docs/Loggers.txt

   1                 Loggers
   2                 -------
   3
   4 Written by Pawel Dziepak <pdziepak@quarnos.org>
   5 Last modified: June 05, 2008
   6
   7 1. Description
   8 --------------
   9
  10 Loggers are services that Manes uses to communicate with the user. When a
  11 message is passed to the logger, it decides how important the information is.
  12 The decision is mainly based on the level of the message which is also passed
  13 to the logger. There are seven levels of importance:
  14         log_critical,
  15         log_failure,
  16         log_error,
  17         log_warning,
  18         log_alert,
  19         log_info,
  20         log_debug
  21 Messages marked as log_critical and log_failure are always sent to the main
  22 logger's data output. When message level is log_error, log_warning or log_alert
  23 the decision of the logger depends on its characteristic and current system
  24 state. Messages marked as log_info and log_debug are always sent to the
  25 secondary data output.
  26
  27 2. Data outputs
  28 ---------------
  29
  30 Loggers usually uses two data outputs, messages that logger decided to be
  31 important are sent to the main, rest of them goes to the secondary one. In
  32 most cases the main data output is a device (for example screen, serial port),
  33 while the secondary data output is a file where logs are saved.
  34
  35 3. Types of loggers
  36 -------------------
  37
  38 3.1. Early logger
  39 -----------------
  40
  41 It is used between start of the kernel and starting tty logger. It directly
  42 uses device drives, and do not need any other Manes feature to work. Other
  43 circumstances when it can be used is situation when a fatal kernel error occured
  44 and there is risk that message informing user might not be shown when using
  45 higher-level procedures.
  46