.\" -*- 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 "SCANSPOOL 8"
.TH SCANSPOOL 8 2024-05-19 "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)"
scanspool \- بررسی انطباق مقالات موجود در مخزن با فایل تاریخچه در INN
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fBscanspool\fR [\fB\-cnrv\fR] [\fB\-a\fR \fIactive-file\fR] [\fB\-s\fR \fIspool-dir\fR]
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
دستور
\&\fBscanspool\fR
یک اسکریپت پرل برای استفاده با مخزن مقالات از نوع
\fItradspool\fR
است. این ابزار فایل
\fIactive\fR
و همچنین تمامی مقالات موجود در مخزن را بررسی کرده و خطاهایی را که با آن‌ها مواجه می‌شود گزارش می‌دهد. از آنجا که این عملیات ممکن است زمان‌بر باشد، استفاده از گزینه
\&\fB\-v\fR
برای مشاهده میزان پیشرفت برنامه توصیه می‌شود.
.PP
هنگام پردازش محتویات مخزن اخبار،
\&\fBscanspool\fR
از هر فایلی که نام آن چیزی جز فقط ارقام نباشد، صرف‌نظر می‌کند.
.PP
ابتدا،
\&\fBscanspool\fR
فایل
\fIactive\fR
را بررسی می‌کند و مشکلاتی از این قبیل را ثبت می‌نماید:
.IP \(bu 4
خطوط با ساختار نادرست؛
.IP \(bu 4
مدخل‌های تکراری؛
.IP \(bu 4
گروه‌های خبری با نام مستعار ارجاع‌داده‌شده به یک گروه خبری ناموجود؛
.IP \(bu 4
گروه‌های خبری با نام مستعار ارجاع‌داده‌شده به گروه خبری دیگری که خود نیز نام مستعار دارد.
.PP
سپس تمام مقالات موجود در پوشه مخزن اخبار شما را بررسی می‌کند و درباره مقالاتی هشدار می‌دهد که:
.IP \(bu 4
نام پایه (basename) آن‌ها با صفر شروع می‌شود؛
.IP \(bu 4
نام پایه آن‌ها بر اساس حد پایین و بالای مشخص‌شده در فایل
\fIactive\fR
خارج از محدوده مجاز باشد؛
.IP \(bu 4
فاقد فیلد سرایند Newsgroups باشند؛
.IP \(bu 4
در پوشه‌ای قرار داشته باشند که هیچ گروه خبری متناظری برای آن در فایل
\fIactive\fR
وجود ندارد؛
.IP \(bu 4
در گروه خبری قرار دارند که به آن تعلق ندارند.
.PP
همچنین
\&\fBscanspool\fR
درباره پوشه‌هایی با نام کاملاً عددی هشدار خواهد داد، در صورتی که پوشه والد یک گروه خبری با حد بالایی کمتر از آن عدد باشد؛ چرا که نام چنین پوشه‌هایی در آینده با یک فایل مقاله با همان نام تداخل پیدا خواهد کرد.
.PP
ابزار
\&\fBscanspool\fR
گروه‌های خبری دارای نام مستعار را درک می‌کند. بنابراین، اگر مقاله‌ای به foo.old.name ارسال شده باشد که نام مستعار foo.bar است، انتظار می‌رود که در پوشه foo.bar یافت شود نه در foo.old.name.
.PP
ابزار
\&\fBscanspool\fR
فرض می‌کند که مسیر پوشه یک گروه خبری معتبر از ریشه درخت مخزن شامل هیچ نویسه
\f(CW\*(C`.\*(C'\fR
نخواهد بود. بنابراین، پوشه‌هایی مانند
\fIout.going\fR ،
\fItmp.dir\fR ،
\fIin.coming\fR
و
\&\fInews.archive\fR
جستجو نخواهند شد. این برنامه همچنین فرض می‌کند که نام پایه مقالات فقط شامل ارقام ده‌دهی است. در نهایت، فایل‌های موجود در پوشه سطح بالای
\fIlost+found\fR
بررسی نمی‌شوند.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP "\fB\-a\fR \fIactive-file\fR" 4
.IX Item "-a active-file"
فایل
\fIactive\fR
مورداستفاده؛ پیش‌فرض
\fIpathdb\fR/active
است.
.IP \fB\-c\fR 4
.IX Item "-c"
فقط نام فایل مقالات بررسی شود. بنابراین
\fBscanspool\fR
فیلد سرایند Newsgroups مقالات را اسکن نخواهد کرد.
.IP \fB\-n\fR 4
.IX Item "-n"
هنگام اسکن، فعالیت
\fBinnd\fR
را محدود (throttle) نکن.
.IP \fB\-r\fR 4
.IX Item "-r"
مقالاتی که گزارش مشکل داشته‌اند حذف شوند. برای مشاهده لیست مقالات مورد بحث، ابتدا
\fBscanspool\fR
را بدون این گزینه اجرا کنید.
.Sp
توجه داشته باشید که استفاده از این گزینه در صورتی که مقالاتی کاملاً معتبر به اشتباه حذف شوند ممکن است به غیرقابل‌دسترس شدن مقالات منجر گردد. ابتدا آن‌ها را بررسی کنید تا مطمئن شوید حذف آن‌ها ایمن است، و سپس از این گزینه استفاده نمایید.
.IP "\fB\-s\fR \fIspool-dir\fR" 4
.IX Item "-s spool-dir"
ریشه درخت مخزن؛ پیش‌فرض
\fIpatharticles\fR
است.
.IP \fB\-v\fR 4
.IX Item "-v"
تنظیم این گزینه حالت پرگو (verbose) را فعال می‌کند. در این حالت،
\fBscanspool\fR
مشخص می‌کند که در حال حاضر روی کدام گروه خبری کار می‌شود. همچنین به جای این که گروه را فقط یک بار چاپ کند، تمام مقالات یافت‌شده در پوشه‌های غیر
\fIactive\fR
(یعنی مقالاتی که در گروه‌هایی قرار دارند که دیگر در فایل
\fIactive\fR
حاضر نیستند) را فهرست می‌کند.
.SH "عیب‌یابی (DIAGNOSTICS)"
.IX Header "DIAGNOSTICS"
خروجی
\fBscanspool\fR
با یکی از قالب‌های زیر آغاز می‌شود:
.ie n .IP """FATAL:"" (به stderr)" 4
.el .IP "\f(CWFATAL:\fR (به stderr)" 4
.IX Item "FATAL: (to stderr)"
خطای مرگبار یا خطای داخلی.
.ie n .IP """WARNING:"" (به stderr)" 4
.el .IP "\f(CWWARNING:\fR (به stderr)" 4
.IX Item "WARNING: (to stderr)"
مشکل در قالب فایل
\fIactive\fR
یا مقاله، مشکل در نام مستعار گروه خبری، خطای
.BR find (1)،
خطای باز کردن مقاله.
.ie n .IP """path/123:"" (به stdout)" 4
.el .IP "\f(CWpath/123:\fR (به stdout)" 4
.IX Item "path/123: (to stdout)"
مشکلاتی از قبیل:
.RS 4
.IP \(bu 4
نام پایه با ۰ شروع شده است؛
.IP \(bu 4
شماره مقاله خارج از محدوده است؛
.IP \(bu 4
مقاله در پوشه اشتباه قرار دارد؛
.IP \(bu 4
مقاله در پوشه‌ای قرار دارد که مربوط به یک گروه خبری فعال (\fIactive\fR) بدون نام مستعار نیست.
.RE
.RS 4
.RE
.ie n .IP """\et ..."" (به stdout)" 4
.el .IP "\f(CW\et ...\fR (به stdout)" 4
.IX Item "t ... (to stdout)"
پیام‌های پرگو (verbose) با یک نویسه تب آغاز می‌شوند.
.SH "تاریخچه (HISTORY)"
.IX Header "HISTORY"
برنامه
\&\fBscanspool\fR
توسط Landon Curt Noll نوشته شده است (chongo was here /\e../\e).
.PP
این صفحه راهنما توسط Florian Schlichting و تا حد زیادی بر اساس توضیحات درون اسکریپت نوشته شده است.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
.BR active (5).