Manual Pages for UNIX Operating System command usage for man pam_getenvlist

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 

     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 vari-
     able of the form name=value. The list returned is  a  dupli-
     cate  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  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | 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 han-
     dle.






SunOS 5.11          Last change: 13 Oct 1998                    1