lr_run(1)

lr_run1

Run a lire program and deal with the logging output

Usage

lr_run program arguments

Overview

lr_run runs program, and redirects program's stderr output to logger(1). It parses programs logging output, and sets logger(1)'s flags accordingly.

lr_run gets configuration from sysconfdir/lire/defaults. In case 'lr_logging_method' is set to 'stderr', logger(1) 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)'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).

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

Version

$Id: lr_run.in,v 1.23 2006/07/23 13:16:33 vanbaal Exp $

Thanks

Rudi Sluijtman, for sharing some thoughts on shell scripting.

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

Author

Joost van Baal <[email protected]>

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