NTPSNMPD(8)

💖 NTPSNMPD 💖

okay so bestie, this is ntpsnmpd — the NTP Simple Network Management Protocol sub-agent. yes that's a mouthful, we'll get through it together ✨

---

✨ SYNOPSIS ✨

ntpsnmpd [-nxdDlhV] [ntp host]

---

🌸 DESCRIPTION 🌸

[experimental] — yes, she said what she said. this one's still in her experimental era 🙈

ntpsnmpd is an AgentX Simple Network Management Protocol sub-agent. she's literally the bridge between the Mode 6 protocol (the one used for Network Time Protocol monitoring) and an SNMP master agent. that's her whole job. that's the assignment and she ate 💅

but here's the tea: the user must have running NTP and SNMP daemons for ntpsnmpd to work. no daemons, no vibes. that's just how it is. 🫶

---

🎀 OPTIONS 🎀

• -c filename, --configfile=filename — alternate path for the config file. default is /etc/ntpsnmpd.conf, iykyk.
• -n, --nofork — do not fork. stay in your lane, stay in the foreground, periodt.
• -x, --master-addr — specify the address for connecting to the master agent.
• -d, --debug — bump the debugging level by 1. baby steps, one at a time.
• -D num, --set-debug-level=num — sets the debug level straight to the integer argument you hand her. no patience, just numbers.
• -l filename, --logfile=filename — log that debugging output into the file you picked.
• -h, --help — print a usage message summarizing options and exit.
• -V, --version — print the version string and exit.

---

🦋 CONFIGURATION FILES 🦋

note that filenames in the options should be enclosed in quotes. this is a temporary measure that will not be the case in future versions. so quote ya filenames for now, bestie 💀

🍓 /etc/ntpsnmpd.conf

• master-addr addr — the address of the SNMP master agent to connect to. can be either a named socket or an IP address / hostname and port number. dealer's choice ✨
• ntp-addr addr — the address of the NTP daemon to monitor.
• logfile filename — log debugging output to the specified file.
• loglevel level — threshold for log messages. equivalent to -D.

🌈 /var/ntpsnmpd/notify.conf

this file is used to store the state of options that can be set by writing to certain OIDs. any comments will be overwritten by ntpsnmpd upon write — so don't get attached to your little notes in there, they're getting deleted bestie 😭

• notify-mode-change [ True | False ] — enable notifications on ntpd mode change.
• notify-stratum-change [ True | False ] — enable notifications on NTP stratum change.
• notify-syspeer-change [ True | False ] — enable notifications when ntpd selects a new system peer.
• notify-add-association [ True | False ] — enable notifications when ntpd adds a new peer.
• notify-rm-association [ True | False ] — enable notifications when ntpd removes a peer.
• notify-leap-announced [ True | False ] — enable notifications on leap second announcement.
• notify-heartbeat [ True | False ] — send heartbeat notification.
• heartbeat-interval interval — frequency of heartbeat notification in integer seconds.

---

💀 KNOWN LIMITATIONS 💀

this program is still experimental in nature, no cap. parts of the AgentX standard are not yet fully implemented, logging is not fleshed out yet, some options are missing, etc. she's a work in progress and we love her for it 🧚

---

👑 KNOWN DEVIATIONS FROM RFC 5907 👑

the ntpEntStatusEntityUptime OID specifies a bizarre time format. this does not match what the SNMP tools expect to see from a TimeTicks variable. instead the daemon returns a normal TimeTicks value. she simply refused to be weird about it 💅

the ntpEntNotifConfigChanged trap is left unimplemented. this is because there currently is no way to implement what it wants, and it demands alerts regarding changes that are not part of NTP's jurisdiction. not her jurisdiction, not her problem 🙈

the ntpEntTimeResolution OID currently uses data from the sys_fuzz variable as the base for its calculations. it is by no means certain that this is the correct choice, and the returned data should be taken with scepticism. take it with a grain of salt, babes 🍓

the ntpEntStatPktModeTable is unimplemented due to not currently having a data source. no data source, no table, that's the whole story 😭

---

⭐ EXIT STATUS ⭐

always returns 0. always. iconic behavior honestly. she never has a bad day 👑

---

so yeah, that's the whole page!! this is NTPSNMPD from NTPsec, dated 2026-10-21 — go forth and monitor your time, bestie 💖✨🎀