MIBs Depot

ZHONE-DISMAN-TRACEROUTE-MIB

Registered at
1.3.6.1.4.1.5504.4.1.20
Last updated
2000-09-21 00:00
Organization
IETF Distributed Management Working Group
Revisions
2000-09-21 00:00
Namespace
zhone
Source file
ZHONE-DISMAN-TRACEROUTE-MIB
Digest
sha256:2ead8d4afdd888fa56119025872a912d68fe9cc6171213a0bb681c9739e12e7c

Description

The Traceroute MIB (ZHONE-DISMAN-TRACEROUTE-MIB) provides access to the traceroute capability at a remote host.

Contact

Kenneth White International Business Machines Corporation Network Computing Software Division Research Triangle Park, NC, USA E-mail: wkenneth@us.ibm.com

Imports

FromSymbols
IF-MIBInterfaceIndexOrZero
INET-ADDRESS-MIBInetAddress, InetAddressType
SNMP-FRAMEWORK-MIBSnmpAdminString
SNMPv2-CONFMODULE-COMPLIANCE, NOTIFICATION-GROUP, OBJECT-GROUP
SNMPv2-SMIGauge32, Integer32, MODULE-IDENTITY, NOTIFICATION-TYPE, OBJECT-IDENTITY, OBJECT-TYPE, Unsigned32, iso, mib-2
SNMPv2-TCDateAndTime, DisplayString, RowStatus, StorageType, TEXTUAL-CONVENTION, TruthValue
ZHONE-DISMAN-PING-MIBOperationResponseStatus
ZhonezhoneIp

Imported by

Nothing in this corpus imports this module.

Load order

Every file a consumer needs in order to load this module, dependencies first.

IANAifType-MIB
IF-MIB
INET-ADDRESS-MIB
SNMP-FRAMEWORK-MIB
SNMPv2-CONF
SNMPv2-MIB
SNMPv2-SMI
SNMPv2-TC
ZHONE-DISMAN-PING-MIB
ZHONE-DISMAN-TRACEROUTE-MIB
Zhone

Objects

