Boost C++ Libraries

...one of the most highly regarded and expertly designed C++ library projects in the world. Herb Sutter and Andrei Alexandrescu, C++ Coding Standards

This is the documentation for a snapshot of the master branch, built from commit cf4ea56341.
PrevUpHomeNext

logger

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

PrevUpHomeNext