PAM Library Functions                        pamgetenvlist(3PAM)



NAME
     pamgetenvlist - returns a list of all the  PAM  environment
     variables

SYNOPSIS
     cc [ flag ... ] file ... -lpam [ library ... ]
     #include 



     char **pamgetenvlist(pamhandlet *pamh);


DESCRIPTION
     The pamgetenvlist() 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 pamgetenvlist().

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

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability           Stable                     
    
     MT-Level                     MT-Safe with exceptions     
    


SEE ALSO
     pam(3PAM), pamgetenv(3PAM), pamputenv(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