NameOIDSyntaxAccessStatus
zhoneTraceRouteNotifications
OBJECT-IDENTITY
1.3.6.1.4.1.5504.4.1.20.0
zhoneTraceRouteObjects
OBJECT-IDENTITY
1.3.6.1.4.1.5504.4.1.20.1
zhoneTraceRouteMaxConcurrentRequests
OBJECT-TYPE
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.
1.3.6.1.4.1.5504.4.1.20.1.1Unsigned32read-writecurrent
zhoneTraceRouteCtlIndexNext
OBJECT-TYPE
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.
1.3.6.1.4.1.5504.4.1.20.1.2INTEGER (0..2147483647)read-onlycurrent
zhoneTraceRouteCtlTable
OBJECT-TYPE
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.
1.3.6.1.4.1.5504.4.1.20.1.3not-accessiblecurrent
zhoneTraceRouteCtlEntry
OBJECT-TYPE
Defines an entry in the zhoneTraceRouteCtlTable.
1.3.6.1.4.1.5504.4.1.20.1.3.1not-accessiblecurrent
zhoneTraceRouteCtlIndex
OBJECT-TYPE
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.
1.3.6.1.4.1.5504.4.1.20.1.3.1.1INTEGER (0..2147483647)read-onlycurrent
zhoneTraceRouteCtlTargetAddressType
OBJECT-TYPE
Specifies the type of host address to be used on the traceroute request at the remote host.
1.3.6.1.4.1.5504.4.1.20.1.3.1.2InetAddressTyperead-createcurrent
zhoneTraceRouteCtlTargetAddress
OBJECT-TYPE
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.
1.3.6.1.4.1.5504.4.1.20.1.3.1.3InetAddressread-createcurrent
zhoneTraceRouteCtlByPassRouteTable
OBJECT-TYPE
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).
1.3.6.1.4.1.5504.4.1.20.1.3.1.4TruthValueread-createcurrent
zhoneTraceRouteCtlDataSize
OBJECT-TYPE
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.
1.3.6.1.4.1.5504.4.1.20.1.3.1.5Unsigned32 (0..65507)read-createcurrent
zhoneTraceRouteCtlTimeOut
OBJECT-TYPE
Specifies the time-out value, in seconds, for a traceroute request.
1.3.6.1.4.1.5504.4.1.20.1.3.1.6Unsigned32 (1..60)read-createcurrent
zhoneTraceRouteCtlProbesPerHop
OBJECT-TYPE
Specifies the number of times to reissue a traceroute request with the same time-to-live (TTL) value.
1.3.6.1.4.1.5504.4.1.20.1.3.1.7Unsigned32 (1..10)read-createcurrent
zhoneTraceRouteCtlPort
OBJECT-TYPE
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.
1.3.6.1.4.1.5504.4.1.20.1.3.1.8Unsigned32 (1..65535)read-createcurrent
zhoneTraceRouteCtlMaxTtl
OBJECT-TYPE
Specifies the maximum time-to-live value.
1.3.6.1.4.1.5504.4.1.20.1.3.1.9Unsigned32 (1..255)read-createcurrent
zhoneTraceRouteCtlDSField
OBJECT-TYPE
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).
1.3.6.1.4.1.5504.4.1.20.1.3.1.10Unsigned32 (0..255)read-createcurrent
zhoneTraceRouteCtlSourceAddressType
OBJECT-TYPE
Specifies the type of the source address, zhoneTraceRouteCtlSourceAddress, to be used at a remote host when performing a traceroute operation.
1.3.6.1.4.1.5504.4.1.20.1.3.1.11InetAddressTyperead-createcurrent
zhoneTraceRouteCtlSourceAddress
OBJECT-TYPE
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.
1.3.6.1.4.1.5504.4.1.20.1.3.1.12InetAddressread-createcurrent
zhoneTraceRouteCtlIfIndex
OBJECT-TYPE
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.
1.3.6.1.4.1.5504.4.1.20.1.3.1.13InterfaceIndexOrZeroread-createcurrent
zhoneTraceRouteCtlMiscOptions
OBJECT-TYPE
Enables an application to specify implementation dependent options.
1.3.6.1.4.1.5504.4.1.20.1.3.1.14SnmpAdminStringread-createcurrent
zhoneTraceRouteCtlMaxFailures
OBJECT-TYPE
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.
1.3.6.1.4.1.5504.4.1.20.1.3.1.15Unsigned32 (0..255)read-createcurrent
zhoneTraceRouteCtlDontFragment
OBJECT-TYPE
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.
1.3.6.1.4.1.5504.4.1.20.1.3.1.16TruthValueread-createcurrent
zhoneTraceRouteCtlInitialTtl
OBJECT-TYPE
The value of this object specifies the initial TTL value to use. This enables bypassing the initial (often well known) portion of a path.
1.3.6.1.4.1.5504.4.1.20.1.3.1.17Unsigned32 (0..255)read-createcurrent
zhoneTraceRouteCtlFrequency
OBJECT-TYPE
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.
1.3.6.1.4.1.5504.4.1.20.1.3.1.18Unsigned32read-createcurrent
zhoneTraceRouteCtlStorageType
OBJECT-TYPE
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.
1.3.6.1.4.1.5504.4.1.20.1.3.1.19StorageTyperead-createcurrent
zhoneTraceRouteCtlAdminStatus
OBJECT-TYPE
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.
1.3.6.1.4.1.5504.4.1.20.1.3.1.20INTEGER {enabled(1), disabled(2)}read-createcurrent
zhoneTraceRouteCtlDescr
OBJECT-TYPE
The purpose of this object is to provide a descriptive name of the remote traceroute test.
1.3.6.1.4.1.5504.4.1.20.1.3.1.21SnmpAdminStringread-createcurrent
zhoneTraceRouteCtlMaxRows
OBJECT-TYPE
None
1.3.6.1.4.1.5504.4.1.20.1.3.1.22Unsigned32read-createcurrent
zhoneTraceRouteCtlTrapGeneration
OBJECT-TYPE
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.
1.3.6.1.4.1.5504.4.1.20.1.3.1.23Bits {pathChange(0), testFailure(1), testCompletion(2)}read-createcurrent
zhoneTraceRouteCtlCreateHopsEntries
OBJECT-TYPE
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).
1.3.6.1.4.1.5504.4.1.20.1.3.1.24TruthValueread-createcurrent
zhoneTraceRouteCtlType
OBJECT-TYPE
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.
1.3.6.1.4.1.5504.4.1.20.1.3.1.25OBJECT IDENTIFIERread-createcurrent
zhoneTraceRouteCtlRowStatus
OBJECT-TYPE
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.
1.3.6.1.4.1.5504.4.1.20.1.3.1.26RowStatusread-createcurrent
zhoneTraceRouteResultsTable
OBJECT-TYPE
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.
1.3.6.1.4.1.5504.4.1.20.1.4not-accessiblecurrent
zhoneTraceRouteResultsEntry
OBJECT-TYPE
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.
1.3.6.1.4.1.5504.4.1.20.1.4.1not-accessiblecurrent
zhoneTraceRouteResultsOperStatus
OBJECT-TYPE
Reflects the operational state of an zhoneTraceRouteCtlEntry: enabled(1) - Test is active. disabled(2) - Test has stopped.
1.3.6.1.4.1.5504.4.1.20.1.4.1.1INTEGER {enabled(1), disabled(2)}read-onlycurrent
zhoneTraceRouteResultsCurHopCount
OBJECT-TYPE
Reflects the current TTL value (range from 1 to 255) for a remote traceroute operation. Maximum TTL value is determined by zhoneTraceRouteCtlMaxTtl.
1.3.6.1.4.1.5504.4.1.20.1.4.1.2Gauge32read-onlycurrent
zhoneTraceRouteResultsCurProbeCount
OBJECT-TYPE
Reflects the current probe count (1..10) for a remote traceroute operation. The maximum probe count is determined by zhoneTraceRouteCtlProbesPerHop.
1.3.6.1.4.1.5504.4.1.20.1.4.1.3Gauge32read-onlycurrent
zhoneTraceRouteResultsIpTgtAddrType
OBJECT-TYPE
This objects indicates the type of address stored in the corresponding zhoneTraceRouteResultsIpTgtAddr object.
1.3.6.1.4.1.5504.4.1.20.1.4.1.4InetAddressTyperead-onlycurrent
zhoneTraceRouteResultsIpTgtAddr
OBJECT-TYPE
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.
1.3.6.1.4.1.5504.4.1.20.1.4.1.5InetAddressread-onlycurrent
zhoneTraceRouteResultsTestAttempts
OBJECT-TYPE
The current number of attempts to determine a path to a target. The value of this object MUST be started at 0.
1.3.6.1.4.1.5504.4.1.20.1.4.1.6Unsigned32read-onlycurrent
zhoneTraceRouteResultsTestSuccesses
OBJECT-TYPE
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.
1.3.6.1.4.1.5504.4.1.20.1.4.1.7Unsigned32read-onlycurrent
zhoneTraceRouteResultsLastGoodPath
OBJECT-TYPE
The date and time when the last complete path was determined.
1.3.6.1.4.1.5504.4.1.20.1.4.1.8DateAndTimeread-onlycurrent
zhoneTraceRouteHopsTable
OBJECT-TYPE
Defines the Remote Operations Traceroute Hop Table for keeping track of the results of traceroute tests on a per hop basis.
1.3.6.1.4.1.5504.4.1.20.1.5not-accessiblecurrent
zhoneTraceRouteHopsEntry
OBJECT-TYPE
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.
1.3.6.1.4.1.5504.4.1.20.1.5.1not-accessiblecurrent
zhoneTraceRouteHopsHopIndex
OBJECT-TYPE
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.
1.3.6.1.4.1.5504.4.1.20.1.5.1.1Unsigned32not-accessiblecurrent
zhoneTraceRouteHopsIpTgtAddressType
OBJECT-TYPE
This objects indicates the type of address stored in the corresponding zhoneTraceRouteHopsIpTargetAddress object.
1.3.6.1.4.1.5504.4.1.20.1.5.1.2InetAddressTyperead-onlycurrent
zhoneTraceRouteHopsIpTgtAddress
OBJECT-TYPE
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.
1.3.6.1.4.1.5504.4.1.20.1.5.1.3InetAddressread-onlycurrent
zhoneTraceRouteHopsMinRtt
OBJECT-TYPE
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.
1.3.6.1.4.1.5504.4.1.20.1.5.1.4Unsigned32read-onlycurrent
zhoneTraceRouteHopsMaxRtt
OBJECT-TYPE
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.
1.3.6.1.4.1.5504.4.1.20.1.5.1.5Unsigned32read-onlycurrent
zhoneTraceRouteHopsAverageRtt
OBJECT-TYPE
The current average traceroute round-trip-time (RTT) for this hop.
1.3.6.1.4.1.5504.4.1.20.1.5.1.6Unsigned32read-onlycurrent
zhoneTraceRouteHopsRttSumOfSquares
OBJECT-TYPE
This object contains the sum of all traceroute responses received for this hop. Its purpose is to enable standard deviation calculation.
1.3.6.1.4.1.5504.4.1.20.1.5.1.7Unsigned32read-onlycurrent
zhoneTraceRouteHopsSentProbes
OBJECT-TYPE
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.
1.3.6.1.4.1.5504.4.1.20.1.5.1.8Unsigned32read-onlycurrent
zhoneTraceRouteHopsProbeResponses
OBJECT-TYPE
Number of responses received for this hop during this traceroute test. This value of this object should start at 0.
1.3.6.1.4.1.5504.4.1.20.1.5.1.9Unsigned32read-onlycurrent
zhoneTraceRouteHopsLastGoodProbe
OBJECT-TYPE
Date and time was the last response was received for a probe for this hop during this traceroute test.
1.3.6.1.4.1.5504.4.1.20.1.5.1.10DateAndTimeread-onlycurrent
zhoneTraceRouteConformance
OBJECT-IDENTITY
1.3.6.1.4.1.5504.4.1.20.2
zhoneTraceRouteGroups
OBJECT-IDENTITY
1.3.6.1.4.1.5504.4.1.20.2.1
zhoneTraceRouteImplementationTypeDomains
OBJECT-IDENTITY
1.3.6.1.4.1.5504.4.1.20.3
zhoneTraceRouteUsingUdpProbes
OBJECT-IDENTITY
Indicates that an implementation is using UDP probes to perform the traceroute operation.
1.3.6.1.4.1.5504.4.1.20.3.1current

