mod_zeroconf
The mod_zeroconf
module is designed to use the DNS Service
Discovery technology (also known as Bonjour, or the ZEROCONF protocols)
created by Apple to publish discoverable information about the running
proftpd
daemon.
This module is contained in the mod_zeroconf.c
file for
ProFTPD 1.3.x, and is not compiled by default. Installation instructions
are discussed here. Detailed documentation on
mod_zeroconf
usage can be found here.
The most current version of mod_zeroconf
can be found at:
http://www.castaglia.org/proftpd/
Please contact TJ Saunders <tj at castaglia.org> with any questions, concerns, or suggestions regarding this module.
The ZeroconfEngine
directive enables or disables the
mod_zeroconf
functionality. If set to on, then
mod_zeroconf
will register all configured servers using the
DNS Service Discovery protocols.
<VirtualHost>
The ZeroconfInfo
directive is used to configure the name
that mod_zeroconf
uses to register the server configuration,
as well as optional information.
The name parameter specifies the name the administrator wishes
to publish for this server configuration. By default, if no
ZeroconfInfo
directive is configured, mod_zeroconf
will register a record using the ServerName
of the server
configuration.
The optional info parameter is a colon-delimited string of
attributes about this server. This data can include things like whether
the server allows anonymous access, supports SSL/TLS sessions, etc.
Each attribute can be specified as a key/value pair, separated by
=
. For example, a ZeroconfInfo
directive with an
info parameter might look like:
ZeroconfInfo "ProFTPD's Public Site" anonymous:ssl=SSLv3,TLSv1
The ZeroconfLog
directive is used to a specify a log file for
mod_zeroconf
reporting and debugging. The path parameter
must be the full path to the file to use for logging. Note that this path must
not be to a world-writable directory and, unless
AllowLogSymlinks
is explicitly set to on
(generally a bad idea), the path must not be a symbolic link.
If path is "none", no logging will be done at all.
mod_zeroconf
, copy the mod_zeroconf.c
file
into:
proftpd-dir/contrib/after unpacking the latest proftpd-1.3.x source code. Then follow the usual steps for using third-party modules in proftpd:
./configure --with-modules=mod_zeroconf make make install
mod_zeroconf
module currently only works on Mac OS X
machines running version 10.3 or later.
Example mod_zeroconf
configuration:
<IfModule mod_zeroconf.c> ZeroconfEngine on ZeroconfLog /var/log/proftpd/zeroconf.log ZeroconfInfo "Public FTP" anonymous:ssl=TLSv1 </IfModule>