No empty .Rs/.Re
[netbsd-mini2440.git] / crypto / dist / heimdal / appl / login / login.access.5
blobd5553e9ac12286ab9920b072adfcabe6796ea4f6
1 .\" $Heimdal: login.access.5 11902 2003-03-24 15:49:30Z joda $
2 .\" $NetBSD$
3 .\" 
4 .Dd March 21, 2003
5 .Dt LOGIN.ACCESS 5
6 .Os
7 .Sh NAME
8 .Nm login.access
9 .Nd
10 login access control table
11 .Sh DESCRIPTION
12 The
13 .Nm login.access
14 file specifies on which ttys or from which hosts certain users are
15 allowed to login.
16 .Pp
17 At login, the
18 .Pa /etc/login.access 
19 file is checked for the first entry that matches a specific user/host
20 or user/tty combination. That entry can either allow or deny login
21 access to that user.
22 .Pp
23 Each entry have three fields separated by colon:
24 .Bl -bullet
25 .It
26 The first field indicates the permission given if the entry matches.
27 It can be either
28 .Dq +
29 (allow access)
31 .Dq -
32 (deny access) .
33 .It
34 The second field is a comma separated list of users or groups for
35 which the current entry applies. NIS netgroups can used (if
36 configured) if preceeded by @. The magic string ALL matches all users.
37 A group will match if the user is a member of that group, or it is the
38 user's primary group.
39 .It
40 The third field is a list of ttys, or network names. A network name
41 can be either a hostname, a domain (indicated by a starting period),
42 or a netgroup. As with the user list, ALL matches anything. LOCAL
43 matches a string not containing a period.
44 .El
45 .Pp
46 If the string EXCEPT is found in either the user or from list, the
47 rest of the list are exceptions to the list before EXCEPT.
48 .Sh BUGS
49 If there's a user and a group with the same name, there is no way to
50 make the group match if the user also matches.
51 .Sh SEE ALSO
52 .Xr login 1
53 .Sh AUTHORS
54 The
55 .Fn login_access
56 function was written by 
57 Wietse Venema. This manual page was written for Heimdal.