NTP-CTL(8)

📦
version 1.9.0 · 6 versions
, in arch rolling, nixpkgs unstable, ubuntu stonking

💅 NTP-CTL — the ntpd-rs management bestie (section 8 of the manual, iykyk)

ok so ntp-ctl is the management client for the ntpd-rs ntp-daemon process. she's the girl who talks to the daemon for you. no cap. 🎀

✨ SYNOPSIS ✨

ntp-ctl validate [-c path]
ntp-ctl status [-f format] [-c path]
ntp-ctl force-sync [-c path]
ntp-ctl -h
ntp-ctl -v

🦋 DESCRIPTION 🦋

okay so bestie, the ntp-ctl management client lets you manage some aspects of the ntpd-rs daemon. and when I say some I mean some — right now the management client only does two (2) things: showing you the current status of the daemon, and validating a configuration file so you know it'll actually work with the daemon. that's the whole job. it's giving focused. it's giving minimal. periodt. 💖

👑 OPTIONS 👑

  • -c path, --config=path — the path to the configuration file where the observation socket address gets retrieved from. if you don't specify it, it defaults to /etc/ntpd-rs/ntp.toml. that's the default, she's home. 🏠
  • -f format, --format=format — the output format for the status command. if you don't specify it, it defaults to plain. alternatively, the format prometheus is available to display the output in an OpenMetrics/Prometheus compatible format. ooh fancy. 📊✨
  • -h, --help — displays usage instructions. she's helpful!! 🫶
  • -v, --version — displays version information. what version are we on, bestie? 💅

🌸 COMMANDS 🌸

  • validate — checks if the configuration you specified (or /etc/ntpd-rs/ntp.toml by default) is valid. vibe check on your config file. if it passes, slay. ✅
  • status — returns status information about the current state of the ntp-daemon that the client connects to. she's asking the daemon "how are you doing girl". 📡
  • force-sync — interactively runs a single synchronization of your clock. this command can be used to do a one-off synchronization to the time sources configured in your configuration file. 🔥
⚠️ okay serious moment bestie: this command should never be used without any validation by a human operator. never ever. not even once. not even for the plot. an actual human has to check this one. 😭👑

💜 SEE ALSO 💜

and that's the whole page, bestie!! this was ntpd-rs version 1.9.0, section NTP-CTL(8) of the manual, and she ate, no crumbs. go validate your config. go check your status. mwah. 🎀💖✨

📦 where this page comes from