Name
ftpservers - ftpd virtual hosting configuration specification file
Description
The ftpservers file is used to tell which set of virtual domain
configuration files the ftpd(8) server should use. When compiled with
VIRTUAL support, wu-ftpd has the ability to use separate configuration
files for each virtual domain.
Currently, configuration files are placed into a separate virtual
domain directory. The directory path and the IP address that is to use
those configuration files is listed in the ftpservers file. The actual
configuration files put into the virtual domain directory MUST be
named:
ftpaccess - virtual domain’s access file
ftpusers - restrict the accounts that can use the
web server,
ftpgroups - SITE GROUP and SITE GPASS support,
ftphosts - allow or deny usernames access to that
virtual server,
ftpconversions - customize conversions available in the
virtual domain.
You do not need to put every file in each of the virtual domain
directories. If you want a set of domains to use the master copy of a
file, for example, the ftpconversions file, then do not include that
file in those virtual domain directories. In that case the default
master copy will be used.
NOTE!!!: The file names must match those listed above. If you misspell
any of them or name them something else, the server WILL NOT find them
and the master copy of them will be used instead.
ftpservers file format
There are two fields to each entry.
ipaddr/hostname directory-containing-configuration-files
For example:
10.196.145.10 /etc/ftpd/ftpaccess.somedomain/
10.196.145.200 /etc/ftpd/ftpaccess.someotherdomain/
some.domain INTERNAL
When an ftp client connects to the server, ftpd tries to match the IP
address the ftp client connected to with one found in the ftpservers
file.
If a match is found the path to the specified directory containing the
configuration files for that specific domain is returned. The ftpd
server uses any configuration files in that directory.
If a match is not found, or an invalid directory path is encountered,
default paths to the configuration files are used. The use of INTERNAL
in the example above fails the check for a specific directory and the
master configuration files will be used.
Either the actual IP address or a specific hostname can be used to
specify the virtual domain. It is better to specify the actual IP of
the virtual domain as it reduces the need for a domain lookup and
eliminates DNS security related naming issues.
10.196.145.20 /etc/ftpd/config/faqs.org/
ftp.some.domain /etc/ftpd/config/faqs.org/
As usual, comment lines are depicted with a # sign. Both comment lines
and blanklines are ignored.
See Also
ftpd(8), ftpaccess(5) ftplog(5), ftpconversions(5), ftphosts(5)
ftpservers(5)