pam_timestamp(8)

1PAM_TIMESTAMP(8)               Linux-PAM Manual               PAM_TIMESTAMP(8)
2
3
4

NAME

6       pam_timestamp - Authenticate using cached successful authentication
7       attempts
8

SYNOPSIS

10       pam_timestamp.so [timestampdir=directory] [timestamp_timeout=number]
11                        [verbose] [debug]
12

DESCRIPTION

14       In a nutshell, pam_timestamp caches successful authentication attempts,
15       and allows you to use a recent successful attempt as the basis for
16       authentication. This is similar mechanism which is used in sudo.
17
18       When an application opens a session using pam_timestamp, a timestamp
19       file is created in the timestampdir directory for the user. When an
20       application attempts to authenticate the user, a pam_timestamp will
21       treat a sufficiently recent timestamp file as grounds for succeeding.
22
23       The default encryption hash is taken from the HMAC_CRYPTO_ALGO variable
24       from /etc/login.defs.
25

OPTIONS

27       timestampdir=directory
28           Specify an alternate directory where pam_timestamp creates
29           timestamp files.
30
31       timestamp_timeout=number
32           How long should pam_timestamp treat timestamp as valid after their
33           last modification date (in seconds). Default is 300 seconds.
34
35       verbose
36           Attempt to inform the user when access is granted.
37
38       debug
39           Turns on debugging messages sent to syslog(3).
40

MODULE TYPES PROVIDED

42       The auth and session module types are provided.
43

RETURN VALUES

45       PAM_AUTH_ERR
46           The module was not able to retrieve the user name or no valid
47           timestamp file was found.
48
49       PAM_SUCCESS
50           Everything was successful.
51
52       PAM_SESSION_ERR
53           Timestamp file could not be created or updated.
54

NOTES

56       Users can get confused when they are not always asked for passwords
57       when running a given program. Some users reflexively begin typing
58       information before noticing that it is not being asked for.
59

EXAMPLES

61           auth sufficient pam_timestamp.so verbose
62           auth required   pam_unix.so
63
64           session required pam_unix.so
65           session optional pam_timestamp.so
66
67

FILES

69       /var/run/pam_timestamp/...
70           timestamp files and directories
71

AUTHOR

76       pam_timestamp was written by Nalin Dahyabhai.
77
78
79
80Linux-PAM Manual                  09/03/2021                  PAM_TIMESTAMP(8)