aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorWarner Losh <imp@FreeBSD.org>2025-11-28 20:49:16 +0000
committerWarner Losh <imp@FreeBSD.org>2025-11-28 20:53:13 +0000
commit687ab0dc54a926092548310d71afdbe386150838 (patch)
tree72808f32f050ed5ce57ce9e0be12126c309133ea
parent19728f31ae421f40e2b0b0c775f4eedd7f927be0 (diff)
umass(4): Update to include pointers to quirks
umass(4), while much improved, still sometimes need quirks. Add a pointer to usb_quirk(4) and usbconfig(8). Sponsored by: Netflix
-rw-r--r--share/man/man4/umass.425
1 files changed, 23 insertions, 2 deletions
diff --git a/share/man/man4/umass.4 b/share/man/man4/umass.4
index 8c6b03a3afea..306dc4e851ba 100644
--- a/share/man/man4/umass.4
+++ b/share/man/man4/umass.4
@@ -25,7 +25,7 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd October 9, 2025
+.Dd November 28, 2025
.Dt UMASS 4
.Os
.Sh NAME
@@ -87,6 +87,25 @@ USB hard disk drives
.It
USB floppy drives
.El
+.Pp
+The
+.Nm
+driver tries its best to avoid issues with the drives, not all issues
+can be handled automatically, so quirks may be necessary.
+See the
+.Em USB Mass Sotrage quirks
+section of
+.Xr usb_quirk 4
+for quirks for the drives.
+The
+.Cd add_dev_quirk_vplh
+and
+.Cd add_quirk
+commands of
+.Xr usbconfig 8
+can manage these dynamically.
+Quirks can be specified via tuables, as described in
+.Xr usb_quirk 4 .
.Sh EXAMPLES
Rescan all slots on a multi-slot flash reader,
where the slots map to separate LUNs on a single SCSI ID:
@@ -106,8 +125,10 @@ the flash reader is the first SCSI bus in the system and has 4 slots.
.Xr ohci 4 ,
.Xr uhci 4 ,
.Xr usb 4 ,
+.Xr usb_quirk 4 ,
.Xr xhci 4 ,
-.Xr camcontrol 8
+.Xr camcontrol 8 ,
+.Xr usbconfig 8 .
.Sh HISTORY
The
.Nm