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 }