---

Manual Reference Pages  - PAM_ENV (8)

---

pam_env - PAM module to set/unset environment variables

CONTENTS

pam_env.so [debug] [conffile=conf-file] [envfile=env-file] [readenv=0|1]

The pam_env PAM module allows the (un)setting of environment variables. Supported is the use of previously set environment variables as well as PAM_ITEMs such as PAM_RHOST.

By default rules for (un)setting of variables is taken from the config file /etc/security/pam_env.conf if no other file is specified.

This module can also parse a file with simple KEY=VAL pairs on seperate lines (/etc/environment by default). You can change the default file to parse, with the envfile flag and turn it on or off by setting the readenv flag to 1 or 0 respectively.

conffile=/path/to/pam_env.conf
	Indicate an alternative pam_env.conf style configuration file to override the default. This can be useful when different services need different environments.
debug
	A lot of debug informations are printed with syslog(3).
envfile=/path/to/environment
	Indicate an alternative environment file to override the default. This can be useful when different services need different environments.
readenv=0|1
	Turns on or off the reading of the file specified by envfile (0 is off, 1 is on). By default this option is on.

The auth and session services are supported.

PAM_ABORT
	Not all relevant data or options could be gotten.
PAM_BUF_ERR
	Memory buffer error.
PAM_IGNORE
	No pam_env.conf and environment file was found.
PAM_SUCCESS
	Environment variables were set.

/etc/security/pam_env.conf
	Default configuration file
/etc/environment
	Default environment file

pam_env.conf(5), pam.d(8), pam(8).

pam_env was written by Dave Kinchlea <kinch@kinch.ark.com>.

Jump to page    or go to Top of page |  Section 8 |  Main Index.