.\" -*- 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 "RNEWS 1"
.TH RNEWS 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)"
rnews \- تزریق مقاله‌های منفرد و دسته‌های مقالات UUCP
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fBrnews\fR [\fB\-abdNUv\fR] [\fB\-h\fR \fIhost\fR] [\fB\-P\fR \fIport\fR] [\fB\-rS\fR \fIserver\fR]
[\fIfile\fR]
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
دستور
\&\fBrnews\fR
مقاله‌های منفرد یا دسته‌های مقالات به سبک UUCP را به یک کارساز اخبار محلی یا دوردست تزریق می‌کند. این برنامه مقاله‌ها را از طریق فرمان IHAVE ارسال کرده و برای تزریق مقاله‌های دریافت شده از سایر منابع مناسب است؛ برای ارسال‌های محلی معمولاً باید از
.BR inews (1)
استفاده شود. همچنین برای پردازش پیام‌های صف‌بندی‌شده‌ای که به عنوان مثال توسط
\fBnnrpd\fR
در زمان عدم دسترسی به
\fBinnd\fR
ایجاد شده‌اند، استفاده می‌شود.
.PP
اگر اطلاعات احراز هویت برای کارساز دوردست در فایل
\fIpasswd.nntp\fR
واقع در مسیر
\fIpathetc\fR
موجود باشد، آنگاه
\&\fBrnews\fR
از آن‌ها برای احراز هویت استفاده خواهد کرد.
.PP
پیام در صورت مشخص شدن از
\fIfile\fR،
فایل‌های صف‌بندی‌شده (با گزینه
\fB\-U\fR)
یا در صورت مشخص نشدن هیچ فایلی از ورودی استاندارد خوانده می‌شود. مقاله‌ها در صورت مشخص بودن گزینه‌های خط فرمان
\fB\-r\fR
یا
\fB\-S\fR
به کارساز مشخص‌شده ارسال می‌شوند؛ در غیر این صورت به کارساز تنظیم‌شده از طریق
\fInnrpdposthost\fR
در
\fIinn.conf\fR،
وگرنه به کارساز محلی در
\f(CW\*(C`127.0.0.1\*(C'\fR
و در نهایت به کارساز تنظیم‌شده توسط
\fIserver\fR
در
\fIinn.conf\fR
ارسال می‌گردند.
.PP
هنگام ارسال از طریق UUCP، مقاله‌های یوزنت (Usenet) معمولاً در یک دسته واحد جمع‌آوری می‌شوند تا سربار UUCP کاهش یابد. دسته‌ها همچنین می‌توانند فشرده‌سازی شوند تا زمان ارتباط کاهش یابد. اگر ورودی به
\&\fBrnews\fR
با نویسه‌های
\f(CW\*(C`#!\*(C'\fR
آغاز نشود، به عنوان یک مقاله خبری منفرد تلقی می‌شود؛ در غیر این صورت، سطر نخست ورودی به عنوان یک دستور دسته‌ای تفسیر می‌گردد.
.PP
اگر دستور دسته‌ای به این صورت باشد:
.PP
.Vb 1
\&    #! rnews <number>
.Ve
.PP
آنگاه به اندازه <number> بایت بعدی (با شروع از سطر بعد) به عنوان یک مقاله خبری خوانده می‌شود. پس از پردازش آن مقاله، سطر بعدی مجدداً به عنوان یک دستور دسته‌ای تلقی خواهد شد.
.PP
اگر دستور به این صورت باشد:
.PP
.Vb 1
\&    #! cunbatch
.Ve
.PP
آنگاه باقی‌مانده ورودی برای خارج شدن از حالت فشرده به
\f(CW\*(C`gzip \-d\*(C'\fR
داده می‌شود، و سپس خروجی غیرفشرده حاصل به‌گونه‌ای بازخوانی می‌شود که گویی ورودی اصلی به
\&\fBrnews\fR
بوده است. بنابراین یک دسته فشرده‌شده باید با این سطر آغاز شود و شامل دسته‌ای از مقاله‌ها باشد که با سطرهای
\f(CW\*(C`#!\ rnews\*(C'\fR
از هم جدا شده و سپس با
.BR compress (1)
فشرده شده‌اند. (دسته‌های فشرده‌شده با
.BR gzip (1)
باید در عوض از
\f(CW\*(C`gunbatch\*(C'\fR
به عنوان دستور دسته‌ای استفاده کنند؛ INN صرفاً به این دلیل از
\fBgzip\fR
به جای
\fBcompress\fR
استفاده می‌کند زیرا می‌تواند فشرده‌سازی به سبک
\fBcompress\fR
را مدیریت کند و به دلیل مسائل مربوط به حق اختراع‌های قدیمی، نسبت به
\fBcompress\fR
به طور گسترده‌تری در دسترس است.)
.PP
در غیر این صورت، اگر دستور هر کلمه دیگری باشد و گزینه
\fB\-a\fR
داده نشده باشد،
\&\fBrnews\fR
تلاش می‌کند برنامه‌ای با آن نام را اجرا کند و به دنبال آن در پوشه
\fIpathbin\fR/rnews.libexec
می‌گردد. باقی‌مانده دسته به ورودی استاندارد آن برنامه داده شده و خروجی استاندارد برنامه به‌گونه‌ای در نظر گرفته می‌شود که گویی ورودی اصلی به
\&\fBrnews\fR
بوده است. INN به همراه سه پردازشگر استاندارد دسته به شرح زیر ارائه می‌شود:
.IP \fBbunbatch\fR 2
.IX Item "bunbatch"
این پردازشگر
\fBbzip2\fR
را فراخوانی می‌کند و باید برای دسته‌های فشرده‌شده با
\fBbzip2\fR
به کار رود.
.IP \fBc7unbatch\fR 2
.IX Item "c7unbatch"
این پردازشگر یک کدگذاری ASCII را خنثی می‌کند تا جریان باینری فشرده‌شده اصلی بازیابی شود و سپس آن را طبق آنچه در بالا توضیح داده شد از حالت فشرده خارج می‌سازد.
.IP \fBgunbatch\fR 2
.IX Item "gunbatch"
این پردازشگر
\fBgzip\fR
را فراخوانی می‌کند و باید برای دسته‌های فشرده‌شده با
\fBgzip\fR
به کار رود.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP \fB\-a\fR 4
.IX Item "-a"
به طور پیش‌فرض،
\&\fBrnews\fR
به دنبال برنامه‌های بازگشایی بسته اضافی در زیرپوشه
\&\fIrnews.libexec\fR
از مسیر
\fIpathbin\fR
(همان‌طور که در
\fIinn.conf\fR
تنظیم شده) می‌گردد. اگر گزینه
\fB\-a\fR
داده شود، از هیچ پردازشگر دسته‌ای اضافی استفاده نخواهد شد؛ تنها
\&\f(CW\*(C`rnews\*(C'\fR
و
\f(CW\*(C`cunbatch\*(C'\fR
به عنوان دستورات دسته‌ای معتبر شناخته خواهند شد.
.IP \fB\-b\fR 4
.IX Item "-b"
به طور پیش‌فرض،
\&\fBrnews\fR
تمام مقالاتی را که توسط کارساز رد شوند یا به هر دلیلی (مانند مفقود بودن فیلد سربرگ) توسط
\&\fBrnews\fR
قابل تجزیه نباشند، ثبت و دور می‌ریزد. اگر گزینه
\fB\-b\fR
داده شود، از مقالات ردشده در زیرپوشه
\fIbad\fR
از مسیر
\fIpathincoming\fR
(تنظیم‌شده در
\fIinn.conf\fR)
یک نسخه پشتیبان نیز تهیه خواهد شد.
.IP \fB\-d\fR 4
.IX Item "-d"
اگر گزینه
\fB\-d\fR
داده شود،
\&\fBrnews\fR
شناسه پیام (message-ID) و بدنه فیلد سربرگ Path هر مقاله‌ای را که توسط کارساز به عنوان تکراری رد شود، از طریق syslog ثبت می‌کند.
.IP "\fB\-h\fR \fIhost\fR" 4
.IX Item "-h host"
اگر گزینه
\fB\-h\fR
داده شود،
\&\fBrnews\fR
شناسه پیام و
\fIhost\fR
را از طریق syslog برای هر مقاله‌ای که به کارساز پیشنهاد می‌دهد ثبت می‌کند. این گزینه همراه با یک فید UUCP برای دریافت لاگ پیام‌های دریافت شده از طریق آن فید به کار می‌رود. همچنین اگر متغیر محیطی UU_MACHINE مقداردهی شده باشد این عمل انجام می‌شود، اما تنها در صورتی صورت می‌پذیرد که
\fIhost\fR
یک رشته خالی نباشد. (بنابراین می‌توانید حتی در صورت تنظیم بودن UU_MACHINE با ارسال گزینه
\f(CW\*(C`\-h \*(Aq\*(Aq\*(C'\fR
به
\&\fBrnews\fR
ثبت لاگ را خاموش کنید.)
.IP \fB\-N\fR 4
.IX Item "-N"
در حالت عادی، اگر بازگشایی دسته ورودی ناموفق باشد، برای تلاش دوباره در آینده مجدداً در
\&\fIpathincoming\fR
صف‌بندی می‌شود. اگر گزینه
\fB\-N\fR
داده شود، هیچ صف‌بندی مجددی انجام نمی‌گیرد و در صورت شکست در بازگشایی،
\&\fBrnews\fR
با وضعیت خروج ۹ پایان می‌یابد.
.IP "\fB\-P\fR \fIport\fR" 4
.IX Item "-P port"
استفاده از
\fIport\fR
به عنوان پورت کارساز برای اتصال به جای
\fInnrpdpostport\fR
(همان‌طور که در
\fIinn.conf\fR
تنظیم شده). توجه داشته باشید که این مقدار تنها زمانی استفاده می‌شود که
\&\fBrnews\fR
به کارساز محلی متصل نشود (به عبارت دیگر، هنگامی که گزینه
\fB\-r\fR
یا
\fB\-S\fR
داده شده یا
\fInnrpdposthost\fR
تنظیم شده باشد).
.IP "\fB\-r\fR \fIserver\fR, \fB\-S\fR \fIserver\fR" 4
.IX Item "-r server, -S server"
گزینه‌های
\&\fB\-r\fR
و
\fB\-S\fR
هم‌معنی هستند. اگر هر یک از آن‌ها داده شود، مقاله‌ها به جای استفاده از کارساز محلی به
\fIserver\fR
ارسال می‌شوند که این کار تنظیم
\fInnrpdposthost\fR
در
\fIinn.conf\fR
را نیز لغو (بازنویسی) می‌کند.
.IP \fB\-U\fR 4
.IX Item "-U"
اگر کارساز در دسترس نباشد، هر دو برنامه
\&\fBrnews\fR
و
\fBnnrpd\fR
ارسال‌ها را در فایل‌های جدید در پوشه
\fIpathincoming\fR
(مشخص‌شده در
\&\fIinn.conf\fR)
صف‌بندی می‌کنند. هنگامی که
\&\fBrnews\fR
با گزینه
\fB\-U\fR
فراخوانی شود، آن پوشه را پیمایش کرده و تمام پیام‌های صف‌بندی‌شده موجود در آنجا را که نام فایل آن‌ها با
\f(CW\*(C`.\*(C'\fR
آغاز نمی‌شود پردازش می‌کند و تلاش می‌کند تا آن‌ها را دوباره به کارساز ارسال کند. اجرای دوره‌ای این دستور از طریق cron برای دریافت و ارسال مقالاتی که به دلیل عدم دسترسی موقت کارساز صف‌بندی شده‌اند، ایده مناسبی است.
.IP \fB\-v\fR 4
.IX Item "-v"
فعال‌سازی حالت پرگویی (verbose) با ردگیری‌های بیشتر، به‌ویژه ثبت دلیل رد شدن مقالات توسط کارساز در لاگ.
.SH "اشکالات (BUGS)"
.IX Header "BUGS"
دستور
\&\fBrnews\fR
نمی‌تواند مقالاتی را که دارای نویسه‌های تهی (null) درون‌سازی‌شده هستند پردازش کند. (در حال حاضر سایر بخش‌های INN نیز قادر به این کار نیستند.)
.SH "تاریخچه (HISTORY)"
.IX Header "HISTORY"
نوشته‌شده توسط Rich $alz <rsalz@uunet.uu.net> برای InterNetNews. بازنویسی در قالب POD توسط Russ Allbery <eagle@eyrie.org>.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
.BR bzip2 (1),
.BR compress (1),
.BR gzip (1),
.BR inews (1),
.BR inn.conf (5),
.BR innd (8),
.BR nnrpd (8),
.BR passwd.nntp (5).