---
name: "lr_run"
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_run"
---

# lr\_run(1)

run a Lire program and deal with the logging output

## NAME

lr\_run - run a Lire program and deal with the logging output

## SYNOPSIS

**lr\_run** *program* *arguments*

## DESCRIPTION

**lr\_run** runs *program*, and redirects *program*'s stderr output to [**logger**(1)](/logger/1.md). It parses *programs* logging output, and sets [**logger**(1)](/logger/1.md)'s  flags accordingly.

**lr\_run** gets configuration from *sysconfdir*/lire/defaults. In case 'lr\_logging\_method' is set to 'stderr', [**logger**(1)](/logger/1.md) is not involved: logging output gets redirected to stderr. In case 'lr\_debug' is set to the empty string, messages with loglevel debug and info get suppressed. The configuration variable 'lr\_logging\_facility' is used to find [**logger**(1)](/logger/1.md)'s facility.

## NOTES

*program*'s output on stderr should be in format *superservice* *service* *id* *programname* *level* *message*. *level* should be one of:  emerg (system is unusable), alert (action must be taken immediately), crit  (critical conditions), err (error conditions), warning (warning conditions), notice (normal, but significant, condition), info (informational message), debug (debug-level message). See [**syslog**(3)](/syslog/3.md).

*id* can be used to tag each Lire job, so that these can get tracked.  *programname* should be the name of the program which generated the log line.

## EXAMPLES

To process a Postfix log and display the report as text, use

```
 $ lr_run lr_log2report postfix < /var/log/mail.log
```

To process a Postfix log and create the report in HTML (packed up in a tar archive), use:

```
 $ lr_run lr_log2report -o html postfix < /var/log/mail.log > postfix.tar
```

## SEE ALSO

Documentation in the Lire User Manual

## VERSION

`$Id:` lr\_run.in,v 1.23 2006/07/23 13:16:33 vanbaal Exp $

## COPYRIGHT

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

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

## THANKS

Rudi Sluijtman, for sharing some thoughts on shell scripting.

## AUTHOR

Joost van Baal \<joostvb@logreport.org\>