NAME
pam_getenvlist
- returns a list of all the PAM environment variables
LIBRARY
SYNOPSIS
char **
pam_getenvlist(pam_handle_t *pamh)
DESCRIPTION
The
pam_getenvlist
function returns a copy of the given PAM context's
environment list as a pointer to an array of strings.
The last element in the array is
NULL.
The pointer is suitable for assignment to
environ.
The array and the strings it lists are allocated using
malloc(3),
and
should be released using
free(3)
after use:
char **envlist, **env;
envlist = environ;
environ = pam_getenvlist(pamh);
/* do something nifty */
for (env = environ; *env != NULL; env++)
free(*env);
free(environ);
environ = envlist;
RETURN VALUES
The
pam_getenvlist
function returns
NULL
on failure.
SEE ALSO
free(3),
malloc(3),
pam(3),
pam_getenv(3),
pam_putenv(3),
pam_setenv(3),
environ(7)
STANDARDS
AUTHORS
The
pam_getenvlist
function and this manual page were developed for the
FreeBSD
Project by ThinkSec AS and Network Associates Laboratories, the
Security Research Division of Network Associates, Inc. under
DARPA/SPAWAR contract N66001-01-C-8035
(``CBOSS''),
as part of the DARPA CHATS research program.