pam_getenvlist (3pam) manual page

Table of Contents

Name

pam_getenvlist - returns a list of all the PAM environment variables

Synopsis

cc [ flag ... ] file ... -lpam [ library ... ] #include <security/pam_appl.h>

char **pam_getenvlist(pam_handle_t *pamh);

Description

The pam_getenvlist() function returns a list of all the PAM environment variables stored in the PAM handle pamh. The list is returned as a null-terminated array of pointers to strings. Each string contains a single PAM environment variable of the form name=value. The list returned is a duplicate copy of all the environment variables stored in pamh. It is the responsibility of the calling application to free the memory returned by pam_getenvlist().

Return Values

If successful, pam_getenvlist() returns in a null-terminated array a copy of all the PAM environment variables stored in pamh. Otherwise, pam_getenvlist() returns a null pointer.

Attributes

See attributes(5) for descriptions of the following attributes:

tab() allbox; cw(2.750000i)| cw(2.750000i) lw(2.750000i) lw(2.750000i). ATTRIBUTE TYPEATTRIBUTE VALUE Interface Stability Stable MT-LevelMT-Safe with exceptions

See Also

pam(3PAM) , pam_getenv(3PAM) , pam_putenv(3PAM) , libpam(3LIB) , attributes(5)

Notes

The interfaces in libpam are MT-Safe only if each thread within the multithreaded application uses its own PAM handle.


Table of Contents