1 .\" $NetBSD: ftpusers.5,v 1.15 2003-07-26 19:32:07 salo 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.
49 file provides user access control for
51 by defining which users may login.
55 file does not exist, all users are denied access.
59 is the escape character; it can be used to escape the meaning of the
60 comment character, or if it is the last character on a line, extends
61 a configuration directive across multiple lines.
64 is the comment character, and all characters from it to the end of
65 line are ignored (unless it is escaped with the escape character).
67 The syntax of each line is:
68 .Dl userglob[:groupglob][@host] [directive [class]]
71 .Bl -tag -width "groupglob" -offset indent
73 matched against the user name, using
79 matched against all the groups that the user is a member of, using
85 either a CIDR address (refer to
87 to match against the remote address
92 glob to match against the remote hostname
100 the user is allowed access.
107 is not given, the user is denied access.
109 defines the class to use in
115 is not given, it defaults to one of the following:
116 .Bl -tag -width "chroot" -offset indent
118 If there is a match in
127 If neither of the above is true.
130 No further comparisons are attempted after the first successful match.
131 If no match is found, the user is granted access.
132 This syntax is backward-compatible with the old syntax.
134 If a user requests a guest login, the
136 server checks to see that
141 have access, so if you deny all users by default, you will need to add both
142 .Dq "anonymous allow"
147 in order to allow guest logins.
151 is used to determine which users will have their session's root directory
154 either to the directory specified in the
158 or to the home directory of the user.
159 If the file does not exist, the root directory change is not performed.
161 The syntax is similar to
166 If there's a positive match, the session's root directory is changed.
167 No further comparisons are attempted after the first successful match.
168 This syntax is backward-compatible with the old syntax.
170 .Bl -tag -width /usr/share/examples/ftpd/ftpusers -compact
171 .It Pa /etc/ftpchroot
172 List of normal users who should have their ftp session's root directory
177 .It Pa /usr/share/examples/ftpd/ftpusers
184 .Xr inet_net_pton 3 ,