packaging/dlog.conf.in

   1 #
   2 # Dlog configuration file.
   3 #
   4 # Lines beginning with '#' are comments.
   5 #
   6 # Following file configures dlog library.
   7 # First section contains global configuration for library.
   8 # It allows to disable or enable platform logs and log limiter features.
   9
  10 PlatformLogs                   on        # Possible values are 'on' and 'off'
  11 LogLimiter                     off
  12
  13 # Second section controls filtering rules for dlog limiter.
  14 # Each line represent a rule for a filter. Filtering is done
  15 # at runtime, but configuration is read only at the boot time.
  16 # Log lines filtered out are not written to log buffers.
  17 # Filtering is done for "TAG"|priority pair, where TAG is string defined by application.
  18 # Which should be quoted with '"' character. It may contain spaces but not TABs.
  19 # Priority is one character from the following values:
  20 #
  21 #     V or v or 1 - Verbose messages,
  22 #     D or d or 2 - Debug messages,
  23 #     I or i or 3 - Informational messages,
  24 #     W or w or 4 - Warning messages,
  25 #     E or e or 5 - Error messages,
  26 #     F or f or 6 - Fatal messages.
  27 #
  28 # Limiter can define rules 'for all' by using an '*' character.
  29 # It's a wildcard replacing all TAGs not mentioned in this file.
  30 # '*' could be used also as wildcard for priority.
  31 # An asterisk is not evaluated, which means rules like "WOR*" are threated as a TAGs.
  32 # Log filter works according to rules presented below:
  33 #
  34 # case 1) The "TAG"|priority pair is not presented on the list.
  35 #       - Use "TAG"|* rule to decide what to do.
  36 #       - If "TAG"|* is not defined, use "*"|priority rule to decide what to do.
  37 #       - If "*"|priority pair is not present, use "*"|* rule.
  38 #       - If rule "*"|* is not present, then allow logging.
  39 #
  40 # case 2) The "TAG"|priority pair is on the list (applies to
  41 #         "*" |priority and "*"|* rules).
  42 #       - If policy = ALLOW, then log speed is unlimited.
  43 #       - If policy = <number> then limit to <number> logs per minute.
  44 #       - If policy = DENY then forbid logging.
  45 #
  46 # Maximum <number> is 10000, which gives 10000 log line per minute.
  47 # Please keep in mind that dlog uses constant size log storage, thus
  48 # when the application writes many logs, it may cause older entries overwriting.
  49 #
  50 # The configuration file has following format:
  51 # Lines beginning with # are threated as comments.
  52 # TAG can contain any ASCII letter or digit and spaces, but
  53 # not a TAB character. TAG has to be quoted using '"' character.
  54 # TAG is separated from priority with pipe '|' character.
  55 # Priority is one character long, the possible values are presented above.
  56 # Policy is separated from the "TAG"|priority pair with TAB character.
  57 # Policy is expressed as ALLOW, DENY or number from 0 to 10000 (not case sensitive).
  58 # Setting policy as 0 is the same as DENY.
  59 # Setting policy to more than 10000 is threated as allow.
  60
  61
  62
  63
  64 # TAG|priority  POLICY
  65 "*"|*                           ALLOW