log_dbglevels.h File Reference

When a message is logged with DEBUG severity, the debug level associated with the message is also specified. More...

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Namespaces
namespace	isc
	Defines the logger used by the top-level component of kea-lfc.
namespace	isc::log

Detailed Description

When a message is logged with DEBUG severity, the debug level associated with the message is also specified.

This debug level is a number ranging from 0 to 99; the idea is that the higher the debug level, the more detailed the message.

If debug messages are being logged, the logging system allows them to be filtered by debug level - only messages logged with a level equal to or less than the set debug level will be output. (For example, if the filter is set to 30, only debug messages logged with levels in the range 0 to 30 will be output; messages logged with levels 31 to 99 will be suppressed.)

Levels of 30 or below are reserved for debug messages that are most likely to be useful for an administrator. Levels 31 to 99 are for use by someone familiar with the code. "Useful for an administrator" is, admittedly, a subjective term: it is loosely defined as messages helping someone diagnose a problem that they could solve without needing to dive into the code. So it covers things like start-up steps and configuration messages.

In practice, this means that levels of 30 and below are most-likely to be used by the top-level programs, and 31 and above by the various libraries.

This file defines a set of standard debug levels for use across all loggers. In this way users can have some expectation of what will be output when enabling debugging. Symbols are prefixed DBGLVL so as not to clash with DBG_ symbols in the various modules.

Definition in file log_dbglevels.h.