/usr/share/doc/lire/dev-manual/ch02.html is in lire-devel-doc 2:2.1.1-2.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 | <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Chapter 2. Writing a New DLF Converter</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><link rel="home" href="index.html" title="Lire Developer's Manual"><link rel="up" href="pt02.html" title="Part II. Using the Lire Framework"><link rel="prev" href="pt02.html" title="Part II. Using the Lire Framework"><link rel="next" href="ch02s02.html" title="The common_syslog Log Format"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 2. Writing a New DLF Converter</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="pt02.html">Prev</a> </td><th width="60%" align="center">Part II. Using the <span class="application">Lire</span> Framework</th><td width="20%" align="right"> <a accesskey="n" href="ch02s02.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 2. Writing a New DLF Converter"><div class="titlepage"><div><div><h2 class="title"><a name="chap:writing-converter"></a>Chapter 2. Writing a New DLF Converter</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="ch02.html#id402415">Prerequisites</a></span></dt><dt><span class="section"><a href="ch02s02.html">The <span class="type">common_syslog</span> Log Format</a></span></dt><dt><span class="section"><a href="ch02s03.html">Creating the DLF Converter Skeleton</a></span></dt><dt><span class="section"><a href="ch02s04.html">Adding a Constructor</a></span></dt><dt><span class="section"><a href="ch02s05.html">The Meta-Data Methods</a></span></dt><dd><dl><dt><span class="section"><a href="ch02s05.html#id402633">The DLF Converter Name</a></span></dt><dt><span class="section"><a href="ch02s05.html#id402670">Providing Information To Users</a></span></dt><dt><span class="section"><a href="ch02s05.html#id402727">Providing Information to the Framework</a></span></dt><dt><span class="section"><a href="ch02s05.html#id402797">The Conversion Methods</a></span></dt></dl></dd><dt><span class="section"><a href="ch02s06.html">Registering Your DLF Converter with the <span class="application">Lire</span> Framework</a></span></dt><dt><span class="section"><a href="ch02s07.html">DLF Converter API</a></span></dt></dl></div><p>Before <span class="application">Lire</span> can do various analysis and generate reports
on the data contained in your various log files, it must first
be converted to a common data model. This is specifically the
job of the DLF converter.
</p><p>So if you want to generate the same reports for your
<span class="productname">RealServer</span>™ log files (currently
unsupported) than for you web server, you only need to develop a
DLF converter which maps the RealServer content to the
<span class="type">www</span> DLF schema.
</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>If no existing DLF schemas represent correctly the
domain of your application log file, it is easy to develop a
new one. Consult the chapter <a class="xref" href="ch03.html" title="Chapter 3. Writing a DLF Schema">Chapter 3, <i>Writing a DLF Schema</i></a> for the whole story.
</p></div><p>This chapter will show you through an example how to
develop a new DLF converter for a kind of useless log format:
the common log format encapsulated in syslog. (It is useless
because there is not many reasons to make your web server logs
it requests through syslog. And it would be probably be
simpler to just use the <span class="command"><strong>cut</strong></span> command to
remove the syslog header.)
</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>The <code class="filename">doc/examples</code> in the source
distribution contains another commented example which could
serve as a starting point for your converters.
</p></div><div class="section" title="Prerequisites"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id402415"></a>Prerequisites</h2></div></div></div><p>Developing a new DLF converter requires some basic
programming skills in perl. Altough not strictly
necessarily, you should be familiar with perl
object-oriented programming model. If you aren't, you should
read <span class="citerefentry"><span class="refentrytitle">perltoot</span>(1)</span> before continuing.
</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="pt02.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="pt02.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch02s02.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Part II. Using the <span class="application">Lire</span> Framework </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> The <span class="type">common_syslog</span> Log Format</td></tr></table></div></body></html>
|