.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "LIRE 7" .TH LIRE 7 "2020-07-07" "Lire 2.1.1" "LogReport's Lire Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" Lire \- generate reports from various log files .SH "INTRODUCTION" .IX Header "INTRODUCTION" Lire allows one to generate reports from various log files. .PP In this manpage, we give an overview of the Lire documentation. .SS "Documentation on installing Lire" .IX Subsection "Documentation on installing Lire" For installation instructions, read the file \fB\s-1INSTALL\s0\fR. This file is shipped with the Lire tarball, lire\-\fIversion\fR.tar.gz. It is available from the World Wide Web at http://logreport.org/pub/current/INSTALL. .SS "Documentation for users" .IX Subsection "Documentation for users" Read the Lire \fB\s-1README\s0\fR file for a quick start on Lire's usage. This file is shipped with the Lire tarball. If you've installed Lire from a package for your Operating System, it might be installed in a location like /usr/share/doc/lire/README . .PP Read the \fBLire User's Manual\fR for a more in-depth overview. This manual is available in various formats, and installed in /usr/[local/]share/doc/lire/user\-manual* . It is available online, at http://logreport.org/pub/current/doc/user\-manual/ . .PP The main Lire commands (\fBlire\fR\|(1), \fBlr_cron\fR\|(1), \fBlr_log2mail\fR\|(1), \fBlr_log2report\fR\|(1), \&\fBlr_xml2report\fR\|(1), ...) should be in your \s-1PATH.\s0 The usage of these commands is documented in man pages; running e.g. .PP .Vb 1 \& man lr_log2report .Ve .PP should show you the lr_log2report manpage. .SS "Documentation for developers" .IX Subsection "Documentation for developers" If you plan to change the Lire internals, or if you are trying to fix a bug, you should consult the \fBLire Developer's Manual\fR. This document is available in various formats, and installed in /usr/[local/]share/doc/lire/dev\-manual* . .PP A lot of \fBLire Perl modules\fR get installed in the Lire:: namespace in the Perl module hierarchy. Likely, this is something like /usr/[local/]share/perl5/Lire/. Most of these come with their own man page. If you plan to write customized Lire extensions, you should read these manpages. .PP \&\fBLire convertors\fR, which take care of log file specific processing, are installed as Perl modules, named something like \fIFoo\fRDlfConvertor.pm, and come with their own man page. (Some old-style convertors come with their own script, in /usr/[local/]libexec/lire/convertors/\fIfoo\fR2dlf). If you're looking for information, specifically for your log file type, you should look here. .PP If you plan to cooperate with the LogReport team, you might want to take a look at the \fB\s-1BUGS\s0\fR file, as distributed with the Lire tarball, too. .PP The file \fB\s-1COPYING\s0\fR documents terms and conditions for copying, distribution and modification of Lire. Some extra explanation about this is given in \&\fBFrequently Asked Question About Lire\fR, online at http://logreport.org/lire/faq.php . .SS "Other sources of information" .IX Subsection "Other sources of information" Some documentation on Lire and LogReport is not distributed with the Lire tarball. Documentation is available from \fBthe LogReport website\fR on http://www.logreport.org/ . It offers mailing list archives on http://www.logreport.org/contact/lists/ . .PP You can get in touch with other Lire users on the Lire mailing lists, see http://logreport.org/contact/lists/ . The LogReport team can be contacted directly too (email, irc, snailmail), see http://logreport.org/contact/ for details. .SH "VERSION" .IX Header "VERSION" This manpage: \f(CW$Id:\fR lire.pod,v 1.5 2006/07/23 13:16:32 vanbaal Exp $ .SH "COPYRIGHT" .IX Header "COPYRIGHT" Copyright (C) 2002, 2003, 2004 Stichting LogReport Foundation LogReport@LogReport.org .PP This manpage is part of Lire. .PP Lire is free software; you can redistribute it and/or modify it under the terms of the \s-1GNU\s0 General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. .PP This program is distributed in the hope that it will be useful, but \s-1WITHOUT ANY WARRANTY\s0; without even the implied warranty of \&\s-1MERCHANTABILITY\s0 or \s-1FITNESS FOR A PARTICULAR PURPOSE.\s0 See the \&\s-1GNU\s0 General Public License for more details. .PP You should have received a copy of the \s-1GNU\s0 General Public License along with this program (see \s-1COPYING\s0); if not, check with http://www.gnu.org/copyleft/gpl.html. .SH "AUTHOR" .IX Header "AUTHOR" Joost van Baal