Manual Pages for UNIX Operating System command usage for man pam_getenv

PAM Library Functions                            pam_getenv(3PAM)



NAME
     pam_getenv - returns the value for a PAM environment name

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

     char *pam_getenv(pam_handle_t *pamh, const char *name);


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

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