PAM_TIMESTAMP_CHECK(8)

  .SH "NAME" pam_timestamp_check - Check to see if the default timestamp is valid
  .SH "SYNOPSIS"
    .HP u
      pam_timestamp_check
       [-k]
       [-d]
       [target_user]

  .SH "DESCRIPTION"

    .PP With no arguments pam_timestamp_check will check to see if the default timestamp is valid, or optionally remove it.

  .SH "OPTIONS"

      .PP -k

                Instead of checking the validity of a timestamp, remove it. This is analogous to sudo's -k option.

          .RE
          .PP -d

                    Instead of returning validity using an exit status, loop indefinitely, polling regularly and printing the status on standard output.

              .RE
              .PP target_user

                        By default pam_timestamp_check checks or removes timestamps generated by pam_timestamp when users authenticate as themselves. When the user authenticates as a different user, the name of the timestamp file changes to accommodate this. target_user allows one to specify this user name.

                  .RE

              .SH "RETURN VALUES"

                  .PP 0

                          The timestamp is valid.

                      .RE
                      .PP 2

                              The binary is not setuid root.

                          .RE
                          .PP 3

                                  Invalid invocation.

                              .RE
                              .PP 4

                                      User is unknown.

                                  .RE
                                  .PP 5

                                          Permissions error.

                                      .RE
                                      .PP 6

                                              Invalid controlling tty.

                                          .RE
                                          .PP 7

                                                  Timestamp is not valid.

                                              .RE

                                          .SH "NOTES"

                                            .PP 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.

                                          .SH "EXAMPLES"

                                            auth sufficient pam_timestamp.so verbose
                                            auth required   pam_unix.so
                                            session required pam_unix.so
                                            session optional pam_timestamp.so

                                          .SH "FILES"

                                              .PP /var/run/sudo/...

                                                      timestamp files and directories

                                                  .RE

                                              .SH "SEE ALSO"

                                                .PP pam_timestamp_check(8), pam.conf(5), pam.d(5), pam(8)

                                              .SH "AUTHOR"

                                                  .PP pam_timestamp was written by Nalin Dahyabhai.