#

[0] Fix | Delete

# This is the configuration file for pam_env, a PAM module to load in

[1] Fix | Delete

# a configurable list of environment variables for a

[2] Fix | Delete

#

[3] Fix | Delete

# The original idea for this came from Andrew G. Morgan ...

[4] Fix | Delete

#<quote>

[5] Fix | Delete

# Mmm. Perhaps you might like to write a pam_env module that reads a

[6] Fix | Delete

# default environment from a file? I can see that as REALLY

[7] Fix | Delete

# useful... Note it would be an "auth" module that returns PAM_IGNORE

[8] Fix | Delete

# for the auth part and sets the environment returning PAM_SUCCESS in

[9] Fix | Delete

# the setcred function...

[10] Fix | Delete

#</quote>

[11] Fix | Delete

#

[12] Fix | Delete

# What I wanted was the REMOTEHOST variable set, purely for selfish

[13] Fix | Delete

# reasons, and AGM didn't want it added to the SimpleApps login

[14] Fix | Delete

# program (which is where I added the patch). So, my first concern is

[15] Fix | Delete

# that variable, from there there are numerous others that might/would

[16] Fix | Delete

# be useful to be set: NNTPSERVER, LESS, PATH, PAGER, MANPAGER .....

[17] Fix | Delete

#

[18] Fix | Delete

# Of course, these are a different kind of variable than REMOTEHOST in

[19] Fix | Delete

# that they are things that are likely to be configured by

[20] Fix | Delete

# administrators rather than set by logging in, how to treat them both

[21] Fix | Delete

# in the same config file?

[22] Fix | Delete

#

[23] Fix | Delete

# Here is my idea:

[24] Fix | Delete

#

[25] Fix | Delete

# Each line starts with the variable name, there are then two possible

[26] Fix | Delete

# options for each variable DEFAULT and OVERRIDE.

[27] Fix | Delete

# DEFAULT allows and administrator to set the value of the

[28] Fix | Delete

# variable to some default value, if none is supplied then the empty

[29] Fix | Delete

# string is assumed. The OVERRIDE option tells pam_env that it should

[30] Fix | Delete

# enter in its value (overriding the default value) if there is one

[31] Fix | Delete

# to use. OVERRIDE is not used, "" is assumed and no override will be

[32] Fix | Delete

# done.

[33] Fix | Delete

#

[34] Fix | Delete

# VARIABLE [DEFAULT=[value]] [OVERRIDE=[value]]

[35] Fix | Delete

#

[36] Fix | Delete

# (Possibly non-existent) environment variables may be used in values

[37] Fix | Delete

# using the ${string} syntax and (possibly non-existent) PAM_ITEMs may

[38] Fix | Delete

# be used in values using the @{string} syntax. Both the $ and @

[39] Fix | Delete

# characters can be backslash escaped to be used as literal values

[40] Fix | Delete

# values can be delimited with "", escaped " not supported.

[41] Fix | Delete

# Note that many environment variables that you would like to use

[42] Fix | Delete

# may not be set by the time the module is called.

[43] Fix | Delete

# For example, HOME is used below several times, but

[44] Fix | Delete

# many PAM applications don't make it available by the time you need it.

[45] Fix | Delete

#

[46] Fix | Delete

#

[47] Fix | Delete

# First, some special variables

[48] Fix | Delete

#

[49] Fix | Delete

# Set the REMOTEHOST variable for any hosts that are remote, default

[50] Fix | Delete

# to "localhost" rather than not being set at all

[51] Fix | Delete

#REMOTEHOST DEFAULT=localhost OVERRIDE=@{PAM_RHOST}

[52] Fix | Delete

#

[53] Fix | Delete

# Set the DISPLAY variable if it seems reasonable

[54] Fix | Delete

#DISPLAY DEFAULT=${REMOTEHOST}:0.0 OVERRIDE=${DISPLAY}

[55] Fix | Delete

#

[56] Fix | Delete

#

[57] Fix | Delete

# Now some simple variables

[58] Fix | Delete

#

[59] Fix | Delete

#PAGER DEFAULT=less

[60] Fix | Delete

#MANPAGER DEFAULT=less

[61] Fix | Delete

#LESS DEFAULT="M q e h15 z23 b80"

[62] Fix | Delete

#NNTPSERVER DEFAULT=localhost

[63] Fix | Delete

#PATH DEFAULT=${HOME}/bin:/usr/local/bin:/bin\

[64] Fix | Delete

#:/usr/bin:/usr/local/bin/X11:/usr/bin/X11

[65] Fix | Delete

#

[66] Fix | Delete

# silly examples of escaped variables, just to show how they work.

[67] Fix | Delete

#

[68] Fix | Delete

#DOLLAR DEFAULT=\$

[69] Fix | Delete

#DOLLARDOLLAR DEFAULT= OVERRIDE=\$${DOLLAR}

[70] Fix | Delete

#DOLLARPLUS DEFAULT=\${REMOTEHOST}${REMOTEHOST}

[71] Fix | Delete

#ATSIGN DEFAULT="" OVERRIDE=\@

[72] Fix | Delete

[73] Fix | Delete