lr_vendor_cron(8)

lr_vendor_cron8

Generate lire reports from all known log files on the system

Usage

lr_vendor_cron daily⎪weekly⎪monthly

Overview

lr_vendor_cron is designed to be invoked by cron. On systems supporting /etc/cron.d/, this script can be invoked by creating /etc/cron.d/lire, which should read e.g.:

 02 5 * * * root /usr/sbin/lr_vendor_cron daily
 22 5 * * 0 root /usr/sbin/lr_vendor_cron weekly
 42 5 1 * * root /usr/sbin/lr_vendor_cron monthly

lr_vendor_cron reads files /etc/sysconfig/lire.d/*.cfg and /etc/default/lire.d/*.cfg. For each log file, such a file should exist. The files should set shell variables `service' (a Lire service, e.g. sendmail), `logfile' (e.g. /var/log/mail.log.1.gz), `filter' (e.g. 'gzip -dc' or 'zcat ⎪ grep sendmail'), and `rotateperiod' (one of the supported lr_vendor_cron arguments).

It then invokes lr_log2mail(1) on the `filter'ed log file. Reading and filtering the log is done as root, lr_log2mail is run as user lire, using su(1). Output is fed to logger(1).

Security

lr_vendor_cron is supposed to be run as root. However, please note that this script is distributed WITHOUT ANY WARRANTY. If you don't like to run such a script as root, make sure your lire user has read access to all log files you'd like to get processed, and adapt this script. We supply this script mainly for people building packages. On many Unix and GNU/Linux distributions, it's hard to enforce log file readability by the lire user. This script is mainly a way to work around this.

Environment

lr_vendor_cron honours DEBUG, CONFDIR, PRIORITY (for logger(1) call), and LIREUSER. Beware! PRIORITY as used here is independent of the LR_FACILITY as set in /etc/lire/defaults. This script does not use any of the settings in /etc/lire/defaults.

Version

$Id: lr_vendor_cron,v 1.4 2004/10/13 16:20:58 wsourdeau Exp $

Authors

Francis J. Lacoste <[email protected]>, Joost van Baal <[email protected]>

From lire 2:2.0.1-4 in Debian 3.1 (Sarge). Parsed by carta from the page's man source.