• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1<html>
2<head>
3<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
4<title>Summary of run-time parameters</title>
5<link rel="stylesheet" href="../../boostbook.css" type="text/css">
6<meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
7<link rel="home" href="../../index.html" title="Boost.Test">
8<link rel="up" href="../runtime_config.html" title="Runtime parameters">
9<link rel="prev" href="custom_command_line_arguments.html" title="Custom command line arguments">
10<link rel="next" href="../adv_scenarios.html" title="Advanced Usage Scenarios">
11</head>
12<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
13<table cellpadding="2" width="100%"><tr>
14<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../boost.png"></td>
15<td align="center"><a href="../../../../../../index.html">Home</a></td>
16<td align="center"><a href="../../../../../../libs/libraries.htm">Libraries</a></td>
17<td align="center"><a href="http://www.boost.org/users/people.html">People</a></td>
18<td align="center"><a href="http://www.boost.org/users/faq.html">FAQ</a></td>
19<td align="center"><a href="../../../../../../more/index.htm">More</a></td>
20</tr></table>
21<hr>
22<div class="spirit-nav">
23<a accesskey="p" href="custom_command_line_arguments.html"><img src="../../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../runtime_config.html"><img src="../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="../adv_scenarios.html"><img src="../../../../../../doc/src/images/next.png" alt="Next"></a>
24</div>
25<div class="section">
26<div class="titlepage"><div><div><h3 class="title">
27<a name="boost_test.runtime_config.summary"></a><a class="link" href="summary.html" title="Summary of run-time parameters">Summary of run-time
28      parameters</a>
29</h3></div></div></div>
30<div class="informaltable"><table class="table">
31<colgroup>
32<col>
33<col>
34</colgroup>
35<thead><tr>
36<th>
37                <p>
38                  Command
39                </p>
40              </th>
41<th>
42                <p>
43                  Short description
44                </p>
45              </th>
46</tr></thead>
47<tbody>
48<tr>
49<td>
50                <p>
51                  <a class="link" href="../utf_reference/rt_param_reference/auto_dbg.html" title="auto_start_dbg"><code class="computeroutput"><span class="identifier">auto_start_dbg</span></code></a>
52                </p>
53              </td>
54<td>
55                <p>
56                  Instructs the framework to automatically attach debugger in case
57                  of system failure.
58                </p>
59              </td>
60</tr>
61<tr>
62<td>
63                <p>
64                  <a class="link" href="../utf_reference/rt_param_reference/build_info.html" title="build_info"><code class="computeroutput"><span class="identifier">build_info</span></code></a>
65                </p>
66              </td>
67<td>
68                <p>
69                  Instructs the framework to display library build information.
70                </p>
71              </td>
72</tr>
73<tr>
74<td>
75                <p>
76                  <a class="link" href="../utf_reference/rt_param_reference/catch_system.html" title="catch_system_errors"><code class="computeroutput"><span class="identifier">catch_system_error</span></code></a>
77                </p>
78              </td>
79<td>
80                <p>
81                  Instructs the framework to catch system errors.
82                </p>
83              </td>
84</tr>
85<tr>
86<td>
87                <p>
88                  <a class="link" href="../utf_reference/rt_param_reference/color_output.html" title="color_output"><code class="computeroutput"><span class="identifier">color_output</span></code></a>
89                </p>
90              </td>
91<td>
92                <p>
93                  Instructs the framework to produce color output
94                </p>
95              </td>
96</tr>
97<tr>
98<td>
99                <p>
100                  <a class="link" href="../utf_reference/rt_param_reference/detect_fp_exceptions.html" title="detect_fp_exceptions"><code class="computeroutput"><span class="identifier">detect_fp_exceptions</span></code></a>
101                </p>
102              </td>
103<td>
104                <p>
105                  Instructs the framework to trap floating point exceptions (on supported
106                  platforms).
107                </p>
108              </td>
109</tr>
110<tr>
111<td>
112                <p>
113                  <a class="link" href="../utf_reference/rt_param_reference/detect_memory_leaks.html" title="detect_memory_leaks"><code class="computeroutput"><span class="identifier">detect_memory_leaks</span></code></a>
114                </p>
115              </td>
116<td>
117                <p>
118                  Instructs the framework to detect memory leaks (on supported platforms).
119                </p>
120              </td>
121</tr>
122<tr>
123<td>
124                <p>
125                  <a class="link" href="../utf_reference/rt_param_reference/help.html" title="help"><code class="computeroutput"><span class="identifier">help</span></code></a>
126                </p>
127              </td>
128<td>
129                <p>
130                  Provides help on the <span class="emphasis"><em>Unit Test Framework</em></span> parameters.
131                </p>
132              </td>
133</tr>
134<tr>
135<td>
136                <p>
137                  <a class="link" href="../utf_reference/rt_param_reference/list_content.html" title="list_content"><code class="computeroutput"><span class="identifier">list_content</span></code></a>
138                </p>
139              </td>
140<td>
141                <p>
142                  Lists the tests units, their organization in the test tree, their
143                  enabled/disabled state...
144                </p>
145              </td>
146</tr>
147<tr>
148<td>
149                <p>
150                  <a class="link" href="../utf_reference/rt_param_reference/list_labels.html" title="list_labels"><code class="computeroutput"><span class="identifier">list_labels</span></code></a>
151                </p>
152              </td>
153<td>
154                <p>
155                  Lists the labels defined in the test module.
156                </p>
157              </td>
158</tr>
159<tr>
160<td>
161                <p>
162                  <a class="link" href="../utf_reference/rt_param_reference/log_format.html" title="log_format"><code class="computeroutput"><span class="identifier">log_format</span></code></a>
163                </p>
164              </td>
165<td>
166                <p>
167                  Specifies the log format
168                </p>
169              </td>
170</tr>
171<tr>
172<td>
173                <p>
174                  <a class="link" href="../utf_reference/rt_param_reference/log_level.html" title="log_level"><code class="computeroutput"><span class="identifier">log_level</span></code></a>
175                </p>
176              </td>
177<td>
178                <p>
179                  Specifies the framework's logging level
180                </p>
181              </td>
182</tr>
183<tr>
184<td>
185                <p>
186                  <a class="link" href="../utf_reference/rt_param_reference/log_sink.html" title="log_sink"><code class="computeroutput"><span class="identifier">log_sink</span></code></a>
187                </p>
188              </td>
189<td>
190                <p>
191                  Specifies where to write testing log to.
192                </p>
193              </td>
194</tr>
195<tr>
196<td>
197                <p>
198                  <a class="link" href="../utf_reference/rt_param_reference/logger.html" title="logger"><code class="computeroutput"><span class="identifier">logger</span></code></a>
199                </p>
200              </td>
201<td>
202                <p>
203                  Specifies the log level, format and sink of one or more loggers.
204                </p>
205              </td>
206</tr>
207<tr>
208<td>
209                <p>
210                  <a class="link" href="../utf_reference/rt_param_reference/output_format.html" title="output_format"><code class="computeroutput"><span class="identifier">output_format</span></code></a>
211                </p>
212              </td>
213<td>
214                <p>
215                  Specifies the log format and the report format.
216                </p>
217              </td>
218</tr>
219<tr>
220<td>
221                <p>
222                  <a class="link" href="../utf_reference/rt_param_reference/random.html" title="random"><code class="computeroutput"><span class="identifier">random</span></code></a>
223                </p>
224              </td>
225<td>
226                <p>
227                  Instructs the framework to run the tests in random order
228                </p>
229              </td>
230</tr>
231<tr>
232<td>
233                <p>
234                  <a class="link" href="../utf_reference/rt_param_reference/report_format.html" title="report_format"><code class="computeroutput"><span class="identifier">report_format</span></code></a>
235                </p>
236              </td>
237<td>
238                <p>
239                  Specifies the report format.
240                </p>
241              </td>
242</tr>
243<tr>
244<td>
245                <p>
246                  <a class="link" href="../utf_reference/rt_param_reference/report_level.html" title="report_level"><code class="computeroutput"><span class="identifier">report_level</span></code></a>
247                </p>
248              </td>
249<td>
250                <p>
251                  Specifies the level of details carried by the framework's testing
252                  result report.
253                </p>
254              </td>
255</tr>
256<tr>
257<td>
258                <p>
259                  <a class="link" href="../utf_reference/rt_param_reference/report_memory_leaks_to.html" title="report_memory_leaks_to"><code class="computeroutput"><span class="identifier">report_memory_leaks_to</span></code></a>
260                </p>
261              </td>
262<td>
263                <p>
264                  Specifies file name where memory leaks report should be re-directed
265                  to.
266                </p>
267              </td>
268</tr>
269<tr>
270<td>
271                <p>
272                  <a class="link" href="../utf_reference/rt_param_reference/report_sink.html" title="report_sink"><code class="computeroutput"><span class="identifier">report_sink</span></code></a>
273                </p>
274              </td>
275<td>
276                <p>
277                  Specifies where to write the testing result report to.
278                </p>
279              </td>
280</tr>
281<tr>
282<td>
283                <p>
284                  <a class="link" href="../utf_reference/rt_param_reference/result_code.html" title="result_code"><code class="computeroutput"><span class="identifier">result_code</span></code></a>
285                </p>
286              </td>
287<td>
288                <p>
289                  Instructs the framework to return or ignore a result code indicating
290                  an error in the tests.
291                </p>
292              </td>
293</tr>
294<tr>
295<td>
296                <p>
297                  <a class="link" href="../utf_reference/rt_param_reference/run_test.html" title="run_test"><code class="computeroutput"><span class="identifier">run_test</span></code></a>
298                </p>
299              </td>
300<td>
301                <p>
302                  Allows to filter which test units to execute at runtime.
303                </p>
304              </td>
305</tr>
306<tr>
307<td>
308                <p>
309                  <a class="link" href="../utf_reference/rt_param_reference/save_pattern.html" title="save_pattern"><code class="computeroutput"><span class="identifier">save_pattern</span></code></a>
310                </p>
311              </td>
312<td>
313                <p>
314                  Facilitates mode switching for testing output streams.
315                </p>
316              </td>
317</tr>
318<tr>
319<td>
320                <p>
321                  <a class="link" href="../utf_reference/rt_param_reference/show_progress.html" title="show_progress"><code class="computeroutput"><span class="identifier">show_progress</span></code></a>
322                </p>
323              </td>
324<td>
325                <p>
326                  Instructs the framework to print progress information. More details
327                  <a class="link" href="../test_output/test_output_progress.html" title="Progress display">here</a>.
328                </p>
329              </td>
330</tr>
331<tr>
332<td>
333                <p>
334                  <a class="link" href="../utf_reference/rt_param_reference/use_alt_stack.html" title="use_alt_stack"><code class="computeroutput"><span class="identifier">use_alt_stack</span></code></a>
335                </p>
336              </td>
337<td>
338                <p>
339                  Instructs the framework to use an alternative stack for signal
340                  processing (on supported platforms).
341                </p>
342              </td>
343</tr>
344<tr>
345<td>
346                <p>
347                  <a class="link" href="../utf_reference/rt_param_reference/usage.html" title="usage"><code class="computeroutput"><span class="identifier">usage</span></code></a>
348                </p>
349              </td>
350<td>
351                <p>
352                  Displays short usage message.
353                </p>
354              </td>
355</tr>
356<tr>
357<td>
358                <p>
359                  <a class="link" href="../utf_reference/rt_param_reference/wait_for_debugger.html" title="wait_for_debugger"><code class="computeroutput"><span class="identifier">wait_for_debugger</span></code></a>
360                </p>
361              </td>
362<td>
363                <p>
364                  Instructs the framework to pause test module before testing is
365                  started to allow debugger to attach.
366                </p>
367              </td>
368</tr>
369</tbody>
370</table></div>
371</div>
372<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
373<td align="left"></td>
374<td align="right"><div class="copyright-footer">Copyright © 2001-2020 Boost.Test contributors<p>
375        Distributed under the Boost Software License, Version 1.0. (See accompanying
376        file LICENSE_1_0.txt or copy at <a href="http://www.boost.org/LICENSE_1_0.txt" target="_top">http://www.boost.org/LICENSE_1_0.txt</a>)
377      </p>
378</div></td>
379</tr></table>
380<hr>
381<div class="spirit-nav">
382<a accesskey="p" href="custom_command_line_arguments.html"><img src="../../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../runtime_config.html"><img src="../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="../adv_scenarios.html"><img src="../../../../../../doc/src/images/next.png" alt="Next"></a>
383</div>
384</body>
385</html>
386