نام (NAME)

incoming.conf - پیکربندی فیدهای خبری ورودی

در یک نگاه (IN A NUTSHELL)

فایل incoming.conf پیکربندی می‌کند که innd از کدام همتایان دوردست فیدهای NNTP را بپذیرد.

یک مدخل رایج برای مجاز کردن "news.server.com" به عنوان یک همتای ورودی به این صورت است:

peer news.server.com {
    hostname: "news.server.com"
}

درگاه (پورت) مورد استفاده برای فیدهای ورودی همان درگاهی است که innd روی آن گوش می‌دهد (معمولاً درگاه ۱۱۹ یا ۴۳۳).

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

پس از اعمال هرگونه تغییر، دستور "inncheck" را برای انجام بررسی‌های نحو پایه اجرا کرده و این فایل پیکربندی را با دستور زیر مجدداً بارگذاری کنید:

ctlinnd reload incoming.conf 'new peer'

توضیحات (DESCRIPTION)

فایل pathetc/incoming.conf از سه نوع مدخل تشکیل شده است: کلید/مقدار، همتا (peer) و گروه (group). کامنت‌ها از نویسه هش "#" تا انتهای خط امتداد دارند. خطوط خالی نادیده گرفته می‌شوند. تمامی مدخل‌های کلید/مقدار در هر نوع نباید تکراری باشند. مدخل‌های کلید/مقدار عبارتند از یک کلمه کلیدی که بلافاصله پس از آن یک دونقطه، حداقل یک فاصله خالی و یک مقدار قرار می‌گیرد. به عنوان مثال:

max-connections: 10

یک کلید معتبر نباید حاوی فاصله‌های خالی، دونقطه یا "#" باشد. سه نوع مختلف مقدار وجود دارد: اعداد صحیح، مقادیر بولی، و رشته‌ها. اعداد صحیح طبق انتظار هستند. یک مقدار بولی یکی از مقادیر "true"، "yes"، "on"، "false"، "no" یا "off" است (بزرگی و کوچکی حروف مهم نیست). مقدار رشته‌ای هر دنباله دیگری از نویسه‌ها است. اگر رشته نیاز به داشتن فاصله خالی داشته باشد، باید درون نقل‌قول دوتایی قرار گیرد.

مدخل‌های همتا (peer) به این صورت هستند:

peer <name> {
    # body
}

کلمه "peer" الزامی است. <name> یک برچسب برای این همتا است. این مقدار هر رشته‌ای است که به عنوان کلید معتبر باشد. بدنه مدخل همتا شامل تعدادی مدخل کلید/مقدار است.

مدخل‌های گروه (group) به این صورت هستند:

group <name> {
    # body
}

کلمه "group" الزامی است. <name> هر رشته‌ای است که به عنوان کلید معتبر باشد. بدنه مدخل گروه می‌تواند شامل هر تعداد از این سه نوع مدخل باشد. بنابراین جفت‌های کلید/مقدار را می‌توان درون یک گروه تعریف کرد، همتاها را می‌توان درون یک گروه قرار داد، و گروه‌های دیگر را نیز می‌توان درون یک گروه به صورت تودرتو جای داد. مدخل‌های کلید/مقدار که خارج از تمام مدخل‌های همتا و گروه تعریف می‌شوند، در حوزه سراسری (global scope) قرار دارند. مدخل‌های سراسری کلید/مقدار به عنوان پیش‌فرض برای همتاها عمل می‌کنند. هنگامی که innd به دنبال یک مقدار مشخص در یک مدخل همتا می‌گردد (برای مثال، حداکثر تعداد اتصالات مجاز)، اگر مقدار در مدخل همتا تعریف نشده باشد، گروه‌های دربرگیرنده برای یافتن آن مدخل بررسی می‌شوند (از نزدیک‌ترین گروه دربرگیرنده شروع می‌شود). اگر هیچ گروه دربرگیرنده‌ای وجود نداشته باشد، یا گروه‌های دربرگیرنده آن کلید/مقدار را تعریف نکرده باشند، از مقدار موجود در حوزه سراسری استفاده می‌شود. یک مثال کوچک می‌تواند به این صورت باشد:

# مقدار سراسری اعمال‌شده به تمام همتاهایی که مقداری از خود ندارند.
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    # توان پردازشی بسیار بالایی دارد.
   }
}

با توجه به فایل پیکربندی بالا، همتاهای تعریف‌شده مقادیر زیر را برای کلید max-connections خواهند داشت:

uunet                  5
vixie                 10
data.ramona.vix.com   15
bb.home.vix.com       20

پارامترها (PARAMETERS)

کلیدهای زیر مجاز هستند:

