lr_log2report(1)

lr_log2report1

Generates a report from a log file

Usage

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.

Overview

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

Version

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

Releases

7 releases since Debian 3.0 (Woody); the text changed 6 times.

  1. 3.0
  2. 3.1
  3. 4.0
  4. 5.0
  5. 6.0
  6. 7
  7. Arch

--help since Debian 3.1 (Sarge); --version since Debian 3.1 (Sarge).

-i until Debian 3.0 (Woody).

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

From lire 2.1.1-8 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.