.de1 NOP . it 1 an-trap . if \\n[.$] \,\\$*\/ .. .ie t \ .ds B-Font [CB] .ds I-Font [CI] .ds R-Font [CR] .el \ .ds B-Font B .ds I-Font I .ds R-Font R .TH sntp 1 "25 May 2024" "4.2.8p18" "User Commands" .\" .\" EDIT THIS FILE WITH CAUTION (in-mem file) .\" .\" It has been AutoGen-ed May 25, 2024 at 12:02:30 AM by AutoGen 5.18.16 .\" From the definitions sntp-opts.def .\" and the template file agman-cmd.tpl .SH "نام (NAME)" sntp \- برنامه کارخواه استاندارد پروتکل زمان شبکه ساده (SNTP) .SH "خلاصه دستور (SYNOPSIS)" \f\*[B-Font]sntp\fP .\" Mixture of short (flag) options and long options [\f\*[B-Font]\-flags\f[]] [\f\*[B-Font]\-flag\f[] [\f\*[I-Font]value\f[]]] [\f\*[B-Font]\-\-option-name\f[][[=| ]\f\*[I-Font]value\f[]]] [ hostname-or-IP ...] .sp \n(Ppu .ne 2 .SH "توضیحات (DESCRIPTION)" می‌توان از \f\*[B-Font]sntp\fP به عنوان یک کارخواه SNTP برای ارسال درخواست به کارساز NTP یا SNTP و نمایش زمان یا تنظیم زمان سیستم محلی (با داشتن مجوزهای لازم) استفاده کرد. این برنامه می‌تواند به عنوان یک دستور تعاملی یا از طریق یک جاب \f\*[B-Font]cron\f[] اجرا شود. پروتکل‌های NTP (پروتکل زمان شبکه) و SNTP (پروتکل زمان شبکه ساده) در RFC 5905 تعریف و توصیف شده‌اند. .sp \n(Ppu .ne 2 حالت پیش‌فرض این است که تاریخ و زمان محلی صحیح تخمینی (یعنی غیر از UTC) را در قالبی مانند زیر در خروجی استاندارد بنویسد: \f\*[B-Font]'1996-10-15 20:17:25.123 (+0800) +4.567 +/- 0.089 [host] IP sN'\f[] که در آن عبارت \f\*[B-Font]'(+0800)'\f[] به این معناست که برای رسیدن به UTC از زمان محلی گزارش‌شده باید ۸ ساعت و ۰ دقیقه اضافه کرد، عبارت \f\*[B-Font]'+4.567'\f[] نشان می‌دهد که ساعت محلی ۴.۵۶۷ ثانیه از زمان صحیح عقب‌تر است (بنابراین باید ۴.۵۶۷ ثانیه به ساعت محلی اضافه شود تا درست شود). توجه داشته باشید که تعداد ارقام اعشار چاپ‌شده برای این مقدار بر اساس دقت گزارش‌شده از سوی کارساز تغییر خواهد کرد. عبارت \f\*[B-Font]'+/- 0.089'\f[] فاصله همگام‌سازی گزارش‌شده (\fIsynchronization\f[] \fIdistance\f[]) بر حسب ثانیه است، که نشان‌دهنده بیشینه خطای ناشی از تمام عوامل است. اگر کارساز داده‌های معتبر لازم برای محاسبه فاصله همگام‌سازی را گزارش نکند، این مقدار به صورت \f\*[B-Font]'+/- ?'\f[] گزارش خواهد شد. اگر \fIhost\f[] با \fIIP\f[] متفاوت باشد، هر دو نمایش داده می‌شوند. در غیر این صورت، تنها \fIIP\f[] نمایش داده می‌شود. در نهایت، \fIstratum\f[] میزبان گزارش شده و نشانگر ثانیه کبیسه رمزگشایی و نمایش داده می‌شود. .SH "گزینه‌ها (OPTIONS)" .TP .NOP \f\*[B-Font]\-4\f[], \f\*[B-Font]\-\-ipv4\f[] اجبار به تفکیک نام دامنه (DNS) با IPv4. این گزینه نباید در ترکیب با هیچ‌یک از گزینه‌های زیر بیاید: ipv6. .sp تفکیک نام میزبان‌های بعدی در خط فرمان را به فضای نام IPv4 اجبار می‌کند. .TP .NOP \f\*[B-Font]\-6\f[], \f\*[B-Font]\-\-ipv6\f[] اجبار به تفکیک نام دامنه (DNS) با IPv6. این گزینه نباید در ترکیب با هیچ‌یک از گزینه‌های زیر بیاید: ipv4. .sp تفکیک نام میزبان‌های بعدی در خط فرمان را به فضای نام IPv6 اجبار می‌کند. .TP .NOP \f\*[B-Font]\-a\f[] \f\*[I-Font]auth\-keynumber\f[], \f\*[B-Font]\-\-authentication\f[]=\f\*[I-Font]auth\-keynumber\f[] فعال کردن احراز هویت با کلید \fBauth-keynumber\fP. این گزینه یک عدد صحیح را به عنوان آرگومان دریافت می‌کند. .sp احراز هویت را با استفاده از کلید مشخص‌شده در آرگومان این گزینه فعال می‌کند. آرگومان این گزینه \fBkeyid\fP است، عددی که در \fBkeyfile\fP به عنوان شناسه این کلید تعیین شده است. برای جزئیات بیشتر به گزینه \fBkeyfile\fP (\fB-k\fP) مراجعه کنید. .TP .NOP \f\*[B-Font]\-b\f[] \f\*[I-Font]broadcast\-address\f[], \f\*[B-Font]\-\-broadcast\f[]=\f\*[I-Font]broadcast\-address\f[] گوش دادن به نشانی مشخص‌شده برای همگام‌سازی زمان همگانی (broadcast). این گزینه می‌تواند به تعداد نامحدود تکرار شود. .sp در صورت تعیین، \fBsntp\fP به نشانی مشخص‌شده برای دریافت پیام‌های همگانی NTP گوش می‌دهد. بیشینه زمان انتظار پیش‌فرض را می‌توان (و احتمالاً بهتر است) با \fB-t\fP تغییر داد. .TP .NOP \f\*[B-Font]\-c\f[] \f\*[I-Font]host\-name\f[], \f\*[B-Font]\-\-concurrent\f[]=\f\*[I-Font]host\-name\f[] ارسال هم‌زمان درخواست به تمام IPهای بازگردانده‌شده برای host-name. این گزینه می‌تواند به تعداد نامحدود تکرار شود. .sp درخواست‌ها از یک «کارخواه» NTP به یک «کارساز» نباید سریع‌تر از یکی در هر ۲ ثانیه ارسال شوند. به طور پیش‌فرض، فرض می‌شود هر IP بازگردانده‌شده در جستجوی DNS مربوط به یک نمونه واحد از \fBntpd\fP است و بنابراین \fBsntp\fP درخواست‌ها را یکی پس از دیگری و با وقفه ۲ ثانیه‌ای میان هر درخواست به این IPها می‌فرستد. .sp فلگ \fB-c\fP یا \fB--concurrent\fP بیان می‌کند که هر IP بازگردانده‌شده برای جستجوی DNS نام میزبان داده‌شده روی ماشین‌های متفاوتی قرار دارند، بنابراین می‌توانیم درخواست‌ها را به صورت هم‌زمان ارسال کنیم. .TP .NOP \f\*[B-Font]\-d\f[], \f\*[B-Font]\-\-debug\-level\f[] افزایش سطح پرگویی اشکال‌زدایی (debug). این گزینه می‌تواند به تعداد نامحدود تکرار شود. .sp .TP .NOP \f\*[B-Font]\-D\f[] \f\*[I-Font]number\f[], \f\*[B-Font]\-\-set\-debug\-level\f[]=\f\*[I-Font]number\f[] تنظیم سطح پرگویی اشکال‌زدایی. این گزینه می‌تواند به تعداد نامحدود تکرار شود. این گزینه یک عدد صحیح را به عنوان آرگومان دریافت می‌کند. .sp .TP .NOP \f\*[B-Font]\-g\f[] \f\*[I-Font]milliseconds\f[], \f\*[B-Font]\-\-gap\f[]=\f\*[I-Font]milliseconds\f[] فاصله زمانی (بر حسب میلی‌ثانیه) میان درخواست‌های زمان. این گزینه یک عدد صحیح را به عنوان آرگومان دریافت می‌کند. مقدار پیش‌فرض \f\*[I-Font]milliseconds\f[] برای این گزینه برابر است با: .ti +4 50 .sp از آنجا که ما فقط از اولین پاسخ معتبر دریافتی استفاده خواهیم کرد و پرس‌وجو از تعداد مناسبی از کارسازها مفید است، درخواست‌های ارسالی را به میزان میلی‌ثانیه مشخص‌شده از هم جدا کنید. .TP .NOP \f\*[B-Font]\-K\f[] \f\*[I-Font]file\-name\f[], \f\*[B-Font]\-\-kod\f[]=\f\*[I-Font]file\-name\f[] نام فایل تاریخچه KoD (بوسه مرگ / Kiss-o'-Death). مقدار پیش‌فرض \f\*[I-Font]file\-name\f[] برای این گزینه برابر است با: .ti +4 /var/db/ntp-kod .sp نام فایلی را تعیین می‌کند که برای تاریخچه دائمی پاسخ‌های KoD دریافتی از کارسازها استفاده می‌شود. اگر فایل وجود نداشته باشد، پیامی هشدار نمایش داده خواهد شد. فایل به طور خودکار ایجاد نخواهد شد. .TP .NOP \f\*[B-Font]\-k\f[] \f\*[I-Font]file\-name\f[], \f\*[B-Font]\-\-keyfile\f[]=\f\*[I-Font]file\-name\f[] جستجو در این فایل برای کلید مشخص‌شده با \fB-a\fP. مقدار پیش‌فرض \f\*[I-Font]file\-name\f[] برای این گزینه برابر است با: .ti +4 /etc/ntp.keys .sp این گزینه فایل کلیدها را مشخص می‌کند. برنامه \fBsntp\fP کلید مشخص‌شده با \fB-a\fP \fIkeyno\fP را در این فایل جستجو خواهد کرد. برای اطلاعات بیشتر به \fBntp.keys(5)\fP مراجعه کنید. .TP .NOP \f\*[B-Font]\-l\f[] \f\*[I-Font]file\-name\f[], \f\*[B-Font]\-\-logfile\f[]=\f\*[I-Font]file\-name\f[] ثبت گزارش در فایل لاگ مشخص‌شده. .sp این گزینه باعث می‌شود کارخواه پیام‌های گزارش را در \fIlogfile\fP مشخص‌شده بنویسد. .TP .NOP \f\*[B-Font]\-M\f[] \f\*[I-Font]number\f[], \f\*[B-Font]\-\-steplimit\f[]=\f\*[I-Font]number\f[] تنظیمات زمانی کمتر از \fBsteplimit\fP میلی‌ثانیه به صورت تدریجی (slew) اعمال می‌شوند. این گزینه یک عدد صحیح را به عنوان آرگومان دریافت می‌کند. مقدار \f\*[I-Font]number\f[] محدود است به: .in +4 .nf .na بزرگ‌تر یا مساوی با 0 .fi .in -4 .sp اگر تنظیم زمان کمتر از \fIsteplimit\fP میلی‌ثانیه باشد، مقدار تصحیح با استفاده از \fBadjtime(2)\fP به صورت تدریجی تغییر می‌یابد. در غیر این صورت، تصحیح به صورت جهشی (step) با استفاده از \fBsettimeofday(2)\fP اعمال می‌شود. مقدار پیش‌فرض 0 است، به این معنی که تمام تنظیمات به صورت جهشی انجام خواهند شد. این یک ویژگی است، زیرا شرایط مختلف مقادیر متفاوتی را می‌طلبند. .TP .NOP \f\*[B-Font]\-o\f[] \f\*[I-Font]number\f[], \f\*[B-Font]\-\-ntpversion\f[]=\f\*[I-Font]number\f[] ارسال \fBint\fP به عنوان نسخه پروتکل NTP ما. این گزینه یک عدد صحیح را به عنوان آرگومان دریافت می‌کند. مقدار \f\*[I-Font]number\f[] محدود است به: .in +4 .nf .na در بازه 0 تا 7 .fi .in -4 مقدار پیش‌فرض \f\*[I-Font]number\f[] برای این گزینه برابر است با: .ti +4 4 .sp هنگام ارسال درخواست‌ها به یک کارساز دوردست، به آن‌ها اعلام می‌کند که از کدام نسخه پروتکل NTP استفاده می‌کنیم. .TP .NOP \f\*[B-Font]\-r\f[], \f\*[B-Font]\-\-usereservedport\f[] استفاده از درگاه اختصاص‌یافته NTP (درگاه ۱۲۳). .sp استفاده از درگاه ۱۲۳، که برای NTP رزرو شده است، برای ارتباطات شبکه ما. .TP .NOP \f\*[B-Font]\-S\f[], \f\*[B-Font]\-\-step\f[] مجاز بودن تنظیم جهشی زمان با \fBsettimeofday(2)\fP. .sp .TP .NOP \f\*[B-Font]\-s\f[], \f\*[B-Font]\-\-slew\f[] مجاز بودن تنظیم تدریجی زمان با \fBadjtime(2)\fP. .sp .TP .NOP \f\*[B-Font]\-t\f[] \f\*[I-Font]seconds\f[], \f\*[B-Font]\-\-timeout\f[]=\f\*[I-Font]seconds\f[] تعداد ثانیه‌ها برای انتظار دریافت پاسخ. این گزینه یک عدد صحیح را به عنوان آرگومان دریافت می‌کند. مقدار پیش‌فرض \f\*[I-Font]seconds\f[] برای این گزینه برابر است با: .ti +4 5 .sp هنگام انتظار برای پاسخ، \fBsntp\fP به اندازه ثانیه‌های مشخص‌شده پیش از انصراف صبر خواهد کرد. مقدار پیش‌فرض باید برای یک پاسخ یونیکست (تک‌پخشی) کاملاً کافی باشد. اگر \fBsntp\fP فقط در انتظار پاسخ همگانی (broadcast) باشد، احتمالاً به مهلت زمانی بیشتری نیاز است. .TP .NOP \f\*[B-Font]\-\-wait\f[], \f\*[B-Font]\-\-no\-wait\f[] منتظر ماندن برای پاسخ‌های در حال تعلیق (در صورتی که زمان سیستم تنظیم نمی‌شود). فرم \fIno\-wait\fP گزینه را غیرفعال می‌کند. این گزینه به صورت پیش‌فرض فعال است. .sp اگر زمان سیستم را تنظیم نمی‌کنیم، منتظر دریافت تمام پاسخ‌های معلق بماند. .TP .NOP \f\*[B-Font]\-\&?\f[], \f\*[B-Font]\-\-help\f[] نمایش اطلاعات نحوه استفاده و خروج. .TP .NOP \f\*[B-Font]\-\&!\f[], \f\*[B-Font]\-\-more-help\f[] ارسال اطلاعات استفاده گسترده از طریق یک صفحه‌بندی‌کننده (pager). .TP .NOP \f\*[B-Font]\->\f[] [\f\*[I-Font]cfgfile\f[]], \f\*[B-Font]\-\-save-opts\f[] [=\f\*[I-Font]cfgfile\f[]] ذخیره وضعیت گزینه‌ها در \fIcfgfile\fP. مقدار پیش‌فرض \fIآخرین\fP فایل پیکربندی فهرست‌شده در بخش \fBپیش‌تنظیم‌های گزینه‌ها (OPTION PRESETS)\fP در زیر است. دستور پس از به‌روزرسانی فایل پیکربندی خارج خواهد شد. .TP .NOP \f\*[B-Font]\-<\f[] \f\*[I-Font]cfgfile\f[], \f\*[B-Font]\-\-load-opts\f[]=\f\*[I-Font]cfgfile\f[], \f\*[B-Font]\-\-no-load-opts\f[] بارگذاری گزینه‌ها از \fIcfgfile\fP. فرم \fIno-load-opts\fP بارگذاری فایل‌های پیکربندی قبلی را غیرفعال می‌کند. گزینه \fI\-\-no-load-opts\fP در مراحل اولیه و خارج از نوبت پردازش می‌شود. .TP .NOP \f\*[B-Font]\-\-version\f[] [{\f\*[I-Font]v|c|n\f[]}] چاپ نسخه برنامه و خروج. حالت پیش‌فرض `v' است، نسخه‌ای ساده. حالت `c' اطلاعات حق نشر را چاپ می‌کند و `n' اعلان کامل حق نشر را چاپ خواهد کرد. .PP .SH "پیش‌تنظیم‌های گزینه‌ها (OPTION PRESETS)" هر گزینه‌ای که به عنوان \fInot presettable\fP (غیرقابل پیش‌تنظیم) علامت‌گذاری نشده باشد می‌تواند با بارگذاری مقادیر از فایل‌های پیکربندی ("RC" یا ".INI") و مقادیر از متغیرهای محیطی با نام‌های زیر پیش‌تنظیم شود: .nf \fBSNTP_\fP یا \fBSNTP\fP .fi .ad پیش‌تنظیم‌های متغیر محیطی بر فایل‌های پیکربندی تقدم دارند (دیرتر از آن‌ها پردازش می‌شوند). فایل‌های \fIhomerc\fP عبارتند از "\fI$HOME\fP" و "\fI.\fP". اگر هر یک از این‌ها دایرکتوری باشند، فایل \fI.ntprc\fP درون آن دایرکتوری‌ها جستجو می‌شود. .SH "نحوه استفاده (USAGE)" .TP 7 .NOP \f[C]sntp ntpserver.somewhere\f[] ساده‌ترین کاربرد این برنامه است و می‌تواند به عنوان یک دستور بدون امتیاز برای بررسی زمان جاری و خطای ساعت محلی اجرا شود. .TP 7 .NOP \f[C]sntp \-Ss \-M 128 ntpserver.somewhere\f[] با داشتن امتیاز لازم، اجرا به صورت یک دستور یا از طریق یک جاب \fCcron\f[]\fR(8)\f[]، دستور \f\*[B-Font]sntp \-Ss \-M 128 ntpserver.somewhere\f[] زمان را از کارساز درخواست می‌کند، و اگر آن کارساز گزارش دهد که همگام است، در صورتی که تعدیل انحراف کمتر از ۱۲۸ میلی‌ثانیه باشد تصحیح به صورت تدریجی (slew) انجام می‌شود، و اگر تصحیح بیشتر از ۱۲۸ میلی‌ثانیه باشد تصحیح به صورت جهشی (step) اعمال خواهد شد. .TP 7 .NOP \f[C]sntp \-S ntpserver.somewhere\f[] با داشتن امتیاز مناسب، اجرا به صورت دستور یا از طریق یک جاب \fCcron\f[]\fR(8)\f[]، دستور \f\*[B-Font]sntp \-S ntpserver.somewhere\f[] ساعت محلی را از یک کارساز مشخص‌شده همگام تنظیم (جهشی) می‌کند، مشابه دستورات (منسوخ‌شده) \fCntpdate\f[]\fR(1)\f[] یا \fCrdate\f[]\fR(8)\f[]. .PP .SH "محیط (ENVIRONMENT)" برای متغیرهای محیطی پیکربندی به \fBپیش‌تنظیم‌های گزینه‌ها (OPTION PRESETS)\fP مراجعه کنید. .SH "فایل‌ها (FILES)" برای فایل‌های پیکربندی به \fBپیش‌تنظیم‌های گزینه‌ها (OPTION PRESETS)\fP مراجعه کنید. .SH "وضعیت خروج (EXIT STATUS)" یکی از مقادیر خروج زیر برگردانده خواهد شد: .TP .NOP 0 " (EXIT_SUCCESS)" اجرای موفقیت‌آمیز برنامه. .TP .NOP 1 " (EXIT_FAILURE)" عملیات با شکست مواجه شد یا نحو دستور معتبر نبود. .TP .NOP 66 " (EX_NOINPUT)" یک فایل پیکربندی مشخص‌شده بارگذاری نشد. .TP .NOP 70 " (EX_SOFTWARE)" کتابخانه libopts با یک خطای عملیاتی داخلی مواجه شد. لطفاً آن را به autogen-users@lists.sourceforge.net گزارش دهید. با تشکر. .PP .SH "نویسندگان (AUTHORS)" .NOP "Johannes Maximilian Kuehn" .br .NOP "Harlan Stenn" .br .NOP "Dave Hart" .br .SH "حق نشر (COPYRIGHT)" حق نشر (C) 1992-2024 متعلق به دانشگاه دلاور و Network Time Foundation است، کلیه حقوق محفوظ است. این برنامه تحت شرایط مجوز NTP منتشر شده است: . .SH "اشکالات (BUGS)" لطفاً گزارش‌های اشکال را به نشانی‌های bugs@ntp.org و https://bugs.ntp.org ارسال کنید. .SH "نکات (NOTES)" این صفحه راهنما توسط \fIAutoGen\fP از روی تعاریف گزینه‌های \fBsntp\fP به طور خودکار تولید شده است.