|-a||When adding, add all sessions defined in the configuration file. When removing, remove all currently established sessions.|
|-c||Path to the configuration file. The default is /etc/iscsi.conf.|
|-d||Target host name or address used for SendTargets discovery. When used, it will add a temporary discovery session. After discovery is done, sessions will be added for each discovered target, and the temporary discovery session will be removed.|
|-i||Session ID, as displayed by iscsictl -v .|
|-n||The "nickname" of session defined in the configuration file.|
|-p||Target portal - host name or address - for statically defined targets.|
|-w||Instead of returning immediately, wait up to timeout seconds until all configured sessions are successfully established.|
Certain parameters are necessary when adding a session. One can specify these either via command line (using the -t , -p , -u , and -s options), or configuration file (using the -a or -n options). Some functionality - for example mutual CHAP - is available only via configuration file.
Since connecting to the target is performed in background, non-zero exit status does not mean that the session was successfully established. Use either -L to check the connection status, or the -w flag to wait for session establishment.
Note that in order for the iSCSI initiator to be able to connect to a target, the iscsid(8) daemon must be running.
Also note that
.Fx currently supports two different initiators: the old one, iscsi_initiator(4), with its control utility iscontrol(8), and the new one, iscsi(4), with iscsictl and iscsid(8). The only thing the two have in common is the configuration file, iscsi.conf(5).
/etc/iscsi.conf iSCSI initiator configuration file.
The iscsictl utility exits 0 on success, and >0 if an error occurs.
Attach to target iqn.2012-06.com.example:target0, served by 192.168.1.1:
-A -t iqn.2012-06.com.example:target0-p 192.168.1.1
Disconnect all iSCSI sessions:
iscsi(4), iscsi.conf(5), iscsid(8)
The iscsictl command appeared in
.Fx 10.0 .
The iscsictl utility was developed by
.An Edward Tomasz Napierala Aq trasz@FreeBSD.org under sponsorship from the FreeBSD Foundation.