PAM Library Functions                            pamgetenv(3PAM)



NAME
     pamgetenv - returns the value for a PAM environment name

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



     char *pamgetenv(pamhandlet *pamh, const char *name);


DESCRIPTION
     The pamgetenv() function searches the PAM handle pamh for a
     value   associated   with  name.  If  a  value  is  present,
     pamgetenv() makes a copy of the value and returns a pointer
     to  the  copy  back  to  the calling application. If no such
     entry exists, pamgetenv() returns  NUL. It is the  respon-
     sibility  of  the  calling  application  to  free the memory
     returned by pamgetenv().

RETURN VALUES
     If successful, pamgetenv() returns  a  copy  of  the  value
     associated  with  name  in  the  PAM  handle;  otherwise, it
     returns a  NUL 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),      pamgetenvlist(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