2 -- NTP MIB, Revision 0.2, 7/25/97
5 NTP-MIB DEFINITIONS ::= BEGIN
8 Integer32, IpAddress, MODULE-IDENTITY, OBJECT-TYPE, Unsigned32,
12 TEXTUAL-CONVENTION, TruthValue
15 ntpMIB MODULE-IDENTITY
16 LAST-UPDATED "199707251530Z"
18 "University of Delaware"
21 Department of Computer & Information Sciences
22 University of Delaware
25 E-mail: sethi@cis.udel.edu
28 Department of Electrical Engineering
29 University of Delaware
32 E-mail: mills@ee.udel.edu"
34 "This MIB module defines a MIB which provides mechanisms to
35 monitor and control an NTP server."
39 -- Position within the OID hierarchy of this MIB:
41 udel OBJECT IDENTIFIER
42 ::= { enterprises 1277 }
45 -- The various groups defined within this MIB definition:
47 ntpSystem OBJECT IDENTIFIER
50 ntpPeers OBJECT IDENTIFIER
53 ntpFilter OBJECT IDENTIFIER
57 -- Textual conventions:
60 NTPTimeStamp ::= TEXTUAL-CONVENTION
65 SYNTAX OCTET STRING (SIZE(8))
67 NTPLeapIndicator ::= TEXTUAL-CONVENTION
81 ntpSysLeap OBJECT-TYPE
82 SYNTAX NTPLeapIndicator
86 " two-bit code warning of an impending leap
87 second to be inserted in the NTP timescale."
90 ntpSysStratum OBJECT-TYPE
91 SYNTAX Integer32 (0..255)
95 " indicating the stratum of the local clock.
97 1, primary reference (e.g.,, calibrated atomic clock,
99 2-255, secondary reference (via NTP)"
102 ntpSysPrecision OBJECT-TYPE
107 "signed integer indicating the precision
108 of the various clocks, in seconds to the nearest power
112 ntpSysRootDelay OBJECT-TYPE
117 "the total roundtrip delay to the primary
118 reference source at the root of the synchronization
122 ntpSysRootDispersion OBJECT-TYPE
127 "the maximum error relative to the primary
128 reference source at the root of the synchronization
129 subnet, in seconds. Only positive values greater
130 than zero are possible"
133 ntpSysRefId OBJECT-TYPE
138 " the particular reference clock. In the case of
139 stratum 0 (unspecified) or stratum 1 (primary reference
140 source), this is a four-octet, left-justified,zero-padded
141 ASCII string.In the case of stratum 2 and greater (secondary
142 reference) this is the four-octet Internet address of the
143 peer selected for synchronization."
146 ntpSysRefTime OBJECT-TYPE
151 " the local time when the local clock was last
152 updated. If the local clock has neverbeen synchronized,
156 ntpSysPoll OBJECT-TYPE
161 " the minimum interval between transmitted
162 messages, in seconds as a power of two. For instance,
163 a value of six indicates a minimum interval of 64 seconds."
166 ntpSysPeer OBJECT-TYPE
171 " the current synchronization source. Usually
172 this will be a pointer to a structure containing the peer
173 variables. The special value NULL indicates there is no
174 currently valid synchronization source."
177 ntpSysPhase OBJECT-TYPE
185 ntpSysFreq OBJECT-TYPE
193 ntpSysError OBJECT-TYPE
201 ntpSysClock OBJECT-TYPE
206 "the current local time. Local time is derived
207 from the hardware clock of the particular machine and
208 increments at intervals depending on the design used."
211 ntpSysSystem OBJECT-TYPE
216 " the type of the local Operating System"
219 ntpSysProcessor OBJECT-TYPE
224 " the type of the local Processor"
232 -- Peer Variables Table
235 ntpPeersVarTable OBJECT-TYPE
236 SYNTAX SEQUENCE OF NtpPeersVarEntry
237 MAX-ACCESS not-accessible
243 ntpPeersVarEntry OBJECT-TYPE
244 SYNTAX NtpPeersVarEntry
245 MAX-ACCESS not-accessible
249 INDEX { ntpPeersAssocId }
250 ::= { ntpPeersVarTable 1 }
252 NtpPeersVarEntry ::= SEQUENCE {
253 ntpPeersAssocId Unsigned32,
254 ntpPeersConfigured TruthValue,
255 ntpPeersPeerAddress IpAddress,
256 ntpPeersPeerPort Unsigned32,
257 ntpPeersHostAddress IpAddress,
258 ntpPeersHostPort Unsigned32,
259 ntpPeersLeap NTPLeapIndicator,
260 ntpPeersMode INTEGER,
261 ntpPeersStratum Integer32,
262 ntpPeersPeerPoll Integer32,
263 ntpPeersHostPoll Integer32,
264 ntpPeersPrecision Integer32,
265 ntpPeersRootDelay OCTET STRING,
266 ntpPeersRootDispersion OCTET STRING,
267 ntpPeersRefId OCTET STRING,
268 ntpPeersRefTime NTPTimeStamp,
269 ntpPeersOrgTime NTPTimeStamp,
270 ntpPeersReceiveTime NTPTimeStamp,
271 ntpPeersTransmitTime NTPTimeStamp,
272 ntpPeersUpdateTime NTPTimeStamp,
273 ntpPeersReach Unsigned32,
274 ntpPeersTimer Integer32,
275 ntpPeersOffset OCTET STRING,
276 ntpPeersDelay OCTET STRING,
277 ntpPeersDispersion OCTET STRING
280 ntpPeersAssocId OBJECT-TYPE
282 MAX-ACCESS not-accessible
286 ::= { ntpPeersVarEntry 1 }
288 ntpPeersConfigured OBJECT-TYPE
293 " This is a bit indicating that the association
294 was created from configuration information and should not
295 be demobilized if the peer becomes unreachable."
296 ::= { ntpPeersVarEntry 2 }
298 ntpPeersPeerAddress OBJECT-TYPE
303 " the Internet address of the peer"
304 ::= { ntpPeersVarEntry 3 }
306 ntpPeersPeerPort OBJECT-TYPE
311 " 16-bit port number of the peer."
312 ::= { ntpPeersVarEntry 4 }
314 ntpPeersHostAddress OBJECT-TYPE
319 " the Internet address of the host"
320 ::= { ntpPeersVarEntry 5 }
322 ntpPeersHostPort OBJECT-TYPE
327 " 16-bit port number of the host"
328 ::= { ntpPeersVarEntry 6 }
330 ntpPeersLeap OBJECT-TYPE
331 SYNTAX NTPLeapIndicator
335 " two-bit code warning of an impending leap
336 second to be inserted in the NTP timescale."
337 ::= { ntpPeersVarEntry 7 }
339 ntpPeersMode OBJECT-TYPE
353 " the association mode,with values coded as
361 6, reserved for NTP control messages
362 7, reserved for private use
364 ::= { ntpPeersVarEntry 8 }
366 ntpPeersStratum OBJECT-TYPE
367 SYNTAX Integer32 (0..255)
371 " indicating the stratum of the peer clock.
373 1, primary reference (e.g.,, calibrated atomic clock,
375 2-255, secondary reference (via NTP)"
376 ::= { ntpPeersVarEntry 9 }
378 ntpPeersPeerPoll OBJECT-TYPE
383 "poll interval of the peer"
384 ::= { ntpPeersVarEntry 10 }
386 ntpPeersHostPoll OBJECT-TYPE
391 "poll interval of the host"
392 ::= { ntpPeersVarEntry 11 }
394 ntpPeersPrecision OBJECT-TYPE
399 "the same as the systemPrecision except this is
401 ::= { ntpPeersVarEntry 12 }
403 ntpPeersRootDelay OBJECT-TYPE
408 "the same as the systemRootDealy except this is for
410 ::= { ntpPeersVarEntry 13 }
412 ntpPeersRootDispersion OBJECT-TYPE
417 "the same as the systemDispersion except this is for
419 ::= { ntpPeersVarEntry 14 }
421 ntpPeersRefId OBJECT-TYPE
426 "the same as the systemRefid except this is for
428 ::= { ntpPeersVarEntry 15 }
430 ntpPeersRefTime OBJECT-TYPE
435 "the same as the systemRefTime except this is for
437 ::= { ntpPeersVarEntry 16 }
439 ntpPeersOrgTime OBJECT-TYPE
444 " the local time at the peer when its latest
445 NTP message was sent. If the peer becomes unreachable the
446 value is set to zero."
447 ::= { ntpPeersVarEntry 17 }
449 ntpPeersReceiveTime OBJECT-TYPE
454 "the local time when the latest NTP message
455 from the peer arrived. If the peer becomes unreachable the
456 value is set to zero."
457 ::= { ntpPeersVarEntry 18 }
459 ntpPeersTransmitTime OBJECT-TYPE
464 "the local time at which the NTP message
465 departed the sender."
466 ::= { ntpPeersVarEntry 19 }
468 ntpPeersUpdateTime OBJECT-TYPE
474 ::= { ntpPeersVarEntry 20 }
476 ntpPeersReach OBJECT-TYPE
481 "a shift register of NTP.WINDOW bits used to determine
482 the reachability status of the peer, with bits entering
483 from the least significant (rightmost) end. A peer is
484 considered reachable if at least one bit in this register is
486 ::= { ntpPeersVarEntry 21 }
488 ntpPeersTimer OBJECT-TYPE
494 ::= { ntpPeersVarEntry 22 }
496 ntpPeersOffset OBJECT-TYPE
502 ::= { ntpPeersVarEntry 23 }
504 ntpPeersDelay OBJECT-TYPE
510 ::= { ntpPeersVarEntry 24 }
512 ntpPeersDispersion OBJECT-TYPE
518 ::= { ntpPeersVarEntry 25 }
523 -- Implementation of this group is optional. It must be implemented
524 -- when the filter and selection algorithms described in Section 4
525 -- of RFC 1305 are used.
529 -- Filter Group Peer Variables Table
531 ntpFilterPeersVarTable OBJECT-TYPE
532 SYNTAX SEQUENCE OF NtpFilterPeersVarEntry
533 MAX-ACCESS not-accessible
536 "This table is an extension of the Peer Variables Table
540 ntpFilterPeersVarEntry OBJECT-TYPE
541 SYNTAX NtpFilterPeersVarEntry
542 MAX-ACCESS not-accessible
546 AUGMENTS { ntpPeersVarEntry }
547 ::= { ntpFilterPeersVarTable 1 }
549 NtpFilterPeersVarEntry ::= SEQUENCE {
550 ntpFilterValidEntries Integer32
553 ntpFilterValidEntries OBJECT-TYPE
558 "The number of valid entries for a peer in the Filter Register Table."
559 ::= { ntpFilterPeersVarEntry 1 }
562 -- Filter Register Table
565 ntpFilterRegisterTable OBJECT-TYPE
566 SYNTAX SEQUENCE OF NtpFilterRegisterEntry
567 MAX-ACCESS not-accessible
573 ntpFilterRegisterEntry OBJECT-TYPE
574 SYNTAX NtpFilterRegisterEntry
575 MAX-ACCESS not-accessible
579 INDEX { ntpPeersAssocId, ntpFilterIndex }
580 ::= { ntpFilterRegisterTable 1 }
582 NtpFilterRegisterEntry ::= SEQUENCE {
583 ntpFilterIndex Unsigned32,
584 ntpFilterPeersOffset OCTET STRING,
585 ntpFilterPeersDelay OCTET STRING,
586 ntpFilterPeersDispersion OCTET STRING
589 ntpFilterIndex OBJECT-TYPE
591 MAX-ACCESS not-accessible
595 ::= { ntpFilterRegisterEntry 1 }
597 ntpFilterPeersOffset OBJECT-TYPE
602 "the offset of the peer clock relative to the
603 local clock in seconds"
604 ::= { ntpFilterRegisterEntry 2 }
606 ntpFilterPeersDelay OBJECT-TYPE
611 "roundtrip delay of the peer clock relative to the
612 local clock over the network path between them, in seconds.
613 this variable can take on both positive and negative values,
614 depending on clock precision and skew-error accumulation."
615 ::= { ntpFilterRegisterEntry 3 }
617 ntpFilterPeersDispersion OBJECT-TYPE
622 "the maximum error of the peer clock relative to the
623 local clock over the network path between them, in seconds.
624 Only positive values greater than zero are possible."
625 ::= { ntpFilterRegisterEntry 4 }