628 lines
16 KiB
Plaintext
628 lines
16 KiB
Plaintext
--
|
|
-- NTP MIB, Revision 0.2, 7/25/97
|
|
--
|
|
|
|
NTP-MIB DEFINITIONS ::= BEGIN
|
|
|
|
IMPORTS
|
|
Integer32, IpAddress, MODULE-IDENTITY, OBJECT-TYPE, Unsigned32,
|
|
enterprises
|
|
FROM SNMPv2-SMI
|
|
|
|
TEXTUAL-CONVENTION, TruthValue
|
|
FROM SNMPv2-TC;
|
|
|
|
ntpMIB MODULE-IDENTITY
|
|
LAST-UPDATED "199707251530Z"
|
|
ORGANIZATION
|
|
"University of Delaware"
|
|
CONTACT-INFO
|
|
"Adarsh Sethi
|
|
Department of Computer & Information Sciences
|
|
University of Delaware
|
|
Newark, DE 19716
|
|
Tel: +1 302 831 1945
|
|
E-mail: sethi@cis.udel.edu
|
|
|
|
David Mills
|
|
Department of Electrical Engineering
|
|
University of Delaware
|
|
Newark, DE 19716
|
|
Tel: +1 302 831 ????
|
|
E-mail: mills@ee.udel.edu"
|
|
DESCRIPTION
|
|
"This MIB module defines a MIB which provides mechanisms to
|
|
monitor and control an NTP server."
|
|
::= { udel 3 }
|
|
|
|
--
|
|
-- Position within the OID hierarchy of this MIB:
|
|
--
|
|
udel OBJECT IDENTIFIER
|
|
::= { enterprises 1277 }
|
|
|
|
--
|
|
-- The various groups defined within this MIB definition:
|
|
--
|
|
ntpSystem OBJECT IDENTIFIER
|
|
::= { ntpMIB 1 }
|
|
|
|
ntpPeers OBJECT IDENTIFIER
|
|
::= { ntpMIB 2 }
|
|
|
|
ntpFilter OBJECT IDENTIFIER
|
|
::= { ntpMIB 3 }
|
|
|
|
--
|
|
-- Textual conventions:
|
|
--
|
|
|
|
NTPTimeStamp ::= TEXTUAL-CONVENTION
|
|
DISPLAY-HINT "4x.4x"
|
|
STATUS current
|
|
DESCRIPTION
|
|
""
|
|
SYNTAX OCTET STRING (SIZE(8))
|
|
|
|
NTPLeapIndicator ::= TEXTUAL-CONVENTION
|
|
STATUS current
|
|
DESCRIPTION
|
|
""
|
|
SYNTAX INTEGER {
|
|
noWarning(0),
|
|
addSecond(1),
|
|
subtractSecond(2),
|
|
alarm(3) }
|
|
|
|
--
|
|
-- System Group
|
|
--
|
|
|
|
ntpSysLeap OBJECT-TYPE
|
|
SYNTAX NTPLeapIndicator
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
" two-bit code warning of an impending leap
|
|
second to be inserted in the NTP timescale."
|
|
::= { ntpSystem 1 }
|
|
|
|
ntpSysStratum OBJECT-TYPE
|
|
SYNTAX Integer32 (0..255)
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
" indicating the stratum of the local clock.
|
|
0, unspecified
|
|
1, primary reference (e.g.,, calibrated atomic clock,
|
|
radio clock)
|
|
2-255, secondary reference (via NTP)"
|
|
::= { ntpSystem 2 }
|
|
|
|
ntpSysPrecision OBJECT-TYPE
|
|
SYNTAX Integer32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"signed integer indicating the precision
|
|
of the various clocks, in seconds to the nearest power
|
|
of two."
|
|
::= { ntpSystem 3 }
|
|
|
|
ntpSysRootDelay OBJECT-TYPE
|
|
SYNTAX OCTET STRING
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"the total roundtrip delay to the primary
|
|
reference source at the root of the synchronization
|
|
subnet, in seconds"
|
|
::= { ntpSystem 4 }
|
|
|
|
ntpSysRootDispersion OBJECT-TYPE
|
|
SYNTAX OCTET STRING
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"the maximum error relative to the primary
|
|
reference source at the root of the synchronization
|
|
subnet, in seconds. Only positive values greater
|
|
than zero are possible"
|
|
::= { ntpSystem 5 }
|
|
|
|
ntpSysRefId OBJECT-TYPE
|
|
SYNTAX OCTET STRING
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
" the particular reference clock. In the case of
|
|
stratum 0 (unspecified) or stratum 1 (primary reference
|
|
source), this is a four-octet, left-justified,zero-padded
|
|
ASCII string.In the case of stratum 2 and greater (secondary
|
|
reference) this is the four-octet Internet address of the
|
|
peer selected for synchronization."
|
|
::= { ntpSystem 6 }
|
|
|
|
ntpSysRefTime OBJECT-TYPE
|
|
SYNTAX NTPTimeStamp
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
" the local time when the local clock was last
|
|
updated. If the local clock has neverbeen synchronized,
|
|
the value is zero."
|
|
::= { ntpSystem 7 }
|
|
|
|
ntpSysPoll OBJECT-TYPE
|
|
SYNTAX Integer32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
" the minimum interval between transmitted
|
|
messages, in seconds as a power of two. For instance,
|
|
a value of six indicates a minimum interval of 64 seconds."
|
|
::= { ntpSystem 8 }
|
|
|
|
ntpSysPeer OBJECT-TYPE
|
|
SYNTAX Unsigned32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
" the current synchronization source. Usually
|
|
this will be a pointer to a structure containing the peer
|
|
variables. The special value NULL indicates there is no
|
|
currently valid synchronization source."
|
|
::= { ntpSystem 9 }
|
|
|
|
ntpSysPhase OBJECT-TYPE
|
|
SYNTAX OCTET STRING
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
""
|
|
::= { ntpSystem 10 }
|
|
|
|
ntpSysFreq OBJECT-TYPE
|
|
SYNTAX OCTET STRING
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
""
|
|
::= { ntpSystem 11 }
|
|
|
|
ntpSysError OBJECT-TYPE
|
|
SYNTAX OCTET STRING
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
""
|
|
::= { ntpSystem 12 }
|
|
|
|
ntpSysClock OBJECT-TYPE
|
|
SYNTAX NTPTimeStamp
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"the current local time. Local time is derived
|
|
from the hardware clock of the particular machine and
|
|
increments at intervals depending on the design used."
|
|
::= { ntpSystem 13 }
|
|
|
|
ntpSysSystem OBJECT-TYPE
|
|
SYNTAX OCTET STRING
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
" the type of the local Operating System"
|
|
::= { ntpSystem 14 }
|
|
|
|
ntpSysProcessor OBJECT-TYPE
|
|
SYNTAX OCTET STRING
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
" the type of the local Processor"
|
|
::= { ntpSystem 15 }
|
|
|
|
--
|
|
-- Peers Group
|
|
--
|
|
|
|
--
|
|
-- Peer Variables Table
|
|
--
|
|
|
|
ntpPeersVarTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF NtpPeersVarEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
""
|
|
::= { ntpPeers 1 }
|
|
|
|
ntpPeersVarEntry OBJECT-TYPE
|
|
SYNTAX NtpPeersVarEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
""
|
|
INDEX { ntpPeersAssocId }
|
|
::= { ntpPeersVarTable 1 }
|
|
|
|
NtpPeersVarEntry ::= SEQUENCE {
|
|
ntpPeersAssocId Unsigned32,
|
|
ntpPeersConfigured TruthValue,
|
|
ntpPeersPeerAddress IpAddress,
|
|
ntpPeersPeerPort Unsigned32,
|
|
ntpPeersHostAddress IpAddress,
|
|
ntpPeersHostPort Unsigned32,
|
|
ntpPeersLeap NTPLeapIndicator,
|
|
ntpPeersMode INTEGER,
|
|
ntpPeersStratum Integer32,
|
|
ntpPeersPeerPoll Integer32,
|
|
ntpPeersHostPoll Integer32,
|
|
ntpPeersPrecision Integer32,
|
|
ntpPeersRootDelay OCTET STRING,
|
|
ntpPeersRootDispersion OCTET STRING,
|
|
ntpPeersRefId OCTET STRING,
|
|
ntpPeersRefTime NTPTimeStamp,
|
|
ntpPeersOrgTime NTPTimeStamp,
|
|
ntpPeersReceiveTime NTPTimeStamp,
|
|
ntpPeersTransmitTime NTPTimeStamp,
|
|
ntpPeersUpdateTime NTPTimeStamp,
|
|
ntpPeersReach Unsigned32,
|
|
ntpPeersTimer Integer32,
|
|
ntpPeersOffset OCTET STRING,
|
|
ntpPeersDelay OCTET STRING,
|
|
ntpPeersDispersion OCTET STRING
|
|
}
|
|
|
|
ntpPeersAssocId OBJECT-TYPE
|
|
SYNTAX Unsigned32
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
""
|
|
::= { ntpPeersVarEntry 1 }
|
|
|
|
ntpPeersConfigured OBJECT-TYPE
|
|
SYNTAX TruthValue
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
" This is a bit indicating that the association
|
|
was created from configuration information and should not
|
|
be demobilized if the peer becomes unreachable."
|
|
::= { ntpPeersVarEntry 2 }
|
|
|
|
ntpPeersPeerAddress OBJECT-TYPE
|
|
SYNTAX IpAddress
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
" the Internet address of the peer"
|
|
::= { ntpPeersVarEntry 3 }
|
|
|
|
ntpPeersPeerPort OBJECT-TYPE
|
|
SYNTAX Unsigned32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
" 16-bit port number of the peer."
|
|
::= { ntpPeersVarEntry 4 }
|
|
|
|
ntpPeersHostAddress OBJECT-TYPE
|
|
SYNTAX IpAddress
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
" the Internet address of the host"
|
|
::= { ntpPeersVarEntry 5 }
|
|
|
|
ntpPeersHostPort OBJECT-TYPE
|
|
SYNTAX Unsigned32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
" 16-bit port number of the host"
|
|
::= { ntpPeersVarEntry 6 }
|
|
|
|
ntpPeersLeap OBJECT-TYPE
|
|
SYNTAX NTPLeapIndicator
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
" two-bit code warning of an impending leap
|
|
second to be inserted in the NTP timescale."
|
|
::= { ntpPeersVarEntry 7 }
|
|
|
|
ntpPeersMode OBJECT-TYPE
|
|
SYNTAX INTEGER {
|
|
unspecified(0),
|
|
symmetricActive(1),
|
|
symmetricPassive(2),
|
|
client(3),
|
|
server(4),
|
|
broadcast(5),
|
|
reservedControl(6),
|
|
reservedPrivate(7)
|
|
}
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
" the association mode,with values coded as
|
|
follows:
|
|
0, unspecified
|
|
1, symmetric active
|
|
2, symmetric passive
|
|
3, client
|
|
4, server
|
|
5, broadcast
|
|
6, reserved for NTP control messages
|
|
7, reserved for private use
|
|
"
|
|
::= { ntpPeersVarEntry 8 }
|
|
|
|
ntpPeersStratum OBJECT-TYPE
|
|
SYNTAX Integer32 (0..255)
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
" indicating the stratum of the peer clock.
|
|
0, unspecified
|
|
1, primary reference (e.g.,, calibrated atomic clock,
|
|
radio clock)
|
|
2-255, secondary reference (via NTP)"
|
|
::= { ntpPeersVarEntry 9 }
|
|
|
|
ntpPeersPeerPoll OBJECT-TYPE
|
|
SYNTAX Integer32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"poll interval of the peer"
|
|
::= { ntpPeersVarEntry 10 }
|
|
|
|
ntpPeersHostPoll OBJECT-TYPE
|
|
SYNTAX Integer32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"poll interval of the host"
|
|
::= { ntpPeersVarEntry 11 }
|
|
|
|
ntpPeersPrecision OBJECT-TYPE
|
|
SYNTAX Integer32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"the same as the systemPrecision except this is
|
|
for the peer"
|
|
::= { ntpPeersVarEntry 12 }
|
|
|
|
ntpPeersRootDelay OBJECT-TYPE
|
|
SYNTAX OCTET STRING
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"the same as the systemRootDealy except this is for
|
|
the peer"
|
|
::= { ntpPeersVarEntry 13 }
|
|
|
|
ntpPeersRootDispersion OBJECT-TYPE
|
|
SYNTAX OCTET STRING
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"the same as the systemDispersion except this is for
|
|
the peer"
|
|
::= { ntpPeersVarEntry 14 }
|
|
|
|
ntpPeersRefId OBJECT-TYPE
|
|
SYNTAX OCTET STRING
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"the same as the systemRefid except this is for
|
|
the peer"
|
|
::= { ntpPeersVarEntry 15 }
|
|
|
|
ntpPeersRefTime OBJECT-TYPE
|
|
SYNTAX NTPTimeStamp
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"the same as the systemRefTime except this is for
|
|
the peer"
|
|
::= { ntpPeersVarEntry 16 }
|
|
|
|
ntpPeersOrgTime OBJECT-TYPE
|
|
SYNTAX NTPTimeStamp
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
" the local time at the peer when its latest
|
|
NTP message was sent. If the peer becomes unreachable the
|
|
value is set to zero."
|
|
::= { ntpPeersVarEntry 17 }
|
|
|
|
ntpPeersReceiveTime OBJECT-TYPE
|
|
SYNTAX NTPTimeStamp
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"the local time when the latest NTP message
|
|
from the peer arrived. If the peer becomes unreachable the
|
|
value is set to zero."
|
|
::= { ntpPeersVarEntry 18 }
|
|
|
|
ntpPeersTransmitTime OBJECT-TYPE
|
|
SYNTAX NTPTimeStamp
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"the local time at which the NTP message
|
|
departed the sender."
|
|
::= { ntpPeersVarEntry 19 }
|
|
|
|
ntpPeersUpdateTime OBJECT-TYPE
|
|
SYNTAX NTPTimeStamp
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
" "
|
|
::= { ntpPeersVarEntry 20 }
|
|
|
|
ntpPeersReach OBJECT-TYPE
|
|
SYNTAX Unsigned32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"a shift register of NTP.WINDOW bits used to determine
|
|
the reachability status of the peer, with bits entering
|
|
from the least significant (rightmost) end. A peer is
|
|
considered reachable if at least one bit in this register is
|
|
set to one."
|
|
::= { ntpPeersVarEntry 21 }
|
|
|
|
ntpPeersTimer OBJECT-TYPE
|
|
SYNTAX Integer32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
""
|
|
::= { ntpPeersVarEntry 22 }
|
|
|
|
ntpPeersOffset OBJECT-TYPE
|
|
SYNTAX OCTET STRING
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
""
|
|
::= { ntpPeersVarEntry 23 }
|
|
|
|
ntpPeersDelay OBJECT-TYPE
|
|
SYNTAX OCTET STRING
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
""
|
|
::= { ntpPeersVarEntry 24 }
|
|
|
|
ntpPeersDispersion OBJECT-TYPE
|
|
SYNTAX OCTET STRING
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
""
|
|
::= { ntpPeersVarEntry 25 }
|
|
|
|
--
|
|
-- Filter Group
|
|
--
|
|
-- Implementation of this group is optional. It must be implemented
|
|
-- when the filter and selection algorithms described in Section 4
|
|
-- of RFC 1305 are used.
|
|
--
|
|
|
|
--
|
|
-- Filter Group Peer Variables Table
|
|
--
|
|
ntpFilterPeersVarTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF NtpFilterPeersVarEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This table is an extension of the Peer Variables Table
|
|
in the Peer Group."
|
|
::= { ntpFilter 1 }
|
|
|
|
ntpFilterPeersVarEntry OBJECT-TYPE
|
|
SYNTAX NtpFilterPeersVarEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
""
|
|
AUGMENTS { ntpPeersVarEntry }
|
|
::= { ntpFilterPeersVarTable 1 }
|
|
|
|
NtpFilterPeersVarEntry ::= SEQUENCE {
|
|
ntpFilterValidEntries Integer32
|
|
}
|
|
|
|
ntpFilterValidEntries OBJECT-TYPE
|
|
SYNTAX Integer32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The number of valid entries for a peer in the Filter Register Table."
|
|
::= { ntpFilterPeersVarEntry 1 }
|
|
|
|
--
|
|
-- Filter Register Table
|
|
--
|
|
|
|
ntpFilterRegisterTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF NtpFilterRegisterEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
""
|
|
::= { ntpFilter 2 }
|
|
|
|
ntpFilterRegisterEntry OBJECT-TYPE
|
|
SYNTAX NtpFilterRegisterEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
""
|
|
INDEX { ntpPeersAssocId, ntpFilterIndex }
|
|
::= { ntpFilterRegisterTable 1 }
|
|
|
|
NtpFilterRegisterEntry ::= SEQUENCE {
|
|
ntpFilterIndex Unsigned32,
|
|
ntpFilterPeersOffset OCTET STRING,
|
|
ntpFilterPeersDelay OCTET STRING,
|
|
ntpFilterPeersDispersion OCTET STRING
|
|
}
|
|
|
|
ntpFilterIndex OBJECT-TYPE
|
|
SYNTAX Unsigned32
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
""
|
|
::= { ntpFilterRegisterEntry 1 }
|
|
|
|
ntpFilterPeersOffset OBJECT-TYPE
|
|
SYNTAX OCTET STRING
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"the offset of the peer clock relative to the
|
|
local clock in seconds"
|
|
::= { ntpFilterRegisterEntry 2 }
|
|
|
|
ntpFilterPeersDelay OBJECT-TYPE
|
|
SYNTAX OCTET STRING
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"roundtrip delay of the peer clock relative to the
|
|
local clock over the network path between them, in seconds.
|
|
this variable can take on both positive and negative values,
|
|
depending on clock precision and skew-error accumulation."
|
|
::= { ntpFilterRegisterEntry 3 }
|
|
|
|
ntpFilterPeersDispersion OBJECT-TYPE
|
|
SYNTAX OCTET STRING
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"the maximum error of the peer clock relative to the
|
|
local clock over the network path between them, in seconds.
|
|
Only positive values greater than zero are possible."
|
|
::= { ntpFilterRegisterEntry 4 }
|
|
|
|
END
|