summaryrefslogtreecommitdiffstats
path: root/modules/pam_lastlog/README
blob: 9b0cff9ca95d7ad7afa3a38c1b7774a05333e6b7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
pam_lastlog — PAM module to display date of last login and perform inactive
account lock out

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

DESCRIPTION

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

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.

EXAMPLES

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


AUTHOR

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

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