aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorWarner Losh <imp@FreeBSD.org>2025-11-28 20:49:16 +0000
committerAlexander Ziaee <ziaee@FreeBSD.org>2026-02-06 00:22:46 +0000
commitf1fe71222acab989f7a49c0f66a2fb2455b8d0d0 (patch)
tree5635a0e7f580441f5d977c229888e7300e76a18e
parent3cdb401480a17618ac4bac5dd2281006efaf614e (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 (cherry picked from commit 687ab0dc54a926092548310d71afdbe386150838)
-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