.\" -*- 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 "PROCBATCH 8"
.TH PROCBATCH 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)"
procbatch \- پردازش یک فایل قیفی (funnel) یا فایل مقالات رهاشده توسط innfeed در INN
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fBprocbatch\fR [\fB\-hquv\fR] [\fB\-c\fR [\fB\-s\fR \fIspooldir\fR]] [\fB\-d\fR \fIoutdir\fR]
[\fB\-e\fR \fIpeer\fR] [\fB\-m\fR [\fB\-t\fR \fIbacklogdir\fR]] \fIbatchfile\fR
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
دستور
\&\fBprocbatch\fR
یک فایل قیفی (funnel) متعلق به INN یا یک فایل
\&\fIinnfeed\-dropped\fR
را دریافت کرده و آن را بر اساس میزبان (host) تفکیک می‌کند تا مستقیماً توسط
\&\fBinnfeed\fR
یا
\&\fBinnxmit\fR
پردازش شوند.
.PP
در حالی که فایل‌های funnel معمولاً تنها پس از بروز خرابی (crash) سیستم مورد توجه قرار می‌گیرند،
\&\fBinnfeed\fR
ممکن است مقالات را به دلایل متعددی رها (drop) کند که لزوماً همه آن‌ها نشان‌دهنده یک مشکل اساسی نیستند. برای مثال، زمانی که
\&\fBinnfeed\fR
در توالی‌های سریع آغاز و متوقف می‌شود در حالی که INN حجم بالایی از پیام‌های کنترلی را پردازش می‌کند (یک ناتوانی موقت)، یا زمانی که INN مقالاتی را برای سایتی ارسال می‌کند که در
\&\fIinnfeed.conf\fR
تعریف نشده است (یک پیکربندی نادرست)، مقالات ممکن است رها شوند.
.PP
هر نمونه در حال اجرای
\&\fBinnfeed\fR
فایلی با نام
\&\fIinnfeed\-dropped.<id>\fR
را باز می‌کند که در حالت عادی باید طول آن صفر بایت باشد و هنگام خروج برنامه حذف شود. اگر فایل‌هایی با اندازه غیرصفر وجود داشته باشند،
\&\fBinnfeed\fR
تعدادی از مقالات را رها کرده است و این فایل‌های مقالات رهاشده باید پردازش شوند، در غیر این صورت این مقالات هرگز به کارگزارهای همتا (peers) ارسال نخواهند شد. اگرچه
\&\fBnews.daily\fR
به‌طور خودکار این فایل‌ها را پردازش می‌کند (با فراخوانی
\&\fBprocbatch\fR)،
اما انجام دستی آن نیز امکان‌پذیر است. ابتدا اطمینان حاصل کنید که فایل مربوط به یک نمونه در حال اجرای
\&\fBinnfeed\fR
نیست؛ برای مثال با فراخوانی دستور
\&\f(CW\*(C`ctlinnd flush innfeed!\*(C'\fR.
.PP
یک فایل funnel مربوط به INN یا یک فایل
\&\fIinnfeed\-dropped\fR
معمولاً دارای ساختار زیر است:
.PP
.Vb 1
\&    pathname message\-id peer1 peer2 peer3 ...
.Ve
.PP
که در آن
\&\fIpathname\fR
می‌تواند به عنوان جایگزین، یک توکن رابط برنامه‌نویسی ذخیره‌سازی (storage API token) باشد.
.PP
دستور
\&\fBprocbatch\fR
این فایل را به فایل‌هایی با نام‌های
\&\fIpeer1.tmp\fR،
\&\fIpeer2.tmp\fR،
\&\fIpeer3.tmp\fR
و غیره با ساختار زیر تفکیک می‌کند:
.PP
.Vb 1
\&    pathname message\-id
.Ve
.PP
این فایل‌های tape مرتب‌سازی شده و ورودی‌های تکراری از آن‌ها حذف می‌شوند. تغییر نام ساده آن‌ها به
\&\fIpeer1\fR،
\&\fIpeer2\fR،
\&\fIpeer3\fR
و غیره در پوشه بک‌لاگ (backlog) یک سرویس در حال اجرای
\&\fBinnfeed\fR
باعث می‌شود که آن‌ها به‌طور خودکار در هر دوره زمانی
\&\fIbacklog\-newfile\-period\fR
ثانیه (همان‌طور که در
\&\fIinnfeed.conf\fR
تنظیم شده است) توسط
\&\fBinnfeed\fR
شناسایی و دریافت شوند. از گزینه
\&\fB\-m\fR
استفاده کنید تا
\&\fBprocbatch\fR
تغییر نام و انتقال آن‌ها به محل مناسب را به‌طور خودکار انجام دهد.
.PP
پس از اجرای
\&\fBprocbatch\fR،
ممکن است بخواهید اطمینان حاصل کنید که هر فایل بک‌لاگ تولیدشده دارای یک فایل متناظر
\&\f(CW\*(C`.lock\*(C'\fR
است. در غیر این صورت،
\&\fBinnfeed\fR
آن سایت را به عنوان یک همتا (peer) پیکربندی نکرده است؛ به این معنی که فایل
\&\fIinnfeed.conf\fR
شما ممکن است به اصلاح نیاز داشته باشد.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP \fB\-c\fR 4
.IX Item "-c"
بررسی وجود مقاله پیش از نوشتن ارجاعات به آن در فایل‌های tape. در حال حاضر، این گزینه تنها با ساختار ذخیره‌سازی مقالات tradspool قابل استفاده است. استفاده از آن با هر قالب اسپول دیگری منجر به رها شدن و از دست رفتن تمام مقالات خواهد شد.
.IP "\fB\-d\fR \fIoutdir\fR" 4
.IX Item "-d outdir"
قرار دادن فایل یا فایل‌های خروجی در پوشه
\&\fIoutdir\fR
(پیش‌فرض آن
\&\fIpathtmp\fR
تعیین‌شده در
\&\fIinn.conf\fR
است). در صورت تعیین همزمان گزینه
\&\fB\-m\fR،
فایل‌های خروجی موقت همچنان پیش از انتقال به محل نهایی در این پوشه قرار می‌گیرند.
.IP "\fB\-e\fR \fIpeer\fR" 4
.IX Item "-e peer"
فقط ورودی‌های مربوط به
\&\fIpeer\fR
پردازش شوند.
.IP \fB\-h\fR 4
.IX Item "-h"
نمایش یک صفحه راهنمای کوتاه.
.IP \fB\-m\fR 4
.IX Item "-m"
افزودن مستقیم به انتهای فایل‌های tape در پوشه بک‌لاگ
\&\fBinnfeed\fR.
.IP \fB\-q\fR 4
.IX Item "-q"
حالت بی‌صدا: فقط نمایش پیام‌های خطا.
.IP "\fB\-s\fR \fIspooldir\fR" 4
.IX Item "-s spooldir"
استفاده از
\&\fIspooldir\fR
به عنوان محل اسپول مقالات (پیش‌فرض آن
\&\fIpatharticles\fR
تعیین‌شده در
\&\fIinn.conf\fR
است). این گزینه تنها در یک سامانه ذخیره‌سازی tradspool و در صورت تعیین همزمان گزینه
\&\fB\-c\fR
کاربرد دارد.
.IP "\fB\-t\fR \fIbacklogdir\fR" 4
.IX Item "-t backlogdir"
استفاده از
\&\fIbacklogdir\fR
به عنوان محل پوشه بک‌لاگ
\&\fBinnfeed\fR
(پوشه‌ای که فایل‌های tape ساخته‌شده در آن قرار می‌گیرند). پیش‌فرض آن
\&\fIpathspool\fR/innfeed
است. این گزینه تنها در صورت مشخص کردن همزمان گزینه
\&\fB\-m\fR
تأثیرگذار است.
.IP \fB\-u\fR 4
.IX Item "-u"
حذف پیوند (unlink) فایل دسته‌ای ورودی پس از اتمام پردازش.
.IP \fB\-v\fR 4
.IX Item "-v"
افزایش جزئیات گزارش (حالت پرگو).
.SH "مثال‌ها (EXAMPLES)"
.IX Header "EXAMPLES"
دریافت فایل
\&\fIinnfeed\-dropped.B012345\fR،
پردازش خطوط آن و افزودن به فایل‌های tape در پوشه بک‌لاگ
\&\fBinnfeed\fR،
و حذف آن پس از پایان کار، همراه با نمایش جزئیات کامل عملیات:
.PP
.Vb 1
\&    procbatch \-umv innfeed\-dropped.B012345
.Ve
.PP
بررسی فایل
\&\fIinnfeed\-dropped.B012345\fR
و ذخیره ورودی‌های مربوط به
\&\f(CW\*(C`peer1\*(C'\fR
در
\&\fI/tmp/peer1.tmp\fR،
اما تنها در صورتی که مقالات همچنان در tradspool محلی موجود باشند:
.PP
.Vb 1
\&    procbatch \-e peer1 \-d /tmp \-c innfeed\-dropped.B012345
.Ve
.SH "اشکالات (BUGS)"
.IX Header "BUGS"
دستور
\&\fBprocbatch\fR
باید بتواند وجود مقالات را در هر نوع روش ذخیره‌سازی مقالات (احتمالاً با استفاده از
\&\fBgrephistory\fR\)) بررسی کند.
.SH "تاریخچه (HISTORY)"
.IX Header "HISTORY"
دستور
\&\fBprocbatch\fR
توسط James Brister نوشته شد و سرعت اجرای آن توسط Clayton O'Neill بهبود یافت.
.PP
این صفحه راهنما توسط Florian Schlichting با استفاده از یادداشتی از Russ Allbery به نگارش درآمد.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
innfeed(8), innxmit(8), news.daily(8).