NAME    [Toc]    [Back]

     pam_getenv -- retrieve the value of a PAM environment variable

LIBRARY    [Toc]    [Back]

     PAM Library (libpam, -lpam)

SYNOPSIS    [Toc]    [Back]

     #include <sys/types.h>
     #include <security/pam_appl.h>

     const char *
     pam_getenv(pam_handle_t *pamh, const char *name);

DESCRIPTION    [Toc]    [Back]

     The pam_getenv function returns the value of an environment variable.
     Its semantics are similar to those of getenv(3), but it accesses the PAM
     context's environment list instead of the application's.

RETURN VALUES    [Toc]    [Back]

     The pam_getenv function returns NULL on failure.

SEE ALSO    [Toc]    [Back]

     getenv(3), pam(3), pam_getenvlist(3), pam_putenv(3), pam_setenv(3)

STANDARDS    [Toc]    [Back]

     X/Open Single Sign-On Service (XSSO) - Pluggable Authentication Modules,
     June 1997.

AUTHORS    [Toc]    [Back]

     The pam_getenv 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.


FreeBSD 5.2.1                    July 15, 2003                   FreeBSD 5.2.1