نام (NAME)

active - فهرست گروه‌های خبری میزبانی‌شده توسط کارساز

توضیحات (DESCRIPTION)

فایل pathdb/active فهرست گروه‌های خبری ارائه‌شده توسط INN را در بر دارد. این فایل معمولاً با استفاده از ctlinnd(8) برای ایجاد و حذف گروه‌ها، یا با واگذاری این کار به controlchan(8) بر پایه پیام‌های کنترلی دریافتی نگهداری می‌شود؛ سپس این فایل به‌روزرسانی شده و یک نسخه پشتیبان در pathdb/active.old ذخیره می‌گردد. توجه داشته باشید که فایل newsgroups(5) معمولاً حاوی توضیحات گروه‌های خبری میزبانی‌شده در کارساز خبر است.

فایل active نباید مستقیماً بدون متوقف‌سازی موقت (throttling) innd ویرایش شود، و باید پیش از لغو توقف innd با استفاده از ctlinnd مجدداً بارگذاری گردد. حتی با رعایت این موارد، ویرایش مستقیم ممکن است موجب ناسازگاری آن با پایگاه‌داده بررسی کلی (overview database) شده و active.times را به‌روز نکند؛ بنابراین در صورت امکان همواره باید از ctlinnd برای اعمال تغییرات استفاده شود.

هر گروه خبری باید تنها یک بار فهرست شود. هر خط یک گروه را مشخص می‌کند. ترتیب گروه‌ها اهمیتی ندارد. در هر گروه خبری، به مقاله‌های دریافت‌شده برای آن گروه اعدادی به صورت یکنواخت افزایشی به عنوان نام‌های یکتا اختصاص می‌یابد. اگر مقاله‌ای به گروه‌های خبری ارسال شود که در این فایل ذکر نشده‌اند، آن گروه‌ها نادیده گرفته می‌شوند.

اگر هیچ‌یک از گروه‌های خبری فهرست‌شده در بدنه فیلد سربرگ Newsgroups یک مقاله در این فایل موجود نباشد، مقاله یا رد می‌شود (اگر wanttrash در inn.conf برابر false باشد)، یا در گروه خبری "junk" قرار می‌گیرد و هنگامی که "Aj" در الگوی فید newsfeeds تنظیم نشده باشد، تنها به سایت‌هایی که گروه خبری "junk" را دریافت می‌کنند بازنشر می‌یابد (اگر wanttrash برابر true باشد).

هر خط از این فایل شامل چهار فیلد است که با یک فاصله (space) از یکدیگر جدا شده‌اند:

<name> <high> <low> <status>

فیلد نخست، نام گروه خبری است. همان‌طور که پیش‌تر اشاره شد، گروه خبری "junk" یک گروه ویژه است. گروه خبری "control" و هر گروه خبری که با "control." آغاز شود نیز ویژه هستند؛ در صورتی که گروه خبری control.* بر اساس نوع پیام کنترلی وجود داشته باشد، پیام‌های کنترلی در آن بایگانی می‌شوند، و در غیر این صورت در گروه خبری "control" قرار می‌گیرند (بدون در نظر گرفتن اینکه چه گروه‌های خبری در فیلد سربرگ Newsgroups فهرست شده‌اند). اگر mergetogroups در inn.conf برابر true تنظیم شده باشد، گروه‌های خبری که با "to." آغاز می‌شوند نیز رفتار ویژه‌ای خواهند داشت؛ innd(8) را ببینید.

فیلد دوم، بالاترین شماره مقاله‌ای است که در آن گروه خبری استفاده شده است. فیلد سوم، پایین‌ترین شماره مقاله در گروه است؛ تضمینی بر دقیق بودن این مقدار وجود ندارد و تنها باید به عنوان یک راهنما در نظر گرفته شود. این مقدار معمولاً هر شب به عنوان بخشی از فرایند انقضا (expire) به‌روزرسانی می‌شود؛ برای جزئیات بیشتر به news.daily(8) مراجعه کرده و عبارت‌های "lowmark" یا "renumber" را جستجو کنید. توجه داشته باشید که ممکن است به دلیل لغو مقالات، شکاف‌هایی در توالی شماره‌گذاری وجود داشته باشد. اگر کمترین شماره مقاله بزرگ‌تر از بیشترین شماره مقاله باشد، به این معنی است که هیچ مقاله‌ای در گروه خبری وجود ندارد. برای اینکه امکان به‌روزرسانی درجا (in-place) بدون بازنویسی کل فایل فراهم باشد، فیلدهای دوم و سوم با صفرهای ابتدایی پر می‌شوند تا طول ثابتی داشته باشند.

فیلد چهارم شامل یکی از وضعیت‌های زیر است:

