2.2.3 Common Options

Typically, you don’t need to use any command line options. The --tool option is only required when there is more than one testsuite in the same directory. The default options are in the local site.exp file, created by make site.exp.

For example, if the directory gdb/testsuite contains a collection of DejaGnu tests for GDB, you can run them like this:

$ cd gdb/testsuite
$ runtest --tool gdb

The test output follows, then ends with:

=== gdb Summary ===

# of expected passes 508
# of expected failures 103
/usr/latest/bin/gdb version 4.14.4 -nx

You can use the option --srcdir to point to some other directory containing a collection of tests:

$ runtest --srcdir /devo/gdb/testsuite

By default, runtest prints only the names of the tests it runs, output from any tests that have unexpected results, and a summary showing how many tests passed and how many failed. To display output from all tests (whether or not they behave as expected), use the -a (all) option. For more verbose output about processes being run, communication, and so on, use -v (verbose). To see even more output, use multiple -v options. See Invoking runtest for a more detailed explanation of each runtest option.