PAM_GETENVLIST(3PAM) PAM Library Functions PAM_GETENVLIST(3PAM)
pam_getenvlist - returns a list of all the PAM environment variables
cc [ flag ... ] file ... -lpam [ library ... ]
#include <security/pam_appl.h>
char **pam_getenvlist(pam_handle_t *pamh);
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().
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.
See attributes(7) for descriptions of the following attributes:
+--------------------+-------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-------------------------+
|Interface Stability | Stable |
+--------------------+-------------------------+
|MT-Level | MT-Safe with exceptions |
+--------------------+-------------------------+
libpam(3LIB), pam(3PAM), pam_getenv(3PAM), pam_putenv(3PAM),
attributes(7)
The interfaces in libpam are MT-Safe only if each thread within the
multithreaded application uses its own PAM handle.
October 13, 1998 PAM_GETENVLIST(3PAM)
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(7) for descriptions of the following attributes:
+--------------------+-------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-------------------------+
|Interface Stability | Stable |
+--------------------+-------------------------+
|MT-Level | MT-Safe with exceptions |
+--------------------+-------------------------+
SEE ALSO
libpam(3LIB), pam(3PAM), pam_getenv(3PAM), pam_putenv(3PAM),
attributes(7)
NOTES
The interfaces in libpam are MT-Safe only if each thread within the
multithreaded application uses its own PAM handle.
October 13, 1998 PAM_GETENVLIST(3PAM)