pam_time(8) — Linux manual page

PAM_TIME(8)                 Linux-PAM Manual                 PAM_TIME(8)

NAME

       pam_time - PAM module for time control access

SYNOPSIS

       pam_time.so [conffile=conf-file] [debug] [noaudit]

DESCRIPTION

       The pam_time PAM module does not authenticate the user, but
       instead it restricts access to a system and or specific
       applications at various times of the day and on specific days or
       over various terminal lines. This module can be configured to
       deny access to (individual) users based on their name, the time
       of day, the day of week, the service they are applying for and
       their terminal from which they are making their request.

       By default rules for time/port access are taken from config file
       /etc/security/time.conf. An alternative file can be specified
       with the conffile option.

       If Linux PAM is compiled with audit support the module will
       report when it denies access.

OPTIONS

       conffile=/path/to/time.conf
           Indicate an alternative time.conf style configuration file to
           override the default.

       debug
           Some debug information is printed with syslog(3).

       noaudit
           Do not report logins at disallowed time to the audit
           subsystem.

MODULE TYPES PROVIDED

       Only the account type is provided.

RETURN VALUES

       PAM_SUCCESS
           Access was granted.

       PAM_ABORT
           Not all relevant data could be gotten.

       PAM_BUF_ERR
           Memory buffer error.

       PAM_PERM_DENIED
           Access was not granted.

       PAM_USER_UNKNOWN
           The user is not known to the system.

FILES

       /etc/security/time.conf
           Default configuration file

EXAMPLES

           #%PAM-1.0
           #
           # apply pam_time accounting to login requests
           #
           login  account  required  pam_time.so

SEE ALSO

       time.conf(5), pam.d(5), pam(8).

AUTHOR

       pam_time was written by Andrew G. Morgan <morgan@kernel.org>.

COLOPHON

       This page is part of the linux-pam (Pluggable Authentication
       Modules for Linux) project.  Information about the project can be
       found at ⟨http://www.linux-pam.org/⟩.  If you have a bug report
       for this manual page, see ⟨//www.linux-pam.org/⟩.  This page was
       obtained from the project's upstream Git repository
       ⟨https://github.com/linux-pam/linux-pam.git⟩ on 2023-12-22.  (At
       that time, the date of the most recent commit that was found in
       the repository was 2023-12-18.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there
       is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

Linux-PAM Manual               12/22/2023                    PAM_TIME(8)

Pages that refer to this page: time.conf(5)

---