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)

     ctld -- CAM Target	Layer /	iSCSI target daemon

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

     The ctld daemon is	responsible for	managing the CAM Target	Layer configu-
     ration, 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 ses-
     sions, 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

     -d		 Debug mode.  The server sends verbose debug output to stan-
		 dard 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

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

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

     ctl(4), ctl.conf(5), ctladm(8)

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

FreeBSD	10.2			 July 20, 2014			  FreeBSD 10.2


Want to link to this manual page? Use this URL:

home | help