.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40)
.\"
.\" 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
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    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
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "LR_VENDOR_CRON.IN 1"
.TH LR_VENDOR_CRON.IN 1 "2020-07-07" "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'd like to generate a log for which no daemon is present on
the current system, just use a placeholder like \*(L"daemon=/bin/true\*(R".
.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. 'gzip \-dc' or 'zcat | grep sendmail', 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. '\-\-template
www_local'.
.PP
After parsing the configuration files, \fBlr_vendor_cron\fR invokes \fBlr_log2mail\fR\|(1)
on the `filter'ed 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 \s-1WITHOUT ANY WARRANTY.\s0  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.
.SH "ENVIRONMENT VARIABLES"
.IX Header "ENVIRONMENT VARIABLES"
\&\fBlr_vendor_cron\fR honours \s-1DEBUG, CONFDIR, PRIORITY\s0 (for \fBlogger\fR\|(1) call), and
\&\s-1LIREUSER.\s0  Beware!  \s-1PRIORITY\s0 as used here is independent of the \s-1LR_FACILITY\s0 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 \s-1GNU\s0 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 \s-1WITHOUT ANY WARRANTY\s0; without even the implied warranty of
\&\s-1MERCHANTABILITY\s0 or \s-1FITNESS FOR A PARTICULAR PURPOSE.\s0  See the
\&\s-1GNU\s0 General Public License for more details.
.PP
You should have received a copy of the \s-1GNU\s0 General Public License
along with this program (see \s-1COPYING\s0); if not, check with
http://www.gnu.org/copyleft/gpl.html.
.SH "AUTHORS"
.IX Header "AUTHORS"
Francis J. Lacoste <flacoste@logreport.org>, Joost van Baal
<joostvb@logreport.org>