نام (NAME)

innxmit - ارسال مقاله‌های یوزنت به یک کارگزار راه‌دور NNTP

خلاصه دستور (SYNOPSIS)

innxmit [-acdHlprsv] [-P portnum] [-T seconds] [-t seconds] host file

توضیحات (DESCRIPTION)

دستور innxmit به کارگزار NNTP در میزبان مشخص‌شده (host) متصل می‌شود (در صورتی که اعتبارنامه‌های احراز هویت برای کارگزار راه‌دور در پروندهٔ passwd.nntp موجود باشد، هویت خود را از طریق آن اعتبارسنجی می‌کند) و مقاله‌های مشخص‌شده در پروندهٔ دسته‌ای به نام file را به آن ارسال می‌کند. این برنامه معمولاً توسط اسکریپتی فراخوانی می‌شود که از طریق cron(8) اجرا شده و از shlock برای قفل کردن نام میزبان استفاده می‌کند و به دنبال آن از یک دستور ctlinnd برای تخلیه (flush) پروندهٔ دسته‌ای بهره می‌برد. اگر file یک مسیر مطلق نباشد، نسبت به دایرکتوری مشخص‌شده توسط پارامتر pathoutgoing در inn.conf در نظر گرفته می‌شود. این پرونده معمولاً با مشخص کردن پرچم‌های "Wnm" در پروندهٔ newsfeeds نوشته می‌شود. هر خط در پروندهٔ دسته‌ای باید در یکی از قالب‌های زیر باشد:

article Message-ID
article

فیلد اول یا توکن API ذخیره‌سازی (storage API token) یک مقاله است یا نام پرونده‌ای که حاوی مقاله است. اگر این فیلد یک مسیر مطلق یا توکن API ذخیره‌سازی نباشد، به‌عنوان یک نام پرونده نسبی به patharticles در inn.conf در نظر گرفته می‌شود. اگر فیلد دوم مشخص نشده باشد، شناسه پیام (Message-ID) با پویش مقاله به دست خواهد آمد. این دو فیلد در صورت وجود، با یک فاصله از یکدیگر جدا می‌شوند. اگر یک خطای ارتباطی مانند شکست در write(2) رخ دهد، innxmit ارسال را متوقف کرده و پروندهٔ دسته‌ای را بازنویسی می‌کند تا حاوی مقاله فعلی و هر مقاله ارسال‌نشدهٔ دیگر باشد.

یک جایگزین برای innxmit می‌تواند innduct باشد که در صفحه راهنمای innfeed(8) به آن اشاره شده است.

گزینه‌ها (OPTIONS)

