runtest(1)

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, -h
    Prints out a help screen and then exits.

--baud, -b
    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
    (Not yet implemented.) 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.

--strace N
    Turns on expect internal tracing to N levels deep.

--target hostname
    The network hostname of the target board.

--runtest
    The names of specific test files to run.

--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
    (Not yet implemented.) Electronic mail addresses to receive test results.

--connect type
    The type of connection to use. The choices are rlogin, telnet, rsh, kermit, tip, mondfe.

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)