ZHONE-DISMAN-TRACEROUTE-MIB DEFINITIONS ::= BEGIN IMPORTS MODULE-IDENTITY, OBJECT-TYPE, Integer32, Gauge32, Unsigned32, mib-2, NOTIFICATION-TYPE, OBJECT-IDENTITY FROM SNMPv2-SMI -- RFC2578 RowStatus, StorageType, TruthValue, DateAndTime FROM SNMPv2-TC -- RFC2579 MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP FROM SNMPv2-CONF -- RFC2580 SnmpAdminString FROM SNMP-FRAMEWORK-MIB -- RFC2571 InterfaceIndexOrZero -- RFC2863 FROM IF-MIB InetAddressType, InetAddress FROM INET-ADDRESS-MIB -- RFC2851 OperationResponseStatus FROM ZHONE-DISMAN-PING-MIB -- RFC2925 zhoneIp FROM Zhone; zhoneTraceRouteMIB MODULE-IDENTITY LAST-UPDATED "200009210000Z" -- 21 September 2000 ORGANIZATION "IETF Distributed Management Working Group" CONTACT-INFO "Kenneth White International Business Machines Corporation Network Computing Software Division Research Triangle Park, NC, USA E-mail: wkenneth@us.ibm.com" DESCRIPTION "The Traceroute MIB (ZHONE-DISMAN-TRACEROUTE-MIB) provides access to the traceroute capability at a remote host." -- Revision history REVISION "200009210000Z" -- 21 September 2000 DESCRIPTION "Initial version, published as RFC 2925." ::= { zhoneIp 20 } -- Top level structure of the MIB zhoneTraceRouteNotifications OBJECT IDENTIFIER ::= { zhoneTraceRouteMIB 0 } zhoneTraceRouteObjects OBJECT IDENTIFIER ::= { zhoneTraceRouteMIB 1 } zhoneTraceRouteConformance OBJECT IDENTIFIER ::= { zhoneTraceRouteMIB 2 } -- The registration node (point) for zhoneTraceRoute implementation types zhoneTraceRouteImplementationTypeDomains OBJECT IDENTIFIER ::= { zhoneTraceRouteMIB 3 } zhoneTraceRouteUsingUdpProbes OBJECT-IDENTITY STATUS current DESCRIPTION "Indicates that an implementation is using UDP probes to perform the traceroute operation." ::= { zhoneTraceRouteImplementationTypeDomains 1 } -- Simple Object Definitions zhoneTraceRouteMaxConcurrentRequests OBJECT-TYPE SYNTAX Unsigned32 UNITS "requests" MAX-ACCESS read-write STATUS current DESCRIPTION "The maximum number of concurrent active traceroute requests that are allowed within an agent implementation. A value of 0 for this object implies that there is no limit for the number of concurrent active requests in effect." DEFVAL { 10 } ::= { zhoneTraceRouteObjects 1 } zhoneTraceRouteCtlIndexNext OBJECT-TYPE SYNTAX INTEGER (0..2147483647) MAX-ACCESS read-only STATUS current DESCRIPTION "This object contains an appropriate value to be used for zhonePingCtlIndex when creating entries in the zhonePingCtlTable. The value 0 indicates that no unassigned entries are available. To obtain the zhonePingCtlIndex value for a new entry, the manager issues a management protocol retrieval operation to obtain the current value of this object. After each retrieval, the agent should modify the value to the next unassigned index. After a manager retrieves a value the agent will determine through its local policy when this index value will be made available for reuse." ::= { zhoneTraceRouteObjects 2 } -- Traceroute Control Table zhoneTraceRouteCtlTable OBJECT-TYPE SYNTAX SEQUENCE OF ZhoneTraceRouteCtlEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Defines the Remote Operations Traceroute Control Table for providing the capability of invoking traceroute from a remote host. The results of traceroute operations can be stored in the zhoneTraceRouteResultsTable, and the zhoneTraceRouteHopsTable." ::= { zhoneTraceRouteObjects 3 } zhoneTraceRouteCtlEntry OBJECT-TYPE SYNTAX ZhoneTraceRouteCtlEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Defines an entry in the zhoneTraceRouteCtlTable." INDEX { zhoneTraceRouteCtlIndex } ::= { zhoneTraceRouteCtlTable 1 } ZhoneTraceRouteCtlEntry ::= SEQUENCE { zhoneTraceRouteCtlIndex INTEGER, zhoneTraceRouteCtlTargetAddressType InetAddressType, zhoneTraceRouteCtlTargetAddress InetAddress, zhoneTraceRouteCtlByPassRouteTable TruthValue, zhoneTraceRouteCtlDataSize Unsigned32, zhoneTraceRouteCtlTimeOut Unsigned32, zhoneTraceRouteCtlProbesPerHop Unsigned32, zhoneTraceRouteCtlPort Unsigned32, zhoneTraceRouteCtlMaxTtl Unsigned32, zhoneTraceRouteCtlDSField Unsigned32, zhoneTraceRouteCtlSourceAddressType InetAddressType, zhoneTraceRouteCtlSourceAddress InetAddress, zhoneTraceRouteCtlIfIndex InterfaceIndexOrZero, zhoneTraceRouteCtlMiscOptions SnmpAdminString, zhoneTraceRouteCtlMaxFailures Unsigned32, zhoneTraceRouteCtlDontFragment TruthValue, zhoneTraceRouteCtlInitialTtl Unsigned32, zhoneTraceRouteCtlFrequency Unsigned32, zhoneTraceRouteCtlStorageType StorageType, zhoneTraceRouteCtlAdminStatus INTEGER, zhoneTraceRouteCtlMaxRows Unsigned32, zhoneTraceRouteCtlTrapGeneration BITS, zhoneTraceRouteCtlDescr SnmpAdminString, zhoneTraceRouteCtlCreateHopsEntries TruthValue, zhoneTraceRouteCtlType OBJECT IDENTIFIER, zhoneTraceRouteCtlRowStatus RowStatus } zhoneTraceRouteCtlIndex OBJECT-TYPE SYNTAX INTEGER (0..2147483647) MAX-ACCESS read-only STATUS current DESCRIPTION "When used in conjunction with such a security policy all entries in the table belonging to a particular user (or group) will have the same value for this initial index. For a given user's entries in a particular table, the object identifiers for the information in these entries will have the same subidentifiers (except for the 'column' subidentifier) up to the end of the encoded owner index." ::= { zhoneTraceRouteCtlEntry 1 } zhoneTraceRouteCtlTargetAddressType OBJECT-TYPE SYNTAX InetAddressType MAX-ACCESS read-create STATUS current DESCRIPTION "Specifies the type of host address to be used on the traceroute request at the remote host." DEFVAL { ipv4 } ::= { zhoneTraceRouteCtlEntry 2 } zhoneTraceRouteCtlTargetAddress OBJECT-TYPE SYNTAX InetAddress MAX-ACCESS read-create STATUS current DESCRIPTION "Specifies the host address used on the traceroute request at the remote host. The host address type can be determined by the examining the value of the corresponding zhoneTraceRouteCtlTargetAddressType index element. A value for this object MUST be set prior to transitioning its corresponding zhoneTraceRouteCtlEntry to active(1) via zhoneTraceRouteCtlRowStatus." ::= { zhoneTraceRouteCtlEntry 3 } zhoneTraceRouteCtlByPassRouteTable OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-create STATUS current DESCRIPTION "The purpose of this object is to optionally enable bypassing the route table. If enabled, the remote host will bypass the normal routing tables and send directly to a host on an attached network. If the host is not on a directly-attached network, an error is returned. This option can be used to perform the traceroute operation to a local host through an interface that has no route defined (e.g., after the interface was dropped by routed)." DEFVAL { false } ::= { zhoneTraceRouteCtlEntry 4 } zhoneTraceRouteCtlDataSize OBJECT-TYPE SYNTAX Unsigned32 (0..65507) UNITS "octets" MAX-ACCESS read-create STATUS current DESCRIPTION "Specifies the size of the data portion of a traceroute request in octets. A traceroute request is essentially transmitted by encoding a UDP datagram into a IP packet. So subtracting the size of a UDP header (8 octets) and the size of a IP header (20 octets) yields a maximum of 65507 octets." DEFVAL { 0 } ::= { zhoneTraceRouteCtlEntry 5 } zhoneTraceRouteCtlTimeOut OBJECT-TYPE SYNTAX Unsigned32 (1..60) UNITS "seconds" MAX-ACCESS read-create STATUS current DESCRIPTION "Specifies the time-out value, in seconds, for a traceroute request." DEFVAL { 3 } ::= { zhoneTraceRouteCtlEntry 6 } zhoneTraceRouteCtlProbesPerHop OBJECT-TYPE SYNTAX Unsigned32 (1..10) UNITS "probes" MAX-ACCESS read-create STATUS current DESCRIPTION "Specifies the number of times to reissue a traceroute request with the same time-to-live (TTL) value." DEFVAL { 3 } ::= { zhoneTraceRouteCtlEntry 7 } zhoneTraceRouteCtlPort OBJECT-TYPE SYNTAX Unsigned32 (1..65535) UNITS "UDP Port" MAX-ACCESS read-create STATUS current DESCRIPTION "Specifies the UDP port to send the traceroute request to. Need to specify a port that is not in use at the destination (target) host. The default value for this object is the IANA assigned port, 33434, for the traceroute function." DEFVAL { 33434 } ::= { zhoneTraceRouteCtlEntry 8 } zhoneTraceRouteCtlMaxTtl OBJECT-TYPE SYNTAX Unsigned32 (1..255) UNITS "time-to-live value" MAX-ACCESS read-create STATUS current DESCRIPTION "Specifies the maximum time-to-live value." DEFVAL { 30 } ::= { zhoneTraceRouteCtlEntry 9 } zhoneTraceRouteCtlDSField OBJECT-TYPE SYNTAX Unsigned32 (0..255) MAX-ACCESS read-create STATUS current DESCRIPTION "Specifies the value to store in the Differentiated Services (DS) Field in the IP packet used to encapsulate the traceroute probe. The DS Field is defined as the Type of Service (TOS) octet in a IPv4 header or as the Traffic Class octet in a IPv6 header. The value of this object must be a decimal integer in the range from 0 to 255. This option can be used to determine what effect an explicit DS Field setting has on a traceroute response. Not all values are legal or meaningful. DS Field usage is often not supported by IP implementations. A value of 0 means that the function represented by this option is not supported. Useful TOS octet values are probably '16' (low delay) and '8' ( high throughput)." REFERENCE "Refer to RFC 2474 for the definition of the Differentiated Services Field and to RFC 1812 Section 5.3.2 for Type of Service (TOS)." DEFVAL { 0 } ::= { zhoneTraceRouteCtlEntry 10 } zhoneTraceRouteCtlSourceAddressType OBJECT-TYPE SYNTAX InetAddressType MAX-ACCESS read-create STATUS current DESCRIPTION "Specifies the type of the source address, zhoneTraceRouteCtlSourceAddress, to be used at a remote host when performing a traceroute operation." DEFVAL { unknown } ::= { zhoneTraceRouteCtlEntry 11 } zhoneTraceRouteCtlSourceAddress OBJECT-TYPE SYNTAX InetAddress MAX-ACCESS read-create STATUS current DESCRIPTION "Use the specified IP address (which must be given as an IP number, not a hostname) as the source address in outgoing probe packets. On hosts with more than one IP address, this option can be used to force the source address to be something other than the primary IP address of the interface the probe packet is sent on. If the IP address is not one of this machine's interface addresses, an error is returned and nothing is sent. A zero length octet string value for this object disables source address specification. The address type (InetAddressType) that relates to this object is specified by the corresponding value of zhoneTraceRouteCtlSourceAddressType." DEFVAL { '0'H } ::= { zhoneTraceRouteCtlEntry 12 } zhoneTraceRouteCtlIfIndex OBJECT-TYPE SYNTAX InterfaceIndexOrZero MAX-ACCESS read-create STATUS current DESCRIPTION "Setting this object to an interface's ifIndex prior to starting a remote traceroute operation directs the traceroute probes to be transmitted over the specified interface. A value of zero for this object implies that this option is not enabled." DEFVAL { 0 } ::= { zhoneTraceRouteCtlEntry 13 } zhoneTraceRouteCtlMiscOptions OBJECT-TYPE SYNTAX SnmpAdminString MAX-ACCESS read-create STATUS current DESCRIPTION "Enables an application to specify implementation dependent options." DEFVAL { '0'H } ::= { zhoneTraceRouteCtlEntry 14 } zhoneTraceRouteCtlMaxFailures OBJECT-TYPE SYNTAX Unsigned32 (0..255) UNITS "timeouts" MAX-ACCESS read-create STATUS current DESCRIPTION "The value of this object indicates the maximum number of consecutive timeouts allowed before terminating a remote traceroute request. A value of either 255 (maximum hop count/possible TTL value) or a 0 indicates that the function of terminating a remote traceroute request when a specific number of successive timeouts are detected is disabled." DEFVAL { 5 } ::= { zhoneTraceRouteCtlEntry 15 } zhoneTraceRouteCtlDontFragment OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-create STATUS current DESCRIPTION "This object enables setting of the don't fragment flag (DF) in the IP header for a probe. Use of this object enables performing a manual PATH MTU test." DEFVAL { false } ::= { zhoneTraceRouteCtlEntry 16 } zhoneTraceRouteCtlInitialTtl OBJECT-TYPE SYNTAX Unsigned32 (0..255) MAX-ACCESS read-create STATUS current DESCRIPTION "The value of this object specifies the initial TTL value to use. This enables bypassing the initial (often well known) portion of a path." DEFVAL { 1 } ::= { zhoneTraceRouteCtlEntry 17 } zhoneTraceRouteCtlFrequency OBJECT-TYPE SYNTAX Unsigned32 UNITS "seconds" MAX-ACCESS read-create STATUS current DESCRIPTION "The number of seconds to wait before repeating a traceroute test as defined by the value of the various objects in the corresponding row. The number of hops in a single traceroute test is determined by the value of the corresponding zhoneTraceRouteCtlProbesPerHop object. After a single test completes the number of seconds as defined by the value of zhoneTraceRouteCtlFrequency MUST elapse before the next traceroute test is started. A value of 0 for this object implies that the test as defined by the corresponding entry will not be repeated." DEFVAL { 0 } ::= { zhoneTraceRouteCtlEntry 18 } zhoneTraceRouteCtlStorageType OBJECT-TYPE SYNTAX StorageType MAX-ACCESS read-create STATUS current DESCRIPTION "The storage type for this conceptual row. Conceptual rows having the value 'permanent' need not allow write-access to any columnar objects in the row." DEFVAL { nonVolatile } ::= { zhoneTraceRouteCtlEntry 19 } zhoneTraceRouteCtlAdminStatus OBJECT-TYPE SYNTAX INTEGER { enabled(1), -- operation should be started disabled(2) -- operation should be stopped } MAX-ACCESS read-create STATUS current DESCRIPTION "Reflects the desired state that an zhoneTraceRouteCtlEntry should be in: enabled(1) - Attempt to activate the test as defined by this zhoneTraceRouteCtlEntry. disabled(2) - Deactivate the test as defined by this zhoneTraceRouteCtlEntry. Refer to the corresponding zhoneTraceRouteResultsOperStatus to determine the operational state of the test defined by this entry." DEFVAL { disabled } ::= { zhoneTraceRouteCtlEntry 20 } zhoneTraceRouteCtlDescr OBJECT-TYPE SYNTAX SnmpAdminString MAX-ACCESS read-create STATUS current DESCRIPTION "The purpose of this object is to provide a descriptive name of the remote traceroute test." DEFVAL { '0'H } ::= { zhoneTraceRouteCtlEntry 21 } zhoneTraceRouteCtlMaxRows OBJECT-TYPE SYNTAX Unsigned32 UNITS "rows" MAX-ACCESS read-create STATUS current DESCRIPTION "None" DEFVAL { 50 } ::= { zhoneTraceRouteCtlEntry 22 } zhoneTraceRouteCtlTrapGeneration OBJECT-TYPE SYNTAX BITS { pathChange(0), testFailure(1), testCompletion(2) } MAX-ACCESS read-create STATUS current DESCRIPTION "The value of this object determines when and if to to generate a notification for this entry: pathChange(0) - Generate a zhoneTraceRoutePathChange notification when the current path varies from a previously determined path. testFailure(1) - Generate a zhoneTraceRouteTestFailed notification when the full path to a target can't be determined. testCompletion(2) - Generate a zhoneTraceRouteTestCompleted notification when the path to a target has been determined. The value of this object defaults to zero, indicating that none of the above options have been selected." ::= { zhoneTraceRouteCtlEntry 23 } zhoneTraceRouteCtlCreateHopsEntries OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-create STATUS current DESCRIPTION "The current path for a traceroute test is kept in the zhoneTraceRouteHopsTable on a per hop basis when the value of this object is true(1)." DEFVAL { false } ::= { zhoneTraceRouteCtlEntry 24 } zhoneTraceRouteCtlType OBJECT-TYPE SYNTAX OBJECT IDENTIFIER MAX-ACCESS read-create STATUS current DESCRIPTION "The value of this object is used either to report or select the implementation method to be used for performing a traceroute operation. The value of this object may be selected from zhoneTraceRouteImplementationTypeDomains. Additional implementation types should be allocated as required by implementers of the ZHONE-DISMAN-TRACEROUTE-MIB under their enterprise specific registration point and not beneath zhoneTraceRouteImplementationTypeDomains." DEFVAL { zhoneTraceRouteUsingUdpProbes } ::= { zhoneTraceRouteCtlEntry 25 } zhoneTraceRouteCtlRowStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "This object allows entries to be created and deleted in the traceRouteCtlTable. Deletion of an entry in this table results in all corresponding (same zhoneTraceRouteCtlOwnerIndex and zhoneTraceRouteCtlTestName index values) zhoneTraceRouteResultsTable and zhoneTraceRouteHopsTable entries being deleted. A value MUST be specified for zhoneTraceRouteCtlTargetAddress prior to a transition to active(1) state being accepted. Activation of a remote traceroute operation is controlled via zhoneTraceRouteCtlAdminStatus and not by transitioning of this object's value to active(1). Transitions in and out of active(1) state are not allowed while an entry's zhoneTraceRouteResultsOperStatus is active(1) with the exception that deletion of an entry in this table by setting its RowStatus object to destroy(6) will stop an active traceroute operation. The operational state of an traceroute operation can be determined by examination of the corresponding zhoneTraceRouteResultsOperStatus object." REFERENCE "See definition of RowStatus in RFC 2579, 'Textual Conventions for SMIv2.'" ::= { zhoneTraceRouteCtlEntry 26 } -- Traceroute Results Table zhoneTraceRouteResultsTable OBJECT-TYPE SYNTAX SEQUENCE OF ZhoneTraceRouteResultsEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Defines the Remote Operations Traceroute Results Table for keeping track of the status of a zhoneTraceRouteCtlEntry. An entry is added to the zhoneTraceRouteResultsTable when an zhoneTraceRouteCtlEntry is started by successful transition of its zhoneTraceRouteCtlAdminStatus object to enabled(1). An entry is removed from the zhoneTraceRouteResultsTable when its corresponding zhoneTraceRouteCtlEntry is deleted." ::= { zhoneTraceRouteObjects 4 } zhoneTraceRouteResultsEntry OBJECT-TYPE SYNTAX ZhoneTraceRouteResultsEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Defines an entry in the zhoneTraceRouteResultsTable. The zhoneTraceRouteResultsTable has the same indexing as the zhoneTraceRouteCtlTable in order for a zhoneTraceRouteResultsEntry to correspond to the zhoneTraceRouteCtlEntry that caused it to be created." INDEX { zhoneTraceRouteCtlIndex } ::= { zhoneTraceRouteResultsTable 1 } ZhoneTraceRouteResultsEntry ::= SEQUENCE { zhoneTraceRouteResultsOperStatus INTEGER, zhoneTraceRouteResultsCurHopCount Gauge32, zhoneTraceRouteResultsCurProbeCount Gauge32, zhoneTraceRouteResultsIpTgtAddrType InetAddressType, zhoneTraceRouteResultsIpTgtAddr InetAddress, zhoneTraceRouteResultsTestAttempts Unsigned32, zhoneTraceRouteResultsTestSuccesses Unsigned32, zhoneTraceRouteResultsLastGoodPath DateAndTime } zhoneTraceRouteResultsOperStatus OBJECT-TYPE SYNTAX INTEGER { enabled(1), -- test is in progress disabled(2) -- test has stopped } MAX-ACCESS read-only STATUS current DESCRIPTION "Reflects the operational state of an zhoneTraceRouteCtlEntry: enabled(1) - Test is active. disabled(2) - Test has stopped." ::= { zhoneTraceRouteResultsEntry 1 } zhoneTraceRouteResultsCurHopCount OBJECT-TYPE SYNTAX Gauge32 UNITS "hops" MAX-ACCESS read-only STATUS current DESCRIPTION "Reflects the current TTL value (range from 1 to 255) for a remote traceroute operation. Maximum TTL value is determined by zhoneTraceRouteCtlMaxTtl." ::= { zhoneTraceRouteResultsEntry 2 } zhoneTraceRouteResultsCurProbeCount OBJECT-TYPE SYNTAX Gauge32 UNITS "probes" MAX-ACCESS read-only STATUS current DESCRIPTION "Reflects the current probe count (1..10) for a remote traceroute operation. The maximum probe count is determined by zhoneTraceRouteCtlProbesPerHop." ::= { zhoneTraceRouteResultsEntry 3 } zhoneTraceRouteResultsIpTgtAddrType OBJECT-TYPE SYNTAX InetAddressType MAX-ACCESS read-only STATUS current DESCRIPTION "This objects indicates the type of address stored in the corresponding zhoneTraceRouteResultsIpTgtAddr object." ::= { zhoneTraceRouteResultsEntry 4 } zhoneTraceRouteResultsIpTgtAddr OBJECT-TYPE SYNTAX InetAddress MAX-ACCESS read-only STATUS current DESCRIPTION "This objects reports the IP address associated with a zhoneTraceRouteCtlTargetAddress value when the destination address is specified as a DNS name. The value of this object should be a zero length octet string when a DNS name is not specified or when a specified DNS name fails to resolve." ::= { zhoneTraceRouteResultsEntry 5 } zhoneTraceRouteResultsTestAttempts OBJECT-TYPE SYNTAX Unsigned32 UNITS "tests" MAX-ACCESS read-only STATUS current DESCRIPTION "The current number of attempts to determine a path to a target. The value of this object MUST be started at 0." ::= { zhoneTraceRouteResultsEntry 6 } zhoneTraceRouteResultsTestSuccesses OBJECT-TYPE SYNTAX Unsigned32 UNITS "tests" MAX-ACCESS read-only STATUS current DESCRIPTION "The current number of attempts to determine a path to a target that have succeeded. The value of this object MUST be reported as 0 when no attempts have succeeded." ::= { zhoneTraceRouteResultsEntry 7 } zhoneTraceRouteResultsLastGoodPath OBJECT-TYPE SYNTAX DateAndTime MAX-ACCESS read-only STATUS current DESCRIPTION "The date and time when the last complete path was determined." ::= { zhoneTraceRouteResultsEntry 8 } -- Trace Route Probe History Table -- Traceroute Hop Results Table zhoneTraceRouteHopsTable OBJECT-TYPE SYNTAX SEQUENCE OF ZhoneTraceRouteHopsEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Defines the Remote Operations Traceroute Hop Table for keeping track of the results of traceroute tests on a per hop basis." ::= { zhoneTraceRouteObjects 5 } zhoneTraceRouteHopsEntry OBJECT-TYPE SYNTAX ZhoneTraceRouteHopsEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Defines an entry in the zhoneTraceRouteHopsTable. The first two index elements identify the zhoneTraceRouteCtlEntry that a zhoneTraceRouteHopsEntry belongs to. The third index element, zhoneTraceRouteHopsHopIndex, selects a hop in a traceroute path." INDEX { zhoneTraceRouteCtlIndex, zhoneTraceRouteHopsHopIndex } ::= { zhoneTraceRouteHopsTable 1 } ZhoneTraceRouteHopsEntry ::= SEQUENCE { zhoneTraceRouteHopsHopIndex Unsigned32, zhoneTraceRouteHopsIpTgtAddressType InetAddressType, zhoneTraceRouteHopsIpTgtAddress InetAddress, zhoneTraceRouteHopsMinRtt Unsigned32, zhoneTraceRouteHopsMaxRtt Unsigned32, zhoneTraceRouteHopsAverageRtt Unsigned32, zhoneTraceRouteHopsRttSumOfSquares Unsigned32, zhoneTraceRouteHopsSentProbes Unsigned32, zhoneTraceRouteHopsProbeResponses Unsigned32, zhoneTraceRouteHopsLastGoodProbe DateAndTime } zhoneTraceRouteHopsHopIndex OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS not-accessible STATUS current DESCRIPTION "Specifies the hop index for a traceroute hop. Values for this object with respect to the same zhoneTraceRouteCtlOwnerIndex and zhoneTraceRouteCtlTestName MUST start at 1 and increase monotonically. The zhoneTraceRouteHopsTable keeps the current traceroute path per zhoneTraceRouteCtlEntry if enabled by setting the corresponding zhoneTraceRouteCtlCreateHopsEntries to true(1). All hops (zhoneTraceRouteHopsTable entries) in a traceroute path MUST be updated at the same time when a traceroute operation completes. Care needs to be applied when either a path changes or can't be determined. The initial portion of the path, up to the first hop change, MUST retain the same zhoneTraceRouteHopsHopIndex values. The remaining portion of the path SHOULD be assigned new zhoneTraceRouteHopsHopIndex values." ::= { zhoneTraceRouteHopsEntry 1 } zhoneTraceRouteHopsIpTgtAddressType OBJECT-TYPE SYNTAX InetAddressType MAX-ACCESS read-only STATUS current DESCRIPTION "This objects indicates the type of address stored in the corresponding zhoneTraceRouteHopsIpTargetAddress object." ::= { zhoneTraceRouteHopsEntry 2 } zhoneTraceRouteHopsIpTgtAddress OBJECT-TYPE SYNTAX InetAddress MAX-ACCESS read-only STATUS current DESCRIPTION "This object reports the IP address associated with the hop. A value for this object should be reported as a numeric IP address and not as a DNS name." ::= { zhoneTraceRouteHopsEntry 3 } zhoneTraceRouteHopsMinRtt OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "The minimum traceroute round-trip-time (RTT) received for this hop. A value of 0 for this object implies that no RTT has been received." ::= { zhoneTraceRouteHopsEntry 4 } zhoneTraceRouteHopsMaxRtt OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "The maximum traceroute round-trip-time (RTT) received for this hop. A value of 0 for this object implies that no RTT has been received." ::= { zhoneTraceRouteHopsEntry 5 } zhoneTraceRouteHopsAverageRtt OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "The current average traceroute round-trip-time (RTT) for this hop." ::= { zhoneTraceRouteHopsEntry 6 } zhoneTraceRouteHopsRttSumOfSquares OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "This object contains the sum of all traceroute responses received for this hop. Its purpose is to enable standard deviation calculation." ::= { zhoneTraceRouteHopsEntry 7 } zhoneTraceRouteHopsSentProbes OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "The value of this object reflects the number of probes sent for this hop during this traceroute test. The value of this object should start at 0." ::= { zhoneTraceRouteHopsEntry 8 } zhoneTraceRouteHopsProbeResponses OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of responses received for this hop during this traceroute test. This value of this object should start at 0." ::= { zhoneTraceRouteHopsEntry 9 } zhoneTraceRouteHopsLastGoodProbe OBJECT-TYPE SYNTAX DateAndTime MAX-ACCESS read-only STATUS current DESCRIPTION "Date and time was the last response was received for a probe for this hop during this traceroute test." ::= { zhoneTraceRouteHopsEntry 10 } -- Notification Definition section zhoneTraceRoutePathChange NOTIFICATION-TYPE OBJECTS { zhoneTraceRouteResultsIpTgtAddr } STATUS current DESCRIPTION "The path to a target has changed." ::= { zhoneTraceRouteNotifications 1 } zhoneTraceRouteTestFailed NOTIFICATION-TYPE OBJECTS { zhoneTraceRouteResultsIpTgtAddr } STATUS current DESCRIPTION "Could not determine the path to a target." ::= { zhoneTraceRouteNotifications 2 } zhoneTraceRouteTestCompleted NOTIFICATION-TYPE OBJECTS { zhoneTraceRouteResultsIpTgtAddr } STATUS current DESCRIPTION "The path to a target has just been determined." ::= { zhoneTraceRouteNotifications 3 } -- Conformance information -- Compliance statements zhoneTraceRouteGroups OBJECT IDENTIFIER ::= { zhoneTraceRouteConformance 1 } -- MIB groupings zhoneTraceRouteGroup OBJECT-GROUP OBJECTS { zhoneTraceRouteMaxConcurrentRequests, zhoneTraceRouteCtlTargetAddressType, zhoneTraceRouteCtlTargetAddress, zhoneTraceRouteCtlByPassRouteTable, zhoneTraceRouteCtlDataSize, zhoneTraceRouteCtlTimeOut, zhoneTraceRouteCtlProbesPerHop, zhoneTraceRouteCtlPort, zhoneTraceRouteCtlMaxTtl, zhoneTraceRouteCtlDSField, zhoneTraceRouteCtlSourceAddressType, zhoneTraceRouteCtlSourceAddress, zhoneTraceRouteCtlIfIndex, zhoneTraceRouteCtlMiscOptions, zhoneTraceRouteCtlMaxFailures, zhoneTraceRouteCtlDontFragment, zhoneTraceRouteCtlInitialTtl, zhoneTraceRouteCtlFrequency, zhoneTraceRouteCtlStorageType, zhoneTraceRouteCtlAdminStatus, zhoneTraceRouteCtlMaxRows, zhoneTraceRouteCtlTrapGeneration, zhoneTraceRouteCtlDescr, zhoneTraceRouteCtlCreateHopsEntries, zhoneTraceRouteCtlType, zhoneTraceRouteCtlRowStatus, zhoneTraceRouteResultsOperStatus, zhoneTraceRouteResultsCurHopCount, zhoneTraceRouteResultsCurProbeCount, zhoneTraceRouteResultsIpTgtAddrType, zhoneTraceRouteResultsIpTgtAddr, zhoneTraceRouteResultsTestAttempts, zhoneTraceRouteResultsTestSuccesses } STATUS current DESCRIPTION "The group of objects that comprise the remote traceroute operation." ::= { zhoneTraceRouteGroups 1 } zhoneTraceRouteTimeStampGroup OBJECT-GROUP OBJECTS { zhoneTraceRouteResultsLastGoodPath } STATUS current DESCRIPTION "The group of DateAndTime objects." ::= { zhoneTraceRouteGroups 2 } zhoneTraceRouteNotificationsGroup NOTIFICATION-GROUP NOTIFICATIONS { zhoneTraceRoutePathChange, zhoneTraceRouteTestFailed, zhoneTraceRouteTestCompleted } STATUS current DESCRIPTION "The notifications which are required to be supported by implementations of this MIB." ::= { zhoneTraceRouteGroups 3 } zhoneTraceRouteHopsTableGroup OBJECT-GROUP OBJECTS { zhoneTraceRouteHopsIpTgtAddressType, zhoneTraceRouteHopsIpTgtAddress, zhoneTraceRouteHopsMinRtt, zhoneTraceRouteHopsMaxRtt, zhoneTraceRouteHopsAverageRtt, zhoneTraceRouteHopsRttSumOfSquares, zhoneTraceRouteHopsSentProbes, zhoneTraceRouteHopsProbeResponses, zhoneTraceRouteHopsLastGoodProbe } STATUS current DESCRIPTION "The group of objects that comprise the zhoneTraceRouteHopsTable." ::= { zhoneTraceRouteGroups 4 } END