$Id: pam_getenvlist.c 648 2013-03-05 17:54:27Z des $
.Dd September 12, 2014 .Dt PAM_GETENVLIST 3 .Os .Sh NAME .Nm pam_getenvlist .Nd returns a list of all the PAM environment variables .Sh LIBRARY .Lb libpam .Sh SYNOPSIS n sys/types.h n security/pam_appl.h .Ft "char **" .Fn pam_getenvlist "pam_handle_t *pamh" .Sh DESCRIPTION The .Fn 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 .Dv NULL . The pointer is suitable for assignment to .Va environ .
p The array and the strings it lists are allocated using .Xr malloc 3 , and should be released using .Xr free 3 after use:
p d -literal char **envlist, **env; envlist = environ; environ = pam_getenvlist(pamh); /* do something nifty */ for (env = environ; *env != NULL; env++) free(*env); free(environ); environ = envlist; .Ed .Sh RETURN VALUES The .Fn pam_getenvlist function returns .Dv NULL on failure. .Sh SEE ALSO .Xr free 3 , .Xr malloc 3 , .Xr pam 3 , .Xr pam_getenv 3 , .Xr pam_putenv 3 , .Xr pam_setenv 3 , .Xr environ 7 .Sh STANDARDS .Rs .%T "X/Open Single Sign-On Service (XSSO) - Pluggable Authentication Modules" .%D "June 1997" .Re .Sh AUTHORS The .Fn pam_getenvlist function and this manual page were developed for the .Fx Project by ThinkSec AS and Network Associates Laboratories, the Security Research Division of Network Associates, Inc. under DARPA/SPAWAR contract N66001-01-C-8035
q Dq CBOSS , as part of the DARPA CHATS research program.
p The OpenPAM library is maintained by .An Dag-Erling Sm\(/orgrav Aq des@des.no .