diff options
author | scottl <scottl@FreeBSD.org> | 2007-07-24 15:35:02 +0000 |
---|---|---|
committer | scottl <scottl@FreeBSD.org> | 2007-07-24 15:35:02 +0000 |
commit | 08b4d87cfeb6a16578e5ea85388ed36884d14f49 (patch) | |
tree | 2ea97a85d2ad3ef80513af697b1ce0fa11f34156 /share | |
parent | 67705357ae28711ac9af6e507a24c9b7fadd6f16 (diff) | |
download | FreeBSD-src-08b4d87cfeb6a16578e5ea85388ed36884d14f49.zip FreeBSD-src-08b4d87cfeb6a16578e5ea85388ed36884d14f49.tar.gz |
Introduce Danny Braniss' iSCSI initiator, version 2.0.99. Please read the
included man pages on how to use it. This code is still somewhat experimental
but has been successfully tested on a number of targets. Many thanks to
Danny for contributing this.
Approved by: re
Diffstat (limited to 'share')
-rw-r--r-- | share/man/man4/Makefile | 1 | ||||
-rw-r--r-- | share/man/man4/iscsi_initiator.4 | 104 |
2 files changed, 105 insertions, 0 deletions
diff --git a/share/man/man4/Makefile b/share/man/man4/Makefile index 689ccab..9c92e22 100644 --- a/share/man/man4/Makefile +++ b/share/man/man4/Makefile @@ -127,6 +127,7 @@ MAN= aac.4 \ ips.4 \ ipsec.4 \ ipw.4 \ + iscsi_initiator.4 \ isp.4 \ ispfw.4 \ iwi.4 \ diff --git a/share/man/man4/iscsi_initiator.4 b/share/man/man4/iscsi_initiator.4 new file mode 100644 index 0000000..5f3bf16 --- /dev/null +++ b/share/man/man4/iscsi_initiator.4 @@ -0,0 +1,104 @@ +.\" Copyright (c) 2007 Daniel Braniss <danny@cs.huji.ac.il> +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" $FreeBSD$ +.\" +.Dd February 23, 2007 +.Os +.Dt ISCSI_INITIATOR 4 +.Sh NAME +.Nm iscsi_initiator +.Nd kernel driver for the iSCSI protocol +.Sh SYNOPSIS +To compile this driver into the kernel, +place the following lines in your +kernel configuration file: +.Bd -ragged -offset indent +.Cd "device iscsi_initiator" +.Ed +.Pp +Alternatively, to load the driver as a +module at boot time, place the following line in +.Xr loader.conf 5 : +.Bd -literal -offset indent +iscsi_initiator_load="YES" +.Ed +.Sh DESCRIPTION +The +.Nm +implements the kernel side of the Internet ISCSI (iSCSI) network +protocol standard, the user land companion is +.Xr iscontrol 8, and permits access to remote +.Em virtual +SCSI devices via the +.Xr cam 4 . +.Sh SYSCTL VARIABLES +.Bl -tag -width ".Va net.iscsi.n.targeaddress" +.It Va debug.iscsi_initiator +set the debug-level, 0 means no debugging, 9 for maximum. +.It Va net.iscsi.isid +the initiator part of the Session Identifier. +.It "the following are informative only:" +.It Va net.iscsi.driver_version +the current version of the driver. +.It Va net.iscsi.sessions +the number of current active sessions. +.It Va net.iscsi.n.targetname +is the targe name of session +.Em n . +.It Va net.iscsi.n.targeaddress +is the IP address of the target of session +.Em n . +.It Va net.iscsi.n.stats +are some statistics for session +.EM n +.It Va net.iscsi.n.pid +is the +.Em "process id" +of the userland side of session +.Em n , +see +.Xr iscontrol 8 . +.El +.Sh FILES +The +.NM +driver creates the following: +.Bl -tag -width ".Pa /dev/iscsi%dxx" -compact +.It Pa /dev/iscsi +used to creat new sessions. +.It Pa /dev/iscsi%d +for each new session. +.El +.\" .Sh ERRORS +.Sh SEE ALSO +.Xr iscontrol 8 , +.Xr cam 4 , +.Xr camcontrol 8 +.Sh STANDARDS +ISCSI RFC 3720 +.\" .Sh HISTORY +.\" .Sh AUTHORS +.Sh BUGS +The lun discovery method is old-fashioned. |