iscsid.8

ISCSI user client software.Client would be used to access the IPSAN server.

.\" iSCSI connection daemon
.\" Copyright (C) 2001, 2002 Cisco Systems, Inc.
.\" maintained by [e-mail]
.\" 
.\" This program is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published
.\" by the Free Software Foundation; either version 2 of the License, or
.\" (at your option) any later version.
.\" 
.\" This program is distributed in the hope that it will be useful, but
.\" WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
.\" General Public License for more details.
.\" 
.\" See the file COPYING included with this distribution for more details.
.\" 
.\" $Id: iscsid.8,v 1.4 2004/09/17 10:54:28 naveenb Exp $ 
.\" 
.TH ISCSID 8 "$Date: 2004/09/17 10:54:28 $" "$Revision: 1.4 $"
.SH NAME
iscsid \- establish iSCSI connections
.SH SYNOPSIS
.B iscsid
.RB [ " \-d " ]
.RB [ " \-f "
.I configfile
]
.RB [ " \-n " ]
.RB [ " \-v " ]
.LP
.SH DESCRIPTION
.B iscsid
establishes connections with iSCSI targets defined in
.IR /etc/iscsi.conf .
.PP
Once the Linux iSCSI driver is activated, a discovery process for
iSCSI storage devices will proceed as follows:
.TP
.BI - 
The iSCSI daemon requests available iSCSI targets from the
iSCSI target, and passes the information discovered to the
iSCSI kernel module.
.TP
.BI - 
The iSCSI kernel module establishes connections to the targets.
.TP
.BI - 
Linux queries targets for device information.
.TP
.BI - 
Linux creates a mapping from SCSI device nodes to iSCSI targets.
.LP
.B iscsid 
should be started after networking is configured and
stopped after all iSCSI devices have been unmounted.
.PP
\fBWarning:\fR Data corruption can occur if you do not unmount iSCSI devices
before disabling network interfaces!
.PP
.SH OPTIONS
.TP
.BI "\-d"
Turns on debug mode.  Each occurence of 
.B "\-d" 
will increment the debug level by one.  The default is zero (off).
.TP
.BI "\-f " "configfile"
Specify an alternative configuration file instead of
.IR /etc/iscsi.conf ","
which is the default.
.TP
.B "\-n"
Avoid auto-backgrounding.
.TP
.B "\-v"
Print version and exit.
.LP                     
.SH SIGNALS
.B iscsid
reacts to a set of signals.  You may easily send a signal to
.B iscsid
using the following:
.IP
.nf
kill -SIGNAL `cat /var/run/iscsid.pid`
.fi
.PP
.TP
.B SIGTERM
The daemon and all of it's children will die.
.TP
.B SIGHUP
sent to the main daemon process will restart all discovery processes
and reprobe LUNs on all targets.
.B iscsid 
and all of it's children will die after shutting down all of the
kernel's iSCSI sessions.
.TP
.B SIGCHLD
Wait for children.
.LP                                   
.SH NOTES
The number of iSCSI targets and LUNs that can be used depends on the
number of SCSI device nodes supported by your kernel.  Each iSCSI
target will be probed for up to 256 LUNs, until the Linux kernel's
limit of SCSI devices has been reached.
.PP
The iSCSI drivers, README files, and example configuration files are
available on the Linux-iSCSI homepage at:
.PP
.UR http://linux-iscsi.sourceforge.net/
http://linux-iscsi.sourceforge.net/
.UE
.SH FILES
.TP
\fC/etc/iscsi.conf\fR
target address and LUN configuration
.TP
\fC/etc/initiatorname.iscsi\fR
persistent iSCSI InitiatorName
.TP
\fC/var/run/iscsi.pid\fR 
the process id of the running daemon
.br
.SH "SEE ALSO"
.BR iscsi.conf (5)