.\" -*- 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 "INNXMIT 8"
.TH INNXMIT 8 2025-05-09 "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)"
innxmit \- ارسال مقاله‌های یوزنت به یک کارگزار راه‌دور NNTP
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fBinnxmit\fR [\fB\-acdHlprsv\fR] [\fB\-P\fR \fIportnum\fR] [\fB\-T\fR \fIseconds\fR]
[\fB\-t\fR \fIseconds\fR] \fIhost\fR \fIfile\fR
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
دستور
\&\fBinnxmit\fR
به کارگزار NNTP در میزبان مشخص‌شده
(\fIhost\fR)
متصل می‌شود (در صورتی که اعتبارنامه‌های احراز هویت برای کارگزار راه‌دور در پروندهٔ
\fIpasswd.nntp\fR
موجود باشد، هویت خود را از طریق آن اعتبارسنجی می‌کند) و مقاله‌های مشخص‌شده در پروندهٔ دسته‌ای به نام
\fIfile\fR
را به آن ارسال می‌کند. این برنامه معمولاً توسط اسکریپتی فراخوانی می‌شود که از طریق
cron(8)
اجرا شده و از
\&\fBshlock\fR
برای قفل کردن نام میزبان استفاده می‌کند و به دنبال آن از یک دستور
\&\fBctlinnd\fR
برای تخلیه (flush) پروندهٔ دسته‌ای بهره می‌برد. اگر
\fIfile\fR
یک مسیر مطلق نباشد، نسبت به دایرکتوری مشخص‌شده توسط پارامتر
\fIpathoutgoing\fR
در
\fIinn.conf\fR
در نظر گرفته می‌شود. این پرونده معمولاً با مشخص کردن پرچم‌های
\&\f(CW\*(C`Wnm\*(C'\fR
در پروندهٔ
\fInewsfeeds\fR
نوشته می‌شود. هر خط در پروندهٔ دسته‌ای باید در یکی از قالب‌های زیر باشد:
.PP
.Vb 2
\&    article Message\-ID
\&    article
.Ve
.PP
فیلد اول یا توکن API ذخیره‌سازی
(storage API token)
یک مقاله است یا نام پرونده‌ای که حاوی مقاله است. اگر این فیلد یک مسیر مطلق یا توکن API ذخیره‌سازی نباشد، به‌عنوان یک نام پرونده نسبی به
\&\fIpatharticles\fR
در
\fIinn.conf\fR
در نظر گرفته می‌شود. اگر فیلد دوم مشخص نشده باشد، شناسه پیام (Message-ID) با پویش مقاله به دست خواهد آمد. این دو فیلد در صورت وجود، با یک فاصله از یکدیگر جدا می‌شوند. اگر یک خطای ارتباطی مانند شکست در
write(2)
رخ دهد،
\&\fBinnxmit\fR
ارسال را متوقف کرده و پروندهٔ دسته‌ای را بازنویسی می‌کند تا حاوی مقاله فعلی و هر مقاله ارسال‌نشدهٔ دیگر باشد.
.PP
یک جایگزین برای
\&\fBinnxmit\fR
می‌تواند
\&\fBinnduct\fR
باشد که در صفحه راهنمای
innfeed(8)
به آن اشاره شده است.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP \fB\-a\fR 4
.IX Item "-a"
اگر تمام مقاله‌ها با موفقیت ارسال شوند،
\&\fBinnxmit\fR
پروندهٔ دسته‌ای را حذف خواهد کرد؛ در غیر این صورت آن را بازنویسی می‌کند تا حاوی فهرست مقاله‌های ارسال‌نشده باشد. اگر هیچ مقاله‌ای ارسال یا رد نشود، پرونده دست‌نخورده باقی می‌ماند. اگر مقاله‌های زیادی منقضی شده باشند و مشکلات ارتباطی وجود داشته باشد، این امر می‌تواند باعث رشد بیش از حد پروندهٔ دسته‌ای شود. برای اینکه پروندهٔ دسته‌ای همیشه بازنویسی شود، از پرچم
\&\fB\-a\fR
استفاده کنید.
.IP \fB\-c\fR 4
.IX Item "-c"
در حالت جریانی (streaming mode)، بررسی هر Message-ID انجام می‌شود تا از ارسال مقاله‌هایی که قبلاً روی کارگزار راه‌دور وجود دارند خودداری شود. پس از پذیرش تعداد معینی مقاله به صورت متوالی،
\&\fBinnxmit\fR
دیگر این پرس‌وجوها را ارسال نمی‌کند، اما به محض دریافت یک پیام رد (که ممکن است به دلیلی غیر از تکراری بودن باشد، مانند یک گروه خبری ناخواسته)، دوباره به ارسال آن‌ها بازمی‌گردد.
.Sp
پرچم
\&\fB\-c\fR
در صورت پشتیبانی از حالت جریانی، باعث می‌شود مقاله‌ها همیشه بدون بررسی ارسال شوند. این کار منجر به توان عملیاتی (throughput) کمی بیشتر می‌شود و ممکن است زمانی که مشخص است سایت مقصد نمی‌تواند از قبل مقاله‌ها را داشته باشد (مانند یک سایت «برگ» یا leaf)، مناسب باشد.
.IP \fB\-d\fR 4
.IX Item "-d"
از پرچم
\&\fB\-d\fR
برای چاپ اطلاعات اشکال‌زدایی روی خروجی خطای استاندارد استفاده کنید. این کار تراکنش‌های پروتکل بین
\&\fBinnxmit\fR
و کارگزار NNTP در میزبان راه‌دور را نشان می‌دهد.
.IP \fB\-H\fR 4
.IX Item "-H"
اگر پرچم
\&\fB\-H\fR
داده شود، برای تمام مقاله‌ها به جز پیام‌های کنترلی، تنها سرایندها (headers) به
\fIhost\fR
ارسال می‌شوند. همچنین فیلد سرایند Bytes حتی اگر در مقاله اصلی وجود نداشته باشد، گنجانده می‌شود. پرچم
\&\fB\-H\fR
برای Diablo reader مفید است.
.IP \fB\-l\fR 4
.IX Item "-l"
پرچم
\&\fB\-l\fR
برای فعال‌سازی ثبت (logging) دلایلی که کارگزار راه‌دور برای رد یک مقاله ارائه می‌دهد، استفاده می‌شود.
.IP "\fB\-P\fR \fIportnum\fR" 4
.IX Item "-P portnum"
برای مشخص کردن شماره درگاهی غیر از مقدار پیش‌فرض، از پرچم
\&\fB\-P\fR
استفاده کنید.
.IP \fB\-p\fR 4
.IX Item "-p"
اگر پرچم
\&\fB\-p\fR
داده شود، هیچ اتصالی برقرار نمی‌شود و پروندهٔ دسته‌ای از ورودی‌هایی که به پرونده‌های ناموجود اشاره دارند پاک‌سازی می‌شود. این پرچم متضمن گزینهٔ
\&\fB\-a\fR
است.
.IP \fB\-r\fR 4
.IX Item "-r"
اگر کارگزار راه‌دور کد پاسخ غیرمنتظره‌ای ارسال کند،
\&\fBinnxmit\fR
مقاله را دوباره در صف قرار داده و ادامه می‌دهد. اگر مقاله نباید مجدداً در صف قرار گیرد، از پرچم
\&\fB\-r\fR
استفاده کنید.
.IP \fB\-s\fR 4
.IX Item "-s"
دستور
\&\fBinnxmit\fR
در هنگام اتصال تلاش خواهد کرد تا افزونهٔ حالت جریانی پروتکل NNTP را با کارگزار مذاکره کند. در صورت موفقیت، از پروتکل کمی متفاوت استفاده می‌کند که توان عملیاتی را بهبود می‌بخشد. اگر کارگزار مذاکرهٔ حالت جریانی را به رسمیت نشناسد،
\&\fBinnxmit\fR
به حالت انتقال عادی NNTP بازمی‌گردد. برای غیرفعال کردن تلاش جهت مذاکره دربارهٔ افزونهٔ حالت جریانی، از پرچم
\&\fB\-s\fR
استفاده کنید.
.IP "\fB\-T\fR \fIseconds\fR" 4
.IX Item "-T seconds"
برای مشخص کردن کل مدت زمانی که باید برای انتقال مقاله‌ها مجاز باشد، از پرچم
\&\fB\-T\fR
استفاده کنید. مقدار پیش‌فرض این است که تا زمان وقوع یک خطای I/O یا انتقال تمام مقاله‌ها صبر کند. اگر پرچم
\&\fB\-T\fR
استفاده شود، زمان درست پیش از شروع هر مقاله بررسی می‌شود؛ این گزینه انتقالی را که در حال انجام است لغو نخواهد کرد.
.IP "\fB\-t\fR \fIseconds\fR" 4
.IX Item "-t seconds"
دستور
\&\fBinnxmit\fR
معمولاً تا زمان برقراری اتصال مسدود می‌شود. برای تعیین مهلت زمانی (timeout) برای مدت تلاش جهت برقراری اتصال، از پرچم
\&\fB\-t\fR
استفاده کنید.
.IP \fB\-v\fR 4
.IX Item "-v"
هنگام خروج،
\&\fBinnxmit\fR
آمار انتقال و میزان استفاده از پردازنده (CPU) را از طریق syslog گزارش می‌دهد. اگر پرچم
\&\fB\-v\fR
استفاده شود، این آمار در خروجی استاندارد نیز چاپ خواهند شد.
.SH "تاریخچه (HISTORY)"
.IX Header "HISTORY"
نوشته‌شده توسط Rich $alz <rsalz@uunet.uu.net> برای InterNetNews. تبدیل‌شده به POD توسط Julien Elie.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
ctlinnd(8), inn.conf(5), innd(8), newsfeeds(5), passwd.nntp(5), shlock(8).