1ftpservers(4)                    File Formats                    ftpservers(4)
2
3
4

NAME

6       ftpservers - FTP Server virtual hosting configuration file
7

SYNOPSIS

9       /etc/ftpd/ftpservers
10
11

DESCRIPTION

13       The  ftpservers  file is used to configure complete virtual hosting. In
14       contrast to limited virtual hosting, complete  virtual  hosting  allows
15       separate configuration files to be specified for each virtual host.
16
17
18       The  set  of  configuration  files  for each virtual host are placed in
19       their own directory. The ftpservers file associates the address of each
20       virtual  host with the directory its configuration files are stored in.
21       The virtual host configuration files must be named:
22
23       ftpaccess         Virtual host's access file
24
25
26       ftpusers          Restricts the accounts that can use the virtual host
27
28
29       ftpgroups         Virtual hosts enhanced group access file
30
31
32       ftphosts          Allow or deny usernames access to the virtual host
33
34
35       ftpconversions    Customize conversions available from the virtual host
36
37
38
39       You do not need to put every file in each virtual  host  directory.  If
40       you  want  a virtual host to use the master copy of a file, then do not
41       include it in the virtual host directory. If the file is not  included,
42       the master copy from the /etc/ftpd directory will be used.
43
44
45       The file names must match exactly. If you misspell any of  them or name
46       them differently, the server will not find them, and  the  server  will
47       use the master copy instead.
48
49
50       The  ftpaddhost  utility is an administrative tool to configure virtual
51       hosts. See ftpaddhost(1M).
52
53   File Format
54       There are two fields to each entry in the ftpservers file:
55
56         address   directory-containing-configuration-files
57
58
59
60       For example:
61
62         10.196.145.10    /etc/ftpd/virtual-ftpd/10.196.145.10
63         10.196.145.200   /etc/ftpd//virtual-ftpd/10.196.145.200
64         some.domain      INTERNAL
65
66
67
68       When an FTP client connects to the FTP  Server,  in.ftpd(1M)  tries  to
69       match  the  IP address to which the FTP client connected with one found
70       in the ftpservers file.
71
72
73       The address can be an IPv4 or IPv6 address, or a hostname.
74
75
76       If a match is found, The FTP server uses any configuration files  found
77       in the associated directory.
78
79
80       If  a match is not found,  or an invalid directory path is encountered,
81       the default paths to the configuration  files  are  used.  The  use  of
82       INTERNAL in the example above fails the check for a specific directory,
83       and the master configuration files will be used.
84
85
86       Either the actual IP address or a specific  hostname  can  be  used  to
87       specify  the virtual host. It is better to specify the actual IP of the
88       virtual host, as it reduces the need for a domain lookup and eliminates
89       DNS security related naming issues, for example:
90
91         10.196.145.20     /etc/ftpd/config/faqs.org/
92         ftp.some.domain   /etc/ftpd/config/faqs.org/
93
94
95
96       Lines  that  begin  with  a # sign are treated as comment lines and are
97       ignored.
98

FILES

100       /etc/ftpd/ftpservers
101
102

ATTRIBUTES

104       See attributes(5)  for descriptions of the following attributes:
105
106
107
108
109       ┌─────────────────────────────┬─────────────────────────────┐
110       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
111       ├─────────────────────────────┼─────────────────────────────┤
112       │Availability                 │SUNWftpr                     │
113       ├─────────────────────────────┼─────────────────────────────┤
114       │Interface Stability          │External                     │
115       └─────────────────────────────┴─────────────────────────────┘
116

SEE ALSO

118       ftpaddhost(1M),  in.ftpd(1M),  ftpaccess(4),  ftpconversions(4),   ftp‐
119       groups(4), ftphosts(4), ftpusers(4), attributes(5)
120
121
122
123SunOS 5.11                        1 May 2003                     ftpservers(4)
Impressum