GPSLOGNTP(1)

💖 GPSLOGNTP 💖

okay bestie, welcome to the gpslogntp manual page — yes it's from the GPSD Documentation, and yes it's lowkey iconic. sit down, grab a boba, and let's get into it 🧋✨

---

✨ NAME ✨

gpslogntp — log gpsd data for ntpviz

---

🦋 SYNOPSIS 🦋

gpslogntp [-h] [-l LOGFILE] [-o] [-w WAIT] [-v] [-V]

    -h, --help            show this help message and exit
    -l LOGFILE, --logfile LOGFILE
                          append log data to LOGFILE instead of stdout
    -o, --once            log one line, then exit
    -w WAIT, --wait WAIT  wait WAIT seconds between log lines, default 5
    -v, --verbose         be verbose
    -V, --version         show program's version number and exit

---

🌸 DESCRIPTION 🌸

so what does gpslogntp actually do? it connects to a local gpsd daemon and logs the number of satellites in use plus the Time Dilution of Precision (TDOP). and the best part? gpslogntp can run as any user, no special privileges are required. no sudo, no drama, no "permission denied" meltdown 💅. this log is intended to be used by ntpviz.

the default vibe is: write the data to stdout about once every 5 seconds. the log file looks like this:

# 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

let's break down those columns, because they're all doing something:

• Time — the POSIX time of when the log line is written. ⏰
• Device — the GPS device the data came from.
• TDOP — the Time Dilution of Precision as reported by the GPS. heads up: some GPS always output a static TDOP 🙃
• nSat — the number of satellites in use. 🛰️

formerly known as ntploggps and formerly part of NTPsec. glow-up era fr fr.

Note: Many GNSS receivers always report TDOP as "1.0". not a bug, just the way they are 🫶

---

💅 OPTIONS 💅

• -h, --help — Displays usage information and exits. the classic escape hatch 🚪
• -l LOGFILE, --logfile LOGFILE — Append log data to LOGFILE instead of stdout.
• -o, --once — Log one line, then exit. one and done, main character energy 👑
• -v, --verbose — Be verbose. tell me everything bestie 🗣️
• -w WAIT, --wait WAIT — Wait WAIT seconds after each log line. The default is 5 seconds. This is just the minimum wait time. gpsd may be reporting data at a much slower interval. so don't come for the timing, it's doing its best 😭
• -V, --version — show program's version number and exit

---

🎀 USAGE 🎀

gpslogntp

this the simplest use of this program. It can be used to check the status of the local gpsd daemon. quick little vibe check, no notes ✨

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

This will continuously log the gpsd data in the background to the file /var/log/ntpstats/gpsd. Only log every 60 seconds. set it and forget it, the background queen 👑

---

🌈 AUTHORS 🌈

Gary E. Miller

---

⭐ EXIT STATUS ⭐

One of the following exit values will be returned:

1. 0 (EXIT_SUCCESS) — Successful program execution. we ate and left no crumbs 🍽️
2. 1 (EXIT_FAILURE) — The operation failed or the command syntax was not valid. 💀

---

🔥 SEE ALSO 🔥

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

iykyk 👀

---

🧚 RESOURCES 🧚

Project web site: https://gpsd.io/

---

💜 COPYING 💜

This file is Copyright by the GPSD project

This file is Copyright by the NTPSec project

SPDX-License-Identifier: BSD-2-clause

---

🫶 AUTHOR 🫶

Gary E. Miller

---

and that's the whole page bestie!! 🎉 this was GPSD, Version 3.27.5, dated 2025-11-04, and honestly? she served. periodt 💅✨🌸