NTPLOGGPS(8)

💖 NTPLOGGPS(8) — the ntploggps glow-up 💖

okay bestie, welcome to the ntploggps page, part of the NTPsec manual set. this lil cutie logs gpsd data and honestly? she's iconic for it. sit down, grab a strawberry 🍓, and let's get you fluent.

---

✨ NAME ✨

ntploggps — log gpsd data 💅

---

✨ SYNOPSIS ✨

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

---

🦋 DESCRIPTION 🦋

so here's the tea ☕ — ntploggps connects to a local gpsd daemon and logs two things: the number of satellites in use and the Time Dilution of Precision (TDOP). that's it. that's the whole job. and the best part? ntploggps can run as any user — no special privileges are required, bestie, you literally don't need root. periodt. 👑

the default vibe is: 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

now let's break down those columns, because each one is a main character 🌟:

• Time — this is the POSIX time of when the log line is written. ⏰
• Device — the GPS device the data came from. (hi /dev/ttyS0 we love you 🫶)
• TDOP — the Time Dilution of Precision as reported by the GPS. heads up: some GPS always output a static TDOP, so don't come for her if the number never moves. 💀
• nSat — the number of satellites in use. 🛰️✨

---

🌸 OPTIONS 🌸

here come the flags, and no cap, you're gonna want to know all of them:

• -h, --help — Displays usage information and exits. your classic "wait what does this do again" button. 🙈
• -l LOGFILE, --logfile LOGFILE — Append log data to LOGFILE instead of stdout. 📝
• -o, --once — Log one line, then exit. one and done, she's a hit it and quit it kinda tool. 💅
• -v, --verbose — Be verbose. spill the details, bestie. 🗣️
• -w WAIT, --wait WAIT — Wait WAIT seconds after each log line. The default is 5 seconds. and okay important caveat: this is just the minimum wait time — gpsd may be reporting data at a much slower interval. so don't @ her if the lines come slower than you asked. 🫠
• -V, --version — show program's version number and exit. 🌈

---

🎀 USAGE 🎀

the bare minimum slay

ntploggps

This the simplest use of this program. It can be used to check the status of the local gpsd daemon. 🩺

the background girlboss move

ntploggps -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. ⏳ — and yes, that trailing & is doing the heavy lifting, she's the whole moment. 💖

---

👑 AUTHORS 👑

Gary E. Miller — we stan. 🫶

---

⭐ EXIT STATUS ⭐

One of the following exit values will be returned:

• 0 (EXIT_SUCCESS) — Successful program execution. 🎉 everything ate, no crumbs.
• 1 (EXIT_FAILURE) — The operation failed or the command syntax was not valid. 😭 it's giving flop, check your syntax.

---

lowkey reminder: -w WAIT sets the minimum wait, not a promise. gpsd runs on its own timeline, bestie. 🧚

---

and that's the whole page!! 💜 this was NTPsec, dated 2026-07-24, from the NTPLOGGPS(8) manual — mwah, go log some satellites, you absolute icon. 🎀✨🛰️