Provided by: wu-ftpd_2.6.2-33ubuntu1_i386 bug

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)