/contrib/bsnmp/snmp_ntp/NTP-MIB.txt

https://bitbucket.org/freebsd/freebsd-head/ · Plain Text · 627 lines · 555 code · 72 blank · 0 comment · 0 complexity · 115dd774c40ccebbcaf373f3530ed544 MD5 · raw file

  1. --
  2. -- NTP MIB, Revision 0.2, 7/25/97
  3. --
  4. NTP-MIB DEFINITIONS ::= BEGIN
  5. IMPORTS
  6. Integer32, IpAddress, MODULE-IDENTITY, OBJECT-TYPE, Unsigned32,
  7. enterprises
  8. FROM SNMPv2-SMI
  9. TEXTUAL-CONVENTION, TruthValue
  10. FROM SNMPv2-TC;
  11. ntpMIB MODULE-IDENTITY
  12. LAST-UPDATED "199707251530Z"
  13. ORGANIZATION
  14. "University of Delaware"
  15. CONTACT-INFO
  16. "Adarsh Sethi
  17. Department of Computer & Information Sciences
  18. University of Delaware
  19. Newark, DE 19716
  20. Tel: +1 302 831 1945
  21. E-mail: sethi@cis.udel.edu
  22. David Mills
  23. Department of Electrical Engineering
  24. University of Delaware
  25. Newark, DE 19716
  26. Tel: +1 302 831 ????
  27. E-mail: mills@ee.udel.edu"
  28. DESCRIPTION
  29. "This MIB module defines a MIB which provides mechanisms to
  30. monitor and control an NTP server."
  31. ::= { udel 3 }
  32. --
  33. -- Position within the OID hierarchy of this MIB:
  34. --
  35. udel OBJECT IDENTIFIER
  36. ::= { enterprises 1277 }
  37. --
  38. -- The various groups defined within this MIB definition:
  39. --
  40. ntpSystem OBJECT IDENTIFIER
  41. ::= { ntpMIB 1 }
  42. ntpPeers OBJECT IDENTIFIER
  43. ::= { ntpMIB 2 }
  44. ntpFilter OBJECT IDENTIFIER
  45. ::= { ntpMIB 3 }
  46. --
  47. -- Textual conventions:
  48. --
  49. NTPTimeStamp ::= TEXTUAL-CONVENTION
  50. DISPLAY-HINT "4x.4x"
  51. STATUS current
  52. DESCRIPTION
  53. ""
  54. SYNTAX OCTET STRING (SIZE(8))
  55. NTPLeapIndicator ::= TEXTUAL-CONVENTION
  56. STATUS current
  57. DESCRIPTION
  58. ""
  59. SYNTAX INTEGER {
  60. noWarning(0),
  61. addSecond(1),
  62. subtractSecond(2),
  63. alarm(3) }
  64. --
  65. -- System Group
  66. --
  67. ntpSysLeap OBJECT-TYPE
  68. SYNTAX NTPLeapIndicator
  69. MAX-ACCESS read-only
  70. STATUS current
  71. DESCRIPTION
  72. " two-bit code warning of an impending leap
  73. second to be inserted in the NTP timescale."
  74. ::= { ntpSystem 1 }
  75. ntpSysStratum OBJECT-TYPE
  76. SYNTAX Integer32 (0..255)
  77. MAX-ACCESS read-only
  78. STATUS current
  79. DESCRIPTION
  80. " indicating the stratum of the local clock.
  81. 0, unspecified
  82. 1, primary reference (e.g.,, calibrated atomic clock,
  83. radio clock)
  84. 2-255, secondary reference (via NTP)"
  85. ::= { ntpSystem 2 }
  86. ntpSysPrecision OBJECT-TYPE
  87. SYNTAX Integer32
  88. MAX-ACCESS read-only
  89. STATUS current
  90. DESCRIPTION
  91. "signed integer indicating the precision
  92. of the various clocks, in seconds to the nearest power
  93. of two."
  94. ::= { ntpSystem 3 }
  95. ntpSysRootDelay OBJECT-TYPE
  96. SYNTAX OCTET STRING
  97. MAX-ACCESS read-only
  98. STATUS current
  99. DESCRIPTION
  100. "the total roundtrip delay to the primary
  101. reference source at the root of the synchronization
  102. subnet, in seconds"
  103. ::= { ntpSystem 4 }
  104. ntpSysRootDispersion OBJECT-TYPE
  105. SYNTAX OCTET STRING
  106. MAX-ACCESS read-only
  107. STATUS current
  108. DESCRIPTION
  109. "the maximum error relative to the primary
  110. reference source at the root of the synchronization
  111. subnet, in seconds. Only positive values greater
  112. than zero are possible"
  113. ::= { ntpSystem 5 }
  114. ntpSysRefId OBJECT-TYPE
  115. SYNTAX OCTET STRING
  116. MAX-ACCESS read-only
  117. STATUS current
  118. DESCRIPTION
  119. " the particular reference clock. In the case of
  120. stratum 0 (unspecified) or stratum 1 (primary reference
  121. source), this is a four-octet, left-justified,zero-padded
  122. ASCII string.In the case of stratum 2 and greater (secondary
  123. reference) this is the four-octet Internet address of the
  124. peer selected for synchronization."
  125. ::= { ntpSystem 6 }
  126. ntpSysRefTime OBJECT-TYPE
  127. SYNTAX NTPTimeStamp
  128. MAX-ACCESS read-only
  129. STATUS current
  130. DESCRIPTION
  131. " the local time when the local clock was last
  132. updated. If the local clock has neverbeen synchronized,
  133. the value is zero."
  134. ::= { ntpSystem 7 }
  135. ntpSysPoll OBJECT-TYPE
  136. SYNTAX Integer32
  137. MAX-ACCESS read-only
  138. STATUS current
  139. DESCRIPTION
  140. " the minimum interval between transmitted
  141. messages, in seconds as a power of two. For instance,
  142. a value of six indicates a minimum interval of 64 seconds."
  143. ::= { ntpSystem 8 }
  144. ntpSysPeer OBJECT-TYPE
  145. SYNTAX Unsigned32
  146. MAX-ACCESS read-only
  147. STATUS current
  148. DESCRIPTION
  149. " the current synchronization source. Usually
  150. this will be a pointer to a structure containing the peer
  151. variables. The special value NULL indicates there is no
  152. currently valid synchronization source."
  153. ::= { ntpSystem 9 }
  154. ntpSysPhase OBJECT-TYPE
  155. SYNTAX OCTET STRING
  156. MAX-ACCESS read-only
  157. STATUS current
  158. DESCRIPTION
  159. ""
  160. ::= { ntpSystem 10 }
  161. ntpSysFreq OBJECT-TYPE
  162. SYNTAX OCTET STRING
  163. MAX-ACCESS read-only
  164. STATUS current
  165. DESCRIPTION
  166. ""
  167. ::= { ntpSystem 11 }
  168. ntpSysError OBJECT-TYPE
  169. SYNTAX OCTET STRING
  170. MAX-ACCESS read-only
  171. STATUS current
  172. DESCRIPTION
  173. ""
  174. ::= { ntpSystem 12 }
  175. ntpSysClock OBJECT-TYPE
  176. SYNTAX NTPTimeStamp
  177. MAX-ACCESS read-only
  178. STATUS current
  179. DESCRIPTION
  180. "the current local time. Local time is derived
  181. from the hardware clock of the particular machine and
  182. increments at intervals depending on the design used."
  183. ::= { ntpSystem 13 }
  184. ntpSysSystem OBJECT-TYPE
  185. SYNTAX OCTET STRING
  186. MAX-ACCESS read-only
  187. STATUS current
  188. DESCRIPTION
  189. " the type of the local Operating System"
  190. ::= { ntpSystem 14 }
  191. ntpSysProcessor OBJECT-TYPE
  192. SYNTAX OCTET STRING
  193. MAX-ACCESS read-only
  194. STATUS current
  195. DESCRIPTION
  196. " the type of the local Processor"
  197. ::= { ntpSystem 15 }
  198. --
  199. -- Peers Group
  200. --
  201. --
  202. -- Peer Variables Table
  203. --
  204. ntpPeersVarTable OBJECT-TYPE
  205. SYNTAX SEQUENCE OF NtpPeersVarEntry
  206. MAX-ACCESS not-accessible
  207. STATUS current
  208. DESCRIPTION
  209. ""
  210. ::= { ntpPeers 1 }
  211. ntpPeersVarEntry OBJECT-TYPE
  212. SYNTAX NtpPeersVarEntry
  213. MAX-ACCESS not-accessible
  214. STATUS current
  215. DESCRIPTION
  216. ""
  217. INDEX { ntpPeersAssocId }
  218. ::= { ntpPeersVarTable 1 }
  219. NtpPeersVarEntry ::= SEQUENCE {
  220. ntpPeersAssocId Unsigned32,
  221. ntpPeersConfigured TruthValue,
  222. ntpPeersPeerAddress IpAddress,
  223. ntpPeersPeerPort Unsigned32,
  224. ntpPeersHostAddress IpAddress,
  225. ntpPeersHostPort Unsigned32,
  226. ntpPeersLeap NTPLeapIndicator,
  227. ntpPeersMode INTEGER,
  228. ntpPeersStratum Integer32,
  229. ntpPeersPeerPoll Integer32,
  230. ntpPeersHostPoll Integer32,
  231. ntpPeersPrecision Integer32,
  232. ntpPeersRootDelay OCTET STRING,
  233. ntpPeersRootDispersion OCTET STRING,
  234. ntpPeersRefId OCTET STRING,
  235. ntpPeersRefTime NTPTimeStamp,
  236. ntpPeersOrgTime NTPTimeStamp,
  237. ntpPeersReceiveTime NTPTimeStamp,
  238. ntpPeersTransmitTime NTPTimeStamp,
  239. ntpPeersUpdateTime NTPTimeStamp,
  240. ntpPeersReach Unsigned32,
  241. ntpPeersTimer Integer32,
  242. ntpPeersOffset OCTET STRING,
  243. ntpPeersDelay OCTET STRING,
  244. ntpPeersDispersion OCTET STRING
  245. }
  246. ntpPeersAssocId OBJECT-TYPE
  247. SYNTAX Unsigned32
  248. MAX-ACCESS not-accessible
  249. STATUS current
  250. DESCRIPTION
  251. ""
  252. ::= { ntpPeersVarEntry 1 }
  253. ntpPeersConfigured OBJECT-TYPE
  254. SYNTAX TruthValue
  255. MAX-ACCESS read-only
  256. STATUS current
  257. DESCRIPTION
  258. " This is a bit indicating that the association
  259. was created from configuration information and should not
  260. be demobilized if the peer becomes unreachable."
  261. ::= { ntpPeersVarEntry 2 }
  262. ntpPeersPeerAddress OBJECT-TYPE
  263. SYNTAX IpAddress
  264. MAX-ACCESS read-only
  265. STATUS current
  266. DESCRIPTION
  267. " the Internet address of the peer"
  268. ::= { ntpPeersVarEntry 3 }
  269. ntpPeersPeerPort OBJECT-TYPE
  270. SYNTAX Unsigned32
  271. MAX-ACCESS read-only
  272. STATUS current
  273. DESCRIPTION
  274. " 16-bit port number of the peer."
  275. ::= { ntpPeersVarEntry 4 }
  276. ntpPeersHostAddress OBJECT-TYPE
  277. SYNTAX IpAddress
  278. MAX-ACCESS read-only
  279. STATUS current
  280. DESCRIPTION
  281. " the Internet address of the host"
  282. ::= { ntpPeersVarEntry 5 }
  283. ntpPeersHostPort OBJECT-TYPE
  284. SYNTAX Unsigned32
  285. MAX-ACCESS read-only
  286. STATUS current
  287. DESCRIPTION
  288. " 16-bit port number of the host"
  289. ::= { ntpPeersVarEntry 6 }
  290. ntpPeersLeap OBJECT-TYPE
  291. SYNTAX NTPLeapIndicator
  292. MAX-ACCESS read-only
  293. STATUS current
  294. DESCRIPTION
  295. " two-bit code warning of an impending leap
  296. second to be inserted in the NTP timescale."
  297. ::= { ntpPeersVarEntry 7 }
  298. ntpPeersMode OBJECT-TYPE
  299. SYNTAX INTEGER {
  300. unspecified(0),
  301. symmetricActive(1),
  302. symmetricPassive(2),
  303. client(3),
  304. server(4),
  305. broadcast(5),
  306. reservedControl(6),
  307. reservedPrivate(7)
  308. }
  309. MAX-ACCESS read-only
  310. STATUS current
  311. DESCRIPTION
  312. " the association mode,with values coded as
  313. follows:
  314. 0, unspecified
  315. 1, symmetric active
  316. 2, symmetric passive
  317. 3, client
  318. 4, server
  319. 5, broadcast
  320. 6, reserved for NTP control messages
  321. 7, reserved for private use
  322. "
  323. ::= { ntpPeersVarEntry 8 }
  324. ntpPeersStratum OBJECT-TYPE
  325. SYNTAX Integer32 (0..255)
  326. MAX-ACCESS read-only
  327. STATUS current
  328. DESCRIPTION
  329. " indicating the stratum of the peer clock.
  330. 0, unspecified
  331. 1, primary reference (e.g.,, calibrated atomic clock,
  332. radio clock)
  333. 2-255, secondary reference (via NTP)"
  334. ::= { ntpPeersVarEntry 9 }
  335. ntpPeersPeerPoll OBJECT-TYPE
  336. SYNTAX Integer32
  337. MAX-ACCESS read-only
  338. STATUS current
  339. DESCRIPTION
  340. "poll interval of the peer"
  341. ::= { ntpPeersVarEntry 10 }
  342. ntpPeersHostPoll OBJECT-TYPE
  343. SYNTAX Integer32
  344. MAX-ACCESS read-only
  345. STATUS current
  346. DESCRIPTION
  347. "poll interval of the host"
  348. ::= { ntpPeersVarEntry 11 }
  349. ntpPeersPrecision OBJECT-TYPE
  350. SYNTAX Integer32
  351. MAX-ACCESS read-only
  352. STATUS current
  353. DESCRIPTION
  354. "the same as the systemPrecision except this is
  355. for the peer"
  356. ::= { ntpPeersVarEntry 12 }
  357. ntpPeersRootDelay OBJECT-TYPE
  358. SYNTAX OCTET STRING
  359. MAX-ACCESS read-only
  360. STATUS current
  361. DESCRIPTION
  362. "the same as the systemRootDealy except this is for
  363. the peer"
  364. ::= { ntpPeersVarEntry 13 }
  365. ntpPeersRootDispersion OBJECT-TYPE
  366. SYNTAX OCTET STRING
  367. MAX-ACCESS read-only
  368. STATUS current
  369. DESCRIPTION
  370. "the same as the systemDispersion except this is for
  371. the peer"
  372. ::= { ntpPeersVarEntry 14 }
  373. ntpPeersRefId OBJECT-TYPE
  374. SYNTAX OCTET STRING
  375. MAX-ACCESS read-only
  376. STATUS current
  377. DESCRIPTION
  378. "the same as the systemRefid except this is for
  379. the peer"
  380. ::= { ntpPeersVarEntry 15 }
  381. ntpPeersRefTime OBJECT-TYPE
  382. SYNTAX NTPTimeStamp
  383. MAX-ACCESS read-only
  384. STATUS current
  385. DESCRIPTION
  386. "the same as the systemRefTime except this is for
  387. the peer"
  388. ::= { ntpPeersVarEntry 16 }
  389. ntpPeersOrgTime OBJECT-TYPE
  390. SYNTAX NTPTimeStamp
  391. MAX-ACCESS read-only
  392. STATUS current
  393. DESCRIPTION
  394. " the local time at the peer when its latest
  395. NTP message was sent. If the peer becomes unreachable the
  396. value is set to zero."
  397. ::= { ntpPeersVarEntry 17 }
  398. ntpPeersReceiveTime OBJECT-TYPE
  399. SYNTAX NTPTimeStamp
  400. MAX-ACCESS read-only
  401. STATUS current
  402. DESCRIPTION
  403. "the local time when the latest NTP message
  404. from the peer arrived. If the peer becomes unreachable the
  405. value is set to zero."
  406. ::= { ntpPeersVarEntry 18 }
  407. ntpPeersTransmitTime OBJECT-TYPE
  408. SYNTAX NTPTimeStamp
  409. MAX-ACCESS read-only
  410. STATUS current
  411. DESCRIPTION
  412. "the local time at which the NTP message
  413. departed the sender."
  414. ::= { ntpPeersVarEntry 19 }
  415. ntpPeersUpdateTime OBJECT-TYPE
  416. SYNTAX NTPTimeStamp
  417. MAX-ACCESS read-only
  418. STATUS current
  419. DESCRIPTION
  420. " "
  421. ::= { ntpPeersVarEntry 20 }
  422. ntpPeersReach OBJECT-TYPE
  423. SYNTAX Unsigned32
  424. MAX-ACCESS read-only
  425. STATUS current
  426. DESCRIPTION
  427. "a shift register of NTP.WINDOW bits used to determine
  428. the reachability status of the peer, with bits entering
  429. from the least significant (rightmost) end. A peer is
  430. considered reachable if at least one bit in this register is
  431. set to one."
  432. ::= { ntpPeersVarEntry 21 }
  433. ntpPeersTimer OBJECT-TYPE
  434. SYNTAX Integer32
  435. MAX-ACCESS read-only
  436. STATUS current
  437. DESCRIPTION
  438. ""
  439. ::= { ntpPeersVarEntry 22 }
  440. ntpPeersOffset OBJECT-TYPE
  441. SYNTAX OCTET STRING
  442. MAX-ACCESS read-only
  443. STATUS current
  444. DESCRIPTION
  445. ""
  446. ::= { ntpPeersVarEntry 23 }
  447. ntpPeersDelay OBJECT-TYPE
  448. SYNTAX OCTET STRING
  449. MAX-ACCESS read-only
  450. STATUS current
  451. DESCRIPTION
  452. ""
  453. ::= { ntpPeersVarEntry 24 }
  454. ntpPeersDispersion OBJECT-TYPE
  455. SYNTAX OCTET STRING
  456. MAX-ACCESS read-only
  457. STATUS current
  458. DESCRIPTION
  459. ""
  460. ::= { ntpPeersVarEntry 25 }
  461. --
  462. -- Filter Group
  463. --
  464. -- Implementation of this group is optional. It must be implemented
  465. -- when the filter and selection algorithms described in Section 4
  466. -- of RFC 1305 are used.
  467. --
  468. --
  469. -- Filter Group Peer Variables Table
  470. --
  471. ntpFilterPeersVarTable OBJECT-TYPE
  472. SYNTAX SEQUENCE OF NtpFilterPeersVarEntry
  473. MAX-ACCESS not-accessible
  474. STATUS current
  475. DESCRIPTION
  476. "This table is an extension of the Peer Variables Table
  477. in the Peer Group."
  478. ::= { ntpFilter 1 }
  479. ntpFilterPeersVarEntry OBJECT-TYPE
  480. SYNTAX NtpFilterPeersVarEntry
  481. MAX-ACCESS not-accessible
  482. STATUS current
  483. DESCRIPTION
  484. ""
  485. AUGMENTS { ntpPeersVarEntry }
  486. ::= { ntpFilterPeersVarTable 1 }
  487. NtpFilterPeersVarEntry ::= SEQUENCE {
  488. ntpFilterValidEntries Integer32
  489. }
  490. ntpFilterValidEntries OBJECT-TYPE
  491. SYNTAX Integer32
  492. MAX-ACCESS read-only
  493. STATUS current
  494. DESCRIPTION
  495. "The number of valid entries for a peer in the Filter Register Table."
  496. ::= { ntpFilterPeersVarEntry 1 }
  497. --
  498. -- Filter Register Table
  499. --
  500. ntpFilterRegisterTable OBJECT-TYPE
  501. SYNTAX SEQUENCE OF NtpFilterRegisterEntry
  502. MAX-ACCESS not-accessible
  503. STATUS current
  504. DESCRIPTION
  505. ""
  506. ::= { ntpFilter 2 }
  507. ntpFilterRegisterEntry OBJECT-TYPE
  508. SYNTAX NtpFilterRegisterEntry
  509. MAX-ACCESS not-accessible
  510. STATUS current
  511. DESCRIPTION
  512. ""
  513. INDEX { ntpPeersAssocId, ntpFilterIndex }
  514. ::= { ntpFilterRegisterTable 1 }
  515. NtpFilterRegisterEntry ::= SEQUENCE {
  516. ntpFilterIndex Unsigned32,
  517. ntpFilterPeersOffset OCTET STRING,
  518. ntpFilterPeersDelay OCTET STRING,
  519. ntpFilterPeersDispersion OCTET STRING
  520. }
  521. ntpFilterIndex OBJECT-TYPE
  522. SYNTAX Unsigned32
  523. MAX-ACCESS not-accessible
  524. STATUS current
  525. DESCRIPTION
  526. ""
  527. ::= { ntpFilterRegisterEntry 1 }
  528. ntpFilterPeersOffset OBJECT-TYPE
  529. SYNTAX OCTET STRING
  530. MAX-ACCESS read-only
  531. STATUS current
  532. DESCRIPTION
  533. "the offset of the peer clock relative to the
  534. local clock in seconds"
  535. ::= { ntpFilterRegisterEntry 2 }
  536. ntpFilterPeersDelay OBJECT-TYPE
  537. SYNTAX OCTET STRING
  538. MAX-ACCESS read-only
  539. STATUS current
  540. DESCRIPTION
  541. "roundtrip delay of the peer clock relative to the
  542. local clock over the network path between them, in seconds.
  543. this variable can take on both positive and negative values,
  544. depending on clock precision and skew-error accumulation."
  545. ::= { ntpFilterRegisterEntry 3 }
  546. ntpFilterPeersDispersion OBJECT-TYPE
  547. SYNTAX OCTET STRING
  548. MAX-ACCESS read-only
  549. STATUS current
  550. DESCRIPTION
  551. "the maximum error of the peer clock relative to the
  552. local clock over the network path between them, in seconds.
  553. Only positive values greater than zero are possible."
  554. ::= { ntpFilterRegisterEntry 4 }
  555. END