1851 lines
68 KiB
Plaintext
1851 lines
68 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 -- RFC3411
|
||
|
InterfaceIndexOrZero -- RFC2863
|
||
|
FROM IF-MIB
|
||
|
InetAddressType, InetAddress
|
||
|
FROM INET-ADDRESS-MIB -- RFC4001
|
||
|
OperationResponseStatus
|
||
|
FROM DISMAN-PING-MIB; -- RFC4560
|
||
|
|
||
|
traceRouteMIB MODULE-IDENTITY
|
||
|
LAST-UPDATED "200606130000Z" -- 13 June 2006
|
||
|
ORGANIZATION "IETF Distributed Management Working Group"
|
||
|
CONTACT-INFO
|
||
|
"Juergen Quittek
|
||
|
|
||
|
NEC Europe Ltd.
|
||
|
Network Laboratories
|
||
|
Kurfuersten-Anlage 36
|
||
|
69115 Heidelberg
|
||
|
Germany
|
||
|
|
||
|
Phone: +49 6221 4342-115
|
||
|
Email: quittek@netlab.nec.de"
|
||
|
DESCRIPTION
|
||
|
"The Traceroute MIB (DISMAN-TRACEROUTE-MIB) provides
|
||
|
access to the traceroute capability at a remote host.
|
||
|
|
||
|
Copyright (C) The Internet Society (2006). This version of
|
||
|
this MIB module is part of RFC 4560; see the RFC itself for
|
||
|
full legal notices."
|
||
|
|
||
|
-- Revision history
|
||
|
|
||
|
REVISION "200606130000Z" -- 13 June 2006
|
||
|
DESCRIPTION
|
||
|
"Updated version, published as RFC 4560.
|
||
|
- Correctly considered IPv6 in DESCRIPTION clause of
|
||
|
object traceRouteCtlDataSize
|
||
|
- Replaced references to RFC 2575 by RFC 3415
|
||
|
- Replaced references to RFC 2571 by RFC 3411
|
||
|
- Replaced references to RFC 2851 by RFC 4001
|
||
|
- Clarified DESCRIPTION clause of object
|
||
|
traceRouteResultsLastGoodPath
|
||
|
- Changed range of object traceRouteCtlInitialTtl
|
||
|
from (0..255) to (1..255)
|
||
|
- Extended DESCRIPTION clause of traceRouteResultsTable
|
||
|
describing re-initialization of entries
|
||
|
- Changed SYNTAX of traceRouteResultsTestAttempts and
|
||
|
traceRouteResultsTestSuccesses from Unsigned32 to
|
||
|
Gauge32
|
||
|
- Changed status of traceRouteCompliance to deprecated
|
||
|
- Added traceRouteFullCompliance and
|
||
|
traceRouteMinimumCompliance
|
||
|
- Changed status of traceRouteGroup and
|
||
|
traceRouteTimeStampGroup to deprecated
|
||
|
- Added traceRouteMinimumGroup,
|
||
|
traceRouteCtlRowStatusGroup, and
|
||
|
traceRouteHistoryGroup
|
||
|
- Changed DEFVAL of object
|
||
|
traceRouteCtlTargetAddressType from { ipv4 }
|
||
|
to { unknown }
|
||
|
- Changed DEFVAL of object traceRouteCtlDescr
|
||
|
from { '00'H } to { ''H }
|
||
|
- Added DEFVAL for object traceRouteCtlTrapGeneration
|
||
|
of DEFVAL { { } }"
|
||
|
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.
|
||
|
|
||
|
The limit applies only to new requests being activated.
|
||
|
When a new value is set, the agent will continue processing
|
||
|
all the requests already active, even if their number
|
||
|
exceeds the limit just imposed."
|
||
|
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 3415, VACM) and that allows a 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,
|
||
|
traceRouteCtlDescr SnmpAdminString,
|
||
|
traceRouteCtlMaxRows Unsigned32,
|
||
|
traceRouteCtlTrapGeneration BITS,
|
||
|
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 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."
|
||
|
::= { 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 a 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 { unknown }
|
||
|
::= { 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
|
||
|
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."
|
||
|
::= { traceRouteCtlEntry 4 }
|
||
|
|
||
|
traceRouteCtlByPassRouteTable OBJECT-TYPE
|
||
|
SYNTAX TruthValue
|
||
|
MAX-ACCESS read-create
|
||
|
STATUS current
|
||
|
DESCRIPTION
|
||
|
"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)."
|
||
|
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. 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)."
|
||
|
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 (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."
|
||
|
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 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.
|
||
|
|
||
|
The octet to be set in the IP header contains the
|
||
|
Differentiated Services (DS) Field in the six most
|
||
|
significant bits.
|
||
|
|
||
|
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. A value of 0
|
||
|
means that the function represented by this option is
|
||
|
not supported. DS Field usage is often not supported
|
||
|
by IP implementations, and not all values are supported.
|
||
|
Refer to RFC 2474 and RFC 3260 for guidance on usage of
|
||
|
this field."
|
||
|
REFERENCE
|
||
|
"Refer to RFC 1812 for the definition of the IPv4 TOS
|
||
|
octet and to RFC 2460 for the definition of the IPv6
|
||
|
Traffic Class octet. Refer to RFC 2474 and RFC 3260
|
||
|
for the definition of the Differentiated Services Field."
|
||
|
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 a traceroute operation is performed."
|
||
|
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 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."
|
||
|
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 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."
|
||
|
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
|
||
|
a manual PATH MTU test is performed."
|
||
|
DEFVAL { false }
|
||
|
::= { traceRouteCtlEntry 17 }
|
||
|
|
||
|
traceRouteCtlInitialTtl OBJECT-TYPE
|
||
|
SYNTAX Unsigned32 (1..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.
|
||
|
|
||
|
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."
|
||
|
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 { ''H }
|
||
|
::= { traceRouteCtlEntry 22 }
|
||
|
|
||
|
traceRouteCtlMaxRows OBJECT-TYPE
|
||
|
SYNTAX Unsigned32
|
||
|
UNITS "rows"
|
||
|
MAX-ACCESS read-create
|
||
|
STATUS current
|
||
|
DESCRIPTION
|
||
|
"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."
|
||
|
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 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."
|
||
|
DEFVAL { { } }
|
||
|
::= { 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 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."
|
||
|
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 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."
|
||
|
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).
|
||
|
|
||
|
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."
|
||
|
::= { 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 so that a traceRouteResultsEntry
|
||
|
corresponds 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 Gauge32,
|
||
|
traceRouteResultsTestSuccesses Gauge32,
|
||
|
traceRouteResultsLastGoodPath DateAndTime
|
||
|
}
|
||
|
|
||
|
traceRouteResultsOperStatus OBJECT-TYPE
|
||
|
SYNTAX INTEGER {
|
||
|
enabled(1), -- test is in progress
|
||
|
disabled(2), -- test has stopped
|
||
|
completed(3) -- test is completed
|
||
|
}
|
||
|
MAX-ACCESS read-only
|
||
|
STATUS current
|
||
|
DESCRIPTION
|
||
|
"Reflects the operational state of an traceRouteCtlEntry:
|
||
|
|
||
|
enabled(1) - Test is active.
|
||
|
disabled(2) - Test has stopped.
|
||
|
completed(3) - Test is completed."
|
||
|
::= { traceRouteResultsEntry 1 }
|
||
|
|
||
|
traceRouteResultsCurHopCount OBJECT-TYPE
|
||
|
SYNTAX Gauge32
|
||
|
UNITS "hops"
|
||
|
MAX-ACCESS read-only
|
||
|
STATUS current
|
||
|
DESCRIPTION
|
||
|
"Reflects the current TTL value (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 object 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 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 name is not specified or
|
||
|
when a specified DNS name fails to resolve."
|
||
|
::= { traceRouteResultsEntry 5 }
|
||
|
|
||
|
traceRouteResultsTestAttempts OBJECT-TYPE
|
||
|
SYNTAX Gauge32
|
||
|
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 Gauge32
|
||
|
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. 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 traceRouteCtlInitialTtl object
|
||
|
up to the end of the path or (if no reply from the
|
||
|
target IP address was received) up to the value of
|
||
|
the corresponding traceRouteCtlMaxTtl object."
|
||
|
::= { 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 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."
|
||
|
::= { 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 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's 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 (1..'ffffffff'h)
|
||
|
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 be given increasing values for
|
||
|
subsequent hops. The value of traceRouteHopsHopIndex is not
|
||
|
necessarily the number of the hop on the traced path.
|
||
|
|
||
|
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 is completed. Care needs to be applied when a path
|
||
|
either 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 object indicates the type of address stored
|
||
|
in the corresponding traceRouteHopsIpTgtAddress
|
||
|
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, not as a DNS name.
|
||
|
|
||
|
The address type (InetAddressType) that relates to
|
||
|
this object is specified by the corresponding value
|
||
|
of pingCtlSourceAddressType."
|
||
|
::= { 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 the squares of all
|
||
|
round-trip-times 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 at which 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
|
||
|
|
||
|
traceRouteFullCompliance MODULE-COMPLIANCE
|
||
|
STATUS current
|
||
|
DESCRIPTION
|
||
|
"The compliance statement for SNMP entities that
|
||
|
fully implement the DISMAN-TRACEROUTE-MIB."
|
||
|
MODULE -- this module
|
||
|
MANDATORY-GROUPS {
|
||
|
traceRouteMinimumGroup,
|
||
|
traceRouteCtlRowStatusGroup,
|
||
|
traceRouteHistoryGroup
|
||
|
}
|
||
|
|
||
|
GROUP traceRouteHopsTableGroup
|
||
|
DESCRIPTION
|
||
|
"This group lists the objects that make up a
|
||
|
traceRouteHopsEntry. Support of the traceRouteHopsTable
|
||
|
is optional."
|
||
|
|
||
|
GROUP traceRouteNotificationsGroup
|
||
|
DESCRIPTION
|
||
|
"This group defines a collection of optional
|
||
|
notifications."
|
||
|
|
||
|
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
|
||
|
"Write access to 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 traceRouteCtlDSField
|
||
|
MIN-ACCESS read-only
|
||
|
DESCRIPTION
|
||
|
"Write access is not required. If 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 traceRouteCtlSourceAddressType
|
||
|
SYNTAX InetAddressType { unknown(0), ipv4(1), ipv6(2) }
|
||
|
MIN-ACCESS read-only
|
||
|
DESCRIPTION
|
||
|
"Write access to 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
|
||
|
"Write access to 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 traceRouteCtlIfIndex
|
||
|
MIN-ACCESS read-only
|
||
|
DESCRIPTION
|
||
|
"Write access is not required. If 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. If 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
|
||
|
that implementations support only the volatile(2)
|
||
|
StorageType enumeration."
|
||
|
|
||
|
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 { unknown(0), ipv4(1), ipv6(2) }
|
||
|
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 traceRouteResultsLastGoodPath
|
||
|
DESCRIPTION
|
||
|
"If the traceRouteHopsTableGroup is implemented, then
|
||
|
this object is mandatory for implementations that have
|
||
|
access to a system clock and that are capable of setting
|
||
|
the values for DateAndTime objects. It is RECOMMENDED
|
||
|
that when this object is not supported its values
|
||
|
be reported as '0000000000000000'H."
|
||
|
|
||
|
OBJECT traceRouteProbeHistoryHAddrType
|
||
|
SYNTAX InetAddressType { unknown(0), ipv4(1), ipv6(2) }
|
||
|
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 traceRouteProbeHistoryTime
|
||
|
DESCRIPTION
|
||
|
"This object is mandatory for implementations that have
|
||
|
access to a system clock and that are capable of setting
|
||
|
the values for DateAndTime objects. It is RECOMMENDED
|
||
|
that when this object is not supported its values
|
||
|
be reported as '0000000000000000'H."
|
||
|
|
||
|
OBJECT traceRouteHopsIpTgtAddressType
|
||
|
SYNTAX InetAddressType { unknown(0), ipv4(1), ipv6(2) }
|
||
|
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."
|
||
|
|
||
|
OBJECT traceRouteHopsLastGoodProbe
|
||
|
DESCRIPTION
|
||
|
"This object is mandatory for implementations that have
|
||
|
access to a system clock and that are capable of setting
|
||
|
the values for DateAndTime objects. It is RECOMMENDED
|
||
|
that when this object is not supported its values
|
||
|
be reported as '0000000000000000'H."
|
||
|
::= { traceRouteCompliances 2 }
|
||
|
|
||
|
traceRouteMinimumCompliance MODULE-COMPLIANCE
|
||
|
STATUS current
|
||
|
DESCRIPTION
|
||
|
"The minimum compliance statement for SNMP entities
|
||
|
which implement the minimal subset of the
|
||
|
DISMAN-TRACEROUTE-MIB. Implementors might choose this
|
||
|
subset for small devices with limited resources."
|
||
|
MODULE -- this module
|
||
|
|
||
|
MANDATORY-GROUPS { traceRouteMinimumGroup }
|
||
|
|
||
|
GROUP traceRouteCtlRowStatusGroup
|
||
|
DESCRIPTION
|
||
|
"A compliant implementation does not have to implement
|
||
|
the traceRouteCtlRowStatusGroup."
|
||
|
|
||
|
GROUP traceRouteHistoryGroup
|
||
|
DESCRIPTION
|
||
|
"A compliant implementation does not have to implement
|
||
|
the traceRouteHistoryGroup."
|
||
|
|
||
|
GROUP traceRouteHopsTableGroup
|
||
|
DESCRIPTION
|
||
|
"This group lists the objects that make up a
|
||
|
traceRouteHopsEntry. Support of the traceRouteHopsTable
|
||
|
is optional."
|
||
|
|
||
|
GROUP traceRouteNotificationsGroup
|
||
|
DESCRIPTION
|
||
|
"This group defines a collection of optional
|
||
|
notifications."
|
||
|
|
||
|
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
|
||
|
"Write access is not required. If write access is
|
||
|
not supported, return a false(2) as the value of this
|
||
|
object. A value of false(2) means that the function
|
||
|
represented by this option is not supported."
|
||
|
|
||
|
OBJECT traceRouteCtlDSField
|
||
|
MIN-ACCESS read-only
|
||
|
DESCRIPTION
|
||
|
"Write access is not required. If 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 traceRouteCtlSourceAddressType
|
||
|
SYNTAX InetAddressType { unknown(0), ipv4(1), ipv6(2) }
|
||
|
MIN-ACCESS read-only
|
||
|
DESCRIPTION
|
||
|
"Write access to 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
|
||
|
"Write access to 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 traceRouteCtlIfIndex
|
||
|
MIN-ACCESS read-only
|
||
|
DESCRIPTION
|
||
|
"Write access is not required. If 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. If not
|
||
|
supporting, do not allow write access, and return a
|
||
|
zero-length octet string as the value of the object."
|
||
|
|
||
|
OBJECT traceRouteCtlDontFragment
|
||
|
MIN-ACCESS read-only
|
||
|
DESCRIPTION
|
||
|
"Write access is not required. If write access is
|
||
|
not supported, return a false(2) as the value of this
|
||
|
object. A value of false(2) means that the function
|
||
|
represented by this option is not supported."
|
||
|
|
||
|
OBJECT traceRouteCtlInitialTtl
|
||
|
MIN-ACCESS read-only
|
||
|
DESCRIPTION
|
||
|
"Write access is not required. If write access is
|
||
|
not supported, return a 1 as the value of this object."
|
||
|
|
||
|
OBJECT traceRouteCtlFrequency
|
||
|
MIN-ACCESS read-only
|
||
|
DESCRIPTION
|
||
|
"Write access is not required. If 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 traceRouteCtlStorageType
|
||
|
MIN-ACCESS read-only
|
||
|
DESCRIPTION
|
||
|
"Write access is not required. It is also allowed
|
||
|
that implementations support only the volatile(2)
|
||
|
StorageType enumeration."
|
||
|
|
||
|
OBJECT traceRouteCtlDescr
|
||
|
MIN-ACCESS read-only
|
||
|
DESCRIPTION
|
||
|
"The agent is not required to support set
|
||
|
operations to this object."
|
||
|
|
||
|
OBJECT traceRouteCtlMaxRows
|
||
|
MIN-ACCESS read-only
|
||
|
DESCRIPTION
|
||
|
"Write access is not required. If the
|
||
|
traceRouteHistoryGroup is not implemented, then write
|
||
|
access to this object MUST be disabled, and the object
|
||
|
MUST return a value of 0 when retrieved."
|
||
|
|
||
|
OBJECT traceRouteCtlTrapGeneration
|
||
|
MIN-ACCESS read-only
|
||
|
DESCRIPTION
|
||
|
"Write access is not required. If the
|
||
|
traceRouteNotificationsGroup is not implemented, then
|
||
|
write access to this object MUST be disabled, and the
|
||
|
object MUST return a value with no bit set when
|
||
|
retrieved. No bit set indicates that no notification
|
||
|
is generated."
|
||
|
|
||
|
OBJECT traceRouteCtlCreateHopsEntries
|
||
|
MIN-ACCESS read-only
|
||
|
DESCRIPTION
|
||
|
"Write access is not required. If the
|
||
|
traceRouteHopsTableGroup is not implemented, then
|
||
|
write access to this object MUST be disabled, and the
|
||
|
object MUST return a value of false(2) when retrieved."
|
||
|
|
||
|
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 { unknown(0), ipv4(1), ipv6(2) }
|
||
|
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 traceRouteResultsLastGoodPath
|
||
|
DESCRIPTION
|
||
|
"This object is mandatory for implementations that have
|
||
|
access to a system clock and that are capable of setting
|
||
|
the values for DateAndTime objects. It is RECOMMENDED
|
||
|
that when this object is not supported its values
|
||
|
be reported as '0000000000000000'H."
|
||
|
|
||
|
OBJECT traceRouteProbeHistoryHAddrType
|
||
|
SYNTAX InetAddressType { unknown(0), ipv4(1), ipv6(2) }
|
||
|
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 traceRouteProbeHistoryTime
|
||
|
DESCRIPTION
|
||
|
"If the traceRouteHistoryGroup is implemented, then
|
||
|
this object is mandatory for implementations that have
|
||
|
access to a system clock and that are capable of setting
|
||
|
the values for DateAndTime objects. It is RECOMMENDED
|
||
|
that when this object is not supported its values
|
||
|
be reported as '0000000000000000'H."
|
||
|
|
||
|
OBJECT traceRouteHopsIpTgtAddressType
|
||
|
SYNTAX InetAddressType { unknown(0), ipv4(1), ipv6(2) }
|
||
|
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."
|
||
|
|
||
|
OBJECT traceRouteHopsLastGoodProbe
|
||
|
DESCRIPTION
|
||
|
"If the traceRouteHopsTableGroup is implemented, then
|
||
|
this object is mandatory for implementations that have
|
||
|
access to a system clock and that are capable of setting
|
||
|
the values for DateAndTime objects. It is RECOMMENDED
|
||
|
that when this object is not supported its values
|
||
|
be reported as '0000000000000000'H."
|
||
|
::= { traceRouteCompliances 3 }
|
||
|
|
||
|
traceRouteCompliance MODULE-COMPLIANCE
|
||
|
STATUS deprecated
|
||
|
DESCRIPTION
|
||
|
"The compliance statement for the DISMAN-TRACEROUTE-MIB.
|
||
|
This compliance statement has been deprecated because
|
||
|
the traceRouteGroup and the traceRouteTimeStampGroup
|
||
|
have been split and deprecated. The
|
||
|
traceRouteFullCompliance is semantically identical to the
|
||
|
deprecated traceRouteCompliance statement."
|
||
|
MODULE -- this module
|
||
|
MANDATORY-GROUPS {
|
||
|
traceRouteGroup
|
||
|
}
|
||
|
GROUP traceRouteTimeStampGroup
|
||
|
DESCRIPTION
|
||
|
"This group is mandatory for implementations that have
|
||
|
access to a system clock and that 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 { unknown(0), ipv4(1), ipv6(2) }
|
||
|
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
|
||
|
that implementations 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 { unknown(0), ipv4(1), ipv6(2) }
|
||
|
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 { unknown(0), ipv4(1), ipv6(2) }
|
||
|
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 { unknown(0), ipv4(1), ipv6(2) }
|
||
|
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
|
||
|
|
||
|
traceRouteMinimumGroup 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,
|
||
|
traceRouteResultsOperStatus,
|
||
|
traceRouteResultsCurHopCount,
|
||
|
traceRouteResultsCurProbeCount,
|
||
|
traceRouteResultsIpTgtAddrType,
|
||
|
traceRouteResultsIpTgtAddr,
|
||
|
traceRouteResultsTestAttempts,
|
||
|
traceRouteResultsTestSuccesses,
|
||
|
traceRouteResultsLastGoodPath
|
||
|
|
||
|
}
|
||
|
STATUS current
|
||
|
DESCRIPTION
|
||
|
"The group of objects that constitute the remote traceroute
|
||
|
operation."
|
||
|
::= { traceRouteGroups 5 }
|
||
|
|
||
|
traceRouteCtlRowStatusGroup OBJECT-GROUP
|
||
|
OBJECTS {
|
||
|
traceRouteCtlRowStatus
|
||
|
}
|
||
|
STATUS current
|
||
|
DESCRIPTION
|
||
|
"The RowStatus object of the traceRouteCtlTable."
|
||
|
::= { traceRouteGroups 6 }
|
||
|
|
||
|
traceRouteHistoryGroup OBJECT-GROUP
|
||
|
OBJECTS {
|
||
|
traceRouteProbeHistoryHAddrType,
|
||
|
traceRouteProbeHistoryHAddr,
|
||
|
traceRouteProbeHistoryResponse,
|
||
|
traceRouteProbeHistoryStatus,
|
||
|
traceRouteProbeHistoryLastRC,
|
||
|
traceRouteProbeHistoryTime
|
||
|
}
|
||
|
STATUS current
|
||
|
DESCRIPTION
|
||
|
"The group of objects that constitute the history
|
||
|
capability."
|
||
|
::= { traceRouteGroups 7 }
|
||
|
|
||
|
traceRouteNotificationsGroup NOTIFICATION-GROUP
|
||
|
NOTIFICATIONS {
|
||
|
traceRoutePathChange,
|
||
|
traceRouteTestFailed,
|
||
|
traceRouteTestCompleted
|
||
|
}
|
||
|
STATUS current
|
||
|
DESCRIPTION
|
||
|
"The notifications that 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 constitute the
|
||
|
traceRouteHopsTable."
|
||
|
::= { traceRouteGroups 4 }
|
||
|
|
||
|
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 deprecated
|
||
|
DESCRIPTION
|
||
|
"The group of objects that constitute the remote traceroute
|
||
|
operation."
|
||
|
::= { traceRouteGroups 1 }
|
||
|
|
||
|
traceRouteTimeStampGroup OBJECT-GROUP
|
||
|
OBJECTS {
|
||
|
traceRouteResultsLastGoodPath,
|
||
|
traceRouteProbeHistoryTime
|
||
|
}
|
||
|
STATUS deprecated
|
||
|
DESCRIPTION
|
||
|
"The group of DateAndTime objects."
|
||
|
::= { traceRouteGroups 2 }
|
||
|
|
||
|
END
|