.\" -*- 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 "INCOMING.CONF 5" .TH INCOMING.CONF 5 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)" incoming.conf \- پیکربندی فیدهای خبری ورودی .SH "در یک نگاه (IN A NUTSHELL)" .IX Header "IN A NUTSHELL" فایل \fIincoming.conf\fR پیکربندی می‌کند که \fBinnd\fR از کدام همتایان دوردست فیدهای NNTP را بپذیرد. .PP یک مدخل رایج برای مجاز کردن \f(CW\*(C`news.server.com\*(C'\fR به عنوان یک همتای ورودی به این صورت است: .PP .Vb 3 \& peer news.server.com { \& hostname: "news.server.com" \& } .Ve .PP درگاه (پورت) مورد استفاده برای فیدهای ورودی همان درگاهی است که \fBinnd\fR روی آن گوش می‌دهد (معمولاً درگاه ۱۱۹ یا ۴۳۳). .PP مدخل‌های همتا به ترتیبی که در فایل پیکربندی آمده‌اند خوانده می‌شوند. اولین مدخل همتایی که مقدار \fIhostname\fR آن با اتصال ورودی مطابقت داشته باشد، برای اعطای دسترسی به همتای دوردست استفاده خواهد شد. مدخل‌های بعدی نادیده گرفته می‌شوند. .PP پس از اعمال هرگونه تغییر، دستور \f(CW\*(C`inncheck\*(C'\fR را برای انجام بررسی‌های نحو پایه اجرا کرده و این فایل پیکربندی را با دستور زیر مجدداً بارگذاری کنید: .PP .Vb 1 \& ctlinnd reload incoming.conf \*(Aqnew peer\*(Aq .Ve .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" فایل \fIpathetc\fR/incoming.conf از سه نوع مدخل تشکیل شده است: کلید/مقدار، همتا (peer) و گروه (group). کامنت‌ها از نویسه هش \f(CW\*(C`#\*(C'\fR تا انتهای خط امتداد دارند. خطوط خالی نادیده گرفته می‌شوند. تمامی مدخل‌های کلید/مقدار در هر نوع نباید تکراری باشند. مدخل‌های کلید/مقدار عبارتند از یک کلمه کلیدی که بلافاصله پس از آن یک دونقطه، حداقل یک فاصله خالی و یک مقدار قرار می‌گیرد. به عنوان مثال: .PP .Vb 1 \& max\-connections: 10 .Ve .PP یک کلید معتبر نباید حاوی فاصله‌های خالی، دونقطه یا \f(CW\*(C`#\*(C'\fR باشد. سه نوع مختلف مقدار وجود دارد: اعداد صحیح، مقادیر بولی، و رشته‌ها. اعداد صحیح طبق انتظار هستند. یک مقدار بولی یکی از مقادیر \f(CW\*(C`true\*(C'\fR، \f(CW\*(C`yes\*(C'\fR، \f(CW\*(C`on\*(C'\fR، \f(CW\*(C`false\*(C'\fR، \&\f(CW\*(C`no\*(C'\fR یا \f(CW\*(C`off\*(C'\fR است (بزرگی و کوچکی حروف مهم نیست). مقدار رشته‌ای هر دنباله دیگری از نویسه‌ها است. اگر رشته نیاز به داشتن فاصله خالی داشته باشد، باید درون نقل‌قول دوتایی قرار گیرد. .PP مدخل‌های همتا (peer) به این صورت هستند: .PP .Vb 3 \& peer { \& # body \& } .Ve .PP کلمه \f(CW\*(C`peer\*(C'\fR الزامی است. یک برچسب برای این همتا است. این مقدار هر رشته‌ای است که به عنوان کلید معتبر باشد. بدنه مدخل همتا شامل تعدادی مدخل کلید/مقدار است. .PP مدخل‌های گروه (group) به این صورت هستند: .PP .Vb 3 \& group { \& # body \& } .Ve .PP کلمه \f(CW\*(C`group\*(C'\fR الزامی است. هر رشته‌ای است که به عنوان کلید معتبر باشد. بدنه مدخل گروه می‌تواند شامل هر تعداد از این سه نوع مدخل باشد. بنابراین جفت‌های کلید/مقدار را می‌توان درون یک گروه تعریف کرد، همتاها را می‌توان درون یک گروه قرار داد، و گروه‌های دیگر را نیز می‌توان درون یک گروه به صورت تودرتو جای داد. مدخل‌های کلید/مقدار که خارج از تمام مدخل‌های همتا و گروه تعریف می‌شوند، در حوزه سراسری (global scope) قرار دارند. مدخل‌های سراسری کلید/مقدار به عنوان پیش‌فرض برای همتاها عمل می‌کنند. هنگامی که \fBinnd\fR به دنبال یک مقدار مشخص در یک مدخل همتا می‌گردد (برای مثال، حداکثر تعداد اتصالات مجاز)، اگر مقدار در مدخل همتا تعریف نشده باشد، گروه‌های دربرگیرنده برای یافتن آن مدخل بررسی می‌شوند (از نزدیک‌ترین گروه دربرگیرنده شروع می‌شود). اگر هیچ گروه دربرگیرنده‌ای وجود نداشته باشد، یا گروه‌های دربرگیرنده آن کلید/مقدار را تعریف نکرده باشند، از مقدار موجود در حوزه سراسری استفاده می‌شود. یک مثال کوچک می‌تواند به این صورت باشد: .PP .Vb 2 \& # مقدار سراسری اعمال‌شده به تمام همتاهایی که مقداری از خود ندارند. \& max\-connections: 5 \& \& # تعریف یک همتا. \& peer uunet { \& hostname: usenet1.uu.net \& } \& \& peer vixie { \& hostname: gw.home.vix.com \& max\-connections: 10 # بازنویسی مقدار سراسری. \& } \& \& # گروهی شامل دو همتا که می‌توانند اتصالات بیشتری نسبت به حالت عادی باز کنند. \& group fast\-sites { \& max\-connections: 15 \& \& # همتایی دیگر. مقدار max\-connections از حوزه گروه \& # fast\-sites استفاده می‌شود. \& peer data.ramona.vix.com { \& hostname: data.ramona.vix.com \& } \& \& peer bb.home.vix.com { \& hostname: bb.home.vix.com \& max\-connections: 20 # توان پردازشی بسیار بالایی دارد. \& } \& } .Ve .PP با توجه به فایل پیکربندی بالا، همتاهای تعریف‌شده مقادیر زیر را برای کلید \fImax-connections\fR خواهند داشت: .PP .Vb 4 \& uunet 5 \& vixie 10 \& data.ramona.vix.com 15 \& bb.home.vix.com 20 .Ve .SH "پارامترها (PARAMETERS)" .IX Header "PARAMETERS" کلیدهای زیر مجاز هستند: .IP \fIhold-time\fR 4 .IX Item "hold-time" این کلید نیازمند یک مقدار عدد صحیح مثبت است. این کلید زمان نگه‌داری قبل از قطع ارتباط را در صورتی که اتصال بیش از \fImax-connections\fR باشد، مشخص می‌کند. مقدار صفر نشان‌دهنده بستن فوری اتصال است. مقدار پیش‌فرض \f(CW\*(C`0\*(C'\fR است. .IP \fIhostname\fR 4 .IX Item "hostname" این کلید نیازمند یک مقدار رشته‌ای است. این مقدار فهرستی از نام‌های میزبان است که با کاما از یکدیگر جدا شده‌اند. نام میزبان یا یک نام دامنه کاملاً واجد شرایط (FQDN) است که به آدرس IPv4 یا IPv6 همتا ترجمه (resolve) می‌شود، یا آدرس IP چهاربخشی با نقطه (dotted-quad) برای IPv4 همتا، یا آدرس IP جداشده با دونقطه برای IPv6 همتا است. اگر این کلید در یک بلوک peer وجود نداشته باشد، نام میزبان به طور پیش‌فرض برچسب همان همتا در نظر گرفته می‌شود. .IP \fIidentd\fR 4 .IX Item "identd" این کلید نیازمند یک مقدار رشته‌ای است. در صورتی استفاده می‌شود که بخواهید نام کاربری همتا که از طریق identd(8) بازیابی می‌شود با رشته مشخص‌شده مطابقت داشته باشد. توجه داشته باشید که در حال حاضر \fBinnd\fR هیچ مهلت زمانی (timeout) برای فراخوانی‌های برگشتی \fBidentd\fR پیاده‌سازی نکرده است؛ بنابراین فعال کردن این گزینه ممکن است در صورتی که همتای دوردست در یک بازه زمانی معقول به فراخوانی‌های ident پاسخ ندهد، موجب معلق ماندن \fBinnd\fR شود. مقدار پیش‌فرض یک رشته خالی است، به این معنی که هیچ دیمن ident در نظر گرفته نمی‌شود. .IP \fIignore\fR 4 .IX Item "ignore" این کلید نیازمند یک مقدار بولی است. تنظیم این مدخل روی true باعث می‌شود \fBinnd\fR به پیشنهادهای همتای دوردست برای ارسال مقاله به شما پاسخ منفی دهد. مقدار پیش‌فرض false است. .Sp از نظر فنی‌تر، اگر \fIignore\fR برابر true باشد، \fBinnd\fR تمام شناسه‌های پیام (Message-ID) پیشنهادشده برای ارسال از طریق CHECK یا IHAVE توسط این همتا را رد خواهد کرد و طوری رفتار می‌کند که گویی از قبل آن مقاله را دارد. با این حال، مقاله‌ای کامل که توسط این همتا از طریق TAKETHIS ارسال شود (چون ابتدا با CHECK استعلام نگرفته است، یا کد پاسخ رد شدن از CHECK قبلی را نادیده گرفته است) همچنان پذیرفته خواهد شد. .IP \fIlist\fR 4 .IX Item "list" این کلید نیازمند یک مقدار بولی است. این کلید مشخص می‌کند که آیا یک همتا مجاز به صدور دستورات LIST هست یا خیر. مقدار پیش‌فرض true است، به این معنی که مجاز است. .IP \fImax-connections\fR 4 .IX Item "max-connections" این کلید نیازمند یک مقدار عدد صحیح مثبت است. این کلید حداکثر تعداد اتصالات مجاز را تعیین می‌کند. مقدار صفر تعداد نامحدودی از حداکثر اتصالات را مشخص می‌کند (\f(CW\*(C`unlimited\*(C'\fR یا \f(CW\*(C`none\*(C'\fR را می‌توان به عنوان مترادف استفاده کرد). مقدار پیش‌فرض \f(CW\*(C`0\*(C'\fR است. .IP \fIpassword\fR 4 .IX Item "password" این کلید نیازمند یک مقدار رشته‌ای است. در صورتی استفاده می‌شود که بخواهید همتا را ملزم کنید یک رمز عبور از طریق AUTHINFO USER/PASS ارائه دهد. مقدار پیش‌فرض یک رشته خالی است، به این معنی که هیچ رمز عبوری انتظار نمی‌رود. .Sp توجه داشته باشید که \fBinnd\fR هر نام کاربری ارائه‌شده توسط همتای دوردست را تا زمانی که رمز عبور مطابقت داشته باشد می‌پذیرد. (از آنجا که نام کاربری در پروتکل احراز هویت اجباری است، \fBinnd\fR انتظار دریافت آن را دارد اما کاری با آن انجام نمی‌دهد.) .IP \fIpatterns\fR 4 .IX Item "patterns" این کلید نیازمند یک مقدار رشته‌ای است. این فیلد فهرستی از گروه‌های خبری به سبک newsfeeds(5) است که باید از این میزبان پذیرفته شوند. مقدار پیش‌فرض رشته \f(CW\*(C`*\*(C'\fR است، به این معنی که تمام گروه‌ها پذیرفته می‌شوند. .IP \fIresendid\fR 4 .IX Item "resendid" این کلید نیازمند یک مقدار بولی است. هنگامی که روی true تنظیم شود، \fBinnd\fR با استفاده از کدهای \f(CW\*(C`431\*(C'\fR (پاسخ به CHECK، در حالت استریمینگ) یا \f(CW\*(C`436\*(C'\fR (پاسخ به IHAVE در حالت غیر استریمینگ)، از همتای دوردست می‌خواهد که بعداً ارسال مقاله پیشنهادی را دوباره امتحان کند (این اتفاق زمانی می‌افتد که همتای دیگری قبلاً پیشنهاد ارسال آن را داده، اما هنوز آن را نفرستاده است). هنگامی که روی false تنظیم شود، \fBinnd\fR هیچ تلاش مجددی را درخواست نمی‌کند (که در صورت عدم ارسال مقاله توسط همتای دیگر، منجر به از دست رفتن آن خواهد شد) و از کدهای \f(CW\*(C`438\*(C'\fR (پاسخ به CHECK) یا \f(CW\*(C`435\*(C'\fR (پاسخ به IHAVE) استفاده می‌کند. قابلیت به تعویق انداختن (deferral) می‌تواند برای همتاهایی که پیام‌ها را بلافاصله مجدداً ارسال می‌کنند، مانند \fBinnfeed\fR، مفید باشد. مقدار پیش‌فرض true است: از قابلیت به تعویق انداختن استفاده می‌شود تا همتا کدهای \f(CW\*(C`431\*(C'\fR و \f(CW\*(C`436\*(C'\fR را دریافت کرده و در نتیجه مقاله را بعداً دوباره ارسال کند. .IP \fIskip\fR 4 .IX Item "skip" این کلید نیازمند یک مقدار بولی است. تنظیم این مدخل باعث نادیده گرفته شدن این همتا می‌شود. مقدار پیش‌فرض false است. .IP \fIstreaming\fR 4 .IX Item "streaming" این کلید نیازمند یک مقدار بولی است. این کلید مشخص می‌کند که آیا دستورات استریمینگ (CHECK و TAKETHIS) از این همتا مجاز هستند یا خیر. مقدار پیش‌فرض true است. .IP \fIxbatch\fR 4 .IX Item "xbatch" این کلید نیازمند یک مقدار بولی است. این کلید مشخص می‌کند که آیا یک همتا مجاز به صدور دستورات XBATCH هست یا خیر. مقدار پیش‌فرض false است، به این معنی که مجاز نیست. .SH "تاریخچه (HISTORY)" .IX Header "HISTORY" نوشته‌شده توسط Fabien Tassin برای InterNetNews. تبدیل‌شده به POD توسط Julien Elie. .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" inn.conf(5), innd(8), libinn_uwildmat(3), newsfeeds(5).