Boost C++ Libraries

The logger parameter allows to fully specify (log format, level and sink) one or several loggers in one command. If this parameter is specified, it has precedence over log_format, log_level and log_sink.

The parameter is repeatable: it may appear several times on the command line. It is possible to indicate a set of loggers using the separator ':', which is the only way for repeating a logger description through the environment variable.

The parameter is composed of three fields separated by a coma ',' and indicating respectively the log format, level and sink. The log format is mandatory. The log level and sink are both optional: if omitted, the default for the specified format will be used. The log level and sink accept the same value as their respective command line switch (see log_level and log_sink for more information).

Acceptable values

Case sensitive string:

logger_set    ::= (logger ':')* logger
logger        ::= logger_format (',' log_level? (',' log_sink? )? )?
logger_format ::= 'HRF' | 'XML' | 'JUNIT'
log_level     ::= 'all' | 'success' | 'test_suite' | 'message' | 'warning' | 'error' | 'cpp_exception' | 'system_error' | 'fatal_error' | 'nothing'
log_sink      ::= 'stdout' | 'stderr' | filename

Examples:

Command line syntax

Environment variable

BOOST_TEST_LOGGER