share/man/man4/sbp_targ.4

   1 .\" Copyright (c) 2003 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 H. Shimokawa
  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 November 7, 2003
  35 .Dt SBP_TARG 4
  36 .Os
  37 .Sh NAME
  38 .Nm sbp_targ
  39 .Nd Serial Bus Protocol 2 (SBP-2) Target Mode devices driver
  40 .Sh SYNOPSIS
  41 To compile this driver into the kernel,
  42 place the following lines in your
  43 kernel configuration file:
  44 .Bd -ragged -offset indent
  45 .Cd "device sbp_targ"
  46 .Cd "device firewire"
  47 .Cd "device scbus"
  48 .Cd "device targ"
  49 .Ed
  50 .Pp
  51 Alternatively, to load the driver as a
  52 module at boot time, place the following lines in
  53 .Xr loader.conf 5 :
  54 .Bd -literal -offset indent
  55 firewire_load="YES"
  56 cam_load="YES"
  57 sbp_targ_load"YES"
  58 .Ed
  59 .Sh DESCRIPTION
  60 The
  61 .Nm
  62 driver provides support for SBP-2 target mode.
  63 This driver is supposed to work with
  64 .Xr cam 4 ,
  65 .Xr targ 4
  66 and
  67 .Xr firewire 4 .
  68 You also need to use
  69 .Xr scsi_target 8 ,
  70 which can be found in
  71 .Pa /usr/share/examples/scsi_target ,
  72 to provide actual devices.
  73 .Sh EXAMPLES
  74 .Bd -literal -offset indent
  75 # mdconfig -a -t malloc -s 10m
  76 md0
  77 # scsi_target 0:0:0 /dev/md0
  78 (Assuming sbp_targ0 on scbus0)
  79 .Ed
  80 .Sh SEE ALSO
  81 .Xr cam 4 ,
  82 .Xr firewire 4 ,
  83 .Xr targ 4 ,
  84 .Xr camcontrol 8 ,
  85 .Xr fwcontrol 8 ,
  86 .Xr kldload 8 ,
  87 .Xr scsi_target 8
  88 .Sh AUTHORS
  89 .An -nosplit
  90 The
  91 .Nm
  92 driver was written by
  93 .An Hidetoshi Shimokawa .
  94 .Sh BUGS
  95 This driver is
  96 .Ud
  97 It does not work correctly in multi-initiator environments
  98 or after the bus topology has been changed.