y         ارسال‌های محلی و مقاله‌های همتایان (peers) مجاز هستند.
m         گروه مدیریت‌شده (moderated) است و تمامی ارسال‌ها باید تأیید شوند.
n         ارسال محلی مجاز نیست، تنها مقاله‌های دریافتی از همتایان مجاز است.
j         مقاله‌های دریافتی از همتایان در عوض در گروه junk بایگانی می‌شوند.
x         ارسال محلی ممنوع است و مقاله‌های دریافتی از همتایان نادیده گرفته می‌شوند.
=foo.bar  مقاله‌ها در عوض در گروه foo.bar بایگانی می‌شوند.

اگر یک گروه خبری دارای وضعیت "j" باشد، هیچ مقاله‌ای در آن گروه خبری بایگانی نخواهد شد. ارسال‌های محلی پذیرفته نمی‌شوند؛ اگر مقاله‌ای برای آن گروه خبری از یک سایت دوردست دریافت شود و به گروه معتبر دیگری ارسال متقاطع (crosspost) نشده باشد، در عوض در گروه خبری "junk" بایگانی می‌شود. این حالت با فهرست نکردن ساده گروه تفاوت دارد، زیرا مقاله همچنان پذیرفته می‌شود و می‌تواند به سایت‌های دیگر منتشر گردد، و در صورت نیاز می‌توان گروه "junk" را در دسترس خوانندگان قرار داد.

اگر فیلد <status> با علامت مساوی شروع شود، آن گروه خبری یک نام مستعار (alias) است. مقاله‌ها را نمی‌توان به آن گروه خبری ارسال کرد، اما می‌توان آن‌ها را از سایر سایت‌ها دریافت نمود. با هر مقاله‌ای که برای آن گروه خبری از همتایان دریافت شود طوری رفتار می‌شود که گویی واقعاً به گروه مشخص‌شده پس از علامت مساوی ارسال شده است. توجه داشته باشید که فیلد سربرگ Newsgroups در مقالات دست‌نخورده باقی می‌ماند. (گروه‌های مستعار عموماً در طول دوره‌های انتقال استفاده می‌شوند و معمولاً به صورت دستی با ctlinnd(8) ایجاد می‌گردند.) یک نام مستعار نباید به یک نام مستعار دیگر اشاره کند.

توجه داشته باشید که readers.conf را می‌توان به گونه‌ای پیکربندی کرد که ارسال‌های محلی به گروه‌های خبری با وضعیت "j"، "n" یا "x" پذیرفته شوند.

حداقل فایل ACTIVE (MINIMAL ACTIVE FILE)

برای اینکه innd قادر به اجرا باشد، سه گروه "control"، "control.cancel" و "junk" باید در فایل active وجود داشته باشند. علاوه بر این، اگر mergetogroups در inn.conf برابر true باشد، گروه خبری "to" نیز باید وجود داشته باشد.

حداقل فایل active که همراه با INN ارائه می‌شود به شرح زیر است:

control 0000000000 0000000001 n
control.cancel 0000000000 0000000001 n
control.checkgroups 0000000000 0000000001 n
control.newgroup 0000000000 0000000001 n
control.rmgroup 0000000000 0000000001 n
junk 0000000000 0000000001 n

(توجه داشته باشید که اگر کارساز خبر قبلاً مورد استفاده قرار گرفته باشد، ممکن است فیلدهای دوم و سوم متفاوت باشند.)

تعداد شبه‌گروه‌های control.* در اینجا بیشتر از مقدار مورد نیاز innd برای شروع به کار است؛ پیام‌های کنترلی مربوطه در آن‌ها بایگانی خواهند شد. وضعیت "n" به این منظور است که کاربران نتوانند مستقیماً در این گروه‌ها پستی ارسال کنند (پیام‌های کنترلی تنها باید به گروه‌هایی ارسال شوند که بر آن‌ها اثر می‌گذارند). اگر نمی‌خواهید این گروه‌ها برای کلاینت‌ها قابل مشاهده باشند، آن‌ها را حذف نکنید؛ بلکه به سادگی آن‌ها را در readers.conf(5) پنهان سازید.

برای ایجاد گروه‌های بیشتر پس از راه‌اندازی کارساز، می‌توانید از "ctlinnd newgroup" استفاده کنید. همچنین می‌توانید فهرست گروه‌های خبری خود را با استفاده از actsync(8) با کارساز دیگری همگام‌سازی کنید یا فایل active یک کارساز NNTP دیگر را با getlist(1) دریافت نمایید. و فراموش نکنید که فایل newsgroups خود را به‌روزرسانی کنید؛ این کار به لطف اجرای docheckgroups همراه با پرچم -u می‌تواند به طور خودکار انجام شود.

تاریخچه (HISTORY)

نوشته‌شده توسط Rich $alz <rsalz@uunet.uu.net> برای InterNetNews. تبدیل به POD توسط Russ Allbery <eagle@eyrie.org>.

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

active.times(5), actsync(8), controlchan(8), ctlinnd(8), docheckgroups(8), getlist(1), inn.conf(5), innd(8), mod-active(8), news.daily(8), newsgroups(5), readers.conf(5).