نام (NAME)

ntpshmmon - دریافت نمونه‌ها از gpsd یا سایر منابع refclock برای ntpd

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

ntpshmmon [OPTIONS]

ntpshmmon -h

ntpshmmon -V

توضیحات (DESCRIPTION)

این برنامه قطعه‌های حافظهٔ اشتراکی (shared-memory) را که توسط gpsd(8) و احتمالاً سایر منابع refclock به‌روزرسانی می‌شوند، به‌عنوان روشی برای برقراری ارتباط با ntpd (دیمن پروتکل زمان شبکه) پایش می‌کند. این برنامه سگمنت‌ها را دقیقاً به همان روشی که نمونه‌ای از ntpd می‌خواند، دریافت می‌کند. این برنامه می‌تواند هم‌زمان با ntpd بدون ایجاد تداخل در عملکرد عادی ntpd اجرا شود.

برنامهٔ ntpshmmon برای دسترسی به NTP0 و NTP1 که فقط مختص مدیر سیستم هستند به امتیازات ریشه (root) نیاز دارد. اجرا به‌عنوان یک کاربر عادی تنها امکان دسترسی به NTP2 و NTP3 را فراهم می‌کند که ممکن است باعث از دست رفتن برخی قابلیت‌ها شود.

این برنامه تا ابد، یا تا زمانی که یک گزینهٔ خاتمه برقرار شود، یا تا زمان توقف با وقفه (interrupt) اجرا می‌شود و گزارش‌های نمونه را در خروجی استاندارد تولید می‌کند. هر خط شامل فیلدهای متنی است که با نویسهٔ فاصله (whitespace) از یکدیگر جدا شده‌اند.

در اینجا نمونه‌ای از ابتدای یک فایل گزارش آورده شده است:

ntpshmmon version 3.18
#      Name   Seen@                Clock                Real               L Pre
sample NTP2 1424926256.443030206 1424926256.115869233 1424926256.000000000 0  -1
sample NTP3 1424926256.443060517 1424926255.995430821 1424926256.000000000 0 -20
sample NTP3 1424926256.995747347 1424926256.995422728 1424926257.000000000 0 -20
sample NTP2 1424926257.112433572 1424926257.111936726 1424926257.000000000 0  -1
sample NTP3 1424926257.996221153 1424926257.995410232 1424926258.000000000 0 -20
sample NTP2 1424926258.107769409 1424926258.107451006 1424926258.000000000 0  -1
sample NTP3 1424926258.995647636 1424926258.995406476 1424926259.000000000 0 -20

خروجی همیشه با یک خط سرآیند آغاز می‌شود که بیانگر نسخهٔ قالب خروجی است؛ خط نسخه با «ntpshmmon version» شروع شده و پس از آن یک فیلد عددی برای نسخه قرار دارد.

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

فیلدهای هر خط نمونه به شرح زیر است:

1.کلیدواژهٔ «sample»

2.واحد NTP که داده از آن گردآوری شده است.

3.زمان روزِ گردآوری، به ثانیه.

4.زمان روزِ گیرنده، به ثانیه.

5.زمان روزِ ساعت، به ثانیه.

6.وضعیت اعلان ثانیهٔ کبیسه (leap-second).

7.دقت منبع (لگاریتم بر مبنای ۲ از لغزش/jitter منبع).

در این فیلدها، «زمان ساعت» (clock time) زمانِ با دقت بالای ساعت سیستم است که توسط منبع اندازه‌گیری شده و «زمان گیرنده» (receiver time) زمان دریافتی از گیرنده است. هر دو زمان در مقیاس UTC هستند. طبیعی است که بخش ثانیه‌های زمان گیرنده با بخش ثانیه‌های زمان گردآوری مطابقت داشته باشد و بخش نانوثانیه‌های زمان گیرنده صفر باشد.

اگر از گزینهٔ -o استفاده شود، ستون «Seen@» با ستون «Offset» جایگزین می‌شود. مقدار «Offset» اختلاف بین زمان‌های «Clock» و «Real» است.