Content-type: text/html Man page of pam_getenv

pam_getenv

Section: PAM Library Functions (3PAM)
Updated: 13 Oct 1998
Index Return to Main Contents
 

NAME

pam_getenv - returns the value for a PAM environment name  

SYNOPSIS

cc [ flag ... ] file ... -lpam [ library ... ]
#include <security/pam_appl.h>

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 responsibility 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 attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
Interface Stability Stable
MT-LevelMT-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 handle.


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUES
ATTRIBUTES
SEE ALSO
NOTES

This document was created by man2html, using the manual pages.
Time: 02:38:32 GMT, October 02, 2010