Manual Pages for UNIX Operating System command usage for man pam_acct_mgmt

PAM Library Functions                         pam_acct_mgmt(3PAM)



NAME
     pam_acct_mgmt - perform PAM account validation procedures

SYNOPSIS
     cc [ flag ... ] file ... -lpam [ library ... ]
     #include 

     int pam_acct_mgmt(pam_handle_t *pamh, int flags);


DESCRIPTION
     The pam_acct_mgmt() function is called to determine  if  the
     current user's account is valid.  It checks for password and
     account expiration, and verifies access  hour  restrictions.
     This  function  is  typically called after the user has been
     authenticated with pam_authenticate(3PAM).


     The pamh argument is an authentication handle obtained by  a
     prior call to pam_start(). The following flags may be set in
     the flags field:

     PAM_SILENT                   The account management  service
                                  should  not  generate  any mes-
                                  sages.


     PAM_DISALLOW_NULL_AUTHTOK    The account management  service
                                  should                   return
                                  PAM_NEW_AUTHTOK_REQD   if   the
                                  user  has a null authentication
                                  token.


RETURN VALUES
     Upon successful completion,   PAM_SUCCESS  is  returned.  In
     addition  to the error return values described in pam(3PAM),
     the following values may be returned:

     PAM_USER_UNKNOWN        User not known to underlying account
                             management module.


     PAM_AUTH_ERR            Authentication failure.


     PAM_NEW_AUTHTOK_REQD    New authentication  token  required.
                             This  is  normally  returned  if the
                             machine  security  policies  require
                             that  the password should be changed
                             because the password is  NULL or has
                             aged.



SunOS 5.11          Last change: 13 Oct 1998                    1






PAM Library Functions                         pam_acct_mgmt(3PAM)



     PAM_ACCT_EXPIRED        User account has expired.


ATTRIBUTES
     See attributes(5) for description of  the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe with exceptions     |
    |_____________________________|_____________________________|


SEE ALSO
     pam(3PAM),     pam_authenticate(3PAM),      pam_start(3PAM),
     libpam(3LIB), attributes(5)

NOTES
     The interfaces in  libpam are MT-Safe only  if  each  thread
     within  the  multithreaded application uses its own PAM han-
     dle.





























SunOS 5.11          Last change: 13 Oct 1998                    2