lib/libpam/modules/pam_login_access/login.access.5

   1 .\"
   2 .\" $FreeBSD$
   3 .\"
   4 .Dd January 30, 2020
   5 .Dt LOGIN.ACCESS 5
   6 .Os
   7 .Sh NAME
   8 .Nm login.access
   9 .Nd login access control table
  10 .Sh SYNOPSIS
  11 .Pa /etc/login.access
  12 .Sh DESCRIPTION
  13 The
  14 .Nm
  15 file specifies (user, host) combinations and/or (user, tty)
  16 combinations for which a login will be either accepted or refused.
  17 .Pp
  18 When someone logs in, the
  19 .Nm
  20 is scanned for the first entry that
  21 matches the (user, host) combination, or, in case of non-networked
  22 logins, the first entry that matches the (user, tty) combination.
  23 The
  24 permissions field of that table entry determines whether the login will
  25 be accepted or refused.
  26 .Pp
  27 Each line of the login access control table has three fields separated by a
  28 .Ql \&:
  29 character:
  30 .Ar permission : Ns Ar users : Ns Ar origins
  31 .Pp
  32 The first field should be a "+" (access granted) or "-" (access denied)
  33 character.
  34 .Pp
  35 The second field should be a list of one or more login names,
  36 group names, or ALL (always matches).
  37 Group names must be enclosed in
  38 parentheses if the pam module specification for
  39 .Pa pam_login_access
  40 specifies the
  41 .Pa nodefgroup
  42 option.
  43 Otherwise, group names will only match if no usernames match.
  44 .Pp
  45 The third field should be a list
  46 of one or more tty names (for non-networked logins), host names, domain
  47 names (begin with "."), host addresses, internet network numbers (end
  48 with "."), ALL (always matches) or LOCAL (matches any string that does
  49 not contain a "." character).
  50 If you run NIS you can use @netgroupname
  51 in host or user patterns.
  52 .Pp
  53 The EXCEPT operator makes it possible to write very compact rules.
  54 .Pp
  55 The group file is searched only when a name does not match that of the
  56 logged-in user.
  57 Only groups are matched in which users are explicitly
  58 listed: the program does not look at a user's primary group id value.
  59 .Sh FILES
  60 .Bl -tag -width /etc/login.access -compact
  61 .It Pa /etc/login.access
  62 login access control table
  63 .El
  64 .Sh SEE ALSO
  65 .Xr login 1 ,
  66 .Xr pam_login_access 8
  67 .Sh AUTHORS
  68 .An Guido van Rooij