Index for Section 4

Alphabetical listing for D

Bottom of page

dtspcdenv(4)
CDE
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

  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 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(1m)

Index for Section 4

Alphabetical listing for D

Top of page