40 lines
1.7 KiB
Plaintext
40 lines
1.7 KiB
Plaintext
[/
|
|
/ Copyright (c) 2003 Boost.Test contributors
|
|
/
|
|
/ Distributed under the Boost Software License, Version 1.0. (See accompanying
|
|
/ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
|
/]
|
|
|
|
|
|
[section:runtime_config Runtime parameters]
|
|
|
|
|
|
The __UTF__ supports multiple parameters that affect test module execution. To set the parameter's value you can
|
|
either use a runtime configuration subsystem interface from within the test module initialization function or you can
|
|
specify the value at runtime during test module invocation.
|
|
|
|
The __UTF__ provides two ways to set a parameter at runtime: by specifying a command line argument and by setting an
|
|
environment variable. The command line argument always overrides the corresponding environment variable.
|
|
|
|
During test module initialization the __UTF__ parses the command line and excludes all parameters that belong to it and
|
|
their values from the argument list. The rest of command line is forwarded to the test module initialization function
|
|
supplied by you. The command line argument format expected by the __UTF__ is:
|
|
|
|
[pre
|
|
--<command_line_argument_name>=<argument_value>
|
|
]
|
|
|
|
The command line argument name is case sensitive. It is required to match exactly the name in parameter specification.
|
|
There should not be any spaces between '=' and either command line argument name or argument value.
|
|
|
|
|
|
The corresponding environment variable name is also case sensitive and is required to exactly match the name in the
|
|
parameter specification.
|
|
|
|
All information about supported parameters is summarized below in the reference section.
|
|
|
|
[include test_unit_filtering.qbk]
|
|
[include runtime_config_summary.qbk]
|
|
|
|
|
|
[endsect] [/ runtime configuration] |