Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

iscontrol(8) [freebsd man page]

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
This command, along with its kernel counterpart iscsi_initiator(4), is obsolete. Users are advised to use iscsictl(8) instead. 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 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). -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 variables/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 configuration, 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), iscsictl(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 disconnects. BSD
October 9, 2014 BSD

Check Out this Related Man Page

LIBISCSI(3)						   BSD Library Functions Manual 					       LIBISCSI(3)

NAME
libiscsi -- iSCSI network storage protocol implementation LIBRARY
iSCSI protocol library (libiscsi, -liscsi) SYNOPSIS
#include <iscsi.h> int iscsi_target_set_defaults(iscsi_target_t *target); int iscsi_target_start(iscsi_target_t *target); int iscsi_target_listen(iscsi_target_t *target); int iscsi_target_shutdown(iscsi_target_t *target); void iscsi_target_write_pidfile(const char *filename); int iscsi_target_setvar(iscsi_target_t *target, const char *name, const char *value); char * iscsi_target_getvar(iscsi_target_t *target, const char *name); int iscsi_initiator_set_defaults(iscsi_initiator_t *initiator); int iscsi_initiator_start(iscsi_initiator_t *initiator); int iscsi_initiator_discover(iscsi_initiator_t *initiator, char *x, uint64_t a, int b); int iscsi_initiator_shutdown(iscsi_initiator_t *initiator); int iscsi_initiator_setvar(iscsi_initiator_t *initiator, const char *name, const char *value); char * iscsi_initiator_getvar(iscsi_initiator_t *initiator, const char *name); DESCRIPTION
libiscsi is a library interface to the iSCSI target and initiator. This conforms to IETF RFC 3720. The corresponding command line utilities for libiscsi are iscsi-initiator(8) and iscsi-target(8). In normal operation, a process acting as a target (i.e. presenting storage to the network) will call iscsi_target_set_defaults() and will then set various values using the iscsi_target_setvar() function. The value of a variable can be retrieved at any time using the iscsi_target_getvar() function. When all of the variables have been set, the iscsi_target_start() function is called, and the block storage will be served up by the process. A useful illustration of the use of these functions can be found in the source code to the iscsi-target(8) utility. The libiscsi library also provides an implementation of the client end of the iSCSI subsystem, which is known as the initiator. The process acting as an initiator will first call the iscsi_initiator_set_defaults() function, to set default values for the initiator variables. Once all the values have been set to the user preferences using the iscsi_initiator_setvar() function, then the iscsi_initiator_start() function is called. The libiscsi library can be used to perform iSCSI device discovery by calling the iscsi_initiator_discovery() function. This will return a list of all the iSCSI targets which are serving up block storage according to the variables which have already been set. SEE ALSO
iscsi-initiator(8), iscsi-target(8) HISTORY
The libiscsi library first appeared in NetBSD 4.0. This programmatic interface to the iSCSI subsystem first appeared in NetBSD 6.0. AUTHORS
Alistair Crooks <agc@NetBSD.org>. BSD
February 19, 2011 BSD
Man Page