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.
The indexes of the table are traceRouteCtlOwnerIndex, traceRouteCtlTestName.
|
OID |
Object |
Syntax |
Max Access |
Description |
Implemented Specifications |
|---|---|---|---|---|---|
|
1.3.6.1.2.1.81.1.2.1.1 |
traceRouteCtlOwnerIndex |
OCTET STRING{(0,32)} |
not-accessible |
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 independently, the initial index is used as an 'owner index'. Such an initial index has a syntax of SnmpAdminString and can thus be trivially mapped to a securityName or groupName defined in VACM, in accordance with a security policy. 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. To configure VACM to permit access to this portion of the table, one would create vacmViewTreeFamilyTable entries with the value of vacmViewTreeFamilySubtree including the owner index portion, and vacmViewTreeFamilyMask 'wildcarding' the column subidentifier. More elaborate configurations are possible. |
This object is implemented as defined in the corresponding MIB files. |
|
1.3.6.1.2.1.81.1.2.1.2 |
traceRouteCtlTestName |
OCTET STRING{(0,32)} |
not-accessible |
The name of a traceroute test. This is locally unique, within the scope of a traceRouteCtlOwnerIndex. |
This object is implemented as defined in the corresponding MIB files. |
|
1.3.6.1.2.1.81.1.2.1.3 |
traceRouteCtlTargetAddressType |
INTEGER{unknown(0),ipv4(1),ipv6(2),ipv4z(3),ipv6z(4),dns(16)} |
read-create |
Specifies the type of host address to be used on the traceroute request at the remote host. |
Support IPv4,IPv6 and Dns. |
|
1.3.6.1.2.1.81.1.2.1.4 |
traceRouteCtlTargetAddress |
OCTET STRING{(0,255)} |
read-create |
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 for this object MUST be set prior to transitioning its corresponding traceRouteCtlEntry to active(1) via traceRouteCtlRowStatus. |
Support IPv4,IPv6 and Dns. |
|
1.3.6.1.2.1.81.1.2.1.5 |
traceRouteCtlByPassRouteTable |
INTEGER{true(1),false(2)} |
read-create |
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 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 the routing daemon at the host). |
This object is implemented as defined in the corresponding MIB files. |
|
1.3.6.1.2.1.81.1.2.1.6 |
traceRouteCtlDataSize |
Unsigned32{(0,65507)} |
read-create |
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 traceroute method is used for which the specified size is not appropriate, then the implementation SHOULD use whatever size (appropriate to the method) is closest to the specified size. The maximum value for this object was computed by subtracting the smallest possible IP header size of 20 octets (IPv4 header with no options) and the UDP header size of 8 octets from the maximum IP packet size. An IP packet has a maximum size of 65535 octets (excluding IPv6 Jumbograms). |
The actually supported value range is 0-8100. |
|
1.3.6.1.2.1.81.1.2.1.7 |
traceRouteCtlTimeOut |
Unsigned32{(1,60)} |
read-create |
Specifies the time-out value, in seconds, for a traceroute request. |
This object is implemented as defined in the corresponding MIB files. |
|
1.3.6.1.2.1.81.1.2.1.8 |
traceRouteCtlProbesPerHop |
Unsigned32{(1,10)} |
read-create |
Specifies the number of times to reissue a traceroute request with the same time-to-live (TTL) value. |
This object is implemented as defined in the corresponding MIB files. |
|
1.3.6.1.2.1.81.1.2.1.9 |
traceRouteCtlPort |
Unsigned32{(1,65535)} |
read-create |
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, for the traceroute function. |
The actually supported value range is 1-50000. |
|
1.3.6.1.2.1.81.1.2.1.10 |
traceRouteCtlMaxTtl |
Unsigned32{(1,255)} |
read-create |
Specifies the maximum time-to-live value. |
This object is implemented as defined in the corresponding MIB files. |
|
1.3.6.1.2.1.81.1.2.1.12 |
traceRouteCtlSourceAddressType |
INTEGER{unknown(0),ipv4(1),ipv6(2),ipv4z(3),ipv6z(4),dns(16)} |
read-create |
Specifies the type of the source address, traceRouteCtlSourceAddress, to be used at a remote host when a traceroute operation is performed. |
The default value is IPv4;only support IPv4. |
|
1.3.6.1.2.1.81.1.2.1.13 |
traceRouteCtlSourceAddress |
OCTET STRING{(0,255)} |
read-create |
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 to be used. 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 traceRouteCtlSourceAddressType. |
Only support IPv4;Size list:1.0.0.0~223.255.255.255. |
|
1.3.6.1.2.1.81.1.2.1.16 |
traceRouteCtlMaxFailures |
Unsigned32{(0,255)} |
read-create |
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 the function of terminating a remote traceroute request when a specific number of consecutive timeouts are detected is disabled. |
The min value is 1 |
|
1.3.6.1.2.1.81.1.2.1.17 |
traceRouteCtlDontFragment |
INTEGER{true(1),false(2)} |
read-create |
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. |
This object is implemented as defined in the corresponding MIB files. |
|
1.3.6.1.2.1.81.1.2.1.18 |
traceRouteCtlInitialTtl |
Unsigned32{(1,255)} |
read-create |
The value of this object specifies the initial TTL value to use. This enables bypassing the initial (often well known) portion of a path. |
This object is implemented as defined in the corresponding MIB files. |
|
1.3.6.1.2.1.81.1.2.1.19 |
traceRouteCtlFrequency |
Unsigned32 |
read-create |
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 by the value of traceRouteCtlFrequency 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. |
The actually supported value range is 0-604800. |
|
1.3.6.1.2.1.81.1.2.1.20 |
traceRouteCtlStorageType |
INTEGER{other(1),volatile(2),nonVolatile(3),permanent(4),readOnly(5)} |
read-create |
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. |
This object is implemented as defined in the corresponding MIB files. |
|
1.3.6.1.2.1.81.1.2.1.21 |
traceRouteCtlAdminStatus |
INTEGER{enabled(1),disabled(2)} |
read-create |
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 test as defined by this traceRouteCtlEntry. Refer to the corresponding traceRouteResultsOperStatus to determine the operational state of the test defined by this entry. |
This object is implemented as defined in the corresponding MIB files. |
|
1.3.6.1.2.1.81.1.2.1.22 |
traceRouteCtlDescr |
OCTET STRING{(0,255)} |
read-create |
The purpose of this object is to provide a descriptive name of the remote traceroute test. |
The default value is NULL;The length of string:0 to 230 |
|
1.3.6.1.2.1.81.1.2.1.23 |
traceRouteCtlMaxRows |
Unsigned32 |
read-create |
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 of an new entry once the number of corresponding rows in the traceRouteProbeHistoryTable reaches this value. Old entries are not removed when a new test is started. Entries are added to the traceRouteProbeHistoryTable until traceRouteCtlMaxRows is reached before entries begin to be removed. A value of 0 for this object disables creation of traceRouteProbeHistoryTable entries. |
The actually supported value range is 1-1000. |
|
1.3.6.1.2.1.81.1.2.1.24 |
traceRouteCtlTrapGeneration |
BITS{pathChange(0),testFailure(1),testCompletion(2)} |
read-create |
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 previously determined path. testFailure(1) - Generate a traceRouteTestFailed notification when the full path to a target can't be determined. testCompletion(2) - Generate a traceRouteTestCompleted notification when the path to a target has been determined. The value of this object defaults to an empty set, indicating that none of the above options has been selected. |
Don't support the trap when The path to a target has changed. |
|
1.3.6.1.2.1.81.1.2.1.25 |
traceRouteCtlCreateHopsEntries |
INTEGER{true(1),false(2)} |
read-create |
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). |
This object is implemented as defined in the corresponding MIB files. |
|
1.3.6.1.2.1.81.1.2.1.26 |
traceRouteCtlType |
OBJECT IDENTIFIER |
read-create |
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 traceRouteImplementationTypeDomains. Additional implementation types should be allocated as required by implementers of the DISMAN-TRACEROUTE-MIB under their enterprise specific registration point, not beneath traceRouteImplementationTypeDomains. |
This object is implemented as defined in the corresponding MIB files. |
|
1.3.6.1.2.1.81.1.2.1.27 |
traceRouteCtlRowStatus |
INTEGER{active(1),notInService(2),notReady(3),createAndGo(4),createAndWait(5),destroy(6)} |
read-create |
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 index values) traceRouteResultsTable, traceRouteProbeHistoryTable, and traceRouteHopsTable entries. A value MUST be specified for traceRouteCtlTargetAddress prior to acceptance of a transition to active(1) state. When a value for pingCtlTargetAddress is set, the value of object pingCtlRowStatus changes from notReady(3) to notInService(2). Activation of a remote traceroute operation is controlled via traceRouteCtlAdminStatus, 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 traceRouteResultsOperStatus 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 traceRouteResultsOperStatus object. |
This object is implemented as defined in the corresponding MIB files. |