Title: pam_getenvlist Author: [FIXME: author] [see http://docbook.sf.net/el/author] Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/> Date: 09/19/2013 Manual: Linux-PAM Manual Source: Linux-PAM Manual Language: English
NAMEpam_getenvlist - getting the PAM environment
- char **pam_getenvlist(pam_handle_t *pamh);
The format of the memory is a malloc()'d array of char pointers, the last element of which is set to NULL. Each of the non-NULL entries in this array point to a NUL terminated and malloc()'d char string of the form: "name=value".
It should be noted that this memory will never be free()'d by libpam. Once obtained by a call to pam_getenvlist, it is the responsibility of the calling application to free() this memory.
It is by design, and not a coincidence, that the format and contents of the returned array matches that required for the third argument of the execle(3) function call.
The pam_getenvlist function returns NULL on failure.