NAME

dtspcdenv − Environment Variable File for the CDE Remote Execution System

DESCRIPTION

The CDE Remote Execution system allows the user and system administrator to create files of environment variable definitions to be placed in the processes environment before a remote process is started.  The system-wide file is:

/etc/dt/dtspcd/dtspcdenv

and the user-specific file is:

$HOME/.dt/dtspcdenv

The environment variable files are evaluated in the following order:

1. local host:  /etc/dt/dtspcd/dtspcdenv

2. local host:  $HOME/.dt/dtspcdenv

3. remote host: /etc/dt/dtspcd/dtspcdenv

4. remote host: $HOME/.dt/dtspcdenv

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).  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/dtspcd/dtspcdenv file have the lowest precedence. 

Line beginning with a "#" are considered comments and are not processed. 

The syntax for a non-commented line is:

VAR_NAME=some_value

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 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

EXAMPLES

The following definition sets the variable "FOO_BIN_PATH" to the value "/var/foo/bin":

FOO_BIN_PATH=/var/foo/bin

FILES

/etc/dt/dtspcd/dtspcdenv
System-wide 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). 

  —  12 January 1994