|
Packit |
62fe53 |
.TH runtest 1 "2017-10-16"
|
|
Packit |
62fe53 |
.SH NAME
|
|
Packit |
62fe53 |
runtest \- DejaGnu test driver
|
|
Packit |
62fe53 |
.SH SYNOPSIS
|
|
Packit |
62fe53 |
.B runtest
|
|
Packit |
62fe53 |
[OPTION]...
|
|
Packit |
62fe53 |
.SH DESCRIPTION
|
|
Packit |
62fe53 |
.I DejaGnu
|
|
Packit |
62fe53 |
is a framework for testing programs using Expect.
|
|
Packit |
62fe53 |
.B runtest
|
|
Packit |
62fe53 |
is the driver program for
|
|
Packit |
62fe53 |
.I DejaGnu.
|
|
Packit |
62fe53 |
It controls what tests to run and how to run them.
|
|
Packit |
62fe53 |
.SH OPTIONS
|
|
Packit |
62fe53 |
.TP
|
|
Packit |
62fe53 |
.B --all,\ -a
|
|
Packit |
62fe53 |
Output all test results. By default, only unexpected results are
|
|
Packit |
62fe53 |
displayed.
|
|
Packit |
62fe53 |
.TP
|
|
Packit |
62fe53 |
.BI --build \ TRIPLET
|
|
Packit |
62fe53 |
The configuration TRIPLET for the build system.
|
|
Packit |
62fe53 |
.TP
|
|
Packit |
62fe53 |
.B --debug
|
|
Packit |
62fe53 |
Turn on
|
|
Packit |
62fe53 |
.B Expect
|
|
Packit |
62fe53 |
internal debugging output. The output is logged to a file called
|
|
Packit |
62fe53 |
\fBdbg.log\fR.
|
|
Packit |
62fe53 |
.TP
|
|
Packit |
62fe53 |
.BI --directory \ DIRECTORY
|
|
Packit |
62fe53 |
Run only tests in the specified DIRECTORY.
|
|
Packit |
62fe53 |
.TP
|
|
Packit |
62fe53 |
.B --help
|
|
Packit |
62fe53 |
Prints a usage message and then exits.
|
|
Packit |
62fe53 |
.TP
|
|
Packit |
62fe53 |
.BI --host \ TRIPLET
|
|
Packit |
62fe53 |
The configuration TRIPLET for the host system.
|
|
Packit |
62fe53 |
.TP
|
|
Packit |
62fe53 |
.BI --host_board \ NAME
|
|
Packit |
62fe53 |
The host board definition to use.
|
|
Packit |
62fe53 |
.TP
|
|
Packit |
62fe53 |
.BI --ignore \ test1.exp\ test2.exp\ ...
|
|
Packit |
62fe53 |
Do not run the specified tests.
|
|
Packit |
62fe53 |
.TP
|
|
Packit |
62fe53 |
.B --log_dialog
|
|
Packit |
62fe53 |
Emit Expect output to standard output.
|
|
Packit |
62fe53 |
.TP
|
|
Packit |
62fe53 |
.BI --mail \ \'name1\ name2\ ...\'
|
|
Packit |
62fe53 |
Electronic mail addresses to receive test results.
|
|
Packit |
62fe53 |
.TP
|
|
Packit |
62fe53 |
.BI --name \ HOSTNAME
|
|
Packit |
62fe53 |
The network HOSTNAME of the target board.
|
|
Packit |
62fe53 |
.TP
|
|
Packit |
62fe53 |
.BI --objdir \ PATH
|
|
Packit |
62fe53 |
\fIPATH\fR is a directory containing compiled test code.
|
|
Packit |
62fe53 |
.TP
|
|
Packit |
62fe53 |
.BI --outdir \ DIRECTORY
|
|
Packit |
62fe53 |
The name of a DIRECTORY for test log output.
|
|
Packit |
62fe53 |
.TP
|
|
Packit |
62fe53 |
.B --reboot
|
|
Packit |
62fe53 |
Reboot the target board when \fBruntest\fR initializes
|
|
Packit |
62fe53 |
(if supported).
|
|
Packit |
62fe53 |
.TP
|
|
Packit |
62fe53 |
.BI --srcdir \ PATH
|
|
Packit |
62fe53 |
\fIPATH\fR is a directory containing test directories.
|
|
Packit |
62fe53 |
.TP
|
|
Packit |
62fe53 |
.BI --strace \ N
|
|
Packit |
62fe53 |
Turns on
|
|
Packit |
62fe53 |
.B Expect
|
|
Packit |
62fe53 |
internal tracing to \fIN\fR levels deep. The output is logged to a
|
|
Packit |
62fe53 |
file called \fBdbg.log\fR.
|
|
Packit |
62fe53 |
.TP
|
|
Packit |
62fe53 |
.BI --target \ TRIPLET
|
|
Packit |
62fe53 |
The configuration TRIPLET for the target.
|
|
Packit |
62fe53 |
.TP
|
|
Packit |
62fe53 |
.BI --target_board \ NAME
|
|
Packit |
62fe53 |
A list of target board NAMEs to run tests on.
|
|
Packit |
62fe53 |
.TP
|
|
Packit |
62fe53 |
.BI --tool \ TOOLNAME
|
|
Packit |
62fe53 |
Specify the tool to be tested. \fITOOLNAME\fR controls the test suite
|
|
Packit |
62fe53 |
applied, and the associated initialization module.
|
|
Packit |
62fe53 |
.TP
|
|
Packit |
62fe53 |
.BI --tool_exec \ PATH
|
|
Packit |
62fe53 |
Specify the PATH to the executable to test.
|
|
Packit |
62fe53 |
.TP
|
|
Packit |
62fe53 |
.BI --tool_opts \ OPTIONS
|
|
Packit |
62fe53 |
Additional OPTIONS to pass to the tool.
|
|
Packit |
62fe53 |
.TP
|
|
Packit |
62fe53 |
.B -v,\ --verbose
|
|
Packit |
62fe53 |
Turns on more debugging output from test cases and DejaGnu utility code.
|
|
Packit |
62fe53 |
Use more than once to increase output further.
|
|
Packit |
62fe53 |
.TP
|
|
Packit |
62fe53 |
.B -V,\ --version
|
|
Packit |
62fe53 |
Prints out the versions of DejaGnu, Expect and Tcl.
|
|
Packit |
62fe53 |
.TP
|
|
Packit |
62fe53 |
.B -x,\ --xml
|
|
Packit |
62fe53 |
Generate XML output. The output file is named after the tool with
|
|
Packit |
62fe53 |
an .xml extension.
|
|
Packit |
62fe53 |
.TP
|
|
Packit |
62fe53 |
.B -D[number]
|
|
Packit |
62fe53 |
Activate the Tcl debugger. \fBnumber\fR can be either 1 or 0. If it
|
|
Packit |
62fe53 |
is 1, then the Expect shell will break when it starts to run. The
|
|
Packit |
62fe53 |
interrupt key will cause DejaGnu to drop to the debugger prompt. If it
|
|
Packit |
62fe53 |
is 0, DejaGnu starts as usual, but Control-C drops to the debugger
|
|
Packit |
62fe53 |
prompt.
|
|
Packit |
62fe53 |
.TP 0
|
|
Packit |
62fe53 |
Any file name on the command line is assumed to be a subset of the
|
|
Packit |
62fe53 |
test names to run. Usually these are the names of the test scripts
|
|
Packit |
62fe53 |
(eg. foo.exp).
|
|
Packit |
62fe53 |
.PP
|
|
Packit |
62fe53 |
Makefile-style variables are used to specify tool names and their
|
|
Packit |
62fe53 |
flags; these and other configuration dependent values are saved in the
|
|
Packit |
62fe53 |
file \fBsite.exp\fR, created during configuration.
|
|
Packit |
62fe53 |
.SS "Exit status:"
|
|
Packit |
62fe53 |
.TP
|
|
Packit |
62fe53 |
0
|
|
Packit |
62fe53 |
if all tests passed including expected failures and unsupported tests,
|
|
Packit |
62fe53 |
.TP
|
|
Packit |
62fe53 |
1
|
|
Packit |
62fe53 |
if any test failed, passed unexpectedly, or was unresolved,
|
|
Packit |
62fe53 |
.TP
|
|
Packit |
62fe53 |
2
|
|
Packit |
62fe53 |
if Expect encountered any error in the test scripts.
|
|
Packit |
62fe53 |
.SH AUTHOR
|
|
Packit |
62fe53 |
Rob Savoye (rob@welcomehome.org)
|
|
Packit |
62fe53 |
.SH "REPORTING BUGS"
|
|
Packit |
62fe53 |
Report bugs to <bug\-dejagnu@gnu.org>.
|
|
Packit |
62fe53 |
.SH COPYRIGHT
|
|
Packit |
62fe53 |
Copyright \(co 2005\-2016 Free Software Foundation, Inc.
|
|
Packit |
62fe53 |
.PP
|
|
Packit |
62fe53 |
This is free software. You may redistribute copies of it under the terms of
|
|
Packit |
62fe53 |
the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
|
|
Packit |
62fe53 |
There is NO WARRANTY, to the extent permitted by law.
|
|
Packit |
62fe53 |
.SH "SEE ALSO"
|
|
Packit |
62fe53 |
The full documentation for
|
|
Packit |
62fe53 |
.B DejaGnu
|
|
Packit |
62fe53 |
is maintained as a Texinfo manual. If the
|
|
Packit |
62fe53 |
.B info
|
|
Packit |
62fe53 |
program is properly installed at your site, the command
|
|
Packit |
62fe53 |
.IP
|
|
Packit |
62fe53 |
.B info dejagnu
|
|
Packit |
62fe53 |
.PP
|
|
Packit |
62fe53 |
should give you access to the complete manual.
|