Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   44335 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

ISCONTROL(8)		  BSD 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 net‐
     work/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 vari‐
		     ables/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 configu‐
     ration, 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 speci‐
     fied, and start an iscsi-session.

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

STANDARDS
     RFC 3720

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 discon‐
     nects.

BSD			      September 23, 2009			   BSD

Vote for polarhome