.\" -*- 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 "CTLINND 8" .TH CTLINND 8 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)" ctlinnd \- ابزار کنترل و ارسال دستور به سرور innd در INN .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" \&\fBctlinnd\fR [\fB\-hs\fR] [\fB\-t\fR \fItimeout\fR] [\fIcommand\fR [\fIargument\fR ...]] .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" دستور \&\fBctlinnd\fR پیامی را به کانال کنترلی innd(8)، دیمن اصلی InterNetNews، ارسال می‌کند. .PP در حالت عملکرد عادی، پیام به سرور ارسال می‌شود؛ سپس سرور اقدام درخواستی را انجام داده و پاسخی حاوی یک پیام متنی و یک کد خروج برای \fBctlinnd\fR پس می‌فرستد. اگر سرور دستور را با موفقیت انجام دهد، \fBctlinnd\fR پاسخ را در خروجی استاندارد چاپ کرده و با وضعیت صفر خارج می‌شود. اگر سرور نتواند دستور را اجرا کند، به \fBctlinnd\fR دستور می‌دهد با وضعیت یک خارج شود. به‌طور پیش‌فرض، \fBctlinnd\fR برای دریافت پاسخ از سوی \fBinnd\fR به‌طور نامحدود منتظر می‌ماند؛ این رفتار را می‌توان با فلگ \fB\-t\fR تغییر داد. .PP دستورهای \f(CW\*(C`shutdown\*(C'\fR\s-1،\s0 \f(CW\*(C`xabort\*(C'\fR و \f(CW\*(C`xexec\*(C'\fR پاسخی تولید نمی‌کنند، زیرا موجب خروج \fBinnd\fR می‌شوند. پس از این دستورها، \fBctlinnd\fR همواره بدون پیام و با وضعیت صفر خارج می‌شود. .SH "گزینه‌ها (OPTIONS)" .IX Header "OPTIONS" .IP \fB\-h\fR 4 .IX Item "-h" خلاصه‌ای از دستورها را چاپ می‌کند. اگر همراه با فلگ \fB\-h\fR یک دستور مشخص نیز داده شود، فقط نحوه استفاده از همان دستور نمایش داده خواهد شد. .IP \fB\-s\fR 4 .IX Item "-s" در صورت موفقیت‌آمیز بودن دستور، خروجی دریافتی از \fBinnd\fR را چاپ نمی‌کند. .IP "\fB\-t\fR \fItimeout\fR" 4 .IX Item "-t timeout" مدت زمان انتظار برای دریافت پاسخ از سرور را برای دستورهایی غیر از \f(CW\*(C`shutdown\*(C'\fR\s-1،\s0 \f(CW\*(C`xabort\*(C'\fR و \f(CW\*(C`xexec\*(C'\fR مشخص می‌کند. مقدار \fItimeout\fR تعداد ثانیه‌های انتظار است. مقدار صفر به معنی انتظار همیشگی (نامحدود) است، و مقدار کمتر از صفر یعنی اصلاً منتظر نماند و بلافاصله با وضعیت صفر خارج شود. هنگام انتظار برای پاسخ، \fBctlinnd\fR هر دو دقیقه یک‌بار بررسی می‌کند تا مطمئن شود سرور همچنان در حال اجراست؛ این کار احتمال قفل شدن و معلق ماندن \fBctlinnd\fR را کاهش می‌دهد. .Sp مقدار پیش‌فرض صفر است که مشخص می‌کند \fBctlinnd\fR باید به‌طور نامحدود منتظر بماند. .SH "دستورها (COMMANDS)" .IX Header "COMMANDS" در ادامه فهرست کامل دستورهای پشتیبانی‌شده آمده است. توجه داشته باشید که تقریباً تمام دستورها دارای تعداد آرگومان‌های ثابتی هستند. اگر پارامتری بتواند یک رشته خالی باشد، همچنان لازم است که رشته خالی به‌عنوان آرگومان به \fBctlinnd\fR ارسال شود (در شل به‌صورت دو علامت نقل‌قول در کنار هم مشخص می‌شود، مانند \f(CW\*(Aq\*(Aq\fR\c ). .IP "addhist \fImessage-id\fR \fIarrival\fR \fIexpires\fR \fIposted\fR \fItoken\fR" 4 .IX Item "addhist message-id arrival expires posted token" یک مدخل برای \fImessage-id\fR به پایگاه‌داده تاریخچه (history) اضافه می‌کند. قلاب‌های زاویه‌دار (علامت‌های کوچک‌تر/بزرگ‌تر) در اطراف \fImessage-id\fR اختیاری هستند. معمولاً باید با استفاده از کوتیشن‌های تکی (single quotes) در برابر تفسیر پوسته محافظت شود. .Sp آرگومان‌های \fIarrival\fR\s-1،\s0 \fIexpires\fR و \fIposted\fR باید تعداد ثانیه‌ها از مبدأ زمان یونیکس (epoch) باشند و به ترتیب نشان‌دهنده زمان دریافت مقاله، زمان انقضای آن (از طریق فیلد هدر Expires) و زمان ارسال آن (مشخص‌شده در فیلد هدر Date) هستند. اگر مقاله فاقد فیلد هدر Expires باشد، \fIexpires\fR باید \f(CW\*(C`0\*(C'\fR باشد. \fItoken\fR توکن API ذخیره‌سازی برای مقاله است و می‌تواند خالی باشد. .Sp این دستور فقط در زمان فعال بودن و اجرای سرور قابل استفاده است و در صورتی که سرور در حالت مکث (paused) یا محدودشده (throttled) باشد، رد خواهد شد. .IP "allow \fIreason\fR" 4 .IX Item "allow reason" اتصال‌های از راه دور را مجاز می‌کند و دستور پیشین \f(CW\*(C`reject\*(C'\fR را لغو می‌نماید. مقدار \fIreason\fR باید همان متنی باشد که به دستور \f(CW\*(C`reject\*(C'\fR داده شده بود، یا یک رشته خالی باشد (که با هر دلیلی تطابق دارد). .IP "begin \fIsite\fR" 4 .IX Item "begin site" ارسال فید به \fIsite\fR را آغاز می‌کند. سرور فایل \fInewsfeeds\fR را دوباره پویش می‌کند تا سایت مشخص‌شده را پیدا کند و یک فید خبری برای آن تنظیم نماید. اگر سایت از قبل وجود داشته باشد، ابتدا یک عملیات \f(CW\*(C`drop\*(C'\fR برای آن سایت انجام می‌شود. این دستور فوروارد (هدایت) می‌شود؛ بخش «نکات (NOTES)» را در ادامه ببینید. .IP "cancel \fImessage-id\fR" 4 .IX Item "cancel message-id" مقاله‌ای با \fImessage-ID\fR مشخص‌شده را از سیستم محلی حذف می‌کند. این کار پیام کنترلی cancel تولید نمی‌کند؛ بلکه فقط بر سیستم محلی اثر می‌گذارد. قلاب‌های زاویه‌دار در اطراف \fImessage-ID\fR اختیاری هستند. این شناسه معمولاً باید در برابر پوسته با کوتیشن‌های تکی (و نه کوتیشن‌های دوگانه) محافظت شود؛ برای مثال: .Sp .Vb 1 \& ctlinnd cancel \*(Aqtest@foo.bar\*(Aq .Ve .Sp توجه داشته باشید که پایگاه‌داده تاریخچه با Message-ID مشخص‌شده به‌روز می‌شود؛ بنابراین اگر مقاله‌ای با همان Message-ID بعداً دریافت شود، رد خواهد شد؛ این امر برای رد کردن هرزنامه‌ها قبل از دریافت آن‌ها بسیار مفید است. .Sp اگر سرور به‌صورت دستی در حالت throttle قرار گرفته باشد، این دستور باعث می‌شود پایگاه‌داده تاریخچه را برای مدت کوتاهی باز کند. اگر سرور به هر دلیل دیگری در حالت مکث (pause) یا محدود (throttle) باشد، این دستور رد می‌شود. .IP "changegroup \fIgroup\fR \fIstatus\fR" 4 .IX Item "changegroup group status" گروه خبری \fIgroup\fR را تغییر می‌دهد تا وضعیت آن (فیلد چهارم در فایل \fIactive\fR\c ) به \fIstatus\fR تبدیل شود. برای مثال می‌توان از این دستور برای مدیردار (moderated) یا بدون‌مدیر (unmoderated) کردن یک گروه موجود استفاده کرد. .Sp این دستور، بر خلاف \f(CW\*(C`newgroup\*(C'\fR یا \f(CW\*(C`rmgroup\*(C'\fR\s-1،\s0 تنها در صورتی قابل استفاده است که سرور در حال اجرا باشد، و در صورت مکث یا محدود بودن سرور، رد خواهد شد. .IP checkfile 4 .IX Item "checkfile" نحو (syntax) فایل \fInewsfeeds\fR را بررسی می‌کند و در صورت یافتن هرگونه خطا، پیامی را نمایش می‌دهد. جزئیات خطاها در syslog ثبت و گزارش می‌شوند. .IP "drop \fIsite\fR" 4 .IX Item "drop site" بافر مربوط به \fIsite\fR را تخلیه (flush) کرده و آن را از فهرست فیدهای فعال سرور حذف (drop) می‌کند. این دستور فوروارد می‌شود؛ بخش «نکات (NOTES)» را در ادامه ببینید. .IP "feedinfo \fIsite\fR" 4 .IX Item "feedinfo site" اطلاعات مفصلی را درباره وضعیت فید به \fIsite\fR چاپ می‌کند، یا اگر \fIsite\fR یک رشته خالی باشد، وضعیت خلاصه‌ای از تمام فیدها را ارائه می‌دهد. .IP "flush \fIsite\fR" 4 .IX Item "flush site" بافر سایت مشخص‌شده را تخلیه (flush) می‌کند. اقدام انجام‌شده به نوع فیدی که سایت دریافت می‌کند بستگی دارد؛ برای اطلاعات بیشتر به newsfeeds(5) مراجعه کنید. این دستور زمانی مفید است که سایت از طریق یک فایل تغذیه می‌شود و دسته‌بندی (batching) در آستانه آغاز است، یا برای بستن تمیز و اجرای مجدد یک فید کانالی به کار می‌رود. اگر \fIsite\fR یک رشته خالی باشد، تمام سایت‌ها تخلیه می‌شوند و فایل \fIactive\fR و پایگاه‌داده تاریخچه نیز روی دیسک ذخیره و همگام (flush) می‌شوند. این دستور فوروارد می‌شود؛ بخش «نکات (NOTES)» را در ادامه ببینید. .Sp تخلیه فید کانال \fBinnfeed\fR روش توصیه‌شده برای راه‌اندازی مجدد \fBinnfeed\fR جهت اعمال پیکربندی‌های جدید است. \fBinnd\fR یک پردازش جدید \fBinnfeed\fR ایجاد می‌کند در حالی که پردازش قدیمی به‌صورت تمیز بسته می‌شود. .IP flushlogs 4 .IX Item "flushlogs" فایل‌های لاگ اخبار و خطا را می‌بندد و با افزودن پسوند \f(CW\*(C`.old\*(C'\fR به نام فایل‌ها آن‌ها را تغییر نام می‌دهد، سپس فایل‌های لاگ جدید اخبار و خطا را باز می‌کند. همچنین فایل \fIactive\fR و پایگاه‌داده تاریخچه روی دیسک تخلیه و ذخیره می‌شوند. کانال‌های پردازش و exploder بازگشایی می‌شوند تا فایل‌های لاگ جدید را به درستی به کار گیرند. .IP "go \fIreason\fR" 4 .IX Item "go reason" پایگاه‌داده تاریخچه را دوباره باز می‌کند و پذیرش مقالات را از سر می‌گیرد، که دستور قبلی \f(CW\*(C`pause\*(C'\fR یا \f(CW\*(C`throttle\*(C'\fR را لغو می‌کند. مقدار \fIreason\fR باید یک رشته خالی باشد یا با متنی که پیش‌تر به دستور \f(CW\*(C`pause\*(C'\fR یا \f(CW\*(C`throttle\*(C'\fR داده شده بود مطابقت داشته باشد. .Sp اگر دستور \f(CW\*(C`reject\*(C'\fR در حال اجرا باشد، در صورت تطابق دلیل با \fIreason\fR\s-1،\s0 با اجرای معادل دستور \f(CW\*(C`allow\*(C'\fR آن را نیز لغو می‌کند. به همین ترتیب، اگر دستور \f(CW\*(C`reserve\*(C'\fR داده شده باشد، در صورتی که \fIreason\fR با متنی که به \f(CW\*(C`reserve\*(C'\fR داده شده بود تطابق داشته باشد، رزرو را پاک خواهد کرد. .Sp پایگاه‌داده تاریخچه در هنگام \f(CW\*(C`throttle\*(C'\fR یا \f(CW\*(C`pause\*(C'\fR به‌طور خودکار بسته می‌شود و با \f(CW\*(C`go\*(C'\fR مجدداً باز می‌گردد، بنابراین می‌توان پایگاه‌داده تاریخچه را در طول مکث یا محدودسازی بدون نیاز به دستور صریح \f(CW\*(C`reload\*(C'\fR جایگزین کرد. اگر هر یک از فایل‌های پیکربندی دیگر یا فایل \fIactive\fR تغییر کرده باشند، باید یک دستور \f(CW\*(C`reload\*(C'\fR داده شود تا سرور وادار به خواندن مجدد آن فایل‌ها گردد. .Sp اگر سرور به دلیل انباشته شدن خطاهای ورودی/خروجی (I/O) زیاد خود را محدود (throttle) کرده باشد، این دستور شمارنده خطا را بازنشانی می‌کند. .Sp اگر \fBinnd\fR با فلگ \fB\-n y\fR شروع نشده باشد، این دستور همچنین معادل دستور \f(CW\*(C`readers\*(C'\fR با فلگ \f(CW\*(C`yes\*(C'\fR و متن \fIreason\fR عمل خواهد کرد. .IP "hangup \fIchannel\fR" 4 .IX Item "hangup channel" سوکت مربوط به کانال ورودی مشخص‌شده را می‌بندد. این کار هنگامی که به نظر می‌رسد یک اتصال ورودی معلق مانده یا قفل کرده، می‌تواند مفید باشد (هرچند \fBinnd\fR اتصال‌های غیرفعال را پس از گذشت مدت‌زمان مشخص‌شده در \fIpeertimeout\fR در فایل \fIinn.conf\fR به‌صورت خودکار می‌بندد). .IP "help [\fIcommand\fR]" 4 .IX Item "help [command]" خلاصه‌ای از همه دستورها را چاپ می‌کند، یا در صورت مشخص شدن \fIcommand\fR\s-1،\s0 فقط راهنمای همان دستور را نمایش می‌دهد. این دستور معادل گزینه \fB\-h\fR است. .IP "kill \fIsignal\fR \fIsite\fR" 4 .IX Item "kill signal site" سیگنال \fIsignal\fR را به پردازش زیربنایی سایت مشخص‌شده ارسال می‌کند، که باید یک فید کانالی یا exploder باشد. \fIsignal\fR می‌تواند یک شماره عددی سیگنال یا یکی از مقادیر \f(CW\*(C`hup\*(C'\fR\s-1،\s0 \f(CW\*(C`int\*(C'\fR یا \f(CW\*(C`term\*(C'\fR باشد؛ بزرگی و کوچکی حروف اهمیتی ندارد. .IP logmode 4 .IX Item "logmode" باعث می‌شود سرور حالت عملیاتی فعلی خود را در syslog ثبت کند. .IP "lowmark \fIfile\fR" 4 .IX Item "lowmark file" نشانه‌های حداقل شماره مقالات (low water marks) را در فایل \fIactive\fR بر اساس محتویات \fIfile\fR بازنشانی می‌کند. هر خط در \fIfile\fR باید به این شکل باشد: .Sp .Vb 1 \& group low\-value .Ve .Sp برای مثال: .Sp .Vb 1 \& comp.lang.c++ 243 .Ve .Sp این دستور عمدتاً توسط \fBnews.daily\fR برای به‌روزرسانی فایل \fIactive\fR پس از انقضای شبانه استفاده می‌شود. .IP mode 4 .IX Item "mode" حالت عملیاتی سرور را به‌عنوان خلاصه‌ای چندخطی از پارامترها و وضعیت کارکرد چاپ می‌کند. پارامترهای موجود در خروجی متناظر با فلگ‌های خط فرمان \fBinnd\fR هستند و تنظیمات فعلی آن دسته از پارامترهایی را نشان می‌دهند که می‌توانند توسط فلگ‌های خط فرمان بازنویسی و جایگزین شوند. .IP "name \fIchannel\fR" 4 .IX Item "name channel" نام و اطلاعات مربوط به شماره کانال ورودی یا خروجی داده‌شده را چاپ می‌کند، یا اگر \fIchannel\fR یک رشته خالی باشد، اطلاعات تمام کانال‌ها را نمایش می‌دهد. پاسخ به این صورت قالب‌بندی می‌شود: .Sp .Vb 1 \& :::: .Ve .Sp که در آن نام کانال، شماره آن (معمولاً همان توصیف‌کننده فایل تخصیص‌یافته به آن)، مدت زمان بیکاری برای یک کانال NNTP یا شناسه پردازش (PID) برای یک کانال پردازشی، و وضعیت کانال‌های NNTP است. .Sp فیلد یکی از مقادیر زیر است: .Sp .Vb 6 \& control Control channel for ctlinnd \& file An outgoing file feed \& localconn Local channel used by nnrpd and rnews for posting \& nntp NNTP channel for remote connections \& proc The process for a process feed \& remconn The channel that accepts new remote connections .Ve .Sp وضعیت کانال نشان می‌دهد که آیا کانال در حالت مکث است یا خیر. چیزی نمایش داده نمی‌شود مگر اینکه کانال در حالت مکث باشد که در آن صورت \f(CW\*(C`paused\*(C'\fR نشان داده می‌شود. اگر تعداد اتصال‌های از راه دور برای آن برچسب در \fIincoming.conf\fR در عرض \fIhold-time\fR ثانیه بیشتر از \fImax-connections\fR شود، کانال به‌طور خودکار به حالت مکث درخواهد آمد. .IP "newgroup \fIgroup\fR [\fIstatus\fR [\fIcreator\fR]]" 4 .IX Item "newgroup group [status [creator]]" گروه خبری مشخص‌شده را ایجاد می‌کند. پارامتر \fIstatus\fR فیلد چهارم مدخل در فایل \fIactive\fR است، همان‌طور که در active(5) شرح داده شده است. اگر علامت مساوی نباشد، فقط کاراکتر اول استفاده می‌شود. \fIcreator\fR باید هویت شخصی باشد که گروه را ایجاد می‌کند. اگر گروه خبری از قبل وجود داشته باشد، این دستور معادل دستور \f(CW\*(C`changegroup\*(C'\fR خواهد بود. .Sp شناسه \fIcreator\fR\s-1،\s0 در صورت مشخص شدن با کدگذاری UTF\-8، می‌تواند حذف شود؛ در این صورت، مقدار پیش‌فرض آن newsmaster خواهد بود (همان‌طور که در زمان پیکربندی و ساخت مشخص شده، معمولاً \f(CW\*(C`usenet\*(C'\fR\c ). پارامتر \fIstatus\fR نیز می‌تواند حذف شود؛ در این صورت مقدار پیش‌فرض آن \f(CW\*(C`y\*(C'\fR (یک گروه عادی و بدون‌مدیر) خواهد بود. ترکیب این مقادیر پیش‌فرض استفاده مستقیم از متن فیلد هدر Control را ممکن می‌سازد (هرچند این کار را بدون بررسی اولیه صحت نحوی فیلد هدر انجام ندهید). .Sp این دستور فقط زمانی قابل اجراست که سرور در حال اجرا باشد یا به‌صورت دستی محدود (throttled) شده باشد. هنگام ارسال دستور \f(CW\*(C`go\*(C'\fR\s-1،\s0 وضعیت داخلی خود را به‌روزرسانی می‌کند. این دستور فایل \fIactive.times\fR را نیز به‌روزرسانی می‌کند. این دستور فوروارد می‌شود؛ بخش «نکات (NOTES)» را در ادامه ببینید. .IP "param \fIletter\fR \fIvalue\fR" 4 .IX Item "param letter value" پارامتر مشخص‌شده سرور را تغییر می‌دهد. \fIletter\fR گزینه خط فرمان \fBinnd\fR برای تنظیم است و \fIvalue\fR مقدار جدید است. برای مثال: .Sp .Vb 1 \& ctlinnd param i 5 .Ve .Sp به سرور دستور می‌دهد که فقط پنج اتصال ورودی را مجاز بداند. برای فعال یا غیرفعال کردن عملکرد فلگ \fB\-n\fR\s-1،\s0 از \f(CW\*(C`n\*(C'\fR برای حرف و به ترتیب از \f(CW\*(C`y\*(C'\fR یا \f(CW\*(C`n\*(C'\fR برای مقدار استفاده کنید. .Sp مقادیر پشتیبانی‌شده برای \fIletter\fR عبارت‌اند از: \f(CW\*(C`a\*(C'\fR\s-1،\s0 \f(CW\*(C`c\*(C'\fR\s-1،\s0 \f(CW\*(C`H\*(C'\fR\s-1،\s0 \f(CW\*(C`i\*(C'\fR\s-1،\s0 \f(CW\*(C`l\*(C'\fR\s-1،\s0 \f(CW\*(C`n\*(C'\fR\s-1،\s0 \f(CW\*(C`o\*(C'\fR\s-1،\s0 \f(CW\*(C`T\*(C'\fR\s-1،\s0 \f(CW\*(C`t\*(C'\fR و \f(CW\*(C`X\*(C'\fR\c . .IP "pause \fIreason\fR" 4 .IX Item "pause reason" سرور را موقتاً متوقف (مکث) می‌کند تا هیچ مقاله ورودی جدیدی پذیرفته نشود. هیچ‌یک از اتصال‌های موجود بسته نمی‌شوند، اما پایگاه‌داده تاریخچه بسته می‌شود. این دستور باید برای قفل‌های کوتاه‌مدت، مانند زمان جایگزینی پایگاه‌داده تاریخچه، استفاده شود. اگر سرور با فلگ \fB\-n y\fR راه‌اندازی نشده باشد، این دستور همچنین معادل اجرای دستور \f(CW\*(C`readers\*(C'\fR با فلگ \f(CW\*(C`no\*(C'\fR و متن \fIreason\fR با کدگذاری UTF\-8 خواهد بود. .IP "perl \fIflag\fR" 4 .IX Item "perl flag" فیلتر کردن پرل (Perl) را برای هر مقاله‌ای که توسط \fBinnd\fR دریافت می‌شود فعال یا غیرفعال می‌کند. این دستور تنها در صورتی در دسترس است که INN با پشتیبانی از فیلتر پرل ساخته شده باشد. اگر \fIflag\fR با حرف \f(CW\*(C`y\*(C'\fR شروع شود، فیلتر کردن فعال می‌شود؛ اگر با \f(CW\*(C`n\*(C'\fR شروع شود، فیلتر کردن غیرفعال خواهد شد. .Sp هنگامی که فیلتر غیرفعال می‌شود، اگر فیلتر پرل \fIfilter_innd.pl\fR تابعی به نام \f(CW\*(C`filter_end\*(C'\fR را تعریف کرده باشد، پیش از غیرفعال‌سازی فیلتر فراخوانی خواهد شد. .Sp توجه داشته باشید که فعال یا غیرفعال کردن فیلتر پرل برای هر پستی که توسط \fBnnrpd\fR دریافت می‌شود، با پارامتر دسترسی \fIperlfilter\fR در فایل \fIreaders.conf\fR تنظیم می‌شود. .IP "python \fIflag\fR" 4 .IX Item "python flag" فیلتر کردن پایتون (Python) را برای هر مقاله‌ای که توسط \fBinnd\fR دریافت می‌شود فعال یا غیرفعال می‌کند. این دستور تنها در صورتی در دسترس است که INN با پشتیبانی از فیلتر پایتون کامپایل شده باشد. اگر \fIflag\fR با \f(CW\*(C`y\*(C'\fR شروع شود، فیلتر فعال می‌شود؛ اگر با \f(CW\*(C`n\*(C'\fR شروع شود، فیلتر غیرفعال خواهد شد. .IP "readers \fIflag\fR \fItext\fR" 4 .IX Item "readers flag text" دسترسی خوانندگان را مجاز یا غیرمجاز می‌کند. اگر \fIflag\fR با حرف \f(CW\*(C`n\*(C'\fR شروع شود، خواندن با ارسال \fItext\fR به‌عنوان مقدار فلگ \fB\-r\fR به \fBnnrpd\fR غیرمجاز می‌شود. اگر \fIflag\fR با حرف \f(CW\*(C`y\*(C'\fR شروع شود و \fItext\fR یک رشته خالی یا همان رشته‌ای با کدگذاری UTF\-8 باشد که هنگام غیرفعال کردن خواندن استفاده شده بود، خواندن دوباره فعال خواهد شد. .Sp مزیت این پارامتر نسبت به \fInoreader\fR در فایل \fIinn.conf\fR این است که امکان تعیین یک پیام سفارشی را فراهم می‌کند. .Sp اگر \fBnnrpd\fR به‌جای ایجاد شدن توسط \fBinnd\fR\s-1،\s0 به‌صورت جداگانه اجرا شده باشد، این دستور هیچ اثری نخواهد داشت. .IP "reject \fIreason\fR" 4 .IX Item "reject reason" اتصال‌های از راه دور (آن‌هایی که به \fBnnrpd\fR تحویل داده نمی‌شوند) رد می‌شوند و \fIreason\fR با کدگذاری UTF\-8 به‌عنوان توضیح ارائه می‌گردد. اتصال‌های موجود بسته نمی‌شوند. .IP "reload \fIwhat\fR \fIreason\fR" 4 .IX Item "reload what reason" نسخه بارگذاری‌شده فایل‌های پیکربندی سرور در حافظه را به‌روزرسانی (بازخوانی) می‌کند. \fIwhat\fR مشخص می‌کند چه چیزی باید بازخوانی شود و \fIreason\fR در پیامی که به بارگذاری مجدد اشاره دارد به syslog گزارش می‌شود. .Sp هیچ راهی برای بازخوانی مجدد \fIinn.conf\fR\s-1،\s0 \fIstorage.conf\fR یا سایر فایل‌های پیکربندی برای بک‌اند ذخیره‌سازی یا مرور کلی (overview) وجود ندارد. برای اعمال تغییرات در آن فایل‌ها، از \f(CW\*(C`ctlinnd xexec innd\*(C'\fR برای راه‌اندازی مجدد \fBinnd\fR استفاده کنید. .Sp اگر \fIwhat\fR یک رشته خالی یا واژه \f(CW\*(C`all\*(C'\fR باشد، همه چیز دوباره بارگذاری می‌شود. اگر واژه \f(CW\*(C`history\*(C'\fR باشد، پایگاه‌داده تاریخچه بسته و دوباره باز می‌شود. اگر واژه \f(CW\*(C`incoming.conf\*(C'\fR باشد، فایل مربوطه مجدداً بارگذاری می‌شود. اگر واژه \f(CW\*(C`active\*(C'\fR یا \f(CW\*(C`newsfeeds\*(C'\fR باشد، هر دو فایل \fIactive\fR و \fInewsfeeds\fR مجدداً بارگذاری می‌شوند، که همچنین باعث تخلیه (flush) و راه‌اندازی مجدد تمام فیدهای خروجی خواهد شد. .Sp اگر \fIwhat\fR واژه \f(CW\*(C`filter.perl\*(C'\fR باشد، فایل \fIfilter_innd.pl\fR مجدداً بارگذاری می‌شود. (البته این فایل برای بارگذاری مجدد در دسترس نیست مگر اینکه INN با پشتیبانی از فیلتر پرل کامپایل شده باشد). اگر فیلتر پرل تابعی به نام \f(CW\*(C`filter_before_reload\*(C'\fR را تعریف کرده باشد، قبل از خواندن مجدد \fIfilter_innd.pl\fR فراخوانی خواهد شد. اگر تابع پرل \f(CW\*(C`filter_after_reload\*(C'\fR تعریف شده باشد، پس از بارگذاری مجدد \fIfilter_innd.pl\fR فراخوانی می‌شود. بارگذاری مجدد فیلتر پرل در صورت غیرفعال بودن فیلتر، آن را فعال نمی‌کند؛ برای این کار از \f(CW\*(C`perl y\*(C'\fR استفاده کنید. فایل \fIstartup_innd.pl\fR نمی‌تواند مجدداً بارگذاری شود. .Sp اگر \fIwhat\fR واژه \f(CW\*(C`filter.python\*(C'\fR باشد، فایل \fIfilter_innd.py\fR مجدداً بارگذاری می‌شود. (البته این فایل برای بارگذاری مجدد در دسترس نیست مگر اینکه INN با پشتیبانی از فیلتر پایتون کامپایل شده باشد). اگر متد پایتونی به نام \f(CW\*(C`filter_before_reload\*(C'\fR وجود داشته باشد، قبل از خواندن مجدد \fIfilter_innd.py\fR فراخوانی می‌شود. اگر متد پایتونی به نام \f(CW\*(C`_\|_init_\|_\*(C'\fR وجود داشته باشد، پس از بارگذاری مجدد \fIfilter_innd.py\fR فراخوانی خواهد شد. بارگذاری مجدد فیلتر پایتون در صورت غیرفعال بودن فیلتر، آن را فعال نمی‌کند؛ برای این کار از \f(CW\*(C`python y\*(C'\fR استفاده کنید. .IP "renumber \fIgroup\fR" 4 .IX Item "renumber group" نشانه‌های حداقل و حداکثر شماره مقالات (low water و high water marks) را برای \fIgroup\fR در فایل \fIactive\fR بر اساس اطلاعات پایگاه‌داده مرور کلی (overview) به‌روزرسانی می‌کند. صرف‌نظر از محتویات پایگاه‌داده overview، نشانه حداکثر کاهش نخواهد یافت. (کاهش آن ممکن است باعث تخصیص شماره‌های مقاله تکراری پس از بروز خرابی یا کرش شود که می‌تواند مشکلات جدی در روش ذخیره‌سازی tradspool ایجاد کند). اگر \fIgroup\fR رشته خالی باشد، تمام گروه‌های خبری شماره‌گذاری مجدد می‌شوند. شماره‌گذاری مجدد فقط در صورتی کار می‌کند که داده‌های overview ایجاد شده باشند (اگر \fIenableoverview\fR در \fIinn.conf\fR روی true تنظیم شده باشد). .IP "renumberlow \fIfile\fR" 4 .IX Item "renumberlow file" کاملاً مشابه دستور \f(CW\*(C`lowmark\*(C'\fR است. .IP "reserve \fIreason\fR" 4 .IX Item "reserve reason" دستور بعدی \f(CW\*(C`pause\*(C'\fR یا \f(CW\*(C`throttle\*(C'\fR را ملزم می‌کند که از \fIreason\fR با کدگذاری UTF\-8 به‌عنوان دلیل خود استفاده کند. این رزرو با دادن یک رشته خالی برای دلیل پاک می‌شود. این کار توسط برنامه‌هایی مانند \fBexpire\fR برای هماهنگ‌سازی مکث‌ها و محدودسازی‌های سرور و جلوگیری از تداخل با نمونه‌های دیگر خود استفاده می‌شود. .IP "rmgroup \fIgroup\fR" 4 .IX Item "rmgroup group" گروه خبری مشخص‌شده را حذف می‌کند. گروه از فایل \fIactive\fR حذف شده و اطلاعات مرور کلی آن پاک می‌شود، که باعث می‌شود بلافاصله برای خوانندگان غیرقابل دسترس گردد. بر خلاف دستور \f(CW\*(C`newgroup\*(C'\fR\s-1،\s0 این دستور فایل \fIactive.times\fR را به‌روزرسانی نمی‌کند. .Sp این دستور فقط زمانی قابل اجراست که سرور در حال اجرا باشد یا به‌صورت دستی محدود (throttled) شده باشد. این دستور فوروارد می‌شود؛ بخش «نکات (NOTES)» را در ادامه ببینید. .IP "send \fIfeed\fR \fItext\fR" 4 .IX Item "send feed text" متن مشخص‌شده \fItext\fR به‌عنوان یک خط کنترلی به فید exploder به نام \fIfeed\fR ارسال می‌شود. .IP "shutdown \fIreason\fR" 4 .IX Item "shutdown reason" سرور خاموش می‌شود، دلیل مشخص‌شده در لاگ ثبت شده و به تمام اتصال‌های باز فرستاده می‌شود. ایده خوبی است که ابتدا یک دستور \f(CW\*(C`throttle\*(C'\fR ارسال شود تا فیدها بتوانند به‌طور ملایم‌تر و منظم‌تری بسته شوند. .Sp اگر فیلتر پرل یا پایتون کامپایل شده و فعال باشد، توابع خاصی در هنگام \f(CW\*(C`throttle\*(C'\fR یا \f(CW\*(C`shutdown\*(C'\fR فراخوانی می‌شوند (برای مثال جهت ذخیره وضعیت فیلتر روی دیسک). برای جزئیات به مستندات فیلتر تعبیه‌شده مراجعه کنید. .IP "stathist (off | \fIfilename\fR)" 4 .IX Item "stathist (off | filename)" تولید آمار عملکرد پایگاه‌داده تاریخچه را فعال یا غیرفعال می‌کند. اگر پارامتر \f(CW\*(C`off\*(C'\fR باشد، هیچ آماری جمع‌آوری نمی‌شود. در غیر این صورت، آمار در فایل مشخص‌شده نوشته می‌شود. یک تجزیه‌کننده برای این فایل در شاخه contrib توزیع INN ارائه شده است. برای اطلاعات درباره نحوه تنظیم مقدار پیش‌فرض، به \fIstathist\fR در inn.conf(5) مراجعه کنید. .IP "status (off | \fIinterval\fR)" 4 .IX Item "status (off | interval)" تناوب زمانی گزارش اطلاعات وضعیت توسط \fBinnd\fR به syslog را تنظیم می‌کند. اگر \f(CW\*(C`off\*(C'\fR یا \f(CW\*(C`0\*(C'\fR به‌عنوان آرگومان داده شود، گزارش وضعیت خاموش می‌شود. در غیر این صورت، وضعیت هر \fIinterval\fR ثانیه یک‌بار گزارش خواهد شد. برای اطلاعات در مورد نحوه تنظیم مقدار پیش‌فرض، به \fIstatus\fR در inn.conf(5) مراجعه کنید. .IP "throttle \fIreason\fR" 4 .IX Item "throttle reason" تمام اتصال‌های ورودی و فیدهای خروجی موجود را می‌بندد و اتصال‌های جدید را رد می‌کند. پایگاه‌داده تاریخچه را می‌بندد. این دستور باید برای قفل‌های طولانی‌مدت یا برای اجرای تعداد زیادی از دستورهای \f(CW\*(C`newgroup\*(C'\fR و \f(CW\*(C`rmgroup\*(C'\fR بدون راه‌اندازی مجدد تمام فیدهای خروجی در میان هر یک از آن‌ها استفاده شود. (توجه داشته باشید که هنگام محدود بودن سرور، تغییر وضعیت گروه‌های خبری موجود امکان‌پذیر نیست). .Sp اگر سرور با فلگ \fB\-n y\fR شروع نشده باشد، این دستور همچنین معادل دستور \f(CW\*(C`readers\*(C'\fR با فلگ \f(CW\*(C`no\*(C'\fR و متن \fIreason\fR با کدگذاری UTF\-8 عمل خواهد کرد. .IP "timer (off | \fIinterval\fR)" 4 .IX Item "timer (off | interval)" تناوب زمانی گزارش اطلاعات عملکرد توسط \fBinnd\fR به syslog را تنظیم می‌کند. در صورتی که \f(CW\*(C`off\*(C'\fR یا \f(CW\*(C`0\*(C'\fR به‌عنوان آرگومان داده شود، نظارت بر عملکرد خاموش می‌شود. در غیر این صورت، آمار هر \fIinterval\fR ثانیه یک‌بار به syslog گزارش خواهد شد. برای اطلاعات در مورد نحوه تنظیم مقدار پیش‌فرض، به \fItimer\fR در inn.conf(5) مراجعه کنید. .IP "trace \fIitem\fR \fIflag\fR" 4 .IX Item "trace item flag" ردیابی (tracing) را برای \fIitem\fR مشخص‌شده روشن یا خاموش می‌کند. \fIflag\fR باید به ترتیب با حرف \f(CW\*(C`y\*(C'\fR یا \f(CW\*(C`n\*(C'\fR شروع شود تا ردیابی روشن یا خاموش گردد. اگر \fIitem\fR با یک عدد شروع شود، ردیابی برای کانال مشخص‌شده در \fBinnd\fR تنظیم می‌شود که باید یک فید ورودی NNTP باشد. اگر با حرف \f(CW\*(C`i\*(C'\fR شروع شود، ردیابی عمومی \fBinnd\fR روشن یا خاموش می‌شود. اگر با حرف \f(CW\*(C`n\*(C'\fR شروع شود، حسب مورد، در پردازش‌های آتی \fBnnrpd\fR که توسط \f(CW\*(C`innd\*(C'\fR ایجاد می‌شوند فلگ \fB\-t\fR اعمال خواهد شد یا خیر. این مورد هیچ تاثیری بر پردازش‌های در حال اجرای \fBnnrpd\fR یا پردازش‌های \fBnnrpd\fR که با روشی غیر از \fBinnd\fR شروع شده‌اند نخواهد داشت. .IP "xabort \fIreason\fR" 4 .IX Item "xabort reason" دلیل مشخص‌شده \fIreason\fR را در لاگ ثبت کرده و سپس پردازش را با شکست مواجه و متوقف (abort) می‌کند. در بیشتر سیستم‌ها، این کار باعث می‌شود \fBinnd\fR یک فایل core dump تولید کند. این دستور صرفاً برای اشکال‌زدایی مفید است. .IP "xexec \fIpath\fR" 4 .IX Item "xexec path" سرور را خاموش می‌کند، اما به جای خروج، \fBinnd\fR را با تمام آرگومان‌های اصلی آن به جز \fB\-r\fR دوباره اجرا (exec) می‌کند. \fIpath\fR می‌تواند \f(CW\*(C`innd\*(C'\fR یا یک رشته خالی باشد که هر دو معادل یکدیگرند. هر مقدار دیگری منجر به خطا خواهد شد. .Sp این ساده‌ترین راه برای راه‌اندازی نسخه جدیدی از \fBinnd\fR پس از ارتقا، یا بارگذاری مجدد فایل‌های پیکربندی است که نمی‌توان آن‌ها را از طریق دستور \f(CW\*(C`reload\*(C'\fR مجدداً بارگذاری کرد. .SH "نکات (NOTES)" .IX Header "NOTES" علاوه بر اقدام توسط سرور، برخی از دستورها می‌توانند به یک پردازش فرزند مناسب فوروارد (ارسال) شوند. اگر سایتی که دستور را دریافت می‌کند یک exploder (مانند \fBbuffchan\fR\c ) یا یک funnel باشد که به یک exploder متصل است، دستور می‌تواند فوروارد شود. در این حالت، سرور یک خط فرمان متشکل از نام دستور \fBctlinnd\fR را به exploder ارسال می‌کند. اگر سایت به یک exploder متصل باشد که در فلگ \f(CW\*(C`W\*(C'\fR خود یک ستاره (\f(CW\*(C`*\*(C'\fR) دارد (برای اطلاعات بیشتر در مورد مشخصات فیدها به newsfeeds(5) مراجعه کنید)، نام سایت به انتهای دستور اضافه می‌شود؛ در غیر این صورت هیچ آرگومانی اضافه نخواهد شد. .SH "اشکالات (BUGS)" .IX Header "BUGS" دستور \&\fBctlinnd\fR در اکثر سیستم‌ها برای برقراری ارتباط با \&\fBinnd\fR از سوکت‌های دامنه یونیکس (Unix domain sockets) استفاده می‌کند و بنابراین به حداکثر اندازه بسته‌ای که سیستم‌عامل برای دیتاگرام‌های دامنه یونیکس تحمیل می‌کند محدود است. این موضوع ممکن است به این معنی باشد که در برخی سیستم‌ها پاسخ‌های سرور به 4\ KB محدود می‌شوند. .SH "تاریخچه (HISTORY)" .IX Header "HISTORY" توسط Rich $alz برای InterNetNews نوشته شده است. نگارش مجدد در قالب POD توسط Russ Allbery انجام شده است. .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" active(5), active.times(5), buffchan(8), incoming.conf(5), innd(8), inn.conf(5), libinn_inndcomm(3), newsfeeds(5), nnrpd(8).