.\" -*- 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 "INNXBATCH 8" .TH INNXBATCH 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)" innxbatch, sendxbatches \- ارسال مقاله‌های دسته‌ای یوزنت (xbatched) به سرور دوردست NNTP .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" \&\fBinnxbatch\fR [\fB\-Dv\fR] [\fB\-t\fR \fItimeout\fR] [\fB\-T\fR \fItimeout\fR] \fIhost\fR \fIfile\fR [\fIfile\fR ...] .PP \&\fBinnxbatch\fR \fB\-i\fR [\fB\-Dv\fR] [\fB\-t\fR \fItimeout\fR] [\fB\-T\fR \fItimeout\fR] \fIhost\fR .PP \&\fBsendxbatches\fR \fIsitename\fR \fIhost\fR \fIfile\fR [\fIfile\fR ...] .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" دستور \&\fBinnxbatch\fR به درگاه ۱۱۹ کارگزار NNTP در میزبان مشخص‌شده (\fIhost\fR) متصل می‌شود و پرونده‌های xbatch مشخص‌شده را با استفاده از افزونهٔ XBATCH در پروتکل NNTP برای آن ارسال می‌کند. این پرونده‌ها یا از طریق خط فرمان مشخص می‌شوند یا در صورت استفاده از گزینهٔ \&\fB\-i\fR از ورودی استاندارد خوانده می‌شوند. .PP هر پرونده پس از انتقال موفقیت‌آمیز، حذف می‌شود. .PP اگر یک خطای ارتباطی مانند شکست در write(2) یا یک پاسخ غیرمنتظره از کارگزار راه‌دور رخ دهد، \&\fBinnxbatch\fR ارسال را متوقف کرده و تمام پرونده‌های باقی‌مانده را برای تلاش مجدد در آینده، دست‌نخورده باقی می‌گذارد. .PP اگر اطلاعات و اعتبارنامه‌های احراز هویت کارگزار راه‌دور در پروندهٔ \&\fIpasswd.nntp\fR در دایرکتوری \&\fIpathetc\fR موجود باشد، \&\fBinnxbatch\fR از آن‌ها برای احراز هویت استفاده خواهد کرد. .PP دستور \&\fBinnxbatch\fR به خودی خود از هیچ سازوکار قفل‌گذاری پرونده استفاده نمی‌کند. در بدترین حالت، یک دسته ممکن است توسط دو اجرای مستقل و همزمان از \&\fBinnxbatch\fR دو بار به صورت موازی ارسال شود. برای جلوگیری از این رخداد، این برنامه باید توسط اسکریپتی فراخوانی شود که از طریق cron(8) اجرا شده و از shlock(8) برای قفل کردن نام میزبان بهره می‌برد، و به دنبال آن دستور \&\f(CW\*(C`ctlinnd flush\*(C'\fR برای تخلیه (flush) پروندهٔ دسته‌ای اجرا شود. \&\fBsendxbatches\fR چنین پوششی (wrapper) برای \&\fBinnxbatch\fR است. این اسکریپت اطمینان حاصل می‌کند که تنها یک نمونه اجرا می‌شود، \fIsitename\fR (همان‌طور که در ورودی \&\fInewsfeeds\fR استفاده شده) را تخلیه (flush) می‌کند و پرونده‌های داده‌شده به عنوان آرگومان را به \fIhost\fR ارسال می‌نماید. .PP از آنجا که افزونهٔ XBATCH یک دستور استاندارد در پروتکل NNTP نیست، برخی از کارگزارهای خبری آن را شناسایی نمی‌کنند. علاوه بر این، برای پذیرش دسته‌ها از همتایان راه‌دور از طریق XBATCH، باید این قابلیت را به صراحت با تنظیم \fIxbatch\fR در پروندهٔ \fIincoming.conf\fR فعال کنید. به جای استفاده از \&\fBinnxbatch\fR می‌توانید استفاده از \&\fBinnfeed\fR یا در صورت عدم امکان آن، \&\fBnntpsend\fR را در نظر بگیرید. .SH "گزینه‌ها (OPTIONS)" .IX Header "OPTIONS" .IP \fB\-D\fR 4 .IX Item "-D" اطلاعات اشکال‌زدایی را روی خروجی خطای استاندارد چاپ می‌کند. این کار تراکنش‌های پروتکل میان \&\fBinnxbatch\fR و کارگزار NNTP در میزبان راه‌دور را نمایش می‌دهد. .IP \fB\-i\fR 4 .IX Item "-i" نام‌های پرونده‌های دسته‌ای را از ورودی استاندارد می‌خواند. به ازای هر دسته که با موفقیت منتقل شود، عبارت \&\f(CW\*(C`OK\*(C'\fR روی خروجی استاندارد چاپ می‌شود تا نشان دهد نام پروندهٔ دیگری مورد انتظار است. .IP "\fB\-t\fR \fItimeout\fR" 4 .IX Item "-t timeout" مهلت زمانی (timeout) بر حسب ثانیه را برای مدت تلاش جهت برقراری اتصال مشخص می‌کند. در غیر این صورت، \&\fBinnxbatch\fR به طور معمول تا زمان برقراری اتصال مسدود می‌شود. .IP "\fB\-T\fR \fItimeout\fR" 4 .IX Item "-T timeout" کل مدت زمان مجاز (بر حسب ثانیه) برای انتقال مقاله‌ها را مشخص می‌کند. .Sp حالت پیش‌فرض این است که برنامه تا زمان وقوع یک خطای ورودی/خروجی (I/O) یا انتقال کامل تمام مقاله‌ها منتظر بماند. اگر این پرچم استفاده شود، زمان درست پیش از آغاز انتقال هر مقاله بررسی می‌شود؛ این گزینه انتقالی را که هم‌اکنون در جریان است لغو نخواهد کرد. .IP \fB\-v\fR 4 .IX Item "-v" هنگام خروج، \&\fBinnxbatch\fR آمار انتقال و میزان استفاده از پردازنده (CPU) را از طریق syslog(3) گزارش می‌دهد. در صورت استفاده از این پرچم، این اطلاعات روی خروجی استاندارد نیز چاپ خواهند شد. .SH "مثال‌ها (EXAMPLES)" .IX Header "EXAMPLES" یک نمونه ورودی در پروندهٔ \fInewsfeeds\fR برای تولید پرونده‌های مناسب xbatch به صورت زیر است: .PP .Vb 5 \& nase\e \& :*\e \& :Tc,Wnb\e \& :/batcher \-p "(<$COMPRESS in /innshellvars>\e \& > /nase.\e$\e$)" nase.do.main .Ve .PP یک اسکریپت نمونه برای فراخوانی innxbatch(8) به صورت زیر است: .PP .Vb 12 \& #! /bin/sh \& # Send xbatches for a site, wrapped around innxbatch. \& if [ $# \-lt 3 ] \& then \& echo "usage: $0 ..." \& exit 1 \& fi \& . /innshellvars \& site="$1"; host="$2"; shift; shift \& ctlinnd flush "$site" \e \& && sleep 5 \e \& && exec ${NEWSBIN}/innxbatch \-v \-D "$host" $* .Ve .PP می‌توانید از \&\fBsendxbatches\fR که از قبل همراه با INN عرضه می‌شود و عملیات قفل‌گذاری را انجام می‌دهد، استفاده کنید. یک نمونه فراخوانی به صورت زیر است: .PP .Vb 1 \& sendxbatches nase remote.news.server.name /nase* .Ve .SH "تاریخچه (HISTORY)" .IX Header "HISTORY" نوشته‌شده توسط Stefan Petri ، الگوبرداری‌شده از \&\fBinnxmit\fR و وصلهٔ XBATCH برای پیاده‌سازی مرجع NNTP. مثال‌ها از Karsten Leipold . بازنویسی در قالب POD توسط Julien Elie. .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" ctlinnd(8), incoming.conf(5), innxmit(8), newsfeeds(5), nntpsend(8), passwd.nntp(5), shlock(8).