pam_getenvlist(3pam) [opensolaris man page]

pam_getenvlist(3PAM)					       PAM Library Functions					      pam_getenvlist(3PAM)

NAME

       pam_getenvlist - returns a list of all the PAM environment variables

SYNOPSIS

       cc [ flag ... ] file ... -lpam [ library ... ]
       #include <security/pam_appl.h>

       char **pam_getenvlist(pam_handle_t *pamh);

DESCRIPTION

       The  pam_getenvlist() function returns a list of all the PAM environment variables stored in the PAM handle pamh. The list is returned as a
       null-terminated array of pointers to strings. Each string contains a single PAM environment variable  of  the  form  name=value.  The  list
       returned  is  a duplicate copy of all the environment variables stored in pamh. It is the responsibility of the calling application to free
       the memory returned by pam_getenvlist().

RETURN VALUES

       If successful, pam_getenvlist() returns in a null-terminated array a copy of all the PAM environment variables stored in  pamh.	Otherwise,
       pam_getenvlist() returns a null pointer.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     | Stable			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe with exceptions	   |
       +-----------------------------+-----------------------------+

SEE ALSO

       pam(3PAM), pam_getenv(3PAM), pam_putenv(3PAM), libpam(3LIB), attributes(5)

NOTES

       The interfaces in  libpam are MT-Safe only if each thread within the multithreaded application uses its own PAM handle.

SunOS 5.11							    13 Oct 1998 					      pam_getenvlist(3PAM)

PAM_PUTENV(3)                                                    Linux-PAM Manual                                                    PAM_PUTENV(3)

NAME

       pam_putenv - set or change PAM environment variable

SYNOPSIS

       #include <security/pam_appl.h>

       int pam_putenv(pam_handle_t *pamh, const char *name_value);

DESCRIPTION

       The pam_putenv function is used to add or change the value of PAM environment variables as associated with the pamh handle.

       The pamh argument is an authentication handle obtained by a prior call to pam_start(). The name_value argument is a single NUL terminated
       string of one of the following forms:

       NAME=value of variable
           In this case the environment variable of the given NAME is set to the indicated value: value of variable. If this variable is already
           known, it is overwritten. Otherwise it is added to the PAM environment.

       NAME=
           This function sets the variable to an empty value. It is listed separately to indicate that this is the correct way to achieve such a
           setting.

       NAME
           Without an '=' the pam_putenv() function will delete the corresponding variable from the PAM environment.

       pam_putenv() operates on a copy of name_value, which means in contrast to putenv(3), the application is responsible to free the data.

RETURN VALUES

       PAM_PERM_DENIED
           Argument name_value given is a NULL pointer.

       PAM_BAD_ITEM
           Variable requested (for deletion) is not currently set.

       PAM_ABORT
           The pamh handle is corrupt.

       PAM_BUF_ERR
           Memory buffer error.

       PAM_SUCCESS
           The environment variable was successfully updated.

SEE ALSO

       pam_start(3), pam_getenv(3), pam_getenvlist(3), pam_strerror(3), pam(7)

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