---
name: "lr_log2report"
section: "1"
platform: "linux"
package: "lire"
version: "2.1.1-8"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/lr_log2report"
---

# lr\_log2report(1)

generates a report from a log file

## NAME

lr\_log2report - generates a report from a log file

## 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)](/gzip/1.md).

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)](/tar/1.md) 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)](/Lire::LrCommand/3pm.md) 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.

## SEE ALSO

[**lr\_log2mail**(1)](/lr_log2mail/1.md), [**lr\_xml2report**(1)](/lr_xml2report/1.md), [**lr\_xml2mail**(1)](/lr_xml2mail/1.md), [**lire**(1)](/lire/1.md), [**lire**(7)](/lire/7.md), [**Lire::LrCommand**(3pm)](/Lire::LrCommand/3pm.md), documentation in the Lire User Manual

## AUTHORS

```
  Joost van Baal <joostvb@logreport.org>
  Francis J. Lacoste <flacoste@logreport.org>
```

## VERSION

`$Id:` lr\_log2report.in,v 1.100 2006/10/04 10:19:17 vanbaal Exp $

## COPYRIGHT

Copyright (C) 2000-2004 Stichting LogReport Foundation LogReport@LogReport.org

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.