lr_log2report(1) generates a report from a log file


lr_log2report [options] dlf_converter [ logfile ] [ output_file ]

lr_log2report --version

lr_log2report --help [dlf-converters|output-formats|report-templates]


--help [section]
If no argument is given, prints usage information and exits. Argument can be one of the following:
Prints the list of available DLF converters and exits.
Prints the list of available output formats and exits.
Prints the list of available report templates and exits.
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.


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.


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



 --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.


  Joost van Baal <[email protected]>
  Francis J. Lacoste <[email protected]>


$Id:,v 1.100 2006/10/04 10:19:17 vanbaal Exp $


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