pam_getenv(3)
NAME
pam_getenv − returns the value for a PAM environment name
SYNOPSIS
cc [ flag ... ] file ... −lpam [ library ... ]
#include <security/pam_appl.h>
char ∗pam_getenv(pam_handle_t ∗pamh, const char ∗name);
DESCRIPTION
pam_getenv() searches the PAM handle, pamh, for a value associated with name. If a value is present, pam_getenv() makes a copy of the value and returns a pointer to the copy back to the calling application. If no such entry exists, pam_getenv() returns NULL. It is the responsibility of the calling application to free the memory returned by pam_getenv().
RETURN VALUES
If successful, pam_getenv() returns a copy of the value associated with name in the PAM handle; otherwise, it 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_getenvlist(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