NAME

pam_setcred - modify/delete user credentials for an authentication service

SYNOPSIS

#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 the credentials of the current user associated with the authentication handle, pamh.

The arguments for pam_setcred() are:

pamh (in)

The PAM authentication handle, which has been returned from a previous call to pam_start().

flags (in)

Flags may be set to one of the following:

PAM_SILENT

To disable messages from the authentication service.

PAM_ESTABLISH_CRED

To set user credentials. This is the default value.

PAM_DELETE_CRED

To delete user credentials associated with the authentication service.

PAM_REINITIALISE_CRED

To reinitialize user credentials.

PAM_REFRESH_CRED

To extend the lifetime of the user credentials.

RETURN VALUE

The following PAM status codes shall be returned:

[PAM_SUCCESS]

Successful completion.

[PAM_CRED_UNAVAIL]

The authentication service cannot retrieve the user credentials.

[PAM_CRED_EXPIRED]

The user credentials have expired.

[PAM_USER_UNKNOWN]

The user is unknown to the service.

[PAM_CRED_ERR]

Failure in setting user credentials.

[PAM_PERM_DENIED]

The caller does not possess the required authority.

[PAM_OPEN_ERR]

Failure when dynamically loading a service module.

[PAM_SYMBOL_ERR]

Symbol not found.

[PAM_SERVICE_ERR]

Error in service module.

[PAM_SYSTEM_ERR]

System error.

[PAM_BUF_ERR]

Memory buffer error.

[PAM_CONV_ERR]

Conversation error.

[??] Some characters or strings that appear in the printed document are not easily representable using HTML.