Skip site navigation (1)Skip section navigation (2)

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
CTLD(8)                 FreeBSD System Manager's Manual                CTLD(8)

NAME
     ctld - CAM Target Layer / iSCSI target daemon

SYNOPSIS
     ctld [-d] [-f config-file]

DESCRIPTION
     The ctld 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 ctld daemon parses the configuration file and exits, if
     it encounters any errors.  Then it compares the configuration with the
     kernel list of LUNs managed by previously running ctld 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 target, which handles it from that point.

     When it receives a SIGHUP signal, the ctld 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 ctld daemon removes LUNs it managed and
     forcibly disconnects all the clients.  Otherwise - for example, when
     killed with SIGKILL - LUNs stay configured and clients remain connected.

     To perform administrative actions that apply to already connected
     sessions, such as forcing termination, use ctladm(8).

     The following options are available:

     -f config-file    Specifies the name of the configuration file.  The
                       default is /etc/ctl.conf.

     -d                Debug mode.  The server sends verbose debug output to
                       standard error, and does not put itself in the
                       background.  The server will also not fork and will
                       exit after processing one connection.  This option is
                       only intended for debugging the target.

FILES
     /etc/ctl.conf          The configuration file for ctld.  The file format
                            and configuration options are described in
                            ctl.conf(5).
     /var/run/ctld.pid      The default location of the ctld PID file.

EXIT STATUS
     The ctld utility exits 0 on success, and >0 if an error occurs.

SEE ALSO
     ctl(4), ctl.conf(5), ctladm(8), ctlstat(8)

HISTORY
     The ctld command appeared in FreeBSD 10.0.

AUTHORS
     The ctld was developed by Edward Tomasz Napierala <trasz@FreeBSD.org>
     under sponsorship from the FreeBSD Foundation.

FreeBSD 11.0-PRERELEASE          May 22, 2015          FreeBSD 11.0-PRERELEASE

NAME | SYNOPSIS | DESCRIPTION | FILES | EXIT STATUS | SEE ALSO | HISTORY | AUTHORS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=ctld&sektion=8&manpath=FreeBSD+10.3-RELEASE+and+Ports>

home | help