.\"                                      Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH LOGCONV.PL 1 "March 31, 2017"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH "نام (NAME)"
logconv.pl \- تحلیل فایل‌های گزارش دسترسی Directory Server
.SH "خلاصه دستور (SYNOPSIS)"
.B logconv.pl 
[\fI\-h\fR] [\fI\-d <rootDN>\fR] [\fI\-s <size limit>\fR] [\fI\-v\fR] [\fI\-V\fR]
[\fI\-S <start time>\fR] [\fI\-E <end time>\fR] [\fI\-T <min etime>\fR]
[\fI\-efcibaltnxgjuU\fR] [\fI access log ... ... \fR]
.PP
.SH "توضیحات (DESCRIPTION)"
فایل‌های گزارش دسترسی (access log) سرویس‌دهنده دایرکتوری (Directory Server) را برای یافتن اطلاعات مشخص‌شده در خط فرمان تحلیل می‌کند.
.SH "گزینه‌ها (OPTIONS)"
خلاصه‌ای از گزینه‌ها در زیر آمده است:
.TP
.B \fB\-h, \-\-help\fR 
راهنما/نحوه استفاده
.TP
.B \fB\-d, \-\-rootDN\fR <DN مدیر دایرکتوری>
پیش‌فرض \-> cn=directory manager
.TP
.B \fB\-D, \-\-data\fR <محل فایل‌های داده موقت>
پیش‌فرض \-> /tmp
.br
نکته \-> در صورت وجود حافظه RAM کافی، می‌توان به جای آن از یک دیسک RAM استفاده کرد:

       mkdir /dev/shm/logconv، و از این دایرکتوری برای مقدار «\-D» استفاده کنید.
.TP
.B \fB\-s, \-\-sizeLimit\fR <تعداد نتایج بازگردانده‌شده در هر دسته‌بندی>
پیش‌فرض \-> 20
.TP
.B \fB\-X, \-\-excludeIP\fR <نشانی IP برای مستثنی کردن از آمار اتصالات>
برای مثال، متعادل‌کننده‌های بار (Load balancers)
.TP
.B \fB\-v, \-\-version\fR نمایش نسخه ابزار
چاپ نسخه ابزار
.TP
.B \fB\-S, \-\-startTime\fR <زمان شروع تحلیل فایل گزارش>
زمان شروع تحلیل فایل گزارش
برای مثال: [28/Mar/2002:13:14:22 \fB\-0800]\fR
.TP
.B \fB\-E, \-\-endTime\fR <زمان توقف تحلیل فایل گزارش>
زمان پایان تحلیل فایل گزارش
برای مثال: [28/Mar/2002:13:24:62 \fB\-0800]\fR
.TP
.B \fB\-T, \-\-minEtime\fR <حداقل etime برای گزارش جستجوهای بدون نمایه>
حداقل etime مورد نیاز برای ثبت و گزارش جستجوهای بدون نمایه (unindexed). پیش‌فرض صفر است.
.TP
.B \fB\-M, \-\-reportFileMins\fR <فایل خروجی CSV>
این گزینه یک گزارش CSV برای برنامه‌های صفحه‌گسترده ایجاد می‌کند.
.TP
.B \fB\-m, \-\-reportFileSecs\fR <فایل خروجی CSV>
این گزینه یک گزارش CSV برای برنامه‌های صفحه‌گسترده ایجاد می‌کند.
.TP
.B \fB\-B, \-\-bind\fR <ALL | ANONYMOUS | "Bind DN">
این گزینه گزارشی بر اساس تمام dnهای bind، اتصالات ناشناس (anonymous binds) یا یک DN خاص تولید می‌کند.
.TP
\fB\-V, \-\-verbose\fR <فعال‌سازی خروجی پرگو \- شامل تمام آمارهای فهرست‌شده در زیر به جز U>
خروجی پرگو (با جزئیات کامل)
.TP
.B \fB\-[efcibaltnxgjuU]\fR
.br
\fBe\fR آمار کدهای خطا (Error Code)
.br
\fBf\fR آمار ورودهای ناموفق
.br
\fBc\fR آمار کدهای اتصال (Connection Code)
.br
\fBi\fR آمار کلاینت‌ها
.br
\fBb\fR آمار Bind
.br
\fBa\fR آمار پایه جستجو (Search Base)
.br
\fBl\fR آمار فیلتر جستجو (Search Filter)
.br
\fBt\fR آمار Etime
.br
\fBn\fR آمار Nentries
.br
\fBx\fR عملیات گسترش‌یافته (Extended Operations)
.br
\fBr\fR آمار پردرخواست‌ترین صفت‌ها (Attribute)
.br
\fBg\fR آمار عملیات رهاشده (Abandoned Operation)
.br
\fBj\fR توصیه‌ها
.br
\fBu\fR آمار جستجوهای بدون نمایه (بسیار دقیق)
.br
\fBy\fR آمار تأخیر اتصال (Connection Latency)
.br
\fBp\fR آمار شناسه‌های اتصال باز (Open Connection ID)
.br
\fBU\fR خلاصه جستجوهای بدون نمایه
.PP
.SH "مثال‌ها (EXAMPLES)"
مثال‌ها:
.IP
logconv.pl \fB\-s\fR 10 \fB\-V\fR access
.IP
logconv.pl \fB\-d\fR "cn=directory manager" /var/log/dirsrv/slapd\-host/access*
.IP
logconv.pl \fB\-s\fR 50 \fB\-ibgju\fR access*
.IP
logconv.pl \fB\-S\fR "[28/Mar/2002:13:14:22 \fB\-0800]\fR" \fB\-E\fR "[28/Mar/2002:13:50:05 \fB\-0800]\fR" \fB\-e\fR access
.br
.SH "نویسندگان (AUTHORS)"
برنامه logconv.pl توسط پروژه 389 نوشته شده است.
.SH "گزارش باگ‌ها (BUGS)"
گزارش باگ‌ها را به <https://github.com/389ds/389-ds-base/issues/new> ارسال کنید.
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
کپی‌رایت \(co 2001 متعلق به Sun Microsystems, Inc. با کسب اجازه استفاده شده است.
.br
کپی‌رایت \(co 2017 متعلق به Red Hat, Inc.
.br
این صفحه راهنما توسط Michele Baldessari <michele@pupazzo.org> برای پروژه دبیان نوشته شده است (اما ممکن است توسط دیگران نیز استفاده شود).
.br
این یک نرم‌افزار آزاد است. شما می‌توانید نسخه‌های آن را تحت شرایط مجوز Directory Server که در فایل LICENSE این توزیع نرم‌افزاری آمده است بازتوزیع کنید. این مجوز اساساً همان مجوز جامع همگانی گنو (GNU General Public License) نسخه ۲ به همراه یک استثنا برای توزیع افزونه‌ها (plug-in) است.