NAME

pam_getenv - retrieve the value of a PAM environment variable

SYNOPSIS

#include <security/pam_appl.h>

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

DESCRIPTION

The pam_getenv() function returns the value of the environment variable specified by name.

The PAM library module will allocate memory for the returned value. The calling application is responsible for freeing that memory. The arguments for pam_getenv() are:

pamh (in)

The PAM authentication handle, obtained from a previous call to pam_start.()

name (in)

Name of the environment variable to be retrieved.

RETURN VALUE

pam_getenv() returns the value of the specified variable. If the variable does not exist, a NULL pointer is returned.