'\" t
.\"     Title: ntpshmmon
.\"    Author: Eric S. Raymond
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2025-11-04
.\"    Manual: GPSD Documentation
.\"    Source: GPSD, Version 3.27.5
.\"  Language: English
.\"
.TH "NTPSHMMON" "1" "2025-11-04" "GPSD, Version 3.27.5" "GPSD Documentation"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
ntpshmmon \- دریافت نمونه‌ها از gpsd یا سایر منابع refclock برای ntpd
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBntpshmmon\fP [OPTIONS]
.sp
\fBntpshmmon\fP \-h
.sp
\fBntpshmmon\fP \-V
.SH "توضیحات (DESCRIPTION)"
.sp
این برنامه قطعه‌های حافظهٔ اشتراکی (shared\-memory) را که توسط \fBgpsd\fP(8) و احتمالاً سایر منابع refclock به‌روزرسانی می‌شوند، به‌عنوان روشی برای برقراری ارتباط با \fBntpd\fP (دیمن پروتکل زمان شبکه) پایش می‌کند. این برنامه سگمنت‌ها را دقیقاً به همان روشی که نمونه‌ای از \fBntpd\fP می‌خواند، دریافت می‌کند. این برنامه می‌تواند هم‌زمان با \fBntpd\fP بدون ایجاد تداخل در عملکرد عادی \fBntpd\fP اجرا شود.
.sp
برنامهٔ \fBntpshmmon\fP برای دسترسی به NTP0 و NTP1 که فقط مختص مدیر سیستم هستند به امتیازات ریشه (root) نیاز دارد. اجرا به‌عنوان یک کاربر عادی تنها امکان دسترسی به NTP2 و NTP3 را فراهم می‌کند که ممکن است باعث از دست رفتن برخی قابلیت‌ها شود.
.sp
این برنامه تا ابد، یا تا زمانی که یک گزینهٔ خاتمه برقرار شود، یا تا زمان توقف با وقفه (interrupt) اجرا می‌شود و گزارش‌های نمونه را در خروجی استاندارد تولید می‌کند. هر خط شامل فیلدهای متنی است که با نویسهٔ فاصله (whitespace) از یکدیگر جدا شده‌اند.
.sp
در اینجا نمونه‌ای از ابتدای یک فایل گزارش آورده شده است:
.sp
.if n .RS 4
.nf
.fam C
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
.fam
.fi
.if n .RE
.sp
خروجی همیشه با یک خط سرآیند آغاز می‌شود که بیانگر نسخهٔ قالب خروجی است؛ خط نسخه با «ntpshmmon version» شروع شده و پس از آن یک فیلد عددی برای نسخه قرار دارد.
.sp
باقی فایل شامل خطوط توضیحات یا نمونه است. خط توضیحات با یک کاراکتر # شروع می‌شود و برنامه‌هایی که این قالب را پردازش می‌کنند باید آن را نادیده بگیرند.
.sp
فیلدهای هر خط نمونه به شرح زیر است:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 1." 4.2
.\}
کلیدواژهٔ «sample»
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 2." 4.2
.\}
واحد NTP که داده از آن گردآوری شده است.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 3." 4.2
.\}
زمان روزِ گردآوری، به ثانیه.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 4.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 4." 4.2
.\}
زمان روزِ گیرنده، به ثانیه.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 5.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 5." 4.2
.\}
زمان روزِ ساعت، به ثانیه.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 6.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 6." 4.2
.\}
وضعیت اعلان ثانیهٔ کبیسه (leap\-second).
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 7.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 7." 4.2
.\}
دقت منبع (لگاریتم بر مبنای ۲ از لغزش/jitter منبع).
.RE
.sp
در این فیلدها، «زمان ساعت» (clock time) زمانِ با دقت بالای ساعت سیستم است که توسط منبع اندازه‌گیری شده و «زمان گیرنده» (receiver time) زمان دریافتی از گیرنده است. هر دو زمان در مقیاس UTC هستند. طبیعی است که بخش ثانیه‌های زمان گیرنده با بخش ثانیه‌های زمان گردآوری مطابقت داشته باشد و بخش نانوثانیه‌های زمان گیرنده صفر باشد.
.sp
اگر از گزینهٔ \fB\-o\fP استفاده شود، ستون «Seen@» با ستون «Offset» جایگزین می‌شود. مقدار «Offset» اختلاف بین زمان‌های «Clock» و «Real» است.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-?\fP, \fB\-h\fP, \fB\-\-help\fP
.RS 4
نمایش راهنمای استفاده از برنامه و خروج.
.RE
.sp
\fB\-n COUNT\fP, \fB\-\-count COUNT\fP
.RS 4
تنظیم حداکثر تعداد نمونه‌های گردآوری‌شده روی COUNT.
.RE
.sp
\fB\-o\fP, \fB\-\-offset\fP
.RS 4
جایگزین کردن ستون «Seen@» با ستون «Offset». مقدار «Offset» اختلاف بین زمان‌های «Clock» و «Real» است.
.RE
.sp
\fB\-s\fP, \fB\-\-rmshm\fP
.RS 4
حذف تمامی سگمنت‌های SHM استفاده‌شده توسط GPSD. این گزینه معمولاً فقط برای توسعه‌دهندگان GPSD کاربرد دارد.
.RE
.sp
\fB\-t SECONDS\fP, \fB\-\-seconds SECONDS\fP
.RS 4
تنظیم حداکثر زمان گردآوری نمونه‌ها بر حسب ثانیه روی SECONDS.
.RE
.sp
\fB\-v\fP, \fB\-\-verbose\fP
.RS 4
فعال‌سازی پیام‌های وضعیت با جزئیات کامل (verbose).
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
نمایش نگارش برنامه و خروج.
.RE
.SH "وضعیت خروج (EXIT STATUS)"
.sp
\fB0\fP
.RS 4
در صورت موفقیت.
.RE
.sp
\fB1\fP
.RS 4
در صورت بروز خطا.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBgpsd\fP(8), \fBgps\fP(1)
.SH "منابع (RESOURCES)"
.sp
\fBوبگاه پروژه:\fP \c
.URL "https://gpsd.io" "" ""
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.sp
حق نشر این فایل متعلق به پروژهٔ GPSD است (۲۰۱۳)
.br
SPDX\-License\-Identifier: BSD\-2\-clause
.SH "نویسندگان (AUTHORS)"
.sp
Eric S. Raymond