PAM Library Functions                           pam_setcred(3PAM)

NAME
     pam_setcred - modify/delete user credentials for an  authen-
     tication service

SYNOPSIS
     cc [ flag ... ] file ... -lpam [ library ... ]
     #include <security/pam_appl.h>

     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
     opened.   See  pam_authenticate(3PAM),  pam_acct_mgmt(3PAM),
     and pam_open_session(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 authentication service.

     PAM_DELETE_CRED
           Delete user credentials associated with an authentica-
           tion service.

     PAM_REINITIALIZE_CRED
           Reinitialize user credentials.

     PAM_REFRESH_CRED
           Extend lifetime of user credentials.

     PAM_SILENT
           Authentication service should not  generate  any  mes-
           sages.

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

RETURN VALUES
     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 unavailable.

SunOS 5.8           Last change: 13 Oct 1998                    1

PAM Library Functions                           pam_setcred(3PAM)

     PAM_CRED_EXPIRED
           User credentials expired.

     PAM_USER_UNKNOWN
           User unknown to underlying authentication 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         |  Stable                     |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe with exceptions     |
    |_____________________________|_____________________________|

SEE ALSO
     pam(3PAM),   pam_acct_mgmt(3PAM),    pam_authenticate(3PAM),
     pam_open_session(3PAM), pam_set_item(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.8           Last change: 13 Oct 1998                    2