1pam_getenv(3PAM)             PAM Library Functions            pam_getenv(3PAM)
2
3
4

NAME

6       pam_getenv - returns the value for a PAM environment name
7

SYNOPSIS

9       cc [ flag ... ] file ... -lpam [ library ... ]
10       #include <security/pam_appl.h>
11
12
13
14       char *pam_getenv(pam_handle_t *pamh, const char *name);
15
16

DESCRIPTION

18       The  pam_getenv()  function  searches  the  PAM handle pamh for a value
19       associated with name. If a value is present, pam_getenv() makes a  copy
20       of  the  value  and  returns  a pointer to the copy back to the calling
21       application. If no such entry exists, pam_getenv() returns  NULL. It is
22       the  responsibility  of  the  calling  application  to  free the memory
23       returned by pam_getenv().
24

RETURN VALUES

26       If successful, pam_getenv() returns a copy of the value associated with
27       name in the PAM handle; otherwise, it returns a  NULL pointer.
28

ATTRIBUTES

30       See attributes(5) for descriptions of the following attributes:
31
32
33
34
35       ┌─────────────────────────────┬─────────────────────────────┐
36       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
37       ├─────────────────────────────┼─────────────────────────────┤
38       │Interface Stability          │ Stable                      │
39       ├─────────────────────────────┼─────────────────────────────┤
40       │MT-Level                     │MT-Safe with exceptions      │
41       └─────────────────────────────┴─────────────────────────────┘
42

SEE ALSO

44       pam(3PAM),    pam_getenvlist(3PAM),   pam_putenv(3PAM),   libpam(3LIB),
45       attributes(5)
46

NOTES

48       The interfaces in  libpam are MT-Safe only if each  thread  within  the
49       multithreaded application uses its own PAM handle.
50
51
52
53SunOS 5.11                        13 Oct 1998                 pam_getenv(3PAM)
Impressum