Previous section.

X/Open Single Sign-on Service (XSSO) -<br> Pluggable Authentication Modules

X/Open Single Sign-on Service (XSSO) -
Pluggable Authentication Modules
Copyright © 1997 The Open Group


pam_sm_set_mapped_authtok - store the password for the username supplied


#include <security/pam_appl.h>
#include <security/pam_modules.h>

int pam_sm_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, int argc, const char **argv );


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

The arguments for pam_sm_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.

argc (in)

The argc argument represents the number of module options defined in the PAM configuration.

argv (in)

Specifies the module options, which are interpreted and processed by the mapping module. If an unknown option is passed in, an error should be logged and the option ignored.


The following PAM status codes shall be returned:


Successful completion.


The username supplied is not recognized.


The mapping service does not support this module type.


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


The mapping service failed in reading/writing data.


Ignore underlying session module regardless of whether the control flag is required, optional or sufficient.


The caller does not possess the required authority.


Error in service module.


System error.


Memory buffer error.


Conversation error.

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

Why not acquire a nicely bound hard copy?
Click here to return to the publication details or order a copy of this publication.

Contents Next section Index