The pam_putenv function is used to add or change the value of PAM
environment variables as associated with the pamh handle.
The pamh argument is an authentication handle obtained by a prior
call to pam_start(). The name_value argument is a single NUL
terminated string of one of the following forms:
NAME=value of variable
In this case the environment variable of the given NAME is set to
the indicated value: value of variable. If this variable is
already known, it is overwritten. Otherwise it is added to the
This function sets the variable to an empty value. It is listed
separately to indicate that this is the correct way to achieve
such a setting.
Without an '=' the pam_putenv() function will delete the
corresponding variable from the PAM environment.
pam_putenv() operates on a copy of name_value, which means in
contrast to putenv(3), the application is responsible to free the
Argument name_value given is a NULL pointer.
Variable requested (for deletion) is not currently set.
The pamh handle is corrupt.
Memory buffer error.
The environment variable was successfully updated.
This page is part of the linux-pam (Pluggable Authentication Modules
for Linux) project. Information about the project can be found at
⟨https://fedorahosted.org/linux-pam/⟩. If you have a bug report for
this manual page, see ⟨https://fedorahosted.org/linux-pam/report⟩.
This page was obtained from the tarball Linux-PAM-1.3.0.tar.gz
fetched from ⟨http://www.linux-pam.org/library/⟩ on 2017-03-13. If
you discover any rendering problems in this HTML version of the page,
or you believe there is a better or more up-to-date source for the
page, or you have corrections or improvements to the information in
this COLOPHON (which is not part of the original manual page), send a
mail to firstname.lastname@example.org
Linux-PAM Manual 04/01/2016 PAM_PUTENV(3)