.TH dim2shell 1 2009/02/12 CERN "Dim2Shell"

.SH SYNOPSIS
dim2shell [-v] [-d] [-n <servername>] 
.SH DESCRIPTION
dim2shell is a small DIM-server which implements an RPC-channel. 
It receives commands in the RPCin-channel. The command has to 
consist of a script name and, if applicable, parameters to this 
script. Upon reception of the command, the server executes the 
script, buffers its output and returns it on the RPCout-channel. 
.TP
-v
be verbose
.TP
-d 
run as daemon
.TP
-n <servername>
run with the specified DIM service name
.SH ENVIRONMENT
The behaviour of dim2shell is controlled by environment variables 
which can be overridden by the command-line options described 
above. 
DIM_SERVICENAME: This variable sets the DIM service name the 
server uses.

The scripts to be executed have to be located in ~/scripts. 
.SH CONFIGURATION FILE
The behaviour of dim2shell can be controlled by the configuration 
file /etc/dim2shell.conf. It contains the user as which the server 
runs as well as the DIM service name. 
.SH INIT SCRIPT
dim2shell comes with a steering script in init.d which supports 
the runlevel control chkconfig. You can check the current configuration 
with:
chkconfig --list dim2shelld
If not yet added to the services to be controlled this can be done by:
chkconfig --add dim2shelld
Then you can use chkconfig to configure in which runlevels the server 
should be running. 
.SH BUGS
The server uses shell expansion for the command. Thus, it is 
possible to execute arbitrary commands by concatenation of 
semicolon separated statements.

Please report any bugs you find to the authors.
.SH AUTHOR
Jochen Klein (jochen.klein@cern.ch)