نام (NAME)

nntpget - دریافت مقاله‌های Usenet از یک سرور دوردست NNTP

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

nntpget [-ov] [-f file] [-n newsgroups] [-t timestring] [-u file] host

توضیحات (DESCRIPTION)

دستور nntpget به سرور NNTP در host مشخص‌شده متصل شده و مقاله‌ها را از آن دریافت می‌کند. شناسه‌های Message-ID مقاله‌های مورد نظر از ورودی استاندارد خوانده می‌شوند. مقاله‌ها به خروجی استاندارد فرستاده می‌شوند.

به‌جای خواندن Message-IDها از خروجی استاندارد، گزینه‌های -f، -n، -t و -u از دستور "NEWNEWS" استفاده می‌کنند که ممکن است در سرور دوردست در دسترس نباشد. در یک زمان تنها می‌توان یکی از گزینه‌های -f، -t یا -u را مشخص کرد؛ -n تنها در صورتی می‌تواند مشخص شود که یکی از سه گزینه دیگر در حال استفاده باشد.

اگر اطلاعات احراز هویت سرور دوردست در فایل passwd.nntp واقع در pathetc موجود باشد، nntpget از آن‌ها برای احراز هویت استفاده خواهد کرد.

گزینه‌ها (OPTIONS)

-f file: فهرست Message-IDهای مقاله معمولاً از ورودی استاندارد خوانده می‌شود. اگر از این گزینه استفاده شود، یک دستور "NEWNEWS" برای دریافت تمام مقالاتی که جدیدتر از تاریخ تغییر file مشخص‌شده هستند، استفاده می‌شود.
-n newsgroups: اگر هر یک از گزینه‌های -f، -t یا -u استفاده شوند، می‌توان از این گزینه برای محدود کردن پاسخ‌ها تنها به گروه‌های خبری‌ای (در صورت وجود) که نامشان با فهرست مطابقت دارد استفاده کرد. مقدار پیش‌فرض "*" است، به این معنی که تمام گروه‌های خبری مورد نظر هستند.
فهرست newsgroups می‌تواند شامل چندین الگو و نویسه‌های wildmat باشد. برای نمونه "misc.*,!*.test" یک فهرست معتبر است که به دستور "NEWNEWS" داده خواهد شد.
-o: از این گزینه تنها زمانی می‌توان استفاده کرد که دستور روی میزبانی که سرور innd در آن در حال اجراست اجرا شود. در صورت استفاده از این گزینه، nntpget برای دریافت مقاله‌ها به host دوردست مشخص‌شده متصل می‌شود. هر مقاله‌ای که در پایگاه داده محلی history وجود نداشته باشد، از سایت دوردست دریافت شده و به سرور محلی ارائه می‌شود.
مقاله‌ها به خروجی استاندارد نوشته نمی‌شوند. تنها در صورتی که گزینه -v نیز استفاده شده باشد، Message-IDهای پردازش‌شده نوشته خواهند شد.
-t timestring: در صورت استفاده از این گزینه، timestring مشخص‌شده به‌عنوان پارامتر زمان و تاریخ برای دستور "NEWNEWS" استفاده می‌شود. تنها مقالاتی که از آن برچسب زمانی به بعد به سرور دوردست رسیده‌اند دریافت می‌شوند.
مقدار timestring به صورت "yyyymmdd hhmmss GMT" مشخص می‌شود که در آن "yyyy" سال، "mm" ماه، "dd" روز ماه، "hh" ساعت در قالب ۲۴ ساعته، "mm" دقیقه و "ss" ثانیه است. شناسه "GMT" مشخص می‌کند که تاریخ و زمان بر اساس ساعت هماهنگ جهانی (UTC) ارائه شده‌اند.
-u file: این گزینه مانند -f است، با این تفاوت که اگر انتقال با موفقیت انجام شود، فایل با یک خط آمار به‌روزرسانی شده و برچسب زمانی آن تغییر می‌یابد تا بتوان از آن در اجراهای بعدی استفاده کرد.
-v: اگر از این گزینه همراه با -o استفاده شود، سپس Message-ID هر مقاله هنگام پردازش به خروجی استاندارد ارسال خواهد شد.

تاریخچه (HISTORY)

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

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

innd(8), passwd.nntp(5).