GPSLOGNTP(1) GPSD Documentation GPSLOGNTP(1)

gpslogntp - ثبت داده‌های gpsd برای تحلیل در ntpviz

gpslogntp [-h] [-l LOGFILE] [-o] [-w WAIT] [-v] [-V]
-h, --help            نمایش این پیام راهنما و خروج
-l LOGFILE, --logfile LOGFILE
                      افزودن داده‌های ثبت‌شده به LOGFILE به جای خروجی استاندارد
-o, --once            ثبت یک خط و سپس خروج
-w WAIT, --wait WAIT  صبر به میزان WAIT ثانیه بین خطوط لاگ، پیش‌فرض ۵
-v, --verbose         حالت با جزئیات کامل
-V, --version         نمایش شماره نسخه برنامه و خروج

دستور gpslogntp به دیمن محلی gpsd متصل می‌شود و تعداد ماهواره‌های در حال استفاده و خطای تضعیف دقت زمانی (TDOP) را ثبت می‌کند. این برنامه می‌تواند با دسترسی هر کاربری اجرا شود و نیازی به مجوزهای ویژه ندارد. لاگ تولیدشده برای استفاده در ntpviz در نظر گرفته شده است.

حالت پیش‌فرض این است که داده‌ها تقریباً هر ۵ ثانیه یک بار در خروجی استاندارد (stdout) نوشته شوند. ساختار فایل لاگ به شکل زیر است:

# 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

ستون Time زمان استاندارد پازیکس (POSIX) در لحظه ثبت خط لاگ است.

ستون Device دستگاه GPS مربوطه است که داده‌ها از آن دریافت شده است.

ستون TDOP میزان تضعیف دقت زمانی گزارش‌شده توسط GPS است. برخی دستگاه‌های GPS همواره مقدار ثابتی از TDOP را تولید می‌کنند.

ستون nSat تعداد ماهواره‌های فعال و در حال استفاده است.

این ابزار قبلاً با نام ntploggps شناخته می‌شد و پیش‌تر بخشی از NTPsec بود.

نکته: بسیاری از گیرنده‌های GNSS همیشه مقدار TDOP را به صورت "1.0" گزارش می‌کنند.

-h, --help

نمایش اطلاعات نحوه استفاده و خروج.

-l LOGFILE, --logfile LOGFILE

افزودن داده‌های ثبت‌شده به انتهای LOGFILE به جای خروجی استاندارد.

-o, --once

ثبت تنها یک خط و سپس خروج.

-v, --verbose

نمایش خروجی با جزئیات کامل.

-w WAIT, --wait WAIT

انتظار به میزان WAIT ثانیه پس از هر خط لاگ. مقدار پیش‌فرض ۵ ثانیه است. این مقدار تنها حداقل زمان انتظار است؛ ممکن است دیمن gpsd داده‌ها را در فواصل طولانی‌تری گزارش کند.

-V, --version

نمایش شماره نسخه برنامه و خروج.

gpslogntp

ساده‌ترین روش استفاده از برنامه است که می‌توان برای بررسی وضعیت دیمن محلی gpsd از آن استفاده کرد.

gpslogntp -l /var/log/ntpstats/gpsd -w 60 &

این دستور به طور مداوم داده‌های gpsd را در پس‌زمینه در فایل /var/log/ntpstats/gpsd ذخیره می‌کند. عمل ثبت لاگ هر ۶۰ ثانیه انجام می‌شود.

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

0 (EXIT_SUCCESS)

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

1 (EXIT_FAILURE)

عملیات با خطا مواجه شد یا ساختار دستور معتبر نبود.

gpsd(8), gps(1), ntpviz(1), ntpd(8).

وب‌سایت پروژه: https://gpsd.io

حق نشر این سند متعلق به پروژه GPSD است
حق نشر این سند متعلق به پروژه NTPSec است
SPDX-License-Identifier: BSD-2-clause

Gary E. Miller

2025-11-04 GPSD, Version 3.27.5