نام (NAME)

inews - ارسال یک مقاله خبری به سرور خبر

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

inews [-ADEhHILNOPRSvVWXY] [-acdefFimnorstwx value] [-p port] [file]

توضیحات (DESCRIPTION)

inews یک مقاله خبری یوزنت (Usenet) را، احتمالاً به همراه سرایندها، از file یا در صورت مشخص نشدن فایل از ورودی استاندارد می‌خواند. این ابزار تعدادی فیلد سرایند اضافه کرده و پاره‌ای بررسی‌های سازگاری را انجام می‌دهد. اگر مقاله در این بررسی‌ها پذیرفته نشود، رد خواهد شد. اگر مقاله بررسی‌ها را با موفقیت پشت سر بگذارد، inews آن را به سرور خبری ارسال می‌کند که در پارامتر server در فایل inn.conf مشخص شده یا هنگام اجرای inews توسط متغیر محیطی "NNTPSERVER" بازنویسی شده است.

برنامه inews مقاله‌ها را از طریق POST ارسال می‌کند و برای ارسال مقالاتی مناسب است که قبلاً به شبکه Usenet تزریق نشده‌اند. برای ارسال مقالاتی که از منابع دیگر دریافت شده‌اند، عموماً باید به جای آن از rnews(1) استفاده شود.

به‌طور پیش‌فرض، اگر فایلی به نام .signature در پوشه خانگی کاربر ارسال‌کننده وجود داشته باشد، به انتهای پست اضافه می‌شود و پیش از آن خطی قرار می‌گیرد که تنها حاوی "-- " است. امضاها مجاز نیستند بیش از چهار خط باشند.

پیام‌های کنترلی به جز پیام‌های لغو (cancel)، تنها در صورتی مجاز هستند که inews توسط کاربر news یا کاربری در گروه news اجرا شود و پیام کنترلی شناخته‌شده باشد. اگر مقاله حاوی فیلد سرایند Distribution با توزیعی باشد که با یکی از الگوهای توزیع نامعتبر در inn/options.h (به‌طور پیش‌فرض هر مقداری که حاوی نقطه باشد) مطابقت داشته باشد، پیام رد خواهد شد. همچنین اگر checkincludedtext در inn.conf روی true تنظیم شده باشد و پیام حاوی متن نقل‌قول‌شده بیشتری نسبت به متن اصلی باشد و طول آن از ۴۰ خط فراتر رود، پیام رد خواهد شد.

در صورت مشخص نشدن، مقدار بدنه فیلد سرایند Path برابر با "not-for-mail" خواهد بود. اگر -x داده شود، مقدار آن به ابتدای فیلد سرایند Path اضافه خواهد شد. به عنوان مثال، ممکن است بخواهید یک مقدار ویژه "path-identity" مربوط به میزبانی که inews را اجرا می‌کند اضافه کنید، که در این حالت به صورت "path-identity!not-for-mail" در فیلد سرایند Path ظاهر می‌شود.

اگر ارسال ناموفق باشد، رونوشتی از پست ارسال‌نشده در فایلی به نام dead.article در پوشه خانگی کاربر اجراکننده inews ذخیره خواهد شد. برنامه inews در صورت شکست ارسال با وضعیتی غیرصفر و در صورت موفقیت‌آمیز بودن با وضعیت صفر خارج می‌شود.

گزینه‌ها (OPTIONS)

بیشتر گزینه‌های inews یک مقدار واحد دریافت کرده و بدنه فیلد سرایند متناظر را در پیامی که ارسال می‌شود تنظیم می‌کنند. اگر مقدار بیش از یک کلمه باشد یا حاوی نویسه‌های خاص شل باشد، باید درون علامت‌های نقل‌قول قرار گیرد تا از شل محافظت شود. در ادامه تمام گزینه‌هایی که فیلدهای سرایند را تنظیم می‌کنند و بدنه فیلد سرایند متناظر آن‌ها آمده است:

-a  Approved
-c  Control
-d  Distribution
-e  Expires
-F  References
-f  From
-m  Message-ID
-n  Newsgroups
-o  Organization
-r  Reply-To
-t  Subject
-w  Followup-To
-x  Path (prefix)

آرگومان -x به ابتدای بدنه عادی فیلد سرایند Path اضافه می‌شود؛ بر خلاف سایر گزینه‌ها، این گزینه جایگزین آن نخواهد شد. این رفتار جنبه تاریخی دارد و نخستین بار در برنامه inews همراه با B News پیاده‌سازی شد (معنای اولیه -x این بود که مقاله به سایت مشخص‌شده ارسال نشود).

-A, -V, -W

برای سازگاری با C News پذیرفته می‌شوند. این گزینه‌ها هیچ اثری ندارند.

-i, -I, -L, -s, -v, -X

برای سازگاری با tinews.pl که همراه با خبرخوان tin عرضه می‌شود پذیرفته شده‌اند. این گزینه‌ها هیچ اثری ندارند.

-D, -N

بررسی‌های سازگاری را انجام داده و فیلدهای سرایند را در صورت نیاز اضافه می‌کند، اما سپس به جای ارسال مقاله به سرور، آن را در خروجی استاندارد چاپ می‌کند. گزینه -N به عنوان مترادف برای سازگاری با C News پذیرفته می‌شود.

-E

اگر مقاله خالی باشد (یعنی بدون متن بدنه باشد)، inews با یک خطا متوقف می‌شود. هنگامی که از -E استفاده می‌شود، inews پیام را به صورت خاموش دور انداخته و خارج می‌شود.

