From nobody Fri Nov 28 20:53:31 2025 X-Original-To: dev-commits-src-main@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4dJ59l1dQwz6JGps for ; Fri, 28 Nov 2025 20:53:31 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4dJ59l0xgjz3bpx for ; Fri, 28 Nov 2025 20:53:31 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1764363211; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=lRaj/r2vggxieOF8zdgQlll7MsOL3EHl2loqYm+44Q8=; b=HYmRjGXK8MbEa5em1STtYIsCl3vhDcyQU7lKnwfRG/PiUYVopEq4qD5LVZep4KataXJ0Hf lwM7wXOyHPeRU9s4PXcx51H6Fg8hWhvaLvWhQpfcVfIqGTeSbn8P4qtOVifoaNIe9T4A9b jhvPvkfBZ3HaWoomw8c8KQWXHyyjfongvS1HZRBS74fVsDx112FKtl31cxD2Vx0Ms9wqDA huLVz0Vxe/hwKb2K1TDDUkm6GspnbgcrtYODbZMfQ5ng9fJSNTkhh6ceh8Yz03NSroj10Q RA6NVpu6BuvbjqNC1v3WGmviusH0S+wtawBy0n6OZZO1hkqAK5zWHj/GBpuMLw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1764363211; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=lRaj/r2vggxieOF8zdgQlll7MsOL3EHl2loqYm+44Q8=; b=vgVaZEgQGNndaOj5bEYymCu4IVHs4WAcaMzRAgqL9eiBM+aNRcTcUzzPKxKnGsjlKztqK8 316lYSbhdNI7wBOz+Kz2YkJXK+IGra9IfXbJt6YKZljX/zcnd1FwUG1pfzFuv/yflipVLp D0tySHLVh4tjqq7NbbWQmv8vJExL+Wp2wjAZV5iEBd/YqevGTi2sr9Q218d7p8sIYBpefd gNyt4sD2Zm15/wVQAQdqzpGY1rYSr/syNWXfAVHi39Dv2/fPzfhrLaP0eYT7C7XJhi48l7 1ZSPsypAHezNUh+B8p5CQ31hLM1+tkTLNtDRM7ohULRolJ9Y/UnzzD7LygNj6w== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1764363211; a=rsa-sha256; cv=none; b=Ej24HqZXXiULW03JqdtnnHG54oXcbjt2R9HabAfFhdpRFHTGA19vTRbJrbUpP+5OtR6j78 8M/rhZDtWM90biwefrvDng/vknsPazzN3PThY+6+zscLQs9khdwo02aCcJlfHcYt1OO4Xz NMlngrqkhVmQ/2JBHEFiDqL8SKQ6vwzgmJ810El3NWNwQ/b/Mb2zOWXUXN4VDqdAPeJmBC 30bwirKBRIZtGYjovz6f+uVAGYSMRTfpdWmwEh4eQ/8ngxdlg8tc3LKvzlmIo0sRtnPsON r11ic48CKxVSDnZvD2n9M1RSuoKmEsP7eEqSFDqeQuugFYmd2CTsXxQ2EJgQ9w== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4dJ59l0XGkz3SN for ; Fri, 28 Nov 2025 20:53:31 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 30a8b by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Fri, 28 Nov 2025 20:53:31 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Warner Losh Subject: git: 687ab0dc54a9 - main - umass(4): Update to include pointers to quirks List-Id: Commit messages for the main branch of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-main@freebsd.org Sender: owner-dev-commits-src-main@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: imp X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 687ab0dc54a926092548310d71afdbe386150838 Auto-Submitted: auto-generated Date: Fri, 28 Nov 2025 20:53:31 +0000 Message-Id: <692a0bcb.30a8b.7b76654d@gitrepo.freebsd.org> The branch main has been updated by imp: URL: https://cgit.FreeBSD.org/src/commit/?id=687ab0dc54a926092548310d71afdbe386150838 commit 687ab0dc54a926092548310d71afdbe386150838 Author: Warner Losh AuthorDate: 2025-11-28 20:49:16 +0000 Commit: Warner Losh 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