نام (NAME)

lr_vendor_cron - تولید گزارش‌های Lire از تمام فایل‌های لاگ شناخته‌شده در سیستم

خلاصه دستور (SYNOPSIS)

lr_vendor_cron daily|weekly|monthly

توضیحات (DESCRIPTION)

اسکریپت lr_vendor_cron برای فراخوانی از طریق cron طراحی شده است. در سیستم‌هایی که از /etc/cron.d/ پشتیبانی می‌کنند، می‌توان این اسکریپت را با ایجاد فایل /etc/cron.d/lire فراخوانی کرد که باید مثلاً شامل خطوط زیر باشد:

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 فایل‌های /etc/sysconfig/lire.d/*.cfg و /etc/default/lire.d/*.cfg را می‌خواند. برای هر فایل لاگ، باید چنین فایلی وجود داشته باشد. این فایل‌ها باید متغیرهای شل زیر را مقداردهی کنند:

daemon: نام باینری یا برنامه‌ای که فایل لاگ مشخصی را تولید کرده است. از این متغیر برای بررسی مناسب بودن فایل *.cfg برای سیستم فعلی استفاده می‌شود. اگر می‌خواهید برای سرویسی که دیمون آن در سیستم فعلی موجود نیست لاگ تولید کنید، کافی است از یک مقدار جانشین مانند "daemon=/bin/true" استفاده کنید.
service: یک سرویس در Lire، مانند sendmail.
logfile: مسیر فایل لاگ، مانند /var/log/mail.log.1.gz.
filter: دستور فیلتر، مانند 'gzip -dc' یا 'zcat | grep sendmail'.
rotateperiod: یکی از دوره‌های چرخش لاگ و آرگومان‌های پشتیبانی‌شده توسط lr_vendor_cron (شامل daily، weekly یا monthly).
extraopts: اختیاری: گزینه‌های اضافی ارسال‌شده به lr_log2mail(1). این مقدار را مثلاً به '--template www_local' تنظیم کنید.

پس از تجزیه فایل‌های پیکربندی، lr_vendor_cron دستور lr_log2mail(1) را روی فایل لاگ فیلترشده فراخوانی می‌کند. خواندن و فیلتر کردن لاگ با دسترسی root انجام می‌شود، و lr_log2mail به عنوان کاربر lire و با استفاده از دستور su(1) اجرا می‌گردد. خروجی حاصل نیز به logger(1) هدایت می‌شود.

امنیت (SECURITY)

دستور lr_vendor_cron برای اجرا با دسترسی کاربر ریشه (root) در نظر گرفته شده است. با این حال، توجه داشته باشید که این اسکریپت بدون هیچ‌گونه ضمانتی توزیع می‌شود. اگر ترجیح می‌دهید چنین اسکریپتی را با دسترسی root اجرا نکنید، مطمئن شوید که کاربر lire به تمام فایل‌های لاگی که مایل به پردازش آن‌ها هستید دسترسی خواندن دارد و سپس اسکریپت را متناسب با آن تغییر دهید. این اسکریپت عمدتاً برای سازندگان بسته‌های نرم‌افزاری ارائه شده است. در بسیاری از توزیع‌های یونیکس و گنو/لینوکس، تضمین دسترسی خواندن فایل‌های لاگ برای کاربر lire دشوار است و این اسکریپت در اصل راهکاری برای برطرف کردن این چالش است.

متغیرهای محیطی (ENVIRONMENT VARIABLES)

دستور lr_vendor_cron متغیرهای محیطی DEBUG ،CONFDIR ،PRIORITY (برای فراخوانی logger(1)) و LIREUSER را در نظر می‌گیرد. توجه داشته باشید که مقدار PRIORITY در اینجا مستقل از LR_FACILITY تعریف‌شده در /etc/lire/defaults است. این اسکریپت از هیچ‌یک از تنظیمات موجود در /etc/lire/defaults استفاده نمی‌کند.

نسخه (VERSION)

$Id: lr_vendor_cron.in,v 1.14 2006/07/23 13:16:33 vanbaal Exp $

حق نشر (COPYRIGHT)

این برنامه بخشی از Lire است.

نرم‌افزار Lire یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «پروانه عمومی همگانی گنو» (GPL) که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، چه نسخهٔ ۲ پروانه و چه (به انتخاب خودتان) هر نسخهٔ پس از آن، بازتوزیع کرده یا تغییر دهید.

این برنامه با این امید توزیع شده است که مفید واقع شود، اما بدون هیچ‌گونه ضمانتی؛ حتی بدون ضمانت ضمنی قابلیت فروش یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر «پروانه عمومی همگانی گنو» را ببینید.

شما باید همراه با این برنامه نسخه‌ای از «پروانه عمومی همگانی گنو» را دریافت کرده باشید (فایل COPYING را ببینید)؛ در غیر این صورت به http://www.gnu.org/copyleft/gpl.html مراجعه کنید.

نویسندگان (AUTHORS)

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