xref: /freebsd/share/man/man4/sbp.4 (revision 8ccc0d235c226d84112561d453c49904398d085c)
1.\"
2.\" SPDX-License-Identifier: BSD-4-Clause
3.\"
4.\" Copyright (c) 1998-2002 Katsushi Kobayashi and Hidetoshi Shimokawa
5.\" All rights reserved.
6.\"
7.\" Redistribution and use in source and binary forms, with or without
8.\" modification, are permitted provided that the following conditions
9.\" are met:
10.\" 1. Redistributions of source code must retain the above copyright
11.\"    notice, this list of conditions and the following disclaimer.
12.\" 2. Redistributions in binary form must reproduce the above copyright
13.\"    notice, this list of conditions and the following disclaimer in the
14.\"    documentation and/or other materials provided with the distribution.
15.\" 3. All advertising materials mentioning features or use of this software
16.\"    must display the acknowledgement as bellow:
17.\"
18.\"      This product includes software developed by K. Kobayashi
19.\"
20.\" 4. The name of the author may not be used to endorse or promote products
21.\"    derived from this software without specific prior written permission.
22.\"
23.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
24.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
25.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
26.\" DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
27.\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
28.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
29.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
30.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
31.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
32.\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
33.\" POSSIBILITY OF SUCH DAMAGE.
34.\"
35.Dd November 11, 2025
36.Dt SBP 4
37.Os
38.Sh NAME
39.Nm sbp
40.Nd Serial Bus Protocol 2 (SBP-2) Mass Storage Devices driver
41.Sh SYNOPSIS
42.Cd "kldload firewire"
43.Cd "kldload cam"
44.Cd "kldload sbp"
45.Pp
46or
47.Pp
48.Cd "device sbp"
49.Cd "device firewire"
50.Cd "device scbus"
51.Cd "device da"
52.Cd "device cd"
53.Cd "device pass"
54.Sh DESCRIPTION
55The
56.Nm
57driver provides support for SBP-2 devices that attach to the FireWire
58(IEEE 1394) port.
59It should work with SBP-2 devices which the CAM layer supports, for example,
60HDDs, CDROM drives and DVD drives.
61.Pp
62Some users familiar with
63.Xr umass 4
64might wonder why the device is not detached at the CAM layer when the device
65is unplugged.
66It is detached only if the device has not been plugged again
67during several bus resets.
68This is for preventing to detach an active file system even when the
69device cannot be probed correctly for some reason after a bus reset
70or when the device is temporary disconnected because the user changes the bus
71topology.
72If you want to force to detach the device, run
73.Ql fwcontrol -r
74several times or set
75.Va hw.firewire.hold_count=0
76by
77.Xr sysctl 8 .
78.Pp
79Some (broken) HDDs do not work well with tagged queuing.
80If you have problems with such drives, try
81.Ql camcontrol [device id] tags -N 1
82to disable tagged queuing.
83.Sh HARDWARE
84The
85.Nm
86driver supports FireWire Serial Bus Protocol 2
87.Pq SBP-2
88storage devices.
89.Sh SEE ALSO
90.Xr cam 4 ,
91.Xr firewire 4 ,
92.Xr camcontrol 8 ,
93.Xr fwcontrol 8 ,
94.Xr kldload 8 ,
95.Xr sysctl 8
96.Sh AUTHORS
97.An -nosplit
98The
99.Nm
100driver was written by
101.An Katsushi Kobayashi
102and
103.An Hidetoshi Shimokawa .
104.Pp
105This manual page was written by
106.An Katsushi Kobayashi .
107