نام (NAME)

lr_run - اجرای یک برنامه Lire و مدیریت خروجی لاگ‌گیری

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

lr_run program arguments

توضیحات (DESCRIPTION)

دستور lr_run برنامهٔ program را اجرا کرده و خروجی خطای استاندارد (stderr) آن را به logger(1) هدایت می‌کند. این دستور خروجی لاگ‌گیری program را تجزیه کرده و فلگ‌های logger(1) را بر همان اساس تنظیم می‌نماید.

دستور lr_run پیکربندی را از مسیر sysconfdir/lire/defaults دریافت می‌کند. در صورتی که 'lr_logging_method' روی 'stderr' تنظیم شده باشد، logger(1) دخالتی نخواهد داشت و خروجی لاگ‌گیری به stderr هدایت می‌شود. در صورتی که 'lr_debug' روی یک رشته خالی تنظیم شود، پیام‌های با سطح لاگ debug و info نادیده گرفته (سرکوب) می‌شوند. از متغیر پیکربندی 'lr_logging_facility' برای یافتن تسهیلات (facility) مربوط به logger(1) استفاده می‌شود.

نکات (NOTES)

خروجی program روی stderr باید در قالب زیر باشد:

superservice service id programname level message

مقدار level باید یکی از موارد زیر باشد:

emerg (سیستم غیرقابل استفاده است)، alert (اقدام فوری باید انجام شود)، crit (شرایط بحرانی)، err (شرایط خطا)، warning (شرایط هشدار)، notice (شرایط عادی، اما قابل توجه)، info (پیام اطلاع‌رسانی)، debug (پیام سطح اشکال‌زدایی). syslog(3) را ببینید.

می‌توان از id برای برچسب‌گذاری هر کار Lire استفاده کرد تا بتوان آن‌ها را پیگیری نمود. programname باید نام برنامه‌ای باشد که خط لاگ را تولید کرده است.

مثال‌ها (EXAMPLES)

برای پردازش یک لاگ Postfix و نمایش گزارش به صورت متن، استفاده کنید از:

$ lr_run lr_log2report postfix < /var/log/mail.log

برای پردازش یک لاگ Postfix و ایجاد گزارش در قالب HTML (بسته‌بندی شده در یک بایگانی tar)، استفاده کنید از:

$ lr_run lr_log2report -o html postfix < /var/log/mail.log > postfix.tar

همچنین ببینید (SEE ALSO)

مستندات موجود در راهنمای کاربر Lire

نسخه (VERSION)

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

حق نشر (COPYRIGHT)

این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «مجوز عمومی همگانی گنو» (GNU General Public License) همان‌طور که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، بازتوزیع کرده و/یا تغییر دهید؛ چه نسخه ۲ مجوز، یا (به انتخاب خودتان) هر نسخه بعدی.

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

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

تشکر و قدردانی (THANKS)

با تشکر از Rudi Sluijtman، برای به اشتراک گذاشتن ایده‌هایی در مورد اسکریپت‌نویسی شل.

نویسنده (AUTHOR)

Joost van Baal <joostvb@logreport.org>