DragonFly On-Line Manual Pages

Search: Section:  

ISCONTROL(8)           DragonFly System Manager's Manual          ISCONTROL(8)


NAME

     iscontrol -- login/negotiator/control for an iSCSI initiator session


SYNOPSIS

     iscontrol [-dv] [-c file] [-n nickname] [-t target] [variable=value ...]


DESCRIPTION

     Internet SCSI (iSCSI) is a network protocol standard, that allows the use
     of the SCSI protocol over TCP/IP networks, the iscontrol program is the
     userland side of an iSCSI session, see iscsi_initiator(4).  It has two
     modes of operation, if -d (discovery session) is specified, it will print
     out the target names returned by the target and exit.  In the second
     mode, it will, after a successful 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:

     -c file         a file containing configuration key-options, see
                     iscsi.conf(5).  Default is /etc/iscsi.conf

     -d              do a discovery session and exit.

     -n nickname     search for the block named nickname in the configuration
                     file (-c), see iscsi.conf(5).

     -t target       is the target's IP address or name.

     -v              verbose mode.

     variable=value  see iscsi.conf(5) for the complete list of
                     variables/options and their possible values.


FILES

     /etc/iscsi.conf  default configuration file


EXAMPLES

           iscontrol -dt myiscsitarget

     will start a 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
     permission, but a full session certainly does.

           iscontrol -c myiscsi.conf -n myiscsi

     will read options from myiscsi.conf, use the targetaddress found in the
     block nicknamed myiscsi, login and negotiate whatever options are
     specified, and start an iscsi-session.


SEE ALSO

     da(4), iscsi_initiator(4), sa(4), iscsi.conf(5), camcontrol(8)


STANDARDS

     RFC 3720


HISTORY

     The iscontrol utility appeared in FreeBSD 7.0.  iscontrol utility first
     appeared in DragonFly 2.3.


BUGS

     Not all functions/specifications have been implemented yet, noticeably
     missing are the Task Management Functions.  The error recovery, though
     not fully compliant does a brave effort to recover from network
     disconnects.

DragonFly 4.5                 September 29, 2016                 DragonFly 4.5

Search: Section: