1 .\" $NetBSD: ftpusers.5,v 1.13 2001/12/01 16:24:24 wiz Exp $
3 .\" Copyright (c) 1997-2001 The NetBSD Foundation, Inc.
4 .\" All rights reserved.
6 .\" This code is derived from software contributed to The NetBSD Foundation
9 .\" Redistribution and use in source and binary forms, with or without
10 .\" modification, are permitted provided that the following conditions
12 .\" 1. Redistributions of source code must retain the above copyright
13 .\" notice, this list of conditions and the following disclaimer.
14 .\" 2. Redistributions in binary form must reproduce the above copyright
15 .\" notice, this list of conditions and the following disclaimer in the
16 .\" documentation and/or other materials provided with the distribution.
17 .\" 3. All advertising materials mentioning features or use of this software
18 .\" must display the following acknowledgement:
19 .\" This product includes software developed by the NetBSD
20 .\" Foundation, Inc. and its contributors.
21 .\" 4. Neither the name of The NetBSD Foundation nor the names of its
22 .\" contributors may be used to endorse or promote products derived
23 .\" from this software without specific prior written permission.
25 .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
26 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
27 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
28 .\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
29 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
30 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
31 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
32 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
33 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
34 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
35 .\" POSSIBILITY OF SUCH DAMAGE.
52 file provides user access control for
54 by defining which users may login.
58 file does not exist, all users are denied access.
62 is the escape character; it can be used to escape the meaning of the
63 comment character, or if it is the last character on a line, extends
64 a configuration directive across multiple lines.
67 is the comment character, and all characters from it to the end of
68 line are ignored (unless it is escaped with the escape character).
70 The syntax of each line is:
71 .Dl userglob[:groupglob][@host] [directive [class]]
74 .Bl -tag -width "groupglob" -offset indent
76 matched against the user name, using
82 matched against all the groups that the user is a member of, using
88 either a CIDR address (refer to
90 to match against the remote address
95 glob to match against the remote hostname
103 the user is allowed access.
110 is not given, the user is denied access.
112 defines the class to use in
118 is not given, it defaults to one of the following:
119 .Bl -tag -width "chroot" -offset indent
121 If there is a match in
130 If neither of the above is true.
133 No further comparisons are attempted after the first successful match.
134 If no match is found, the user is granted access.
135 This syntax is backward-compatible with the old syntax.
137 If a user requests a guest login, the
139 server checks to see that
144 have access, so if you deny all users by default, you will need to add both
145 .Dq "anonymous allow"
150 in order to allow guest logins.
154 is used to determine which users will have their session's root directory
157 either to the directory specified in the
161 or to the home directory of the user.
162 If the file does not exist, the root directory change is not performed.
164 The syntax is similar to
169 If there's a positive match, the session's root directory is changed.
170 No further comparisons are attempted after the first successful match.
171 This syntax is backward-compatible with the old syntax.
173 .Bl -tag -width /usr/share/examples/ftpd/ftpusers -compact
174 .It Pa /etc/ftpchroot
175 List of normal users who should have their ftp session's root directory
180 .It Pa /usr/share/examples/ftpd/ftpusers
187 .Xr inet_net_pton 3 ,