share/man/man4/sbp.4

   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
  45 or
  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
  54 The
  55 .Nm
  56 driver provides support for SBP-2 devices that attach to the FireWire
  57 (IEEE 1394) port.
  58 It should work with SBP-2 devices which the CAM layer supports, for example,
  59 HDDs, CDROM drives and DVD drives.
  60 .Pp
  61 Some users familiar with
  62 .Xr umass 4
  63 might wonder why the device is not detached at the CAM layer when the device
  64 is unplugged.
  65 It is detached only if the device has not been plugged again
  66 during several bus resets.
  67 This is for preventing to detach an active file system
  68 even when the device cannot be probed correctly for some reason after a bus reset
  69 or when the device is temporary disconnected because the user changes the bus
  70 topology.
  71 If you want to force to detach the device, run
  72 .Dq Nm fwcontrol Fl r
  73 several times or set hw.firewire.hold_count=0 by
  74 .Xr sysctl 8 .
  75 .Pp
  76 Some (broken) HDDs do not work well with tagged queuing.
  77 If you have problems with such drives, try
  78 .Dq Nm camcontrol [device id] tags -N 1
  79 to 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
  89 The
  90 .Nm
  91 driver was written by
  92 .An Katsushi Kobayashi
  93 and
  94 .An Hidetoshi Shimokawa .
  95 .Pp
  96 This manual page was written by
  97 .An Katsushi Kobayashi .