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

AUTHOR

118       Rob Savoye (rob@welcomehome.org)
119

REPORTING BUGS

121       Report bugs to <bug-dejagnu@gnu.org>.
122

COPYRIGHT

124       Copyright © 2005-2016 Free Software Foundation, Inc.
125
126       This  is  free  software.   You may redistribute copies of it under the
127       terms      of      the      GNU      General       Public       License
128       <http://www.gnu.org/licenses/gpl.html>.   There  is NO WARRANTY, to the
129       extent permitted by law.
130