CAM Target Layer / iSCSI target daemon
daemon is responsible for managing
the CAM Target Layer configuration, accepting incoming iSCSI connections,
performing authentication and passing connections to the kernel part of the
native iSCSI target.
Upon startup, the
daemon parses the
configuration file. If it encounters any errors,
exits. It then compares the
configuration with the kernel list of LUNs managed by previously running
instances, removes LUNs no longer
existing in the configuration file, and creates new LUNs as necessary. After
that it listens for the incoming iSCSI connections, performs authentication,
and, if successful, passes the connections to the kernel part of CTL iSCSI
which handles it from that point.
When it receives a SIGHUP signal, the
reloads its configuration and applies the changes to the kernel. Changes are
applied in a way that avoids unnecessary disruptions; for example removing one
LUN does not affect other LUNs.
When exiting gracefully, the
removes LUNs it managed and forcibly disconnects all the clients. Otherwise -
for example, when killed with SIGKILL - LUNs stay configured and clients
To perform administrative actions that apply to already connected sessions, such
as forcing termination, use
The following options are available:
- Specifies the name of the configuration file. The default is
- Debug mode. The daemon sends verbose debug output to standard error, and
does not put itself in the background. The daemon will also not fork and
will exit after processing one connection. This option is only intended
for debugging the target.
- Use UCL configuration file format instead of the traditional non-UCL
- The configuration file for
file format and configuration options are described in
- The default location of the
utility exits 0 on success, and
>0 if an error occurs.
command appeared in
was developed by
Edward Tomasz Napierala
under sponsorship from the FreeBSD Foundation.