Skip site navigation (1)Skip section navigation (2)
Date:      Fri, 28 Nov 2025 20:53:31 +0000
From:      Warner Losh <imp@FreeBSD.org>
To:        src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org
Subject:   git: 687ab0dc54a9 - main - umass(4): Update to include pointers to quirks
Message-ID:  <692a0bcb.30a8b.7b76654d@gitrepo.freebsd.org>

index | next in thread | raw e-mail

The branch main has been updated by imp:

URL: https://cgit.FreeBSD.org/src/commit/?id=687ab0dc54a926092548310d71afdbe386150838

commit 687ab0dc54a926092548310d71afdbe386150838
Author:     Warner Losh <imp@FreeBSD.org>
AuthorDate: 2025-11-28 20:49:16 +0000
Commit:     Warner Losh <imp@FreeBSD.org>
CommitDate: 2025-11-28 20:53:13 +0000

    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
---
 share/man/man4/umass.4 | 25 +++++++++++++++++++++++--
 1 file 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


help

Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?692a0bcb.30a8b.7b76654d>