pam_misc_drop_env(3) [debian man page]

PAM_MISC_DROP_ENV(3)						 Linux-PAM Manual					      PAM_MISC_DROP_ENV(3)

NAME

       pam_misc_drop_env - liberating a locally saved environment

SYNOPSIS

       #include <security/pam_misc.h>

       int pam_misc_drop_env(char **env);

DESCRIPTION

       This function is defined to complement the pam_getenvlist(3) function. It liberates the memory associated with env, overwriting with 0 all
       memory before free()ing it.

SEE ALSO

       pam_getenvlist(3), pam(7)

STANDARDS

       The pam_misc_drop_env function is part of the libpam_misc Library and not defined in any standard.

Linux-PAM Manual						    06/04/2011						      PAM_MISC_DROP_ENV(3)

PAM_GETENVLIST(3)                                                Linux-PAM Manual                                                PAM_GETENVLIST(3)

NAME

       pam_getenvlist - getting the PAM environment

SYNOPSIS

       #include <security/pam_appl.h>

       char **pam_getenvlist(pam_handle_t *pamh);

DESCRIPTION

       The pam_getenvlist function returns a complete copy of the PAM environment as associated with the handle pamh. The PAM environment
       variables represent the contents of the regular environment variables of the authenticated user when service is granted.

       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.

RETURN VALUES

       The pam_getenvlist function returns NULL on failure.

SEE ALSO

       pam_start(3), pam_getenv(3), pam_putenv(3), pam(7)

Linux-PAM Manual                                                    06/04/2011                                                   PAM_GETENVLIST(3)