hpux man page for pam_setcred

pam_setcred(3)						     Library Functions Manual						    pam_setcred(3)

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

SYNOPSIS
       [ flag ... ] file ...  [ library ... ]

DESCRIPTION
       is  used  to  establish, modify, or delete user credentials.  is typically called after the user has been authenticated and after a session
       has been opened (refer to pam_authenticate(3), pam_acct_mgmt(3), and pam_open_session(3)).

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

       Set user credentials for an authentication service.

       Delete user credentials associated with an authentication service.

       Reinitialize user credentials.

       Extend lifetime of user credentials.

       Authentication service should not generate any messages.

       If none of the flags are set, is used as the default.

APPLICATION USAGE
       Refer to pam(3) for information on thread-safety of PAM interfaces.

RETURN VALUES
       Upon success, returns In addition to the error return values described in pam(3), the following values may be returned upon error:

       Underlying authentication service can not retrieve user credentials unavailable.

       User credentials expired.

       User unknown to underlying authentication service.

       Failure setting user credentials.

SEE ALSO
       pam(3), pam_start(3), pam_authenticate(3), pam_acct_mgmt(3), pam_open_session(3).

																    pam_setcred(3)