mirror of
https://github.com/librenms/librenms.git
synced 2024-09-21 10:28:13 +00:00
53a4e91e8c
git-svn-id: http://www.observium.org/svn/observer/trunk@1645 61d68cd4-352d-0410-923a-c4978735b2b8
1317 lines
46 KiB
Plaintext
1317 lines
46 KiB
Plaintext
|
|
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 DISMAN-PING-MIB; -- RFC2925
|
|
|
|
traceRouteMIB 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 (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."
|
|
|
|
::= { mib-2 81 }
|
|
|
|
-- Top level structure of the MIB
|
|
|
|
traceRouteNotifications OBJECT IDENTIFIER ::= { traceRouteMIB 0 }
|
|
traceRouteObjects OBJECT IDENTIFIER
|
|
::= { traceRouteMIB 1 }
|
|
traceRouteConformance OBJECT IDENTIFIER ::= { traceRouteMIB 2 }
|
|
|
|
-- The registration node (point) for traceroute implementation types
|
|
|
|
traceRouteImplementationTypeDomains OBJECT IDENTIFIER
|
|
::= { traceRouteMIB 3 }
|
|
|
|
traceRouteUsingUdpProbes OBJECT-IDENTITY
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Indicates that an implementation is using UDP probes to
|
|
perform the traceroute operation."
|
|
::= { traceRouteImplementationTypeDomains 1 }
|
|
|
|
|
|
-- Simple Object Definitions
|
|
|
|
traceRouteMaxConcurrentRequests 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 }
|
|
::= { traceRouteObjects 1 }
|
|
|
|
|
|
-- Traceroute Control Table
|
|
|
|
traceRouteCtlTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF TraceRouteCtlEntry
|
|
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 traceRouteResultsTable, traceRouteProbeHistoryTable, and
|
|
the traceRouteHopsTable."
|
|
::= { traceRouteObjects 2 }
|
|
|
|
traceRouteCtlEntry OBJECT-TYPE
|
|
SYNTAX TraceRouteCtlEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"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 2575 [11], VACM) and allows an management
|
|
application to identify its entries. The second index,
|
|
traceRouteCtlTestName (also an SnmpAdminString),
|
|
enables the same management application to have
|
|
multiple requests outstanding."
|
|
INDEX {
|
|
traceRouteCtlOwnerIndex,
|
|
traceRouteCtlTestName
|
|
}
|
|
::= { traceRouteCtlTable 1 }
|
|
|
|
TraceRouteCtlEntry ::=
|
|
SEQUENCE {
|
|
traceRouteCtlOwnerIndex SnmpAdminString,
|
|
traceRouteCtlTestName SnmpAdminString,
|
|
traceRouteCtlTargetAddressType InetAddressType,
|
|
traceRouteCtlTargetAddress InetAddress,
|
|
traceRouteCtlByPassRouteTable TruthValue,
|
|
traceRouteCtlDataSize Unsigned32,
|
|
traceRouteCtlTimeOut Unsigned32,
|
|
traceRouteCtlProbesPerHop Unsigned32,
|
|
traceRouteCtlPort Unsigned32,
|
|
traceRouteCtlMaxTtl Unsigned32,
|
|
traceRouteCtlDSField Unsigned32,
|
|
traceRouteCtlSourceAddressType InetAddressType,
|
|
traceRouteCtlSourceAddress InetAddress,
|
|
traceRouteCtlIfIndex InterfaceIndexOrZero,
|
|
traceRouteCtlMiscOptions SnmpAdminString,
|
|
traceRouteCtlMaxFailures Unsigned32,
|
|
traceRouteCtlDontFragment TruthValue,
|
|
traceRouteCtlInitialTtl Unsigned32,
|
|
traceRouteCtlFrequency Unsigned32,
|
|
traceRouteCtlStorageType StorageType,
|
|
traceRouteCtlAdminStatus INTEGER,
|
|
traceRouteCtlMaxRows Unsigned32,
|
|
traceRouteCtlTrapGeneration BITS,
|
|
traceRouteCtlDescr SnmpAdminString,
|
|
traceRouteCtlCreateHopsEntries TruthValue,
|
|
traceRouteCtlType OBJECT IDENTIFIER,
|
|
traceRouteCtlRowStatus RowStatus
|
|
}
|
|
|
|
traceRouteCtlOwnerIndex OBJECT-TYPE
|
|
SYNTAX SnmpAdminString (SIZE(0..32))
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"To facilitate the provisioning of access control by a
|
|
security administrator using the View-Based Access
|
|
Control Model (RFC 2575, VACM) for tables in which
|
|
multiple users may need to independently create or
|
|
modify entries, 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 as 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."
|
|
::= { traceRouteCtlEntry 1 }
|
|
|
|
traceRouteCtlTestName OBJECT-TYPE
|
|
SYNTAX SnmpAdminString (SIZE(0..32))
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The name of a traceroute test. This is locally unique,
|
|
within the scope of an traceRouteCtlOwnerIndex."
|
|
::= { traceRouteCtlEntry 2 }
|
|
|
|
traceRouteCtlTargetAddressType 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 }
|
|
::= { traceRouteCtlEntry 3 }
|
|
|
|
traceRouteCtlTargetAddress 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
|
|
traceRouteCtlTargetAddressType index element.
|
|
|
|
A value for this object MUST be set prior to
|
|
transitioning its corresponding traceRouteCtlEntry to
|
|
active(1) via traceRouteCtlRowStatus."
|
|
::= { traceRouteCtlEntry 4 }
|
|
|
|
traceRouteCtlByPassRouteTable 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 }
|
|
::= { traceRouteCtlEntry 5 }
|
|
|
|
traceRouteCtlDataSize 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 }
|
|
::= { traceRouteCtlEntry 6 }
|
|
|
|
traceRouteCtlTimeOut 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 }
|
|
::= { traceRouteCtlEntry 7 }
|
|
|
|
traceRouteCtlProbesPerHop 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 }
|
|
::= { traceRouteCtlEntry 8 }
|
|
|
|
traceRouteCtlPort 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 }
|
|
::= { traceRouteCtlEntry 9 }
|
|
|
|
traceRouteCtlMaxTtl 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 }
|
|
::= { traceRouteCtlEntry 10 }
|
|
|
|
traceRouteCtlDSField 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 }
|
|
::= { traceRouteCtlEntry 11 }
|
|
|
|
traceRouteCtlSourceAddressType OBJECT-TYPE
|
|
SYNTAX InetAddressType
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Specifies the type of the source address,
|
|
traceRouteCtlSourceAddress, to be used at a remote host
|
|
when performing a traceroute operation."
|
|
DEFVAL { unknown }
|
|
::= { traceRouteCtlEntry 12 }
|
|
|
|
traceRouteCtlSourceAddress 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 traceRouteCtlSourceAddressType."
|
|
DEFVAL { ''H }
|
|
::= { traceRouteCtlEntry 13 }
|
|
|
|
traceRouteCtlIfIndex 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 }
|
|
::= { traceRouteCtlEntry 14 }
|
|
|
|
traceRouteCtlMiscOptions OBJECT-TYPE
|
|
SYNTAX SnmpAdminString
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Enables an application to specify implementation
|
|
dependent options."
|
|
DEFVAL { ''H }
|
|
::= { traceRouteCtlEntry 15 }
|
|
|
|
traceRouteCtlMaxFailures 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 }
|
|
::= { traceRouteCtlEntry 16 }
|
|
|
|
traceRouteCtlDontFragment 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 }
|
|
::= { traceRouteCtlEntry 17 }
|
|
|
|
traceRouteCtlInitialTtl 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 }
|
|
::= { traceRouteCtlEntry 18 }
|
|
|
|
traceRouteCtlFrequency 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
|
|
traceRouteCtlProbesPerHop object. After a
|
|
single test completes 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."
|
|
DEFVAL { 0 }
|
|
::= { traceRouteCtlEntry 19 }
|
|
|
|
traceRouteCtlStorageType 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 }
|
|
::= { traceRouteCtlEntry 20 }
|
|
|
|
traceRouteCtlAdminStatus 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 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."
|
|
DEFVAL { disabled }
|
|
::= { traceRouteCtlEntry 21 }
|
|
|
|
traceRouteCtlDescr 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 { '00'H }
|
|
::= { traceRouteCtlEntry 22 }
|
|
|
|
traceRouteCtlMaxRows OBJECT-TYPE
|
|
SYNTAX Unsigned32
|
|
UNITS "rows"
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The maximum number of entries allowed in the
|
|
traceRouteProbeHistoryTable. An implementation of
|
|
this MIB will remove the oldest entry in the
|
|
traceRouteProbeHistoryTable to allow the addition
|
|
of an new entry once the number of 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."
|
|
DEFVAL { 50 }
|
|
::= { traceRouteCtlEntry 23 }
|
|
|
|
traceRouteCtlTrapGeneration 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 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 zero, indicating
|
|
that none of the above options have been selected."
|
|
::= { traceRouteCtlEntry 24 }
|
|
|
|
traceRouteCtlCreateHopsEntries OBJECT-TYPE
|
|
SYNTAX TruthValue
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"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)."
|
|
DEFVAL { false }
|
|
::= { traceRouteCtlEntry 25 }
|
|
|
|
traceRouteCtlType 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
|
|
traceRouteImplementationTypeDomains.
|
|
|
|
Additional implementation types should be allocated as
|
|
required by implementers of the DISMAN-TRACEROUTE-MIB
|
|
under their enterprise specific registration point and
|
|
not beneath traceRouteImplementationTypeDomains."
|
|
DEFVAL { traceRouteUsingUdpProbes }
|
|
::= { traceRouteCtlEntry 26 }
|
|
|
|
traceRouteCtlRowStatus 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
|
|
traceRouteCtlOwnerIndex and traceRouteCtlTestName
|
|
index values) traceRouteResultsTable,
|
|
traceRouteProbeHistoryTable, and traceRouteHopsTable
|
|
entries being deleted.
|
|
|
|
A value MUST be specified for traceRouteCtlTargetAddress
|
|
prior to a transition to active(1) state being
|
|
accepted.
|
|
|
|
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."
|
|
REFERENCE
|
|
"See definition of RowStatus in RFC 2579, 'Textual
|
|
Conventions for SMIv2.'"
|
|
::= { traceRouteCtlEntry 27 }
|
|
|
|
|
|
-- Traceroute Results Table
|
|
|
|
traceRouteResultsTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF TraceRouteResultsEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"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).
|
|
An entry is removed from the traceRouteResultsTable when
|
|
its corresponding traceRouteCtlEntry is deleted."
|
|
::= { traceRouteObjects 3 }
|
|
traceRouteResultsEntry OBJECT-TYPE
|
|
SYNTAX TraceRouteResultsEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Defines an entry in the traceRouteResultsTable. The
|
|
traceRouteResultsTable has the same indexing as the
|
|
traceRouteCtlTable in order for a traceRouteResultsEntry
|
|
to correspond to the traceRouteCtlEntry that caused it to
|
|
be created."
|
|
INDEX {
|
|
traceRouteCtlOwnerIndex,
|
|
traceRouteCtlTestName
|
|
}
|
|
::= { traceRouteResultsTable 1 }
|
|
|
|
TraceRouteResultsEntry ::=
|
|
SEQUENCE {
|
|
traceRouteResultsOperStatus INTEGER,
|
|
traceRouteResultsCurHopCount Gauge32,
|
|
traceRouteResultsCurProbeCount Gauge32,
|
|
traceRouteResultsIpTgtAddrType InetAddressType,
|
|
traceRouteResultsIpTgtAddr InetAddress,
|
|
traceRouteResultsTestAttempts Unsigned32,
|
|
traceRouteResultsTestSuccesses Unsigned32,
|
|
traceRouteResultsLastGoodPath DateAndTime
|
|
}
|
|
|
|
traceRouteResultsOperStatus 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 traceRouteCtlEntry:
|
|
|
|
enabled(1) - Test is active.
|
|
disabled(2) - Test has stopped."
|
|
::= { traceRouteResultsEntry 1 }
|
|
|
|
traceRouteResultsCurHopCount 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
|
|
traceRouteCtlMaxTtl."
|
|
::= { traceRouteResultsEntry 2 }
|
|
|
|
traceRouteResultsCurProbeCount 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
|
|
traceRouteCtlProbesPerHop."
|
|
::= { traceRouteResultsEntry 3 }
|
|
|
|
traceRouteResultsIpTgtAddrType OBJECT-TYPE
|
|
SYNTAX InetAddressType
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This objects indicates the type of address stored
|
|
in the corresponding traceRouteResultsIpTgtAddr
|
|
object."
|
|
::= { traceRouteResultsEntry 4 }
|
|
|
|
traceRouteResultsIpTgtAddr OBJECT-TYPE
|
|
SYNTAX InetAddress
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This objects 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 name is not specified or
|
|
when a specified DNS name fails to resolve."
|
|
::= { traceRouteResultsEntry 5 }
|
|
|
|
traceRouteResultsTestAttempts 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."
|
|
::= { traceRouteResultsEntry 6 }
|
|
|
|
traceRouteResultsTestSuccesses 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."
|
|
::= { traceRouteResultsEntry 7 }
|
|
|
|
traceRouteResultsLastGoodPath OBJECT-TYPE
|
|
SYNTAX DateAndTime
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The date and time when the last complete path
|
|
was determined."
|
|
::= { traceRouteResultsEntry 8 }
|
|
|
|
-- Trace Route Probe History Table
|
|
|
|
traceRouteProbeHistoryTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF TraceRouteProbeHistoryEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"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 to allow the
|
|
addition of an new entry once the number of rows in
|
|
the traceRouteProbeHistoryTable reaches the value specified
|
|
by traceRouteCtlMaxRows."
|
|
::= { traceRouteObjects 4 }
|
|
|
|
traceRouteProbeHistoryEntry OBJECT-TYPE
|
|
SYNTAX TraceRouteProbeHistoryEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"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
|
|
traceRouteCtlEntry that a traceRouteProbeHistoryEntry
|
|
belongs to. The third index element selects a single
|
|
traceroute operation result. The fourth and fifth indexes
|
|
select the hop and the probe for a particular
|
|
traceroute operation."
|
|
INDEX {
|
|
traceRouteCtlOwnerIndex,
|
|
traceRouteCtlTestName,
|
|
traceRouteProbeHistoryIndex,
|
|
traceRouteProbeHistoryHopIndex,
|
|
traceRouteProbeHistoryProbeIndex
|
|
}
|
|
::= { traceRouteProbeHistoryTable 1 }
|
|
|
|
TraceRouteProbeHistoryEntry ::=
|
|
SEQUENCE {
|
|
traceRouteProbeHistoryIndex Unsigned32,
|
|
traceRouteProbeHistoryHopIndex Unsigned32,
|
|
traceRouteProbeHistoryProbeIndex Unsigned32,
|
|
traceRouteProbeHistoryHAddrType InetAddressType,
|
|
traceRouteProbeHistoryHAddr InetAddress,
|
|
traceRouteProbeHistoryResponse Unsigned32,
|
|
traceRouteProbeHistoryStatus OperationResponseStatus,
|
|
traceRouteProbeHistoryLastRC Integer32,
|
|
traceRouteProbeHistoryTime DateAndTime
|
|
}
|
|
|
|
traceRouteProbeHistoryIndex OBJECT-TYPE
|
|
SYNTAX Unsigned32 (1..'ffffffff'h)
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"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) belongs
|
|
to. An entry is removed from this table when
|
|
its corresponding traceRouteCtlEntry is deleted.
|
|
|
|
An implementation MUST start assigning
|
|
traceRouteProbeHistoryIndex values at 1 and wrap after
|
|
exceeding the maximum possible value as defined by the
|
|
limit of this object ('ffffffff'h)."
|
|
::= { traceRouteProbeHistoryEntry 1 }
|
|
|
|
traceRouteProbeHistoryHopIndex OBJECT-TYPE
|
|
SYNTAX Unsigned32 (1..255)
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Indicates which hop in a traceroute path that the probe's
|
|
results are for. The value of this object is initially
|
|
determined by the value of traceRouteCtlInitialTtl."
|
|
::= { traceRouteProbeHistoryEntry 2 }
|
|
|
|
traceRouteProbeHistoryProbeIndex OBJECT-TYPE
|
|
SYNTAX Unsigned32 (1..10)
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"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."
|
|
::= { traceRouteProbeHistoryEntry 3 }
|
|
|
|
traceRouteProbeHistoryHAddrType OBJECT-TYPE
|
|
SYNTAX InetAddressType
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This objects indicates the type of address stored
|
|
in the corresponding traceRouteProbeHistoryHAddr
|
|
object."
|
|
::= { traceRouteProbeHistoryEntry 4 }
|
|
|
|
traceRouteProbeHistoryHAddr OBJECT-TYPE
|
|
SYNTAX InetAddress
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"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."
|
|
::= { traceRouteProbeHistoryEntry 5 }
|
|
|
|
traceRouteProbeHistoryResponse OBJECT-TYPE
|
|
SYNTAX Unsigned32
|
|
UNITS "milliseconds"
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"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."
|
|
::= { traceRouteProbeHistoryEntry 6 }
|
|
|
|
traceRouteProbeHistoryStatus OBJECT-TYPE
|
|
SYNTAX OperationResponseStatus
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The result of a traceroute operation made by a remote
|
|
host for a particular probe."
|
|
::= { traceRouteProbeHistoryEntry 7 }
|
|
|
|
traceRouteProbeHistoryLastRC OBJECT-TYPE
|
|
SYNTAX Integer32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"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 datagram encapsulated into an IP packet.
|
|
Each hop in a path to the target (destination) host rejects
|
|
the probe packets (probe's TTL too small, ICMP reply) until
|
|
either the maximum TTL is exceeded or the target host is
|
|
received."
|
|
::= { traceRouteProbeHistoryEntry 8 }
|
|
|
|
traceRouteProbeHistoryTime OBJECT-TYPE
|
|
SYNTAX DateAndTime
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Timestamp for when this probe results were determined."
|
|
::= { traceRouteProbeHistoryEntry 9 }
|
|
|
|
-- Traceroute Hop Results Table
|
|
|
|
traceRouteHopsTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF TraceRouteHopsEntry
|
|
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."
|
|
::= { traceRouteObjects 5 }
|
|
|
|
traceRouteHopsEntry OBJECT-TYPE
|
|
SYNTAX TraceRouteHopsEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"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 traceroute path."
|
|
INDEX {
|
|
traceRouteCtlOwnerIndex,
|
|
traceRouteCtlTestName,
|
|
traceRouteHopsHopIndex
|
|
}
|
|
::= { traceRouteHopsTable 1 }
|
|
|
|
TraceRouteHopsEntry ::=
|
|
SEQUENCE {
|
|
traceRouteHopsHopIndex Unsigned32,
|
|
traceRouteHopsIpTgtAddressType InetAddressType,
|
|
traceRouteHopsIpTgtAddress InetAddress,
|
|
traceRouteHopsMinRtt Unsigned32,
|
|
traceRouteHopsMaxRtt Unsigned32,
|
|
traceRouteHopsAverageRtt Unsigned32,
|
|
traceRouteHopsRttSumOfSquares Unsigned32,
|
|
traceRouteHopsSentProbes Unsigned32,
|
|
traceRouteHopsProbeResponses Unsigned32,
|
|
traceRouteHopsLastGoodProbe DateAndTime
|
|
}
|
|
|
|
traceRouteHopsHopIndex 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
|
|
traceRouteCtlOwnerIndex and traceRouteCtlTestName
|
|
MUST start at 1 and increase monotonically.
|
|
|
|
The traceRouteHopsTable keeps the current traceroute
|
|
path per traceRouteCtlEntry if enabled by
|
|
setting the corresponding traceRouteCtlCreateHopsEntries
|
|
to true(1).
|
|
|
|
All hops (traceRouteHopsTable 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 traceRouteHopsHopIndex values. The remaining portion
|
|
of the path SHOULD be assigned new traceRouteHopsHopIndex
|
|
values."
|
|
::= { traceRouteHopsEntry 1 }
|
|
|
|
traceRouteHopsIpTgtAddressType OBJECT-TYPE
|
|
SYNTAX InetAddressType
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This objects indicates the type of address stored
|
|
in the corresponding traceRouteHopsIpTargetAddress
|
|
object."
|
|
::= { traceRouteHopsEntry 2 }
|
|
|
|
traceRouteHopsIpTgtAddress 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."
|
|
::= { traceRouteHopsEntry 3 }
|
|
|
|
traceRouteHopsMinRtt 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."
|
|
::= { traceRouteHopsEntry 4 }
|
|
|
|
traceRouteHopsMaxRtt 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."
|
|
::= { traceRouteHopsEntry 5 }
|
|
|
|
traceRouteHopsAverageRtt OBJECT-TYPE
|
|
SYNTAX Unsigned32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The current average traceroute round-trip-time (RTT) for
|
|
this hop."
|
|
::= { traceRouteHopsEntry 6 }
|
|
|
|
traceRouteHopsRttSumOfSquares 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."
|
|
::= { traceRouteHopsEntry 7 }
|
|
|
|
traceRouteHopsSentProbes 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."
|
|
::= { traceRouteHopsEntry 8 }
|
|
|
|
traceRouteHopsProbeResponses 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."
|
|
::= { traceRouteHopsEntry 9 }
|
|
|
|
traceRouteHopsLastGoodProbe 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."
|
|
::= { traceRouteHopsEntry 10 }
|
|
|
|
-- Notification Definition section
|
|
|
|
traceRoutePathChange NOTIFICATION-TYPE
|
|
OBJECTS {
|
|
traceRouteCtlTargetAddressType,
|
|
traceRouteCtlTargetAddress,
|
|
traceRouteResultsIpTgtAddrType,
|
|
traceRouteResultsIpTgtAddr
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The path to a target has changed."
|
|
::= { traceRouteNotifications 1 }
|
|
|
|
traceRouteTestFailed NOTIFICATION-TYPE
|
|
OBJECTS {
|
|
traceRouteCtlTargetAddressType,
|
|
traceRouteCtlTargetAddress,
|
|
traceRouteResultsIpTgtAddrType,
|
|
traceRouteResultsIpTgtAddr
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Could not determine the path to a target."
|
|
::= { traceRouteNotifications 2 }
|
|
|
|
traceRouteTestCompleted NOTIFICATION-TYPE
|
|
OBJECTS {
|
|
traceRouteCtlTargetAddressType,
|
|
traceRouteCtlTargetAddress,
|
|
traceRouteResultsIpTgtAddrType,
|
|
traceRouteResultsIpTgtAddr
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The path to a target has just been determined."
|
|
::= { traceRouteNotifications 3 }
|
|
|
|
-- Conformance information
|
|
-- Compliance statements
|
|
|
|
traceRouteCompliances OBJECT IDENTIFIER ::= { traceRouteConformance 1 }
|
|
traceRouteGroups OBJECT IDENTIFIER ::= { traceRouteConformance 2 }
|
|
|
|
-- Compliance statements
|
|
|
|
traceRouteCompliance MODULE-COMPLIANCE
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The compliance statement for the DISMAN-TRACEROUTE-MIB."
|
|
MODULE -- this module
|
|
MANDATORY-GROUPS {
|
|
traceRouteGroup
|
|
}
|
|
GROUP traceRouteTimeStampGroup
|
|
DESCRIPTION
|
|
"This group is mandatory for implementations that have
|
|
access to a system clock and are capable of setting
|
|
the values for DateAndTime objects."
|
|
|
|
GROUP traceRouteNotificationsGroup
|
|
DESCRIPTION
|
|
"This group defines a collection of optional
|
|
notifications."
|
|
|
|
GROUP traceRouteHopsTableGroup
|
|
DESCRIPTION
|
|
"This group lists the objects that make up a
|
|
traceRouteHopsEntry. Support of the traceRouteHopsTable
|
|
is optional."
|
|
|
|
OBJECT traceRouteMaxConcurrentRequests
|
|
MIN-ACCESS read-only
|
|
DESCRIPTION
|
|
"The agent is not required to support SET
|
|
operations to this object."
|
|
|
|
OBJECT traceRouteCtlByPassRouteTable
|
|
MIN-ACCESS read-only
|
|
DESCRIPTION
|
|
"This object is not required by implementations that
|
|
are not capable of its implementation. The function
|
|
represented by this object is implementable if the
|
|
setsockopt SOL_SOCKET SO_DONTROUTE option is
|
|
supported."
|
|
|
|
OBJECT traceRouteCtlSourceAddressType
|
|
SYNTAX InetAddressType
|
|
MIN-ACCESS read-only
|
|
DESCRIPTION
|
|
"This object is not required by implementations that
|
|
are not capable of binding the send socket with a
|
|
source address. An implementation is only required to
|
|
support IPv4 and IPv6 addresses."
|
|
|
|
OBJECT traceRouteCtlSourceAddress
|
|
SYNTAX InetAddress (SIZE(0|4|16))
|
|
MIN-ACCESS read-only
|
|
DESCRIPTION
|
|
"This object is not required by implementations that
|
|
are not capable of binding the send socket with a
|
|
source address. An implementation is only required to
|
|
support IPv4 and globally unique IPv6 addresses."
|
|
|
|
OBJECT traceRouteCtlIfIndex
|
|
MIN-ACCESS read-only
|
|
DESCRIPTION
|
|
"Write access is not required. When write access is
|
|
not supported return a 0 as the value of this object.
|
|
A value of 0 implies that the function represented by
|
|
this option is not supported."
|
|
|
|
OBJECT traceRouteCtlMiscOptions
|
|
MIN-ACCESS read-only
|
|
DESCRIPTION
|
|
"Support of this object is optional. When not
|
|
supporting do not allow write access and return a
|
|
zero length octet string as the value of the object."
|
|
|
|
OBJECT traceRouteCtlStorageType
|
|
MIN-ACCESS read-only
|
|
DESCRIPTION
|
|
"Write access is not required. It is also allowed
|
|
for implementations to support only the volatile
|
|
StorageType enumeration."
|
|
|
|
OBJECT traceRouteCtlDSField
|
|
MIN-ACCESS read-only
|
|
DESCRIPTION
|
|
"Write access is not required. When write access is
|
|
not supported return a 0 as the value of this object.
|
|
A value of 0 implies that the function represented by
|
|
this option is not supported."
|
|
|
|
OBJECT traceRouteCtlType
|
|
MIN-ACCESS read-only
|
|
DESCRIPTION
|
|
"Write access is not required. In addition, the only
|
|
value that is RECOMMENDED to be supported by an
|
|
implementation is traceRouteUsingUdpProbes."
|
|
|
|
OBJECT traceRouteResultsIpTgtAddrType
|
|
SYNTAX InetAddressType
|
|
DESCRIPTION
|
|
"An implementation should only support IPv4 and
|
|
globally unique IPv6 address values for this object."
|
|
|
|
OBJECT traceRouteResultsIpTgtAddr
|
|
SYNTAX InetAddress (SIZE(0|4|16))
|
|
DESCRIPTION
|
|
"An implementation should only support IPv4 and
|
|
globally unique IPv6 address values for this object."
|
|
|
|
OBJECT traceRouteProbeHistoryHAddrType
|
|
SYNTAX InetAddressType
|
|
DESCRIPTION
|
|
"An implementation should only support IPv4 and
|
|
globally unique IPv6 address values for this object."
|
|
OBJECT traceRouteProbeHistoryHAddr
|
|
SYNTAX InetAddress (SIZE(0|4|16))
|
|
DESCRIPTION
|
|
"An implementation should only support IPv4 and
|
|
globally unique IPv6 address values for this object."
|
|
|
|
OBJECT traceRouteHopsIpTgtAddressType
|
|
SYNTAX InetAddressType
|
|
DESCRIPTION
|
|
"An implementation should only support IPv4 and
|
|
globally unique IPv6 address values for this object."
|
|
|
|
OBJECT traceRouteHopsIpTgtAddress
|
|
SYNTAX InetAddress (SIZE(0|4|16))
|
|
DESCRIPTION
|
|
"An implementation should only support IPv4 and
|
|
globally unique IPv6 address values for this object."
|
|
::= { traceRouteCompliances 1 }
|
|
|
|
-- MIB groupings
|
|
|
|
traceRouteGroup OBJECT-GROUP
|
|
OBJECTS {
|
|
traceRouteMaxConcurrentRequests,
|
|
traceRouteCtlTargetAddressType,
|
|
traceRouteCtlTargetAddress,
|
|
traceRouteCtlByPassRouteTable,
|
|
traceRouteCtlDataSize,
|
|
traceRouteCtlTimeOut,
|
|
traceRouteCtlProbesPerHop,
|
|
traceRouteCtlPort,
|
|
traceRouteCtlMaxTtl,
|
|
traceRouteCtlDSField,
|
|
traceRouteCtlSourceAddressType,
|
|
traceRouteCtlSourceAddress,
|
|
traceRouteCtlIfIndex,
|
|
traceRouteCtlMiscOptions,
|
|
traceRouteCtlMaxFailures,
|
|
traceRouteCtlDontFragment,
|
|
traceRouteCtlInitialTtl,
|
|
traceRouteCtlFrequency,
|
|
traceRouteCtlStorageType,
|
|
traceRouteCtlAdminStatus,
|
|
traceRouteCtlMaxRows,
|
|
traceRouteCtlTrapGeneration,
|
|
traceRouteCtlDescr,
|
|
traceRouteCtlCreateHopsEntries,
|
|
traceRouteCtlType,
|
|
traceRouteCtlRowStatus,
|
|
traceRouteResultsOperStatus,
|
|
traceRouteResultsCurHopCount,
|
|
traceRouteResultsCurProbeCount,
|
|
traceRouteResultsIpTgtAddrType,
|
|
traceRouteResultsIpTgtAddr,
|
|
traceRouteResultsTestAttempts,
|
|
traceRouteResultsTestSuccesses,
|
|
traceRouteProbeHistoryHAddrType,
|
|
traceRouteProbeHistoryHAddr,
|
|
traceRouteProbeHistoryResponse,
|
|
traceRouteProbeHistoryStatus,
|
|
traceRouteProbeHistoryLastRC
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The group of objects that comprise the remote traceroute
|
|
operation."
|
|
::= { traceRouteGroups 1 }
|
|
|
|
traceRouteTimeStampGroup OBJECT-GROUP
|
|
OBJECTS {
|
|
traceRouteResultsLastGoodPath,
|
|
traceRouteProbeHistoryTime
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The group of DateAndTime objects."
|
|
::= { traceRouteGroups 2 }
|
|
|
|
traceRouteNotificationsGroup NOTIFICATION-GROUP
|
|
NOTIFICATIONS {
|
|
traceRoutePathChange,
|
|
traceRouteTestFailed,
|
|
traceRouteTestCompleted
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The notifications which are required to be supported by
|
|
implementations of this MIB."
|
|
::= { traceRouteGroups 3 }
|
|
|
|
traceRouteHopsTableGroup OBJECT-GROUP
|
|
OBJECTS {
|
|
traceRouteHopsIpTgtAddressType,
|
|
traceRouteHopsIpTgtAddress,
|
|
traceRouteHopsMinRtt,
|
|
traceRouteHopsMaxRtt,
|
|
traceRouteHopsAverageRtt,
|
|
traceRouteHopsRttSumOfSquares,
|
|
traceRouteHopsSentProbes,
|
|
traceRouteHopsProbeResponses,
|
|
traceRouteHopsLastGoodProbe
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The group of objects that comprise the traceRouteHopsTable."
|
|
::= { traceRouteGroups 4 }
|
|
|
|
END
|