NAME [Toc] [Back]
pam_setcred - modify/delete user credentials for an authentication
SYNOPSIS [Toc] [Back]
cc [ flag ... ] file ... -lpam [ library ... ]
int pam_setcred(pam_handle_t *pamh, int flags);
DESCRIPTION [Toc] [Back]
pam_setcred() is used to establish, modify, or delete user
credentials. pam_setcred() 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 pam_start() or
pam_set_item(), 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:
PAM_ESTABLISH_CRED Set user credentials for an authentication
PAM_DELETE_CRED Delete user credentials associated with an
PAM_REINITIALIZE_CRED Reinitialize user credentials.
PAM_REFRESH_CRED Extend lifetime of user credentials.
PAM_SILENT Authentication service should not generate
If none of the flags are set, PAM_ESTABLISH_CRED is used as the
APPLICATION USAGE [Toc] [Back]
Refer to pam(3) for information on thread-safety of PAM interfaces.
RETURN VALUES [Toc] [Back]
Upon success, pam_setcred() returns PAM_SUCCESS. In addition to the
error return values described in pam(3), the following values may be
returned upon error:
PAM_CRED_UNAVAIL Underlying authentication service can not
retrieve user credentials unavailable.
PAM_CRED_EXPIRED User credentials expired.
Hewlett-Packard Company - 1 - HP-UX 11i Version 2: August 2003
PAM_USER_UNKNOWN User unknown to underlying authentication
PAM_CRED_ERR Failure setting user credentials.
SEE ALSO [Toc] [Back]
pam(3), pam_start(3), pam_authenticate(3), pam_acct_mgmt(3),
Hewlett-Packard Company - 2 - HP-UX 11i Version 2: August 2003 [ Back ]