'\" t
.\"     Title: gpslogntp
.\"    Author: Gary E. Miller
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2025-11-04
.\"    Manual: GPSD Documentation
.\"    Source: GPSD, Version 3.27.5
.\"  Language: English
.\"
.TH "GPSLOGNTP" "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)"
gpslogntp \- ثبت داده‌های gpsd برای تحلیل در ntpviz
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
gpslogntp [\-h] [\-l LOGFILE] [\-o] [\-w WAIT] [\-v] [\-V]
.fi
.br
.sp
.if n .RS 4
.nf
.fam C
\-h, \-\-help\&            نمایش این پیام راهنما و خروج
\-l LOGFILE, \-\-logfile LOGFILE
                      افزودن داده‌های ثبت‌شده به LOGFILE به جای خروجی استاندارد
\-o, \-\-once\&            ثبت یک خط و سپس خروج
\-w WAIT, \-\-wait WAIT\&  صبر به میزان WAIT ثانیه بین خطوط لاگ، پیش‌فرض ۵
\-v, \-\-verbose\&         حالت با جزئیات کامل
\-V, \-\-version\&         نمایش شماره نسخه برنامه و خروج
.fam
.fi
.if n .RE
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBgpslogntp\fP به دیمن محلی gpsd متصل می‌شود و تعداد ماهواره‌های در حال استفاده و خطای تضعیف دقت زمانی (TDOP) را ثبت می‌کند. این برنامه می‌تواند با دسترسی هر کاربری اجرا شود و نیازی به مجوزهای ویژه ندارد. لاگ تولیدشده برای استفاده در \fBntpviz\fP در نظر گرفته شده است.
.sp
حالت پیش‌فرض این است که داده‌ها تقریباً هر ۵ ثانیه یک بار در خروجی استاندارد (stdout) نوشته شوند. ساختار فایل لاگ به شکل زیر است:
.sp
.if n .RS 4
.nf
.fam C
# Time\&       Device\&     TDOP\&     nSat
1483668619.0 /dev/ttyS0 0.820000 7
1483668624.0 /dev/ttyS0 0.820000 7
1483668629.0 /dev/ttyS0 0.820000 7
.fam
.fi
.if n .RE
.sp
ستون Time زمان استاندارد پازیکس (POSIX) در لحظه ثبت خط لاگ است.
.sp
ستون Device دستگاه GPS مربوطه است که داده‌ها از آن دریافت شده است.
.sp
ستون TDOP میزان تضعیف دقت زمانی گزارش‌شده توسط GPS است. برخی دستگاه‌های GPS همواره مقدار ثابتی از TDOP را تولید می‌کنند.
.sp
ستون nSat تعداد ماهواره‌های فعال و در حال استفاده است.
.sp
این ابزار قبلاً با نام \fBntploggps\fP شناخته می‌شد و پیش‌تر بخشی از NTPsec بود.
.sp
نکته: بسیاری از گیرنده‌های GNSS همیشه مقدار TDOP را به صورت "1.0" گزارش می‌کنند.
.SH "گزینه‌ها (OPTIONS)"
.sp
\-h, \-\-help
.RS 4
نمایش اطلاعات نحوه استفاده و خروج.
.RE
.sp
\-l LOGFILE, \-\-logfile LOGFILE
.RS 4
افزودن داده‌های ثبت‌شده به انتهای LOGFILE به جای خروجی استاندارد.
.RE
.sp
\-o, \-\-once
.RS 4
ثبت تنها یک خط و سپس خروج.
.RE
.sp
\-v, \-\-verbose
.RS 4
نمایش خروجی با جزئیات کامل.
.RE
.sp
\-w WAIT, \-\-wait WAIT
.RS 4
انتظار به میزان WAIT ثانیه پس از هر خط لاگ. مقدار پیش‌فرض ۵ ثانیه است. این مقدار تنها حداقل زمان انتظار است؛ ممکن است دیمن gpsd داده‌ها را در فواصل طولانی‌تری گزارش کند.
.RE
.sp
\-V, \-\-version
.RS 4
نمایش شماره نسخه برنامه و خروج.
.RE
.SH "نحوه استفاده (USAGE)"
.sp
gpslogntp
.RS 4
ساده‌ترین روش استفاده از برنامه است که می‌توان برای بررسی وضعیت دیمن محلی gpsd از آن استفاده کرد.
.RE
.sp
gpslogntp \-l /var/log/ntpstats/gpsd \-w 60 &
.RS 4
این دستور به طور مداوم داده‌های gpsd را در پس‌زمینه در فایل /var/log/ntpstats/gpsd ذخیره می‌کند. عمل ثبت لاگ هر ۶۰ ثانیه انجام می‌شود.
.RE
.SH "وضعیت خروج (EXIT STATUS)"
.sp
یکی از مقادیر وضعیت خروج زیر بازگردانده می‌شود:
.sp
0 (EXIT_SUCCESS)
.RS 4
اجرای موفقیت‌آمیز برنامه.
.RE
.sp
1 (EXIT_FAILURE)
.RS 4
عملیات با خطا مواجه شد یا ساختار دستور معتبر نبود.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBgpsd\fP(8), \fBgps\fP(1), \fBntpviz\fP(1), \fBntpd\fP(8).
.SH "منابع (RESOURCES)"
.sp
\fBوب‌سایت پروژه:\fP \c
.URL "https://gpsd.io" "" ""
.SH "کپی‌رایت و تکثیر (COPYING)"
.sp
حق نشر این سند متعلق به پروژه GPSD است
.br
حق نشر این سند متعلق به پروژه NTPSec است
.br
SPDX\-License\-Identifier: BSD\-2\-clause
.SH "نویسندگان (AUTHORS)"
.sp
Gary E. Miller