NTPv4-MIB
- Registered at
- 1.3.6.1.2.1.197
- Last updated
- 2010-05-17 00:00
- Organization
- The IETF NTP Working Group (ntpwg)
- Revisions
- 2010-05-17 00:00
- Namespace
- standard
- Source file
NTPv4-MIB- Digest
sha256:a1dee046e7a9d10e10dcd8116de034c3f71769ba0cad5f53ed5ea6020c4e7d38
Description
The Management Information Base for NTP time entities. Copyright (c) 2010 IETF Trust and the persons identified as authors of the code. All rights reserved. Redistribution and use in source and binary forms, with or without modification, is permitted pursuant to, and subject to the license terms contained in, the Simplified BSD License set forth in Section 4.c of the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info).
Contact
WG Email: ntpwg@lists.ntp.isc.org Subscribe: https://lists.ntp.isc.org/mailman/listinfo/ntpwg Heiko Gerstung Meinberg Funkuhren Gmbh & Co. KG Lange Wand 9 Bad Pyrmont 31812 Germany Phone: +49 5281 9309 25 Email: heiko.gerstung@meinberg.de Chris Elliott 1516 Kent St. Durham, NC 27707 USA Phone: +1-919-308-1216 Email: chelliot@pobox.com Brian Haberman 11100 Johns Hopkins Road Laurel, MD 20723 USA Phone: +1-443-778-1319 Email: brian@innovationslab.net
Imports
| From | Symbols |
|---|---|
| INET-ADDRESS-MIB | InetAddress, InetAddressType |
| SNMPv2-CONF | MODULE-COMPLIANCE, NOTIFICATION-GROUP, OBJECT-GROUP |
| SNMPv2-SMI | Counter32, Integer32, MODULE-IDENTITY, NOTIFICATION-TYPE, OBJECT-IDENTITY, OBJECT-TYPE, TimeTicks, Unsigned32, iso, mib-2 |
| SNMPv2-TC | DisplayString, TEXTUAL-CONVENTION |
| SYSAPPL-MIB | Utf8String |
Imported by
Nothing in this corpus imports this module.
Load order
Every file a consumer needs in order to load this module, dependencies first.
INET-ADDRESS-MIB NTPv4-MIB SNMPv2-CONF SNMPv2-SMI SNMPv2-TC SYSAPPL-MIB
Textual conventions
| Name | OID | Syntax | Access | Status |
|---|---|---|---|---|
| NtpDateTime TEXTUAL-CONVENTION NTP date/time on the device, in 128-bit NTP date format. If time is not syncronized, this field shall be a zero-length string. This trusted certificate (TC) is not to be used for objects that are used to set the time of the node querying this object. NTP should be used for this -- or at least SNTP. | current | |||
| NtpStratum TEXTUAL-CONVENTION The NTP stratum, with 16 representing no stratum. | current |
Objects
| Name | OID | Syntax | Access | Status |
|---|---|---|---|---|
| ntpEntNotifications OBJECT-IDENTITY | 1.3.6.1.2.1.197.0 | |||
| ntpSnmpMIBObjects OBJECT-IDENTITY | 1.3.6.1.2.1.197.1 | |||
| ntpEntInfo OBJECT-IDENTITY | 1.3.6.1.2.1.197.1.1 | |||
| ntpEntSoftwareName OBJECT-TYPE The product name of the running NTP version, e.g., 'ntpd'. | 1.3.6.1.2.1.197.1.1.1 | Utf8String | read-only | current |
| ntpEntSoftwareVersion OBJECT-TYPE The software version of the installed NTP implementation as a full version string, e.g., 'ntpd-4.2.0b@1.1433 ...' | 1.3.6.1.2.1.197.1.1.2 | Utf8String | read-only | current |
| ntpEntSoftwareVendor OBJECT-TYPE The vendor/author of the installed NTP version. | 1.3.6.1.2.1.197.1.1.3 | Utf8String | read-only | current |
| ntpEntSystemType OBJECT-TYPE General hardware/os platform information, e.g., 'Linux 2.6.12 / x86'. | 1.3.6.1.2.1.197.1.1.4 | Utf8String | read-only | current |
| ntpEntTimeResolution OBJECT-TYPE The time resolution in integer format, where the resolution is represented as divisions of a second, e.g., a value of 1000 translates to 1.0 ms. | 1.3.6.1.2.1.197.1.1.5 | Unsigned32 | read-only | current |
| ntpEntTimePrecision OBJECT-TYPE The entity's precision in integer format, shows the precision. A value of -5 would mean 2^-5 = 31.25 ms. | 1.3.6.1.2.1.197.1.1.6 | Integer32 | read-only | current |
| ntpEntTimeDistance OBJECT-TYPE The distance from this NTP entity to the root time reference (stratum 0) source including the unit, e.g., '13.243 ms'. | 1.3.6.1.2.1.197.1.1.7 | DisplayString | read-only | current |
| ntpEntStatus OBJECT-IDENTITY | 1.3.6.1.2.1.197.1.2 | |||
| ntpEntStatusCurrentMode OBJECT-TYPE The current mode of the NTP. The definition of each possible value is: notRunning(1) - NTP is not running. notSynchronized(2) - NTP is not synchronized to any time source (stratum = 16). noneConfigured(3) - NTP is not synchronized and does not have a reference configured (stratum = 16). syncToLocal(4) - NTP is distributing time based on its local clock (degraded accuracy and/or reliability). syncToRefclock(5) - NTP is synchronized to a local hardware refclock (e.g., GPS). syncToRemoteServer(6) - NTP is synchronized to a remote NTP server ('upstream' server). unknown(99) - The state of NTP is unknown. | 1.3.6.1.2.1.197.1.2.1 | INTEGER {notRunning(1), notSynchronized(2), noneConfigured(3), syncToLocal(4), syncToRefclock(5), syncToRemoteServer(6), unknown(99)} | read-only | current |
| ntpEntStatusStratum OBJECT-TYPE The NTP entity's own stratum value. Should be a stratum of syspeer + 1 (or 16 if no syspeer). | 1.3.6.1.2.1.197.1.2.2 | NtpStratum | read-only | current |
| ntpEntStatusActiveRefSourceId OBJECT-TYPE The association ID of the current syspeer. | 1.3.6.1.2.1.197.1.2.3 | Unsigned32 (0..99999) | read-only | current |
| ntpEntStatusActiveRefSourceName OBJECT-TYPE The hostname/descriptive name of the current reference source selected as syspeer, e.g., 'ntp1.ptb.de' or 'GPS' or 'DCFi', ... | 1.3.6.1.2.1.197.1.2.4 | Utf8String | read-only | current |
| ntpEntStatusActiveOffset OBJECT-TYPE The time offset to the current selected reference time source as a string including unit, e.g., '0.032 ms' or '1.232 s'. | 1.3.6.1.2.1.197.1.2.5 | DisplayString | read-only | current |
| ntpEntStatusNumberOfRefSources OBJECT-TYPE The number of reference sources configured for NTP. | 1.3.6.1.2.1.197.1.2.6 | Unsigned32 (0..99) | read-only | current |
| ntpEntStatusDispersion OBJECT-TYPE The root dispersion of the running NTP entity, e.g., '6.927'. | 1.3.6.1.2.1.197.1.2.7 | DisplayString | read-only | current |
| ntpEntStatusEntityUptime OBJECT-TYPE The uptime of the NTP entity, (i.e., the time since ntpd was (re-)initialized not sysUptime!). The time is represented in hundreds of seconds since Jan 1, 1970 (00:00:00.000) UTC. | 1.3.6.1.2.1.197.1.2.8 | TimeTicks | read-only | current |
| ntpEntStatusDateTime OBJECT-TYPE The current NTP date/time on the device, in 128-bit NTP date format. If time is not syncronized, this field shall be a zero-length string. This object can be used to timestamp events on this node and allow a management station to correlate different time objects. For example, a management station could query this object and sysUpTime in the same operation to be able to relate sysUpTime to NTP time. This object is not to be used to set the time of the node querying this object. NTP should be used for this -- or at least SNTP. | 1.3.6.1.2.1.197.1.2.9 | NtpDateTime | read-only | current |
| ntpEntStatusLeapSecond OBJECT-TYPE Date the next known leap second will occur. If there is no leap second announced, then this object should be 0. | 1.3.6.1.2.1.197.1.2.10 | NtpDateTime | read-only | current |
| ntpEntStatusLeapSecDirection OBJECT-TYPE Direction of next known leap second. If there is no leap second announced, then this object should be 0. | 1.3.6.1.2.1.197.1.2.11 | Integer32 (-1..1) | read-only | current |
| ntpEntStatusInPkts OBJECT-TYPE The total number of NTP messages delivered to the NTP entity from the transport service. Discountinuities in the value of this counter can occur upon cold start or reinitialization of the NTP entity, the management system and at other times as indicated by discontinuities in the value of sysUpTime. | 1.3.6.1.2.1.197.1.2.12 | Counter32 | read-only | current |
| ntpEntStatusOutPkts OBJECT-TYPE The total number of NTP messages delivered to the transport service by this NTP entity. Discountinuities in the value of this counter can occur upon cold start or reinitialization of the NTP entity, the management system and at other times as indicated by discontinuities in the value of sysUpTime. | 1.3.6.1.2.1.197.1.2.13 | Counter32 | read-only | current |
| ntpEntStatusBadVersion OBJECT-TYPE The total number of NTP messages that were delivered to this NTP entity and were for an unsupported NTP version. Discountinuities in the value of this counter can occur upon cold start or reinitialization of the NTP entity, the management system and at other times as indicated by discontinuities in the value of sysUpTime. | 1.3.6.1.2.1.197.1.2.14 | Counter32 | read-only | current |
| ntpEntStatusProtocolError OBJECT-TYPE The total number of NTP messages that were delivered to this NTP entity and this entity was not able to process due to an NTP protocol error. Discountinuities in the value of this counter can occur upon cold start or reinitialization of the NTP entity, the management system and at other times as indicated by discontinuities in the value of sysUpTime. | 1.3.6.1.2.1.197.1.2.15 | Counter32 | read-only | current |
| ntpEntStatusNotifications OBJECT-TYPE The total number of SNMP notifications that this NTP entity has generated. Discountinuities in the value of this counter can occur upon cold start or reinitialization of the NTP entity, the management system and at other times as indicated by discontinuities in the value of sysUpTime. | 1.3.6.1.2.1.197.1.2.16 | Counter32 | read-only | current |
| ntpEntStatPktModeTable OBJECT-TYPE The number of packets sent and received by packet mode. One entry per packet mode. | 1.3.6.1.2.1.197.1.2.17 | not-accessible | current | |
| ntpEntStatPktModeEntry OBJECT-TYPE A statistical record of the number of packets sent and received for each packet mode. | 1.3.6.1.2.1.197.1.2.17.1 | not-accessible | current | |
| ntpEntStatPktMode OBJECT-TYPE The NTP packet mode. | 1.3.6.1.2.1.197.1.2.17.1.1 | INTEGER {symetricactive(1), symetricpassive(2), client(3), server(4), broadcastserver(5), broadcastclient(6)} | not-accessible | current |
| ntpEntStatPktSent OBJECT-TYPE The number of NTP packets sent with this packet mode. Discountinuities in the value of this counter can occur upon cold start or reinitialization of the NTP entity, the management system and at other times as indicated by discontinuities in the value of sysUpTime. | 1.3.6.1.2.1.197.1.2.17.1.2 | Counter32 | read-only | current |
| ntpEntStatPktReceived OBJECT-TYPE The number of NTP packets received with this packet mode. Discountinuities in the value of this counter can occur upon cold start or reinitialization of the NTP entity, the management system and at other times as indicated by discontinuities in the value of sysUpTime. | 1.3.6.1.2.1.197.1.2.17.1.3 | Counter32 | read-only | current |
| ntpAssociation OBJECT-IDENTITY | 1.3.6.1.2.1.197.1.3 | |||
| ntpAssociationTable OBJECT-TYPE The table of currently mobilized associations. | 1.3.6.1.2.1.197.1.3.1 | not-accessible | current | |
| ntpAssociationEntry OBJECT-TYPE The table entry of currently mobilized associations. | 1.3.6.1.2.1.197.1.3.1.1 | not-accessible | current | |
| ntpAssocId OBJECT-TYPE The association ID. This is an internal, unique ID. | 1.3.6.1.2.1.197.1.3.1.1.1 | Unsigned32 (1..99999) | not-accessible | current |
| ntpAssocName OBJECT-TYPE The hostname or other descriptive name for the association. | 1.3.6.1.2.1.197.1.3.1.1.2 | Utf8String | read-only | current |
| ntpAssocRefId OBJECT-TYPE The refclock driver ID, if available. | 1.3.6.1.2.1.197.1.3.1.1.3 | DisplayString | read-only | current |
| ntpAssocAddressType OBJECT-TYPE The type of address of the association. Can be either IPv4 or IPv6 (both with or without zone index) and contains the type of address for unicast, multicast, and broadcast associations. | 1.3.6.1.2.1.197.1.3.1.1.4 | InetAddressType {ipv4(1), ipv6(2), ipv4z(3), ipv6z(4)} | read-only | current |
| ntpAssocAddress OBJECT-TYPE The IP address (IPv4 or IPv6, with or without zone index) of the association. The type and size depends on the ntpAssocAddressType object. Represents the IP address of a uni/multi/broadcast association. | 1.3.6.1.2.1.197.1.3.1.1.5 | InetAddress (SIZE(4 | 8 | 16 | 20)) | read-only | current |
| ntpAssocOffset OBJECT-TYPE The time offset to the association as a string. | 1.3.6.1.2.1.197.1.3.1.1.6 | DisplayString | read-only | current |
| ntpAssocStratum OBJECT-TYPE The association stratum value. | 1.3.6.1.2.1.197.1.3.1.1.7 | NtpStratum | read-only | current |
| ntpAssocStatusJitter OBJECT-TYPE The jitter in milliseconds as a string. | 1.3.6.1.2.1.197.1.3.1.1.8 | DisplayString | read-only | current |
| ntpAssocStatusDelay OBJECT-TYPE The network delay in milliseconds as a string. | 1.3.6.1.2.1.197.1.3.1.1.9 | DisplayString | read-only | current |
| ntpAssocStatusDispersion OBJECT-TYPE The root dispersion of the association. | 1.3.6.1.2.1.197.1.3.1.1.10 | DisplayString | read-only | current |
| ntpAssociationStatisticsTable OBJECT-TYPE The table of statistics for current associations. | 1.3.6.1.2.1.197.1.3.2 | not-accessible | current | |
| ntpAssociationStatisticsEntry OBJECT-TYPE The table entry of statistics for current associations. | 1.3.6.1.2.1.197.1.3.2.1 | not-accessible | current | |
| ntpAssocStatInPkts OBJECT-TYPE The total number of NTP messages delivered to the NTP entity from this association. Discountinuities in the value of this counter can occur upon cold start or reinitialization of the NTP entity, the management system and at other times as indicated by discontinuities in the value of sysUpTime. | 1.3.6.1.2.1.197.1.3.2.1.1 | Counter32 | read-only | current |
| ntpAssocStatOutPkts OBJECT-TYPE The total number of NTP messages delivered to the transport service by this NTP entity for this association. Discountinuities in the value of this counter can occur upon cold start or reinitialization of the NTP entity, the management system and at other times as indicated by discontinuities in the value of sysUpTime. | 1.3.6.1.2.1.197.1.3.2.1.2 | Counter32 | read-only | current |
| ntpAssocStatProtocolError OBJECT-TYPE The total number of NTP messages that were delivered to this NTP entity from this association and this entity was not able to process due to an NTP protocol error. Discountinuities in the value of this counter can occur upon cold start or reinitialization of the NTP entity, the management system and at other times as indicated by discontinuities in the value of sysUpTime. | 1.3.6.1.2.1.197.1.3.2.1.3 | Counter32 | read-only | current |
| ntpEntControl OBJECT-IDENTITY | 1.3.6.1.2.1.197.1.4 | |||
| ntpEntHeartbeatInterval OBJECT-TYPE The interval at which the ntpEntNotifHeartbeat notification should be sent, in seconds. If set to 0 and the entNotifHeartbeat bit in ntpEntNotifBits is 1, then ntpEntNotifHeartbeat is sent once. This value is stored persistently and will be restored to its last set value upon cold start or restart. | 1.3.6.1.2.1.197.1.4.1 | Unsigned32 | read-write | current |
| ntpEntNotifBits OBJECT-TYPE A bit for each notification. A 1 for a particular bit enables that particular notification, a 0 disables it. This value is stored persistently and will be restored to its last set value upon cold start or restart. | 1.3.6.1.2.1.197.1.4.2 | Bits {notUsed(0), entNotifModeChange(1), entNotifStratumChange(2), entNotifSyspeerChanged(3), entNotifAddAssociation(4), entNotifRemoveAssociation(5), entNotifConfigChanged(6), entNotifLeapSecondAnnounced(7), entNotifHeartbeat(8)} | read-write | current |
| ntpEntNotifObjects OBJECT-IDENTITY | 1.3.6.1.2.1.197.1.5 | |||
| ntpEntNotifMessage OBJECT-TYPE Used as a payload object for all notifications. Holds a cleartext event message. | 1.3.6.1.2.1.197.1.5.1 | Utf8String | accessible-for-notify | current |
| ntpEntConformance OBJECT-IDENTITY | 1.3.6.1.2.1.197.2 | |||
| ntpEntCompliances OBJECT-IDENTITY | 1.3.6.1.2.1.197.2.1 | |||
| ntpEntGroups OBJECT-IDENTITY | 1.3.6.1.2.1.197.2.2 |
Notifications
| Name | OID | Status |
|---|---|---|
| ntpEntNotifModeChange NOTIFICATION-TYPE The notification to be sent when the NTP entity changes mode, including starting and stopping (if possible). | 1.3.6.1.2.1.197.0.1 | current |
| ntpEntNotifStratumChange NOTIFICATION-TYPE The notification to be sent when stratum level of NTP changes. | 1.3.6.1.2.1.197.0.2 | current |
| ntpEntNotifSyspeerChanged NOTIFICATION-TYPE The notification to be sent when a (new) syspeer has been selected. | 1.3.6.1.2.1.197.0.3 | current |
| ntpEntNotifAddAssociation NOTIFICATION-TYPE The notification to be sent when a new association is mobilized. | 1.3.6.1.2.1.197.0.4 | current |
| ntpEntNotifRemoveAssociation NOTIFICATION-TYPE The notification to be sent when an association is demobilized. | 1.3.6.1.2.1.197.0.5 | current |
| ntpEntNotifConfigChanged NOTIFICATION-TYPE The notification to be sent when the NTP configuration has changed, e.g., when the system connected to the Internet and was assigned a new IP address by the ISPs DHCP server. | 1.3.6.1.2.1.197.0.6 | current |
| ntpEntNotifLeapSecondAnnounced NOTIFICATION-TYPE The notification to be sent when a leap second has been announced. | 1.3.6.1.2.1.197.0.7 | current |
| ntpEntNotifHeartbeat NOTIFICATION-TYPE The notification to be sent periodically (as defined by ntpEntHeartbeatInterval) to indicate that the NTP entity is still alive. | 1.3.6.1.2.1.197.0.8 | current |
Conformance
| Name | OID | Status |
|---|---|---|
| ntpEntNTPCompliance MODULE-COMPLIANCE The compliance statement for SNMP entities that use NTP and implement the NTP MIB. | 1.3.6.1.2.1.197.2.1.1 | current |
| ntpEntSNTPCompliance MODULE-COMPLIANCE The compliance statement for SNMP entities that use SNTP and implement the NTP MIB. | 1.3.6.1.2.1.197.2.1.2 | current |
| ntpEntObjectsGroup1 OBJECT-GROUP A collection of objects for the NTP MIB. | 1.3.6.1.2.1.197.2.2.1 | current |
| ntpEntObjectsGroup2 OBJECT-GROUP A collection of objects for the NTP MIB. | 1.3.6.1.2.1.197.2.2.2 | current |
| ntpEntNotifGroup NOTIFICATION-GROUP A collection of notifications for the NTP MIB | 1.3.6.1.2.1.197.2.2.3 | current |