Establishes, changes, or removes user credentials for authentication.
PAM Library (libpam.a)
#include <security/pam_appl.h>
int pam_setcred (PAMHandle, Flags)
pam_handle_t *PAMHandle;
int Flags;
The pam_setcred subroutine allows for the credentials of the PAM user for the current PAM session to be modified. Functions such as establishing, deleting, renewing, and refreshing credentials are defined.
Item | Description |
---|---|
PAMhandle | The PAM handle representing the current user authentication session. This handle is obtained by a call to pam_start(). |
Flags | The flags are used to set pam_setcred options.
The recognized flags are:
|
Upon successful completion, pam_setcred returns PAM_SUCCESS. If the routine fails, a different error is returned, depending on the actual error.
Item | Description |
---|---|
PAM_CRED_UNAVAIL | The user credentials cannot be found. |
PAM_CRED_EXPIRED | The user's credentials have expired. |
PAM_CRED_ERR | A failure occurred while setting user credentials. |
PAM_USER_UNKNOWN | The user is not known. |
PAM_OPEN_ERR | One of the PAM authentication modules could not be loaded. |
PAM_SYMBOL_ERR | A necessary item is not available to a PAM module. |
PAM_SERVICE_ERR | An error occurred in a PAM module. |
PAM_SYSTEM_ERR | A system error occurred. |
PAM_BUF_ERR | A memory error occurred. |
PAM_CONV_ERR | A conversation error occurred. |
PAM_PERM_DENIED | Access permission was denied to the user. |