LR_RUN.IN(1)						  LogReport's Lire Documentation					      LR_RUN.IN(1)

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

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>

Lire 2.1.1							    2006-07-23							      LR_RUN.IN(1)