ftpservers.5

ftpservers(5)                                       ftpservers(5)

Name

       ftpservers - ftpd virtual hosting configuration specifica­
       tion 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  abil­
       ity  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 configura­
       tion 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 spec­
       ify 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)