granicus.if.org Git - shadow/blob - man/login.access.5

   1 .\"     Title: login.access
   2 .\"    Author:
   3 .\" Generator: DocBook XSL Stylesheets v1.70.1 <http://docbook.sf.net/>
   4 .\"      Date: 06/06/2006
   5 .\"    Manual: File Formats and Conversions
   6 .\"    Source: File Formats and Conversions
   7 .\"
   8 .TH "LOGIN.ACCESS" "5" "06/06/2006" "File Formats and Conversions" "File Formats and Conversions"
   9 .\" disable hyphenation
  10 .nh
  11 .\" disable justification (adjust text to left margin only)
  12 .ad l
  13 .SH "NAME"
  14 login.access \- login access control table
  15 .SH "DESCRIPTION"
  16 .PP
  17 The
  18 \fIlogin.access\fR
  19 file specifies (user, host) combinations and/or (user, tty) combinations for which a login will be either accepted or refused.
  20 .PP
  21 When someone logs in, the
  22 \fIlogin.access\fR
  23 is scanned for the first entry that matches the (user, host) combination, or, in case of non\-networked logins, the first entry that matches the (user, tty) combination. The permissions field of that table entry determines whether the login will be accepted or refused.
  24 .PP
  25 Each line of the login access control table has three fields separated by a ":" character:
  26 .PP
  27
  28 \fIpermission\fR:\fIusers\fR:\fIorigins\fR
  29 .PP
  30 The first field should be a "\fI+\fR" (access granted) or "\fI\-\fR" (access denied) character. The second field should be a list of one or more login names, group names, or
  31 \fIALL\fR
  32 (always matches). The third field should be a list of one or more tty names (for non\-networked logins), host names, domain names (begin with "."), host addresses, internet network numbers (end with "."),
  33 \fIALL\fR
  34 (always matches) or
  35 \fILOCAL\fR
  36 (matches any string that does not contain a "." character). If you run NIS you can use @netgroupname in host or user patterns.
  37 .PP
  38 The
  39 \fIEXCEPT\fR
  40 operator makes it possible to write very compact rules.
  41 .PP
  42 The group file is searched only when a name does not match that of the logged\-in user. Only groups are matched in which users are explicitly listed: the program does not look at a user's primary group id value.
  43 .SH "FILES"
  44 .TP 3n
  45 \fI/etc/login.defs\fR
  46 Shadow password suite configuration.
  47 .SH "SEE ALSO"
  48 .PP
  49
  50 \fBlogin\fR(1).