.\" -*- 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 "ACTIVE 5" .TH ACTIVE 5 2022-07-10 "INN 2.7.4" "مستندات InterNetNews" .\" 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)" active \- فهرست گروه‌های خبری میزبانی‌شده توسط کارساز .SH "توضیحات (DESCRIPTION)" .IX Header "توضیحات (DESCRIPTION)" فایل \fIpathdb\fR/active فهرست گروه‌های خبری ارائه‌شده توسط INN را در بر دارد. این فایل معمولاً با استفاده از ctlinnd(8) برای ایجاد و حذف گروه‌ها، یا با واگذاری این کار به controlchan(8) بر پایه پیام‌های کنترلی دریافتی نگهداری می‌شود؛ سپس این فایل به‌روزرسانی شده و یک نسخه پشتیبان در \fIpathdb\fR/active.old ذخیره می‌گردد. توجه داشته باشید که فایل newsgroups(5) معمولاً حاوی توضیحات گروه‌های خبری میزبانی‌شده در کارساز خبر است. .PP فایل \fIactive\fR نباید مستقیماً بدون متوقف‌سازی موقت (\fIthrottling\fR) \fBinnd\fR ویرایش شود، و باید پیش از لغو توقف \fBinnd\fR با استفاده از \fBctlinnd\fR مجدداً بارگذاری گردد. حتی با رعایت این موارد، ویرایش مستقیم ممکن است موجب ناسازگاری آن با پایگاه‌داده بررسی کلی (overview database) شده و \fIactive.times\fR را به‌روز نکند؛ بنابراین در صورت امکان همواره باید از \fBctlinnd\fR برای اعمال تغییرات استفاده شود. .PP هر گروه خبری باید تنها یک بار فهرست شود. هر خط یک گروه را مشخص می‌کند. ترتیب گروه‌ها اهمیتی ندارد. در هر گروه خبری، به مقاله‌های دریافت‌شده برای آن گروه اعدادی به صورت یکنواخت افزایشی به عنوان نام‌های یکتا اختصاص می‌یابد. اگر مقاله‌ای به گروه‌های خبری ارسال شود که در این فایل ذکر نشده‌اند، آن گروه‌ها نادیده گرفته می‌شوند. .PP اگر هیچ‌یک از گروه‌های خبری فهرست‌شده در بدنه فیلد سربرگ Newsgroups یک مقاله در این فایل موجود نباشد، مقاله یا رد می‌شود (اگر \fIwanttrash\fR در \fIinn.conf\fR برابر false باشد)، یا در گروه خبری \&\f(CW\*(C`junk\*(C'\fR قرار می‌گیرد و هنگامی که \f(CW\*(C`Aj\*(C'\fR در الگوی فید \fInewsfeeds\fR تنظیم نشده باشد، تنها به سایت‌هایی که گروه خبری \f(CW\*(C`junk\*(C'\fR را دریافت می‌کنند بازنشر می‌یابد (اگر \fIwanttrash\fR برابر true باشد). .PP هر خط از این فایل شامل چهار فیلد است که با یک فاصله (space) از یکدیگر جدا شده‌اند: .PP .Vb 1 \& .Ve .PP فیلد نخست، نام گروه خبری است. همان‌طور که پیش‌تر اشاره شد، گروه خبری \f(CW\*(C`junk\*(C'\fR یک گروه ویژه است. گروه خبری \f(CW\*(C`control\*(C'\fR و هر گروه خبری که با \f(CW\*(C`control.\*(C'\fR آغاز شود نیز ویژه هستند؛ در صورتی که گروه خبری control.* بر اساس نوع پیام کنترلی وجود داشته باشد، پیام‌های کنترلی در آن بایگانی می‌شوند، و در غیر این صورت در گروه خبری \f(CW\*(C`control\*(C'\fR قرار می‌گیرند (بدون در نظر گرفتن اینکه چه گروه‌های خبری در فیلد سربرگ Newsgroups فهرست شده‌اند). اگر \fImergetogroups\fR در \fIinn.conf\fR برابر true تنظیم شده باشد، گروه‌های خبری که با \f(CW\*(C`to.\*(C'\fR آغاز می‌شوند نیز رفتار ویژه‌ای خواهند داشت؛ innd(8) را ببینید. .PP فیلد دوم، بالاترین شماره مقاله‌ای است که در آن گروه خبری استفاده شده است. فیلد سوم، پایین‌ترین شماره مقاله در گروه است؛ تضمینی بر دقیق بودن این مقدار وجود ندارد و تنها باید به عنوان یک راهنما در نظر گرفته شود. این مقدار معمولاً هر شب به عنوان بخشی از فرایند انقضا (expire) به‌روزرسانی می‌شود؛ برای جزئیات بیشتر به news.daily(8) مراجعه کرده و عبارت‌های \f(CW\*(C`lowmark\*(C'\fR یا \f(CW\*(C`renumber\*(C'\fR را جستجو کنید. توجه داشته باشید که ممکن است به دلیل لغو مقالات، شکاف‌هایی در توالی شماره‌گذاری وجود داشته باشد. اگر کمترین شماره مقاله بزرگ‌تر از بیشترین شماره مقاله باشد، به این معنی است که هیچ مقاله‌ای در گروه خبری وجود ندارد. برای اینکه امکان به‌روزرسانی درجا (in-place) بدون بازنویسی کل فایل فراهم باشد، فیلدهای دوم و سوم با صفرهای ابتدایی پر می‌شوند تا طول ثابتی داشته باشند. .PP فیلد چهارم شامل یکی از وضعیت‌های زیر است: .PP .Vb 6 \& y ارسال‌های محلی و مقاله‌های همتایان (peers) مجاز هستند. \& m گروه مدیریت‌شده (moderated) است و تمامی ارسال‌ها باید تأیید شوند. \& n ارسال محلی مجاز نیست، تنها مقاله‌های دریافتی از همتایان مجاز است. \& j مقاله‌های دریافتی از همتایان در عوض در گروه junk بایگانی می‌شوند. \& x ارسال محلی ممنوع است و مقاله‌های دریافتی از همتایان نادیده گرفته می‌شوند. \& =foo.bar مقاله‌ها در عوض در گروه foo.bar بایگانی می‌شوند. .Ve .PP اگر یک گروه خبری دارای وضعیت \f(CW\*(C`j\*(C'\fR باشد، هیچ مقاله‌ای در آن گروه خبری بایگانی نخواهد شد. ارسال‌های محلی پذیرفته نمی‌شوند؛ اگر مقاله‌ای برای آن گروه خبری از یک سایت دوردست دریافت شود و به گروه معتبر دیگری ارسال متقاطع (crosspost) نشده باشد، در عوض در گروه خبری \f(CW\*(C`junk\*(C'\fR بایگانی می‌شود. این حالت با فهرست نکردن ساده گروه تفاوت دارد، زیرا مقاله همچنان پذیرفته می‌شود و می‌تواند به سایت‌های دیگر منتشر گردد، و در صورت نیاز می‌توان گروه \f(CW\*(C`junk\*(C'\fR را در دسترس خوانندگان قرار داد. .PP اگر فیلد با علامت مساوی شروع شود، آن گروه خبری یک نام مستعار (alias) است. مقاله‌ها را نمی‌توان به آن گروه خبری ارسال کرد، اما می‌توان آن‌ها را از سایر سایت‌ها دریافت نمود. با هر مقاله‌ای که برای آن گروه خبری از همتایان دریافت شود طوری رفتار می‌شود که گویی واقعاً به گروه مشخص‌شده پس از علامت مساوی ارسال شده است. توجه داشته باشید که فیلد سربرگ Newsgroups در مقالات دست‌نخورده باقی می‌ماند. (گروه‌های مستعار عموماً در طول دوره‌های انتقال استفاده می‌شوند و معمولاً به صورت دستی با ctlinnd(8) ایجاد می‌گردند.) یک نام مستعار نباید به یک نام مستعار دیگر اشاره کند. .PP توجه داشته باشید که \fIreaders.conf\fR را می‌توان به گونه‌ای پیکربندی کرد که ارسال‌های محلی به گروه‌های خبری با وضعیت \f(CW\*(C`j\*(C'\fR، \f(CW\*(C`n\*(C'\fR یا \f(CW\*(C`x\*(C'\fR پذیرفته شوند. .SH "حداقل فایل ACTIVE (MINIMAL ACTIVE FILE)" .IX Header "حداقل فایل ACTIVE (MINIMAL ACTIVE FILE)" برای اینکه \fBinnd\fR قادر به اجرا باشد، سه گروه \f(CW\*(C`control\*(C'\fR، \&\f(CW\*(C`control.cancel\*(C'\fR و \f(CW\*(C`junk\*(C'\fR باید در فایل \fIactive\fR وجود داشته باشند. علاوه بر این، اگر \fImergetogroups\fR در \fIinn.conf\fR برابر true باشد، گروه خبری \f(CW\*(C`to\*(C'\fR نیز باید وجود داشته باشد. .PP حداقل فایل \fIactive\fR که همراه با INN ارائه می‌شود به شرح زیر است: .PP .Vb 6 \& 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 .Ve .PP (توجه داشته باشید که اگر کارساز خبر قبلاً مورد استفاده قرار گرفته باشد، ممکن است فیلدهای دوم و سوم متفاوت باشند.) .PP تعداد شبه‌گروه‌های control.* در اینجا بیشتر از مقدار مورد نیاز \fBinnd\fR برای شروع به کار است؛ پیام‌های کنترلی مربوطه در آن‌ها بایگانی خواهند شد. وضعیت \f(CW\*(C`n\*(C'\fR به این منظور است که کاربران نتوانند مستقیماً در این گروه‌ها پستی ارسال کنند (پیام‌های کنترلی تنها باید به گروه‌هایی ارسال شوند که بر آن‌ها اثر می‌گذارند). اگر نمی‌خواهید این گروه‌ها برای کلاینت‌ها قابل مشاهده باشند، آن‌ها را حذف نکنید؛ بلکه به سادگی آن‌ها را در readers.conf(5) پنهان سازید. .PP برای ایجاد گروه‌های بیشتر پس از راه‌اندازی کارساز، می‌توانید از \&\f(CW\*(C`ctlinnd newgroup\*(C'\fR استفاده کنید. همچنین می‌توانید فهرست گروه‌های خبری خود را با استفاده از actsync(8) با کارساز دیگری همگام‌سازی کنید یا فایل \fIactive\fR یک کارساز NNTP دیگر را با getlist(1) دریافت نمایید. و فراموش نکنید که فایل \fInewsgroups\fR خود را به‌روزرسانی کنید؛ این کار به لطف اجرای \fBdocheckgroups\fR همراه با پرچم \fB\-u\fR می‌تواند به طور خودکار انجام شود. .SH "تاریخچه (HISTORY)" .IX Header "تاریخچه (HISTORY)" نوشته‌شده توسط Rich $alz برای InterNetNews. تبدیل به POD توسط Russ Allbery . .SH "همچنین ببینید (SEE ALSO)" .IX Header "همچنین ببینید (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).