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>