.\" -*- 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_LOG2REPORT.IN 1" .TH LR_LOG2REPORT.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_log2report \- تولید گزارش از یک فایل لاگ .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" \&\fBlr_log2report\fR \fB[\fR\fIoptions\fR\fB]\fR \fIdlf_converter\fR \fB[\fR \fIlogfile\fR \fB]\fR \fB[\fR \fIoutput_file\fR \fB]\fR .PP \&\fBlr_log2report\fR \fB\-\-version\fR .PP \&\fBlr_log2report\fR \fB\-\-help\fR \fB[dlf\-converters|output\-formats|report\-templates]\fR .SH "گزینه‌ها (OPTIONS)" .IX Header "OPTIONS" .IP "\fB\-\-help\fR \fB[\fR\fIsection\fR\fB]\fR" 4 .IX Item "--help [section]" اگر هیچ آرگومانی داده نشود، اطلاعات نحوهٔ استفاده را چاپ کرده و خارج می‌شود. آرگومان می‌تواند یکی از موارد زیر باشد: .RS 4 .IP dlf\-converters 4 .IX Item "dlf-converters" فهرست مبدل‌های DLF موجود را چاپ کرده و خارج می‌شود. .IP output\-formats 4 .IX Item "output-formats" فهرست قالب‌های خروجی موجود را چاپ کرده و خارج می‌شود. .IP report\-templates 4 .IX Item "report-templates" فهرست الگوهای گزارش موجود را چاپ کرده و خارج می‌شود. .RE .RS 4 .RE .IP \fB\-\-version\fR 4 .IX Item "--version" نسخهٔ Lire را چاپ کرده و خارج می‌شود. .IP "\fB\-\-output\-format|\-o\fR \fIoutput format\fR" 4 .IX Item "--output-format|-o output format" قالب خروجی مورد نظر برای تولید گزارش را انتخاب می‌کند. .IP "\fB\-\-template|\-t\fR \fIname\fR" 4 .IX Item "--template|-t name" از پیکربندی گزارشی با نام \fIname\fR برای تولید گزارش استفاده می‌کند. .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" دستور \&\fBlr_log2report\fR یک فایل لاگ را از STDIN یا آرگومان مشخص‌شده خوانده و گزارش قالب‌بندی‌شدهٔ Lire را در STDOUT یا در آرگومان \fIoutput_file\fR خروجی می‌دهد. قالب فایل لاگ با استفاده از آرگومان \fIdlf_converter\fR تعیین می‌شود. برای دریافت فهرستی از تمام مبدل‌های DLF موجود، از گزینهٔ \fB\-\-help dlf\-converters\fR استفاده کنید. .PP در صورتی که فایل لاگ در یک قالب فشرده ارسال شود، با استفاده از \fBgzip\fR\|(1) به‌صورت درجا (on the fly) از حالت فشرده خارج می‌شود. .PP هشدار: این دستور برای تمام قالب‌های خروجی به جز \fBtxt\fR و \fBxml\fR، داده‌های باینری را در ترمینال چاپ می‌کند. هنگام استفاده از آن قالب‌های خروجی، باید stdout را به یک فایل تغییر مسیر (redirect) دهید. .PP در حالتی که \fIoutput format\fR برابر با \fBhtml\fR باشد، آرگومان \fIoutput_file\fR به عنوان نام یک دایرکتوری در نظر گرفته خواهد شد. این دایرکتوری در صورت نیاز ایجاد می‌شود و فایل‌های گوناگون html را در بر می‌گیرد. در صورتی که این آرگومان حذف شود، یک فایل \&\fBtar\fR\|(1) باید در STDOUT خروجی داده شود (اما بخش باگ‌ها را ببینید). .PP هشدار: اجرای این دستور روی فایل‌های لاگ حجیم عموماً بدین معناست که به فضای خالی دیسک زیادی نیاز خواهید داشت. برای جزئیات به \fBLire::LrCommand\fR\|(3pm) مراجعه کنید. .SH "مثال‌ها (EXAMPLES)" .IX Header "EXAMPLES" برای پردازش یک لاگ Postfix و نمایش گزارش به صورت متن: .PP .Vb 1 \& $ lr_log2report postfix /var/log/mail.log .Ve .PP برای پردازش یک لاگ Postfix و ایجاد گزارش HTML درون یک دایرکتوری: .PP .Vb 1 \& $ lr_log2report \-o html postfix /var/log/mail.log postfix\-report .Ve .SH "گزارش باگ‌ها (BUGS)" .IX Header "BUGS" اگر .PP .Vb 1 \& \-\-output html .Ve .PP مشخص شده باشد، هم \fIlogfile\fR و هم \fIoutput_file\fR باید مشخص شوند. تعیین \f(CW\*(C`\-\*(C'\fR (یا \f(CW\*(C`/dev/stdin\*(C'\fR) به عنوان \fIlogfile\fR پشتیبانی می‌شود. بنابراین دستور زیر .PP .Vb 2 \& $ tai64nfrac < /var/log/qmail\-send/current | \e \& lr_log2report qmail \-\-output html \- /tmp/report .Ve .PP کار خواهد کرد. .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" \&\fBlr_log2mail\fR\|(1), \fBlr_xml2report\fR\|(1), \fBlr_xml2mail\fR\|(1), \fBlire\fR\|(1), \fBlire\fR\|(7), \&\fBLire::LrCommand\fR\|(3pm), مستندات راهنمای کاربری Lire .SH "نویسندگان (AUTHORS)" .IX Header "AUTHORS" .Vb 2 \& Joost van Baal \& Francis J. Lacoste .Ve .SH "نسخه (VERSION)" .IX Header "VERSION" \&\f(CW$Id:\fR lr_log2report.in,v 1.100 2006/10/04 10:19:17 vanbaal Exp $ .SH "کپی‌رایت و تکثیر (COPYRIGHT)" .IX Header "COPYRIGHT" Copyright (C) 2000\-2004 Stichting LogReport Foundation LogReport@LogReport.org .PP این برنامه بخشی از Lire است. .PP برنامه Lire یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز عمومی همگانی گنو (GNU GPL) که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، چه نسخهٔ ۲ مجوز و چه (به انتخاب خودتان) هر نسخهٔ بالاتر دیگری، بازتوزیع کرده یا تغییر دهید. .PP این برنامه به این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به مجوز عمومی همگانی گنو مراجعه کنید. .PP شما باید به همراه این برنامه یک نسخه از مجوز عمومی همگانی گنو را دریافت کرده باشید (فایل COPYING را ببینید)؛ در غیر این صورت به نشانی http://www.gnu.org/copyleft/gpl.html مراجعه کنید.