.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Required to disable full justification in groff 1.23.0. .if n .ds AD l .\" ======================================================================== .\" .IX Title "LR_VENDOR_CRON.IN 1" .TH LR_VENDOR_CRON.IN 1 2025-09-28 "Lire 2.1.1" "LogReport's Lire Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH NAME lr_vendor_cron \- generate Lire reports from all known log files on the system .SH SYNOPSIS .IX Header "SYNOPSIS" \&\fBlr_vendor_cron\fR \fIdaily\fR\fB|\fR\fIweekly\fR\fB|\fR\fImonthly\fR .SH DESCRIPTION .IX Header "DESCRIPTION" \&\fBlr_vendor_cron\fR 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.: .PP .Vb 3 \& 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 .Ve .PP \&\fBlr_vendor_cron\fR 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: .IP daemon 4 .IX Item "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\*(Aqd like to generate a log for which no daemon is present on the current system, just use a placeholder like "daemon=/bin/true". .IP service 4 .IX Item "service" a Lire service, e.g. sendmail, .IP logfile 4 .IX Item "logfile" e.g. /var/log/mail.log.1.gz, .IP filter 4 .IX Item "filter" e.g. \*(Aqgzip \-dc\*(Aq or \*(Aqzcat | grep sendmail\*(Aq, and .IP rotateperiod 4 .IX Item "rotateperiod" one of the supported lr_vendor_cron arguments. .IP extraopts 4 .IX Item "extraopts" optional: extra options passed to \fBlr_log2mail\fR\|(1). Set this to e.g. \*(Aq\-\-template www_local\*(Aq. .PP After parsing the configuration files, \fBlr_vendor_cron\fR invokes \fBlr_log2mail\fR\|(1) on the \`filter\*(Aqed log file. Reading and filtering the log is done as root, lr_log2mail is run as user lire, using \fBsu\fR\|(1). Output is fed to \fBlogger\fR\|(1). .SH SECURITY .IX Header "SECURITY" \&\fBlr_vendor_cron\fR is supposed to be run as root. However, please note that this script is distributed WITHOUT ANY WARRANTY. If you don\*(Aqt like to run such a script as root, make sure your lire user has read access to all log files you\*(Aqd 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\*(Aqs hard to enforce log file readability by the lire user. This script is mainly a way to work around this. .SH "ENVIRONMENT VARIABLES" .IX Header "ENVIRONMENT VARIABLES" \&\fBlr_vendor_cron\fR honours DEBUG, CONFDIR, PRIORITY (for \fBlogger\fR\|(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. .SH VERSION .IX Header "VERSION" \&\f(CW$Id:\fR lr_vendor_cron.in,v 1.14 2006/07/23 13:16:33 vanbaal Exp $ .SH COPYRIGHT .IX Header "COPYRIGHT" Copyright (C) 2002, 2003 Stichting LogReport Foundation LogReport@LogReport.org Copyright (C) 2005 Joost van Baal .PP This program is part of Lire. .PP 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. .PP 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. .PP 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. .SH AUTHORS .IX Header "AUTHORS" Francis J. Lacoste , Joost van Baal