pam_lastlog(8) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | MODULE TYPES PROVIDED | RETURN VALUES | EXAMPLES | FILES | SEE ALSO | AUTHOR | COLOPHON

PAM_LASTLOG(8)              Linux-PAM Manual              PAM_LASTLOG(8)

NAME         top

       pam_lastlog - PAM module to display date of last login and
       perform inactive account lock out

SYNOPSIS         top


       pam_lastlog.so [debug] [silent] [never] [nodate] [nohost]
                      [noterm] [nowtmp] [noupdate] [showfailed]
                      [inactive=<days>] [unlimited]

DESCRIPTION         top

       pam_lastlog is a PAM module to display a line of information
       about the last login of the user. In addition, the module
       maintains the /var/log/lastlog file.

       Some applications may perform this function themselves. In such
       cases, this module is not necessary.

       The module checks LASTLOG_UID_MAX option in /etc/login.defs and
       does not update or display last login records for users with UID
       higher than its value. If the option is not present or its value
       is invalid, no user ID limit is applied.

       If the module is called in the auth or account phase, the
       accounts that were not used recently enough will be disallowed to
       log in. The check is not performed for the root account so the
       root is never locked out. It is also not performed for users with
       UID higher than the LASTLOG_UID_MAX value.

OPTIONS         top

       debug
           Print debug information.

       silent
           Don't inform the user about any previous login, just update
           the /var/log/lastlog file. This option does not affect
           display of bad login attempts.

       never
           If the /var/log/lastlog file does not contain any old entries
           for the user, indicate that the user has never previously
           logged in with a welcome message.

       nodate
           Don't display the date of the last login.

       noterm
           Don't display the terminal name on which the last login was
           attempted.

       nohost
           Don't indicate from which host the last login was attempted.

       nowtmp
           Don't update the wtmp entry.

       noupdate
           Don't update any file.

       showfailed
           Display number of failed login attempts and the date of the
           last failed attempt from btmp. The date is not displayed when
           nodate is specified.

       inactive=<days>
           This option is specific for the auth or account phase. It
           specifies the number of days after the last login of the user
           when the user will be locked out by the module. The default
           value is 90.

       unlimited
           If the fsize limit is set, this option can be used to
           override it, preventing failures on systems with large UID
           values that lead lastlog to become a huge sparse file.

MODULE TYPES PROVIDED         top

       The auth and account module type allows one to lock out users who
       did not login recently enough. The session module type is
       provided for displaying the information about the last login
       and/or updating the lastlog and wtmp files.

RETURN VALUES         top

       PAM_SUCCESS
           Everything was successful.

       PAM_SERVICE_ERR
           Internal service module error.

       PAM_USER_UNKNOWN
           User not known.

       PAM_AUTH_ERR
           User locked out in the auth or account phase due to
           inactivity.

       PAM_IGNORE
           There was an error during reading the lastlog file in the
           auth or account phase and thus inactivity of the user cannot
           be determined.

EXAMPLES         top

       Add the following line to /etc/pam.d/login to display the last
       login time of a user:

               session  required  pam_lastlog.so nowtmp

       To reject the user if he did not login during the previous 50
       days the following line can be used:

               auth  required  pam_lastlog.so inactive=50

FILES         top

       /var/log/lastlog
           Lastlog logging file

SEE ALSO         top

       limits.conf(5), pam.conf(5), pam.d(5), pam(8)

AUTHOR         top

       pam_lastlog was written by Andrew G. Morgan <morgan@kernel.org>.

       Inactive account lock out added by Tomáš Mráz <tm@t8m.info>.

COLOPHON         top

       This page is part of the linux-pam (Pluggable Authentication
       Modules for Linux) project.  Information about the project can be
       found at ⟨http://www.linux-pam.org/⟩.  If you have a bug report
       for this manual page, see ⟨//www.linux-pam.org/⟩.  This page was
       obtained from the project's upstream Git repository
       ⟨https://github.com/linux-pam/linux-pam.git⟩ on 2023-12-22.  (At
       that time, the date of the most recent commit that was found in
       the repository was 2023-12-18.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there
       is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

Linux-PAM Manual               12/22/2023                 PAM_LASTLOG(8)

Pages that refer to this page: su(1)