1ftpservers(4) File Formats ftpservers(4)
2
3
4
6 ftpservers - FTP Server virtual hosting configuration file
7
9 /etc/ftpd/ftpservers
10
11
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
100 /etc/ftpd/ftpservers
101
102
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
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)