modules/pam_lastlog/README

   1 pam_lastlog — PAM module to display date of last login and perform inactive
   2 account lock out
   3
   4 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   5
   6 DESCRIPTION
   7
   8 pam_lastlog is a PAM module to display a line of information about the last
   9 login of the user. In addition, the module maintains the /var/log/lastlog file.
  10
  11 Some applications may perform this function themselves. In such cases, this
  12 module is not necessary.
  13
  14 If the module is called in the auth or account phase, the accounts that were
  15 not used recently enough will be disallowed to log in. The check is not
  16 performed for the root account so the root is never locked out.
  17
  18 OPTIONS
  19
  20 debug
  21
  22     Print debug information.
  23
  24 silent
  25
  26     Don't inform the user about any previous login, just update the /var/log/
  27     lastlog file.
  28
  29 never
  30
  31     If the /var/log/lastlog file does not contain any old entries for the user,
  32     indicate that the user has never previously logged in with a welcome
  33     message.
  34
  35 nodate
  36
  37     Don't display the date of the last login.
  38
  39 noterm
  40
  41     Don't display the terminal name on which the last login was attempted.
  42
  43 nohost
  44
  45     Don't indicate from which host the last login was attempted.
  46
  47 nowtmp
  48
  49     Don't update the wtmp entry.
  50
  51 noupdate
  52
  53     Don't update any file.
  54
  55 showfailed
  56
  57     Display number of failed login attempts and the date of the last failed
  58     attempt from btmp. The date is not displayed when nodate is specified.
  59
  60 inactive=<days>
  61
  62     This option is specific for the auth or account phase. It specifies the
  63     number of days after the last login of the user when the user will be
  64     locked out by the module. The default value is 90.
  65
  66 EXAMPLES
  67
  68 Add the following line to /etc/pam.d/login to display the last login time of an
  69 user:
  70
  71     session  required  pam_lastlog.so nowtmp
  72
  73
  74 To reject the user if he did not login during the previous 50 days the
  75 following line can be used:
  76
  77     auth  required  pam_lastlog.so inactive=50
  78
  79
  80 AUTHOR
  81
  82 pam_lastlog was written by Andrew G. Morgan <morgan@kernel.org>.
  83
  84 Inactive account lock out added by Tomáš Mráz <tm@t8m.info>.
  85