/usr/dt/share/man/cat4/dtspcdenv.4(/usr/dt/share/man/cat4/dtspcdenv.4)

dtspcdenv(4m)	  MISC.	REFERENCE MANUAL PAGES	    dtspcdenv(4m)

NAME
     dtspcdenv - environment Variable File for the TED Subprocess
     Control Service

DESCRIPTION
     The TED 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  TED  is
     installed.	  This	file may be overwritten	by subsequent TED
     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  follow-
     ing 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 pre-
     cedence.  In this context,	the local host is the host  where
     a	TED  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  com-
     ments and are not processed.

     The syntax	for a non-commented line is:

Unix System LaboratoLast change: 1 August 1995			1

dtspcdenv(4m)	  MISC.	REFERENCE MANUAL PAGES	    dtspcdenv(4m)

	  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
     TED client	has the	following definition in	its environment:

	  PATH=/bin:/sbin:/usr/local/bin

     and the following definition occurs in one	of  the	 environ-
     ment 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.

Unix System LaboratoLast change: 1 August 1995			2

dtspcdenv(4m)	  MISC.	REFERENCE MANUAL PAGES	    dtspcdenv(4m)

	PWD	       The variable PWD	is not propagated to  the
		       remote host.

		       Note that  the  above  variables	 will  be
		       overridden  by their corresponding defini-
		       tions 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 defin-
				      itions used when a  process
				      is executed

		       /etc/dt/config/dtspcdenv
				      System-wide,	  locally
				      defined  environment  vari-
				      able 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).

Unix System LaboratoLast change: 1 August 1995			3

See also dtspcdenv(4)