path: root/doc/man/pam_getenvlist.3
diff options
Diffstat (limited to 'doc/man/pam_getenvlist.3')
1 files changed, 0 insertions, 50 deletions
diff --git a/doc/man/pam_getenvlist.3 b/doc/man/pam_getenvlist.3
deleted file mode 100644
index 57c1d70e..00000000
--- a/doc/man/pam_getenvlist.3
+++ /dev/null
@@ -1,50 +0,0 @@
-.\" Title: pam_getenvlist
-.\" Author:
-.\" Generator: DocBook XSL Stylesheets v1.70.1 <>
-.\" Date: 06/27/2006
-.\" Manual: Linux\-PAM Manual
-.\" Source: Linux\-PAM Manual
-.TH "PAM_GETENVLIST" "3" "06/27/2006" "Linux\-PAM Manual" "Linux\-PAM Manual"
-.\" disable hyphenation
-.\" disable justification (adjust text to left margin only) l
-pam_getenvlist \- getting the PAM environment
-.ft B
-#include <security/pam_appl.h>
-.HP 22
-.BI "char **pam_getenvlist(pam_handle_t\ *" "pamh" ");"
-function returns a complete copy of the PAM environment as associated with the handle
-\fIpamh\fR. The PAM environment variables represent the contents of the regular environment variables of the authenticated user when service is granted.
-The format of the memory is a malloc()'d array of char pointers, the last element of which is set to NULL. Each of the non\-NULL entries in this array point to a NUL terminated and malloc()'d char string of the form: "\fIname=value\fR".
-It should be noted that this memory will never be free()'d by libpam. Once obtained by a call to
-\fBpam_getenvlist\fR, it is the responsibility of the calling application to free() this memory.
-It is by design, and not a coincidence, that the format and contents of the returned array matches that required for the third argument of the
-function call.
-function returns NULL on failure.