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