summaryrefslogtreecommitdiff
path: root/modules/pam_env
diff options
context:
space:
mode:
Diffstat (limited to 'modules/pam_env')
-rw-r--r--modules/pam_env/pam_env.834
-rw-r--r--modules/pam_env/pam_env.conf.523
2 files changed, 37 insertions, 20 deletions
diff --git a/modules/pam_env/pam_env.8 b/modules/pam_env/pam_env.8
index 566396f1..23083da0 100644
--- a/modules/pam_env/pam_env.8
+++ b/modules/pam_env/pam_env.8
@@ -1,8 +1,11 @@
-.\" ** You probably do not want to edit this file directly **
-.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1).
-.\" Instead of manually editing it, you probably should edit the DocBook XML
-.\" source for it and then use the DocBook XSL Stylesheets to regenerate it.
-.TH "PAM_ENV" "8" "02/17/2006" "Linux\-PAM Manual" "Linux\-PAM Manual"
+.\" Title: pam_env
+.\" Author:
+.\" Generator: DocBook XSL Stylesheets v1.70.1 <http://docbook.sf.net/>
+.\" Date: 06/02/2006
+.\" Manual: Linux\-PAM Manual
+.\" Source: Linux\-PAM Manual
+.\"
+.TH "PAM_ENV" "8" "06/02/2006" "Linux\-PAM Manual" "Linux\-PAM Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
@@ -31,21 +34,21 @@ flag and turn it on or off by setting the
\fIreadenv\fR
flag to 1 or 0 respectively.
.SH "OPTIONS"
-.TP
+.TP 3n
\fBconffile=\fR\fB\fI/path/to/pam_env.conf\fR\fR
Indicate an alternative
\fIpam_env.conf\fR
style configuration file to override the default. This can be useful when different services need different environments.
-.TP
+.TP 3n
\fBdebug\fR
A lot of debug informations are printed with
\fBsyslog\fR(3).
-.TP
+.TP 3n
\fBenvfile=\fR\fB\fI/path/to/environment\fR\fR
Indicate an alternative
\fIenvironment\fR
file to override the default. This can be useful when different services need different environments.
-.TP
+.TP 3n
\fBreadenv=\fR\fB\fI0|1\fR\fR
Turns on or off the reading of the file specified by envfile (0 is off, 1 is on). By default this option is on.
.SH "MODULE SERVICES PROVIDED"
@@ -56,27 +59,28 @@ and
\fBsession\fR
services are supported.
.SH "RETURN VALUES"
-.TP
+.TP 3n
PAM_ABORT
Not all relevant data or options could be gotten.
-.TP
+.TP 3n
PAM_BUF_ERR
Memory buffer error.
-.TP
+.TP 3n
PAM_IGNORE
No pam_env.conf and environment file was found.
-.TP
+.TP 3n
PAM_SUCCESS
Environment variables were set.
.SH "FILES"
-.TP
+.TP 3n
\fI/etc/security/pam_env.conf\fR
Default configuration file
-.TP
+.TP 3n
\fI/etc/environment\fR
Default environment file
.SH "SEE ALSO"
.PP
+
\fBpam_env.conf\fR(5),
\fBpam.d\fR(8),
\fBpam\fR(8).
diff --git a/modules/pam_env/pam_env.conf.5 b/modules/pam_env/pam_env.conf.5
index edf1fe2f..3f4dcd4f 100644
--- a/modules/pam_env/pam_env.conf.5
+++ b/modules/pam_env/pam_env.conf.5
@@ -1,8 +1,11 @@
-.\" ** You probably do not want to edit this file directly **
-.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1).
-.\" Instead of manually editing it, you probably should edit the DocBook XML
-.\" source for it and then use the DocBook XSL Stylesheets to regenerate it.
-.TH "PAM_ENV.CONF" "5" "02/17/2006" "Linux\-PAM Manual" "Linux\-PAM Manual"
+.\" Title: pam_env.conf
+.\" Author:
+.\" Generator: DocBook XSL Stylesheets v1.70.1 <http://docbook.sf.net/>
+.\" Date: 06/02/2006
+.\" Manual: Linux\-PAM Manual
+.\" Source: Linux\-PAM Manual
+.\"
+.TH "PAM_ENV.CONF" "5" "06/02/2006" "Linux\-PAM Manual" "Linux\-PAM Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
@@ -22,6 +25,7 @@ file specifies the environment variables to be set, unset or modified. When some
.PP
Each line starts with the variable name, there are then two possible options for each variable DEFAULT and OVERRIDE. DEFAULT allows and administrator to set the value of the variable to some default value, if none is supplied then the empty string is assumed. The OVERRIDE option tells pam_env that it should enter in its value (overriding the default value) if there is one to use. OVERRIDE is not used, "" is assumed and no override will be done.
.PP
+
\fIVARIABLE\fR
[\fIDEFAULT=[value]\fR] [\fIOVERRIDE=[value]\fR]
.PP
@@ -35,20 +39,25 @@ These are some example lines which might be specified in
.PP
Set the REMOTEHOST variable for any hosts that are remote, default to "localhost" rather than not being set at all
.sp
+.RS 3n
.nf
REMOTEHOST DEFAULT=localhost OVERRIDE=@{PAM_RHOST}
.fi
+.RE
.PP
Set the DISPLAY variable if it seems reasonable
.sp
+.RS 3n
.nf
DISPLAY DEFAULT=${REMOTEHOST}:0.0 OVERRIDE=${DISPLAY}
.fi
+.RE
.PP
Now some simple variables
.sp
+.RS 3n
.nf
PAGER DEFAULT=less
MANPAGER DEFAULT=less
@@ -58,9 +67,11 @@ Now some simple variables
:/usr/bin:/usr/local/bin/X11:/usr/bin/X11
.fi
+.RE
.PP
Silly examples of escaped variables, just to show how they work.
.sp
+.RS 3n
.nf
DOLLAR DEFAULT=\\$
DOLLARDOLLAR DEFAULT= OVERRIDE=\\$${DOLLAR}
@@ -68,8 +79,10 @@ Silly examples of escaped variables, just to show how they work.
ATSIGN DEFAULT="" OVERRIDE=\\@
.fi
+.RE
.SH "SEE ALSO"
.PP
+
\fBpam_env\fR(8),
\fBpam.d\fR(5),
\fBpam\fR(8)