|
HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|
|
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | MODULE TYPES PROVIDED | RETURN VALUES | EXAMPLES | FILES | SEE ALSO | AUTHOR | COLOPHON |
|
|
|
PAM_LASTLOG(8) Linux-PAM Manual PAM_LASTLOG(8)
pam_lastlog - PAM module to display date of last login and perform
inactive account lock out
pam_lastlog.so [debug] [silent] [never] [nodate] [nohost] [noterm]
[nowtmp] [noupdate] [showfailed] [inactive=<days>]
[unlimited]
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.
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.
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.
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.
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
/var/log/lastlog
Lastlog logging file
limits.conf(5), pam.conf(5), pam.d(5), pam(8)
pam_lastlog was written by Andrew G. Morgan <morgan@kernel.org>.
Inactive account lock out added by Tomáš Mráz <tm@t8m.info>.
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)
|
HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|