NAME

pam_set_mapped_authtok - store the password for the username supplied

SYNOPSIS

#include <security/pam_appl.h>

int pam_set_mapped_authtok (
    pam_handle_t    *pamh,
    char            *target_module_username,
    size_t          *target_authtok_len,
    unsigned char   *target_module_authtok,
    char            *target_module_type,
    char            *target_authn_domain,
);

DESCRIPTION

The pam_set_mapped_authtok() function stores the password for the target_username supplied.

The arguments for pam_set_mapped_authtok() are:

pamh (in)

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

target_module_username (in)

The target username for which the password is to be stored.

target_authtok_len (in)

The length of the password to be stored.

target_module_authtok (in)

The password to be stored.

target_module_type (in)

The target authentication type; for example, UNIX.

target_authn_domain (in)

The target domain; for example, the UNIX hostname.

RETURN VALUE

The following PAM status codes shall be returned:

[PAM_SUCCESS]

Successful completion.

[PAM_USER_UNKNOWN]

The username supplied is not recognized.

[PAM_MODULE_UNKNOWN]

The mapping service does not support this module type.

[PAM_DOMAIN_UNKNOWN]

The mapping service does not support this module's domain.

[PAM_SERVICE_ERR]

The mapping service failed in reading/writing data.

[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 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.