.\" -*- 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_RUN.IN 1"
.TH LR_RUN.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_run \- اجرای یک برنامه Lire و مدیریت خروجی لاگ‌گیری
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fBlr_run\fR \fIprogram\fR \fIarguments\fR
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
دستور
\&\fBlr_run\fR
برنامهٔ
\&\fIprogram\fR
را اجرا کرده و خروجی خطای استاندارد (stderr) آن را به
\&\fBlogger\fR\|(1)
هدایت می‌کند. این دستور خروجی لاگ‌گیری
\&\fIprogram\fR
را تجزیه کرده و فلگ‌های
\&\fBlogger\fR\|(1)
را بر همان اساس تنظیم می‌نماید.
.PP
دستور
\&\fBlr_run\fR
پیکربندی را از مسیر
\&\fIsysconfdir\fR/lire/defaults
دریافت می‌کند. در صورتی که
\&\*(Aqlr_logging_method\*(Aq
روی
\&\*(Aqstderr\*(Aq
تنظیم شده باشد،
\&\fBlogger\fR\|(1)
دخالتی نخواهد داشت و خروجی لاگ‌گیری به stderr هدایت می‌شود. در صورتی که
\&\*(Aqlr_debug\*(Aq
روی یک رشته خالی تنظیم شود، پیام‌های با سطح لاگ debug و info نادیده گرفته (سرکوب) می‌شوند. از متغیر پیکربندی
\&\*(Aqlr_logging_facility\*(Aq
برای یافتن تسهیلات (facility) مربوط به
\&\fBlogger\fR\|(1)
استفاده می‌شود.
.SH "نکات (NOTES)"
.IX Header "NOTES"
خروجی
\&\fIprogram\fR
روی stderr باید در قالب زیر باشد:
.PP
\&\fIsuperservice\fR \fIservice\fR \fIid\fR \fIprogramname\fR \fIlevel\fR \fImessage\fR
.PP
مقدار
\&\fIlevel\fR
باید یکی از موارد زیر باشد:
.PP
\&\fBemerg\fR (سیستم غیرقابل استفاده است)،
\&\fBalert\fR (اقدام فوری باید انجام شود)،
\&\fBcrit\fR (شرایط بحرانی)،
\&\fBerr\fR (شرایط خطا)،
\&\fBwarning\fR (شرایط هشدار)،
\&\fBnotice\fR (شرایط عادی، اما قابل توجه)،
\&\fBinfo\fR (پیام اطلاع‌رسانی)،
\&\fBdebug\fR (پیام سطح اشکال‌زدایی).
\&\fBsyslog\fR\|(3)
را ببینید.
.PP
می‌توان از
\&\fIid\fR
برای برچسب‌گذاری هر کار Lire استفاده کرد تا بتوان آن‌ها را پیگیری نمود.
\&\fIprogramname\fR
باید نام برنامه‌ای باشد که خط لاگ را تولید کرده است.
.SH "مثال‌ها (EXAMPLES)"
.IX Header "EXAMPLES"
برای پردازش یک لاگ Postfix و نمایش گزارش به صورت متن، استفاده کنید از:
.PP
.Vb 1
\& $ lr_run lr_log2report postfix < /var/log/mail.log
.Ve
.PP
برای پردازش یک لاگ Postfix و ایجاد گزارش در قالب HTML (بسته‌بندی شده در یک بایگانی tar)، استفاده کنید از:
.PP
.Vb 1
\& $ lr_run lr_log2report \-o html postfix < /var/log/mail.log > postfix.tar
.Ve
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
مستندات موجود در راهنمای کاربر Lire
.SH "نسخه (VERSION)"
.IX Header "VERSION"
\&\f(CW$Id:\fR lr_run.in,v 1.23 2006/07/23 13:16:33 vanbaal Exp $
.SH "حق نشر (COPYRIGHT)"
.IX Header "COPYRIGHT"
حق نشر \(co 2000\-2003 متعلق به بنیاد Stichting LogReport است: LogReport@LogReport.org
.PP
این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «مجوز عمومی همگانی گنو» (GNU General Public License) همان‌طور که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، بازتوزیع کرده و/یا تغییر دهید؛ چه نسخه ۲ مجوز، یا (به انتخاب خودتان) هر نسخه بعدی.
.PP
این برنامه با این امید توزیع شده است که مفید واقع شود، اما بدون هیچ‌گونه ضمانتی؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به «مجوز عمومی همگانی گنو» مراجعه کنید.
.PP
شما باید همراه با این برنامه یک نسخه از «مجوز عمومی همگانی گنو» را دریافت کرده باشید (پرونده COPYING را ببینید)؛ در غیر این صورت به نشانی زیر مراجعه کنید:
http://www.gnu.org/copyleft/gpl.html
.SH "تشکر و قدردانی (THANKS)"
.IX Header "THANKS"
با تشکر از Rudi Sluijtman، برای به اشتراک گذاشتن ایده‌هایی در مورد اسکریپت‌نویسی شل.
.SH "نویسنده (AUTHOR)"
.IX Header "AUTHOR"
Joost van Baal <joostvb@logreport.org>