نام (NAME)

ntptrace - ردیابی سرورهای همتا (peers) در یک سرور NTP

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

ntptrace [-flags] [-flag [value]] [--option-name[[=| ]value]] [host]

توضیحات (DESCRIPTION)

دستور ntptrace یک اسکریپت پرل است که از ابزار ntpq برای دنبال کردن زنجیره سرورهای NTP از یک هاست مشخص تا منبع زمان اولیه استفاده می‌کند. برای کارکرد درست ntptrace، هر یک از این سرورها باید پروتکل کنترل و نظارت NTP مشخص‌شده در RFC 1305 را پیاده‌سازی کرده و بسته‌های حالت ۶ (Mode 6) پروتکل NTP را فعال کرده باشند.

اگر هیچ آرگومانی ارائه نشود، ntptrace با localhost آغاز می‌کند. در زیر نمونه‌ای از خروجی ntptrace آورده شده است:

% ntptrace localhost: stratum 4, offset 0.0019529, synch distance 0.144135
server2ozo.com: stratum 2, offset 0.0124263, synch distance 0.115784 usndh.edu:
stratum 1, offset 0.0019298, synch distance 0.011993, refid 'WWVB'

در هر خط، فیلدها عبارتند از (از چپ به راست): نام هاست، لایه (stratum) هاست، اختلاف زمانی (time offset) بین آن هاست و هاست محلی (همان‌طور که توسط ntptrace اندازه‌گیری شده است؛ به همین دلیل است که برای "localhost" همیشه صفر نیست)، فاصله همگام‌سازی (synchronization distance) هاست، و (تنها برای سرورهای stratum-1) شناسه ساعت مرجع (reference clock ID). تمامی زمان‌ها بر حسب ثانیه داده شده‌اند. توجه داشته باشید که stratum تعداد جهش‌های سرور تا منبع اصلی است، ولی در عین حال synchronization distance میزان خطای تخمینی نسبت به منبع اصلی می‌باشد. این اصطلاحات به طور دقیق در RFC-1305 تعریف شده‌اند.

گزینه‌ها (OPTIONS)

-n, --numeric: چاپ آدرس‌های IP به جای نام‌های میزبان (hostnames).
نمایش خروجی میزبان‌ها در قالب عددی چهاربخشی با نقطه (dotted-quad) به جای تبدیل آنها به نام‌های میزبان رسمی.
-m number, --max-hosts=number: حداکثر تعداد سرورهای همتا برای ردیابی. این گزینه یک عدد صحیح را به عنوان آرگومان دریافت می‌کند. مقدار پیش‌فرض number برای این گزینه برابر است با:
99
این گزینه به طور کامل مستندسازی نشده است.
-r string, --host=string: میزبان راه دور منفرد. مقدار پیش‌فرض string برای این گزینه برابر است با:
127.0.0.1
این گزینه به طور کامل مستندسازی نشده است.
-?, --help: نمایش اطلاعات نحوه استفاده و خروج.
-!, --more-help: ارسال اطلاعات مفصل نحوه استفاده به یک صفحه‌بند (pager).
-v [{v|c|n --version [{v|c|n}]}]: نمایش نسخه برنامه و خروج. حالت پیش‌فرض `v` است که نسخه ساده را نمایش می‌دهد. حالت `c` اطلاعات حق نشر و `n` کل اعلامیه حق نشر را چاپ می‌کند.

وضعیت خروج (EXIT STATUS)

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

0 (EXIT_SUCCESS): اجرای موفقیت‌آمیز برنامه.
1 (EXIT_FAILURE): عملیات ناموفق بود یا ساختار دستور نامعتبر بود.
70 (EX_SOFTWARE): کتابخانه libopts با یک خطای عملیاتی داخلی مواجه شد. لطفاً آن را به autogen-users@lists.sourceforge.net گزارش دهید. با تشکر.

نکات (NOTES)

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