runtest(1)

1runtest(1)                  General Commands Manual                 runtest(1)
2
3
4

NAME

6       runtest - DejaGnu test driver
7

SYNOPSIS

9       runtest [OPTION]...
10

DESCRIPTION

12       DejaGnu  is  a framework for testing programs using Expect.  runtest is
13       the driver program for DejaGnu.  It controls what tests to run and  how
14       to run them.
15

OPTIONS

17       --all  Output all test results. By default, only unexpected results are
18              displayed.
19
20       --debug
21              Turn on expect internal debugging output. The output  is  logged
22              to a file called dbg.out.
23
24       --build TRIPLET
25              The configuration TRIPLET for the build system.
26
27       --directory DIRECTORY
28              Run only tests in the specified DIRECTORY.
29
30       --help Prints out a help screen and then exits.
31
32       --host TRIPLET
33              The configuration TRIPLET for the host system.
34
35       --host_board NAME
36              The host board defintion to use.
37
38       --ignore test1.exp test2.exp ...
39              Do not run the specified tests.
40
41       --mail ´name1 name2 ...´
42              Electronic mail addresses to receive test results.
43
44       --name HOSTNAME
45              The network HOSTNAME of the target board.
46
47       --objdir PATH
48              PATH is a directory containing compiled test code.
49
50       --outdir DIRECTORY
51              The name of a DIRECTORY for test log output.
52
53       --reboot
54              Reboot the target board when runtest initializes (if supported).
55
56       --srcdir PATH
57              PATH is a directory containing test directories.
58
59       --status
60              Set the exit status to fail on Tcl errors.
61
62       --strace N
63              Turns on expect internal tracing to N levels deep. The output is
64              logged to a file called dbg.out.
65
66       --target TRIPLET
67              The configuration TRIPLET for the target.
68
69       --target_board NAME
70              A list of target board NAMEs to run tests on.
71
72       --tool TOOLNAME
73              Specify the tool to be tested.  TOOLNAME controls the test suite
74              applied, and the associated initialization module.
75
76       --tool_exec PATH
77              Specify the PATH to the executable to test.
78
79       --tool_opts OPTIONS
80              Additional OPTIONS to pass to the tool.
81
82       --verbose, -v
83              Turns on more debugging output from test cases and DejaGnu util‐
84              ity code.  Use more than once to increase output further.
85
86       --version, -V
87              Prints out the versions of DejaGnu, Expect and Tcl.
88
89       --xml, -x
90              Generate XML output.
91
92       -D[number]
93              Activate the Tcl debugger.  number can be either 1 or 0.  If  it
94              is  1,  then  the expect shell will break when it starts to run.
95              The interrupt key will cause DejaGnu to  drop  to  the  debugger
96              prompt.  If  it is 0, DejaGnu starts as usual, but a ^C drops to
97              the debugger prompt.
98
99       Any file name on the command line is assumed to be a subset of the
100       test names to run.  Usually these are the names  of  the  test  scripts
101       (eg. foo.exp).
102
103       Makefile-style  variables  are  used  to  specify  tool names and their
104       flags; these and other configuration dependent values are saved in  the
105       file site.exp, created during configuration.
106

EXIT CODES

108       runtest  sets the exit code to 1 if any of the tests failed, or sets it
109       to 0 if all the tests passed.
110

AUTHOR

112       Rob Savoye (rob@welcomehome.org)
113

REPORTING BUGS

115       Report bugs to <bug-dejagnu@gnu.org>.
116

COPYRIGHT

118       Copyright © 2005, 2007, 2008 Free Software Foundation, Inc.
119       This is free software.  You may redistribute copies  of  it  under  the
120       terms       of       the      GNU      General      Public      License
121       <http://www.gnu.org/licenses/gpl.html>.  There is NO WARRANTY,  to  the
122       extent permitted by law.
123