.\" Process this file with
.\" groff -man -Tascii foo.1
.\"
.TH NGINJECT 1 "FEBRUARY 2009" "pvss_mockup" "User Commands"
.SH NAME
nginject \- 
.SH SYNOPSIS
.B nginject
.I [options]
.I [<target>[@state]]
.I <tag> ...

.SH DESCRIPTION
.B nginject
is the primary tool to control the TRD front-end electronics from the
command line.  

.B nginject
sends commands via the ConfigureFero command channel to the InterCom
Layer, which in turn retrieves the corresponding configuration from
the wingDB configuration database and sends it to the specified
read-out chambers (ROCs). 
.B nginject 
collects the replies from the ROCs on their ACK channels and displays
them, optionally filtering them with a XSL stylesheet using the 
.B xsltproc 
command.


.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
display help message
.TP
\fB\-q\fR, \fB\-\-quiet\fR
decrease verbosity
.TP
\fB\-v\fR, \fB\-\-verbose\fR
decrease verbosity
.TP
\fB\-s\fR, \fB\-\-stylesheet\fR=\fISTYLESHEET\fR
filter output with 
.B xsltproc
using stylesheet
.I STYLESHEET


.SH TARGETS

The target specifies which ROCs the commands will be sent
to. Shell-style wildcards can be used to specify multiple ROCs.
Only one target can be specified at a time.

If the command 
.B wing_showrocs
is available, it will only use the ROCs listed in its output, otherwise 
.B nginject 
will assume that the all 540 ROCs in the full TRD are available.

.TP
\fISM_S_L\fR \fBTRD-FEE_\fISM_S_L\fR \fBtrd-fee_\fISM_S_L\fR 
send to super-module \fISM\fR, stack \fIS\fR layer \fIL\fR
.TP
\fBsm\fISM\fR
send to all ROCs in super-module \fISM\fR
.TP
\fBall\fR
send to all available ROCs

.SH STATES

If a state is specified on the command line, only ROCs that are in
that state will receive the commands specified on the command
line. This can be used to bring all ROCs to the same state easily. 

Several forms are possible for each state:

.TP
\fBstdby standby\fR
send only to ROCs in state \fBSTANDBY\fR
.TP
\fBstdby_init init\fR
send only to ROCs in state \fBSTANDBY_INITIALIZED\fR
.TP
\fBconfigured cfg\fR
send only to ROCs in state \fBCONFIGURED\fR
.TP
\fBerror err\fR
send only to ROCs in state \fBERROR\fR


.SH BUGS
None ;-)

.SH AUTHORS
Tom Dietel