NTPCTL(8)

📦
version 7.9p1 · 3 versions
, in arch rolling

💖 NTPCTL(8) — the control-your-NTP-daemon page 🕐✨

okay bestie, welcome to ntpctl(8) from the System Manager's Manual section — yes this is the little sidekick that lets you peek inside your running ntpd(8) daemon 👀. No cap, it's giving "I just want to know what my clock is doing" energy, and honestly? Same.

✨ NAME ✨

ntpctl — control the NTP daemon 🫶

🌸 SYNOPSIS 🌸

ntpctl -s all | peers | Sensors | status

💜 DESCRIPTION 💜

The ntpctl program displays information about the running ntpd(8) daemon. literally just a vibe check for your time sync situation, and it always passes iced tea ☕✨

The options are as follows:

  • -s all | peers | Sensors | status — used to display information about the running daemon. Keywords may be abbreviated (yes bestie, you can be lazy, it's fine 💅).
    • all shows all data available. the whole buffet, no crumbs left 🍓
    • peers shows the following information about each peer: weight, trustlevel, stratum, number of seconds until the next poll, polling interval in seconds, and offset, network delay and network jitter in milliseconds. When the system clock is synced to a peer, an asterisk is displayed to the left of the weight column for that peer. ⭐ that little star is the main character of the row, iykyk
    • Sensors shows the following information about each sensor: weight, sensor "good" status, stratum, and offset and the configured correction in milliseconds. When the system clock is synced to a sensor, an asterisk is displayed to the left of the weight column for that sensor. ⭐ (yes, capital S — that's not a typo, that's just how it is, periodt)
    • status shows the status of peers and sensors, and whether the system clock is synced. When the system clock is synced, the stratum is displayed. When the system clock is not synced, the offset of the system clock, as reported by the adjtime(2) system call, is displayed. When the median constraint is set, the offset to the local time is displayed. 😭 it's the "are we synced or not" of it all

🎀 FILES 🎀

  • /var/run/ntpd.sock — socket file for communication with ntpd(8). this is the little pipe between you and the daemon, treat her well 🧚

🦋 SEE ALSO 🦋

adjtime(2), ntpd.conf(5), ntpd(8)

🌈 HISTORY 🌈

The ntpctl program first appeared in OpenBSD 5.5. an icon, a legend, a moment in time (pun fully intended) 👑

bestie reminder: this is NTPCTL(8) from the System Manager's Manual, and it's the Debian build — dated March 2, 2023 🗓️💖. so go check your peers, your sensors, and your status, and slay the clock sync game. mwah 💋✨
📦 where this page comes from