pam_set_data(3)pam_set_data(3)NAME
pam_set_data, pam_get_data - PAM routines to maintain module specific
state
SYNOPSIS
[ flag ... ] file ... [ library ... ]
DESCRIPTION
and allow PAM service modules to access and update module specific
information as needed. These functions should not be used by applica‐
tions.
stores module specific data within the PAM handle, pamh. The mod‐
ule_data_name argument uniquely identifies the data, and the data argu‐
ment represents the actual data. module_data_name should be unique
across all services (UNIX, etc).
The cleanup function is used to free any memory used by the data after
it is no longer needed, and is invoked by The cleanup function takes as
its arguments a pointer to the PAM handle, pamh, a pointer to the
actual data, data, and a status code, pam_end_status. The status code
determines exactly what state information needs to be purged, and is
therefore specific to each module.
If is called and module data already exists under the same mod‐
ule_data_name (from a prior call to then the existing data is replaced
by the new data, and the existing cleanup function is replaced by the
new cleanup function.
retrieves module specific data stored in the PAM handle, pamh, identi‐
fied by the unique name, module_data_name. The data argument is
assigned the address of the requested data.
APPLICATION USAGE
Refer to pam(3) for information on thread-safety of PAM interfaces.
RETURN VALUES
In addition to the return values listed in pam(3), the following value
may also be returned:
No module specific data is present.
SEE ALSOpam(3), pam_start(3).
pam_set_data(3)