PAM_TIMESTAMP(8)

  .SH "NAME" pam_timestamp - Authenticate using cached successful authentication attempts
  .SH "SYNOPSIS"
    .HP u
      pam_timestamp.so
       [timestampdir=directory]
       [timestamp_timeout=number]
       [verbose]
       [debug]

  .SH "DESCRIPTION"

    .PP In a nutshell, pam_timestamp 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 sudo.
    .PP When an application opens a session using pam_timestamp, a timestamp file is created in the timestampdir directory for the user. When an application attempts to authenticate the user, a pam_timestamp will treat a sufficiently recent timestamp file as grounds for succeeding.

  .SH "OPTIONS"

      .PP timestampdir=directory

                Specify an alternate directory where pam_timestamp creates timestamp files.

          .RE
          .PP timestamp_timeout=number

                    How long should pam_timestamp treat timestamp as valid after their last modification date (in seconds). Default is 300 seconds.

              .RE
              .PP verbose

                        Attempt to inform the user when access is granted.

                  .RE
                  .PP debug

                            Turns on debugging messages sent to syslog(3).

                      .RE

                  .SH "MODULE TYPES PROVIDED"

                    .PP The auth and session module types are provided.

                  .SH "RETURN VALUES"

                      .PP PAM_AUTH_ERR

                              The module was not able to retrieve the user name or no valid timestamp file was found.

                          .RE
                          .PP PAM_SUCCESS

                                  Everything was successful.

                              .RE
                              .PP PAM_SESSION_ERR

                                      Timestamp file could not be created or updated.

                                  .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/pam_timestamp/...

                                          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.