pam_getenvlist(3)
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
pam_getenvlist() 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. Upon error, pam_getenvlist() returns a null pointer.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
| MT Level | MT-Safe with exceptions |
SEE ALSO
pam(3), pam_getenv(3), pam_putenv(3), libpam(4), attributes(5)
NOTES
The interfaces in libpam() are MT-Safe only if each thread within the multi-threaded application uses its own PAM handle.
SunOS 5.6 — Last change: 10 Mar 1997