dtspcdenv(4m) UNIX System V (1 August 1995) dtspcdenv(4m)
NAME
dtspcdenv - environment Variable File for the CDE Subprocess
Control Service
DESCRIPTION
The CDE Subprocess Control service provides the ability for
a process running on one system to invoke another process on
a different system. By default, the environment variables
of the parent process are passed unmodified to the child
process (on the remote host); however, there are some
environment variables that are given special handling. In
addition, the user or system administrator can specify
environment variables that should be modified when they are
passed to the child process.
The system-wide environment files are:
/etc/dt/config/dtspcdenv
/usr/dt/config/dtspcdenv
and the user-specific environment file is:
$HOME/.dt/dtspcdenv
The file /usr/dt/config/dtspcdenv is created when CDE is
installed. This file may be overwritten by subsequent CDE
installations. Consequently, local variable definitions
should be placed in the file /etc/dt/config/dtspcdenv
because this file is not overwritten during installation.
The environment variable files are evaluated in the
following order:
local host: /usr/dt/config/dtspcdenv
local host: /etc/dt/config/dtspcdenv
local host: $HOME/.dt/dtspcdenv
remote host: /usr/dt/config/dtspcdenv
remote host: /etc/dt/config/dtspcdenv
remote host: $HOME/.dt/dtspcdenv
The precedence occurs in the reverse order of evaluation.
Thus, variables in the remote host's $HOME/.dt/dtspcdenv
file have the highest precedence and variables in the local
host's /etc/dt/config/dtspcdenv file have the lowest
precedence. In this context, the local host is the host
where a CDE client is running and the remote host is the
host where a remote process will be started (on behalf of
the local client).
Lines beginning with a numer symbol (#) are considered
comments and are not processed.
The syntax for a non-commented line is:
VAR_NAME=some_value
Page 1 (printed 9/3/04)
dtspcdenv(4m) UNIX System V (1 August 1995) dtspcdenv(4m)
where VAR_NAME is the name of an environment variable and
some_value is the value assigned to the variable.
If some_value contains a variable reference, the reference
will be replaced by the variable's value. For example, if a
CDE client has the following definition in its environment:
PATH=/bin:/sbin:/usr/local/bin
and the following definition occurs in one of the
environment files:
PATH=/opt/foo/bin:$PATH
then before the remote process is executed, PATH
will be expanded to:
PATH=/opt/foo/bin:/bin:/sbin:/usr/local/bin
The environment variable names may consist of letters,
digits or underscores and may be enclosed in curly braces.
The environment variable files may contain "unset
<variable_name>" commands to prevent an environment variable
from being propagated to the remote process. For example,
the following line would prevent the variable LIB_PATH from
being propagated to the remote process:
unset LIB_PATH
ENVIRONMENT VARIABLES
The dtspcd daemon treats the following variables specially:
DISPLAY If DISPLAY is set to "unix:<n>",
"local:<n>" or ":<n>" (where <n> is the
screen number), then before the remote
process is executed, DISPLAY is changed to
the name of the local host and the screen
number is preserved.
HOME Before the remote process is executed,
HOME is set to the value of the user's
home directory in the password file on the
remote host.
SHELL If SHELL is not in the parent processes
environment, SHELL is set to the value of
the user's shell in the password file on
the remote host.
PWD The variable PWD is not propagated to the
Page 2 (printed 9/3/04)
dtspcdenv(4m) UNIX System V (1 August 1995) dtspcdenv(4m)
remote host.
Note that the above variables will be
overridden by their corresponding
definitions in an environment file.
EXAMPLES
The following definition sets the variable FOO_BIN_PATH to
the value /var/foo/bin:
FOO_BIN_PATH=/var/foo/bin
FILES
/usr/dt/config/dtspcdenv
System-wide, installed
environment variable
definitions used when a
process is executed
/etc/dt/config/dtspcdenv
System-wide, locally
defined environment
variable definitions used
when a process is executed
$HOME/.dt/dtspcdenv
User-specific environment
variable definitions used
when a process is executed
SEE ALSO
dtspcd(1).
Page 3 (printed 9/3/04)