.\" -*- 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 "CONTROLCHAN 8"
.TH CONTROLCHAN 8 2025-03-29 "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)"
controlchan \- پردازش پیام‌های کنترلی درون-باندی INN
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fBcontrolchan\fR [\fB\-ch\fR]
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
ابزار
\&\fBcontrolchan\fR
مسئولیت رسیدگی به پیام‌های کنترلی (به جز لغوها یا cancels) را از
\&\fBinnd\fR
برداشته و در عوض آن‌ها را از یک فید کانال یا فایل پردازش می‌کند.
.PP
دو ماژول پرل
\&\f(CW\*(C`Encode\*(C'\fR
و
\&\f(CW\*(C`MIME::Parser\*(C'\fR
برای اجرای
\&\fBcontrolchan\fR
مورد نیاز هستند.
.PP
برای کاهش بار سیستم،
\&\fBcontrolchan\fR
یک نسخه از
\&\fIcontrol.ctl\fR
و
\&\fIcontrol.ctl.local\fR
را در حافظه نگه می‌دارد و پیش از فراخوانی هر اسکریپت، مجوزها (شامل سرآیندهای لازم PGP) را بررسی می‌کند. این دو فایل پیکربندی هر زمان که
\&\fBcontrolchan\fR
متوجه تغییر آن‌ها شود، به‌طور خودکار دوباره بارگذاری می‌شوند. همچنین، حالت پیش‌فرض مقاله کنترلی ناشناخته به‌صورت داخلی مدیریت می‌شود. مورد
\&\f(CW\*(C`drop\*(C'\fR
نیز با پیچیدگی بسیار کمتری رسیدگی می‌شود.
.PP
به‌طور معمول،
\&\fBcontrolchan\fR
توسط
\&\fBinnd\fR
طبق تنظیمات در
\&\fInewsfeeds\fR
فراخوانی می‌شود. یک ورودی نمونه در زیر آمده است. اطمینان حاصل کنید گروه خبری
\&\f(CW\*(C`control.cancel\*(C'\fR
وجود داشته باشد تا
\&\fBcontrolchan\fR
مجبور به بررسی پیام‌های لغو (cancels) نباشد، که در هر صورت آن‌ها را پردازش نمی‌کند.
.PP
.Vb 4
\&    controlchan!\e
\&        :!*,control,control.*,!control.cancel\e
\&        :AC,Tc,Wnsm\e
\&        :<pathbin in inn.conf>/controlchan
.Ve
.PP
همچنین می‌توان
\&\fBcontrolchan\fR
را به‌صورت دستی تنها با ارسال مسیر یک فایل (شامل یک مقاله کنترلی کامل به همراه سرآیندها و متن آن) یا یک توکن در ورودی استاندارد اجرا کرد:
.PP
.Vb 2
\&    echo \*(Aq/path/to/a/control/article\*(Aq | controlchan
\&    echo \*(Aq@0303465234000000000000235AE000000002@\*(Aq | controlchan
.Ve
.PP
توجه داشته باشید در شرایط (بسیار نامحتمل) که نیاز به پردازش پیام‌های کنترلی ihave/sendme باشد، مطمئن شوید
\&\fIlogipaddr\fR
در
\&\fIinn.conf\fR
روی false تنظیم شده باشد؛ زیرا در این حالت
\&\fBcontrolchan\fR
به نام سایت نیاز دارد، نه آدرس IP.
.PP
\&\fBcontrolchan\fR
تلاش می‌کند تمام پیام‌های لاگ را از طریق
\&\fBsyslog\fR\|(3)
گزارش دهد، مگر اینکه به ترمینال تعاملی متصل باشد.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP \fB\-c\fR 4
.IX Item "-c"
به‌طور پیش‌فرض،
\&\fBcontrolchan\fR
مقالاتی را که فیلدهای سرآیند Date یا Injection-Date آن‌ها بیش از حد در گذشته (بیشتر از
\&\fIartcutoff\fR
روز، تعیین‌شده در
\&\fIinn.conf\fR)
یا یک روز در آینده باشد پردازش نمی‌کند. این امر امکان جلوگیری از بازپخش مخرب مقالات کنترلی قدیمی را فراهم می‌کند.
.Sp
استفاده از پرچم
\&\fB\-c\fR
این بررسی تاریخ انقضا (cutoff date) را غیرفعال می‌کند.
.IP \fB\-h\fR 4
.IX Item "-h"
اطلاعات نحوه استفاده را نمایش می‌دهد.
.SH "تاریخچه (HISTORY)"
.IX Header "HISTORY"
نوشته‌شده توسط Katsuhiro Kondou <kondou@nec.co.jp> برای InterNetNews. تبدیل به POD توسط Julien Elie.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBcontrol.ctl\fR\|(5), \fBinn.conf\fR\|(5).