NAME
ftpservers — ftpd virtual hosting configuration specification file
SYNPOSIS
/etc/ftpd/ftpservers
DESCRIPTION
The
/etc/ftpd/ftpservers
file is used to tell which set of virtual domain configuration files that the
ftpd
server should use. With
VIRTUAL
support, wu-ftpd has the ability to use separate configuration files for each
virtual domain.
For a virtual host, configuration files can be placed into a
separate virtual domain directory. The directory path and the
virtual host IP address that is to use those configuration files is
listed in the
/etc/ftpd/ftpservers
file.
The actual
configuration files put into the virtual domain directory MUST be
named as follows:
- 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.
NOTE:
Comment lines are depicted with a # sign. Both comment lines
and blanklines are ignored.
FILES
/etc/ftpd/ftpservers
AUTHOR
ftpservers
was developed by the Washington University, St. Louis, Missouri.
Printable version