-a: اگر تمام مقاله‌ها با موفقیت ارسال شوند، innxmit پروندهٔ دسته‌ای را حذف خواهد کرد؛ در غیر این صورت آن را بازنویسی می‌کند تا حاوی فهرست مقاله‌های ارسال‌نشده باشد. اگر هیچ مقاله‌ای ارسال یا رد نشود، پرونده دست‌نخورده باقی می‌ماند. اگر مقاله‌های زیادی منقضی شده باشند و مشکلات ارتباطی وجود داشته باشد، این امر می‌تواند باعث رشد بیش از حد پروندهٔ دسته‌ای شود. برای اینکه پروندهٔ دسته‌ای همیشه بازنویسی شود، از پرچم -a استفاده کنید.
-c: در حالت جریانی (streaming mode)، بررسی هر Message-ID انجام می‌شود تا از ارسال مقاله‌هایی که قبلاً روی کارگزار راه‌دور وجود دارند خودداری شود. پس از پذیرش تعداد معینی مقاله به صورت متوالی، innxmit دیگر این پرس‌وجوها را ارسال نمی‌کند، اما به محض دریافت یک پیام رد (که ممکن است به دلیلی غیر از تکراری بودن باشد، مانند یک گروه خبری ناخواسته)، دوباره به ارسال آن‌ها بازمی‌گردد.
پرچم -c در صورت پشتیبانی از حالت جریانی، باعث می‌شود مقاله‌ها همیشه بدون بررسی ارسال شوند. این کار منجر به توان عملیاتی (throughput) کمی بیشتر می‌شود و ممکن است زمانی که مشخص است سایت مقصد نمی‌تواند از قبل مقاله‌ها را داشته باشد (مانند یک سایت «برگ» یا leaf)، مناسب باشد.
-d: از پرچم -d برای چاپ اطلاعات اشکال‌زدایی روی خروجی خطای استاندارد استفاده کنید. این کار تراکنش‌های پروتکل بین innxmit و کارگزار NNTP در میزبان راه‌دور را نشان می‌دهد.
-H: اگر پرچم -H داده شود، برای تمام مقاله‌ها به جز پیام‌های کنترلی، تنها سرایندها (headers) به host ارسال می‌شوند. همچنین فیلد سرایند Bytes حتی اگر در مقاله اصلی وجود نداشته باشد، گنجانده می‌شود. پرچم -H برای Diablo reader مفید است.
-l: پرچم -l برای فعال‌سازی ثبت (logging) دلایلی که کارگزار راه‌دور برای رد یک مقاله ارائه می‌دهد، استفاده می‌شود.
-P portnum: برای مشخص کردن شماره درگاهی غیر از مقدار پیش‌فرض، از پرچم -P استفاده کنید.
-p: اگر پرچم -p داده شود، هیچ اتصالی برقرار نمی‌شود و پروندهٔ دسته‌ای از ورودی‌هایی که به پرونده‌های ناموجود اشاره دارند پاک‌سازی می‌شود. این پرچم متضمن گزینهٔ -a است.
-r: اگر کارگزار راه‌دور کد پاسخ غیرمنتظره‌ای ارسال کند، innxmit مقاله را دوباره در صف قرار داده و ادامه می‌دهد. اگر مقاله نباید مجدداً در صف قرار گیرد، از پرچم -r استفاده کنید.
-s: دستور innxmit در هنگام اتصال تلاش خواهد کرد تا افزونهٔ حالت جریانی پروتکل NNTP را با کارگزار مذاکره کند. در صورت موفقیت، از پروتکل کمی متفاوت استفاده می‌کند که توان عملیاتی را بهبود می‌بخشد. اگر کارگزار مذاکرهٔ حالت جریانی را به رسمیت نشناسد، innxmit به حالت انتقال عادی NNTP بازمی‌گردد. برای غیرفعال کردن تلاش جهت مذاکره دربارهٔ افزونهٔ حالت جریانی، از پرچم -s استفاده کنید.
-T seconds: برای مشخص کردن کل مدت زمانی که باید برای انتقال مقاله‌ها مجاز باشد، از پرچم -T استفاده کنید. مقدار پیش‌فرض این است که تا زمان وقوع یک خطای I/O یا انتقال تمام مقاله‌ها صبر کند. اگر پرچم -T استفاده شود، زمان درست پیش از شروع هر مقاله بررسی می‌شود؛ این گزینه انتقالی را که در حال انجام است لغو نخواهد کرد.
-t seconds: دستور innxmit معمولاً تا زمان برقراری اتصال مسدود می‌شود. برای تعیین مهلت زمانی (timeout) برای مدت تلاش جهت برقراری اتصال، از پرچم -t استفاده کنید.
-v: هنگام خروج، innxmit آمار انتقال و میزان استفاده از پردازنده (CPU) را از طریق syslog گزارش می‌دهد. اگر پرچم -v استفاده شود، این آمار در خروجی استاندارد نیز چاپ خواهند شد.

تاریخچه (HISTORY)

نوشته‌شده توسط Rich $alz <rsalz@uunet.uu.net> برای InterNetNews. تبدیل‌شده به POD توسط Julien Elie.

همچنین ببینید (SEE ALSO)

ctlinnd(8), inn.conf(5), innd(8), newsfeeds(5), passwd.nntp(5), shlock(8).