.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.0102 (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
.\" ========================================================================
.\"
.IX Title "SCANLOGS 8"
.TH SCANLOGS 8 2025-05-09 "INN 2.7.4" "InterNetNews 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)"
scanlogs \- خلاصه‌سازی و چرخش پرونده‌های وقایع INN
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fBscanlogs\fR [\fBnorotate\fR]
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
\&\fBscanlogs\fR اطلاعات ثبت‌شده در پرونده‌های وقایع INN را که در دایرکتوری
\fIpathlog\fR
تنظیم‌شده در
\fIinn.conf\fR
قرار دارند، خلاصه‌سازی می‌کند (برای جزئیات بیشتر درباره این پرونده‌های وقایع به
.BR newslog (5)
مراجعه کنید). این دستور معمولاً توسط اسکریپت
.BR news.daily (8)
که وظایف روزانه نگهداری سرور را انجام می‌دهد فراخوانی می‌شود.
.PP
این ابزار
\f(CW\*(C`ctlinnd flushlogs\*(C'\fR
را فراخوانی می‌کند تا پرونده‌های وقایع اخبار و خطاها بسته شوند، نام آن‌ها با افزودن
\f(CW\*(C`.old\*(C'\fR
به انتهای نام پرونده تغییر یابد و پرونده‌های وقایع جدید باز شوند؛ پرونده
\fIactive\fR
نیز همراه با پایگاه‌داده تاریخچه روی دیسک تخلیه و همگام‌سازی (flush) می‌شود.
.PP
به‌طور پیش‌فرض،
\&\fBscanlogs\fR
پرونده‌های وقایع را می‌چرخاند و پاک‌سازی می‌کند. این ابزار تا حداکثر
\&\fIlogcycles\fR
پرونده وقایع فشرده قدیمی را در مسیر
\fIpathlog\fR/OLD
نگه می‌دارد (پارامتر
\fIlogcycles\fR
در
\fIinn.conf\fR
قابل تنظیم است). همچنین
\&\fBscanlogs\fR
نسخه‌های بایگانی پرونده
\fIactive\fR
را در این دایرکتوری نگهداری می‌کند.
.PP
اگر
\fInewgroup.log\fR
یا
\fIrmgroup.log\fR
در
\fIpathlog\fR
وجود داشته باشد، دستور
\&\fBtally.control\fR
را فراخوانی می‌کند (برای اطلاعات بیشتر به مدخل
\fIcontrol.log\fR
در
.BR newslog (5)
مراجعه کنید).
.PP
در صورت خالی نبودن،
\&\fBscanlogs\fR
۵۰ سطر اول پرونده‌های
\fIerrlog\fR\fR،
\fInews.err\fR
و
\fInews.crit\fR
را نمایش می‌دهد و
\&\fBinnreport\fR
را اجرا می‌کند تا محتویات
\fInews\fR\fR،
\fInews.notice\fR
و
\fIperl\-nocem.log\fR
را خلاصه‌سازی کند و از میان موارد دیگر، پرونده
\&\fIunwanted.log\fR
را به‌روزرسانی نماید (برای اطلاعات بیشتر در این رابطه به
.BR innreport (8)
مراجعه کنید).
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
در حال حاضر تنها یک گزینه پذیرفته می‌شود:
.IP \fBnorotate\fR 4
.IX Item "norotate"
استفاده از این گزینه بخش چرخش و پاک‌سازی پردازش گزارش را غیرفعال می‌کند: پرونده‌های وقایع صرفاً برای استخراج اطلاعات بررسی می‌شوند و هیچ محتوایی تغییر داده نمی‌شود. اگر
\&\fBscanlogs\fR
بیش از یک بار در روز فراخوانی شود، باید از گزینه
\&\fBnorotate\fR
استفاده شود تا از پاک‌سازی زودهنگام وقایع جلوگیری شود.
.SH "فایل‌ها (FILES)"
.IX Header "FILES"
برای مشاهده فهرست پرونده‌های وقایع پردازش‌شده توسط
\&\fBscanlogs\fR\fR،
به
.BR newslog (5)
مراجعه کنید.
.SH "تاریخچه (HISTORY)"
.IX Header "HISTORY"
نوشته‌شده توسط Landon Curt Noll <chongo@toad.com> و Rich $alz
<rsalz@uunet.uu.net> برای InterNetNews. تبدیل به POD توسط Julien Elie.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
.BR inn.conf (5)،
.BR innreport (8)،
.BR news.daily (8)،
.BR newslog (5)،
.BR shlock (8)،
.BR tally.control (8).