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
117 lines
3.7 KiB
Groff
117 lines
3.7 KiB
Groff
.\" 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 22, 2007
|
|
.Dt ISCONTROL 8
|
|
.Os
|
|
.Sh NAME
|
|
.Nm iscontrol
|
|
.Nd login/negotiator/control for an iSCSI initiator session
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Op Fl vd
|
|
.Oo
|
|
.Op Fl Ar file
|
|
.Op Fl n Ar nickname
|
|
.Oc
|
|
.Op Fl t Ar target
|
|
.Op Ar variable Ns = Ns Ar value
|
|
.Sh DESCRIPTION
|
|
Internet SCSI (iSCSI) is a network protocol standard, that allows the
|
|
use of the SCSI protocol over TCP/IP networks,
|
|
the
|
|
.Nm
|
|
program is the userland side of an iSCSI session, see
|
|
iscsi_initiator(4).
|
|
It has 2 modes of operation, if -d (discovery session) is specified,
|
|
it will print out the
|
|
.Em target names
|
|
returned by the target and exit.
|
|
In the second mode, it will, after a succesful login/negotiation, run
|
|
in daemon mode, monitoring the connection, and will try to reconnect
|
|
in case of a network/target failure. It will terminate/logout the session
|
|
when a SIGHUP signal is received.
|
|
The flags are as follows:
|
|
.Bl -tag -width variable=value
|
|
.It Fl v
|
|
verbose mode.
|
|
.It Fl d
|
|
do a
|
|
.Em discovery session
|
|
and exit.
|
|
.It Fl c Ar file
|
|
a file containing configuration
|
|
.Em key-options ,
|
|
see iscsi.conf(5)
|
|
.It Fl n Ar nickname
|
|
if
|
|
.Sy -c file
|
|
is specified, then search for the block named
|
|
.Em nickname
|
|
in that file, see iscsi.conf(5)
|
|
.It Fl t Ar target
|
|
is the target's IP address or name
|
|
.It Ar variable Ns = Ns Ar value
|
|
see iscsi.conf(5) for the complete list of variables/options and their
|
|
possible values.
|
|
.El
|
|
.Sh EXAMPLES
|
|
.Dl iscontrol -dt myiscsitarget
|
|
.Pp
|
|
will start a
|
|
.Em discovery session
|
|
with the target and
|
|
print to stdout the list of available targetnames/targetadresses.
|
|
Note: this listing does not necessarily mean availability, since
|
|
depending on the target configuration, a discovery session might
|
|
not need login/access permition, but a
|
|
.Em full session
|
|
certainly does.
|
|
.sp
|
|
.Dl iscontrol -c /etc/iscsi.conf -n myiscsi
|
|
.Pp
|
|
will read options from file /etc/iscsi.conf, use the targetaddress
|
|
found in the block nicknamed myiscsi, login and negotiate
|
|
whatever options are specified, and start an iscsi-session.
|
|
.Sh SEE ALSO
|
|
.Xr iscsi_initiator 4 ,
|
|
.Xr iscsi.conf 5 ,
|
|
.Xr camcontrol 8 ,
|
|
.Xr da 4 ,
|
|
.Xr sa 4
|
|
.Sh STANDARDS
|
|
RFC 3720
|
|
.\"Sh HISTORY
|
|
.Sh BUGS
|
|
.Nm
|
|
should probably load the iscsi_initiator module if needed.
|
|
.br
|
|
Not all functions/specifications have been implemented yet, noticeably
|
|
missing are the Task Management Funtions.
|
|
The error recovery, though not
|
|
.Em fully compliant
|
|
does a brave effort to recover from network disconnects.
|