.\" -*- 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 "PULLNEWS 1" .TH PULLNEWS 1 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)" pullnews \- دریافت خبرها از چندین سرور خبر و ارسال آن‌ها به سروری دیگر .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" \&\fBpullnews\fR [\fB\-BhnOqRx\fR] [\fB\-a\fR \fIhashfeed\fR] [\fB\-b\fR \fIfraction\fR] [\fB\-c\fR \fIconfig\fR] [\fB\-C\fR \fIwidth\fR] [\fB\-d\fR \fIlevel\fR] [\fB\-f\fR \fIfraction\fR] [\fB\-F\fR \fIfakehop\fR] [\fB\-g\fR \fIgroups\fR] [\fB\-G\fR \fInewsgroups\fR] [\fB\-H\fR \fIheaders\fR] [\fB\-k\fR \fIcheckpt\fR] [\fB\-l\fR \fIlogfile\fR] [\fB\-L\fR \fIsize\fR] [\fB\-m\fR \fIheader_pats\fR] [\fB\-M\fR \fInum\fR] [\fB\-N\fR \fItimeout\fR] [\fB\-p\fR \fIport\fR] [\fB\-P\fR \fIhop_limit\fR] [\fB\-Q\fR \fIlevel\fR] [\fB\-r\fR \fIfile\fR] [\fB\-s\fR \fIto-server\fR[:\fIport\fR][_\fItlsmode\fR]] [\fB\-S\fR \fImax-run\fR] [\fB\-t\fR \fIretries\fR] [\fB\-T\fR \fIconnect-pause\fR] [\fB\-w\fR \fInum\fR] [\fB\-z\fR \fIarticle-pause\fR] [\fB\-Z\fR \fIgroup-pause\fR] [\fIfrom-server\fR ...] .SH "نیازمندی‌ها (REQUIREMENTS)" .IX Header "REQUIREMENTS" ماژول \f(CW\*(C`Net::NNTP\*(C'\fR باید نصب باشد. این ماژول به عنوان بخشی از توزیع libnet در دسترس است و به همراه نسخه‌های جدید Perl ارائه می‌شود. برای نسخه‌های قدیمی‌تر Perl، می‌توانید آن را از دریافت کنید..SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" دستور \&\fBpullnews\fR یک فایل پیکربندی به نام \fIpullnews.marks\fR را می‌خواند و به عنوان یک کلاینت خواننده به سرورهای بالادست (upstream) مشخص‌شده در آن متصل می‌شود. این فایل زمانی که \fBpullnews\fR با کاربری تنظیم‌شده در \fIrunasuser\fR در \fIinn.conf\fR (که به‌طور پیش‌فرض کاربر \f(CW\*(C`news\*(C'\fR است) اجرا شود، در \fIpathdb\fR جستجو می‌شود؛ در غیر این صورت، این فایل در دایرکتوری خانگی کاربری که در حال اجرای آن است جستجو می‌شود. .PP به‌طور پیش‌فرض، \fBpullnews\fR به تمام سرورهای فهرست‌شده در فایل پیکربندی متصل می‌شود، اما می‌توانید با فهرست کردن سرورها در خط فرمان، \fBpullnews\fR را به سرورهای خاصی محدود کنید: می‌توان فهرستی از نام‌های سرور را که با فاصله از هم جدا شده‌اند مشخص کرد، مانند \fIfrom-server\fR برای یکی از آن‌ها. برای هر سروری که به آن متصل می‌شود، مقالات را دریافت کرده و از طریق دستورهای IHAVE یا POST به سرور مقصد ارسال (feed) می‌کند. این بدان معناست که سیستمی که \fBpullnews\fR روی آن اجرا می‌شود باید دسترسی ارسال به سرور اخبار مقصد را داشته باشد. .PP دستور \&\fBpullnews\fR برای سایت‌های بسیار کوچکی طراحی شده است که نمی‌خواهند درگیر راه‌اندازی ارتباط‌های همتای سنتی (traditional peering) شوند و برای مدیریت خوراک‌های بزرگ در نظر گرفته نشده است. .PP در صورتی که همتاهای (peers) فعال دارید و نمی‌خواهید مقالاتی را که از سرورهای بالادست دریافت می‌کنید برای آن‌ها منتشر کنید، باید با پرچم \fB\-F\fR یک جهش ساختگی (fake hop) به تمام مقالات دریافت‌شده اضافه کنید، و همان جهش ساختگی را در زیربخش استثنای (exclusion sub-field) تمام سایت‌های پیکربندی‌شده در فایل \fInewsfeeds\fR خود که نباید این مقالات را دریافت کنند قرار دهید. برای مثال، با استفاده از \f(CW\*(C`pullnews \-F myserverimported\*(C'\fR، عبارت \f(CW\*(C`sitename:*:Tm:innfeed!\*(C'\fR را برای هر \fIsitename\fR در \fInewsfeeds\fR که نمی‌خواهید مقالات دریافت‌شده به آن ارسال شوند (مانند همتاهای خروجی شما و احتمالاً یک مدخل \f(CW\*(C`inpaths!\*(C'\fR) به \f(CW\*(C`sitename/myserverimported:*:Tm:innfeed!\*(C'\fR تغییر دهید. مدخل‌هایی مانند \f(CW\*(C`ME\*(C'\fR، \f(CW\*(C`controlchan!\*(C'\fR، \&\f(CW\*(C`innfeed!\*(C'\fR یا \f(CW\*(C`nocem!\*(C'\fR نیازی به این استثنا ندارند. .SH "گزینه‌ها (OPTIONS)" .IX Header "OPTIONS" .IP "\fB\-a\fR \fIhashfeed\fR" 4 .IX Item "-a hashfeed" این گزینه یک روش قطعی (deterministic) برای کنترل جریان مقالات و تقسیم یک خوراک است. پارامتر \fIhashfeed\fR باید به صورت \f(CW\*(C`value/mod\*(C'\fR یا \f(CW\*(C`start\-end/mod\*(C'\fR باشد. شناسه Message-ID هر مقاله با استفاده از MD5 درهم‌سازی (هش) می‌شود که منجر به یک هش ۱۲۸ بیتی خواهد شد. سپس ۳۲ بیت پایینی به‌طور پیش‌فرض به عنوان مقدار hashfeed (که یک عدد صحیح است) در نظر گرفته می‌شود. اگر باقیمانده مقدار hashfeed بر \f(CW\*(C`mod\*(C'\fR به علاوه یک، برابر با \f(CW\*(C`value\*(C'\fR باشد یا بین \f(CW\*(C`start\*(C'\fR و \f(CW\*(C`end\*(C'\fR قرار گیرد، \fBpullnews\fR مقاله را ارسال خواهد کرد. تمام این اعداد باید عدد صحیح باشند. .Sp برای نمونه: .Sp .Vb 2 \& pullnews \-a 1/2 ارسال حدود ۵۰٪ از تمام مقالات. \& pullnews \-a 2/2 ارسال ۵۰٪ دیگر از تمام مقالات. .Ve .Sp مثالی دیگر: .Sp .Vb 3 \& pullnews \-a 1\-3/10 ارسال حدود ۳۰٪ از تمام مقالات. \& pullnews \-a 4\-5/10 ارسال حدود ۲۰٪ از تمام مقالات. \& pullnews \-a 6\-10/10 ارسال حدود ۵۰٪ از تمام مقالات. .Ve .Sp می‌توانید از ساختار گسترش‌یافته‌ای به صورت \f(CW\*(C`value/mod:offset\*(C'\fR یا \&\f(CW\*(C`start\-end/mod:offset\*(C'\fR استفاده کنید (استفاده از یک زیرخط \f(CW\*(C`_\*(C'\fR به جای دونقطه \&\f(CW\*(C`:\*(C'\fR نیز شناخته می‌شود). از آنجا که MD5 یک مقدار خروجی ۱۲۸ بیتی تولید می‌کند، می‌توان مشخص کرد که عدد صحیح ۳۲ بیتی مورد استفاده توسط hashfeed از کدام افست بایتی (byte-offset) آغاز شود. مقدار پیش‌فرض برای \f(CW\*(C`offset\*(C'\fR برابر با \f(CW\*(C`:0\*(C'\fR است و سیزده مقدار هم‌پوشان از \f(CW\*(C`:0\*(C'\fR تا \f(CW\*(C`:12\*(C'\fR قابل استفاده هستند. تنها حداکثر چهار مقدار کاملاً مستقل وجود دارد: \f(CW\*(C`:0\*(C'\fR، \f(CW\*(C`:4\*(C'\fR، \f(CW\*(C`:8\*(C'\fR و \f(CW\*(C`:12\*(C'\fR. .Sp بنابراین، این امکان را فراهم می‌کند که سطح دومی از توزیع قطعی ایجاد شود. در واقع، اگر \fBpullnews\fR مقدار \f(CW\*(C`1/2\*(C'\fR را ارسال کند، می‌تواند برای نمونه با استفاده از \f(CW\*(C`1\-3/9:4\*(C'\fR به تقسیم کردن ادامه دهد. تا چهار سطح از توزیع قطعی می‌تواند مورد استفاده قرار گیرد. .Sp الگوریتم این گزینه با الگوریتم استفاده‌شده توسط Diablo\ 5.1 و بالاتر سازگار است. .IP "\fB\-b\fR \fIfraction\fR" 4 .IX Item "-b fraction" بازگشت به عقب هنگام بازنشانی شماره‌گذاری سرور. نسبتی (\f(CW\*(C`0.0\*(C'\fR تا \f(CW\*(C`1.0\*(C'\fR) از مقالات یک گروه را مشخص می‌کند که در صورت کمتر بودن شماره مقاله سرور از بالاترین شماره موجود برای آن گروه، باید دریافت شوند. هنگامی که \fIfraction\fR برابر \f(CW\*(C`1.0\*(C'\fR باشد، تمام مقالات سرور شماره‌گذاری‌مجددشده دریافت می‌شوند. حالت پیش‌فرض عدم انجام هیچ کاری است. .IP \fB\-B\fR 4 .IX Item "-B" خوراک فقط شامل سرایند است؛ به این معنی که \fBpullnews\fR فقط سرایندهای مقالات را به همراه یک خط خالی ارسال می‌کند. اگر مقاله از قبل فیلد سرایند Bytes را نداشته باشد، آن را اضافه می‌کند و بدنه را تنها در صورتی نگه می‌دارد که مقاله یک مقاله کنترلی باشد. .IP "\fB\-c\fR \fIconfig\fR" 4 .IX Item "-c config" به‌طور معمول، زمانی که \fBpullnews\fR به عنوان کاربر news اجرا می‌شود، فایل پیکربندی در \fIpullnews.marks\fR در \fIpathdb\fR ذخیره می‌شود، و در غیر این صورت در دایرکتوری خانگی کاربری که در حال اجرای آن است قرار دارد. اگر \fB\-c\fR مشخص شود، به جای آن از \fIconfig\fR به عنوان فایل پیکربندی استفاده خواهد شد. این در صورتی مفید است که \fBpullnews\fR را به صورت خودکار از طریق cron با یک کاربر سیستمی یا به عنوان یک کاربر مستقل، به جای کاربر news اجرا کنید. .Sp برای اطلاع از ساختار این فایل، بخش «فایل پیکربندی (CONFIG FILE)» را در ادامه ببینید. .IP "\fB\-C\fR \fIwidth\fR" 4 .IX Item "-C width" استفاده از \fIwidth\fR نویسه در هر خط برای جدول پیشرفت. مقدار پیش‌فرض \f(CW\*(C`50\*(C'\fR است. .IP "\fB\-d\fR \fIlevel\fR" 4 .IX Item "-d level" تنظیم سطح اشکال‌زدایی روی عدد صحیح \fIlevel\fR (تا حداکثر \f(CW\*(C`4\*(C'\fR)؛ با افزایش این مقدار، خروجی اشکال‌زدایی بیشتری ثبت خواهد شد. مقدار پیش‌فرض \f(CW\*(C`0\*(C'\fR است. .IP "\fB\-f\fR \fIfraction\fR" 4 .IX Item "-f fraction" این گزینه نسبت مقالاتی که باید از هر گروه دریافت شوند را به \&\fIfraction\fR تغییر می‌دهد و باید در بازه \f(CW\*(C`0.0\*(C'\fR تا \f(CW\*(C`1.0\*(C'\fR باشد (\f(CW\*(C`1.0\*(C'\fR مقدار پیش‌فرض است). .IP "\fB\-F\fR \fIfakehop\fR" 4 .IX Item "-F fakehop" افزودن \fIfakehop\fR به عنوان یک میزبان به ابتدای بدنه فیلد سرایند Path در مقالات ارسال‌شده. .IP "\fB\-g\fR \fIgroups\fR" 4 .IX Item "-g groups" مشخص کردن مجموعه‌ای از گروه‌ها برای دریافت. پارامتر \fIgroups\fR فهرستی از گروه‌های خبری است که با کاما از هم جدا شده‌اند (فقط کاما، بدون فاصله). هر گروه باید در فایل پیکربندی تعریف شده باشد، و فقط با میزبان‌های راه دور که دارای آن گروه‌ها هستند ارتباط برقرار خواهد شد. توجه داشته باشید که این یک فهرست ساده از گروه‌ها است، نه یک عبارت wildmat، و نویسه‌های عام (wildcards) پشتیبانی نمی‌شوند. .IP "\fB\-G\fR \fInewsgroups\fR" 4 .IX Item "-G newsgroups" افزودن فهرست گروه‌های جداشده با کاما \fInewsgroups\fR به هر سرور در فایل پیکربندی (همچنین گزینه‌های \fB\-g\fR و \fB\-w\fR را ببینید). .IP \fB\-h\fR 4 .IX Item "-h" چاپ پیام راهنمای نحوه استفاده و خروج. .IP "\fB\-H\fR \fIheaders\fR" 4 .IX Item "-H headers" حذف این فیلدهای سرایند مشخص‌شده (فهرستی جداشده با دونقطه) از مقالات ارسال‌شده. .IP "\fB\-k\fR \fIcheckpt\fR" 4 .IX Item "-k checkpt" ثبت نقطه بازبینی (ذخیره) فایل پیکربندی به ازای هر \fIcheckpt\fR مقاله (پیش‌فرض \f(CW\*(C`0\*(C'\fR است، به این معنی که در انتهای نشست انجام می‌شود). .IP "\fB\-l\fR \fIlogfile\fR" 4 .IX Item "-l logfile" ثبت گزارش پیشرفت/آمار در \fIlogfile\fR (پیش‌فرض \f(CW\*(C`stdout\*(C'\fR است). .IP "\fB\-L\fR \fIsize\fR" 4 .IX Item "-L size" مشخص کردن بیشترین اندازه مجاز مقاله به بایت. پیش‌فرض، بارگیری تمام مقالات بدون در نظر گرفتن اندازه‌شان است. هنگام استفاده از این گزینه، \fBpullnews\fR پیش از تصمیم‌گیری درباره اینکه کدام مقالات را بارگیری کند، ابتدا داده‌های بررسی اجمالی (overview data در صورت موجود بودن) مربوط به هر گروه خبری را جهت پردازش و به‌دست آوردن اندازه‌های مقالات دریافت می‌کند. .IP "\fB\-m\fR \fIheader_pats\fR" 4 .IX Item "-m header_pats" ارسال مقاله بر اساس تطابق بدنه فیلد سرایند. آرگومان شامل تعدادی تاپل جداشده با فاصله است (هر تاپل نام فیلد سرایند و عبارت باقاعده است که با دونقطه از هم جدا شده‌اند). برای نمونه: .Sp .Vb 1 \& \-m "Hdr1:regexp1 !Hdr2:regexp2 #Hdr3:regexp3 !#Hdr4:regexp4" .Ve .Sp مشخص می‌کند که مقاله تنها در صورتی منتقل خواهد شد که بدنه فیلد سرایند \f(CW\*(C`Hdr1\*(C'\fR با \f(CW\*(C`regexp1\*(C'\fR مطابقت داشته باشد و بدنه فیلد سرایند \f(CW\*(C`Hdr2\*(C'\fR با \f(CW\*(C`regexp2\*(C'\fR مطابقت نداشته باشد. علاوه بر این، اگر بدنه فیلد سرایند \f(CW\*(C`Hdr3\*(C'\fR با \&\f(CW\*(C`regexp3\*(C'\fR مطابقت داشته باشد، آن سرایند حذف می‌شود؛ و اگر بدنه فیلد سرایند \f(CW\*(C`Hdr4\*(C'\fR با \f(CW\*(C`regexp4\*(C'\fR مطابقت نداشته باشد، آن سرایند حذف می‌شود. .IP "\fB\-M\fR \fInum\fR" 4 .IX Item "-M num" مشخص کردن حداکثر تعداد مقالات (به ازای هر گروه) برای پردازش. حالت پیش‌فرض، پردازش تمام مقالات جدید است. همچنین گزینه \fB\-f\fR را ببینید. .IP \fB\-n\fR 4 .IX Item "-n" کاری جز خواندن مقالات انجام نمی‌دهد \-\- مقالات را به سرور پایین‌دست ارسال نمی‌کند، هیچ فایل \fBrnews\fR نمی‌نویسد، و فایل پیکربندی را به‌روزرسانی نمی‌کند. .IP "\fB\-N\fR \fItimeout\fR" 4 .IX Item "-N timeout" مشخص کردن مدت‌زمان وقفه (timeout)، به صورت \fItimeout\fR ثانیه، هنگام برقراری اتصال NNTP. .IP \fB\-O\fR 4 .IX Item "-O" استفاده از حالت بهینه‌شده: \fBpullnews\fR پیش از بارگیری مقاله، بررسی می‌کند که آیا مقاله از قبل روی سرور پایین‌دست وجود دارد یا خیر. این حالت ممکن است برای مقالات بسیار حجیم یا پیوند کند با میزبان‌های بالادست مفید باشد. .IP "\fB\-p\fR \fIport\fR" 4 .IX Item "-p port" اتصال به سرور اخبار مقصد روی درگاهی غیر از درگاه پیش‌فرض \&\f(CW\*(C`119\*(C'\fR. این گزینه درگاه مورد استفاده برای اتصال به سرورهای اخبار مبدأ را تغییر نمی‌دهد. .IP "\fB\-P\fR \fIhop_limit\fR" 4 .IX Item "-P hop_limit" محدود کردن ارسال مقاله بر اساس تعداد جهش‌هایی (hops) که تاکنون طی کرده است. جهش‌ها در بدنه فیلد سرایند Path شمرده می‌شوند (\fIhop_count\fR)، و مقاله تنها زمانی ارسال می‌شود که \fIhop_limit\fR به صورت \f(CW\*(C`+num\*(C'\fR بوده و \fIhop_count\fR بیشتر از \fInum\fR باشد؛ یا \fIhop_limit\fR به صورت \f(CW\*(C`\-num\*(C'\fR بوده و \fIhop_count\fR کمتر از \fInum\fR باشد..IP \fB\-q\fR 4 .IX Item "-q" نمایش اطلاعات وضعیت کمتر در حین اجرا. .IP "\fB\-Q\fR \fIlevel\fR" 4 .IX Item "-Q level" تنظیم سطح سکوت (\f(CW\*(C`\-Q 2\*(C'\fR معادل \f(CW\*(C`\-q\*(C'\fR است). هرچه این مقدار بیشتر باشد، پیام‌های کمتری ثبت می‌شوند. مقدار پیش‌فرض \f(CW\*(C`0\*(C'\fR است. .IP "\fB\-r\fR \fIfile\fR" 4 .IX Item "-r file" به جای ارسال مقاله‌های دریافت‌شده به یک سرور مقصد، یک فایل دسته‌ای (batch) ایجاد می‌کند که بعداً می‌توان آن را با استفاده از \fBrnews\fR به سرور ارسال کرد. برای اطلاعات بیشتر در مورد قالب فایل دسته‌ای، rnews(1) را ببینید. .IP \fB\-R\fR 4 .IX Item "-R" رفتار به عنوان یک خواننده (استفاده از دستورهای MODE READER و POST) در ارتباط با سرور پایین‌دستی. در این حالت، ممکن است برخی از پست‌ها به دلیل فیلدهای سرایند تزریق غیرمنتظره، فیلدهای سرایند منسوخ یا قالباً نادرست، یا تاریخی بسیار دور در گذشته، رد شوند. در این صورت ممکن است بخواهید \fIartcutoff\fR را در \fIinn.conf\fR روی \f(CW\*(C`0\*(C'\fR تنظیم کرده و از پرچم \fB\-H\fR برای حذف فیلدهای سرایند ناخواسته استفاده کنید. حتی با این کار نیز ممکن است تعداد کمی از مقاله‌ها همچنان رد شوند. .Sp حالت پیش‌فرض، رفتار مانند یک تغذیه‌کننده (feeder) و استفاده از دستور IHAVE است. (باید در \fIincoming.conf\fR اتصالات از سوی \fBpullnews\fR را مجاز کنید تا به عنوان تغذیه‌کننده شناخته شود.) .IP "\fB\-s\fR \fIto-server\fR[:\fIport\fR][_\fItlsmode\fR]" 4 .IX Item "-s to-server[:port][_tlsmode]" به طور معمول، \fBpullnews\fR مقاله‌هایی را که بازیابی می‌کند به سرور خبری در حال اجرا روی localhost تحویل می‌دهد. برای اتصال به میزبانی دیگر، سرور مورد نظر را با پرچم \fB\-s\fR مشخص کنید. همچنین می‌توانید پورت را با همین پرچم تعیین کرده یا از \fB\-p\fR استفاده نمایید. پورت پیش‌فرض \f(CW\*(C`119\*(C'\fR است. .Sp اتصال به طور پیش‌فرض رمزگذاری‌نشده است. برای مذاکره بر سر لایه رمزگذاری TLS، می‌توانید \fItlsmode\fR را برای TLS ضمنی روی \f(CW\*(C`TLS\*(C'\fR (مذاکره بلافاصله پس از اتصال روی یک پورت اختصاصی) یا برای TLS صریح روی \f(CW\*(C`STARTTLS\*(C'\fR (ارسال دستور مناسب قبل از احراز هویت یا تحویل پیام‌ها) تنظیم کنید. مثال‌هایی از نحوه استفاده: .Sp .Vb 3 \& pullnews \-s news.server.com \& pullnews \-s news.server.com_STARTTLS \& pullnews \-s news.server.com:433_TLS .Ve .Sp توجه داشته باشید که همه سرورهای NNTP از TLS برای تحویل مقاله‌ها پشتیبانی نمی‌کنند. .IP "\fB\-S\fR \fImax-run\fR" 4 .IX Item "-S max-run" مشخص کردن حداکثر زمان اجرای \fBpullnews\fR با \fImax-run\fR بر حسب ثانیه. .IP "\fB\-t\fR \fIretries\fR" 4 .IX Item "-t retries" حداکثر تعداد تلاش‌ها (\fIretries\fR) برای برقراری اتصال به یک سرور یا اتصال مجدد در صورت بسته شدن غیرمنتظره سوکت (همچنین \fB\-T\fR را ببینید). مقدار پیش‌فرض \f(CW\*(C`0\*(C'\fR است. .IP "\fB\-T\fR \fIconnect-pause\fR" 4 .IX Item "-T connect-pause" مکث به مدت \fIconnect-pause\fR ثانیه میان تلاش‌های مجدد برای اتصال (همچنین \fB\-t\fR را ببینید). مقدار پیش‌فرض \f(CW\*(C`1\*(C'\fR است. .IP "\fB\-w\fR \fInum\fR" 4 .IX Item "-w num" تنظیم نشان بالاترین حد دریافت (high water mark یا شماره آخرین مقاله دریافت‌شده) هر گروه روی \fInum\fR. اگر \fInum\fR منفی باشد، به جای آن \fICurrent\fR+\fInum\fR محاسبه می‌شود (یعنی دریافت آخرین مقاله‌ها به تعداد \fInum\fR). بنابراین، مقدار \f(CW\*(C`0\*(C'\fR برای \fInum\fR همه مقاله‌های موجود در سرور را مجدداً دریافت می‌کند؛ در حالی که مقدار \f(CW\*(C`\-0\*(C'\fR هیچ مقاله قدیمی را دریافت نکرده و نشان را روی \fICurrent\fR (جدیدترین مقاله روی سرور) تنظیم می‌کند. .IP \fB\-x\fR 4 .IX Item "-x" در صورت استفاده از پرچم \fB\-x\fR، فیلد سرایند Xref به هر مقاله‌ای که فاقد آن باشد اضافه می‌شود. این قابلیت به عنوان مثال زمانی مفید است که مقاله‌ها به سرور خبری ارسال می‌شوند که \fIxrefslave\fR در \fIinn.conf\fR آن تنظیم شده است. .IP "\fB\-z\fR \fIarticle-pause\fR" 4 .IX Item "-z article-pause" مکث به مدت \fIarticle-pause\fR ثانیه بین دریافت مقاله‌ها. مقدار پیش‌فرض \f(CW\*(C`0\*(C'\fR است. .IP "\fB\-Z\fR \fIgroup-pause\fR" 4 .IX Item "-Z group-pause" مکث به مدت \fIgroup-pause\fR ثانیه بین بررسی گروه‌ها. مقدار پیش‌فرض \f(CW\*(C`0\*(C'\fR است. .SH "فایل پیکربندی (CONFIG FILE)" .IX Header "CONFIG FILE" فایل پیکربندی \fBpullnews\fR به بلوک‌هایی تقسیم شده است؛ یک بلوک برای هر سرور دوردست جهت اتصال. یک بلوک با خط میزبان آغاز می‌شود (که نباید هیچ فاصله ابتدایی داشته باشد) و تنها شامل نام میزبان سرور دوردست به همراه پورت و حالت TLS اختیاری است (با همان ساختار معنایی پرچم \fB\-s\fR)، و در ادامه می‌تواند اطلاعات احراز هویت (نام کاربری و گذرواژه برای آن سرور) به صورت اختیاری قرار گیرد. توجه داشته باشید که اطلاعات احراز هویت را می‌توان برای سرور پایین‌دستی نیز تعیین کرد (یک خط میزبان برای \f(CW\*(C`localhost\*(C'\fR یا نام میزبان مشخص‌شده با پرچم \fB\-s\fR می‌تواند بدون مشخص کردن هیچ گروه خبری در فایل پیکربندی برای آن اضافه شود). .PP به دنبال خط میزبان باید یک یا چند خط گروه خبری قرار گیرد که با فاصله آغاز شده و نام گروه خبری جهت دریافت در ادامه آن می‌آید. در هر خط فقط باید یک گروه خبری درج شود. .PP \&\fBpullnews\fR فایل پیکربندی را به‌روزرسانی می‌کند تا شامل زمان آخرین بررسی گروه و بالاترین شماره مقاله‌ای باشد که با موفقیت دریافت و به سرور مقصد منتقل شده است. این ابزار از این داده‌ها استفاده می‌کند تا در اجرای بعدی از انجام کار تکراری جلوگیری نماید. .PP ساختار دستوری کامل به صورت زیر است: .PP .Vb 3 \& [:][_] [ ] \& [