hold-time: این کلید نیازمند یک مقدار عدد صحیح مثبت است. این کلید زمان نگه‌داری قبل از قطع ارتباط را در صورتی که اتصال بیش از max-connections باشد، مشخص می‌کند. مقدار صفر نشان‌دهنده بستن فوری اتصال است. مقدار پیش‌فرض "0" است.
hostname: این کلید نیازمند یک مقدار رشته‌ای است. این مقدار فهرستی از نام‌های میزبان است که با کاما از یکدیگر جدا شده‌اند. نام میزبان یا یک نام دامنه کاملاً واجد شرایط (FQDN) است که به آدرس IPv4 یا IPv6 همتا ترجمه (resolve) می‌شود، یا آدرس IP چهاربخشی با نقطه (dotted-quad) برای IPv4 همتا، یا آدرس IP جداشده با دونقطه برای IPv6 همتا است. اگر این کلید در یک بلوک peer وجود نداشته باشد، نام میزبان به طور پیش‌فرض برچسب همان همتا در نظر گرفته می‌شود.
identd: این کلید نیازمند یک مقدار رشته‌ای است. در صورتی استفاده می‌شود که بخواهید نام کاربری همتا که از طریق identd(8) بازیابی می‌شود با رشته مشخص‌شده مطابقت داشته باشد. توجه داشته باشید که در حال حاضر innd هیچ مهلت زمانی (timeout) برای فراخوانی‌های برگشتی identd پیاده‌سازی نکرده است؛ بنابراین فعال کردن این گزینه ممکن است در صورتی که همتای دوردست در یک بازه زمانی معقول به فراخوانی‌های ident پاسخ ندهد، موجب معلق ماندن innd شود. مقدار پیش‌فرض یک رشته خالی است، به این معنی که هیچ دیمن ident در نظر گرفته نمی‌شود.
ignore: این کلید نیازمند یک مقدار بولی است. تنظیم این مدخل روی true باعث می‌شود innd به پیشنهادهای همتای دوردست برای ارسال مقاله به شما پاسخ منفی دهد. مقدار پیش‌فرض false است.
از نظر فنی‌تر، اگر ignore برابر true باشد، innd تمام شناسه‌های پیام (Message-ID) پیشنهادشده برای ارسال از طریق CHECK یا IHAVE توسط این همتا را رد خواهد کرد و طوری رفتار می‌کند که گویی از قبل آن مقاله را دارد. با این حال، مقاله‌ای کامل که توسط این همتا از طریق TAKETHIS ارسال شود (چون ابتدا با CHECK استعلام نگرفته است، یا کد پاسخ رد شدن از CHECK قبلی را نادیده گرفته است) همچنان پذیرفته خواهد شد.
list: این کلید نیازمند یک مقدار بولی است. این کلید مشخص می‌کند که آیا یک همتا مجاز به صدور دستورات LIST هست یا خیر. مقدار پیش‌فرض true است، به این معنی که مجاز است.
max-connections: این کلید نیازمند یک مقدار عدد صحیح مثبت است. این کلید حداکثر تعداد اتصالات مجاز را تعیین می‌کند. مقدار صفر تعداد نامحدودی از حداکثر اتصالات را مشخص می‌کند ("unlimited" یا "none" را می‌توان به عنوان مترادف استفاده کرد). مقدار پیش‌فرض "0" است.
password: این کلید نیازمند یک مقدار رشته‌ای است. در صورتی استفاده می‌شود که بخواهید همتا را ملزم کنید یک رمز عبور از طریق AUTHINFO USER/PASS ارائه دهد. مقدار پیش‌فرض یک رشته خالی است، به این معنی که هیچ رمز عبوری انتظار نمی‌رود.
توجه داشته باشید که innd هر نام کاربری ارائه‌شده توسط همتای دوردست را تا زمانی که رمز عبور مطابقت داشته باشد می‌پذیرد. (از آنجا که نام کاربری در پروتکل احراز هویت اجباری است، innd انتظار دریافت آن را دارد اما کاری با آن انجام نمی‌دهد.)
patterns: این کلید نیازمند یک مقدار رشته‌ای است. این فیلد فهرستی از گروه‌های خبری به سبک newsfeeds(5) است که باید از این میزبان پذیرفته شوند. مقدار پیش‌فرض رشته "*" است، به این معنی که تمام گروه‌ها پذیرفته می‌شوند.
resendid: این کلید نیازمند یک مقدار بولی است. هنگامی که روی true تنظیم شود، innd با استفاده از کدهای "431" (پاسخ به CHECK، در حالت استریمینگ) یا "436" (پاسخ به IHAVE در حالت غیر استریمینگ)، از همتای دوردست می‌خواهد که بعداً ارسال مقاله پیشنهادی را دوباره امتحان کند (این اتفاق زمانی می‌افتد که همتای دیگری قبلاً پیشنهاد ارسال آن را داده، اما هنوز آن را نفرستاده است). هنگامی که روی false تنظیم شود، innd هیچ تلاش مجددی را درخواست نمی‌کند (که در صورت عدم ارسال مقاله توسط همتای دیگر، منجر به از دست رفتن آن خواهد شد) و از کدهای "438" (پاسخ به CHECK) یا "435" (پاسخ به IHAVE) استفاده می‌کند. قابلیت به تعویق انداختن (deferral) می‌تواند برای همتاهایی که پیام‌ها را بلافاصله مجدداً ارسال می‌کنند، مانند innfeed، مفید باشد. مقدار پیش‌فرض true است: از قابلیت به تعویق انداختن استفاده می‌شود تا همتا کدهای "431" و "436" را دریافت کرده و در نتیجه مقاله را بعداً دوباره ارسال کند.
skip: این کلید نیازمند یک مقدار بولی است. تنظیم این مدخل باعث نادیده گرفته شدن این همتا می‌شود. مقدار پیش‌فرض false است.
streaming: این کلید نیازمند یک مقدار بولی است. این کلید مشخص می‌کند که آیا دستورات استریمینگ (CHECK و TAKETHIS) از این همتا مجاز هستند یا خیر. مقدار پیش‌فرض true است.
xbatch: این کلید نیازمند یک مقدار بولی است. این کلید مشخص می‌کند که آیا یک همتا مجاز به صدور دستورات XBATCH هست یا خیر. مقدار پیش‌فرض false است، به این معنی که مجاز نیست.

تاریخچه (HISTORY)

نوشته‌شده توسط Fabien Tassin <fta@sofaraway.org> برای InterNetNews. تبدیل‌شده به POD توسط Julien Elie.

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

inn.conf(5), innd(8), libinn_uwildmat(3), newsfeeds(5).