.\" -*- 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 \- تولید گزارش‌های Lire از تمام فایل‌های لاگ شناخته‌شده در سیستم
.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
برای فراخوانی از طریق cron طراحی شده است. در سیستم‌هایی که از
/etc/cron.d/
پشتیبانی می‌کنند، می‌توان این اسکریپت را با ایجاد فایل
/etc/cron.d/lire
فراخوانی کرد که باید مثلاً شامل خطوط زیر باشد:
.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
فایل‌های
/etc/sysconfig/lire.d/*.cfg
و
/etc/default/lire.d/*.cfg
را می‌خواند. برای هر فایل لاگ، باید چنین فایلی وجود داشته باشد. این فایل‌ها باید متغیرهای شل زیر را مقداردهی کنند:
.IP daemon 4
.IX Item "daemon"
نام باینری یا برنامه‌ای که فایل لاگ مشخصی را تولید کرده است. از این متغیر برای بررسی مناسب بودن فایل *.cfg برای سیستم فعلی استفاده می‌شود. اگر می‌خواهید برای سرویسی که دیمون آن در سیستم فعلی موجود نیست لاگ تولید کنید، کافی است از یک مقدار جانشین مانند "daemon=/bin/true" استفاده کنید.
.IP service 4
.IX Item "service"
یک سرویس در Lire، مانند sendmail.
.IP logfile 4
.IX Item "logfile"
مسیر فایل لاگ، مانند /var/log/mail.log.1.gz.
.IP filter 4
.IX Item "filter"
دستور فیلتر، مانند 'gzip \-dc' یا 'zcat | grep sendmail'.
.IP rotateperiod 4
.IX Item "rotateperiod"
یکی از دوره‌های چرخش لاگ و آرگومان‌های پشتیبانی‌شده توسط lr_vendor_cron (شامل daily، weekly یا monthly).
.IP extraopts 4
.IX Item "extraopts"
اختیاری: گزینه‌های اضافی ارسال‌شده به
\fBlr_log2mail\fR\|(1).
این مقدار را مثلاً به '\-\-template www_local' تنظیم کنید.
.PP
پس از تجزیه فایل‌های پیکربندی،
\&\fBlr_vendor_cron\fR
دستور
\fBlr_log2mail\fR\|(1)
را روی فایل لاگ فیلترشده فراخوانی می‌کند. خواندن و فیلتر کردن لاگ با دسترسی root انجام می‌شود، و
lr_log2mail
به عنوان کاربر lire و با استفاده از دستور
\fBsu\fR\|(1)
اجرا می‌گردد. خروجی حاصل نیز به
\fBlogger\fR\|(1)
هدایت می‌شود.
.SH "امنیت (SECURITY)"
.IX Header "SECURITY"
دستور
\&\fBlr_vendor_cron\fR
برای اجرا با دسترسی کاربر ریشه (root) در نظر گرفته شده است. با این حال، توجه داشته باشید که این اسکریپت بدون هیچ‌گونه ضمانتی توزیع می‌شود. اگر ترجیح می‌دهید چنین اسکریپتی را با دسترسی root اجرا نکنید، مطمئن شوید که کاربر lire به تمام فایل‌های لاگی که مایل به پردازش آن‌ها هستید دسترسی خواندن دارد و سپس اسکریپت را متناسب با آن تغییر دهید. این اسکریپت عمدتاً برای سازندگان بسته‌های نرم‌افزاری ارائه شده است. در بسیاری از توزیع‌های یونیکس و گنو/لینوکس، تضمین دسترسی خواندن فایل‌های لاگ برای کاربر lire دشوار است و این اسکریپت در اصل راهکاری برای برطرف کردن این چالش است.
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.IX Header "ENVIRONMENT VARIABLES"
دستور
\&\fBlr_vendor_cron\fR
متغیرهای محیطی DEBUG ،CONFDIR ،PRIORITY (برای فراخوانی
\fBlogger\fR\|(1))
و LIREUSER را در نظر می‌گیرد. توجه داشته باشید که مقدار PRIORITY در اینجا مستقل از LR_FACILITY تعریف‌شده در
/etc/lire/defaults
است. این اسکریپت از هیچ‌یک از تنظیمات موجود در
/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"
حق نشر \(co ۲۰۰۲، ۲۰۰۳ بنیاد Stichting LogReport به نشانی LogReport@LogReport.org
.PP
حق نشر \(co ۲۰۰۵ Joost van Baal
.PP
این برنامه بخشی از Lire است.
.PP
نرم‌افزار Lire یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «پروانه عمومی همگانی گنو» (GPL) که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، چه نسخهٔ ۲ پروانه و چه (به انتخاب خودتان) هر نسخهٔ پس از آن، بازتوزیع کرده یا تغییر دهید.
.PP
این برنامه با این امید توزیع شده است که مفید واقع شود، اما بدون هیچ‌گونه ضمانتی؛ حتی بدون ضمانت ضمنی قابلیت فروش یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر «پروانه عمومی همگانی گنو» را ببینید.
.PP
شما باید همراه با این برنامه نسخه‌ای از «پروانه عمومی همگانی گنو» را دریافت کرده باشید (فایل COPYING را ببینید)؛ در غیر این صورت به
<http://www.gnu.org/copyleft/gpl.html>
مراجعه کنید.
.SH "نویسندگان (AUTHORS)"
.IX Header "AUTHORS"
Francis J. Lacoste <flacoste@logreport.org>, Joost van Baal
<joostvb@logreport.org>