pam_getenv (3pam) manual page

Table of Contents


pam_getenv - returns the value for a PAM environment name


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

char *pam_getenv(pam_handle_t *pamh, const char *name);


The pam_getenv() function 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.


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_getenvlist(3PAM) , pam_putenv(3PAM) , libpam(3LIB) , attributes(5)


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

Table of Contents