.\" -*- 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 "COMMON2DLF.IN 1"
.TH COMMON2DLF.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)"
common2dlf \- تبدیل فایل‌های لاگ وب‌سرور Common Log Format به www DLF
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fBcommon2dlf\fR \fIfile\fR
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
دستور \&\fBcommon2dlf\fR فایل‌های لاگ وب‌سرور در ساختار Common Log Format را به
www DLF تبدیل می‌کند. ساختار Common Log Format یک قالب لاگ استاندارد است که
در ابتدا در وب‌سرور CERN httpd پیاده‌سازی شده بود، اما امروزه توسط بیشتر
وب‌سرورها پشتیبانی می‌شود. می‌توان Apache، IIS، Boa و PureFTPD را به گونه‌ای
پیکربندی کرد که رویدادها را در این قالب ثبت کنند.
.PP
اگر آرگومان \fIfile\fR مشخص نشده باشد، STDIN تجزیه خواهد شد. خروجی DLF در
STDOUT چاپ خواهد شد.
.SH "قالب لاگ متداول (COMMON LOG FORMAT)"
.IX Header "COMMON LOG FORMAT"
قالب Common Log Format دارای ساختار زیر است:
.PP
\&\fIremotehost\fR \fIrfc931\fR \fIauthuser\fR [\fIdate\fR] "\fIrequest\fR" \fIstatus\fR \fIbytes\fR
.PP
که در آن هر فیلد مفهوم زیر را دارد:
.IP \fIremotehost\fR 4
.IX Item "remotehost"
میزبانی که درخواست را ارسال کرده است. می‌تواند یک IP یا نام میزبان (hostname) باشد.
.IP \fIrfc931\fR 4
.IX Item "rfc931"
نتیجه جستجوی ident روی میزبان. این فیلد معمولاً استفاده نمی‌شود.
.IP \fIauthuser\fR 4
.IX Item "authuser"
نام کاربری احرازهویت‌شده.
.IP \fIdate\fR 4
.IX Item "date"
برچسب زمانی (timestamp) ثبت درخواست.
.IP \fIrequest\fR 4
.IX Item "request"
خط اول درخواست؛ معمولاً در قالب 
"\fImethod\fR \fIrequest\-uri\fR \fIhttp\-version\fR".
.Sp
همچنین بخش 5.1 از سند RFC 2616 را ببینید.
.IP \fIstatus\fR 4
.IX Item "status"
کد وضعیت پاسخ به درخواست؛ مانند 200، 301، 404، 500.
.IP \fIbytes\fR 4
.IX Item "bytes"
حجم داده ارسال‌شده به کلاینت.
.PP
نمونه لاگ:
.PP
.Vb 2
\&  127.0.01 \- \- [11/03/2001 12:12:01 \-0400] "GET / HTTP/1.0" 200 513
\&  dsl1.myprovider.com \- francis [11/03/2001 12:14:01 \-0400] "GET /secret/ HTTP/1.0" 200 1256
.Ve
.SH "مثال‌ها (EXAMPLES)"
.IX Header "EXAMPLES"
برای پردازش لاگی که در قالب common logformat تولید شده است:
.PP
.Vb 1
\& $ lr_run common2dlf < common.log
.Ve
.PP
ابزار common2dlf به‌ندرت به صورت مستقل استفاده می‌شود؛ بلکه اغلب توسط
lr_log2report فراخوانی می‌گردد:
.PP
.Vb 1
\& $ lr_log2report common < /var/log/httpd/common.log
.Ve
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBcombined\fR\|(2), \fBmodgzip2dlf\fR\|(1), \fBreferer2dlf\fR\|(1)
.SH "نویسندگان (AUTHORS)"
.IX Header "AUTHORS"
Joost van Baal <joostvb@logreport.org>، Francis J. Lacoste
<flacoste@logreport.org> و Egon Willighagen <egonw@logreport.org>،
بر پایه ایده‌ای از Edwin Groothuis
.SH "نسخه (VERSION)"
.IX Header "VERSION"
\&\f(CW$Id:\fR common2dlf.in,v 1.15 2006/07/23 13:16:36 vanbaal Exp $
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.IX Header "COPYRIGHT"
Copyright (C) 2000, 2001 Stichting LogReport Foundation LogReport@LogReport.org
.PP
این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز عمومی همگانی گنو (GNU General Public License) که توسط بنیاد نرم‌افزارهای آزاد (Free Software Foundation) منتشر شده است — چه نسخه ۲ مجوز و چه (به انتخاب خودتان) هر نسخه پس از آن — بازتوزیع کرده و/یا تغییر دهید.
.PP
این برنامه با این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به متن پروانه عمومی همگانی گنو مراجعه کنید.
.PP
شما باید به همراه این برنامه نسخه‌ای از GNU General Public License را دریافت کرده باشید (فایل COPYING را ببینید)؛ در غیر این صورت به نشانی http://www.gnu.org/copyleft/gpl.html مراجعه کنید.