توجه داشته باشید که پیام‌های کنترلی بدون بدنه رد نمی‌شوند.

-h

به‌طور معمول این پرچم همیشه باید داده شود. این گزینه نشان می‌دهد که مقاله شامل سرایندها، یک خط خالی و سپس بدنه پیام است. اگر این گزینه حذف شود، ورودی صرفاً به عنوان بدنه پیام تلقی می‌شود و هرگونه فیلد سرایند مورد نظر باید با گزینه‌های خط فرمان به ترتیبی که در بالا توضیح داده شد مشخص شود.

-H

چاپ پیام راهنما در خروجی استاندارد.

-O

به‌طور پیش‌فرض، اگر فیلد سرایند Organization در مقاله وجود نداشته باشد، افزوده خواهد شد. برای جلوگیری از افزودن مقدار پیش‌فرض (از organization در inn.conf)، از این پرچم استفاده کنید.

-p port

اتصال به درگاه (port) مشخص‌شده در سرور به جای درگاه پیش‌فرض (درگاه 119).

-P

برنامه inews نشانی فرستنده را با نام کاربری کاربر اجراکننده inews و نام میزبان سرور خبر محاسبه می‌کند. این نشانی نمایانگر ارسال‌کننده واقعی مقاله است.

به‌طور پیش‌فرض، اگر این فیلد در مقاله وجود نداشته باشد یا اگر فیلد سرایند From از قبل روی آن تنظیم نشده باشد، یک فیلد سرایند Sender با آن مقدار اضافه می‌شود. علاوه بر این، اگر فیلد سرایند Sender از قبل وجود داشته باشد، با آن مقدار بازنویسی خواهد شد.

برای جلوگیری از افزودن یا بازنویسی فیلد سرایند Sender، از این پرچم استفاده کنید.

-R

رد کردن تمامی پیام‌های کنترلی.

-S

تلاش نکردن برای افزودن ~/.signature به پیام، حتی اگر این فایل وجود داشته باشد.

-Y

به‌طور پیش‌فرض، inews تنها زمانی در سرور خبر راه دور احراز هویت می‌کند که از آن خواسته شود، یا اینکه پیام آغازین NNTP بیانگر وضعیتی باشد که ارسال در آن مجاز نیست. استفاده از این پرچم باعث می‌شود inews همیشه احراز هویت را انجام دهد، حتی اگر درخواست نشده باشد.

مثال‌ها (EXAMPLES)

مثال‌های زیر نحوه ارسال مقاله‌ای شامل سرایندها و بدنه، جداشده با یک خط خالی، که در فایلی به نام article ذخیره شده است را نشان می‌دهند.

برای ارسال آن به سرور خبری تعیین‌شده در پارامتر server فایل inn.conf (که اگر سرور محلی باشد می‌تواند "localhost" باشد)، بدون افزودن فیلد سرایند Sender:

inews -h -P < article

برای اجبار "news.uu.net" به عنوان سروری که مقاله به آن ارسال می‌شود:

NNTPSERVER=news.uu.net inews -h -P < article

برای اهداف آزمایشی، جهت مشاهده مقاله‌ای که ارسال خواهد شد بدون ارسال واقعی آن و صرفاً با چاپ آن در خروجی استاندارد:

inews -h -P -D < article

اگر فایل article فقط حاوی پیامی بدون سرایند باشد، می‌توانید از دستور زیر استفاده کنید:

inews -t 'Hello' -n misc.test -f 'Bob <bob@uu.net>' -P < article

نکات (NOTES)

اگر سرور NNTP درخواست احراز هویت کند، inews تلاش می‌کند برای دریافت نام کاربری و گذرواژه فایل passwd.nntp را بخواند و بنابراین به مجوز خواندن آن فایل نیاز خواهد داشت. این کار معمولاً با امکان‌پذیر کردن خواندن فایل توسط گروه و افزودن تمام کاربرانی که باید بتوانند با inews به آن سرور پست ارسال کنند به گروه مربوطه انجام می‌شود.

برنامه inews در گذشته حتی کارهای بیشتری نسبت به حال حاضر انجام می‌داد، و تمام بررسی‌های باقی‌مانده که وابسته به کاربر اجراکننده inews نیستند احتمالاً باید به نفع مدیریت آنها توسط خود سرور خبر حذف شوند.

از آنجا که برنامه inews مربوط به INN از inn.conf و بخش‌های دیگر نصب INN استفاده می‌کند، به عنوان یک برنامه مستقل عمومی inews برای استفاده عام در سیستمی که سرور خبر روی آن اجرا نمی‌شود خیلی مناسب نیست. نسخه‌های دیگر و مناسب‌تری از inews به عنوان بخشی از کلاینت‌های مختلف خبری یونیکس یا به صورت مجزا در دسترس هستند. ما تلاش می‌کنیم سازگاری با پرچم‌هایی که پیاده‌سازی‌های دیگر استفاده می‌کنند را حفظ کنیم (مانند C News، inews-xt و نسخه همچنان فعال tinews.pl که همراه با خبرخوان tin عرضه شده یا برای استفاده مستقل از http://bzr.tin.org/tools/tinews.pl قابل بارگیری است).

تاریخچه (HISTORY)

نوشته‌شده توسط Rich $alz <rsalz@uunet.uu.net> برای InterNetNews. بازنویسی در قالب POD توسط Russ Allbery <eagle@eyrie.org>.

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

inn.conf(5), passwd.nntp(5), rnews(1).