iscsi-target(8) [netbsd man page]

ISCSI-TARGET(8) 					    BSD System Manager's Manual 					   ISCSI-TARGET(8)

NAME

     iscsi-target -- service remote iSCSI requests

SYNOPSIS

     iscsi-target [-46DV] [-b block length] [-f configuration file] [-p port number] [-s maximum number of sessions] [-t target name]
		  [-v verbose arg]

DESCRIPTION

     iscsi-target is the server for iSCSI requests from iSCSI initiators.  iscsi-target listens for discovery and login requests on the required
     port, and responds to those requests appropriately.

     Options and operands available for iscsi-target:

     -4      iscsi-target will listen for IPv4 connections, and respond back using IPv4.  This is the default address family.

     -6      iscsi-target will listen for IPv6 connections, and respond back using IPv6.

     -b blocksize
	     Specify the underlying block size for iSCSI storage which will be served.	The possible sizes are: 512, 1024, 2048, and 4096 bytes,
	     with the default being 512 bytes.

     -D      When this option is specified, iscsi-target will not detach itself from the controlling tty, and will not become a daemon.  This can
	     be useful for debugging purposes.

     -f configfile
	     Use the named file as the configuration file.  The default file can be found in /etc/iscsi/targets.  See targets(5) for more informa-
	     tion.

     -p port number
	     Use the port number provided as the argument as the port on which to listen for iSCSI service requests from initiators.

     -s maximum number of sessions
	     Allow the maximum number of sessions to be initiated when connecting to the target.

     -t filename
	     The target name (as it appears to the iSCSI initiator) can be specified using this flag.

     -V      iscsi-target will print the utility name and version number, and the address for bug reports, and then exit.

     -v argument
	     The amount of information shown can be varied by using this command.  Possible values of argument are net to show network-related
	     information, iscsi to show iSCSI protocol-related information, scsi to show SCSI protocol information, and all to show information
	     from all of the above arguments.

FILES

     /etc/iscsi/targets 	the list of exported storage
     /var/run/iscsi-target.pid	the PID of the currently running iscsi-target

SEE ALSO

     targets(5)

HISTORY

     The iscsi-target utility first appeared in NetBSD 4.0.

BSD
								   May 27, 2006 							       BSD

ISCSID(8)						      System Manager's Manual							 ISCSID(8)

NAME

       iscsid - establish iSCSI connections

SYNOPSIS

       iscsid [ -b bindingfile ] [ -d ] [ -f configfile ] [ -l basedir ] [ -m mode ] [ -n ]

DESCRIPTION

       iscsid establishes connections with iSCSI targets defined in /etc/iscsi.conf.

       Once the Linux iSCSI driver is activated, a discovery process for iSCSI storage devices will proceed as follows:

       -      The  iSCSI  daemon requests available iSCSI targets from the iSCSI target, and passes the information discovered to the iSCSI kernel
	      module.

       -      The iSCSI kernel module establishes connections to the targets.

       -      Linux queries targets for device information.

       -      Linux creates a mapping from SCSI device nodes to iSCSI targets.

       iscsid should be started after networking is configured and stopped after all iSCSI devices have been unmounted.

       Warning: Data corruption can occur if you do not unmount iSCSI devices before disabling network interfaces!

DEVICE NAMES

       Because Linux assigns SCSI device nodes dynamically whenever a SCSI logical unit is detected, the mapping from device nodes (e.g  /dev/sda,
       /dev/sdb) to iSCSI targets and logical units may vary.

       Variations  in  process scheduling and network delay may result in iSCSI targets being mapped to different SCSI device nodes every time the
       driver is started.  Because of this variability, configuring applications or operating system utilities to use  the  standard  SCSI  device
       nodes to access iSCSI devices may result in SCSI commands being sent to the wrong target or logical unit.

       To  provide  a more reliable namespace, the iSCSI driver will scan the system to determine the mapping from SCSI device nodes to iSCSI tar-
       gets, and then create a tree of directories and symbolic links under /dev/iscsi to make it easier to use a particular iSCSI target's  logi-
       cal units.

TARGET BINDINGS

       The  iSCSI  driver  automatically maintains a bindings file /var/iscsi/bindings.  This file contains persistent bindings to ensure that the
       same iSCSI bus and target id number are used for every iSCSI session to a particular iSCSI TargetName, no matter how many times the  driver
       is restarted.

       This feature ensures that the SCSI numbers in the device symlinks described above will always map to the same iSCSI target.

       Note  that  because  of	the  way  Linux dynamically allocates SCSI device nodes as SCSI devices are found, the driver does not and can not
       ensure that any particular SCSI device node (e.g. /dev/sda) will always map to the same iSCSI TargetName.  The symlinks	described  in  the
       section	on  Device  Names  are intended to provide a persistent device mapping for use by applications and fstab files, and should be used
       instead of direct references to particular SCSI device nodes.

       If the bindings file grows too large, lines for targets that no longer exist may be manually removed by editing the file.   Manual  editing
       should not normally be needed, since the driver can maintain up to 65535 different bindings.

OPTIONS

       -b bindingfile
	      Specify an alternative bindings file instead of /var/iscsi/bindings, which is the default.

       -d     Turns on debug mode.  Each occurence of -d will increment the debug level by one.  The default is zero (off).

       -f configfile
	      Specify an alternative configuration file instead of /etc/iscsi.conf, which is the default.

       -l basedir
	      Specify  the base directory under which to build a tree of directories containing symlinks to SCSI device nodes, in a manner similar
	      to the devfs Linux kernel option.  Using these symlinks hides variations in the mapping from SCSI device nodes  to  SCSI	device	id
	      numbers.

       -m mode
	      Specify the directory permission mode (in octal) to use when creating directories.

       -n     Avoid auto-backgrounding.

       -v     Print version and exit.

SIGNALS

       iscsid reacts to a set of signals.  You may easily send a signal to iscsid using the following:

	      kill -SIGNAL `cat /var/run/iscsid.pid`

       SIGTERM
	      The daemon and all of it's children will die.

       SIGHUP sent  to the main daemon process will restart all discovery processes and reprobe LUNs on all targets.  iscsid and all of it's chil-
	      dren will die after shutting down all of the kernel's iSCSI sessions.

       SIGCHLD
	      Wait for children.

NOTES

       The iSCSI Driver for Linux provides IP access to a maximum of sixteen remote SCSI targets.  Each target will be probed for up to 256  LUNs,
       until the Linux kernel's limit of SCSI devices has been reached.

       The iSCSI drivers, README files, and example configuration files are available on the Linux-iSCSI homepage at:

       http://linux-iscsi.sourceforge.com/ <http://linux-iscsi.sourceforge.com/>

FILES

       /etc/iscsi.conf
	      target address and LUN configuration

       /var/run/iscsi.pid
	      the process id of the running daemon

       /var/iscsi/bindings
	      persistent bus and target id bindings for iSCSI TargetNames

       /proc/scsi/iscsi
	      information about iSCSI devices

       /dev/iscsi
	      a directory tree containing symlinks to iSCSI device nodes.

SEE ALSO

       iscsi.conf(5)

$Revision: 1.8 $					   $Date: 2002/09/20 19:27:32 $ 						 ISCSID(8)