DISMAN-TRACEROUTE-MIB Table View

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 traceRouteResultsTable, traceRouteProbeHistoryTable, and
the traceRouteHopsTable.

traceRouteCtlEntry row .1.3.6.1.2.1.81.1.2.1

Defines an entry in the traceRouteCtlTable. The first
index element, traceRouteCtlOwnerIndex, is of type
SnmpAdminString, a textual convention that allows for
use of the SNMPv3 View-Based Access Control Model
(RFC 3415…

Indexes

traceRouteCtlOwnerIndex traceRouteCtlTestName

Column	Syntax	OID
traceRouteCtlOwnerIndex To facilitate the provisioning of access control by a security administrator using the View-Based Access Control Model (RFC 3415, VACM) for tables in which multiple users may need to create or modify entries independent…	OctetString Constraints: range: 0-32	.1.3.6.1.2.1.81.1.2.1.1
traceRouteCtlTestName The name of a traceroute test. This is locally unique, within the scope of a traceRouteCtlOwnerIndex.	OctetString Constraints: range: 0-32	.1.3.6.1.2.1.81.1.2.1.2
traceRouteCtlTargetAddressType Specifies the type of host address to be used on the traceroute request at the remote host.	INET-ADDRESS-MIBInetAddressTyper/w Type Values: 0 unknown 1 ipv4 2 ipv6 3 ipv4z 4 ipv6z 16 dns 25 l2vpn	.1.3.6.1.2.1.81.1.2.1.3
traceRouteCtlTargetAddress Specifies the host address used on the traceroute request at the remote host. The host address type can be determined by examining the value of the corresponding traceRouteCtlTargetAddressType. A value f…	INET-ADDRESS-MIBInetAddressr/w Type Constraints: range: 0..255	.1.3.6.1.2.1.81.1.2.1.4
traceRouteCtlByPassRouteTable The purpose of this object is to enable optional 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…	SNMPv2-TCTruthValuer/w Type Values: 1 true 2 false Description: Represents a boolean value.	.1.3.6.1.2.1.81.1.2.1.5
traceRouteCtlDataSize Specifies the size of the data portion of a traceroute request, in octets. If the RECOMMENDED traceroute method (UDP datagrams as probes) is used, then the value contained in this object MUST be applied. If another tr…	octetsUnsigned32r/w Constraints: range: 0-65507	.1.3.6.1.2.1.81.1.2.1.6
traceRouteCtlTimeOut Specifies the time-out value, in seconds, for a traceroute request.	secondsUnsigned32r/w Constraints: range: 1-60	.1.3.6.1.2.1.81.1.2.1.7
traceRouteCtlProbesPerHop Specifies the number of times to reissue a traceroute request with the same time-to-live (TTL) value.	probesUnsigned32r/w Constraints: range: 1-10	.1.3.6.1.2.1.81.1.2.1.8
traceRouteCtlPort Specifies the (initial) UDP port to send the traceroute request to. A port needs to be specified that is not in use at the destination (target) host. The default value for this object is the IANA assigned port, 33434,…	UDP PortUnsigned32r/w Constraints: range: 1-65535	.1.3.6.1.2.1.81.1.2.1.9
traceRouteCtlMaxTtl Specifies the maximum time-to-live value.	time-to-live valueUnsigned32r/w Constraints: range: 1-255	.1.3.6.1.2.1.81.1.2.1.10
traceRouteCtlDSField Specifies the value to store in the Type of Service (TOS) octet in the IPv4 header or in the Traffic Class octet in the IPv6 header, respectively, of the IP packet used to encapsulate the traceroute probe. …	Unsigned32r/w Constraints: range: 0-255	.1.3.6.1.2.1.81.1.2.1.11
traceRouteCtlSourceAddressType Specifies the type of the source address, traceRouteCtlSourceAddress, to be used at a remote host when a traceroute operation is performed.	INET-ADDRESS-MIBInetAddressTyper/w Type Values: 0 unknown 1 ipv4 2 ipv6 3 ipv4z 4 ipv6z 16 dns 25 l2vpn	.1.3.6.1.2.1.81.1.2.1.12
traceRouteCtlSourceAddress 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 select the address …	INET-ADDRESS-MIBInetAddressr/w Type Constraints: range: 0..255	.1.3.6.1.2.1.81.1.2.1.13
traceRouteCtlIfIndex 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 t…	IF-MIBInterfaceIndexOrZeror/w Type Constraints: range: 0..2147483647 Description: This textual convention is an extension of the InterfaceIndex convention. The latter defines a greater than zero value used to identify an interface or interface sub-layer in the managed system. This extension permits…	.1.3.6.1.2.1.81.1.2.1.14
traceRouteCtlMiscOptions Enables an application to specify implementation-dependent options.	SNMP-FRAMEWORK-MIBSnmpAdminStringr/w Type Constraints: range: 0..255	.1.3.6.1.2.1.81.1.2.1.15
traceRouteCtlMaxFailures The value of this object indicates the maximum number of consecutive timeouts allowed before a remote traceroute request is terminated. A value of either 255 (maximum hop count/possible TTL value) or 0 indicates that t…	timeoutsUnsigned32r/w Constraints: range: 0-255	.1.3.6.1.2.1.81.1.2.1.16
traceRouteCtlDontFragment This object enables setting of the don't fragment flag (DF) in the IP header for a probe. Use of this object enables a manual PATH MTU test is performed.	SNMPv2-TCTruthValuer/w Type Values: 1 true 2 false Description: Represents a boolean value.	.1.3.6.1.2.1.81.1.2.1.17
traceRouteCtlInitialTtl The value of this object specifies the initial TTL value to use. This enables bypassing the initial (often well known) portion of a path.	Unsigned32r/w Constraints: range: 1-255	.1.3.6.1.2.1.81.1.2.1.18
traceRouteCtlFrequency The number of seconds to wait before repeating a traceroute test, as defined by the value of the various objects in the corresponding row. After a single test is completed the number of seconds as defined…	secondsSNMPv2-SMIUnsigned32r/w Type Constraints: range: 0..4294967295	.1.3.6.1.2.1.81.1.2.1.19
traceRouteCtlStorageType 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.	SNMPv2-TCStorageTyper/w Type Values: 1 other 2 volatile 3 nonVolatile 4 permanent 5 readOnly Description: Describes the memory realization of a conceptual row. A row which is volatile(2) is lost upon reboot. A row which is either nonVolatile(3), permanent(4) or readOnly(5), is backed up by stable storage. A row which is …	.1.3.6.1.2.1.81.1.2.1.20
traceRouteCtlAdminStatus Reflects the desired state that an traceRouteCtlEntry should be in: enabled(1) - Attempt to activate the test as defined by this traceRouteCtlEntry. disabled(2) - Deactivate the te…	Enumerationr/w Enumerated Values: 1 enabled 2 disabled	.1.3.6.1.2.1.81.1.2.1.21
traceRouteCtlDescr The purpose of this object is to provide a descriptive name of the remote traceroute test.	SNMP-FRAMEWORK-MIBSnmpAdminStringr/w Type Constraints: range: 0..255	.1.3.6.1.2.1.81.1.2.1.22
traceRouteCtlMaxRows The maximum number of corresponding entries allowed in the traceRouteProbeHistoryTable. An implementation of this MIB will remove the oldest corresponding entry in the traceRouteProbeHistoryTable to allow the addition …	rowsSNMPv2-SMIUnsigned32r/w Type Constraints: range: 0..4294967295	.1.3.6.1.2.1.81.1.2.1.23
traceRouteCtlTrapGeneration The value of this object determines when and whether to generate a notification for this entry: pathChange(0) - Generate a traceRoutePathChange notification when the current path varies from a …	Bitsr/w Enumerated Values: 0 pathChange 1 testFailure 2 testCompletion	.1.3.6.1.2.1.81.1.2.1.24
traceRouteCtlCreateHopsEntries The current path for a traceroute test is kept in the traceRouteHopsTable on a per-hop basis when the value of this object is true(1).	SNMPv2-TCTruthValuer/w Type Values: 1 true 2 false Description: Represents a boolean value.	.1.3.6.1.2.1.81.1.2.1.25
traceRouteCtlType The value of this object is used either to report or to select the implementation method to be used for performing a traceroute operation. The value of this object may be selected from traceRouteImplementationTypeDomai…	ObjectIdentifierr/w	.1.3.6.1.2.1.81.1.2.1.26
traceRouteCtlRowStatus This object allows entries to be created and deleted in the traceRouteCtlTable. Deletion of an entry in this table results in a deletion of all corresponding (same traceRouteCtlOwnerIndex and traceRouteCtlTestName inde…	SNMPv2-TCRowStatusr/w Type Values: 1 active 2 notInService 3 notReady 4 createAndGo 5 createAndWait 6 destroy Description: The RowStatus textual convention is used to manage the creation and deletion of conceptual rows, and is used as the value of the SYNTAX clause for the status column of a conceptual row (as described in Section 7.7.1 of …	.1.3.6.1.2.1.81.1.2.1.27

Defines the Remote Operations Traceroute Results Table for
keeping track of the status of a traceRouteCtlEntry.
          
An entry is added to the traceRouteResultsTable when an
traceRouteCtlEntry is started by successful transition
of its traceRouteCtlAdminStatus object to enabled(1).
          
If the object traceRouteCtlAdminStatus already has the value
enabled(1), and if the corresponding
traceRouteResultsOperStatus object has the value
completed(3), then successfully writing enabled(1) to the
object traceRouteCtlAdminStatus re-initializes the already
existing entry in the traceRouteResultsTable.  The values of
objects in the re-initialized entry are the same as
the values of objects in a new entry would be.
          
An entry is removed from the traceRouteResultsTable when
          
its corresponding traceRouteCtlEntry is deleted.

traceRouteResultsEntry row .1.3.6.1.2.1.81.1.3.1

Defines an entry in the traceRouteResultsTable. The
traceRouteResultsTable has the same indexing as the
traceRouteCtlTable so that a traceRouteResultsEntry
corresponds to the traceRouteCtlEntry that caused it to
be cre…

Indexes

traceRouteCtlOwnerIndex traceRouteCtlTestName

Column	Syntax	OID
traceRouteResultsOperStatus Reflects the operational state of an traceRouteCtlEntry: enabled(1) - Test is active. disabled(2) - Test has stopped. completed(3) - Test is completed.	Enumeration Enumerated Values: 1 enabled 2 disabled 3 completed	.1.3.6.1.2.1.81.1.3.1.1
traceRouteResultsCurHopCount Reflects the current TTL value (from 1 to 255) for a remote traceroute operation. Maximum TTL value is determined by traceRouteCtlMaxTtl.	hopsSNMPv2-SMIGauge32 Type Constraints: range: 0..4294967295	.1.3.6.1.2.1.81.1.3.1.2
traceRouteResultsCurProbeCount Reflects the current probe count (1..10) for a remote traceroute operation. The maximum probe count is determined by traceRouteCtlProbesPerHop.	probesSNMPv2-SMIGauge32 Type Constraints: range: 0..4294967295	.1.3.6.1.2.1.81.1.3.1.3
traceRouteResultsIpTgtAddrType This object indicates the type of address stored in the corresponding traceRouteResultsIpTgtAddr object.	INET-ADDRESS-MIBInetAddressType Type Values: 0 unknown 1 ipv4 2 ipv6 3 ipv4z 4 ipv6z 16 dns 25 l2vpn	.1.3.6.1.2.1.81.1.3.1.4
traceRouteResultsIpTgtAddr This object reports the IP address associated with a traceRouteCtlTargetAddress 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 nam…	INET-ADDRESS-MIBInetAddress Type Constraints: range: 0..255	.1.3.6.1.2.1.81.1.3.1.5
traceRouteResultsTestAttempts The current number of attempts to determine a path to a target. The value of this object MUST be started at 0.	testsSNMPv2-SMIGauge32 Type Constraints: range: 0..4294967295	.1.3.6.1.2.1.81.1.3.1.6
traceRouteResultsTestSuccesses 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.	testsSNMPv2-SMIGauge32 Type Constraints: range: 0..4294967295	.1.3.6.1.2.1.81.1.3.1.7
traceRouteResultsLastGoodPath The date and time when the last complete path was determined. A path is complete if responses were received or timeout occurred for each hop on the path; i.e., for each TTL value from the value of the corresponding tra…	SNMPv2-TCDateAndTime Type Constraints: range: 8 range: 11 Description: A date-time specification. field octets contents range ----- ------ -------- ----- 1 1-2 year* 0..65536 2 3 month …	.1.3.6.1.2.1.81.1.3.1.8

Defines the Remote Operations Traceroute Results Table
for storing the results of a traceroute operation.
          
An implementation of this MIB will remove the oldest
          
entry in the traceRouteProbeHistoryTable of the
corresponding entry in the traceRouteCtlTable to allow
the addition of a new entry once the number of rows in
the traceRouteProbeHistoryTable reaches the value specified
by traceRouteCtlMaxRows for the corresponding entry in the
traceRouteCtlTable.

traceRouteProbeHistoryEntry row .1.3.6.1.2.1.81.1.4.1

Defines a table for storing the results of a traceroute
operation. Entries in this table are limited by
the value of the corresponding traceRouteCtlMaxRows
object.

The first two index elements identify the…

Indexes

traceRouteCtlOwnerIndex traceRouteCtlTestName traceRouteProbeHistoryIndex traceRouteProbeHistoryHopIndex traceRouteProbeHistoryProbeIndex

Column	Syntax	OID
traceRouteProbeHistoryIndex An entry in this table is created when the result of a traceroute probe is determined. The initial 2 instance identifier index values identify the traceRouteCtlEntry that a probe result (traceRouteProbeHistoryEntry) be…	Unsigned32 Constraints: range: 1-4294967295	.1.3.6.1.2.1.81.1.4.1.1
traceRouteProbeHistoryHopIndex Indicates which hop in a traceroute path the probe's results are for. The value of this object is initially determined by the value of traceRouteCtlInitialTtl.	Unsigned32 Constraints: range: 1-255	.1.3.6.1.2.1.81.1.4.1.2
traceRouteProbeHistoryProbeIndex Indicates the index of a probe for a particular hop in a traceroute path. The number of probes per hop is determined by the value of the corresponding traceRouteCtlProbesPerHop object.	Unsigned32 Constraints: range: 1-10	.1.3.6.1.2.1.81.1.4.1.3
traceRouteProbeHistoryHAddrType This objects indicates the type of address stored in the corresponding traceRouteProbeHistoryHAddr object.	INET-ADDRESS-MIBInetAddressType Type Values: 0 unknown 1 ipv4 2 ipv6 3 ipv4z 4 ipv6z 16 dns 25 l2vpn	.1.3.6.1.2.1.81.1.4.1.4
traceRouteProbeHistoryHAddr The address of a hop in a traceroute path. This object is not allowed to be a DNS name. The value of the corresponding object, traceRouteProbeHistoryHAddrType, indicates this object's IP address type.	INET-ADDRESS-MIBInetAddress Type Constraints: range: 0..255	.1.3.6.1.2.1.81.1.4.1.5
traceRouteProbeHistoryResponse The amount of time measured in milliseconds from when a probe was sent to when its response was received or when it timed out. The value of this object is reported as 0 when it is not possible to transmit a probe.	millisecondsSNMPv2-SMIUnsigned32 Type Constraints: range: 0..4294967295	.1.3.6.1.2.1.81.1.4.1.6
traceRouteProbeHistoryStatus The result of a traceroute operation made by a remote host for a particular probe.	DISMAN-PING-MIBOperationResponseStatus Type Values: 1 responseReceived 2 unknown 3 internalError 4 requestTimedOut 5 unknownDestinationAddress 6 noRouteToTarget 7 interfaceInactiveToTarget 8 arpFailure 9 maxConcurrentLimitReached 10 unableToResolveDnsName 11 invalidHostAddress	.1.3.6.1.2.1.81.1.4.1.7
traceRouteProbeHistoryLastRC The last implementation-method-specific reply code received. Traceroute is usually implemented by transmitting a series of probe packets with increasing time-to-live values. A probe packet is a UDP datag…	SNMPv2-SMIInteger32 Type Constraints: range: -2147483648..2147483647	.1.3.6.1.2.1.81.1.4.1.8
traceRouteProbeHistoryTime Timestamp for when this probe's results were determined.	SNMPv2-TCDateAndTime Type Constraints: range: 8 range: 11 Description: A date-time specification. field octets contents range ----- ------ -------- ----- 1 1-2 year* 0..65536 2 3 month …	.1.3.6.1.2.1.81.1.4.1.9

Defines the Remote Operations Traceroute Hop Table for
keeping track of the results of traceroute tests on a
per-hop basis.

traceRouteHopsEntry row .1.3.6.1.2.1.81.1.5.1

Defines an entry in the traceRouteHopsTable.
The first two index elements identify the
traceRouteCtlEntry that a traceRouteHopsEntry
belongs to. The third index element,
traceRouteHopsHopIndex, selects a
hop in a trace…

Indexes

traceRouteCtlOwnerIndex traceRouteCtlTestName traceRouteHopsHopIndex

Column	Syntax	OID
traceRouteHopsHopIndex Specifies the hop index for a traceroute hop. Values for this object with respect to the same traceRouteCtlOwnerIndex and traceRouteCtlTestName MUST start at 1 and be given increasing values for subsequent hops. The v…	Unsigned32 Constraints: range: 1-4294967295	.1.3.6.1.2.1.81.1.5.1.1
traceRouteHopsIpTgtAddressType This object indicates the type of address stored in the corresponding traceRouteHopsIpTgtAddress object.	INET-ADDRESS-MIBInetAddressType Type Values: 0 unknown 1 ipv4 2 ipv6 3 ipv4z 4 ipv6z 16 dns 25 l2vpn	.1.3.6.1.2.1.81.1.5.1.2
traceRouteHopsIpTgtAddress This object reports the IP address associated with the hop. A value for this object should be reported as a numeric IP address, not as a DNS name. The address type (InetAddressType) that r…	INET-ADDRESS-MIBInetAddress Type Constraints: range: 0..255	.1.3.6.1.2.1.81.1.5.1.3
traceRouteHopsMinRtt 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.	SNMPv2-SMIUnsigned32 Type Constraints: range: 0..4294967295	.1.3.6.1.2.1.81.1.5.1.4
traceRouteHopsMaxRtt 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.	SNMPv2-SMIUnsigned32 Type Constraints: range: 0..4294967295	.1.3.6.1.2.1.81.1.5.1.5
traceRouteHopsAverageRtt The current average traceroute round-trip-time (RTT) for this hop.	SNMPv2-SMIUnsigned32 Type Constraints: range: 0..4294967295	.1.3.6.1.2.1.81.1.5.1.6
traceRouteHopsRttSumOfSquares This object contains the sum of the squares of all round-trip-times received for this hop. Its purpose is to enable standard deviation calculation.	SNMPv2-SMIUnsigned32 Type Constraints: range: 0..4294967295	.1.3.6.1.2.1.81.1.5.1.7
traceRouteHopsSentProbes 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.	SNMPv2-SMIUnsigned32 Type Constraints: range: 0..4294967295	.1.3.6.1.2.1.81.1.5.1.8
traceRouteHopsProbeResponses Number of responses received for this hop during this traceroute test. This value of this object should start at 0.	SNMPv2-SMIUnsigned32 Type Constraints: range: 0..4294967295	.1.3.6.1.2.1.81.1.5.1.9
traceRouteHopsLastGoodProbe Date and time at which the last response was received for a probe for this hop during this traceroute test.	SNMPv2-TCDateAndTime Type Constraints: range: 8 range: 11 Description: A date-time specification. field octets contents range ----- ------ -------- ----- 1 1-2 year* 0..65536 2 3 month …	.1.3.6.1.2.1.81.1.5.1.10