نام (NAME)

scanspool - بررسی انطباق مقالات موجود در مخزن با فایل تاریخچه در INN

خلاصه دستور (SYNOPSIS)

scanspool [-cnrv] [-a active-file] [-s spool-dir]

توضیحات (DESCRIPTION)

دستور scanspool یک اسکریپت پرل برای استفاده با مخزن مقالات از نوع tradspool است. این ابزار فایل active و همچنین تمامی مقالات موجود در مخزن را بررسی کرده و خطاهایی را که با آن‌ها مواجه می‌شود گزارش می‌دهد. از آنجا که این عملیات ممکن است زمان‌بر باشد، استفاده از گزینه -v برای مشاهده میزان پیشرفت برنامه توصیه می‌شود.

هنگام پردازش محتویات مخزن اخبار، scanspool از هر فایلی که نام آن چیزی جز فقط ارقام نباشد، صرف‌نظر می‌کند.

ابتدا، scanspool فایل active را بررسی می‌کند و مشکلاتی از این قبیل را ثبت می‌نماید:

• خطوط با ساختار نادرست؛
• مدخل‌های تکراری؛
• گروه‌های خبری با نام مستعار ارجاع‌داده‌شده به یک گروه خبری ناموجود؛
• گروه‌های خبری با نام مستعار ارجاع‌داده‌شده به گروه خبری دیگری که خود نیز نام مستعار دارد.

سپس تمام مقالات موجود در پوشه مخزن اخبار شما را بررسی می‌کند و درباره مقالاتی هشدار می‌دهد که:

• نام پایه (basename) آن‌ها با صفر شروع می‌شود؛
• نام پایه آن‌ها بر اساس حد پایین و بالای مشخص‌شده در فایل active خارج از محدوده مجاز باشد؛
• فاقد فیلد سرایند Newsgroups باشند؛
• در پوشه‌ای قرار داشته باشند که هیچ گروه خبری متناظری برای آن در فایل active وجود ندارد؛
• در گروه خبری قرار دارند که به آن تعلق ندارند.

همچنین scanspool درباره پوشه‌هایی با نام کاملاً عددی هشدار خواهد داد، در صورتی که پوشه والد یک گروه خبری با حد بالایی کمتر از آن عدد باشد؛ چرا که نام چنین پوشه‌هایی در آینده با یک فایل مقاله با همان نام تداخل پیدا خواهد کرد.

ابزار scanspool گروه‌های خبری دارای نام مستعار را درک می‌کند. بنابراین، اگر مقاله‌ای به foo.old.name ارسال شده باشد که نام مستعار foo.bar است، انتظار می‌رود که در پوشه foo.bar یافت شود نه در foo.old.name.

ابزار scanspool فرض می‌کند که مسیر پوشه یک گروه خبری معتبر از ریشه درخت مخزن شامل هیچ نویسه "." نخواهد بود. بنابراین، پوشه‌هایی مانند out.going ، tmp.dir ، in.coming و news.archive جستجو نخواهند شد. این برنامه همچنین فرض می‌کند که نام پایه مقالات فقط شامل ارقام ده‌دهی است. در نهایت، فایل‌های موجود در پوشه سطح بالای lost+found بررسی نمی‌شوند.

گزینه‌ها (OPTIONS)

-a active-file

فایل active مورداستفاده؛ پیش‌فرض pathdb/active است.

-c

فقط نام فایل مقالات بررسی شود. بنابراین scanspool فیلد سرایند Newsgroups مقالات را اسکن نخواهد کرد.

-n

هنگام اسکن، فعالیت innd را محدود (throttle) نکن.

-r

مقالاتی که گزارش مشکل داشته‌اند حذف شوند. برای مشاهده لیست مقالات مورد بحث، ابتدا scanspool را بدون این گزینه اجرا کنید.

توجه داشته باشید که استفاده از این گزینه در صورتی که مقالاتی کاملاً معتبر به اشتباه حذف شوند ممکن است به غیرقابل‌دسترس شدن مقالات منجر گردد. ابتدا آن‌ها را بررسی کنید تا مطمئن شوید حذف آن‌ها ایمن است، و سپس از این گزینه استفاده نمایید.

-s spool-dir

ریشه درخت مخزن؛ پیش‌فرض patharticles است.

-v

تنظیم این گزینه حالت پرگو (verbose) را فعال می‌کند. در این حالت، scanspool مشخص می‌کند که در حال حاضر روی کدام گروه خبری کار می‌شود. همچنین به جای این که گروه را فقط یک بار چاپ کند، تمام مقالات یافت‌شده در پوشه‌های غیر active (یعنی مقالاتی که در گروه‌هایی قرار دارند که دیگر در فایل active حاضر نیستند) را فهرست می‌کند.

عیب‌یابی (DIAGNOSTICS)

خروجی scanspool با یکی از قالب‌های زیر آغاز می‌شود:

"FATAL:" (به stderr)

خطای مرگبار یا خطای داخلی.

"WARNING:" (به stderr)

مشکل در قالب فایل active یا مقاله، مشکل در نام مستعار گروه خبری، خطای find(1)، خطای باز کردن مقاله.

"path/123:" (به stdout)

مشکلاتی از قبیل:

"\t ..." (به stdout)

پیام‌های پرگو (verbose) با یک نویسه تب آغاز می‌شوند.

تاریخچه (HISTORY)

برنامه scanspool توسط Landon Curt Noll نوشته شده است (chongo was here /\../\).

این صفحه راهنما توسط Florian Schlichting و تا حد زیادی بر اساس توضیحات درون اسکریپت نوشته شده است.

همچنین ببینید (SEE ALSO)

active(5).