man.bsd.lv manual page server

DESCRIPTION

The following options are available:

--libxo

Generate output via libxo(3) in a selection of different human and machine readable formats. See xo_parse_args(3) for details on command line arguments.

-A

Add session.

-M

Modify session.

-R

Remove session.

-L

List sessions.

-a

When adding, add all sessions defined in the configuration file. When removing, remove all currently established sessions.

-c path

Path to the configuration file. The default is /etc/iscsi.conf.

-d discovery-host

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.

-e on|off

Enable or disable the session. This is ignored for discovery sessions, but gets passed down to normal sessions they add.

-i session-id

Session ID, as displayed by iscsictl -v.

-n nickname

The nickname of a session defined in the configuration file.

-p portal

Target portal — host name or address — for statically defined targets.

-r

Use iSER (iSCSI over RDMA) instead of plain iSCSI over TCP/IP.

-s secret

CHAP secret.

-t target

Target name.

-u user

CHAP login.

-v

Verbose mode.

-w timeout

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 iscsictl -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 FreeBSD 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).