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   9747 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]] [-p pidfile] [-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 2
     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).

     -d		     do a discovery session and exit.

     -n nickname     if -c file is specified, then search for the block named
		     nickname in that file, see iscsi.conf(5).

     -p pidfile	     will write the process ID of the session to the specified
		     pidfile

     -t target	     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.

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 /etc/iscsi.conf -n myiscsi

     will read options from /etc/iscsi.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

BUGS
     iscontrol should probably load the iscsi_initiator module if needed.
     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			       February 22, 2007			   BSD

Vote for polarhome