Debian Codegraph @

upstream/debian-unstable/man8/pam_timestamp_check.8

raw
1 '\" t
2 .\" Title: pam_timestamp_check
3 .\" Author: [see the "AUTHOR" section]
4 .\" Generator: DocBook XSL Stylesheets v1.79.2 <http://docbook.sf.net/>
5 .\" Date: 06/29/2025
6 .\" Manual: Linux-PAM Manual
7 .\" Source: Linux-PAM
8 .\" Language: English
9 .\"
10 .TH "PAM_TIMESTAMP_CHECK" "8" "06/29/2025" "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_check \- Check to see if the default timestamp is valid
32 .SH "SYNOPSIS"
33 .HP \w'\fBpam_timestamp_check\fR\ 'u
34 \fBpam_timestamp_check\fR [\-k] [\-d] [\fItarget_user\fR]
35 .SH "DESCRIPTION"
36 .PP
37 With no arguments
38 \fBpam_timestamp_check\fR
39 will check to see if the default timestamp is valid, or optionally remove it\&.
40 .SH "OPTIONS"
41 .PP
42 \-k
43 .RS 4
44 Instead of checking the validity of a timestamp, remove it\&. This is analogous to sudo\*(Aqs
45 \fI\-k\fR
46 option\&.
47 .RE
48 .PP
49 \-d
50 .RS 4
51 Instead of returning validity using an exit status, loop indefinitely, polling regularly and printing the status on standard output\&.
52 .RE
53 .PP
54 target_user
55 .RS 4
56 By default
57 \fBpam_timestamp_check\fR
58 checks or removes timestamps generated by
59 \fIpam_timestamp\fR
60 when users authenticate as themselves\&. When the user authenticates as a different user, the name of the timestamp file changes to accommodate this\&.
61 \fItarget_user\fR
62 allows one to specify this user name\&.
63 .RE
64 .SH "RETURN VALUES"
65 .PP
66 0
67 .RS 4
68 The timestamp is valid\&.
69 .RE
70 .PP
71 2
72 .RS 4
73 The binary is not setuid root\&.
74 .RE
75 .PP
76 3
77 .RS 4
78 Invalid invocation\&.
79 .RE
80 .PP
81 4
82 .RS 4
83 User is unknown\&.
84 .RE
85 .PP
86 5
87 .RS 4
88 Permissions error\&.
89 .RE
90 .PP
91 6
92 .RS 4
93 Invalid controlling tty\&.
94 .RE
95 .PP
96 7
97 .RS 4
98 Timestamp is not valid\&.
99 .RE
100 .SH "NOTES"
101 .PP
102 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\&.
103 .SH "EXAMPLES"
104 .sp
105 .if n \{\
106 .RS 4
107 .\}
108 .nf
109 auth sufficient pam_timestamp\&.so verbose
110 auth required pam_unix\&.so
111
112 session required pam_unix\&.so
113 session optional pam_timestamp\&.so
114
115 .fi
116 .if n \{\
117 .RE
118 .\}
119 .SH "FILES"
120 .PP
121 /var/run/sudo/\&.\&.\&.
122 .RS 4
123 timestamp files and directories
124 .RE
125 .SH "SEE ALSO"
126 .PP
127 \fBpam_timestamp_check\fR(8),
128 \fBpam.conf\fR(5),
129 \fBpam.d\fR(5),
130 \fBpam\fR(7)
131 .SH "AUTHOR"
132 .PP
133 pam_timestamp was written by Nalin Dahyabhai\&.