.\" -*- 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 ' .\" .\" 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 "NNTPSEND 8" .TH NNTPSEND 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)" nntpsend \- ارسال دسته‌های مقالات Usenet از طریق NNTP .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" \&\fBnntpsend\fR [\fB\-acDdlNnpr\fR] [\fB\-P\fR \fIportnum\fR] [\fB\-s\fR \fIsize\fR] [\fB\-T\fR \fItimelimit\fR] [\fB\-t\fR \fItimeout\fR] [\fB\-w\fR \fIdelay\fR] [\fIsitename\fR \fIfqdn\fR] ... .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" برنامه \&\fBnntpsend\fR یک رابط (front-end) است که برای ارسال مقالات Usenet به یک سایت دوردست NNTP، برنامه \fBinnxmit\fR را فراخوانی می‌کند. سایت‌هایی که باید تغذیه شوند را می‌توان با مشخص کردن جفت‌های \&\fIsitename\fR \fIfqdn\fR در خط فرمان تعیین کرد. اگر چنین جفت‌هایی مشخص نشوند، \&\fBnntpsend\fR به صورت پیش‌فرض از اطلاعات موجود در فایل پیکربندی \&\fInntpsend.ctl\fR استفاده می‌کند. مقدار \fIsitename\fR باید نام سایت به همان صورت مشخص‌شده در فایل \&\fInewsfeeds\fR باشد. مقدار \fIfqdn\fR باید نام میزبان (hostname) یا نشانی IP سایت دوردست باشد. برای سایت‌هایی که خبرهای صف‌بندی‌شده دارند، یک فرایند \fBinnxmit\fR اجرا می‌شود. تمام فرایندهای \fBinnxmit\fR در پس‌زمینه ایجاد می‌شوند و اسکریپت قبل از بازگشت، منتظر می‌ماند تا همگی آن‌ها به پایان برسند. خروجی به فایل \&\fInntpsend.log\fR در \fIpathlog\fR ارسال می‌شود. برای جلوگیری از تحمیل بار بیش از حد به سیستم محلی، \&\fBnntpsend\fR قبل از ایجاد هر فرایند فرزند پنج ثانیه صبر می‌کند. .PP برنامه \&\fBnntpsend\fR انتظار دارد که فایل دسته (batch file) برای یک سایت، به نام \&\fIsitename\fR در \fIpathoutgoing\fR باشد. برای جلوگیری از خراب شدن فایل‌های دسته، از \fBshlock\fR برای «قفل کردن» این فایل‌ها استفاده می‌شود. هنگامی که جفت‌های \&\fIsitename\fR \fIfqdn\fR در خط فرمان مشخص شوند، هر پرچمی که در خط فرمان داده شود نحوه عملکرد \fBinnxmit\fR و \fBshrinkfile\fR را به طور کامل مشخص می‌کند. هنگامی که چنین جفت‌هایی در خط فرمان داده نشوند، اطلاعات موجود در \&\fInntpsend.ctl\fR به پرچم‌های پیش‌فرض برای آن سایت تبدیل می‌شوند. هر پرچمی که در خط فرمان داده شود، بر پرچم‌های پیش‌فرض سایت اولویت دارد و آن‌ها را بازنویسی می‌کند. .PP یک جایگزین برای \&\fBnntpsend\fR می‌تواند \&\fBinnduct\fR باشد که در صفحه راهنمای innfeed(8) به آن اشاره شده است. .SH "گزینه‌ها (OPTIONS)" .IX Header "OPTIONS" .IP "\fB\-D\fR, \fB\-d\fR" 2 .IX Item "-D, -d" پرچم \fB\-D\fR باعث می‌شود \&\fBnntpsend\fR خروجی را به جای فایل گزارش \&\fInntpsend.log\fR در \fIpathlog\fR، به stdout بفرستد. پرچم \fB\-d\fR نیز همین کار را انجام می‌دهد و علاوه بر آن، \fB\-d\fR را به تمام فراخوانی‌های \fBinnxmit\fR منتقل می‌کند که در نتیجه باعث می‌شود \&\fBinnxmit\fR به حالت اشکال‌زدایی (debug mode) برود. .IP \fB\-n\fR 2 .IX Item "-n" اگر از پرچم \fB\-n\fR استفاده شود، \&\fBnntpsend\fR از \fBshlock\fR برای قفل کردن استفاده از \&\fBnntpsend\fR استفاده نمی‌کند. فایل‌های دسته همچنان قفل خواهند شد. .IP "\fB\-s\fR \fIsize\fR" 2 .IX Item "-s size" اگر از پرچم \fB\-s\fR استفاده شود، برنامه \fBshrinkfile\fR فراخوانی خواهد شد تا یک برش از ابتدای فایل (head truncation) به اندازه \fIsize\fR بایت روی فایل دسته انجام دهد و این پرچم به آن منتقل خواهد شد. .IP "\fB\-w\fR \fIdelay\fR" 2 .IX Item "-w delay" اگر از پرچم \fB\-w\fR استفاده شود، \&\fBnntpsend\fR پس از تخلیه (flush) سایت، به مدت \fIdelay\fR ثانیه قبل از اجرای \fBinnxmit\fR منتظر می‌ماند. .IP "\fB\-a\fR, \fB\-c\fR, \fB\-l\fR, \fB\-N\fR, \fB\-P\fR \fIportnum\fR, \fB\-p\fR, \fB\-r\fR, \fB\-T\fR \fItimelimit\fR, \fB\-t\fR \fItimeout\fR" 2 .IX Item "-a, -c, -l, -N, -P portnum, -p, -r, -T timelimit, -t timeout" پرچم‌های \fB\-a\fR، \fB\-c\fR، \fB\-l\fR، \fB\-P\fR \fIportnum\fR، \fB\-p\fR، \fB\-r\fR، \fB\-T\fR \fItimelimit\fR و \fB\-t\fR \fItimeout\fR به برنامه فرزند \&\fBinnxmit\fR منتقل می‌شوند. پرچم \fB\-N\fR به عنوان پرچم \fB\-s\fR به برنامه فرزند \fBinnxmit\fR پاس داده می‌شود. برای جزئیات بیشتر به innxmit(8) مراجعه کنید. .Sp توجه داشته باشید که اگر از پرچم \fB\-p\fR استفاده شود، هیچ اتصالی برقرار نمی‌شود و هیچ مقاله‌ای به سایت دوردست ارسال نمی‌گردد. این ویژگی زمانی مفید است که cron(8) برنامه \&\fBnntpsend\fR را با این پرچم اجرا کند تا در صورتی که ارتباط با یک سایت برای مدتی طولانی برقرار نشود، مشکلی پیش نیاید. .SH "مثال‌ها (EXAMPLES)" .IX Header "EXAMPLES" با فایل پیکربندی \&\fInntpsend.ctl\fR زیر: .PP .Vb 4 \& nsavax:erehwon.nsavax.gov::\-t60 \& group70:group70.org:: \& walldrug:walldrug.com:4m\-1m:\-T1800 \-t300 \& kremvax:kremvax.cis:2m: .Ve .PP دستور \f(CW\*(C`nntpsend\*(C'\fR منجر به موارد زیر خواهد شد: .PP .Vb 5 \& Sitename Truncation innxmit flags \& nsavax (none) \-a \-t60 \& group70 (none) \-a \-t180 \& walldrug 1m if >4m \-T1800 \-t300 \& kremvax 2m \-t180 .Ve .PP دستور \f(CW\*(C`nntpsend \-d \-T1200\*(C'\fR منجر به موارد زیر خواهد شد: .PP .Vb 5 \& Sitename Truncation innxmit flags \& nsavax (none) \-a \-d \-T1200 \-t60 \& group70 (none) \-a \-d \-T1200 \-t180 \& walldrug 1m if >4m \-d \-T1200 \-t300 \& kremvax 2m \-d \-T1200 \-t180 .Ve .PP دستور \f(CW\*(C`nntpsend \-s 5m \-T1200 nsavax erehwon.nsavax.gov group70 group70.org\*(C'\fR منجر به موارد زیر خواهد شد: .PP .Vb 3 \& Sitename Truncation innxmit flags \& nsavax 5m \-T1200 \-t180 \& group70 5m \-T1200 \-t180 .Ve .PP به یاد داشته باشید که پرچم \fB\-a\fR همیشه زمانی که هیچ محدودیت اندازه‌ای وجود ندارد اعمال می‌شود، و مقدار پیش‌فرض \fB\-t\fR برابر با \f(CW\*(C`180\*(C'\fR است. .SH "تاریخچه (HISTORY)" .IX Header "HISTORY" نوشته شده توسط Landon Curt Noll و Rich $alz برای InterNetNews. تبدیل شده به POD توسط Julien Elie. .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" inn.conf(5), innxmit(8), newsfeeds(5), nntpsend.ctl(5), shlock(8), shrinkfile(1).