NTPLOGGPS(1)

🛰️ NTPLOGGPS(1) — like, the ntploggps girlies' guide 💖

okay bestie, so this is ntploggps from the NTPsec fam — pull up a chair, we're logging gpsd data and it's gonna be adorable ✨

---

🌸 NAME 🌸

ntploggps — literally just logs your gpsd data. that's the whole vibe. no cap. 💅

---

🦋 SYNOPSIS 🦋

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

and here's the quick-reference menu, so you know what you're ordering:

• -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 after each log line, default 5
• -v, --verbose — be verbose
• -V, --version — show program's version number and exit

---

✨ DESCRIPTION ✨

so ntploggps connects to a local gpsd daemon and logs two things: the number of satellites in use, and the Time Dilution of Precision (TDOP). obsessed. 🎀

the best part? ntploggps can run as any user — no special privileges required. she's lowkey for the people. 🫶

default behavior is to write the data to stdout about once every 5 seconds. and the log file? it's giving 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 me break down the columns for you, because iykyk:

• 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 (iconic of them, honestly).
• nSat — the number of satellites in use. 🛰️

---

🎀 OPTIONS 🎀

• -h, --help — displays usage information and exits. your little safety net. 💖
• -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
• -w WAIT, --wait WAIT — wait WAIT seconds after each log line. the default is 5 seconds. and listen — this is just the minimum wait time. gpsd may be reporting data at a much slower interval, so don't come for her if it's slower, okay? 😭
• -V, --version — show program's version number and exit

---

🌈 USAGE 🌈

ntploggps

the simplest possible use of this program. perfect for checking the status of your local gpsd daemon — a little vibe check, if you will. ⭐

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

this one will continuously log the gpsd data in the background to the file /var/log/ntpstats/gpsd. only logs every 60 seconds. set it and forget it, bestie. 🔥

---

👑 AUTHORS 👑

Gary E. Miller — the one who made this happen. we stan. 🫶

---

💀 EXIT STATUS 💀

one of the following exit values will be returned:

• 0 (EXIT_SUCCESS) — successful program execution. slay. ✨
• 1 (EXIT_FAILURE) — the operation failed or the command syntax was not valid. not slay, but we recover. 🙈

---

ok that's the whole page, no notes. go log some satellites, bestie 💜

NTPsec 🦋 2026-08-02 — mwah, see you in the group chat 💖🎀✨