.\" -*- 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 "INEWS 1" .TH INEWS 1 2026-06-12 "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)" inews \- ارسال یک مقاله خبری به سرور خبر .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" \&\fBinews\fR [\fB\-ADEhHILNOPRSvVWXY\fR] [\fB\-acdefFimnorstwx\fR \fIvalue\fR] [\fB\-p\fR \fIport\fR] [\fIfile\fR] .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" \&\fBinews\fR یک مقاله خبری یوزنت (Usenet) را، احتمالاً به همراه سرایندها، از \fIfile\fR یا در صورت مشخص نشدن فایل از ورودی استاندارد می‌خواند. این ابزار تعدادی فیلد سرایند اضافه کرده و پاره‌ای بررسی‌های سازگاری را انجام می‌دهد. اگر مقاله در این بررسی‌ها پذیرفته نشود، رد خواهد شد. اگر مقاله بررسی‌ها را با موفقیت پشت سر بگذارد، \&\fBinews\fR آن را به سرور خبری ارسال می‌کند که در پارامتر \fIserver\fR در فایل \fIinn.conf\fR مشخص شده یا هنگام اجرای \&\fBinews\fR توسط متغیر محیطی \f(CW\*(C`NNTPSERVER\*(C'\fR بازنویسی شده است. .PP برنامه \&\fBinews\fR مقاله‌ها را از طریق POST ارسال می‌کند و برای ارسال مقالاتی مناسب است که قبلاً به شبکه Usenet تزریق نشده‌اند. برای ارسال مقالاتی که از منابع دیگر دریافت شده‌اند، عموماً باید به جای آن از rnews(1) استفاده شود. .PP به‌طور پیش‌فرض، اگر فایلی به نام \fI.signature\fR در پوشه خانگی کاربر ارسال‌کننده وجود داشته باشد، به انتهای پست اضافه می‌شود و پیش از آن خطی قرار می‌گیرد که تنها حاوی \f(CW\*(C`\-\- \*(C'\fR است. امضاها مجاز نیستند بیش از چهار خط باشند. .PP پیام‌های کنترلی به جز پیام‌های لغو (cancel)، تنها در صورتی مجاز هستند که \&\fBinews\fR توسط کاربر news یا کاربری در گروه news اجرا شود و پیام کنترلی شناخته‌شده باشد. اگر مقاله حاوی فیلد سرایند Distribution با توزیعی باشد که با یکی از الگوهای توزیع نامعتبر در \fIinn/options.h\fR (به‌طور پیش‌فرض هر مقداری که حاوی نقطه باشد) مطابقت داشته باشد، پیام رد خواهد شد. همچنین اگر \fIcheckincludedtext\fR در \fIinn.conf\fR روی true تنظیم شده باشد و پیام حاوی متن نقل‌قول‌شده بیشتری نسبت به متن اصلی باشد و طول آن از ۴۰ خط فراتر رود، پیام رد خواهد شد. .PP در صورت مشخص نشدن، مقدار بدنه فیلد سرایند Path برابر با \f(CW\*(C`not\-for\-mail\*(C'\fR خواهد بود. اگر \fB\-x\fR داده شود، مقدار آن به ابتدای فیلد سرایند Path اضافه خواهد شد. به عنوان مثال، ممکن است بخواهید یک مقدار ویژه \f(CW\*(C`path\-identity\*(C'\fR مربوط به میزبانی که \&\fBinews\fR را اجرا می‌کند اضافه کنید، که در این حالت به صورت \f(CW\*(C`path\-identity!not\-for\-mail\*(C'\fR در فیلد سرایند Path ظاهر می‌شود. .PP اگر ارسال ناموفق باشد، رونوشتی از پست ارسال‌نشده در فایلی به نام \&\fIdead.article\fR در پوشه خانگی کاربر اجراکننده \&\fBinews\fR ذخیره خواهد شد. برنامه \&\fBinews\fR در صورت شکست ارسال با وضعیتی غیرصفر و در صورت موفقیت‌آمیز بودن با وضعیت صفر خارج می‌شود. .SH "گزینه‌ها (OPTIONS)" .IX Header "OPTIONS" بیشتر گزینه‌های \&\fBinews\fR یک مقدار واحد دریافت کرده و بدنه فیلد سرایند متناظر را در پیامی که ارسال می‌شود تنظیم می‌کنند. اگر مقدار بیش از یک کلمه باشد یا حاوی نویسه‌های خاص شل باشد، باید درون علامت‌های نقل‌قول قرار گیرد تا از شل محافظت شود. در ادامه تمام گزینه‌هایی که فیلدهای سرایند را تنظیم می‌کنند و بدنه فیلد سرایند متناظر آن‌ها آمده است: .PP .Vb 10 \& \-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) .Ve .PP آرگومان \fB\-x\fR به ابتدای بدنه عادی فیلد سرایند Path اضافه می‌شود؛ بر خلاف سایر گزینه‌ها، این گزینه جایگزین آن نخواهد شد. این رفتار جنبه تاریخی دارد و نخستین بار در برنامه \fBinews\fR همراه با B News پیاده‌سازی شد (معنای اولیه \fB\-x\fR این بود که مقاله به سایت مشخص‌شده ارسال نشود). .IP "\fB\-A\fR, \fB\-V\fR, \fB\-W\fR" 4 .IX Item "-A, -V, -W" برای سازگاری با C News پذیرفته می‌شوند. این گزینه‌ها هیچ اثری ندارند. .IP "\fB\-i\fR, \fB\-I\fR, \fB\-L\fR, \fB\-s\fR, \fB\-v\fR, \fB\-X\fR" 4 .IX Item "-i, -I, -L, -s, -v, -X" برای سازگاری با \fBtinews.pl\fR که همراه با خبرخوان tin عرضه می‌شود پذیرفته شده‌اند. این گزینه‌ها هیچ اثری ندارند. .IP "\fB\-D\fR, \fB\-N\fR" 4 .IX Item "-D, -N" بررسی‌های سازگاری را انجام داده و فیلدهای سرایند را در صورت نیاز اضافه می‌کند، اما سپس به جای ارسال مقاله به سرور، آن را در خروجی استاندارد چاپ می‌کند. گزینه \fB\-N\fR به عنوان مترادف برای سازگاری با C News پذیرفته می‌شود. .IP \fB\-E\fR 4 .IX Item "-E" اگر مقاله خالی باشد (یعنی بدون متن بدنه باشد)، \&\fBinews\fR با یک خطا متوقف می‌شود. هنگامی که از \fB\-E\fR استفاده می‌شود، \&\fBinews\fR پیام را به صورت خاموش دور انداخته و خارج می‌شود. .Sp توجه داشته باشید که پیام‌های کنترلی بدون بدنه رد نمی‌شوند. .IP \fB\-h\fR 4 .IX Item "-h" به‌طور معمول این پرچم همیشه باید داده شود. این گزینه نشان می‌دهد که مقاله شامل سرایندها، یک خط خالی و سپس بدنه پیام است. اگر این گزینه حذف شود، ورودی صرفاً به عنوان بدنه پیام تلقی می‌شود و هرگونه فیلد سرایند مورد نظر باید با گزینه‌های خط فرمان به ترتیبی که در بالا توضیح داده شد مشخص شود. .IP \fB\-H\fR 4 .IX Item "-H" چاپ پیام راهنما در خروجی استاندارد. .IP \fB\-O\fR 4 .IX Item "-O" به‌طور پیش‌فرض، اگر فیلد سرایند Organization در مقاله وجود نداشته باشد، افزوده خواهد شد. برای جلوگیری از افزودن مقدار پیش‌فرض (از \fIorganization\fR در \fIinn.conf\fR)، از این پرچم استفاده کنید. .IP "\fB\-p\fR \fIport\fR" 4 .IX Item "-p port" اتصال به درگاه (port) مشخص‌شده در سرور به جای درگاه پیش‌فرض (درگاه 119). .IP \fB\-P\fR 4 .IX Item "-P" برنامه \&\fBinews\fR نشانی فرستنده را با نام کاربری کاربر اجراکننده \&\fBinews\fR و نام میزبان سرور خبر محاسبه می‌کند. این نشانی نمایانگر ارسال‌کننده واقعی مقاله است. .Sp به‌طور پیش‌فرض، اگر این فیلد در مقاله وجود نداشته باشد یا اگر فیلد سرایند From از قبل روی آن تنظیم نشده باشد، یک فیلد سرایند Sender با آن مقدار اضافه می‌شود. علاوه بر این، اگر فیلد سرایند Sender از قبل وجود داشته باشد، با آن مقدار بازنویسی خواهد شد. .Sp برای جلوگیری از افزودن یا بازنویسی فیلد سرایند Sender، از این پرچم استفاده کنید. .IP \fB\-R\fR 4 .IX Item "-R" رد کردن تمامی پیام‌های کنترلی. .IP \fB\-S\fR 4 .IX Item "-S" تلاش نکردن برای افزودن \fI~/.signature\fR به پیام، حتی اگر این فایل وجود داشته باشد. .IP \fB\-Y\fR 4 .IX Item "-Y" به‌طور پیش‌فرض، \&\fBinews\fR تنها زمانی در سرور خبر راه دور احراز هویت می‌کند که از آن خواسته شود، یا اینکه پیام آغازین NNTP بیانگر وضعیتی باشد که ارسال در آن مجاز نیست. استفاده از این پرچم باعث می‌شود \&\fBinews\fR همیشه احراز هویت را انجام دهد، حتی اگر درخواست نشده باشد. .SH "مثال‌ها (EXAMPLES)" .IX Header "EXAMPLES" مثال‌های زیر نحوه ارسال مقاله‌ای شامل سرایندها و بدنه، جداشده با یک خط خالی، که در فایلی به نام \fIarticle\fR ذخیره شده است را نشان می‌دهند. .PP برای ارسال آن به سرور خبری تعیین‌شده در پارامتر \fIserver\fR فایل \fIinn.conf\fR (که اگر سرور محلی باشد می‌تواند \f(CW\*(C`localhost\*(C'\fR باشد)، بدون افزودن فیلد سرایند Sender: .PP .Vb 1 \& inews \-h \-P < article .Ve .PP برای اجبار \f(CW\*(C`news.uu.net\*(C'\fR به عنوان سروری که مقاله به آن ارسال می‌شود: .PP .Vb 1 \& NNTPSERVER=news.uu.net inews \-h \-P < article .Ve .PP برای اهداف آزمایشی، جهت مشاهده مقاله‌ای که ارسال خواهد شد بدون ارسال واقعی آن و صرفاً با چاپ آن در خروجی استاندارد: .PP .Vb 1 \& inews \-h \-P \-D < article .Ve .PP اگر فایل \fIarticle\fR فقط حاوی پیامی بدون سرایند باشد، می‌توانید از دستور زیر استفاده کنید: .PP .Vb 1 \& inews \-t \*(AqHello\*(Aq \-n misc.test \-f \*(AqBob \*(Aq \-P < article .Ve .SH "نکات (NOTES)" .IX Header "NOTES" اگر سرور NNTP درخواست احراز هویت کند، \&\fBinews\fR تلاش می‌کند برای دریافت نام کاربری و گذرواژه فایل \&\fIpasswd.nntp\fR را بخواند و بنابراین به مجوز خواندن آن فایل نیاز خواهد داشت. این کار معمولاً با امکان‌پذیر کردن خواندن فایل توسط گروه و افزودن تمام کاربرانی که باید بتوانند با \&\fBinews\fR به آن سرور پست ارسال کنند به گروه مربوطه انجام می‌شود. .PP برنامه \&\fBinews\fR در گذشته حتی کارهای بیشتری نسبت به حال حاضر انجام می‌داد، و تمام بررسی‌های باقی‌مانده که وابسته به کاربر اجراکننده \&\fBinews\fR نیستند احتمالاً باید به نفع مدیریت آنها توسط خود سرور خبر حذف شوند. .PP از آنجا که برنامه \fBinews\fR مربوط به INN از \fIinn.conf\fR و بخش‌های دیگر نصب INN استفاده می‌کند، به عنوان یک برنامه مستقل عمومی \fBinews\fR برای استفاده عام در سیستمی که سرور خبر روی آن اجرا نمی‌شود خیلی مناسب نیست. نسخه‌های دیگر و مناسب‌تری از \fBinews\fR به عنوان بخشی از کلاینت‌های مختلف خبری یونیکس یا به صورت مجزا در دسترس هستند. ما تلاش می‌کنیم سازگاری با پرچم‌هایی که پیاده‌سازی‌های دیگر استفاده می‌کنند را حفظ کنیم (مانند C News، inews-xt و نسخه همچنان فعال \fBtinews.pl\fR که همراه با خبرخوان tin عرضه شده یا برای استفاده مستقل از قابل بارگیری است). .SH "تاریخچه (HISTORY)" .IX Header "HISTORY" نوشته‌شده توسط Rich $alz برای InterNetNews. بازنویسی در قالب POD توسط Russ Allbery . .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" inn.conf(5), passwd.nntp(5), rnews(1).