.\" -*- 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 "INNFEED.CONF 5" .TH INNFEED.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)" innfeed.conf \- فایل پیکربندی ارسال سریع فید مقالات در INN .SH "در یک نگاه (IN A NUTSHELL)" .IX Header "IN A NUTSHELL" فایل \fIinnfeed.conf\fR پیکربندی می‌کند که \fBinnfeed\fR فیدهای NNTP را به کدام همتاهای دوردست ارسال نماید. .PP یک مدخل متداول برای پارامتردهی \f(CW\*(C`news.server.com\*(C'\fR به عنوان یک فید خروجی به صورت زیر است: .PP .Vb 3 \& peer news.server.com { \& ip\-name: "news.server.com" \& } .Ve .PP اگر پورت استاندارد ۱۱۹ برای NNTP استفاده نمی‌شود، می‌توانید یک پورت جایگزین را به صورت زیر مشخص کنید: .PP .Vb 4 \& peer news.server.com { \& ip\-name: "news.server.com" \& port\-number: 433 \& } .Ve .PP پس از هرگونه تغییر، دستور \f(CW\*(C`inncheck\*(C'\fR را برای انجام بررسی‌های اولیه ساختار نحوی اجرا کنید و با دستور زیر این فایل پیکربندی را مجدداً بارگذاری نمایید که باعث می‌شود \fBinnd\fR نمونه جدیدی از \fBinnfeed\fR را بازتولید کند (با فرض اینکه \f(CW\*(C`innfeed!\*(C'\fR نام فید کانال مربوطه در \fInewsfeeds\fR باشد): .PP .Vb 1 \& ctlinnd flush innfeed! .Ve .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" فایل پیکربندی \fIinnfeed.conf\fR در \fIpathetc\fR برای کنترل برنامه innfeed(8) به کار می‌رود. این فایل ساختاری کاملاً آزاد دارد و از سه نوع مدخل تشکیل شده است: \fIkey\fR:\fIvalue\fR، \fIpeer\fR و \fIgroup\fR. توضیحات و یادداشت‌ها از نویسه هش (\f(CW\*(C`#\*(C'\fR) تا انتهای خط در نظر گرفته می‌شوند. .PP مدخل‌های \&\fIkey\fR:\fIvalue\fR یک کلمه کلیدی و یک مقدار هستند که با دونقطه (که خود می‌تواند با فاصله‌های خالی احاطه شود) از هم جدا شده‌اند. به عنوان مثال: .PP .Vb 1 \& max\-connections: 10 .Ve .PP یک \fIkey\fR مجاز با یک حرف شروع می‌شود و تنها شامل حروف، ارقام و نویسه‌های \f(CW\*(C`_\*(C'\fR و \f(CW\*(C`\-\*(C'\fR است. ۵ نوع مقدار مختلف وجود دارد: اعداد صحیح، اعداد اعشاری، نویسه‌ها، مقادیر بولی و رشته‌ها. .PP اعداد صحیح و اعشاری همان‌طور که انتظار می‌رود عمل می‌کنند، جز اینکه نمادهای علمی (نماها) در اعداد اعشاری پشتیبانی نمی‌شوند. مقدار بولی یکی از مقادیر \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 است (بزرگی و کوچکی حروف مهم نیست). مقدار نویسه (کاراکتر)، یک نویسه درون نقل‌قول تکی همانند تعریف زبان C است. مقدار رشته‌ای هر دنباله دیگری از نویسه‌ها است. اگر رشته نیاز به داشتن فاصله خالی داشته باشد، باید درون نقل‌قول دوتایی قرار گیرد و از همان ساختار زبان C برای جاسازی نویسه‌های غیرقابل‌چاپ استفاده می‌کند. .PP مدخل‌های همتا (Peer) به شکل زیر هستند: .PP .Vb 3 \& peer { \& # body ... \& } .Ve .PP کلمه \f(CW\*(C`peer\*(C'\fR الزامی است. \fI\fR همان نام سایت در فایل پیکربندی \fInewsfeeds\fR در INN است. بدنه یک مدخل همتا شامل تعدادی (احتمالاً صفر) از مدخل‌های \fIkey\fR:\fIvalue\fR است. .PP مدخل‌های گروه (Group) به شکل زیر هستند: .PP .Vb 3 \& group { \& # body ... \& } .Ve .PP کلمه \f(CW\*(C`group\*(C'\fR الزامی است. \fI\fR هر رشته معتبری به عنوان یک کلید است. بدنه یک مدخل گروه شامل هر تعداد از این سه نوع مدخل می‌باشد؛ بنابراین جفت‌های \fIkey\fR:\fIvalue\fR می‌توانند درون یک گروه تعریف شوند، همتاها می‌توانند درون یک گروه تو در تو باشند، و گروه‌های دیگر نیز می‌توانند درون یک گروه قرار گیرند. .PP مدخل‌های \&\fIkey\fR:\fIvalue\fR که خارج از تمام مدخل‌های \fIpeer\fR و \fIgroup\fR تعریف شده‌اند، دارای «دامنه سراسری» (global scope) هستند. مدخل‌های سراسری \fIkey\fR:\fIvalue\fR وجود دارند که به کل فرایند اعمال می‌شوند (به عنوان مثال مکان دایرکتوری فایل‌های بک‌لاگ)، و همچنین مدخل‌های سراسری \fIkey\fR:\fIvalue\fR دیگری وجود دارند که به عنوان پیش‌فرض‌های همتاها عمل می‌کنند. زمانی که \fBinnfeed\fR به دنبال مقدار مشخصی در یک مدخل همتا می‌گردد (مثلاً حداکثر تعداد اتصالات برای برقراری)، اگر آن مقدار در مدخل همتا تعریف نشده باشد، گروه‌های دربرگیرنده به دنبال آن مدخل بررسی می‌شوند (از نزدیک‌ترین گروه دربرگیرنده شروع می‌شود). اگر هیچ گروه دربرگیرنده‌ای وجود نداشته باشد، یا گروه‌های دربرگیرنده آن \fIkey\fR:\fIvalue\fR را تعریف نکرده باشند، مقدار موجود در دامنه سراسری استفاده می‌شود. .PP یک مثال کوچک می‌تواند به این صورت باشد: .PP .Vb 3 \& # Global value applied to all peers that have \& # no value of their own. \& max\-connections: 5 \& \& # A peer definition. "uunet" is the name used by innd \& # in the newsfeeds configuration file. \& peer uunet { \& ip\-name: usenet1.uu.net \& } \& \& peer vixie { \& ip\-name: gw.home.vix.com \& max\-connections: 10 # Override global value. \& } \& \& # A group of two peers which can handle more connections \& # than normal. \& group fast\-sites { \& max\-connections: 15 \& \& # Another peer. The "max\-connections" value from the \& # "fast\-sites" group scope is used. The "ip\-name" value \& # defaults to the peer\*(Aqs name. \& peer data.ramona.vix.com { \& } \& \& peer bb.home.vix.com { \& max\-connections: 20 # He can really cook. \& } \& } .Ve .PP با توجه به فایل پیکربندی بالا، همتاهای تعریف‌شده مقادیر زیر را برای کلید \fImax-connections\fR خواهند داشت: .PP .Vb 4 \& uunet 5 \& vixie 10 \& data.ramona.vix.com 15 \& bb.home.vix.com 20 .Ve .PP برنامه \&\fBinnfeed\fR جفت‌های \fIkey\fR:\fIvalue\fR را که به آن‌ها علاقه‌ای ندارد نادیده می‌گیرد. برخی از مقادیر فایل پیکربندی را می‌توان از طریق گزینه‌های خط فرمان تنظیم کرد که در این صورت آن تنظیمات بر تنظیمات درون فایل اولویت دارند. .PP فایل‌های پیکربندی را می‌توان با نحو زیر در سایر فایل‌های پیکربندی گنجاند: .PP .Vb 1 \& $INCLUDE filename .Ve .PP حداکثر عمق تو در تو بودن ۱۰ است. .PP برای مشاهده یک نمونه کامل‌تر از فایل پیکربندی، به فایل \fIinnfeed.conf\fR ارائه‌شده مراجعه کنید. .SH "مقادیر سراسری (GLOBAL VALUES)" .IX Header "GLOBAL VALUES" فهرست زیر تمام کلیدهایی را نشان می‌دهد که به کل فرایند اعمال می‌شوند. این کلیدها الزامی نیستند (در صورت نیاز از مقادیر پیش‌فرض تعبیه‌شده در زمان کامپایل استفاده می‌شود). .IP \fInews-spool\fR 4 .IX Item "news-spool" این کلید نیازمند یک مقدار مسیر است و مقدار پیش‌فرض آن \fIpatharticles\fR در \fIinn.conf\fR می‌باشد. این کلید مشخص می‌کند که ریشه یا بالای اسپول مقاله کجاست. این تنظیم معادل گزینه خط فرمان \fB\-a\fR است. .IP \fIinput-file\fR 4 .IX Item "input-file" این کلید نیازمند یک مقدار مسیر است. این کلید مسیر (نسبت به مقدار \fIbacklog-directory\fR) فایلی را مشخص می‌کند که باید در حالت funnel-file خوانده شود. این معادل دادن یک نام فایل به عنوان آرگومان در خط فرمان است (یعنی وجود آن نشان‌دهنده استفاده از حالت funnel-file نیز می‌باشد). .Sp پیش‌فرض این مقدار تنظیم‌نشده است؛ در این صورت \fBinnfeed\fR در حالت کانال یا دسته‌ای اجرا می‌شود. .IP \fIpid-file\fR 4 .IX Item "pid-file" این کلید نیازمند یک مقدار مسیر است و به طور پیش‌فرض \fIinnfeed.pid\fR می‌باشد. این کلید مسیر (نسبت به \fIpathrun\fR در \fIinn.conf\fR) ذخیره شناسه فرایند (PID) برنامه \fBinnfeed\fR را مشخص می‌کند. این تنظیم معادل گزینه خط فرمان \fB\-p\fR است. .IP \fIdebug-level\fR 4 .IX Item "debug-level" این کلید سطح اشکال‌زدایی را برای فرایند مشخص می‌کند. پیش‌فرض \f(CW\*(C`0\*(C'\fR است. یک عدد غیرصفر پیام‌های زیادی را به stderr یا به فایل گزارش مشخص‌شده در پیکربندی (یعنی \fIlog-file\fR) ارسال می‌کند. این تنظیم معادل گزینه خط فرمان \fB\-d\fR است. .Sp اگر فایلی به نام \fIinnfeed.debug\fR در دایرکتوری \fIpathlog\fR (همان‌طور که در \fIinn.conf\fR تنظیم شده) وجود داشته باشد، مقدار \fIdebug-level\fR به صورت خودکار روی \f(CW\*(C`1\*(C'\fR تنظیم می‌شود. این روشی ساده و کم‌هزینه برای جلوگیری از بارگذاری مجدد مداوم فایل \fInewsfeeds\fR هنگام اشکال‌زدایی است. توجه داشته باشید که پیام‌های اشکال‌زدایی همچنان به \fIlog-file\fR ارسال می‌شوند. .IP \fIdebug-shrinking\fR 4 .IX Item "debug-shrinking" این کلید نیازمند یک مقدار بولی است و پیش‌فرض آن false است (فایل اشکال‌زدایی اجازه دارد بدون محدودیت رشد کند). در صورت تنظیم روی true، هنگامی که اندازه این فایل به حد معینی برسد، کوتاه می‌شود. برای جزئیات بیشتر به \fIbacklog-limit\fR مراجعه کنید. .IP \fIinitial-sleep\fR 4 .IX Item "initial-sleep" این کلید نیازمند یک عدد صحیح مثبت است. مقدار پیش‌فرض \f(CW\*(C`2\*(C'\fR است. این کلید تعداد ثانیه‌هایی را مشخص می‌کند که \fBinnfeed\fR (یا یک انشعاب از آن) پس از شروع، پیش از آغاز باز کردن اتصالات به میزبان‌های راه دور باید منتظر بماند. .IP \fIfast-exit\fR 4 .IX Item "fast-exit" این کلید نیازمند یک مقدار بولی است و پیش‌فرض آن false است. در صورت تنظیم روی true، هنگامی که \fBinnfeed\fR یک سیگنال SIGTERM یا SIGQUIT دریافت می‌کند، شنوندگان خود را در سریع‌ترین زمان ممکن می‌بندد، حتی اگر به معنای نادیده گرفتن و انداختن مقالات باشد. .IP \fIuse-mmap\fR 4 .IX Item "use-mmap" این کلید نیازمند یک مقدار بولی است و پیش‌فرض آن true است. هنگامی که به جای نشانه‌های API ذخیره‌سازی، نام فایل‌ها به \fBinnfeed\fR داده می‌شود تا ارسال شوند (یک مورد استفاده نسبتاً نادر)، مشخص می‌کند که آیا در صورت کامپایل شدن \fBinnfeed\fR با پشتیبانی از mmap(2) باید از mmap استفاده شود یا خیر. اگر داده‌های مقاله روی دیسک در قالبی آماده برای NNTP نباشد (CR/LF در انتهای هر خط)، پس از mmap شدن، مقاله در حافظه خوانده شده و اصلاح می‌شود؛ بنابراین mmap هیچ اثر مثبتی ندارد (و بسته به سیستم شما احتمالاً اثر منفی هم دارد)؛ در نتیجه در چنین حالتی این مقدار باید \f(CW\*(C`false\*(C'\fR باشد که معادل گزینه خط فرمان \fB\-M\fR است. .IP \fIlog-file\fR 4 .IX Item "log-file" این کلید نیازمند یک مقدار مسیر است و پیش‌فرض آن \fIinnfeed.log\fR می‌باشد. این کلید مشخص می‌کند که هرگونه پیام گزارشی که امکان ارسال آن از طریق syslog(3) وجود نداشته است (مانند پیام‌های تولیدشده هنگام استفاده از مقدار مثبت برای \fIdebug-level\fR) به کجا ارسال شود. این تنظیم معادل گزینه خط فرمان \fB\-l\fR است. .Sp این مسیر نسبت به \fIpathlog\fR در \fIinn.conf\fR است. .IP \fIlog-time-format\fR 4 .IX Item "log-time-format" این کلید نیازمند یک رشته قالب مناسب برای strftime(3) است. این رشته برای پیام‌های ارسال‌شده از طریق syslog(3) و به \fIstatus-file\fR استفاده می‌شود. مقدار پیش‌فرض \f(CW\*(C`%a %b %d %H:%M:%S %Y\*(C'\fR است. .IP \fIbacklog-directory\fR 4 .IX Item "backlog-directory" این کلید نیازمند یک مقدار مسیر است و پیش‌فرض آن \fIinnfeed\fR می‌باشد. این کلید مشخص می‌کند که فرایند فعلی \fBinnfeed\fR کجا باید فایل‌های بک‌لاگ را ذخیره کند. این تنظیم معادل گزینه خط فرمان \fB\-b\fR است. .Sp این مسیر نسبت به \fIpathspool\fR در \fIinn.conf\fR است. .IP \fIbacklog-highwater\fR 4 .IX Item "backlog-highwater" این کلید نیازمند یک عدد صحیح مثبت است و مقدار پیش‌فرض آن \f(CW\*(C`5\*(C'\fR می‌باشد. این کلید مشخص می‌کند چه تعداد مقاله باید در صف فایل بک‌لاگ نگه‌داری شود قبل از اینکه نوشتن مدخل‌های جدید روی دیسک آغاز گردد. .IP \fIbacklog-ckpt-period\fR 4 .IX Item "backlog-ckpt-period" این کلید نیازمند یک عدد صحیح مثبت است و پیش‌فرض آن \f(CW\*(C`30\*(C'\fR می‌باشد. این کلید مشخص می‌کند چند ثانیه بین نقاط بازرسی و بازنویسی‌های فایل ورودی بک‌لاگ سپری شود. عدد خیلی کوچک به معنای دسترسی مکرر به دیسک است؛ عدد خیلی بزرگ یعنی پس از یک خرابی (crash)، \fBinnfeed\fR مقالات پردازش‌شده بیشتری را نسبت به آنچه لازم است مجدداً پیشنهاد می‌دهد. .IP \fIbacklog-newfile-period\fR 4 .IX Item "backlog-newfile-period" این کلید نیازمند یک عدد صحیح مثبت است و پیش‌فرض آن \f(CW\*(C`600\*(C'\fR می‌باشد. این کلید مشخص می‌کند چند ثانیه قبل از هر بررسی برای فایل‌های بک‌لاگ تولیدشده به صورت بیرونی (که باید برداشته و پردازش شوند) سپری شود. .IP \fIbacklog-rotate-period\fR 4 .IX Item "backlog-rotate-period" این کلید نیازمند یک عدد صحیح مثبت است و پیش‌فرض آن \f(CW\*(C`60\*(C'\fR می‌باشد. این کلید مشخص می‌کند چند ثانیه سپری شود پیش از آنکه \fBinnfeed\fR یک فایل بک‌لاگ ایجادشده به صورت بیرونی را به فایل بک‌لاگ ورودی منتقل کند (اگر به میزان \fIbacklog-newfile-period\fR ثانیه گذشته باشد) یا در غیاب چنین فایلی، فایل بک‌لاگ خروجی را به فایل بک‌لاگ ورودی انتقال دهد. اگر فایل بک‌لاگ ورودی خالی نباشد هیچ انتقالی رخ نمی‌دهد. .IP \fIdns-retry\fR 4 .IX Item "dns-retry" این کلید نیازمند یک عدد صحیح مثبت است و پیش‌فرض آن \f(CW\*(C`900\*(C'\fR می‌باشد. این کلید تعداد ثانیه‌های بین تلاش‌ها برای جستجوی مجدد اطلاعات میزبانی را که قبلاً در تفکیک نام (resolve) ناموفق بوده است، مشخص می‌کند. .IP \fIdns-expire\fR 4 .IX Item "dns-expire" این کلید نیازمند یک عدد صحیح مثبت است و پیش‌فرض آن \f(CW\*(C`86400\*(C'\fR می‌باشد. این کلید تعداد ثانیه‌های بین تازه‌سازی‌های ترجمه نام DNS به آدرس را مشخص می‌کند. این برای آن است که فرایندهای با اجرای طولانی‌مدت، در صورت تغییر آدرس‌های IP همتا، با داده‌های منقضی‌شده و کهنه روبرو نشوند. .IP \fIgen-html\fR 4 .IX Item "gen-html" این کلید نیازمند یک مقدار بولی است و پیش‌فرض آن false است. این کلید مشخص می‌کند که آیا \fIstatus-file\fR باید به صورت HTML تبدیل و تولید شود یا خیر. .IP \fIstatus-file\fR 4 .IX Item "status-file" این کلید نیازمند یک مقدار مسیر است و پیش‌فرض آن \fIinnfeed.status\fR می‌باشد. می‌توان از یک مسیر مطلق نیز استفاده کرد. این کلید مسیری را مشخص می‌کند (نسبت به \fIpathhttp\fR هنگامی که \fIgen-html\fR برابر با true است؛ در غیر این صورت نسبت به \fIpathlog\fR همان‌طور که در \fIinn.conf\fR آمده) که وضعیت دوره‌ای فرایند \fBinnfeed\fR باید در آن ذخیره شود. این تنظیم معادل گزینه خط فرمان \fB\-S\fR است. .IP \fIconnection-stats\fR 4 .IX Item "connection-stats" این کلید نیازمند یک مقدار بولی است و پیش‌فرض آن false است. اگر مقدار true باشد، هر زمان که آمار انتقال برای یک همتا ثبت می‌شود، هر اتصال فعال نیز آمار اختصاصی خود را ثبت می‌کند. این تنظیم معادل گزینه خط فرمان \&\fB\-z\fR است. .IP \fIhost-queue-highwater\fR 4 .IX Item "host-queue-highwater" این کلید نیازمند یک عدد صحیح مثبت است و پیش‌فرض آن \f(CW\*(C`10\*(C'\fR می‌باشد. این کلید مشخص می‌کند چه تعداد مقاله به صورت داخلی برای یک همتا نگه‌داری شود، پیش از آنکه مقالات جدید باعث شوند اطلاعات مقاله به فایل بک‌لاگ منتقل گردد. .IP \fIstats-period\fR 4 .IX Item "stats-period" این کلید نیازمند یک عدد صحیح مثبت است و پیش‌فرض آن \f(CW\*(C`600\*(C'\fR می‌باشد. این کلید مشخص می‌کند \fBinnfeed\fR چند ثانیه بین تولید آمار نرخ انتقال صبر کند. .IP \fIstats-reset\fR 4 .IX Item "stats-reset" این کلید نیازمند یک عدد صحیح مثبت است و پیش‌فرض آن \f(CW\*(C`43200\*(C'\fR می‌باشد. این کلید مشخص می‌کند \fBinnfeed\fR چند ثانیه قبل از صفر کردن مجدد همه شمارنده‌های انتقال داخلی (پس از یک بار ثبت نهایی در گزارش) صبر کند. این به این دلیل است که یک فرایند \fBinnfeed\fR که بیش از یک روز در حال اجرا است آمارهای «نهایی» تولید کند تا توسط اسکریپت‌های پردازش فایل‌های گزارش برداشته شوند. .IP \fIinitial-reconnect-time\fR 4 .IX Item "initial-reconnect-time" این کلید نیازمند یک عدد صحیح مثبت است و پیش‌فرض آن \f(CW\*(C`30\*(C'\fR می‌باشد. این کلید مشخص می‌کند پس از قطع یا شکست در اتصال، ابتدا چند ثانیه قبل از تلاش مجدد برای اتصال مجدد صبر شود. اگر تلاش بعدی نیز ناموفق باشد، زمان اتصال مجدد تقریباً دو برابر می‌شود تا زمانی که اتصال برقرار شود یا به \fImax-reconnect-time\fR برسد. .IP \fImax-reconnect-time\fR 4 .IX Item "max-reconnect-time" این کلید نیازمند یک مقدار عدد صحیح است و پیش‌فرض آن \f(CW\*(C`3600\*(C'\fR می‌باشد. این کلید حداکثر تعداد ثانیه‌ها برای انتظار بین تلاش‌ها جهت اتصال مجدد به یک همتا را تعیین می‌کند. مقدار اولیه برای تلاش‌های اتصال مجدد توسط \&\fIinitial-reconnect-time\fR مشخص می‌شود و پس از هر شکست دو برابر می‌گردد تا به این مقدار برسد. .IP \fIstdio-fdmax\fR 4 .IX Item "stdio-fdmax" این کلید نیازمند یک عدد صحیح غیرمنفی است و مقدار پیش‌فرض آن \f(CW\*(C`0\*(C'\fR می‌باشد. اگر مقدار بزرگ‌تر از صفر باشد، هرگاه توصیف‌گر فایل سوکت شبکه ایجاد شود و مقداری \fIکمتر از\fR این مقدار داشته باشد، توصیف‌گر فایل با دستور dup کپی می‌شود تا مقدار آن بزرگ‌تر از این مقدار گردد. این کار برای آزاد گذاشتن توصیف‌گرهای فایل با شماره‌های پایین‌تر برای stdio است. سیستم‌های خاصی، به ویژه سیستم‌های Sun، به این مورد نیاز دارند. SunOS 4.1.x معمولاً به مقدار \f(CW\*(C`128\*(C'\fR نیاز دارد؛ نسخه‌های ۳۲ بیتی Solaris یا برنامه‌های ۳۲ بیتی که روی Solaris ۶۴ بیتی اجرا می‌شوند، و همچنین نسخه‌های ۶۴ بیتی Solaris قبل از 11.0 به مقدار \f(CW\*(C`256\*(C'\fR نیاز دارند. برای جزئیات بیشتر به مستندات سولاریس درباره توصیف‌گرهای فایل مراجعه کنید. در صورتی که این مورد مشخص نشده باشد، پیش‌فرض \f(CW\*(C`0\*(C'\fR است. .SS "کلیدهای ویژه برای \fBimapfeed\fP (Special keys for imapfeed)" .IX Subsection "Special keys for imapfeed" کلیدهای زیر همراه با \fBimapfeed\fR برای احراز هویت در یک میزبان راه دور استفاده می‌شوند. چندین پارامتر ممکن است در دامنه سراسری گنجانده شوند: .IP \fIdeliver-authname\fR 4 .IX Item "deliver-authname" نام احراز هویت (authname) هویتی است که می‌خواهید به عنوان آن احراز هویت شوید. .IP \fIdeliver-password\fR 4 .IX Item "deliver-password" این گذرواژه مناسب برای authname است. .IP \fIdeliver-username\fR 4 .IX Item "deliver-username" نام کاربری (username) کسی است که می‌خواهید «نقش» او را ایفا کنید؛ یعنی کسی که در واقع قرار است از سرور استفاده کند. .IP \fIdeliver-realm\fR 4 .IX Item "deliver-realm" در این مورد، «قلمرو» (realm) همان قلمرویی است که authname مشخص‌شده در آن معتبر است. در حال حاضر این مورد فقط توسط سازوکار SASL مدل DIGEST\-MD5 مورد نیاز است. .IP \fIdeliver-rcpt-to\fR 4 .IX Item "deliver-rcpt-to" یک رشته قالب با سبک printf(3) برای ایجاد آدرس گیرنده پاکت (envelope recipient). الگو باید الزاماً شامل یک مشخص‌کننده رشته منفرد باشد که با گروه خبری جدید جایگزین می‌شود (مثلاً \f(CW\*(C`bb+%s\*(C'\fR). مقدار پیش‌فرض \f(CW\*(C`+%s\*(C'\fR است. .IP \fIdeliver-to-header\fR 4 .IX Item "deliver-to-header" یک رشته قالب اختیاری با سبک printf(3) برای ایجاد یک فیلد هدر To که باید در ابتدای مقاله قرار گیرد. الگو باید الزاماً شامل یک مشخص‌کننده رشته منفرد باشد که با گروه خبری جدید جایگزین می‌شود (مثلاً \f(CW\*(C`post+%s@domain\*(C'\fR). در صورت مشخص نشدن، فیلد هدر To اضافه نخواهد شد. .SH "پیش‌فرض‌های سراسری همتا (GLOBAL PEER DEFAULTS)" .IX Header "GLOBAL PEER DEFAULTS" تمام جفت‌های \fIkey\fR:\fIvalue\fR ذکرشده در این بخش را می‌توان در دامنه سراسری مشخص کرد. همچنین می‌توان آن‌ها را در داخل تعریف یک گروه یا همتا نیز تعیین نمود. توجه داشته باشید که وقتی همتاها به صورت پویا اضافه می‌شوند (یعنی زمانی که \fBinnfeed\fR مقاله‌ای برای یک همتای نامشخص دریافت می‌کند)، سایت همتا را با استفاده از پارامترهای مشخص‌شده در دامنه سراسری اضافه خواهد کرد. .SS "کلیدهای الزامی (Required keys)" .IX Subsection "Required keys" در حال حاضر هیچ کلیدی الزامی نیست. همه آن‌ها در صورت عدم وجود در فایل پیکربندی، دارای مقدار پیش‌فرض هستند. .SS "کلیدهای اختیاری (Optional keys)" .IX Subsection "Optional keys" کلیدهای زیر اختیاری هستند: .IP \fIarticle-timeout\fR 4 .IX Item "article-timeout" این کلید نیازمند یک مقدار عدد صحیح غیرمنفی است. مقدار پیش‌فرض آن \f(CW\*(C`600\*(C'\fR می‌باشد. اگر تا این تعداد ثانیه نیازی به ارسال مقاله به همتا نباشد، همتا بیکار تلقی شده و تمام اتصالات فعال آن قطع می‌شوند. .IP \fIresponse-timeout\fR 4 .IX Item "response-timeout" این کلید نیازمند یک مقدار عدد صحیح غیرمنفی است. مقدار پیش‌فرض آن \f(CW\*(C`300\*(C'\fR می‌باشد. این کلید حداکثر زمان انتظار برای دریافت پاسخ از همتا پس از صدور یک دستور را مشخص می‌کند. .IP \fIinitial-connections\fR 4 .IX Item "initial-connections" این کلید نیازمند یک مقدار عدد صحیح غیرمنفی است. مقدار پیش‌فرض آن \f(CW\*(C`1\*(C'\fR می‌باشد. این کلید تعداد اتصالاتی را که باید بلافاصله هنگام راه‌اندازی پیوند با یک همتا برقرار شوند، مشخص می‌کند. مقدار \f(CW\*(C`0\*(C'\fR به این معنی است که تا زمانی که نیازی به ارسال مقاله نباشد، هیچ اتصالی ایجاد نخواهد شد. .IP \fImax-connections\fR 4 .IX Item "max-connections" این کلید نیازمند یک عدد صحیح مثبت است. مقدار پیش‌فرض \f(CW\*(C`2\*(C'\fR است، اما در صورت نیاز یا برای فیدهای بزرگ می‌توان آن را افزایش داد. این کلید حداکثر تعداد اتصالات موازی به همتا را مشخص می‌کند. مقدار \f(CW\*(C`0\*(C'\fR حداکثر تعداد اتصالات نامحدود را مشخص می‌کند. به‌طور کلی، استفاده از تعداد نامحدود اتصالات توصیه نمی‌شود. هرگز \fImax-connections\fR را هنگام تنظیم \fIdynamic-method\fR روی 0، برابر با صفر قرار ندهید، زیرا این کار باعث اشباع میزبان‌های همتا با اتصالات بیش از حد می‌شود. .IP \fIclose-period\fR 4 .IX Item "close-period" این کلید نیازمند یک مقدار عدد صحیح مثبت است و پیش‌فرض آن \f(CW\*(C`86400\*(C'\fR می‌باشد. این مقدار حداکثر تعداد ثانیه‌هایی است که یک اتصال باید باز نگه داشته شود. برخی از سرورهای NNTP با باز ماندن طولانی‌مدت اتصالات عملکرد خوبی ندارند. .IP \fIdynamic-method\fR 4 .IX Item "dynamic-method" این کلید نیازمند یک عدد صحیح بین 0 تا 3 است. مقدار پیش‌فرض آن \f(CW\*(C`3\*(C'\fR می‌باشد. این کلید چگونگی برقراری اتصالات را تا سقف مشخص‌شده توسط \fImax-connections\fR کنترل می‌کند. به‌طور کلی (و به‌ویژه با \fIdynamic-method\fR برابر با 0)، یک اتصال جدید زمانی باز می‌شود که تعداد فعلی اتصالات کمتر از \fImax-connections\fR باشد و مقاله‌ای برای ارسال وجود داشته باشد در حالی که هیچ اتصال فعلی بیکار نباشد. بدون محدودیت بیشتر (یعنی استفاده از \fIdynamic-method\fR برابر با 0)، در عمل این بدان معناست که اتصالات به اندازه \fImax-connections\fR در حین ارسال مقالات برقرار می‌شوند. استفاده از سایر تنظیمات \fIdynamic-method\fR محدودیت بیشتری بر تعداد اتصالات بازشده زیر سقف تعیین‌شده توسط \fImax-connections\fR اعمال می‌کند. این محدودیت بسته به مقدار \fIdynamic-method\fR به روش‌های متفاوتی محاسبه می‌شود. .Sp کاربران باید توجه داشته باشند که افزودن اتصالات بیشتر همیشه سودمند نیست \-\- صرفاً به این دلیل که باز کردن دو برابری اتصالات منجر به افزایش درصد کمی از مقالات پذیرفته‌شده توسط همتای راه دور می‌شود، ممکن است هزینه منابع قابل‌توجهی چه به صورت محلی و چه در سایت راه دور داشته باشد، در حالی که سایت راه دور ممکن است به خوبی مقالات اضافی ارسال‌شده را از همتای دیگری کسری از ثانیه بعد دریافت کند. باز کردن تعداد زیادی اتصال، رفتاری ضد اجتماعی تلقی می‌شود. .Sp معانی تنظیمات مختلف عبارتند از: .RS 4 .IP "\fB0\fR (no method)" 2 .IX Item "0 (no method)" افزایش اتصالات تا سقف \fImax-connections\fR بدون محدودیت است. .IP "\fB1\fR (maximize articles per second)" 2 .IX Item "1 (maximize articles per second)" اتصالات افزایش (تا سقف \fImax-connections\fR) و کاهش می‌یابند تا تعداد مقالات ارسالی در ثانیه به حداکثر برسد، در حالی که کمترین اتصالات ممکن برای این کار استفاده شود. .IP "\fB2\fR (set target queue length)" 2 .IX Item "2 (set target queue length)" اتصالات افزایش (تا سقف \fImax-connections\fR) و کاهش می‌یابند تا صف مقالاتی که باید ارسال شوند در محدوده تعیین‌شده توسط \fIdynamic-backlog-low\fR و \fIdynamic-backlog-high\fR باقی بماند، در حالی که از حداقل منابع ممکن استفاده شود. از آنجا که صف تمایل به پر شدن دارد اگر سایت نتواند همگام بماند، این روش تضمین می‌کند که حداکثر تعداد مقالات با استفاده از حداقل تعداد اتصالات به همتا ارائه شود. .IP "\fB3\fR (combination)" 2 .IX Item "3 (combination)" این روش از ترکیبی از روش‌های ۱ و ۲ بالا استفاده می‌کند. برای سایت‌هایی که درصد زیادی از مقالات را می‌پذیرند، از روش ۲ استفاده می‌شود تا اطمینان حاصل شود که تا حد امکان فید کاملی به آن‌ها ارائه می‌شود. برای سایت‌هایی که درصد کمی از مقالات را می‌پذیرند، از روش ۱ استفاده می‌شود تا مصرف منابع راه دور به حداقل برسد. برای سایت‌های میانی، از یک ترکیب مناسب استفاده می‌شود. .RE .RS 4 .RE .IP \fIdynamic-backlog-low\fR 4 .IX Item "dynamic-backlog-low" این کلید نیازمند یک مقدار اعشاری بین 0 تا 100 است. این مقدار نشان‌دهنده حد پایین (به درصد) برای صف میزبان است. اگر صف میزبان هنگام استفاده از \fIdynamic-method\fR ۲ یا ۳ به زیر این مقدار افت کند و ۲ یا تعداد بیشتری اتصال باز باشد، \fBinnfeed\fR تلاش خواهد کرد تا اتصالات به میزبان را کاهش داده و قطع کند. یک فیلتر پاسخ ضربه نامحدود (IIR) روی این مقدار اعمال می‌شود تا از نوسان سریع اتصال جلوگیری شود (به \fIdynamic-filter\fR مراجعه کنید). مقدار پیش‌فرض \f(CW\*(C`20.0\*(C'\fR است. این مقدار باید کوچک‌تر از \fIdynamic-backlog-high\fR باشد. .IP \fIdynamic-backlog-high\fR 4 .IX Item "dynamic-backlog-high" این کلید نیازمند یک مقدار اعشاری بین 0 تا 100 است. این مقدار نشان‌دهنده حد بالا (به درصد) برای صف میزبان است. اگر صف میزبان هنگام استفاده از \fIdynamic-method\fR ۲ یا ۳ از این مقدار فراتر رود و تعداد اتصالات باز به میزبان کمتر از \fImax-connections\fR باشد، \fBinnfeed\fR تلاش خواهد کرد اتصالات بیشتری را به میزبان باز کند. یک فیلتر پاسخ ضربه نامحدود (IIR) روی این مقدار اعمال می‌شود تا از نوسان سریع اتصال جلوگیری کند (به \fIdynamic-filter\fR مراجعه کنید). مقدار پیش‌فرض \f(CW\*(C`50.0\*(C'\fR است. این مقدار باید بزرگ‌تر از \fIdynamic-backlog-low\fR باشد. .IP \fIdynamic-backlog-filter\fR 4 .IX Item "dynamic-backlog-filter" این کلید نیازمند یک مقدار اعشاری بین 0 تا 1 است. این مقدار ضریب فیلتر استفاده‌شده توسط فیلتر پاسخ ضربه نامحدود (IIR) را نشان می‌دهد که برای پیاده‌سازی \fIdynamic-method\fR ۲ و ۳ استفاده می‌شود. مقدار پیش‌فرض این فیلتر \f(CW\*(C`0.7\*(C'\fR است که ثابت زمانی معادل با مقالات 1/(1\-0.7) را ارائه می‌دهد. مقادیر بالاتر منجر به پاسخ کندتر به تغییرات پر شدن صف می‌شوند و مقادیر پایین‌تر باعث پاسخ سریع‌تر خواهند شد. .IP \fImax-queue-size\fR 4 .IX Item "max-queue-size" این کلید نیازمند یک عدد صحیح مثبت است. مقدار پیش‌فرض آن \f(CW\*(C`20\*(C'\fR می‌باشد. این کلید حداکثر تعداد مقالاتی را مشخص می‌کند که هنگام استفاده از ارسال جریانی به یک همتا در یک زمان پردازش می‌شوند. اعداد بزرگ‌تر به معنای مصرف حافظه بیشتر است زیرا مقالات معمولاً به حافظه کشیده می‌شوند (به توضیحات \fIuse-mmap\fR مراجعه کنید). .IP \fIstreaming\fR 4 .IX Item "streaming" این کلید نیازمند یک مقدار بولی است. مقدار پیش‌فرض آن true است. این کلید مشخص می‌کند که آیا از دستورات جریانی برای انتقال مقالات به همتاها استفاده شود یا خیر. .IP \fIno-check-high\fR 4 .IX Item "no-check-high" این کلید نیازمند یک عدد اعشاری در محدوده [0.0, 100.0] است. هنگام ارسال با دستورات جریانی، \&\fBinnfeed\fR بهینه‌سازی‌ای به نام «حالت no-CHECK» را امتحان می‌کند. این کار شامل \fIعدم\fR پرسش از همتا مبنی بر اینکه آیا مقاله را می‌خواهد و ارسال مستقیم آن است. این بهینه‌سازی زمانی رخ می‌دهد که درصد مقالات پذیرفته‌شده توسط همتا از این عدد بیشتر شود. اگر این مقدار روی \f(CW\*(C`100.0\*(C'\fR تنظیم شود، حالت no-CHECK عملاً خاموش می‌شود زیرا درصد هرگز نمی‌تواند بالاتر از 100.0 برود. اگر این مقدار خیلی کوچک باشد، تعداد مقالاتی که همتا رد می‌کند افزایش می‌یابد (و پهنای باند شما هدر خواهد رفت). مقدار پیش‌فرض \f(CW\*(C`95.0\*(C'\fR معمولاً بسیار خوب عمل می‌کند. .IP \fIno-check-low\fR 4 .IX Item "no-check-low" این کلید نیازمند یک عدد اعشاری در محدوده [0.0, 100.0] است و باید کوچک‌تر از مقدار \fIno-check-high\fR باشد. هنگام اجرا در حالت no-CHECK طبق توضیحات بالا، اگر درصد مقالات پذیرفته‌شده توسط سرور راه دور به زیر این عدد سقوط کند، بهینه‌سازی no-CHECK غیرفعال می‌شود تا زمانی که این درصد دوباره بالاتر از مقدار \&\fIno-check-high\fR برود. اگر تفاوت کمی بین این مقدار و مقدار \fIno-check-high\fR وجود داشته باشد (کمتر از حدود 5.0)، ممکن است \fBinnfeed\fR به طور مکرر وارد حالت no-CHECK شده و از آن خارج شود. اگر تفاوت خیلی زیاد باشد، خروج از حالت no-CHECK در زمان نیاز دشوارتر خواهد شد (و باعث هدر رفتن پهنای باند می‌شود). نگه داشتن این مقدار بین 5.0 تا 10.0 واحد کمتر از \&\fBno-check-high\fR معمولاً به خوبی پاسخ می‌دهد. مقدار پیش‌فرض \f(CW\*(C`90.0\*(C'\fR است. .IP \fIno-check-filter\fR 4 .IX Item "no-check-filter" این یک مقدار اعشاری است که نشان‌دهنده ثابت زمانی بر حسب مقاله است که محاسبات CHECK/no\-CHECK در طول آن انجام می‌شود. مقدار پیش‌فرض \&\f(CW\*(C`50.0\*(C'\fR است که یک فیلتر پاسخ ضربه نامحدود (IIR) با ثابت زمانی ۵۰ را پیاده‌سازی می‌کند. این تقریباً معادل تصمیم‌گیری در مورد وضعیت در طول ۵۰ مقاله قبلی است. عدد بالاتر منجر به پاسخ کندتر به تغییرات درصدهای پذیرش مقالات می‌شود؛ عدد پایین‌تر به پاسخ سریع‌تر می‌انجامد. .IP \fIport-number\fR 4 .IX Item "port-number" این کلید نیازمند یک عدد صحیح مثبت است. این کلید شماره پورت TCP/IP را برای استفاده هنگام اتصال به سیستم راه دور مشخص می‌کند. معمولاً از پورت شماره ۱۱۹ استفاده می‌شود که مقدار پیش‌فرض است. .IP \fIforce\-ipv4\fR 4 .IX Item "force-ipv4" این کلید نیازمند یک مقدار بولی است. به صورت پیش‌فرض روی false تنظیم شده است. تنظیم آن روی true مشابه تنظیم \fIbindaddress6\fR روی \f(CW\*(C`none\*(C'\fR و حذف \fIbindaddress\fR از حالت \f(CW\*(C`none\*(C'\fR (در صورت تنظیم بودن) است. .IP \fIdrop-deferred\fR 4 .IX Item "drop-deferred" این کلید نیازمند یک مقدار بولی است. به صورت پیش‌فرض روی false تنظیم شده است. هنگامی که روی true تنظیم شود و یک همتا با کد 431 یا 436 (بعداً دوباره تلاش کنید) پاسخ دهد، \&\fBinnfeed\fR صرفاً مقاله را رها می‌کند و تلاشی برای ارسال مجدد آن نمی‌کند. این مورد برای برخی از همتاها که مقالات را به مدت طولانی به تعویق می‌اندازند مفید است تا از تلاش مکرر \fBinnfeed\fR برای ارائه چندباره همان مقاله جلوگیری شود. .IP \fImin-queue-connection\fR 4 .IX Item "min-queue-connection" این کلید نیازمند یک مقدار بولی است. به صورت پیش‌فرض روی false تنظیم شده است. وقتی روی true تنظیم شود، \fBinnfeed\fR تلاش خواهد کرد از اتصالی با کمترین اندازه صف (یا اولین اتصال خالی) استفاده کند. اگر این کلید روی true تنظیم شده باشد، توصیه می‌شود که \fIdynamic-method\fR روی \f(CW\*(C`0\*(C'\fR تنظیم شود. این امر امکان انتشار مقاله با کمترین تأخیر را فراهم می‌سازد. .IP \fIno-backlog\fR 4 .IX Item "no-backlog" این کلید نیازمند یک مقدار بولی است. این کلید مشخص می‌کند که آیا اسپولینگ باید فعال باشد (false، پیش‌فرض) یا غیرفعال (true). توجه داشته باشید که وقتی \&\fIno-backlog\fR تنظیم شود، مقالاتی که به عنوان اسپول‌شده گزارش می‌شوند، در واقع به آرامی و بدون اعلام دور انداخته می‌شوند. .IP \fIbacklog-limit\fR 4 .IX Item "backlog-limit" این کلید نیازمند یک عدد صحیح غیرمنفی است. اگر این عدد \f(CW\*(C`0\*(C'\fR (پیش‌فرض) باشد، در زمانی که همتا قادر به هماهنگی با جریان مقالات نیست، فایل‌های بک‌لاگ اجازه دارند بدون محدودیت رشد کنند. اگر این عدد بزرگ‌تر از صفر باشد، اندازه‌ای (به بایت) را مشخص می‌کند که وقتی فایل بک‌لاگ به حد معینی رسید باید به آن اندازه کوتاه شود. این حد بستگی به این دارد که از \fIbacklog-factor\fR یا \fIbacklog-limit-highwater\fR استفاده شود. .Sp این پارامتر همچنین برای فایل اشکال‌زدایی زمانی که \fIdebug-shrinking\fR روی true تنظیم شده اعمال می‌شود و همان اثری را روی این فایل دارد که روی فایل‌های بک‌لاگ می‌گذارد. .IP \fIbacklog-factor\fR 4 .IX Item "backlog-factor" این کلید نیازمند یک مقدار اعشاری است که باید بزرگ‌تر از 1.0 باشد. این کلید همراه با کلید همتای \fIbacklog-limit\fR استفاده می‌شود. اگر \fIbacklog-limit\fR مقداری بزرگ‌تر از صفر داشته باشد، زمانی که اندازه فایل بک‌لاگ از مقدار حاصل‌ضرب \fIbacklog-limit\fR * \fIbacklog-factor\fR بزرگ‌تر شود، فایل بک‌لاگ به اندازه \fIbacklog-limit\fR کوتاه خواهد شد. .Sp به عنوان مثال، اگر \fIbacklog-limit\fR دارای مقدار \f(CW\*(C`1000000\*(C'\fR و \&\fIbacklog-factor\fR دارای مقدار \f(CW\*(C`2.0\*(C'\fR باشد، زمانی که حجم فایل بک‌لاگ به بیش از 2000000 بایت برسد، به 1000000 بایت کوتاه خواهد شد. قسمت ابتدایی فایل حذف می‌شود و این هرس کردن در مرز خطوط اتفاق می‌افتد؛ بنابراین ممکن است اندازه نهایی اندکی کمتر از این عدد باشد. اگر \fIbacklog-limit-highwater\fR نیز تعریف شده باشد، \fIbacklog-factor\fR اولویت خواهد داشت. مقدار پیش‌فرض \fIbacklog-factor\fR برابر با \f(CW\*(C`1.1\*(C'\fR است. .Sp این پارامتر همچنین برای فایل اشکال‌زدایی در صورتی که \fIdebug-shrinking\fR روی true تنظیم شده باشد اعمال می‌شود و همان اثر را روی این فایل دارد. .IP \fIbacklog-limit-highwater\fR 4 .IX Item "backlog-limit-highwater" این کلید نیازمند یک عدد صحیح مثبت است که باید بزرگ‌تر از مقدار \fIbacklog-limit\fR باشد. مقدار پیش‌فرض \f(CW\*(C`0\*(C'\fR است. .Sp اگر اندازه فایل بک‌لاگ بزرگ‌تر از این مقدار (به بایت) شود، حجم فایل بک‌لاگ به اندازه \fIbacklog-limit\fR کاهش می‌یابد. اگر هر دو مقدار \fIbacklog-factor\fR و \fIbacklog-limit-highwater\fR تعریف شده باشند، مقدار \fIbacklog-factor\fR استفاده می‌شود. .Sp این پارامتر همچنین برای فایل اشکال‌زدایی زمانی که \fIdebug-shrinking\fR روی true تنظیم شده است اعمال می‌شود و همان اثری را دارد که روی فایل‌های بک‌لاگ می‌گذارد. .IP \fIbacklog-feed-first\fR 4 .IX Item "backlog-feed-first" این کلید نیازمند یک مقدار بولی است. به صورت پیش‌فرض روی false تنظیم شده است. در صورت تنظیم روی true، فایل‌های بک‌لاگ قبل از فایل‌های جدید فید می‌شوند. این به منظور اجبار در تحویل به ترتیب است؛ بنابراین تنظیم این مقدار روی true زمانی که \fIinitial-connections\fR یا \fImax-connections\fR بیشتر از ۱ است، نامتناقض و ناسازگار خواهد بود. .IP \fIbindaddress\fR 4 .IX Item "bindaddress" این کلید نیازمند یک مقدار رشته‌ای است. این کلید مشخص می‌کند که \&\fBinnfeed\fR انتهای محلی اتصال خود را به کدام آدرس IPv4 خروجی متصل (bind) کند. این مقدار باید یک آدرس IPv4 در قالب نقطه-چهارگانه (nnn.nnn.nnn.nnn)، \f(CW\*(C`any\*(C'\fR یا \f(CW\*(C`none\*(C'\fR باشد. اگر تنظیم نشود یا روی \f(CW\*(C`any\*(C'\fR تنظیم شود، پیش‌فرض \fBinnfeed\fR این است که به هسته سیستم‌عامل اجازه دهد این آدرس را انتخاب کند. اگر روی \f(CW\*(C`none\*(C'\fR تنظیم شود، \fBinnfeed\fR از IPv4 برای اتصالات خروجی به همتاها در این دامنه استفاده نخواهد کرد (یعنی استفاده از IPv6 را اجباری می‌کند). .Sp در صورتی که در \fIinnfeed.conf\fR تنظیم نشود، \fBinnfeed\fR به صورت پیش‌فرض از مقدار \&\fIsourceaddress\fR در \fIinn.conf\fR (که به طور پیش‌فرض تنظیم‌نشده است) استفاده می‌کند. .IP \fIbindaddress6\fR 4 .IX Item "bindaddress6" این کلید نیازمند یک مقدار رشته‌ای است. عملکردی مشابه \fIbindaddress\fR دارد به جز اینکه برای اتصالات خروجی IPv6 استفاده می‌شود. این مقدار باید در قالب عددی IPv6 باشد (توجه داشته باشید که مقداری که حاوی دونقطه است باید در داخل نقل‌قول دوتایی قرار گیرد)، \f(CW\*(C`any\*(C'\fR یا \f(CW\*(C`none\*(C'\fR. اگر روی \f(CW\*(C`none\*(C'\fR تنظیم شود، \fBinnfeed\fR از IPv6 برای اتصالات خروجی به همتاها در این دامنه استفاده نخواهد کرد. .Sp اگر در \fIinnfeed.conf\fR تنظیم نشده باشد، \fBinnfeed\fR به طور پیش‌فرض از مقدار \&\fIsourceaddress6\fR در \fIinn.conf\fR (که به طور پیش‌فرض تنظیم‌نشده است) استفاده می‌کند. .IP \fIusername\fR 4 .IX Item "username" این کلید نیازمند یک مقدار رشته‌ای است. اگر مقدار تعریف شده باشد، \fBinnfeed\fR تلاش می‌کند تا از طریق AUTHINFO USER احراز هویت کند و از این مقدار برای نام کاربری استفاده خواهد کرد. در صورت تعریف این کلید، \&\fIpassword\fR نیز باید تعریف شود. .IP \fIpassword\fR 4 .IX Item "password" این کلید نیازمند یک مقدار رشته‌ای است. این مقدار گذرواژه‌ای است که برای AUTHINFO PASS استفاده می‌شود. اگر این کلید تعریف شده باشد، \fIusername\fR نیز باید تعریف شود. .SH "مقادیر همتا (PEER VALUES)" .IX Header "PEER VALUES" همان‌طور که قبلاً توضیح داده شد، تعاریف همتا می‌توانند شامل بازتعریف هر یک از جفت‌های \fIkey\fR:\fIvalue\fR توصیف‌شده در بخش پیش‌فرض‌های سراسری همتا در بالا باشند. یک جفت \fIkey\fR:\fIvalue\fR وجود دارد که مختص تعریف همتا است. .IP \fIip-name\fR 4 .IX Item "ip-name" این کلید نیازمند یک مقدار کلمه‌ای است. این کلمه یا یکی از نام‌های دامنه کاملاً واجد شرایط (FQDN) میزبان است، یا آدرس IP نقطه-چهارگانه همتا برای IPv4، یا آدرس IP با جداکننده دونقطه برای IPv6. اگر این مقدار مشخص نشود، نام همتا در بلوک دربرگیرنده \fIpeer\fR به عنوان \fIip-name\fR آن نیز در نظر گرفته می‌شود. .SH "بارگذاری مجدد (RELOADING)" .IX Header "RELOADING" اگر \fBinnfeed\fR یک سیگنال SIGHUP دریافت کند، فایل پیکربندی را مجدداً خواهد خواند. تمام مقادیر در دامنه سراسری به جز \fIbacklog-directory\fR قابل تغییر هستند (اگرچه توجه داشته باشید که تغییرات در \fIbindaddress\fR و \fIbindaddress6\fR تنها بر اتصالات جدید تأثیر می‌گذارد). .PP هر همتای جدید اضافه می‌شود و اتصالات هر همتای حذف‌شده بسته می‌شود. .PP فایل گزارش نیز مجدداً باز می‌شود. .SH "مثال (EXAMPLE)" .IX Header "EXAMPLE" برای یک مثال جامع، به نمونه فایل \fIinnfeed.conf\fR توزیع‌شده همراه با INN که به عنوان نقطه شروع نصب می‌شود مراجعه کنید. .PP در اینجا نمونه‌هایی از نحوه قالب‌بندی مقادیر آورده شده است: .PP .Vb 12 \& eg\-string: "New\etconfig\etfile\en" \& eg\-long\-string: "A long string that goes \& over multiple lines. The \& newline is kept in the \& string except when quoted \& with a backslash \e \& as here." \& eg\-simple\-string: A\-no\-quote\-string \& eg\-integer: 10 \& eg\-boolean: true \& eg\-char: \*(Aqa\*(Aq \& eg\-ctrl\-g: \*(Aq\e007\*(Aq .Ve .SH "تاریخچه (HISTORY)" .IX Header "HISTORY" نوشته‌شده توسط James Brister برای InterNetNews. تبدیل‌شده به POD توسط Julien Elie. .PP نسخه‌های قبلی \fBinnfeed\fR (تا 0.10.1) به طور جداگانه عرضه می‌شدند؛ \&\fBinnfeed\fR اکنون بخشی از INN است و از همان شماره نسخه مشترک استفاده می‌کند. لطفاً توجه داشته باشید که ساختار \fIinnfeed.conf\fR از نسخه\ 0.9.3 دستخوش تغییرات چشمگیری شده است. .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" inn.conf(5), innfeed(8), newsfeeds(5).