X-Git-Url: http://g0dil.de/git?a=blobdiff_plain;f=Utils%2FLogger%2FConfig.hh;h=34566b13f50d52a395a57f03045e788dc05ea712;hb=914aedddb62c3ca4fcabc881ad12b398a1c120f3;hp=4bfb369f7ffb0956c355ece9383ef66ff1894034;hpb=e7aa3355bca498de96d75d441865216706e74e3f;p=senf.git diff --git a/Utils/Logger/Config.hh b/Utils/Logger/Config.hh index 4bfb369..34566b1 100644 --- a/Utils/Logger/Config.hh +++ b/Utils/Logger/Config.hh @@ -99,6 +99,8 @@ The routing statements are processed by the targets in order, the first matching rule will decide a log messages fate for that target. + + \section config_fallback Fallback routing There are two cases, where this setup may lead to inadvertently lost log messages: \li When using a library which does internally use the Logger but not initializing the logger in @@ -107,9 +109,9 @@ Since no route is set up in these cases, the messages will be dropped. To counter this problem, the logger is initially in fallback routing state. If any log - message arrives in this state, the message will be unconditionally logged to the console. The - first routing statement on any target will take the logger out of this state and normal routing - will take place. + message arrives in this state, the message will be logged to the console if it is above the + default runtime limit of it's stream. The first routing statement on any target will take the + logger out of this state and normal routing will take place. \see \ref senf::log::Target @@ -123,8 +125,8 @@ By default, the logging library will call gettimeofday() for each log message. To change the time source, just pass the new class or instance to senf::log::timeSource: \code - // Use senf::Scheduler::instance().eventTime() to time log messages - senf::log::timeSource(); + // Use senf::scheduler::eventTime() to time log messages + senf::log::timeSource(); \endcode */ @@ -150,7 +152,7 @@ namespace log { stream ::= \e scope_seq \n optional_area::= (_) | \e scope_seq \n level ::= \c VERBOSE | \c NOTICE | \c MESSAGE | \c IMPORTANT | \c CRITICAL | \c DISABLED \n - scope_seq ::= \e scope \e scope \e scope* \n + scope_seq ::= \e scope \e scope* \n scope ::= ( \e name ) \n name ::= arbitrary C++ identifier