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

NAME

6       pam_getenvlist - returns a list of all the PAM environment variables
7

SYNOPSIS

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

DESCRIPTION

18       The pam_getenvlist() function returns a list of all the PAM environment
19       variables stored in the PAM handle pamh. The  list  is  returned  as  a
20       null-terminated  array  of  pointers to strings. Each string contains a
21       single PAM environment  variable  of  the  form  name=value.  The  list
22       returned is a duplicate copy of all the environment variables stored in
23       pamh. It is the responsibility of the calling application to  free  the
24       memory returned by pam_getenvlist().
25

RETURN VALUES

27       If  successful,  pam_getenvlist()  returns in a null-terminated array a
28       copy of all the PAM environment variables stored  in  pamh.  Otherwise,
29       pam_getenvlist() returns a null pointer.
30

ATTRIBUTES

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

SEE ALSO

46       pam(3PAM),     pam_getenv(3PAM),     pam_putenv(3PAM),    libpam(3LIB),
47       attributes(5)
48

NOTES

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