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

   1 .\"
   2 .\" $FreeBSD$
   3 .\"
   4 .Dd January 27, 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 .Pp
  38 The third field should be a list
  39 of one or more tty names (for non-networked logins), host names, domain
  40 names (begin with "."), host addresses, internet network numbers (end
  41 with "."), ALL (always matches) or LOCAL (matches any string that does
  42 not contain a "." character).
  43 If you run NIS you can use @netgroupname
  44 in host or user patterns.
  45 .Pp
  46 The EXCEPT operator makes it possible to write very compact rules.
  47 .Pp
  48 The group file is searched only when a name does not match that of the
  49 logged-in user.
  50 Only groups are matched in which users are explicitly
  51 listed: the program does not look at a user's primary group id value.
  52 .Sh FILES
  53 .Bl -tag -width /etc/login.access -compact
  54 .It Pa /etc/login.access
  55 login access control table
  56 .El
  57 .Sh SEE ALSO
  58 .Xr login 1 ,
  59 .Xr pam_login_access 8
  60 .Sh AUTHORS
  61 .An Guido van Rooij