SYNOPSIS
lr_log2report [options] dlf_converter [ logfile ] [ output_file ]lr_log2report --version
lr_log2report --help [dlf-converters|output-formats|report-templates]
OPTIONS
- --help [section]
-
If no argument is given, prints usage information and exits. Argument
can be one of the following:
-
- dlf-converters
- Prints the list of available DLF converters and exits.
- output-formats
- Prints the list of available output formats and exits.
- report-templates
- Prints the list of available report templates and exits.
-
- --version
- Prints Lire's version and exits.
- --output-format|-o output format
- Selects the ouput format in which to generate the report.
- --template|-t name
- Uses the report configuration named name to generate the report.
DESCRIPTION
lr_log2report reads a log file from STDIN or the specified argument and will output a formatted Lire report on STDOUT or in the output_file argument. The format of the log file is specified using the dlf_converter argument. Use the --help dlf-converters option to get a list of all currently available DLF converters.In case the log is passed in a compressed format, it's uncompressed on the fly, using gzip(1).
WARNING: This command outputs binary data on the terminal for all output formats except txt and xml. You should redirect stdout to a file when using those output formats.
In the case where output format is html, the output_file argument will be interpreted as a directory name. This directory will get created if needed, and will hold the various html files. In case this argument is omitted, a tar(1) file should be output on STDOUT (but see the BUGS section).
WARNING: Running this command on big logfiles generally means you'll need lots of free diskspace. See Lire::LrCommand(3pm) for details.
EXAMPLES
To process a Postfix log and display the report as text, use
$ lr_log2report postfix /var/log/mail.log
To process a Postfix log and create an HTML report in a directory, use
$ lr_log2report -o html postfix /var/log/mail.log postfix-report
BUGS
If
--output html
is specified, both logfile and output_file need to be specified. Specifying "-" (or "/dev/stdin") as logfile is supported. So this
$ tai64nfrac < /var/log/qmail-send/current | \ lr_log2report qmail --output html - /tmp/report
will work.
AUTHORS
Joost van Baal <[email protected]> Francis J. Lacoste <[email protected]>
VERSION
$Id: lr_log2report.in,v 1.100 2006/10/04 10:19:17 vanbaal Exp $COPYRIGHT
Copyright (C) 2000-2004 Stichting LogReport Foundation [email protected]This program is part of Lire.
Lire is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program (see COPYING); if not, check with http://www.gnu.org/copyleft/gpl.html.