pam_getenv(3PAM) PAM Library Functions pam_getenv(3PAM)NAMEpam_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
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.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Interface Stability │ Stable │
├─────────────────────────────┼─────────────────────────────┤
│MT-Level │MT-Safe with exceptions │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOpam(3PAM), pam_getenvlist(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.
SunOS 5.10 13 Oct 1998 pam_getenv(3PAM)