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_get_data - get module information


#include <security/pam_appl.h>

int pam_get_data ( pam_handle_t *pamh, const char *module_data_name, void **data );


The pam_get_data() function is used by the PAM modules to retrieve module-specific information from the PAM handle, pamh, for the module_data_name supplied. The data argument is assigned the address of the requested data. This data should not be freed by the caller; it will be freed by the cleanup function that was specified in the call to pam_set_data() when the pam_end() function is called.

The arguments for pam_get_data() are:

pamh (in)

The PAM authentication handle, obtained from a previous call to pam_start(), from which the data are retrieved.

module_data_name (in)

The name identifying the module data to be retrieved. This should be unique across all services.

data (out)

The data retrieved from pamh for module_data_name supplied.


One of the following PAM status codes shall be returned:


Successful completion.


No module-specific data are present.


System error.


Memory buffer 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