DISMAN-TRACEROUTE-MIB.txt
上传用户:wxp200602
上传日期:2007-10-30
资源大小:4028k
文件大小:47k
源码类别:
SNMP编程
开发平台:
Unix_Linux
- 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 { 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
- 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 { 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
- 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