Skip site navigation (1)Skip section navigation (2)

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
ISCONTROL(8)		FreeBSD	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), iscsictl(8),
     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.

FreeBSD	9.2			August 9, 2010			   FreeBSD 9.2

NAME | SYNOPSIS | DESCRIPTION | EXAMPLES | SEE ALSO | STANDARDS | BUGS

Want to link to this manual page? Use this URL:
<http://www.freebsd.org/cgi/man.cgi?query=iscontrol&sektion=8&manpath=FreeBSD+10.0-RELEASE>

home | help