pam_sm_acct_mgmt(3) — Linux manual page


PAM_SM_ACCT_MGMT(3)         Linux-PAM Manual         PAM_SM_ACCT_MGMT(3)

NAME         top

       pam_sm_acct_mgmt - PAM service function for account management

SYNOPSIS         top

       #include <security/pam_modules.h>

       int pam_sm_acct_mgmt(pam_handle_t *pamh, int flags, int argc,
                            const char **argv);

DESCRIPTION         top

       The pam_sm_acct_mgmt function is the service module's
       implementation of the pam_acct_mgmt(3) interface.

       This function performs the task of establishing whether the user
       is permitted to gain access at this time. It should be understood
       that the user has previously been validated by an authentication
       module. This function checks for other things. Such things might
       be: the time of day or the date, the terminal line, remote
       hostname, etc. This function may also determine things like the
       expiration on passwords, and respond that the user change it
       before continuing.

       Valid flags, which may be logically OR'd with PAM_SILENT, are:

           Do not emit any messages.

           Return PAM_AUTH_ERR if the database of authentication tokens
           for this authentication mechanism has a NULL entry for the

RETURN VALUES         top

           User account has expired.

           Authentication failure.

           The user's authentication token has expired. Before calling
           this function again the application will arrange for a new
           one to be given. This will likely result in a call to

           Permission denied.

           The authentication token was successfully updated.

           User unknown to password service.

SEE ALSO         top

       pam(3), pam_acct_mgmt(3), pam_sm_chauthtok(3), pam_strerror(3),

COLOPHON         top

       This page is part of the linux-pam (Pluggable Authentication
       Modules for Linux) project.  Information about the project can be
       found at ⟨⟩.  If you have a bug report
       for this manual page, see ⟨//⟩.  This page was
       obtained from the project's upstream Git repository
       ⟨⟩ 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

Linux-PAM Manual               12/22/2023            PAM_SM_ACCT_MGMT(3)

Pages that refer to this page: pam_debug(8)