Notifications

NameOIDStatus
zhoneTraceRoutePathChange
NOTIFICATION-TYPE
The path to a target has changed.
1.3.6.1.4.1.5504.4.1.20.0.1current
zhoneTraceRouteTestFailed
NOTIFICATION-TYPE
Could not determine the path to a target.
1.3.6.1.4.1.5504.4.1.20.0.2current
zhoneTraceRouteTestCompleted
NOTIFICATION-TYPE
The path to a target has just been determined.
1.3.6.1.4.1.5504.4.1.20.0.3current

Conformance

NameOIDStatus
zhoneTraceRouteGroup
OBJECT-GROUP
The group of objects that comprise the remote traceroute operation.
1.3.6.1.4.1.5504.4.1.20.2.1.1current
zhoneTraceRouteTimeStampGroup
OBJECT-GROUP
The group of DateAndTime objects.
1.3.6.1.4.1.5504.4.1.20.2.1.2current
zhoneTraceRouteNotificationsGroup
NOTIFICATION-GROUP
The notifications which are required to be supported by implementations of this MIB.
1.3.6.1.4.1.5504.4.1.20.2.1.3current
zhoneTraceRouteHopsTableGroup
OBJECT-GROUP
The group of objects that comprise the zhoneTraceRouteHopsTable.
1.3.6.1.4.1.5504.4.1.20.2.1.4current