xref: /freebsd/share/man/man4/sbp.4 (revision 7ef62cebc2f965b0f640263e179276928885e33d)
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.\" $FreeBSD$
33.\"
34.Dd February 8, 2012
35.Dt SBP 4
36.Os
37.Sh NAME
38.Nm sbp
39.Nd Serial Bus Protocol 2 (SBP-2) Mass Storage Devices driver
40.Sh SYNOPSIS
41.Cd "kldload firewire"
42.Cd "kldload cam"
43.Cd "kldload sbp"
44.Pp
45or
46.Pp
47.Cd "device sbp"
48.Cd "device firewire"
49.Cd "device scbus"
50.Cd "device da"
51.Cd "device cd"
52.Cd "device pass"
53.Sh DESCRIPTION
54The
55.Nm
56driver provides support for SBP-2 devices that attach to the FireWire
57(IEEE 1394) port.
58It should work with SBP-2 devices which the CAM layer supports, for example,
59HDDs, CDROM drives and DVD drives.
60.Pp
61Some users familiar with
62.Xr umass 4
63might wonder why the device is not detached at the CAM layer when the device
64is unplugged.
65It is detached only if the device has not been plugged again
66during several bus resets.
67This is for preventing to detach an active file system
68even when the device cannot be probed correctly for some reason after a bus reset
69or when the device is temporary disconnected because the user changes the bus
70topology.
71If you want to force to detach the device, run
72.Dq Nm fwcontrol Fl r
73several times or set hw.firewire.hold_count=0 by
74.Xr sysctl 8 .
75.Pp
76Some (broken) HDDs do not work well with tagged queuing.
77If you have problems with such drives, try
78.Dq Nm camcontrol [device id] tags -N 1
79to disable tagged queuing.
80.Sh SEE ALSO
81.Xr cam 4 ,
82.Xr firewire 4 ,
83.Xr camcontrol 8 ,
84.Xr fwcontrol 8 ,
85.Xr kldload 8 ,
86.Xr sysctl 8
87.Sh AUTHORS
88.An -nosplit
89The
90.Nm
91driver was written by
92.An Katsushi Kobayashi
93and
94.An Hidetoshi Shimokawa .
95.Pp
96This manual page was written by
97.An Katsushi Kobayashi .
98