Provided by: lire_2.0.1-4_all bug

NAME

       lr_vendor_cron - generate Lire reports from all known log files on the
       system

SYNOPSIS

       lr_vendor_cron dailyâ”│weeklyâ”│monthly

DESCRIPTION

       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 VARIABLES

       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 $

COPYRIGHT

       Copyright (C) 2002, 2003 Stichting LogReport Foundation
       LogReport@LogReport.org

       This program is part of Lire.

       Lire 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 or write to the Free Software
       Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111, USA.

AUTHORS

       Francis J. Lacoste <flacoste@logreport.org>, Joost van Baal
       <joostvb@logreport.org>