NAME¶
iscsi
—
iSCSI initiator
SYNOPSIS¶
To compile this driver into the kernel, place the following line in the kernel
configuration file:
device iscsi
Alternatively, to load the driver as a module at boot time, place the following
line in
loader.conf(5):
DESCRIPTION¶
The
iscsi
subsystem provides the kernel
component of an iSCSI initiator. The initiator is the iSCSI client, which
connects to an iSCSI target, providing local access to a remote block device.
The userland component is provided by
iscsid(8)
and both the kernel and userland are configured using
iscsictl(8). The
iscsi
subsystem is responsible for
implementing the “Full Feature Phase” of the iSCSI protocol.
SYSCTL VARIABLES¶
The following variables are available as both
sysctl(8) variables and
loader(8) tunables:
- kern.iscsi.ping_timeout
- The number of seconds to wait for the target to respond to a NOP-Out PDU.
In the event that there is no response within that time the session gets
forcibly restarted.
- kern.iscsi.iscsid_timeout
- The number of seconds to wait for ctld(8) to
establish a session. After that time
iscsi
will abort and retry.
- kern.iscsi.login_timeout
- The number of seconds to wait for a login attempt to succeed. After that
time
iscsi
will abort and retry.
- kern.iscsi.maxtags
- The maximum number of outstanding IO requests.
- kern.iscsi.fail_on_disconnection
- Controls the behavior after an iSCSI connection has been dropped due to
network problems. When set to 1, a dropped connection causes the iSCSI
device nodes to be destroyed. After reconnecting, they will be created
again. By default, the device nodes are left intact. While the connection
is down all input/output operations are suspended, to be retried after the
connection is reestablished.
SEE ALSO¶
iscsi.conf(5),
iscsictl(8),
iscsid(8)
HISTORY¶
The
iscsi
subsystem first appeared in
FreeBSD 10.0.
AUTHORS¶
The
iscsi
subsystem was developed by
Edward Tomasz Napierala
<
trasz@FreeBSD.org>
under sponsorship from the FreeBSD Foundation.