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

AUTHOR

124       Rob Savoye (rob@welcomehome.org)
125

REPORTING BUGS

127       Report bugs to <bug-dejagnu@gnu.org>.
128

COPYRIGHT

130       Copyright © 2005-2016, 2018, 2020 Free Software Foundation, Inc.
131
132       This is free software.  You may redistribute copies  of  it  under  the
133       terms   of  the  GNU  General  Public  License  <http://www.gnu.org/li‐
134       censes/gpl.html>.  There is NO WARRANTY, to  the  extent  permitted  by
135       law.
136