git: 9465b903fbbb - releng/15.0 - sbp.4: Add a hardware section, fix markup nits

From: Colin Percival <cperciva_at_FreeBSD.org>
Date: Fri, 14 Nov 2025 02:35:21 UTC
The branch releng/15.0 has been updated by cperciva:

URL: https://cgit.FreeBSD.org/src/commit/?id=9465b903fbbb888a385018c0379901b2b3e3a85d

commit 9465b903fbbb888a385018c0379901b2b3e3a85d
Author:     Alexander Ziaee <ziaee@FreeBSD.org>
AuthorDate: 2025-11-11 18:38:04 +0000
Commit:     Colin Percival <cperciva@FreeBSD.org>
CommitDate: 2025-11-14 02:35:00 +0000

    sbp.4: Add a hardware section, fix markup nits
    
    + tag SPDX
    + add sysctl to apropos database
    + fix markup of examples and reflow a overly long line
    + add a hardware section for hw relnotes
    
    Approved by:    re (cperciva)
    MFC after:      3 days
    
    (cherry picked from commit dee8e38f52266d9b2fa837607ff3a78f240a806d)
    (cherry picked from commit ccf4b4fc42882652b8bb347bb5afed1e89258310)
---
 share/man/man4/sbp.4 | 23 +++++++++++++++++------
 1 file changed, 17 insertions(+), 6 deletions(-)

diff --git a/share/man/man4/sbp.4 b/share/man/man4/sbp.4
index 2255fa2993ae..1daffd104a2c 100644
--- a/share/man/man4/sbp.4
+++ b/share/man/man4/sbp.4
@@ -1,3 +1,6 @@
+.\"
+.\" SPDX-License-Identifier: BSD-4-Clause
+.\"
 .\" Copyright (c) 1998-2002 Katsushi Kobayashi and Hidetoshi Shimokawa
 .\" All rights reserved.
 .\"
@@ -29,7 +32,7 @@
 .\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd February 8, 2012
+.Dd November 11, 2025
 .Dt SBP 4
 .Os
 .Sh NAME
@@ -62,19 +65,27 @@ might wonder why the device is not detached at the CAM layer when the device
 is unplugged.
 It is detached only if the device has not been plugged again
 during several bus resets.
-This is for preventing to detach an active file system
-even when the device cannot be probed correctly for some reason after a bus reset
+This is for preventing to detach an active file system even when the
+device cannot be probed correctly for some reason after a bus reset
 or when the device is temporary disconnected because the user changes the bus
 topology.
 If you want to force to detach the device, run
-.Dq Nm fwcontrol Fl r
-several times or set hw.firewire.hold_count=0 by
+.Ql fwcontrol -r
+several times or set
+.Va hw.firewire.hold_count=0
+by
 .Xr sysctl 8 .
 .Pp
 Some (broken) HDDs do not work well with tagged queuing.
 If you have problems with such drives, try
-.Dq Nm camcontrol [device id] tags -N 1
+.Ql camcontrol [device id] tags -N 1
 to disable tagged queuing.
+.Sh HARDWARE
+The
+.Nm
+driver supports FireWire Serial Bus Protocol 2
+.Pq SBP-2
+storage devices.
 .Sh SEE ALSO
 .Xr cam 4 ,
 .Xr firewire 4 ,