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.