manual/wu-ftpd/original/man5/ftpservers.5

   1 .\"
   2 .\" Copyright (c) 1999,2000 WU-FTPD Development Group.
   3 .\" All rights reserved.
   4 .\"
   5 .\" Portions Copyright (c) 1980, 1985, 1988, 1989, 1990, 1991, 1993, 1994
   6 .\" The Regents of the University of California.  Portions Copyright (c)
   7 .\" 1993, 1994 Washington University in Saint Louis.  Portions Copyright
   8 .\" (c) 1996, 1998 Berkeley Software Design, Inc.  Portions Copyright (c)
   9 .\" 1998 Sendmail, Inc.  Portions Copyright (c) 1983, 1995, 1996, 1997 Eric
  10 .\" P. Allman.  Portions Copyright (c) 1989 Massachusetts Institute of
  11 .\" Technology.  Portions Copyright (c) 1997 Stan Barber.  Portions
  12 .\" Copyright (C) 1991, 1992, 1993, 1994, 1995, 1996, 1997 Free Software
  13 .\" Foundation, Inc.  Portions Copyright (c) 1997 Kent Landfield.
  14 .\"
  15 .\" Use and distribution of this software and its source code are governed
  16 .\" by the terms and conditions of the WU-FTPD Software License ("LICENSE").
  17 .\"
  18 .\"     $Id: ftpservers.5,v 1.2 2000/07/01 17:49:09 wuftpd Exp $
  19 .\"
  20 .TH ftpservers 5
  21 .SH Name
  22 ftpservers \- ftpd virtual hosting configuration specification file
  23
  24 .SH Description
  25
  26 The ftpservers file is used to tell which set of virtual domain configuration
  27 files the
  28 .BR ftpd(8)
  29 server should use. When compiled with VIRTUAL support, wu-ftpd has the
  30 ability to use separate configuration files for each virtual domain.
  31
  32 Currently, configuration files are placed into a separate virtual domain
  33 directory. The directory path and the IP address that is to use those
  34 configuration files is listed in the ftpservers file.  The actual
  35 configuration files put into the virtual domain directory MUST be
  36 named:
  37 .PP
  38
  39     ftpaccess      - virtual domain's access file
  40     ftpusers       - restrict the accounts that can use the
  41                      web server,
  42     ftpgroups      - SITE GROUP and SITE GPASS support,
  43     ftphosts       - allow or deny usernames access to that
  44                      virtual server,
  45     ftpconversions - customize conversions available in the
  46                      virtual domain.
  47
  48 You do not need to put every file in each of the virtual domain
  49 directories. If you want a set of domains to use the master copy
  50 of a file, for example, the ftpconversions file, then do not include
  51 that file in those virtual domain directories. In that case the
  52 default master copy will be used.
  53
  54 .B NOTE!!!:
  55 The file names must match those listed above. If you misspell any of
  56 them or name them something else, the server WILL NOT find them and
  57 the master copy of them will be used instead.
  58
  59 .SH ftpservers file format
  60
  61 There are two fields to each entry.
  62
  63 .B ipaddr/hostname   directory-containing-configuration-files
  64
  65 For example:
  66     10.196.145.10    /etc/ftpd/ftpaccess.somedomain/
  67     10.196.145.200   /etc/ftpd/ftpaccess.someotherdomain/
  68     some.domain      INTERNAL
  69
  70 When an ftp client connects to the server, ftpd tries to match the IP
  71 address the ftp client connected to with one found in the ftpservers file.
  72
  73 If a match is found the path to the specified directory containing
  74 the configuration files for that specific domain is returned. The
  75 ftpd server uses any configuration files in that directory.
  76
  77 If a match is not found, or an invalid directory path is encountered,
  78 default paths to the configuration files are used.  The use of INTERNAL
  79 in the example above fails the check for a specific directory and the
  80 master configuration files will be used.
  81
  82 Either the actual IP address or a specific hostname can be used to
  83 specify the virtual domain.  It is better to specify the actual IP
  84 of the virtual domain as it reduces the need for a domain lookup
  85 and eliminates DNS security related naming issues.
  86
  87     10.196.145.20     /etc/ftpd/config/faqs.org/
  88     ftp.some.domain   /etc/ftpd/config/faqs.org/
  89
  90 As usual, comment lines are depicted with a # sign. Both comment lines
  91 and blanklines are ignored.
  92 .P
  93 .SH See Also
  94 .BR ftpd(8) ,
  95 .BR ftpaccess(5)
  96 .BR ftplog(5) ,
  97 .BR ftpconversions(5) ,
  98 .BR ftphosts(5)