/usr/share/doc/liblognorm-dev/html/internals.html is in liblognorm-dev 1.1.2-1.1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Liblognorm internals — A fast log normalization library</title>
<link rel="stylesheet" href="_static/haiku.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: './',
VERSION: '1.1.2',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<link rel="top" title="A fast log normalization library" href="index.html" />
<link rel="next" title="Licensing" href="license.html" />
<link rel="prev" title="Library API" href="libraryapi.html" />
</head>
<body role="document">
<div class="header" role="banner"><h1 class="heading"><a href="index.html">
<span>Liblognorm 1.1.2 documentation</span></a></h1>
<h2 class="heading"><span>Liblognorm internals</span></h2>
</div>
<div class="topnav" role="navigation" aria-label="top navigation">
<p>
«  <a href="libraryapi.html">Library API</a>
  ::  
<a class="uplink" href="index.html">Contents</a>
  ::  
<a href="license.html">Licensing</a>  »
</p>
</div>
<div class="content">
<div class="section" id="liblognorm-internals">
<h1>Liblognorm internals<a class="headerlink" href="#liblognorm-internals" title="Permalink to this headline">¶</a></h1>
<div class="section" id="parse-tree">
<h2>Parse-tree<a class="headerlink" href="#parse-tree" title="Permalink to this headline">¶</a></h2>
<p>A parse-tree is generated each time when normalization process is set up.</p>
<p>You could also call it a optimized rulebase. Each message runs through
this tree consisting of parsers and fields and will be compared to it. The
message can either fit into a branch or not. If it fits, it can be
normalized. If it does not fit any branch in the tree, then a fitting
sample has to be created for this message.</p>
<p>The tree is built from branches. These branches consist of 3 things:
nodes, paths and parser.</p>
<p>A node is typically a literal part from a message where either a parser
follows or there are several subsequent literals which are different, so
one of the paths must be selected. After a parser, a node will always
follow. Parsers are like variables and thus the core structure of a
sample. With these a property field can be filled, which in the end is
needed to normalize the message.</p>
<p>A few notes on optimization of a parse-tree.</p>
<p>A parse-tree is always optimized, whether or not the samples of a similar
kind are next to each other or not. Even if you make the order totally
random, it should always result in the same parse-tree. Therefore, no
optimization efforts have to be made to the tree itself. It reuses
equivalent prefixes of messages which are already in the tree. Only if a
difference occurs, then a new node must follow.</p>
<p>One case where rule order can be significant is when a message can match
two or more different rules. This can occur when the rules differ in
parsers. If in doubt, use <a class="reference internal" href="lognormalizer.html"><em>lognormalizer</em></a> tool to
debug.</p>
</div>
</div>
</div>
<div class="bottomnav" role="navigation" aria-label="bottom navigation">
<p>
«  <a href="libraryapi.html">Library API</a>
  ::  
<a class="uplink" href="index.html">Contents</a>
  ::  
<a href="license.html">Licensing</a>  »
</p>
</div>
<div class="footer" role="contentinfo">
Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.3.1.
</div>
</body>
</html>
|