NAME

pam_set_mapped_username - set a username

SYNOPSIS

#include <security/pam_appl.h>

int pam_set_mapped_username (
    pam_handle_t    *pamh,
    char            *src_username,
    char            *src_module_type,
    char            *src_authn_domain,
    char            *target_module_username,
    char            *target_module_type,
    char            *target_authn_domain,
);

DESCRIPTION

The pam_set_mapped_username() function stores a username using the target_module_type and target_authn_domain parameters supplied.

The arguments for pam_set_mapped_username() are:

pamh (in)

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

target_module_username (in)

The target username 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.