sntp(1) User Commands sntp(1)

sntp - برنامه کارخواه استاندارد پروتکل زمان شبکه ساده (SNTP)

sntp [-flags] [-flag [value]] [--option-name[[=| ]value]] [ hostname-or-IP ...]

می‌توان از sntp به عنوان یک کارخواه SNTP برای ارسال درخواست به کارساز NTP یا SNTP و نمایش زمان یا تنظیم زمان سیستم محلی (با داشتن مجوزهای لازم) استفاده کرد. این برنامه می‌تواند به عنوان یک دستور تعاملی یا از طریق یک جاب cron اجرا شود. پروتکل‌های NTP (پروتکل زمان شبکه) و SNTP (پروتکل زمان شبکه ساده) در RFC 5905 تعریف و توصیف شده‌اند.

حالت پیش‌فرض این است که تاریخ و زمان محلی صحیح تخمینی (یعنی غیر از UTC) را در قالبی مانند زیر در خروجی استاندارد بنویسد: '1996-10-15 20:17:25.123 (+0800) +4.567 +/- 0.089 [host] IP sN' که در آن عبارت '(+0800)' به این معناست که برای رسیدن به UTC از زمان محلی گزارش‌شده باید ۸ ساعت و ۰ دقیقه اضافه کرد، عبارت '+4.567' نشان می‌دهد که ساعت محلی ۴.۵۶۷ ثانیه از زمان صحیح عقب‌تر است (بنابراین باید ۴.۵۶۷ ثانیه به ساعت محلی اضافه شود تا درست شود). توجه داشته باشید که تعداد ارقام اعشار چاپ‌شده برای این مقدار بر اساس دقت گزارش‌شده از سوی کارساز تغییر خواهد کرد. عبارت '+/- 0.089' فاصله همگام‌سازی گزارش‌شده (synchronization distance) بر حسب ثانیه است، که نشان‌دهنده بیشینه خطای ناشی از تمام عوامل است. اگر کارساز داده‌های معتبر لازم برای محاسبه فاصله همگام‌سازی را گزارش نکند، این مقدار به صورت '+/- ?' گزارش خواهد شد. اگر host با IP متفاوت باشد، هر دو نمایش داده می‌شوند. در غیر این صورت، تنها IP نمایش داده می‌شود. در نهایت، stratum میزبان گزارش شده و نشانگر ثانیه کبیسه رمزگشایی و نمایش داده می‌شود.

-4, --ipv4

اجبار به تفکیک نام دامنه (DNS) با IPv4. این گزینه نباید در ترکیب با هیچ‌یک از گزینه‌های زیر بیاید: ipv6.

تفکیک نام میزبان‌های بعدی در خط فرمان را به فضای نام IPv4 اجبار می‌کند.

-6, --ipv6

اجبار به تفکیک نام دامنه (DNS) با IPv6. این گزینه نباید در ترکیب با هیچ‌یک از گزینه‌های زیر بیاید: ipv4.

تفکیک نام میزبان‌های بعدی در خط فرمان را به فضای نام IPv6 اجبار می‌کند.


فعال کردن احراز هویت با کلید auth-keynumber. این گزینه یک عدد صحیح را به عنوان آرگومان دریافت می‌کند.

احراز هویت را با استفاده از کلید مشخص‌شده در آرگومان این گزینه فعال می‌کند. آرگومان این گزینه keyid است، عددی که در keyfile به عنوان شناسه این کلید تعیین شده است. برای جزئیات بیشتر به گزینه keyfile (-k) مراجعه کنید.


گوش دادن به نشانی مشخص‌شده برای همگام‌سازی زمان همگانی (broadcast). این گزینه می‌تواند به تعداد نامحدود تکرار شود.

در صورت تعیین، sntp به نشانی مشخص‌شده برای دریافت پیام‌های همگانی NTP گوش می‌دهد. بیشینه زمان انتظار پیش‌فرض را می‌توان (و احتمالاً بهتر است) با -t تغییر داد.


ارسال هم‌زمان درخواست به تمام IPهای بازگردانده‌شده برای host-name. این گزینه می‌تواند به تعداد نامحدود تکرار شود.

درخواست‌ها از یک «کارخواه» NTP به یک «کارساز» نباید سریع‌تر از یکی در هر ۲ ثانیه ارسال شوند. به طور پیش‌فرض، فرض می‌شود هر IP بازگردانده‌شده در جستجوی DNS مربوط به یک نمونه واحد از ntpd است و بنابراین sntp درخواست‌ها را یکی پس از دیگری و با وقفه ۲ ثانیه‌ای میان هر درخواست به این IPها می‌فرستد.

فلگ -c یا --concurrent بیان می‌کند که هر IP بازگردانده‌شده برای جستجوی DNS نام میزبان داده‌شده روی ماشین‌های متفاوتی قرار دارند، بنابراین می‌توانیم درخواست‌ها را به صورت هم‌زمان ارسال کنیم.


