.\" -*- 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 "NNTPGET 1"
.TH NNTPGET 1 2022-07-10 "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)"
nntpget \- دریافت مقاله‌های Usenet از یک سرور دوردست NNTP
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fBnntpget\fR [\fB\-ov\fR] [\fB\-f\fR \fIfile\fR] [\fB\-n\fR \fInewsgroups\fR]
[\fB\-t\fR \fItimestring\fR] [\fB\-u\fR \fIfile\fR] \fIhost\fR
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
دستور \&\fBnntpget\fR به سرور NNTP در \fIhost\fR مشخص‌شده متصل شده و مقاله‌ها را از آن دریافت می‌کند. شناسه‌های Message-ID مقاله‌های مورد نظر از ورودی استاندارد خوانده می‌شوند. مقاله‌ها به خروجی استاندارد فرستاده می‌شوند.
.PP
به‌جای خواندن Message-IDها از خروجی استاندارد، گزینه‌های \fB\-f\fR، \fB\-n\fR، \&\fB\-t\fR و \fB\-u\fR از دستور \f(CW\*(C`NEWNEWS\*(C'\fR استفاده می‌کنند که ممکن است در سرور دوردست در دسترس نباشد. در یک زمان تنها می‌توان یکی از گزینه‌های \fB\-f\fR، \fB\-t\fR یا \fB\-u\fR را مشخص کرد؛ \fB\-n\fR تنها در صورتی می‌تواند مشخص شود که یکی از سه گزینه دیگر در حال استفاده باشد.
.PP
اگر اطلاعات احراز هویت سرور دوردست در فایل \&\fIpasswd.nntp\fR واقع در \fIpathetc\fR موجود باشد، \fBnntpget\fR از آن‌ها برای احراز هویت استفاده خواهد کرد.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP "\fB\-f\fR \fIfile\fR" 4
.IX Item "-f file"
فهرست Message-IDهای مقاله معمولاً از ورودی استاندارد خوانده می‌شود. اگر از این گزینه استفاده شود، یک دستور \f(CW\*(C`NEWNEWS\*(C'\fR برای دریافت تمام مقالاتی که جدیدتر از تاریخ تغییر \fIfile\fR مشخص‌شده هستند، استفاده می‌شود.
.IP "\fB\-n\fR \fInewsgroups\fR" 4
.IX Item "-n newsgroups"
اگر هر یک از گزینه‌های \fB\-f\fR، \fB\-t\fR یا \fB\-u\fR استفاده شوند، می‌توان از این گزینه برای محدود کردن پاسخ‌ها تنها به گروه‌های خبری‌ای (در صورت وجود) که نامشان با فهرست مطابقت دارد استفاده کرد. مقدار پیش‌فرض \f(CW\*(C`*\*(C'\fR است، به این معنی که تمام گروه‌های خبری مورد نظر هستند.
.Sp
فهرست \fInewsgroups\fR می‌تواند شامل چندین الگو و نویسه‌های wildmat باشد. برای نمونه \f(CW\*(C`misc.*,!*.test\*(C'\fR یک فهرست معتبر است که به دستور \&\f(CW\*(C`NEWNEWS\*(C'\fR داده خواهد شد.
.IP \fB\-o\fR 4
.IX Item "-o"
از این گزینه تنها زمانی می‌توان استفاده کرد که دستور روی میزبانی که سرور \&\fBinnd\fR در آن در حال اجراست اجرا شود. در صورت استفاده از این گزینه، \fBnntpget\fR برای دریافت مقاله‌ها به \fIhost\fR دوردست مشخص‌شده متصل می‌شود. هر مقاله‌ای که در پایگاه داده محلی \fIhistory\fR وجود نداشته باشد، از سایت دوردست دریافت شده و به سرور محلی ارائه می‌شود.
.Sp
مقاله‌ها به خروجی استاندارد نوشته نمی‌شوند. تنها در صورتی که گزینه \fB\-v\fR نیز استفاده شده باشد، Message-IDهای پردازش‌شده نوشته خواهند شد.
.IP "\fB\-t\fR \fItimestring\fR" 4
.IX Item "-t timestring"
در صورت استفاده از این گزینه، \fItimestring\fR مشخص‌شده به‌عنوان پارامتر زمان و تاریخ برای دستور \f(CW\*(C`NEWNEWS\*(C'\fR استفاده می‌شود. تنها مقالاتی که از آن برچسب زمانی به بعد به سرور دوردست رسیده‌اند دریافت می‌شوند.
.Sp
مقدار \fItimestring\fR به صورت \f(CW\*(C`yyyymmdd hhmmss GMT\*(C'\fR مشخص می‌شود که در آن \f(CW\*(C`yyyy\*(C'\fR سال، \f(CW\*(C`mm\*(C'\fR ماه، \f(CW\*(C`dd\*(C'\fR روز ماه، \f(CW\*(C`hh\*(C'\fR ساعت در قالب ۲۴ ساعته، \f(CW\*(C`mm\*(C'\fR دقیقه و \f(CW\*(C`ss\*(C'\fR ثانیه است. شناسه \f(CW\*(C`GMT\*(C'\fR مشخص می‌کند که تاریخ و زمان بر اساس ساعت هماهنگ جهانی (UTC) ارائه شده‌اند.
.IP "\fB\-u\fR \fIfile\fR" 4
.IX Item "-u file"
این گزینه مانند \fB\-f\fR است، با این تفاوت که اگر انتقال با موفقیت انجام شود، فایل با یک خط آمار به‌روزرسانی شده و برچسب زمانی آن تغییر می‌یابد تا بتوان از آن در اجراهای بعدی استفاده کرد.
.IP \fB\-v\fR 4
.IX Item "-v"
اگر از این گزینه همراه با \fB\-o\fR استفاده شود، سپس Message-ID هر مقاله هنگام پردازش به خروجی استاندارد ارسال خواهد شد.
.SH "تاریخچه (HISTORY)"
.IX Header "HISTORY"
نوشته شده توسط Rich $alz <rsalz@uunet.uu.net> برای InterNetNews. بازنویسی شده به فرمت POD توسط Julien Elie.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
innd(8), passwd.nntp(5).