Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

lr_vendor_cron(1) [debian man page]

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

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 the following shell variables:

       daemon
	   the name of a binary which generated the specific log.  This is used to test wether the *.cfg-file is suitable for the current system.
	   If you'd like to generate a log for which no daemon is present on the current system, just use a placeholder like "daemon=/bin/true".

       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.

       extraopts
	   optional: extra options passed to lr_log2mail(1).  Set this to e.g. '--template www_local'.

       After parsing the configuration files, lr_vendor_cron 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.in,v 1.14 2006/07/23 13:16:33 vanbaal Exp $

COPYRIGHT

       Copyright (C) 2002, 2003 Stichting LogReport Foundation LogReport@LogReport.org Copyright (C) 2005 Joost van Baal

       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.

AUTHORS

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

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

Check Out this Related Man Page

ReportJob(3pm)						  LogReport's Lire Documentation					    ReportJob(3pm)

NAME

       Lire::ReportJob - Object used to configure periodical report generation

SYNOPSIS

	 use Lire::ReportJob;
	 use Lire::ReportSchedule;

	 my $store = Lire::DlfStore->open( 'aStore' );
	 my $job = new Lire::ReportJob( "webServer" );
	 my $cfg = $store->get_report_config( 'my_report' );
	 $job->add_schedule( new Lire::ReportSchedule( 'daily', $cfg );
	 $job->run( $store, 'daily' );

DESCRIPTION

       The Lire::ReportJob object is used to configure and execute report generation jobs. These objects are usually configured in a store through
       the lire(1) command.

   new( $name, );
       Create a new Lire::ReportJob(). The constructor takes one parameter which is an identifier.

   name()
       Returns the name of this ReportJob.

   add_schedule( $schedule, ... )
       Adds one or more Lire::ReportSchedule to the ReportJob objects.

   schedules()
       Returns the Lire::ReportSchedule related to this object.

   run( $store, $period, [$time]  )
       Executes all the configured generation with a period of 'period' using the $store DlfStore. Once the method returns, XML report will have
       been generated in the DlfStore and OutputJob associated with the ScheduleJob will have been sent. The $time parameter will be used to
       determine the time window covered by period. It defaults to the current time.

SEE ALSO

       Lire::DlfStore(3pm) Lire::ImportJob(3pm) Lire::ReportSchedule(3pm) lire(1) Lire::OutputJob(3pm)

AUTHOR

	 Francis J. Lacoste <flacoste@logreport.org>

VERSION

       $Id: ReportJob.pm,v 1.9 2006/07/23 13:16:29 vanbaal Exp $

COPYRIGHT

       Copyright (C) 2004 Stichting LogReport Foundation LogReport@LogReport.org

       This file 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.

Lire 2.1.1							    2006-07-23							    ReportJob(3pm)
Man Page