افزایش سطح پرگویی اشکال‌زدایی (debug). این گزینه می‌تواند به تعداد نامحدود تکرار شود.

تنظیم سطح پرگویی اشکال‌زدایی. این گزینه می‌تواند به تعداد نامحدود تکرار شود. این گزینه یک عدد صحیح را به عنوان آرگومان دریافت می‌کند.

فاصله زمانی (بر حسب میلی‌ثانیه) میان درخواست‌های زمان. این گزینه یک عدد صحیح را به عنوان آرگومان دریافت می‌کند. مقدار پیش‌فرض milliseconds برای این گزینه برابر است با:
50

از آنجا که ما فقط از اولین پاسخ معتبر دریافتی استفاده خواهیم کرد و پرس‌وجو از تعداد مناسبی از کارسازها مفید است، درخواست‌های ارسالی را به میزان میلی‌ثانیه مشخص‌شده از هم جدا کنید.


نام فایل تاریخچه KoD (بوسه مرگ / Kiss-o'-Death). مقدار پیش‌فرض file-name برای این گزینه برابر است با:
/var/db/ntp-kod

نام فایلی را تعیین می‌کند که برای تاریخچه دائمی پاسخ‌های KoD دریافتی از کارسازها استفاده می‌شود. اگر فایل وجود نداشته باشد، پیامی هشدار نمایش داده خواهد شد. فایل به طور خودکار ایجاد نخواهد شد.


جستجو در این فایل برای کلید مشخص‌شده با -a. مقدار پیش‌فرض file-name برای این گزینه برابر است با:
/etc/ntp.keys

این گزینه فایل کلیدها را مشخص می‌کند. برنامه sntp کلید مشخص‌شده با -a keyno را در این فایل جستجو خواهد کرد. برای اطلاعات بیشتر به ntp.keys(5) مراجعه کنید.


ثبت گزارش در فایل لاگ مشخص‌شده.

این گزینه باعث می‌شود کارخواه پیام‌های گزارش را در logfile مشخص‌شده بنویسد.


تنظیمات زمانی کمتر از steplimit میلی‌ثانیه به صورت تدریجی (slew) اعمال می‌شوند. این گزینه یک عدد صحیح را به عنوان آرگومان دریافت می‌کند. مقدار number محدود است به: 
بزرگ‌تر یا مساوی با 0

اگر تنظیم زمان کمتر از steplimit میلی‌ثانیه باشد، مقدار تصحیح با استفاده از adjtime(2) به صورت تدریجی تغییر می‌یابد. در غیر این صورت، تصحیح به صورت جهشی (step) با استفاده از settimeofday(2) اعمال می‌شود. مقدار پیش‌فرض 0 است، به این معنی که تمام تنظیمات به صورت جهشی انجام خواهند شد. این یک ویژگی است، زیرا شرایط مختلف مقادیر متفاوتی را می‌طلبند.


ارسال int به عنوان نسخه پروتکل NTP ما. این گزینه یک عدد صحیح را به عنوان آرگومان دریافت می‌کند. مقدار number محدود است به: 
در بازه 0 تا 7

مقدار پیش‌فرض number برای این گزینه برابر است با:
4

هنگام ارسال درخواست‌ها به یک کارساز دوردست، به آن‌ها اعلام می‌کند که از کدام نسخه پروتکل NTP استفاده می‌کنیم.


استفاده از درگاه اختصاص‌یافته NTP (درگاه ۱۲۳).

استفاده از درگاه ۱۲۳، که برای NTP رزرو شده است، برای ارتباطات شبکه ما.


مجاز بودن تنظیم جهشی زمان با settimeofday(2).

مجاز بودن تنظیم تدریجی زمان با adjtime(2).

تعداد ثانیه‌ها برای انتظار دریافت پاسخ. این گزینه یک عدد صحیح را به عنوان آرگومان دریافت می‌کند. مقدار پیش‌فرض seconds برای این گزینه برابر است با:
5

هنگام انتظار برای پاسخ، sntp به اندازه ثانیه‌های مشخص‌شده پیش از انصراف صبر خواهد کرد. مقدار پیش‌فرض باید برای یک پاسخ یونیکست (تک‌پخشی) کاملاً کافی باشد. اگر sntp فقط در انتظار پاسخ همگانی (broadcast) باشد، احتمالاً به مهلت زمانی بیشتری نیاز است.


منتظر ماندن برای پاسخ‌های در حال تعلیق (در صورتی که زمان سیستم تنظیم نمی‌شود). فرم no-wait گزینه را غیرفعال می‌کند. این گزینه به صورت پیش‌فرض فعال است.

اگر زمان سیستم را تنظیم نمی‌کنیم، منتظر دریافت تمام پاسخ‌های معلق بماند.

-?, --help

نمایش اطلاعات نحوه استفاده و خروج.
-!, --more-help

ارسال اطلاعات استفاده گسترده از طریق یک صفحه‌بندی‌کننده (pager).
-> [cfgfile], --save-opts [=cfgfile]

ذخیره وضعیت گزینه‌ها در cfgfile. مقدار پیش‌فرض آخرین فایل پیکربندی فهرست‌شده در بخش پیش‌تنظیم‌های گزینه‌ها (OPTION PRESETS) در زیر است. دستور پس از به‌روزرسانی فایل پیکربندی خارج خواهد شد.
-< cfgfile, --load-opts=cfgfile, --no-load-opts

بارگذاری گزینه‌ها از cfgfile. فرم no-load-opts بارگذاری فایل‌های پیکربندی قبلی را غیرفعال می‌کند. گزینه --no-load-opts در مراحل اولیه و خارج از نوبت پردازش می‌شود.

چاپ نسخه برنامه و خروج. حالت پیش‌فرض `v' است، نسخه‌ای ساده. حالت `c' اطلاعات حق نشر را چاپ می‌کند و `n' اعلان کامل حق نشر را چاپ خواهد کرد.

هر گزینه‌ای که به عنوان not presettable (غیرقابل پیش‌تنظیم) علامت‌گذاری نشده باشد می‌تواند با بارگذاری مقادیر از فایل‌های پیکربندی ("RC" یا ".INI") و مقادیر از متغیرهای محیطی با نام‌های زیر پیش‌تنظیم شود:

SNTP_<option-name> یا SNTP

پیش‌تنظیم‌های متغیر محیطی بر فایل‌های پیکربندی تقدم دارند (دیرتر از آن‌ها پردازش می‌شوند). فایل‌های homerc عبارتند از "$HOME" و ".". اگر هر یک از این‌ها دایرکتوری باشند، فایل .ntprc درون آن دایرکتوری‌ها جستجو می‌شود.

sntp ntpserver.somewhere

ساده‌ترین کاربرد این برنامه است و می‌تواند به عنوان یک دستور بدون امتیاز برای بررسی زمان جاری و خطای ساعت محلی اجرا شود.
sntp -Ss -M 128 ntpserver.somewhere

با داشتن امتیاز لازم، اجرا به صورت یک دستور یا از طریق یک جاب cron(8)، دستور sntp -Ss -M 128 ntpserver.somewhere زمان را از کارساز درخواست می‌کند، و اگر آن کارساز گزارش دهد که همگام است، در صورتی که تعدیل انحراف کمتر از ۱۲۸ میلی‌ثانیه باشد تصحیح به صورت تدریجی (slew) انجام می‌شود، و اگر تصحیح بیشتر از ۱۲۸ میلی‌ثانیه باشد تصحیح به صورت جهشی (step) اعمال خواهد شد.
sntp -S ntpserver.somewhere

با داشتن امتیاز مناسب، اجرا به صورت دستور یا از طریق یک جاب cron(8)، دستور sntp -S ntpserver.somewhere ساعت محلی را از یک کارساز مشخص‌شده همگام تنظیم (جهشی) می‌کند، مشابه دستورات (منسوخ‌شده) ntpdate(1) یا rdate(8).

برای متغیرهای محیطی پیکربندی به پیش‌تنظیم‌های گزینه‌ها (OPTION PRESETS) مراجعه کنید.

برای فایل‌های پیکربندی به پیش‌تنظیم‌های گزینه‌ها (OPTION PRESETS) مراجعه کنید.

یکی از مقادیر خروج زیر برگردانده خواهد شد:

0 (EXIT_SUCCESS)

اجرای موفقیت‌آمیز برنامه.
1 (EXIT_FAILURE)

عملیات با شکست مواجه شد یا نحو دستور معتبر نبود.
66 (EX_NOINPUT)

یک فایل پیکربندی مشخص‌شده بارگذاری نشد.
70 (EX_SOFTWARE)

کتابخانه libopts با یک خطای عملیاتی داخلی مواجه شد. لطفاً آن را به autogen-users@lists.sourceforge.net گزارش دهید. با تشکر.

Johannes Maximilian Kuehn
Harlan Stenn
Dave Hart

حق نشر (C) 1992-2024 متعلق به دانشگاه دلاور و Network Time Foundation است، کلیه حقوق محفوظ است. این برنامه تحت شرایط مجوز NTP منتشر شده است: http://ntp.org/license.

لطفاً گزارش‌های اشکال را به نشانی‌های bugs@ntp.org و https://bugs.ntp.org ارسال کنید.

این صفحه راهنما توسط AutoGen از روی تعاریف گزینه‌های sntp به طور خودکار تولید شده است.

25 May 2024 4.2.8p18