| 1 |
578 |
markom |
.TH runtest 1 "08 Dec 1998"
|
| 2 |
|
|
.SH NAME
|
| 3 |
|
|
runtest \- the DejaGnu test driver program
|
| 4 |
|
|
.SH SYNOPSIS
|
| 5 |
|
|
.B runtest
|
| 6 |
|
|
[ options ]
|
| 7 |
|
|
.SH DESCRIPTION
|
| 8 |
|
|
.I DejaGnu
|
| 9 |
|
|
is a framework for running test suites on GNU tools. It is written in
|
| 10 |
|
|
expect, which uses TCL (Tool command language).
|
| 11 |
|
|
.B runtest
|
| 12 |
|
|
is the test driver program; use it to control what tests to run,
|
| 13 |
|
|
and variations on how to run them.
|
| 14 |
|
|
|
| 15 |
|
|
You can find a comprehensive description of DejaGnu and \fBruntest\fR in
|
| 16 |
|
|
.I
|
| 17 |
|
|
The DejaGnu Testing Framework
|
| 18 |
|
|
or its Info version,
|
| 19 |
|
|
.BR dejagnu.info .
|
| 20 |
|
|
.SH OPTIONS
|
| 21 |
|
|
.TP
|
| 22 |
|
|
.B --all
|
| 23 |
|
|
Print all test output to screen. By default, only unexpected results are
|
| 24 |
|
|
displayed.
|
| 25 |
|
|
.TP
|
| 26 |
|
|
.BI --baud \ rate
|
| 27 |
|
|
Set the baud rate for a serial line connection. Some serial interface
|
| 28 |
|
|
programs (like \fBtip\fR) don't use this value but instead use a separate
|
| 29 |
|
|
initialization file.
|
| 30 |
|
|
.TP
|
| 31 |
|
|
.BI --connect \ type
|
| 32 |
|
|
The type of connection to use. The choices are
|
| 33 |
|
|
.BR rlogin ,
|
| 34 |
|
|
.BR telnet ,
|
| 35 |
|
|
.BR rsh ,
|
| 36 |
|
|
.BR kermit ,
|
| 37 |
|
|
.BR tip
|
| 38 |
|
|
and
|
| 39 |
|
|
.BR mondfe .
|
| 40 |
|
|
.TP
|
| 41 |
|
|
.B --debug
|
| 42 |
|
|
Turn on
|
| 43 |
|
|
.B expect
|
| 44 |
|
|
internal debugging output. All output is logged to
|
| 45 |
|
|
a file called \fBdbg.out\fR.
|
| 46 |
|
|
The output of the \fB--strace\fR also goes into this file.
|
| 47 |
|
|
.TP
|
| 48 |
|
|
.B --help
|
| 49 |
|
|
Prints out a help screen and then exits.
|
| 50 |
|
|
.TP
|
| 51 |
|
|
.BI --host \ type
|
| 52 |
|
|
The configuration string for the host.
|
| 53 |
|
|
.TP
|
| 54 |
|
|
.BI --ignore \ test1.exp\ test2.exp\ ...
|
| 55 |
|
|
Do not run the specified tests.
|
| 56 |
|
|
.BI --mail \ \'name1\ name2\ ...\'
|
| 57 |
|
|
Electronic mail addresses to receive test results.
|
| 58 |
|
|
.TP
|
| 59 |
|
|
.BI --name \ hostname
|
| 60 |
|
|
The network hostname of the target board.
|
| 61 |
|
|
.TP
|
| 62 |
|
|
.BI --objdir \ path
|
| 63 |
|
|
\fIpath\fR is a directory containing compiled test code.
|
| 64 |
|
|
.TP
|
| 65 |
|
|
.BI --outdir \ directory
|
| 66 |
|
|
The name of a directory for test log output.
|
| 67 |
|
|
.TP
|
| 68 |
|
|
.B --reboot
|
| 69 |
|
|
Reboot the target board when \fBruntest\fR initializes
|
| 70 |
|
|
(if supported).
|
| 71 |
|
|
.TP
|
| 72 |
|
|
.BI --srcdir \ path
|
| 73 |
|
|
\fIpath\fR is a directory containing test directories.
|
| 74 |
|
|
.TP
|
| 75 |
|
|
.BI --strace \ N
|
| 76 |
|
|
Turns on
|
| 77 |
|
|
.B expect
|
| 78 |
|
|
internal tracing to \fIN\fR levels deep.
|
| 79 |
|
|
.TP
|
| 80 |
|
|
.BI --target \ type
|
| 81 |
|
|
The configuration string for the target.
|
| 82 |
|
|
.TP
|
| 83 |
|
|
.BI --tool \ toolname
|
| 84 |
|
|
Specify the tool to be tested. \fItoolname\fR controls the test suite
|
| 85 |
|
|
applied, and the associated initialization module.
|
| 86 |
|
|
.TP
|
| 87 |
|
|
.B --verbose,\ -v
|
| 88 |
|
|
Turns on more debugging output from test cases and DejaGnu utility code.
|
| 89 |
|
|
Use more than once to increase output further.
|
| 90 |
|
|
.TP
|
| 91 |
|
|
.B --version,\ -V
|
| 92 |
|
|
Prints out the versions of DejaGnu, expect and Tcl.
|
| 93 |
|
|
.TP
|
| 94 |
|
|
.B -D[number]
|
| 95 |
|
|
Activate the Tcl debugger.\fBnumber\fR can be either 1 or 0. If it is
|
| 96 |
|
|
1, then the expect shell will break when it starts to run. All ^C's
|
| 97 |
|
|
drop DejaGnu back to the debugger prompt. A 0 starts DejaGnu like
|
| 98 |
|
|
normal, but a ^C drops to the debugger prompt.
|
| 99 |
|
|
.TP 0
|
| 100 |
|
|
Any file name on the command line is assumed to be a subset
|
| 101 |
|
|
of the test names to run. Usually these are the names of the
|
| 102 |
|
|
expect test driver, ie... special.exp.
|
| 103 |
|
|
|
| 104 |
|
|
Makefile style variables are used to specify tool names and their
|
| 105 |
|
|
flags; these and other configuration dependent values are saved in the
|
| 106 |
|
|
file \fBsite.exp\fR, created during configuration.
|
| 107 |
|
|
.SH EXIT CODES
|
| 108 |
|
|
.B runtest
|
| 109 |
|
|
sets the exit code to 1 if any of the tests failed, or
|
| 110 |
|
|
sets it to 0 if all the tests passed.
|
| 111 |
|
|
.SH SEE ALSO
|
| 112 |
|
|
.I The DejaGnu Testing Framework
|
| 113 |
|
|
.RB ( dejagnu.info ).
|
| 114 |
|
|
This is the DejaGnu manual; its source is the SGML files
|
| 115 |
|
|
.B
|
| 116 |
|
|
doc/*.sgml.
|
| 117 |
|
|
in the DejaGnu distribution.
|
| 118 |
|
|
.SH AUTHOR
|
| 119 |
|
|
Rob Savoye (rob@welcomehome.org)
|
