NAME

pam_putenv - set the value of an environment variable

SYNOPSIS

#include <security/pam_appl.h>

int pam_putenv (
    pam_handle_t    *pamh,
    const char      *namevalue,
);

DESCRIPTION

The function pam_putenv() is used by the PAM service modules to set the value of the environment variable defined by namevalue.

The arguments for pam_putenv() are:

pamh (in)

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

namevalue (in)

Name and value of the environment variable to be set. It should be in the form "NAME=value"; for example, "SHELL=/bin/sh" .

RETURN VALUE

The following PAM status codes shall be returned:

[PAM_SUCCESS]

Successful completion.

[PAM_SYSTEM_ERR]

The environment variable could not be set.

[PAM_BUF_ERR]

Memory buffer error.

[??] Some characters or strings that appear in the printed document are not easily representable using HTML.