NAME

dtspcd − Common Desktop Environment Remote Execution Daemon

SYNOPSIS

dtspcd [ −debug ] [ −log ] [ −auth_dir directory ] [ −timeout num_minutes ] [ −mount_point mount_point ]

DESCRIPTION

 
dtspcd is the Common Desktop Environment (CDE) Remote Execution daemon. It is not intended to be started directly by the user, rather it should be started automatically by the inetd daemon (see inetd(1M)) in response to a CDE client requesting a process to be started on the daemon’s host.

OPTIONS

−auth_dir directory
The default authentication directory is the user’s $HOME directory.  This option allows the system administrator to use a different directory.  Note "directory" must be exported to hosts wishing to use the dtspc service.

directory − the name of the directory to use for authentication. 

−timeout minutes
By default, the dtspcd process will terminate if it does not have any activity (process start or process stop) for 10 minutes and dtspcd has no child processes running. To change the timeout, set "minutes" to the desired number of minutes. To force the daemon to not use a timer, set "minutes" to "-1".

minutes − the number of minutes for the timer. 

−mount_point mount_point
"mount_point" is the name of the file system’s mount point.  For example, "mount_point" could be "/net" or "/nfs".  The daemon sets the environment variable "DTMOUNTPOINT" to the value of "mount_point".   This value of DTMOUNTPOINT will override all other definitions of DTMOUNTPOINT.

mount_point − the file system’s mount point. 

−log This option runs on logging of status information to the file "/var/dt/tmp/DTSPCD.log".  The information logged includes the name of the client host, the client’s username, error messages and the name of the file used for authentication.  The default is to not do any logging. 

−debug
This option turns on logging of dtspc protocol to the file "/var/dt/tmp/DTSPCD.log".  The protocol information logged includes the name of the protocol and number of bytes in the request. The default is to not log the protocol.

AUTHENTICATION

When a CDE client attempts to connect to a dtspcd daemon, the client sends the daemon its username.  The daemon uses the uername to determine the user’s home directory on the daemon’s host.  The home directory is used during authentication and it must be readable by the daemon and writable by the client.  Therefore, the user’s home directory on the daemon’s host must be mounted to the client host.  If the user’s home directory is not readable and the "-auth_dir" command line option is not used, the directory /var/dt/tmp will be used. 

To use a directory other than the user’s home directory for authentication, use the "-auth_dir" command line option. 

CONFIGURATION

The dtspcd daemon is an Internet service that must be registered in the file /etc/services as follows:

dtspc      6112/tcp

and in the file /etc/inetd.conf as follows:

dtspc  stream  tcp  nowait  root  /usr/dt/bin/dtspcd \

/usr/dt/bin/dtspcd

ENVIRONMENT VARIABLE MANAGEMENT

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.  See dtspcdenv(4) for more information. 

OPERATING SYSTEM DEPENDENCIES

On HP-UX, the file /usr/adm/inetd.sec may be used to control access to the dtspcd daemon.  See inetd.sec(4) for more information. 

FILES

/usr/dt/bin/dtspcd The CDE remote execution daemon

/etc/services The Internet service name data base

/etc/inted.conf The inetd configuration file

/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

/var/dt/tmp/DTSPCD.log
The dtspcd log file

SEE ALSO

inetd(1M) services(4), inetd.conf(4), dtspcdenv(4). 

DIAGNOSTICS

Use the command line options "-log" and "-debug" (describe above) to get diagnostic information. 

  —  12 January 1994