.\" Process this file with
.\" groff -man -Tascii foo.1
.\"
.TH STRESSTEST 1 "FEBRUARY 2009" "pvss_mockup" "User Commands"
.SH NAME
stresstest \- stability test for TRD FEE
.SH SYNOPSIS
.B stresstest
.I [options]
.SH DESCRIPTION
.B stresstest
tests the stability of TRD front-end electronics (FEE) by sending
triggers and regularly checking for errors in the read-out tree. If it
finds an error, it reconfigures the electronics under test before it
starts a new cycle. At the beginning of a test, the electronics
is configured using the specified tags.

For controlling and querying the state of the FEE the command 
.B nginject
is used. The tags to be used can be specified in a configuration file
or on the command line, where the command line options take precedence
over the configuration file.

The trigger is controlled via three configurable commands to start and
stop sending triggers and to reset the trigger system at the beginning
of each cycle of the test, e.g. to reset the event counter in the
trigger system.

.SH OPTIONS
.TP
\fB\-t\fR, \fB\-\-target\fR=\fITARGET\fR
run stresstest on \fITARGET\fR
.TP
\fB\-i\fR, \fB\-\-init\-tag\fR=\fITAG\fR
use \fITAG\fR to initialise target at beginning of a test
.TP
\fB\-c\fR, \fB\-\-config\-tag\fR=\fITAG\fR
use \fITAG\fR to configure target at beginning of a test or cycle
.TP
\fB\-s\fR, \fB\-\-rstate\-tag\fR=\fITAG\fR
use \fITAG\fR to query state of target
.TP
\fB\-u\fR, \fB\-\-uncfg\-tag\fR=\fITAG\fR
use \fITAG\fR to unconfigure ROCs before (re\-)configuring
.TP
\fB\-r\fR, \fB\-\-init\-tag\fR=\fITAG\fR
use \fITAG\fR to reset ROCs in error at beginning of a test
.TP
\fB\-o\fR, \fB\-\-trigger\-on\fR=\fICOMMAND\fR
shell command to start sending triggers
.TP
\fB\-f\fR, \fB\-\-trigger\-off\fR=\fICOMMAND\fR
shell command to stop sending triggers
.TP
\fB\-R\fR, \fB\-\-trigger\-reset\fR=\fICOMMAND\fR
shell command to reset trigger system for next cycle





.SH CONFIGURATION FILES

The configuration files can contain directives to control the target,
the tags and the trigger commands. Each line contains exaclty one
directive. Empty lines and lines starting with a comment sign (#) are
ignored. Possible directives are:

.TP
\fBtarget\fR \fITARGET\fR
run stresstest on \fITARGET\fR
.TP
\fBtag init\fR \fITAG\fR
use \fITAG\fR to initialise target at beginning of a test
.TP
\fBtag cfg\fR \fITAG\fR
use \fITAG\fR to configure target at beginning of a test or cycle
.TP
\fBtag rstate\fR \fITAG\fR
use \fITAG\fR to query state of target
.TP
\fBtag uncfg\fR \fITAG\fR
use \fITAG\fR to unconfigure ROCs before (re\-)configuring
.TP
\fBtag reset\fR \fITAG\fR
use \fITAG\fR to reset ROCs in error at beginning of a test
.TP
\fBtrigger on\fR \fICOMMAND\fR
shell command to start sending triggers
.TP
\fBtrigger off\fR \fICOMMAND\fR
shell command to stop sending triggers
.TP
\fBtrigger reset\fR \fICOMMAND\fR
shell command to reset trigger system for next cycle





.SH FILES
.TP
.I ~/.stresstestrc /etc/trd/stresstest.cfg
The user specific and system wide configuration file for
.B stresstest.


.SH EXAMPLES

.B Example configuration file

.ft R

# Default target
target sm0

# Tags to control ROCs in stress
tag init   201
tag cfg    503
tag reset  600
tag uncfg  350
tag rstate 60

# Commands to control trigger
trigger on     dimcmd ttcvi/command 1
trigger off    dimcmd ttcvi/command 7
trigger reset  dimcmd ttcvi/command reset

# XSL processing
xslt command   xsltproc /usr/share/pvss_mockup/rstate.xsl




.SH BUGS
None ;-)
.SH AUTHORS
Tom Dietel