Manual Pages for UNIX Operating System command usage for man pam_setcred

PAM Library Functions                           pam_setcred(3PAM)



NAME
     pam_setcred - modify  or  delete  user  credentials  for  an
     authentication service

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



     int pam_setcred(pam_handle_t *pamh, int flags);


DESCRIPTION
     The pam_setcred() function is used to establish, modify,  or
     delete  user  credentials.  It is typically called after the
     user has been authenticated and after  a  session  has  been
     validated.        See       pam_authenticate(3PAM)       and
     pam_acct_mgmt(3PAM).


     The user is specified by a  prior  call  to  pam_start()  or
     pam_set_item(), and is referenced by the authentication han-
     dle, pamh. The following flags  may  be  set  in  the  flags
     field.    Note  that  the  first  four  flags  are  mutually
     exclusive:

     PAM_ESTABLISH_CRED       Set user credentials for an authen-
                              tication service.


     PAM_DELETE_CRED          Delete user credentials  associated
                              with an authentication service.


     PAM_REINITIALIZE_CRED    Reinitialize user credentials.


     PAM_REFRESH_CRED         Extend  lifetime  of  user  creden-
                              tials.


     PAM_SILENT               Authentication service  should  not
                              generate any messages.



     If no flag  is  set,   PAM_ESTABLISH_CRED  is  used  as  the
     default.

RETURN VALUES




SunOS 5.11          Last change: 10 Jan 2008                    1






PAM Library Functions                           pam_setcred(3PAM)



     Upon success, pam_setcred() returns  PAM_SUCCESS.  In  addi-
     tion  to  the error return values described in pam(3PAM) the
     following values may be returned upon error:

     PAM_CRED_UNAVAIL    Underlying  authentication  service  can
                         not  retrieve  user credentials unavail-
                         able.


     PAM_CRED_EXPIRED    User credentials expired.


     PAM_USER_UNKNOWN    User unknown to  underlying  authentica-
                         tion service.


     PAM_CRED_ERR        Failure setting user credentials.


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_acct_mgmt(3PAM),    pam_authenticate(3PAM),
     pam_set_item(3PAM),  pam_start(3PAM),  libpam(3LIB),  attri-
     butes(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: 10 Jan 2008                    2