runtest
Section: User Commands (1)
Updated: 31 Dec 1992
Index
Return to Main Contents
NAME
runtest - the DejaGnu test driver program
SYNOPSIS
runtest
[ options ]
DESCRIPTION
DejaGnu
is a framework for running test suites on GNU tools. It is written in
expect, which uses TCL (Tool command language).
runtest
is the test driver program; use it to control what tests to run,
and variations on how to run them.
You can find a comprehensive description of DejaGnu and runtest in
The DejaGnu Testing Framework
or its Info version,
dejagnu.info.
OPTIONS
- --help
-
Prints out a help screen and then exits.
- -D[number]
-
Activate the Tcl debugger.number can be either 1 or 0. If it is
1, then the expect shell will break when it starts to run. All ^C's
drop DejaGnu back to the debugger prompt. A 0 starts DejaGnu like
normal, but a ^C drops to the debugger prompt.
- --baud rate
-
Set the baud rate for a serial line connection. Some serial interface
programs (like tip) don't use this value but instead use a separate
initialization file.
- --version, -V
-
Prints out the versions of DejaGnu, expect and Tcl.
- --verbose, -v
-
Turns on more debugging output from test cases and DejaGnu utility code.
Use more than once to increase output further.
- --all
-
Print all test output to screen. By default, only unexpected results are
displayed.
- --diff file
-
Run diff on the summary of the current run and the previous run.
- --debug
-
Turn on
expect
internal debugging output. All output is logged to
a file called dbg.out.
The output of the --strace also goes into this file.
- --srcdir path
-
path is a directory containing test directories.
- --objdir path
-
path is a directory containing compiled test code.
- --strace N
-
Turns on
expect
internal tracing to N levels deep.
- --host type
-
The configuration string for the host.
- --target type
-
The configuration string for the host.
- --name hostname
-
The network hostname of the target board.
- --tool toolname
-
Specify the tool to be tested. toolname controls the test suite
applied, and the associated initialization module.
- --outdir directory
-
The name of a directory for test log output.
- --noreboot
-
Do not reboot the target board when runtest initializes.
- --mail 'name1 name2 ...'
-
Electronic mail addresses to receive test results.
- --connect type
-
The type of connection to use. The choices are rlogin, telnet,
rsh, kermit, tip, mondfe.
- Any file name on the command line is assumed to be a subset of the
-
test names to run. Usually these are the names of the expect test
driver, ie... special.exp.
Makefile style variables are used to specify tool names and their
flags; these and other configuration dependent values are saved in the
file site.exp, created during configuration.
EXIT CODES
runtest
sets the exit code to 1 if any of the tests failed, or
sets it to 0 if all the tests passed.
SEE ALSO
The DejaGnu Testing Framework
(dejagnu.info).
This is the DejaGnu manual; its source is the Texinfo file
doc/dejagnu.texi
in the DejaGnu distribution.
AUTHOR
Rob Savoye (rob@cygnus.com)
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- EXIT CODES
-
- SEE ALSO
-
- AUTHOR
-
This document was created by
man2html,
using the manual pages.
Time: 02:52:05 GMT, December 08, 2024