Gecko [ www.thearyasamaj.org ]

Name	Size	Permission
contrib	[ DIR ]	drwxr-xr-x
howto	[ DIR ]	drwxr-xr-x
modules	[ DIR ]	drwxr-xr-x
rfc	[ DIR ]	drwxr-xr-x
sample-configurations	[ DIR ]	drwxr-xr-x
utils	[ DIR ]	drwxr-xr-x
CREDITS	2.2 KB	-rw-r--r--
ChangeLog	1.64 MB	-rw-r--r--
Configuration.html	534.86 KB	-rw-r--r--
Configuration.pdf	1.39 MB	-rw-r--r--
Configuration.sgml	675 B	-rw-r--r--
NEWS	176 KB	-rw-r--r--
README.DSO	2.47 KB	-rw-r--r--
README.IPv6	3.84 KB	-rw-r--r--
README.PAM	6.47 KB	-rw-r--r--
README.capabilities	2.21 KB	-rw-r--r--
README.classes	611 B	-rw-r--r--
README.contrib	968 B	-rw-r--r--
README.controls	1.98 KB	-rw-r--r--
README.facl	1.6 KB	-rw-r--r--
README.md	4.62 KB	-rw-r--r--
README.modules	6.79 KB	-rw-r--r--
README.ratio	5.21 KB	-rw-r--r--
faq.html	93.22 KB	-rw-r--r--
license.txt	1.17 KB	-rw-r--r--
mod_sample.c	11.03 KB	-rw-r--r--

Code Editor : README.controls

Controls
--------

A new functionality called Controls was added in ProFTPD 1.2.10rc1.

Controls is a feature that provides a way for system administrators to
communicate directly with a running proftpd daemon, making it possible to do
on-the-fly configuration changes and other capabilities.  This feature
includes a program called `ftpdctl', for communicating with the daemon from
the command line, and an API that third-party modules can use to extend the
Control commands available to `ftpdctl'.  Note, however, that this
functionality is only available if proftpd is run in standalone mode
(i.e. "ServerType standalone"); proftpd daemons run via inetd/xinetd cannot
support this feature.

To enable support for Controls, use the --enable-ctrls configure option:

./configure --enable-ctrls ...

This enables support for the Controls API in the core engine, and causes
the userland program `ftpdctl' to be functional.  It also causes the
mod_ctrls module to be automatically compiled into proftpd (hence you should
NOT use both --enable-ctrls and --with-modules=mod_ctrls).

The mod_ctrls module provides some basic ftpdctl commands:

help
  insctrl
  lsctrl
  rmctrl

Online documentation for these commands can currently be found here:

http://www.castaglia.org/proftpd/modules/mod_ctrls.html

Additional modules that make use of Controls have been added to the contrib/
area that extend the number of ftpdctl commands.  For example, to use
the mod_ctrls_admin module, you would add it to your --with-modules
configure option, in addition to enabling Controls support:

./configure --enable-ctrls --with-modules=mod_ctrls_admin ...

More information on the mod_ctrls_admin module can be found in the HTML
documentation for that module, which can be found in the contrib/ directory
as well as online:

http://www.castaglia.org/proftpd/modules/mod_ctrls_admin.html

As always, please report any bugs or problems with the new Controls
functionality to ProFTPD's bug tracking system:

http://bugs.proftpd.org

${this.title}

Code Editor : README.controls