PAM Library Functions                         pamacctmgmt(3PAM)



NAME
     pamacctmgmt - perform PAM account validation procedures

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



     int pamacctmgmt(pamhandlet *pamh, int flags);


DESCRIPTION
     The pamacctmgmt() 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 pamauthenticate(3PAM).


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

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


     PAMDISALOWNULAUTHTOK    The account management  service
                                  should                   return
                                  PAMNEWAUTHTOKREQD   if   the
                                  user  has a null authentication
                                  token.


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

     PAMUSERUNKNOWN        User not known to underlying account
                             management module.


     PAMAUTHER            Authentication failure.


     PAMNEWAUTHTOKREQD    New authentication  token  required.
                             This  is  normally  returned  if the
                             machine  security  policies  require
                             that  the password should be changed



SunOS 5.11          Last change: 13 Oct 1998                    1






PAM Library Functions                         pamacctmgmt(3PAM)



                             because the password is  NUL or has
                             aged.


     PAMACTEXPIRED        User account has expired.


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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability           Stable                     
    
     MT-Level                     MT-Safe with exceptions     
    


SEE ALSO
     pam(3PAM),     pamauthenticate(3PAM),      pamstart(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