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