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