Boost C++ Libraries 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 an old version of Boost. Click here to view this page for the latest version.


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: * --logger=HRF,all will set the all log level for the HRF log format, and will use the default sink associated to HRF (stdout) * --logger=JUNIT,,somefile.xml:HRF,warning will use the default log level associated to the JUNIT log format, and will use the file somefile.xml as the log sink. It will also enable the HRF format with log level warning. The corresponding sink will be set to the HRF default (stdout).

Command line syntax
Environment variable