pam_getenvlist

Name

pam_getenvlist -- returns a pointer to the complete PAM environment.

Synopsis

#include <security/pam_appl.h>

char * const * pam_getenvlist(pam_handle_t * pamh);

Description

pam_getenvlist() returns a pointer to the complete PAM environment. This pointer points to an array of pointers to NUL-terminated strings and must be terminated by a NULL pointer. Each string has the form "name=value".

The PAM library module allocates memory for the returned value and the associated strings. The calling application is responsible for freeing this memory.

Return Value

pam_getenvlist() returns an array of string pointers containing the PAM environment. On error, NULL is returned.