home *** CD-ROM | disk | FTP | other *** search
/ Thomson (Residential) / TGSTPv7203.iso / mac / SNMP_MIBs / extended / DISMAN-TRACEROUTE-MIB.mib < prev    next >
Text File  |  2008-02-08  |  48KB  |  1,336 lines
  1. DISMAN-TRACEROUTE-MIB DEFINITIONS ::= BEGIN
  2.  
  3.  
  4. IMPORTS
  5.     MODULE-IDENTITY, OBJECT-TYPE, Integer32,
  6.     Gauge32, Unsigned32, mib-2,
  7.     NOTIFICATION-TYPE,
  8.     OBJECT-IDENTITY
  9.         FROM SNMPv2-SMI                  -- RFC2578
  10.     RowStatus, StorageType,
  11.     TruthValue, DateAndTime
  12.         FROM SNMPv2-TC                   -- RFC2579
  13.     MODULE-COMPLIANCE, OBJECT-GROUP,
  14.     NOTIFICATION-GROUP
  15.         FROM SNMPv2-CONF                 -- RFC2580
  16.     SnmpAdminString
  17.         FROM SNMP-FRAMEWORK-MIB          -- RFC2571
  18.     InterfaceIndexOrZero                 -- RFC2863
  19.         FROM IF-MIB
  20.     InetAddressType, InetAddress
  21.         FROM INET-ADDRESS-MIB            -- RFC2851
  22.     OperationResponseStatus
  23.         FROM DISMAN-PING-MIB;            -- RFC2925
  24.  
  25.  traceRouteMIB MODULE-IDENTITY
  26.     LAST-UPDATED "200009210000Z"         -- 21 September 2000
  27.  
  28.     ORGANIZATION "IETF Distributed Management Working Group"
  29.     CONTACT-INFO
  30.         "Kenneth White
  31.  
  32.         International Business Machines Corporation
  33.         Network Computing Software Division
  34.         Research Triangle Park, NC, USA
  35.  
  36.         E-mail: wkenneth@us.ibm.com"
  37.     DESCRIPTION
  38.         "The Traceroute MIB (DISMAN-TRACEROUTE-MIB) provides
  39.         access to the traceroute capability at a remote host."
  40.  
  41.      --  Revision history
  42.  
  43.      REVISION     "200009210000Z"         -- 21 September 2000
  44.      DESCRIPTION
  45.          "Initial version, published as RFC 2925."
  46.  
  47.     ::= { mib-2 81 }
  48.  
  49.  -- Top level structure of the MIB
  50.  
  51.  traceRouteNotifications  OBJECT IDENTIFIER ::= { traceRouteMIB 0 }
  52.  traceRouteObjects        OBJECT IDENTIFIER ::= { traceRouteMIB 1 }
  53.  traceRouteConformance    OBJECT IDENTIFIER ::= { traceRouteMIB 2 }
  54.  
  55.  -- The registration node (point) for traceroute implementation types
  56.  
  57.  traceRouteImplementationTypeDomains OBJECT IDENTIFIER
  58.  ::= { traceRouteMIB 3 }
  59.  
  60.  traceRouteUsingUdpProbes OBJECT-IDENTITY
  61.     STATUS      current
  62.     DESCRIPTION
  63.         "Indicates that an implementation is using UDP probes to
  64.         perform the traceroute operation."
  65.     ::= { traceRouteImplementationTypeDomains 1 }
  66.  
  67.  -- Simple Object Definitions
  68.  
  69.  traceRouteMaxConcurrentRequests OBJECT-TYPE
  70.     SYNTAX      Unsigned32
  71.     UNITS       "requests"
  72.     MAX-ACCESS  read-write
  73.     STATUS      current
  74.     DESCRIPTION
  75.        "The maximum number of concurrent active traceroute requests
  76.        that are allowed within an agent implementation.  A value
  77.        of 0 for this object implies that there is no limit for
  78.        the number of concurrent active requests in effect."
  79.     DEFVAL { 10 }
  80.     ::= { traceRouteObjects 1 }
  81.  
  82.   -- Traceroute Control Table
  83.  
  84.  traceRouteCtlTable OBJECT-TYPE
  85.     SYNTAX      SEQUENCE OF TraceRouteCtlEntry
  86.     MAX-ACCESS  not-accessible
  87.     STATUS      current
  88.     DESCRIPTION
  89.         "Defines the Remote Operations Traceroute Control Table for
  90.         providing the capability of invoking traceroute from a remote
  91.         host.  The results of traceroute operations can be stored in
  92.         the traceRouteResultsTable, traceRouteProbeHistoryTable, and
  93.         the traceRouteHopsTable."
  94.    ::= { traceRouteObjects 2 }
  95.  
  96.  traceRouteCtlEntry OBJECT-TYPE
  97.     SYNTAX      TraceRouteCtlEntry
  98.     MAX-ACCESS  not-accessible
  99.     STATUS      current
  100.     DESCRIPTION
  101.         "Defines an entry in the traceRouteCtlTable.  The first
  102.         index element, traceRouteCtlOwnerIndex, is of type
  103.         SnmpAdminString, a textual convention that allows for
  104.         use of the SNMPv3 View-Based Access Control Model
  105.         (RFC 2575 [11], VACM) and allows an management
  106.         application to identify its entries.  The second index,
  107.         traceRouteCtlTestName (also an SnmpAdminString),
  108.         enables the same management application to have
  109.         multiple requests outstanding."
  110.     INDEX {
  111.             traceRouteCtlOwnerIndex,
  112.             traceRouteCtlTestName
  113.           }
  114.     ::= { traceRouteCtlTable 1 }
  115.  
  116.  TraceRouteCtlEntry ::=
  117.     SEQUENCE {
  118.       traceRouteCtlOwnerIndex         SnmpAdminString,
  119.       traceRouteCtlTestName           SnmpAdminString,
  120.       traceRouteCtlTargetAddressType  InetAddressType,
  121.       traceRouteCtlTargetAddress      InetAddress,
  122.       traceRouteCtlByPassRouteTable   TruthValue,
  123.       traceRouteCtlDataSize           Unsigned32,
  124.       traceRouteCtlTimeOut            Unsigned32,
  125.       traceRouteCtlProbesPerHop       Unsigned32,
  126.       traceRouteCtlPort               Unsigned32,
  127.       traceRouteCtlMaxTtl             Unsigned32,
  128.       traceRouteCtlDSField            Unsigned32,
  129.       traceRouteCtlSourceAddressType  InetAddressType,
  130.  
  131.       traceRouteCtlSourceAddress      InetAddress,
  132.       traceRouteCtlIfIndex            InterfaceIndexOrZero,
  133.       traceRouteCtlMiscOptions        SnmpAdminString,
  134.       traceRouteCtlMaxFailures        Unsigned32,
  135.       traceRouteCtlDontFragment       TruthValue,
  136.       traceRouteCtlInitialTtl         Unsigned32,
  137.       traceRouteCtlFrequency          Unsigned32,
  138.       traceRouteCtlStorageType        StorageType,
  139.       traceRouteCtlAdminStatus        INTEGER,
  140.       traceRouteCtlMaxRows            Unsigned32,
  141.       traceRouteCtlTrapGeneration     BITS,
  142.       traceRouteCtlDescr              SnmpAdminString,
  143.       traceRouteCtlCreateHopsEntries  TruthValue,
  144.       traceRouteCtlType               OBJECT IDENTIFIER,
  145.       traceRouteCtlRowStatus          RowStatus
  146.     }
  147.  
  148.  traceRouteCtlOwnerIndex OBJECT-TYPE
  149.     SYNTAX      SnmpAdminString (SIZE(0..32))
  150.     MAX-ACCESS  not-accessible
  151.     STATUS      current
  152.     DESCRIPTION
  153.        "To facilitate the provisioning of access control by a
  154.        security administrator using the View-Based Access
  155.        Control Model (RFC 2575, VACM) for tables in which
  156.        multiple users may need to independently create or
  157.        modify entries, the initial index is used as an 'owner
  158.        index'.  Such an initial index has a syntax of
  159.        SnmpAdminString, and can thus be trivially mapped to a
  160.        securityName or groupName as defined in VACM, in
  161.        accordance with a security policy.
  162.  
  163.        When used in conjunction with such a security policy
  164.        all entries in the table belonging to a particular user
  165.        (or group) will have the same value for this initial
  166.        index.  For a given user's entries in a particular
  167.        table, the object identifiers for the information in
  168.        these entries will have the same subidentifiers (except
  169.        for the 'column' subidentifier) up to the end of the
  170.        encoded owner index. To configure VACM to permit access
  171.        to this portion of the table, one would create
  172.        vacmViewTreeFamilyTable entries with the value of
  173.        vacmViewTreeFamilySubtree including the owner index
  174.        portion, and vacmViewTreeFamilyMask 'wildcarding' the
  175.        column subidentifier.  More elaborate configurations
  176.        are possible."
  177.     ::= { traceRouteCtlEntry 1 }
  178.  
  179.   traceRouteCtlTestName OBJECT-TYPE
  180.     SYNTAX      SnmpAdminString (SIZE(0..32))
  181.     MAX-ACCESS  not-accessible
  182.     STATUS      current
  183.     DESCRIPTION
  184.         "The name of a traceroute test.  This is locally unique,
  185.         within the scope of an traceRouteCtlOwnerIndex."
  186.     ::= { traceRouteCtlEntry 2 }
  187.  
  188.  traceRouteCtlTargetAddressType OBJECT-TYPE
  189.     SYNTAX      InetAddressType
  190.     MAX-ACCESS  read-create
  191.     STATUS      current
  192.     DESCRIPTION
  193.         "Specifies the type of host address to be used on the
  194.         traceroute request at the remote host."
  195.     DEFVAL { ipv4 }
  196.     ::= { traceRouteCtlEntry 3 }
  197.  
  198.  traceRouteCtlTargetAddress OBJECT-TYPE
  199.     SYNTAX      InetAddress
  200.     MAX-ACCESS  read-create
  201.     STATUS      current
  202.     DESCRIPTION
  203.         "Specifies the host address used on the
  204.         traceroute request at the remote host.  The
  205.         host address type can be determined by the
  206.         examining the value of the corresponding
  207.         traceRouteCtlTargetAddressType index element.
  208.  
  209.         A value for this object MUST be set prior to
  210.         transitioning its corresponding traceRouteCtlEntry to
  211.         active(1) via traceRouteCtlRowStatus."
  212.     ::= { traceRouteCtlEntry 4 }
  213.  
  214.  traceRouteCtlByPassRouteTable OBJECT-TYPE
  215.     SYNTAX TruthValue
  216.     MAX-ACCESS  read-create
  217.     STATUS      current
  218.     DESCRIPTION
  219.        "The purpose of this object is to optionally enable
  220.        bypassing the route table.  If enabled, the remote
  221.        host will bypass the normal routing tables and send
  222.        directly to a host on an attached network.  If the
  223.        host is not on a directly-attached network, an
  224.        error is returned.  This option can be used to perform
  225.        the traceroute operation to a local host through an
  226.        interface that has no route defined (e.g., after the
  227.  
  228.        interface was dropped by routed)."
  229.     DEFVAL { false }
  230.     ::= { traceRouteCtlEntry 5 }
  231.  
  232.  traceRouteCtlDataSize OBJECT-TYPE
  233.     SYNTAX      Unsigned32 (0..65507)
  234.     UNITS       "octets"
  235.     MAX-ACCESS  read-create
  236.     STATUS      current
  237.     DESCRIPTION
  238.         "Specifies the size of the data portion of a traceroute
  239.         request in octets.  A traceroute request is essentially
  240.         transmitted by encoding a UDP datagram into a
  241.         IP packet. So subtracting the size of a UDP header
  242.         (8 octets) and the size of a IP header (20 octets)
  243.         yields a maximum of 65507 octets."
  244.     DEFVAL { 0 }
  245.     ::= { traceRouteCtlEntry 6 }
  246.  
  247.  traceRouteCtlTimeOut OBJECT-TYPE
  248.     SYNTAX      Unsigned32 (1..60)
  249.     UNITS       "seconds"
  250.     MAX-ACCESS  read-create
  251.     STATUS      current
  252.     DESCRIPTION
  253.         "Specifies the time-out value, in seconds, for
  254.         a traceroute request."
  255.     DEFVAL { 3 }
  256.     ::= { traceRouteCtlEntry 7 }
  257.  
  258.  traceRouteCtlProbesPerHop OBJECT-TYPE
  259.     SYNTAX      Unsigned32 (1..10)
  260.     UNITS       "probes"
  261.     MAX-ACCESS  read-create
  262.     STATUS      current
  263.     DESCRIPTION
  264.         "Specifies the number of times to reissue a traceroute
  265.         request with the same time-to-live (TTL) value."
  266.     DEFVAL { 3 }
  267.     ::= { traceRouteCtlEntry 8 }
  268.  
  269.  traceRouteCtlPort OBJECT-TYPE
  270.     SYNTAX      Unsigned32 (1..65535)
  271.     UNITS       "UDP Port"
  272.     MAX-ACCESS  read-create
  273.     STATUS      current
  274.     DESCRIPTION
  275.         "Specifies the UDP port to send the traceroute
  276.  
  277.         request to.  Need to specify a port that is not in
  278.         use at the destination (target) host.  The default
  279.         value for this object is the IANA assigned port,
  280.         33434, for the traceroute function."
  281.     DEFVAL { 33434 }
  282.     ::= { traceRouteCtlEntry 9 }
  283.  
  284.  traceRouteCtlMaxTtl OBJECT-TYPE
  285.     SYNTAX      Unsigned32 (1..255)
  286.     UNITS       "time-to-live value"
  287.     MAX-ACCESS  read-create
  288.     STATUS      current
  289.     DESCRIPTION
  290.         "Specifies the maximum time-to-live value."
  291.     DEFVAL { 30 }
  292.     ::= { traceRouteCtlEntry 10 }
  293.  
  294.  traceRouteCtlDSField OBJECT-TYPE
  295.     SYNTAX      Unsigned32 (0..255)
  296.     MAX-ACCESS  read-create
  297.     STATUS      current
  298.     DESCRIPTION
  299.         "Specifies the value to store in the Differentiated
  300.         Services (DS) Field in the IP packet used to
  301.         encapsulate the traceroute probe.  The DS Field is
  302.         defined as the Type of Service (TOS) octet in a IPv4
  303.         header or as the Traffic Class octet in a IPv6 header.
  304.  
  305.         The value of this object must be a decimal integer
  306.         in the range from 0 to 255.  This option can be used
  307.         to determine what effect an explicit DS Field setting
  308.         has on a traceroute response.  Not all values are legal
  309.         or meaningful.  DS Field usage is often not supported
  310.         by IP implementations.  A value of 0 means that the
  311.      function represented by this option is not supported.
  312.      Useful TOS octet values are probably '16' (low delay)
  313.      and '8' ( high throughput)."
  314.     REFERENCE
  315.         "Refer to RFC 2474 for the definition of the
  316.         Differentiated Services Field and to RFC 1812
  317.         Section 5.3.2 for Type of Service (TOS)."
  318.     DEFVAL { 0 }
  319.     ::= { traceRouteCtlEntry 11 }
  320.  
  321.  traceRouteCtlSourceAddressType OBJECT-TYPE
  322.     SYNTAX      InetAddressType
  323.     MAX-ACCESS  read-create
  324.     STATUS      current
  325.  
  326.     DESCRIPTION
  327.         "Specifies the type of the source address,
  328.         traceRouteCtlSourceAddress, to be used at a remote host
  329.         when performing a traceroute operation."
  330.     DEFVAL { unknown }
  331.     ::= { traceRouteCtlEntry 12 }
  332.  
  333.  traceRouteCtlSourceAddress OBJECT-TYPE
  334.     SYNTAX      InetAddress
  335.     MAX-ACCESS  read-create
  336.     STATUS      current
  337.     DESCRIPTION
  338.         "Use the specified IP address (which must be given
  339.         as an IP number, not a hostname) as the source
  340.         address in outgoing probe packets. On hosts with
  341.         more than one IP address, this option can be used
  342.         to force the source address to be something other
  343.         than the primary IP address of the interface the
  344.         probe packet is sent on.  If the IP address is not
  345.         one of this machine's interface addresses, an error
  346.         is returned and nothing is sent.  A zero length
  347.         octet string value for this object disables source
  348.         address specification.
  349.  
  350.         The address type (InetAddressType) that relates to
  351.         this object is specified by the corresponding value
  352.         of traceRouteCtlSourceAddressType."
  353.     DEFVAL { ''H }
  354.     ::= { traceRouteCtlEntry 13 }
  355.  
  356.  traceRouteCtlIfIndex OBJECT-TYPE
  357.     SYNTAX      InterfaceIndexOrZero
  358.     MAX-ACCESS  read-create
  359.     STATUS      current
  360.     DESCRIPTION
  361.         "Setting this object to an interface's ifIndex prior
  362.         to starting a remote traceroute operation directs
  363.         the traceroute probes to be transmitted over the
  364.         specified interface.  A value of zero for this object
  365.         implies that this option is not enabled."
  366.     DEFVAL { 0 }
  367.     ::= { traceRouteCtlEntry 14 }
  368.  
  369.  traceRouteCtlMiscOptions OBJECT-TYPE
  370.     SYNTAX      SnmpAdminString
  371.     MAX-ACCESS  read-create
  372.     STATUS      current
  373.     DESCRIPTION
  374.  
  375.         "Enables an application to specify implementation
  376.         dependent options."
  377.     DEFVAL { ''H }
  378.     ::= { traceRouteCtlEntry 15 }
  379.  
  380.  traceRouteCtlMaxFailures OBJECT-TYPE
  381.     SYNTAX      Unsigned32 (0..255)
  382.     UNITS       "timeouts"
  383.     MAX-ACCESS  read-create
  384.     STATUS      current
  385.     DESCRIPTION
  386.         "The value of this object indicates the maximum number
  387.         of consecutive timeouts allowed before terminating
  388.         a remote traceroute request.  A value of either 255 (maximum
  389.         hop count/possible TTL value) or a 0 indicates that the
  390.         function of terminating a remote traceroute request when a
  391.         specific number of successive timeouts are detected is
  392.         disabled."
  393.     DEFVAL { 5 }
  394.     ::= { traceRouteCtlEntry 16 }
  395.  
  396.  traceRouteCtlDontFragment OBJECT-TYPE
  397.     SYNTAX         TruthValue
  398.     MAX-ACCESS     read-create
  399.     STATUS         current
  400.     DESCRIPTION
  401.         "This object enables setting of the don't fragment flag (DF)
  402.         in the IP header for a probe.  Use of this object enables
  403.         performing a manual PATH MTU test."
  404.     DEFVAL  { false }
  405.     ::= { traceRouteCtlEntry 17 }
  406.  
  407.  traceRouteCtlInitialTtl OBJECT-TYPE
  408.     SYNTAX         Unsigned32 (0..255)
  409.     MAX-ACCESS     read-create
  410.     STATUS         current
  411.     DESCRIPTION
  412.         "The value of this object specifies the initial TTL value to
  413.         use.  This enables bypassing the initial (often well known)
  414.         portion of a path."
  415.     DEFVAL { 1 }
  416.     ::= { traceRouteCtlEntry 18 }
  417.  
  418.  traceRouteCtlFrequency  OBJECT-TYPE
  419.     SYNTAX      Unsigned32
  420.     UNITS       "seconds"
  421.     MAX-ACCESS  read-create
  422.     STATUS      current
  423.  
  424.     DESCRIPTION
  425.         "The number of seconds to wait before repeating a
  426.         traceroute test as defined by the value of the
  427.         various objects in the corresponding row.
  428.  
  429.         The number of hops in a single traceroute test
  430.         is determined by the value of the corresponding
  431.         traceRouteCtlProbesPerHop object.  After a
  432.         single test completes the number of seconds as defined
  433.         by the value of traceRouteCtlFrequency MUST elapse
  434.         before the next traceroute test is started.
  435.  
  436.         A value of 0 for this object implies that the test
  437.         as defined by the corresponding entry will not be
  438.         repeated."
  439.     DEFVAL { 0 }
  440.     ::= { traceRouteCtlEntry 19 }
  441.  
  442.  traceRouteCtlStorageType OBJECT-TYPE
  443.     SYNTAX      StorageType
  444.     MAX-ACCESS  read-create
  445.     STATUS      current
  446.     DESCRIPTION
  447.         "The storage type for this conceptual row.
  448.         Conceptual rows having the value 'permanent' need not
  449.         allow write-access to any columnar objects in the row."
  450.     DEFVAL { nonVolatile }
  451.     ::= { traceRouteCtlEntry 20 }
  452.  
  453.  traceRouteCtlAdminStatus OBJECT-TYPE
  454.     SYNTAX      INTEGER {
  455.                           enabled(1), -- operation should be started
  456.                           disabled(2) -- operation should be stopped
  457.                         }
  458.     MAX-ACCESS  read-create
  459.     STATUS      current
  460.     DESCRIPTION
  461.         "Reflects the desired state that an traceRouteCtlEntry
  462.         should be in:
  463.  
  464.            enabled(1)  - Attempt to activate the test as defined by
  465.                          this traceRouteCtlEntry.
  466.            disabled(2) - Deactivate the test as defined by this
  467.                          traceRouteCtlEntry.
  468.  
  469.         Refer to the corresponding traceRouteResultsOperStatus to
  470.         determine the operational state of the test defined by
  471.         this entry."
  472.  
  473.      DEFVAL { disabled }
  474.     ::= { traceRouteCtlEntry 21 }
  475.  
  476.  traceRouteCtlDescr OBJECT-TYPE
  477.     SYNTAX      SnmpAdminString
  478.     MAX-ACCESS  read-create
  479.     STATUS      current
  480.     DESCRIPTION
  481.         "The purpose of this object is to provide a
  482.         descriptive name of the remote traceroute
  483.         test."
  484.     DEFVAL { '00'H }
  485.     ::= { traceRouteCtlEntry 22 }
  486.  
  487.  traceRouteCtlMaxRows OBJECT-TYPE
  488.     SYNTAX      Unsigned32
  489.     UNITS       "rows"
  490.     MAX-ACCESS  read-create
  491.     STATUS      current
  492.     DESCRIPTION
  493.         "The maximum number of entries allowed in the
  494.         traceRouteProbeHistoryTable.  An implementation of
  495.         this MIB will remove the oldest entry in the
  496.         traceRouteProbeHistoryTable to allow the addition
  497.         of an new entry once the number of rows in the
  498.         traceRouteProbeHistoryTable reaches this value.
  499.  
  500.         Old entries are not removed when a new test is
  501.         started.  Entries are added to the
  502.         traceRouteProbeHistoryTable until traceRouteCtlMaxRows
  503.         is reached before entries begin to be removed.
  504.  
  505.         A value of 0 for this object disables creation of
  506.         traceRouteProbeHistoryTable entries."
  507.     DEFVAL      { 50 }
  508.     ::= { traceRouteCtlEntry 23 }
  509.  
  510.  traceRouteCtlTrapGeneration OBJECT-TYPE
  511.     SYNTAX      BITS {
  512.                   pathChange(0),
  513.                   testFailure(1),
  514.                   testCompletion(2)
  515.                 }
  516.     MAX-ACCESS  read-create
  517.     STATUS      current
  518.     DESCRIPTION
  519.         "The value of this object determines when and if to
  520.         to generate a notification for this entry:
  521.  
  522.         pathChange(0)     - Generate a traceRoutePathChange
  523.             notification when the current path varies from a
  524.             previously determined path.
  525.         testFailure(1)    - Generate a traceRouteTestFailed
  526.             notification when the full path to a target
  527.             can't be determined.
  528.         testCompletion(2) - Generate a traceRouteTestCompleted
  529.             notification when the path to a target has been
  530.             determined.
  531.  
  532.         The value of this object defaults to zero, indicating
  533.         that none of the above options have been selected."
  534.     ::= { traceRouteCtlEntry 24 }
  535.  
  536.  traceRouteCtlCreateHopsEntries OBJECT-TYPE
  537.     SYNTAX      TruthValue
  538.     MAX-ACCESS  read-create
  539.     STATUS      current
  540.     DESCRIPTION
  541.         "The current path for a traceroute test is kept in the
  542.         traceRouteHopsTable on a per hop basis when the value of
  543.         this object is true(1)."
  544.     DEFVAL { false }
  545.     ::= { traceRouteCtlEntry 25 }
  546.  
  547.  traceRouteCtlType OBJECT-TYPE
  548.     SYNTAX      OBJECT IDENTIFIER
  549.     MAX-ACCESS  read-create
  550.     STATUS      current
  551.     DESCRIPTION
  552.         "The value of this object is used either to report or
  553.         select the implementation method to be used for
  554.         performing a traceroute operation. The value of this
  555.         object may be selected from
  556.         traceRouteImplementationTypeDomains.
  557.  
  558.         Additional implementation types should be allocated as
  559.         required by implementers of the DISMAN-TRACEROUTE-MIB
  560.         under their enterprise specific registration point and
  561.         not beneath traceRouteImplementationTypeDomains."
  562.     DEFVAL { traceRouteUsingUdpProbes }
  563.     ::= { traceRouteCtlEntry 26 }
  564.  
  565.  traceRouteCtlRowStatus OBJECT-TYPE
  566.     SYNTAX      RowStatus
  567.     MAX-ACCESS  read-create
  568.     STATUS      current
  569.     DESCRIPTION
  570.  
  571.         "This object allows entries to be created and deleted
  572.         in the traceRouteCtlTable.  Deletion of an entry in
  573.         this table results in all corresponding (same
  574.         traceRouteCtlOwnerIndex and traceRouteCtlTestName
  575.         index values) traceRouteResultsTable,
  576.         traceRouteProbeHistoryTable, and traceRouteHopsTable
  577.         entries being deleted.
  578.  
  579.         A value MUST be specified for traceRouteCtlTargetAddress
  580.         prior to a transition to active(1) state being
  581.         accepted.
  582.  
  583.         Activation of a remote traceroute operation is
  584.         controlled via traceRouteCtlAdminStatus and not
  585.         by transitioning of this object's value to active(1).
  586.  
  587.         Transitions in and out of active(1) state are not
  588.         allowed while an entry's traceRouteResultsOperStatus
  589.         is active(1) with the exception that deletion of
  590.         an entry in this table by setting its RowStatus
  591.         object to destroy(6) will stop an active
  592.         traceroute operation.
  593.  
  594.         The operational state of an traceroute operation
  595.         can be determined by examination of the corresponding
  596.         traceRouteResultsOperStatus object."
  597.     REFERENCE
  598.         "See definition of RowStatus in RFC 2579, 'Textual
  599.         Conventions for SMIv2.'"
  600.     ::= { traceRouteCtlEntry 27 }
  601.  
  602.  -- Traceroute Results Table
  603.  
  604.  traceRouteResultsTable OBJECT-TYPE
  605.     SYNTAX      SEQUENCE OF TraceRouteResultsEntry
  606.     MAX-ACCESS  not-accessible
  607.     STATUS      current
  608.     DESCRIPTION
  609.         "Defines the Remote Operations Traceroute Results Table for
  610.         keeping track of the status of a traceRouteCtlEntry.
  611.  
  612.         An entry is added to the traceRouteResultsTable when an
  613.         traceRouteCtlEntry is started by successful transition
  614.         of its traceRouteCtlAdminStatus object to enabled(1).
  615.         An entry is removed from the traceRouteResultsTable when
  616.         its corresponding traceRouteCtlEntry is deleted."
  617.    ::= { traceRouteObjects 3 }
  618.  
  619.  traceRouteResultsEntry OBJECT-TYPE
  620.     SYNTAX      TraceRouteResultsEntry
  621.     MAX-ACCESS  not-accessible
  622.     STATUS      current
  623.     DESCRIPTION
  624.         "Defines an entry in the traceRouteResultsTable.  The
  625.         traceRouteResultsTable has the same indexing as the
  626.         traceRouteCtlTable in order for a traceRouteResultsEntry
  627.         to correspond to the traceRouteCtlEntry that caused it to
  628.         be created."
  629.     INDEX {
  630.             traceRouteCtlOwnerIndex,
  631.             traceRouteCtlTestName
  632.           }
  633.     ::= { traceRouteResultsTable 1 }
  634.  
  635.  TraceRouteResultsEntry ::=
  636.     SEQUENCE {
  637.       traceRouteResultsOperStatus       INTEGER,
  638.       traceRouteResultsCurHopCount      Gauge32,
  639.       traceRouteResultsCurProbeCount    Gauge32,
  640.       traceRouteResultsIpTgtAddrType    InetAddressType,
  641.       traceRouteResultsIpTgtAddr        InetAddress,
  642.       traceRouteResultsTestAttempts     Unsigned32,
  643.       traceRouteResultsTestSuccesses    Unsigned32,
  644.       traceRouteResultsLastGoodPath     DateAndTime
  645.     }
  646.  
  647.  traceRouteResultsOperStatus OBJECT-TYPE
  648.     SYNTAX      INTEGER {
  649.                           enabled(1), -- test is in progress
  650.                           disabled(2) -- test has stopped
  651.                         }
  652.     MAX-ACCESS  read-only
  653.     STATUS      current
  654.     DESCRIPTION
  655.         "Reflects the operational state of an traceRouteCtlEntry:
  656.  
  657.            enabled(1)  - Test is active.
  658.            disabled(2) - Test has stopped."
  659.     ::= { traceRouteResultsEntry 1 }
  660.  
  661.  traceRouteResultsCurHopCount OBJECT-TYPE
  662.     SYNTAX      Gauge32
  663.     UNITS       "hops"
  664.     MAX-ACCESS  read-only
  665.     STATUS      current
  666.     DESCRIPTION
  667.  
  668.         "Reflects the current TTL value (range from 1 to
  669.         255) for a remote traceroute operation.
  670.         Maximum TTL value is determined by
  671.         traceRouteCtlMaxTtl."
  672.     ::= { traceRouteResultsEntry 2 }
  673.  
  674.  traceRouteResultsCurProbeCount OBJECT-TYPE
  675.     SYNTAX      Gauge32
  676.     UNITS       "probes"
  677.     MAX-ACCESS  read-only
  678.     STATUS      current
  679.     DESCRIPTION
  680.         "Reflects the current probe count (1..10) for
  681.         a remote traceroute operation. The maximum
  682.         probe count is determined by
  683.         traceRouteCtlProbesPerHop."
  684.     ::= { traceRouteResultsEntry 3 }
  685.  
  686.  traceRouteResultsIpTgtAddrType OBJECT-TYPE
  687.     SYNTAX      InetAddressType
  688.     MAX-ACCESS  read-only
  689.     STATUS      current
  690.     DESCRIPTION
  691.         "This objects indicates the type of address stored
  692.         in the corresponding traceRouteResultsIpTgtAddr
  693.         object."
  694.     ::= { traceRouteResultsEntry 4 }
  695.  
  696.  traceRouteResultsIpTgtAddr OBJECT-TYPE
  697.     SYNTAX      InetAddress
  698.     MAX-ACCESS  read-only
  699.     STATUS      current
  700.     DESCRIPTION
  701.         "This objects reports the IP address associated
  702.         with a traceRouteCtlTargetAddress value when the
  703.         destination address is specified as a DNS name.
  704.         The value of this object should be a zero length
  705.         octet string when a DNS name is not specified or
  706.         when a specified DNS name fails to resolve."
  707.     ::= { traceRouteResultsEntry 5 }
  708.  
  709.  traceRouteResultsTestAttempts OBJECT-TYPE
  710.     SYNTAX      Unsigned32
  711.     UNITS       "tests"
  712.     MAX-ACCESS  read-only
  713.     STATUS      current
  714.     DESCRIPTION
  715.         "The current number of attempts to determine a path
  716.  
  717.         to a target.  The value of this object MUST be started
  718.         at 0."
  719.     ::= { traceRouteResultsEntry 6 }
  720.  
  721.  traceRouteResultsTestSuccesses OBJECT-TYPE
  722.     SYNTAX      Unsigned32
  723.     UNITS       "tests"
  724.     MAX-ACCESS  read-only
  725.     STATUS      current
  726.     DESCRIPTION
  727.         "The current number of attempts to determine a path
  728.         to a target that have succeeded.  The value of this
  729.         object MUST be reported as 0 when no attempts have
  730.         succeeded."
  731.     ::= { traceRouteResultsEntry 7 }
  732.  
  733.  traceRouteResultsLastGoodPath OBJECT-TYPE
  734.     SYNTAX      DateAndTime
  735.     MAX-ACCESS  read-only
  736.     STATUS      current
  737.     DESCRIPTION
  738.         "The date and time when the last complete path
  739.         was determined."
  740.     ::= { traceRouteResultsEntry 8 }
  741.  
  742.  -- Trace Route Probe History Table
  743.  
  744.  traceRouteProbeHistoryTable OBJECT-TYPE
  745.     SYNTAX      SEQUENCE OF TraceRouteProbeHistoryEntry
  746.     MAX-ACCESS  not-accessible
  747.     STATUS      current
  748.     DESCRIPTION
  749.         "Defines the Remote Operations Traceroute Results Table for
  750.         storing the results of a traceroute operation.
  751.  
  752.         An implementation of this MIB will remove the oldest
  753.         entry in the traceRouteProbeHistoryTable to allow the
  754.         addition of an new entry once the number of rows in
  755.         the traceRouteProbeHistoryTable reaches the value specified
  756.         by traceRouteCtlMaxRows."
  757.    ::= { traceRouteObjects 4 }
  758.  
  759.  traceRouteProbeHistoryEntry OBJECT-TYPE
  760.     SYNTAX      TraceRouteProbeHistoryEntry
  761.     MAX-ACCESS  not-accessible
  762.     STATUS      current
  763.     DESCRIPTION
  764.         "Defines a table for storing the results of a traceroute
  765.  
  766.         operation.  Entries in this table are limited by
  767.         the value of the corresponding traceRouteCtlMaxRows
  768.         object.
  769.  
  770.         The first two index elements identify the
  771.         traceRouteCtlEntry that a traceRouteProbeHistoryEntry
  772.         belongs to.  The third index element selects a single
  773.         traceroute operation result.  The fourth and fifth indexes
  774.         select the hop and the probe for a particular
  775.         traceroute operation."
  776.     INDEX {
  777.              traceRouteCtlOwnerIndex,
  778.              traceRouteCtlTestName,
  779.              traceRouteProbeHistoryIndex,
  780.              traceRouteProbeHistoryHopIndex,
  781.              traceRouteProbeHistoryProbeIndex
  782.           }
  783.     ::= { traceRouteProbeHistoryTable 1 }
  784.  
  785.  TraceRouteProbeHistoryEntry ::=
  786.     SEQUENCE {
  787.       traceRouteProbeHistoryIndex         Unsigned32,
  788.       traceRouteProbeHistoryHopIndex      Unsigned32,
  789.       traceRouteProbeHistoryProbeIndex    Unsigned32,
  790.       traceRouteProbeHistoryHAddrType     InetAddressType,
  791.       traceRouteProbeHistoryHAddr         InetAddress,
  792.       traceRouteProbeHistoryResponse      Unsigned32,
  793.       traceRouteProbeHistoryStatus        OperationResponseStatus,
  794.       traceRouteProbeHistoryLastRC        Integer32,
  795.       traceRouteProbeHistoryTime          DateAndTime
  796.     }
  797.  
  798.  traceRouteProbeHistoryIndex OBJECT-TYPE
  799.     SYNTAX      Unsigned32 (1..'ffffffff'h)
  800.     MAX-ACCESS  not-accessible
  801.     STATUS      current
  802.     DESCRIPTION
  803.         "An entry in this table is created when the result of
  804.         a traceroute probe is determined.  The initial 2 instance
  805.         identifier index values identify the traceRouteCtlEntry
  806.         that a probe result (traceRouteProbeHistoryEntry) belongs
  807.         to.  An entry is removed from this table when
  808.         its corresponding traceRouteCtlEntry is deleted.
  809.  
  810.         An implementation MUST start assigning
  811.         traceRouteProbeHistoryIndex values at 1 and wrap after
  812.         exceeding the maximum possible value as defined by the
  813.         limit of this object ('ffffffff'h)."
  814.  
  815.     ::= { traceRouteProbeHistoryEntry 1 }
  816.  
  817.  traceRouteProbeHistoryHopIndex OBJECT-TYPE
  818.     SYNTAX      Unsigned32 (1..255)
  819.     MAX-ACCESS  not-accessible
  820.     STATUS      current
  821.     DESCRIPTION
  822.        "Indicates which hop in a traceroute path that the probe's
  823.        results are for.  The value of this object is initially
  824.        determined by the value of traceRouteCtlInitialTtl."
  825.     ::= { traceRouteProbeHistoryEntry 2 }
  826.  
  827.  traceRouteProbeHistoryProbeIndex OBJECT-TYPE
  828.     SYNTAX      Unsigned32 (1..10)
  829.     MAX-ACCESS  not-accessible
  830.     STATUS      current
  831.     DESCRIPTION
  832.        "Indicates the index of a probe for a particular
  833.        hop in a traceroute path.  The number of probes per
  834.        hop is determined by the value of the corresponding
  835.        traceRouteCtlProbesPerHop object."
  836.     ::= { traceRouteProbeHistoryEntry 3 }
  837.  
  838.  traceRouteProbeHistoryHAddrType OBJECT-TYPE
  839.     SYNTAX      InetAddressType
  840.     MAX-ACCESS  read-only
  841.     STATUS      current
  842.     DESCRIPTION
  843.         "This objects indicates the type of address stored
  844.         in the corresponding traceRouteProbeHistoryHAddr
  845.         object."
  846.     ::= { traceRouteProbeHistoryEntry 4 }
  847.  
  848.  traceRouteProbeHistoryHAddr OBJECT-TYPE
  849.     SYNTAX      InetAddress
  850.     MAX-ACCESS  read-only
  851.     STATUS      current
  852.     DESCRIPTION
  853.        "The address of a hop in a traceroute path.  This object
  854.        is not allowed to be a DNS name.  The value of the
  855.        corresponding object, traceRouteProbeHistoryHAddrType,
  856.        indicates this object's IP address type."
  857.     ::= { traceRouteProbeHistoryEntry 5 }
  858.  
  859.  traceRouteProbeHistoryResponse OBJECT-TYPE
  860.     SYNTAX      Unsigned32
  861.     UNITS       "milliseconds"
  862.     MAX-ACCESS  read-only
  863.  
  864.     STATUS      current
  865.     DESCRIPTION
  866.         "The amount of time measured in milliseconds from when
  867.         a probe was sent to when its response was received or
  868.         when it timed out.  The value of this object is reported
  869.         as 0 when it is not possible to transmit a probe."
  870.     ::= { traceRouteProbeHistoryEntry 6 }
  871.  
  872.  traceRouteProbeHistoryStatus OBJECT-TYPE
  873.     SYNTAX      OperationResponseStatus
  874.     MAX-ACCESS  read-only
  875.     STATUS      current
  876.     DESCRIPTION
  877.         "The result of a traceroute operation made by a remote
  878.         host for a particular probe."
  879.     ::= { traceRouteProbeHistoryEntry 7 }
  880.  
  881.  traceRouteProbeHistoryLastRC OBJECT-TYPE
  882.     SYNTAX      Integer32
  883.     MAX-ACCESS  read-only
  884.     STATUS      current
  885.     DESCRIPTION
  886.         "The last implementation method specific reply code received.
  887.  
  888.         Traceroute is usually implemented by transmitting a series of
  889.         probe packets with increasing time-to-live values.  A probe
  890.         packet is a UDP datagram encapsulated into an IP packet.
  891.         Each hop in a path to the target (destination) host rejects
  892.         the probe packets (probe's TTL too small, ICMP reply) until
  893.         either the maximum TTL is exceeded or the target host is
  894.         received."
  895.     ::= { traceRouteProbeHistoryEntry 8 }
  896.  
  897.  traceRouteProbeHistoryTime OBJECT-TYPE
  898.     SYNTAX      DateAndTime
  899.     MAX-ACCESS  read-only
  900.     STATUS      current
  901.     DESCRIPTION
  902.         "Timestamp for when this probe results were determined."
  903.     ::= { traceRouteProbeHistoryEntry 9 }
  904.  
  905.  -- Traceroute Hop Results Table
  906.  
  907.  traceRouteHopsTable OBJECT-TYPE
  908.     SYNTAX      SEQUENCE OF TraceRouteHopsEntry
  909.     MAX-ACCESS  not-accessible
  910.     STATUS      current
  911.     DESCRIPTION
  912.  
  913.         "Defines the Remote Operations Traceroute Hop Table for
  914.         keeping track of the results of traceroute tests on a
  915.         per hop basis."
  916.     ::= { traceRouteObjects 5 }
  917.  
  918.  traceRouteHopsEntry OBJECT-TYPE
  919.     SYNTAX      TraceRouteHopsEntry
  920.     MAX-ACCESS  not-accessible
  921.     STATUS      current
  922.     DESCRIPTION
  923.         "Defines an entry in the traceRouteHopsTable.
  924.  
  925.         The first two index elements identify the
  926.         traceRouteCtlEntry that a traceRouteHopsEntry
  927.         belongs to.  The third index element,
  928.         traceRouteHopsHopIndex, selects a
  929.         hop in a traceroute path."
  930.     INDEX {
  931.             traceRouteCtlOwnerIndex,
  932.             traceRouteCtlTestName,
  933.             traceRouteHopsHopIndex
  934.           }
  935.     ::= { traceRouteHopsTable 1 }
  936.  
  937.  TraceRouteHopsEntry ::=
  938.     SEQUENCE {
  939.         traceRouteHopsHopIndex         Unsigned32,
  940.         traceRouteHopsIpTgtAddressType InetAddressType,
  941.         traceRouteHopsIpTgtAddress     InetAddress,
  942.         traceRouteHopsMinRtt           Unsigned32,
  943.         traceRouteHopsMaxRtt           Unsigned32,
  944.         traceRouteHopsAverageRtt       Unsigned32,
  945.         traceRouteHopsRttSumOfSquares  Unsigned32,
  946.         traceRouteHopsSentProbes       Unsigned32,
  947.         traceRouteHopsProbeResponses   Unsigned32,
  948.         traceRouteHopsLastGoodProbe    DateAndTime
  949.       }
  950.  
  951.  traceRouteHopsHopIndex OBJECT-TYPE
  952.     SYNTAX      Unsigned32
  953.     MAX-ACCESS  not-accessible
  954.     STATUS      current
  955.     DESCRIPTION
  956.         "Specifies the hop index for a traceroute hop.  Values
  957.         for this object with respect to the same
  958.         traceRouteCtlOwnerIndex and traceRouteCtlTestName
  959.         MUST start at 1 and increase monotonically.
  960.  
  961.         The traceRouteHopsTable keeps the current traceroute
  962.         path per traceRouteCtlEntry if enabled by
  963.         setting the corresponding traceRouteCtlCreateHopsEntries
  964.         to true(1).
  965.  
  966.         All hops (traceRouteHopsTable entries) in a traceroute
  967.         path MUST be updated at the same time when a traceroute
  968.         operation completes.  Care needs to be applied when either
  969.         a path changes or can't be determined.  The initial portion
  970.         of the path, up to the first hop change, MUST retain the
  971.         same traceRouteHopsHopIndex values.  The remaining portion
  972.         of the path SHOULD be assigned new traceRouteHopsHopIndex
  973.         values."
  974.     ::= { traceRouteHopsEntry 1 }
  975.  
  976.  traceRouteHopsIpTgtAddressType OBJECT-TYPE
  977.     SYNTAX      InetAddressType
  978.     MAX-ACCESS  read-only
  979.     STATUS      current
  980.     DESCRIPTION
  981.         "This objects indicates the type of address stored
  982.         in the corresponding traceRouteHopsIpTargetAddress
  983.         object."
  984.     ::= { traceRouteHopsEntry 2 }
  985.  
  986.  traceRouteHopsIpTgtAddress OBJECT-TYPE
  987.     SYNTAX      InetAddress
  988.     MAX-ACCESS  read-only
  989.     STATUS      current
  990.     DESCRIPTION
  991.         "This object reports the IP address associated with
  992.         the hop.  A value for this object should be reported
  993.         as a numeric IP address and not as a DNS name."
  994.     ::= { traceRouteHopsEntry 3 }
  995.  
  996.  traceRouteHopsMinRtt OBJECT-TYPE
  997.     SYNTAX      Unsigned32
  998.     MAX-ACCESS  read-only
  999.     STATUS      current
  1000.     DESCRIPTION
  1001.         "The minimum traceroute round-trip-time (RTT) received for
  1002.         this hop.  A value of 0 for this object implies that no
  1003.         RTT has been received."
  1004.     ::= { traceRouteHopsEntry 4 }
  1005.  
  1006.  traceRouteHopsMaxRtt OBJECT-TYPE
  1007.     SYNTAX      Unsigned32
  1008.     MAX-ACCESS  read-only
  1009.  
  1010.     STATUS      current
  1011.     DESCRIPTION
  1012.         "The maximum traceroute round-trip-time (RTT) received for
  1013.         this hop.  A value of 0 for this object implies that no
  1014.         RTT has been received."
  1015.     ::= { traceRouteHopsEntry 5 }
  1016.  
  1017.  traceRouteHopsAverageRtt OBJECT-TYPE
  1018.     SYNTAX      Unsigned32
  1019.     MAX-ACCESS  read-only
  1020.     STATUS      current
  1021.     DESCRIPTION
  1022.         "The current average traceroute round-trip-time (RTT) for
  1023.         this hop."
  1024.     ::= { traceRouteHopsEntry 6 }
  1025.  
  1026.  traceRouteHopsRttSumOfSquares OBJECT-TYPE
  1027.     SYNTAX      Unsigned32
  1028.     MAX-ACCESS  read-only
  1029.     STATUS      current
  1030.     DESCRIPTION
  1031.         "This object contains the sum of all traceroute responses
  1032.         received for this hop.  Its purpose is to enable standard
  1033.         deviation calculation."
  1034.     ::= { traceRouteHopsEntry 7 }
  1035.  
  1036.  traceRouteHopsSentProbes OBJECT-TYPE
  1037.     SYNTAX      Unsigned32
  1038.     MAX-ACCESS  read-only
  1039.     STATUS      current
  1040.     DESCRIPTION
  1041.         "The value of this object reflects the number of probes sent
  1042.         for this hop during this traceroute test.  The value of this
  1043.         object should start at 0."
  1044.     ::= { traceRouteHopsEntry 8 }
  1045.  
  1046.  traceRouteHopsProbeResponses OBJECT-TYPE
  1047.     SYNTAX      Unsigned32
  1048.     MAX-ACCESS  read-only
  1049.     STATUS      current
  1050.     DESCRIPTION
  1051.         "Number of responses received for this hop during this
  1052.         traceroute test.  This value of this object should start
  1053.         at 0."
  1054.     ::= { traceRouteHopsEntry 9 }
  1055.  
  1056.  traceRouteHopsLastGoodProbe OBJECT-TYPE
  1057.     SYNTAX      DateAndTime
  1058.  
  1059.     MAX-ACCESS  read-only
  1060.     STATUS      current
  1061.     DESCRIPTION
  1062.         "Date and time was the last response was received for a probe
  1063.         for this hop during this traceroute test."
  1064.     ::= { traceRouteHopsEntry 10 }
  1065.  
  1066.  -- Notification Definition section
  1067.  
  1068.  traceRoutePathChange NOTIFICATION-TYPE
  1069.       OBJECTS {
  1070.         traceRouteCtlTargetAddressType,
  1071.         traceRouteCtlTargetAddress,
  1072.         traceRouteResultsIpTgtAddrType,
  1073.         traceRouteResultsIpTgtAddr
  1074.       }
  1075.       STATUS  current
  1076.       DESCRIPTION
  1077.           "The path to a target has changed."
  1078.       ::= { traceRouteNotifications 1 }
  1079.  
  1080.  traceRouteTestFailed NOTIFICATION-TYPE
  1081.       OBJECTS {
  1082.         traceRouteCtlTargetAddressType,
  1083.         traceRouteCtlTargetAddress,
  1084.         traceRouteResultsIpTgtAddrType,
  1085.         traceRouteResultsIpTgtAddr
  1086.       }
  1087.       STATUS  current
  1088.       DESCRIPTION
  1089.           "Could not determine the path to a target."
  1090.       ::= { traceRouteNotifications 2 }
  1091.  
  1092.  traceRouteTestCompleted NOTIFICATION-TYPE
  1093.       OBJECTS {
  1094.         traceRouteCtlTargetAddressType,
  1095.         traceRouteCtlTargetAddress,
  1096.         traceRouteResultsIpTgtAddrType,
  1097.         traceRouteResultsIpTgtAddr
  1098.       }
  1099.       STATUS  current
  1100.       DESCRIPTION
  1101.           "The path to a target has just been determined."
  1102.       ::= { traceRouteNotifications 3 }
  1103.  
  1104.  -- Conformance information
  1105.  -- Compliance statements
  1106.  
  1107.  traceRouteCompliances OBJECT IDENTIFIER ::= { traceRouteConformance 1 }
  1108.  traceRouteGroups      OBJECT IDENTIFIER ::= { traceRouteConformance 2 }
  1109.  
  1110.  -- Compliance statements
  1111.  
  1112.  traceRouteCompliance MODULE-COMPLIANCE
  1113.     STATUS  current
  1114.     DESCRIPTION
  1115.             "The compliance statement for the DISMAN-TRACEROUTE-MIB."
  1116.     MODULE  -- this module
  1117.         MANDATORY-GROUPS {
  1118.                             traceRouteGroup
  1119.                           }
  1120.         GROUP traceRouteTimeStampGroup
  1121.         DESCRIPTION
  1122.             "This group is mandatory for implementations that have
  1123.             access to a system clock and are capable of setting
  1124.             the values for DateAndTime objects."
  1125.  
  1126.         GROUP traceRouteNotificationsGroup
  1127.         DESCRIPTION
  1128.             "This group defines a collection of optional
  1129.             notifications."
  1130.  
  1131.         GROUP traceRouteHopsTableGroup
  1132.         DESCRIPTION
  1133.             "This group lists the objects that make up a
  1134.             traceRouteHopsEntry.  Support of the traceRouteHopsTable
  1135.             is optional."
  1136.  
  1137.         OBJECT traceRouteMaxConcurrentRequests
  1138.         MIN-ACCESS  read-only
  1139.         DESCRIPTION
  1140.             "The agent is not required to support SET
  1141.             operations to this object."
  1142.  
  1143.         OBJECT traceRouteCtlByPassRouteTable
  1144.         MIN-ACCESS  read-only
  1145.         DESCRIPTION
  1146.             "This object is not required by implementations that
  1147.             are not capable of its implementation.  The function
  1148.             represented by this object is implementable if the
  1149.             setsockopt SOL_SOCKET SO_DONTROUTE option is
  1150.             supported."
  1151.  
  1152.         OBJECT traceRouteCtlSourceAddressType
  1153.         SYNTAX  InetAddressType { unknown(0), ipv4(1), ipv6(2) }
  1154.         MIN-ACCESS  read-only
  1155.  
  1156.         DESCRIPTION
  1157.             "This object is not required by implementations that
  1158.             are not capable of binding the send socket with a
  1159.             source address. An implementation is only required to
  1160.             support IPv4 and IPv6 addresses."
  1161.  
  1162.         OBJECT traceRouteCtlSourceAddress
  1163.         SYNTAX  InetAddress (SIZE(0|4|16))
  1164.         MIN-ACCESS  read-only
  1165.         DESCRIPTION
  1166.             "This object is not required by implementations that
  1167.             are not capable of binding the send socket with a
  1168.             source address. An implementation is only required to
  1169.             support IPv4 and globally unique IPv6 addresses."
  1170.  
  1171.         OBJECT traceRouteCtlIfIndex
  1172.         MIN-ACCESS  read-only
  1173.         DESCRIPTION
  1174.             "Write access is not required.  When write access is
  1175.             not supported return a 0 as the value of this object.
  1176.             A value of 0 implies that the function represented by
  1177.             this option is not supported."
  1178.  
  1179.         OBJECT traceRouteCtlMiscOptions
  1180.         MIN-ACCESS  read-only
  1181.         DESCRIPTION
  1182.             "Support of this object is optional.  When not
  1183.             supporting do not allow write access and return a
  1184.             zero length octet string as the value of the object."
  1185.  
  1186.         OBJECT traceRouteCtlStorageType
  1187.         MIN-ACCESS  read-only
  1188.         DESCRIPTION
  1189.             "Write access is not required.  It is also allowed
  1190.             for implementations to support only the volatile
  1191.             StorageType enumeration."
  1192.  
  1193.         OBJECT traceRouteCtlDSField
  1194.         MIN-ACCESS  read-only
  1195.         DESCRIPTION
  1196.             "Write access is not required.   When write access is
  1197.             not supported return a 0 as the value of this object.
  1198.             A value of 0 implies that the function represented by
  1199.             this option is not supported."
  1200.  
  1201.         OBJECT traceRouteCtlType
  1202.         MIN-ACCESS  read-only
  1203.         DESCRIPTION
  1204.  
  1205.             "Write access is not required.  In addition, the only
  1206.             value that is RECOMMENDED to be supported by an
  1207.             implementation is traceRouteUsingUdpProbes."
  1208.  
  1209.         OBJECT traceRouteResultsIpTgtAddrType
  1210.         SYNTAX  InetAddressType { unknown(0), ipv4(1), ipv6(2) }
  1211.         DESCRIPTION
  1212.             "An implementation should only support IPv4 and
  1213.             globally unique IPv6 address values for this object."
  1214.  
  1215.         OBJECT traceRouteResultsIpTgtAddr
  1216.         SYNTAX  InetAddress (SIZE(0|4|16))
  1217.         DESCRIPTION
  1218.             "An implementation should only support IPv4 and
  1219.             globally unique IPv6 address values for this object."
  1220.  
  1221.         OBJECT traceRouteProbeHistoryHAddrType
  1222.         SYNTAX  InetAddressType { unknown(0), ipv4(1), ipv6(2) }
  1223.         DESCRIPTION
  1224.             "An implementation should only support IPv4 and
  1225.             globally unique IPv6 address values for this object."
  1226.         OBJECT traceRouteProbeHistoryHAddr
  1227.         SYNTAX  InetAddress (SIZE(0|4|16))
  1228.         DESCRIPTION
  1229.             "An implementation should only support IPv4 and
  1230.             globally unique IPv6 address values for this object."
  1231.  
  1232.         OBJECT traceRouteHopsIpTgtAddressType
  1233.         SYNTAX  InetAddressType { unknown(0), ipv4(1), ipv6(2) }
  1234.         DESCRIPTION
  1235.             "An implementation should only support IPv4 and
  1236.             globally unique IPv6 address values for this object."
  1237.  
  1238.         OBJECT traceRouteHopsIpTgtAddress
  1239.         SYNTAX  InetAddress (SIZE(0|4|16))
  1240.         DESCRIPTION
  1241.             "An implementation should only support IPv4 and
  1242.             globally unique IPv6 address values for this object."
  1243.     ::= { traceRouteCompliances 1 }
  1244.  
  1245.  -- MIB groupings
  1246.  
  1247.  traceRouteGroup OBJECT-GROUP
  1248.    OBJECTS {
  1249.              traceRouteMaxConcurrentRequests,
  1250.              traceRouteCtlTargetAddressType,
  1251.              traceRouteCtlTargetAddress,
  1252.              traceRouteCtlByPassRouteTable,
  1253.  
  1254.              traceRouteCtlDataSize,
  1255.              traceRouteCtlTimeOut,
  1256.              traceRouteCtlProbesPerHop,
  1257.              traceRouteCtlPort,
  1258.              traceRouteCtlMaxTtl,
  1259.              traceRouteCtlDSField,
  1260.              traceRouteCtlSourceAddressType,
  1261.              traceRouteCtlSourceAddress,
  1262.              traceRouteCtlIfIndex,
  1263.              traceRouteCtlMiscOptions,
  1264.              traceRouteCtlMaxFailures,
  1265.              traceRouteCtlDontFragment,
  1266.              traceRouteCtlInitialTtl,
  1267.              traceRouteCtlFrequency,
  1268.              traceRouteCtlStorageType,
  1269.              traceRouteCtlAdminStatus,
  1270.              traceRouteCtlMaxRows,
  1271.              traceRouteCtlTrapGeneration,
  1272.              traceRouteCtlDescr,
  1273.              traceRouteCtlCreateHopsEntries,
  1274.              traceRouteCtlType,
  1275.              traceRouteCtlRowStatus,
  1276.              traceRouteResultsOperStatus,
  1277.              traceRouteResultsCurHopCount,
  1278.              traceRouteResultsCurProbeCount,
  1279.              traceRouteResultsIpTgtAddrType,
  1280.              traceRouteResultsIpTgtAddr,
  1281.              traceRouteResultsTestAttempts,
  1282.              traceRouteResultsTestSuccesses,
  1283.              traceRouteProbeHistoryHAddrType,
  1284.              traceRouteProbeHistoryHAddr,
  1285.              traceRouteProbeHistoryResponse,
  1286.              traceRouteProbeHistoryStatus,
  1287.              traceRouteProbeHistoryLastRC
  1288.           }
  1289.    STATUS  current
  1290.    DESCRIPTION
  1291.        "The group of objects that comprise the remote traceroute
  1292.        operation."
  1293.    ::= { traceRouteGroups 1 }
  1294.  
  1295.  traceRouteTimeStampGroup OBJECT-GROUP
  1296.    OBJECTS {
  1297.              traceRouteResultsLastGoodPath,
  1298.              traceRouteProbeHistoryTime
  1299.            }
  1300.    STATUS  current
  1301.    DESCRIPTION
  1302.  
  1303.        "The group of DateAndTime objects."
  1304.     ::= { traceRouteGroups 2 }
  1305.  
  1306.  traceRouteNotificationsGroup NOTIFICATION-GROUP
  1307.    NOTIFICATIONS {
  1308.              traceRoutePathChange,
  1309.              traceRouteTestFailed,
  1310.              traceRouteTestCompleted
  1311.           }
  1312.    STATUS   current
  1313.    DESCRIPTION
  1314.        "The notifications which are required to be supported by
  1315.        implementations of this MIB."
  1316.    ::= { traceRouteGroups 3 }
  1317.  
  1318.  traceRouteHopsTableGroup OBJECT-GROUP
  1319.    OBJECTS {
  1320.              traceRouteHopsIpTgtAddressType,
  1321.              traceRouteHopsIpTgtAddress,
  1322.              traceRouteHopsMinRtt,
  1323.              traceRouteHopsMaxRtt,
  1324.              traceRouteHopsAverageRtt,
  1325.              traceRouteHopsRttSumOfSquares,
  1326.              traceRouteHopsSentProbes,
  1327.              traceRouteHopsProbeResponses,
  1328.              traceRouteHopsLastGoodProbe
  1329.            }
  1330.     STATUS   current
  1331.     DESCRIPTION
  1332.         "The group of objects that comprise the traceRouteHopsTable."
  1333.   ::= { traceRouteGroups 4 }
  1334.  
  1335. END
  1336.