Debian Codegraph @

upstream/fedora-44/man8/pam_timestamp.8

raw
1 '\" t
2 .\" Title: pam_timestamp
3 .\" Author: [see the "AUTHOR" section]
4 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
5 .\" Date: 01/23/2026
6 .\" Manual: Linux-PAM Manual
7 .\" Source: Linux-PAM
8 .\" Language: English
9 .\"
10 .TH "PAM_TIMESTAMP" "8" "01/23/2026" "Linux\-PAM" "Linux\-PAM Manual"
11 .\" -----------------------------------------------------------------
12 .\" * Define some portability stuff
13 .\" -----------------------------------------------------------------
14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15 .\" http://bugs.debian.org/507673
16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
18 .ie \n(.g .ds Aq \(aq
19 .el .ds Aq '
20 .\" -----------------------------------------------------------------
21 .\" * set default formatting
22 .\" -----------------------------------------------------------------
23 .\" disable hyphenation
24 .nh
25 .\" disable justification (adjust text to left margin only)
26 .ad l
27 .\" -----------------------------------------------------------------
28 .\" * MAIN CONTENT STARTS HERE *
29 .\" -----------------------------------------------------------------
30 .SH "NAME"
31 pam_timestamp \- Authenticate using cached successful authentication attempts
32 .SH "SYNOPSIS"
33 .HP \w'\fBpam_timestamp\&.so\fR\ 'u
34 \fBpam_timestamp\&.so\fR [timestampdir=\fIdirectory\fR] [timestamp_timeout=\fInumber\fR] [verbose] [debug]
35 .SH "DESCRIPTION"
36 .PP
37 In a nutshell,
38 \fIpam_timestamp\fR
39 caches successful authentication attempts, and allows you to use a recent successful attempt as the basis for authentication\&. This is similar mechanism which is used in
40 \fBsudo\fR\&.
41 .PP
42 When an application opens a session using
43 \fIpam_timestamp\fR, a timestamp file is created in the
44 \fItimestampdir\fR
45 directory for the user\&. When an application attempts to authenticate the user, a
46 \fIpam_timestamp\fR
47 will treat a sufficiently recent timestamp file as grounds for succeeding\&.
48 .PP
49 The default encryption hash is taken from the
50 \fBHMAC_CRYPTO_ALGO\fR
51 variable from
52 \fI/etc/login\&.defs\fR\&.
53 .SH "OPTIONS"
54 .PP
55 timestampdir=directory
56 .RS 4
57 Specify an alternate directory where
58 \fIpam_timestamp\fR
59 creates timestamp files\&.
60 .RE
61 .PP
62 timestamp_timeout=number
63 .RS 4
64 How long should
65 \fIpam_timestamp\fR
66 treat timestamp as valid after their last modification date (in seconds)\&. Default is 300 seconds\&.
67 .RE
68 .PP
69 verbose
70 .RS 4
71 Attempt to inform the user when access is granted\&.
72 .RE
73 .PP
74 debug
75 .RS 4
76 Turns on debugging messages sent to
77 \fBsyslog\fR(3)\&.
78 .RE
79 .SH "MODULE TYPES PROVIDED"
80 .PP
81 The
82 \fBauth\fR
83 and
84 \fBsession\fR
85 module types are provided\&.
86 .SH "RETURN VALUES"
87 .PP
88 PAM_AUTH_ERR
89 .RS 4
90 The module was not able to retrieve the user name or no valid timestamp file was found\&.
91 .RE
92 .PP
93 PAM_SUCCESS
94 .RS 4
95 Everything was successful\&.
96 .RE
97 .PP
98 PAM_SESSION_ERR
99 .RS 4
100 Timestamp file could not be created or updated\&.
101 .RE
102 .SH "NOTES"
103 .PP
104 Users can get confused when they are not always asked for passwords when running a given program\&. Some users reflexively begin typing information before noticing that it is not being asked for\&.
105 .SH "EXAMPLES"
106 .sp
107 .if n \{\
108 .RS 4
109 .\}
110 .nf
111 auth sufficient pam_timestamp\&.so verbose
112 auth required pam_unix\&.so
113
114 session required pam_unix\&.so
115 session optional pam_timestamp\&.so
116
117 .fi
118 .if n \{\
119 .RE
120 .\}
121 .SH "FILES"
122 .PP
123 /var/run/pam_timestamp/\&.\&.\&.
124 .RS 4
125 timestamp files and directories
126 .RE
127 .SH "SEE ALSO"
128 .PP
129 \fBpam_timestamp_check\fR(8),
130 \fBpam.conf\fR(5),
131 \fBpam.d\fR(5),
132 \fBpam\fR(8)
133 .SH "AUTHOR"
134 .PP
135 pam_timestamp was written by Nalin Dahyabhai\&.