home *** CD-ROM | disk | FTP | other *** search
/ The Hacker's Encyclopedia 1998 / hackers_encyclopedia.iso / rfc / 3 / rfc2096.txt < prev    next >
Encoding:
Text File  |  2003-06-11  |  35.1 KB  |  1,180 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Network Working Group                                           F. Baker
  8. Request for Comments: 2096                                 Cisco Systems
  9. Obsoletes: 1354                                             January 1997
  10. Category: Standards Track
  11.  
  12.  
  13.                         IP Forwarding Table MIB
  14.  
  15. Status of this Memo
  16.  
  17.    This document specifies an Internet standards track protocol for the
  18.    Internet community, and requests discussion and suggestions for
  19.    improvements.  Please refer to the current edition of the "Internet
  20.    Official Protocol Standards" (STD 1) for the standardization state
  21.    and status of this protocol.  Distribution of this memo is unlimited.
  22.  
  23. Table of Contents
  24.  
  25.    1. Introduction ..........................................    1
  26.    2. The SNMP Network Management Framework .................    2
  27.    2.1 Object Definitions ...................................    2
  28.    3. Overview ..............................................    2
  29.    4. Definitions ...........................................    3
  30.    5. Acknowledgements ......................................   20
  31.    6. References ............................................   20
  32.    7. Security Considerations ...............................   21
  33.    8. Author's Address ......................................   21
  34.  
  35.  
  36. 1.  Introduction
  37.  
  38.    This memo defines an update to RFC 1354, "IP Forwarding Table MIB",
  39.    for Classless Inter-Domain Routing (CIDR).  That document was
  40.    developed by the Router Requirements Working Group as an update to
  41.    RFC 1213's ipRouteTable, with the display of multiple routes as
  42.    a primary objective.  The significant difference between this MIB and
  43.    RFC 1354 is the recognition (explicitly discussed but by consensus
  44.    left to future work) that CIDR routes may have the
  45.    same network number but different network masks.  Note that this MIB
  46.    obsoletes a number of objects from RFC 1354.  The reader should pay
  47.    careful attention to the STATUS field.
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58. Baker                       Standards Track                     [Page 1]
  59.  
  60. RFC 2096                IP Forwarding Table MIB             January 1997
  61.  
  62.  
  63. 2.  The SNMP Network Management Framework
  64.  
  65.    The SNMP Network Management Framework presently consists of three
  66.    major components.  They are:
  67.  
  68.    o    the SMI, described in RFC 1902 [1], - the mechanisms used
  69.         for describing and naming objects for the purpose of
  70.         management.
  71.  
  72.    o    the MIB-II, STD 17, RFC 1213 [2], - the core set of
  73.         managed objects for the Internet suite of protocols.
  74.  
  75.    o    the protocol, RFC 1157 [6] and/or RFC 1905 [4], - the
  76.         protocol for accessing managed information.
  77.  
  78.    Textual conventions are defined in RFC 1903 [3], and conformance
  79.    statements are defined in RFC 1904 [5].
  80.  
  81.    The Framework permits new objects to be defined for the purpose of
  82.    experimentation and evaluation.
  83.  
  84. 2.1.  Object Definitions
  85.  
  86.    Managed objects are accessed via a virtual information store, termed
  87.    the Management Information Base or MIB.  Objects in the MIB
  88.    are defined using the subset of Abstract Syntax Notation One (ASN.1)
  89.    defined in the SMI.  In particular, each object object type is named
  90.    by an OBJECT IDENTIFIER, an administratively assigned name.  The
  91.    object type together with an object instance serves to uniquely
  92.    identify a specific instantiation of the object.  For
  93.    human convenience, we often use a textual string, termed the
  94.    descriptor, to refer to the object type.
  95.  
  96. 3.  Overview
  97.  
  98.    The MIB consists of two tables and two global objects.
  99.  
  100.    (1)  The object ipForwardNumber indicates the number of
  101.         current routes.  This is primarily to avoid having to
  102.         read the table in order to determine this number.
  103.  
  104.    (2)  The ipForwardTable updates the RFC 1213 ipRouteTable to
  105.         display multipath IP Routes.  This is in turn obsoleted
  106.         by the ipCidrRouteTable.
  107.  
  108.    (3)  The ipCidrRouteTable updates the RFC 1213 ipRouteTable to
  109.         display multipath IP Routes having the same network
  110.         number but differing network masks.
  111.  
  112.  
  113.  
  114. Baker                       Standards Track                     [Page 2]
  115.  
  116. RFC 2096                IP Forwarding Table MIB             January 1997
  117.  
  118.  
  119. 4.  Definitions
  120.  
  121. IP-FORWARD-MIB DEFINITIONS ::= BEGIN
  122.  
  123. IMPORTS
  124.     MODULE-IDENTITY, OBJECT-TYPE, IpAddress, Integer32, Gauge32
  125.         FROM SNMPv2-SMI
  126.     RowStatus
  127.         FROM SNMPv2-TC
  128.     ip
  129.         FROM RFC1213-MIB
  130.     MODULE-COMPLIANCE, OBJECT-GROUP
  131.         FROM SNMPv2-CONF;
  132.  
  133. ipForward MODULE-IDENTITY
  134.     LAST-UPDATED "9609190000Z"     -- Thu Sep 26 16:34:47 PDT 1996
  135.     ORGANIZATION "IETF OSPF Working Group"
  136.     CONTACT-INFO
  137.      "        Fred Baker
  138.       Postal: Cisco Systems
  139.               519 Lado Drive
  140.               Santa Barbara, California 93111
  141.  
  142.       Phone:  +1 805 681 0115
  143.       Email:  fred@cisco.com
  144.       "
  145.     DESCRIPTION
  146.             "The MIB module for the display of CIDR multipath IP Routes."
  147.     REVISION      "9609190000Z"
  148.     DESCRIPTION
  149.             "Revisions made by the OSPF WG."
  150.     ::= { ip 24 }
  151.  
  152. ipCidrRouteNumber OBJECT-TYPE
  153.     SYNTAX   Gauge32
  154.     MAX-ACCESS read-only
  155.     STATUS   current
  156.     DESCRIPTION
  157.        "The number of current ipCidrRouteTable entries
  158.        that are not invalid."
  159.     ::= { ipForward 3 }
  160.  
  161. --  IP CIDR Route Table
  162.  
  163. --  The IP CIDR Route Table obsoletes and replaces the ipRoute
  164. --  Table current in MIB-I and MIB-II and the IP Forwarding Table.
  165. --  It adds knowledge of the autonomous system of the next hop,
  166. --  multiple next hops, and policy routing, and Classless
  167.  
  168.  
  169.  
  170. Baker                       Standards Track                     [Page 3]
  171.  
  172. RFC 2096                IP Forwarding Table MIB             January 1997
  173.  
  174.  
  175. --  Inter-Domain Routing.
  176.  
  177. ipCidrRouteTable OBJECT-TYPE
  178.     SYNTAX   SEQUENCE OF IpCidrRouteEntry
  179.     MAX-ACCESS not-accessible
  180.     STATUS   current
  181.     DESCRIPTION
  182.        "This entity's IP Routing table."
  183.     REFERENCE
  184.        "RFC 1213 Section 6.6, The IP Group"
  185.     ::= { ipForward 4 }
  186.  
  187. ipCidrRouteEntry OBJECT-TYPE
  188.     SYNTAX   IpCidrRouteEntry
  189.     MAX-ACCESS not-accessible
  190.     STATUS   current
  191.     DESCRIPTION
  192.        "A particular route to  a  particular  destina-
  193.        tion, under a particular policy."
  194.     INDEX {
  195.         ipCidrRouteDest,
  196.         ipCidrRouteMask,
  197.         ipCidrRouteTos,
  198.         ipCidrRouteNextHop
  199.         }
  200.     ::= { ipCidrRouteTable 1 }
  201.  
  202. IpCidrRouteEntry ::=
  203.     SEQUENCE {
  204.         ipCidrRouteDest
  205.             IpAddress,
  206.         ipCidrRouteMask
  207.             IpAddress,
  208.         ipCidrRouteTos
  209.              Integer32,
  210.         ipCidrRouteNextHop
  211.             IpAddress,
  212.         ipCidrRouteIfIndex
  213.             Integer32,
  214.         ipCidrRouteType
  215.             INTEGER,
  216.         ipCidrRouteProto
  217.             INTEGER,
  218.         ipCidrRouteAge
  219.             Integer32,
  220.         ipCidrRouteInfo
  221.             OBJECT IDENTIFIER,
  222.         ipCidrRouteNextHopAS
  223.  
  224.  
  225.  
  226. Baker                       Standards Track                     [Page 4]
  227.  
  228. RFC 2096                IP Forwarding Table MIB             January 1997
  229.  
  230.  
  231.             Integer32,
  232.         ipCidrRouteMetric1
  233.             Integer32,
  234.         ipCidrRouteMetric2
  235.             Integer32,
  236.         ipCidrRouteMetric3
  237.             Integer32,
  238.         ipCidrRouteMetric4
  239.             Integer32,
  240.         ipCidrRouteMetric5
  241.             Integer32,
  242.         ipCidrRouteStatus
  243.             RowStatus
  244.     }
  245.  
  246. ipCidrRouteDest OBJECT-TYPE
  247.     SYNTAX   IpAddress
  248.     MAX-ACCESS read-only
  249.     STATUS   current
  250.     DESCRIPTION
  251.        "The destination IP address of this route.
  252.  
  253.        This object may not take a Multicast (Class  D)
  254.        address value.
  255.  
  256.        Any assignment (implicit or  otherwise)  of  an
  257.        instance  of  this  object to a value x must be
  258.        rejected if the bitwise logical-AND of  x  with
  259.        the  value of the corresponding instance of the
  260.        ipCidrRouteMask object is not equal to x."
  261.     ::= { ipCidrRouteEntry 1 }
  262.  
  263. ipCidrRouteMask OBJECT-TYPE
  264.     SYNTAX   IpAddress
  265.     MAX-ACCESS read-only
  266.     STATUS   current
  267.     DESCRIPTION
  268.        "Indicate the mask to be logical-ANDed with the
  269.        destination  address  before  being compared to
  270.        the value  in  the  ipCidrRouteDest  field.   For
  271.        those  systems  that  do  not support arbitrary
  272.        subnet masks, an agent constructs the value  of
  273.        the  ipCidrRouteMask  by  reference to the IP Ad-
  274.        dress Class.
  275.  
  276.        Any assignment (implicit or  otherwise)  of  an
  277.        instance  of  this  object to a value x must be
  278.        rejected if the bitwise logical-AND of  x  with
  279.  
  280.  
  281.  
  282. Baker                       Standards Track                     [Page 5]
  283.  
  284. RFC 2096                IP Forwarding Table MIB             January 1997
  285.  
  286.  
  287.        the  value of the corresponding instance of the
  288.        ipCidrRouteDest object is not equal to ipCidrRoute-
  289.        Dest."
  290.     ::= { ipCidrRouteEntry 2 }
  291.  
  292. -- The following convention is included for specification
  293. -- of TOS Field contents.  At this time, the Host Requirements
  294. -- and the Router Requirements documents disagree on the width
  295. -- of the TOS field.  This mapping describes the Router
  296. -- Requirements mapping, and leaves room to widen the TOS field
  297. -- without impact to fielded systems.
  298.  
  299. ipCidrRouteTos OBJECT-TYPE
  300.     SYNTAX   Integer32
  301.     MAX-ACCESS read-only
  302.     STATUS   current
  303.     DESCRIPTION
  304.        "The policy specifier is the IP TOS Field.  The encoding
  305.        of IP TOS is as specified  by  the  following convention.
  306.        Zero indicates the default path if no more  specific
  307.        policy applies.
  308.  
  309.        +-----+-----+-----+-----+-----+-----+-----+-----+
  310.        |                 |                       |     |
  311.        |   PRECEDENCE    |    TYPE OF SERVICE    |  0  |
  312.        |                 |                       |     |
  313.        +-----+-----+-----+-----+-----+-----+-----+-----+
  314.  
  315.                 IP TOS                IP TOS
  316.            Field     Policy      Field     Policy
  317.            Contents    Code      Contents    Code
  318.            0 0 0 0  ==>   0      0 0 0 1  ==>   2
  319.            0 0 1 0  ==>   4      0 0 1 1  ==>   6
  320.            0 1 0 0  ==>   8      0 1 0 1  ==>  10
  321.            0 1 1 0  ==>  12      0 1 1 1  ==>  14
  322.            1 0 0 0  ==>  16      1 0 0 1  ==>  18
  323.            1 0 1 0  ==>  20      1 0 1 1  ==>  22
  324.            1 1 0 0  ==>  24      1 1 0 1  ==>  26
  325.            1 1 1 0  ==>  28      1 1 1 1  ==>  30"
  326.     ::= { ipCidrRouteEntry 3 }
  327.  
  328. ipCidrRouteNextHop OBJECT-TYPE
  329.     SYNTAX   IpAddress
  330.     MAX-ACCESS read-only
  331.     STATUS   current
  332.     DESCRIPTION
  333.        "On remote routes, the address of the next sys-
  334.        tem en route; Otherwise, 0.0.0.0."
  335.  
  336.  
  337.  
  338. Baker                       Standards Track                     [Page 6]
  339.  
  340. RFC 2096                IP Forwarding Table MIB             January 1997
  341.  
  342.  
  343.     ::= { ipCidrRouteEntry 4 }
  344.  
  345. ipCidrRouteIfIndex OBJECT-TYPE
  346.     SYNTAX   Integer32
  347.     MAX-ACCESS read-create
  348.     STATUS   current
  349.     DESCRIPTION
  350.        "The ifIndex value which identifies  the  local
  351.        interface  through  which  the next hop of this
  352.        route should be reached."
  353.     DEFVAL { 0 }
  354.     ::= { ipCidrRouteEntry 5 }
  355.  
  356. ipCidrRouteType OBJECT-TYPE
  357.     SYNTAX   INTEGER {
  358.                 other    (1), -- not specified by this MIB
  359.                 reject   (2), -- route which discards traffic
  360.                 local    (3), -- local interface
  361.                 remote   (4)  -- remote destination
  362.              }
  363.     MAX-ACCESS read-create
  364.     STATUS   current
  365.     DESCRIPTION
  366.        "The type of route.  Note that local(3)  refers
  367.        to  a route for which the next hop is the final
  368.        destination; remote(4) refers to  a  route  for
  369.        which  the  next  hop is not the final destina-
  370.        tion.
  371.  
  372.        Routes which do not result in traffic forwarding or
  373.        rejection should not be displayed even if the
  374.        implementation keeps them stored internally.
  375.  
  376.  
  377.        reject (2) refers to a route which, if matched, discards
  378.        the message as unreachable. This is used in some
  379.        protocols as a means of correctly aggregating routes."
  380.     ::= { ipCidrRouteEntry 6 }
  381.  
  382. ipCidrRouteProto OBJECT-TYPE
  383.     SYNTAX   INTEGER {
  384.                 other     (1),  -- not specified
  385.                 local     (2),  -- local interface
  386.                 netmgmt   (3),  -- static route
  387.                 icmp      (4),  -- result of ICMP Redirect
  388.  
  389.                         -- the following are all dynamic
  390.                         -- routing protocols
  391.  
  392.  
  393.  
  394. Baker                       Standards Track                     [Page 7]
  395.  
  396. RFC 2096                IP Forwarding Table MIB             January 1997
  397.  
  398.  
  399.                 egp        (5),  -- Exterior Gateway Protocol
  400.                 ggp        (6),  -- Gateway-Gateway Protocol
  401.                 hello      (7),  -- FuzzBall HelloSpeak
  402.                 rip        (8),  -- Berkeley RIP or RIP-II
  403.                 isIs       (9),  -- Dual IS-IS
  404.                 esIs       (10), -- ISO 9542
  405.                 ciscoIgrp  (11), -- Cisco IGRP
  406.                 bbnSpfIgp  (12), -- BBN SPF IGP
  407.                 ospf       (13), -- Open Shortest Path First
  408.                 bgp        (14), -- Border Gateway Protocol
  409.                 idpr       (15), -- InterDomain Policy Routing
  410.                 ciscoEigrp (16)  -- Cisco EIGRP
  411.              }
  412.     MAX-ACCESS read-only
  413.     STATUS   current
  414.     DESCRIPTION
  415.        "The routing mechanism via which this route was
  416.        learned.  Inclusion of values for gateway rout-
  417.        ing protocols is not  intended  to  imply  that
  418.        hosts should support those protocols."
  419.     ::= { ipCidrRouteEntry 7 }
  420.  
  421. ipCidrRouteAge OBJECT-TYPE
  422.     SYNTAX   Integer32
  423.     MAX-ACCESS read-only
  424.     STATUS   current
  425.     DESCRIPTION
  426.        "The number of seconds  since  this  route  was
  427.        last  updated  or  otherwise  determined  to be
  428.        correct.  Note that no semantics of  `too  old'
  429.        can  be implied except through knowledge of the
  430.        routing  protocol  by  which  the   route   was
  431.        learned."
  432.     DEFVAL  { 0 }
  433.     ::= { ipCidrRouteEntry 8 }
  434.  
  435. ipCidrRouteInfo OBJECT-TYPE
  436.     SYNTAX   OBJECT IDENTIFIER
  437.     MAX-ACCESS read-create
  438.     STATUS   current
  439.     DESCRIPTION
  440.        "A reference to MIB definitions specific to the
  441.        particular  routing protocol which is responsi-
  442.        ble for this route, as determined by the  value
  443.        specified  in the route's ipCidrRouteProto value.
  444.        If this information is not present,  its  value
  445.        should be set to the OBJECT IDENTIFIER { 0 0 },
  446.        which is a syntactically valid object  identif-
  447.  
  448.  
  449.  
  450. Baker                       Standards Track                     [Page 8]
  451.  
  452. RFC 2096                IP Forwarding Table MIB             January 1997
  453.  
  454.  
  455.        ier, and any implementation conforming to ASN.1
  456.        and the Basic Encoding Rules must  be  able  to
  457.        generate and recognize this value."
  458.     ::= { ipCidrRouteEntry 9 }
  459.  
  460. ipCidrRouteNextHopAS OBJECT-TYPE
  461.     SYNTAX   Integer32
  462.     MAX-ACCESS read-create
  463.     STATUS   current
  464.     DESCRIPTION
  465.        "The Autonomous System Number of the Next  Hop.
  466.        The  semantics of this object are determined by
  467.        the routing-protocol specified in  the  route's
  468.        ipCidrRouteProto  value. When  this object is
  469.        unknown or not relevant its value should be set
  470.        to zero."
  471.     DEFVAL { 0 }
  472.     ::= { ipCidrRouteEntry 10 }
  473.  
  474. ipCidrRouteMetric1 OBJECT-TYPE
  475.     SYNTAX   Integer32
  476.     MAX-ACCESS read-create
  477.     STATUS   current
  478.     DESCRIPTION
  479.        "The primary routing  metric  for  this  route.
  480.        The  semantics of this metric are determined by
  481.        the routing-protocol specified in  the  route's
  482.        ipCidrRouteProto  value.   If  this metric is not
  483.        used, its value should be set to -1."
  484.     DEFVAL { -1 }
  485.     ::= { ipCidrRouteEntry 11 }
  486.  
  487. ipCidrRouteMetric2 OBJECT-TYPE
  488.     SYNTAX   Integer32
  489.     MAX-ACCESS read-create
  490.     STATUS   current
  491.     DESCRIPTION
  492.        "An alternate routing metric  for  this  route.
  493.        The  semantics of this metric are determined by
  494.        the routing-protocol specified in  the  route's
  495.        ipCidrRouteProto  value.   If  this metric is not
  496.        used, its value should be set to -1."
  497.     DEFVAL { -1 }
  498.     ::= { ipCidrRouteEntry 12 }
  499.  
  500. ipCidrRouteMetric3 OBJECT-TYPE
  501.     SYNTAX   Integer32
  502.     MAX-ACCESS read-create
  503.  
  504.  
  505.  
  506. Baker                       Standards Track                     [Page 9]
  507.  
  508. RFC 2096                IP Forwarding Table MIB             January 1997
  509.  
  510.  
  511.     STATUS   current
  512.     DESCRIPTION
  513.        "An alternate routing metric  for  this  route.
  514.        The  semantics of this metric are determined by
  515.        the routing-protocol specified in  the  route's
  516.        ipCidrRouteProto  value.   If  this metric is not
  517.        used, its value should be set to -1."
  518.     DEFVAL { -1 }
  519.     ::= { ipCidrRouteEntry 13 }
  520.  
  521. ipCidrRouteMetric4 OBJECT-TYPE
  522.     SYNTAX   Integer32
  523.     MAX-ACCESS read-create
  524.     STATUS   current
  525.     DESCRIPTION
  526.        "An alternate routing metric  for  this  route.
  527.        The  semantics of this metric are determined by
  528.        the routing-protocol specified in  the  route's
  529.        ipCidrRouteProto  value.   If  this metric is not
  530.        used, its value should be set to -1."
  531.     DEFVAL { -1 }
  532.     ::= { ipCidrRouteEntry 14 }
  533.  
  534. ipCidrRouteMetric5 OBJECT-TYPE
  535.     SYNTAX   Integer32
  536.     MAX-ACCESS read-create
  537.     STATUS   current
  538.     DESCRIPTION
  539.        "An alternate routing metric  for  this  route.
  540.        The  semantics of this metric are determined by
  541.        the routing-protocol specified in  the  route's
  542.        ipCidrRouteProto  value.   If  this metric is not
  543.        used, its value should be set to -1."
  544.     DEFVAL { -1 }
  545.     ::= { ipCidrRouteEntry 15 }
  546.  
  547. ipCidrRouteStatus OBJECT-TYPE
  548.     SYNTAX   RowStatus
  549.     MAX-ACCESS read-create
  550.     STATUS   current
  551.     DESCRIPTION
  552.        "The row status variable, used according to
  553.        row installation and removal conventions."
  554.     ::= { ipCidrRouteEntry 16 }
  555.  
  556. -- conformance information
  557.  
  558. ipForwardConformance OBJECT IDENTIFIER ::= { ipForward 5 }
  559.  
  560.  
  561.  
  562. Baker                       Standards Track                    [Page 10]
  563.  
  564. RFC 2096                IP Forwarding Table MIB             January 1997
  565.  
  566.  
  567. ipForwardGroups      OBJECT IDENTIFIER ::= { ipForwardConformance 1 }
  568. ipForwardCompliances OBJECT IDENTIFIER ::= { ipForwardConformance 2 }
  569.  
  570. -- compliance statements
  571.  
  572. ipForwardCompliance MODULE-COMPLIANCE
  573.    STATUS  current
  574.    DESCRIPTION
  575.        "The compliance statement for SNMPv2 entities
  576.        which implement the ipForward MIB."
  577.  
  578.    MODULE  -- this module
  579.    MANDATORY-GROUPS { ipForwardCidrRouteGroup }
  580.  
  581.    ::= { ipForwardCompliances 1 }
  582.  
  583. -- units of conformance
  584.  
  585. ipForwardCidrRouteGroup OBJECT-GROUP
  586.     OBJECTS { ipCidrRouteNumber,
  587.               ipCidrRouteDest, ipCidrRouteMask, ipCidrRouteTos,
  588.               ipCidrRouteNextHop, ipCidrRouteIfIndex, ipCidrRouteType,
  589.               ipCidrRouteProto, ipCidrRouteAge, ipCidrRouteInfo,
  590.               ipCidrRouteNextHopAS, ipCidrRouteMetric1,
  591.               ipCidrRouteMetric2, ipCidrRouteMetric3,
  592.               ipCidrRouteMetric4, ipCidrRouteMetric5, ipCidrRouteStatus
  593.         }
  594.     STATUS  current
  595.     DESCRIPTION
  596.        "The CIDR Route Table."
  597.     ::= { ipForwardGroups 3 }
  598.  
  599. -- Obsoleted Definitions - Objects
  600.  
  601. ipForwardNumber OBJECT-TYPE
  602.     SYNTAX   Gauge32
  603.     MAX-ACCESS read-only
  604.     STATUS   obsolete
  605.     DESCRIPTION
  606.        "The number of current  ipForwardTable  entries
  607.        that are not invalid."
  608.     ::= { ipForward 1 }
  609.  
  610. --  IP Forwarding Table
  611.  
  612. --  The IP Forwarding Table obsoletes and replaces the ipRoute
  613. --  Table current in MIB-I and MIB-II.  It adds knowledge of
  614. --  the autonomous system of the next hop, multiple next hop
  615.  
  616.  
  617.  
  618. Baker                       Standards Track                    [Page 11]
  619.  
  620. RFC 2096                IP Forwarding Table MIB             January 1997
  621.  
  622.  
  623. --  support, and policy routing support.
  624.  
  625. ipForwardTable OBJECT-TYPE
  626.     SYNTAX   SEQUENCE OF IpForwardEntry
  627.     MAX-ACCESS not-accessible
  628.     STATUS   obsolete
  629.     DESCRIPTION
  630.        "This entity's IP Routing table."
  631.     REFERENCE
  632.        "RFC 1213 Section 6.6, The IP Group"
  633.     ::= { ipForward 2 }
  634.  
  635. ipForwardEntry OBJECT-TYPE
  636.     SYNTAX   IpForwardEntry
  637.     MAX-ACCESS not-accessible
  638.     STATUS   obsolete
  639.     DESCRIPTION
  640.        "A particular route to  a  particular  destina-
  641.        tion, under a particular policy."
  642.     INDEX {
  643.         ipForwardDest,
  644.         ipForwardProto,
  645.         ipForwardPolicy,
  646.         ipForwardNextHop
  647.         }
  648.     ::= { ipForwardTable 1 }
  649.  
  650. IpForwardEntry ::=
  651.     SEQUENCE {
  652.         ipForwardDest
  653.             IpAddress,
  654.         ipForwardMask
  655.             IpAddress,
  656.         ipForwardPolicy
  657.              Integer32,
  658.         ipForwardNextHop
  659.             IpAddress,
  660.         ipForwardIfIndex
  661.             Integer32,
  662.         ipForwardType
  663.             INTEGER,
  664.         ipForwardProto
  665.             INTEGER,
  666.         ipForwardAge
  667.             Integer32,
  668.         ipForwardInfo
  669.             OBJECT IDENTIFIER,
  670.         ipForwardNextHopAS
  671.  
  672.  
  673.  
  674. Baker                       Standards Track                    [Page 12]
  675.  
  676. RFC 2096                IP Forwarding Table MIB             January 1997
  677.  
  678.  
  679.             Integer32,
  680.         ipForwardMetric1
  681.             Integer32,
  682.         ipForwardMetric2
  683.             Integer32,
  684.         ipForwardMetric3
  685.             Integer32,
  686.         ipForwardMetric4
  687.             Integer32,
  688.         ipForwardMetric5
  689.             Integer32
  690.     }
  691.  
  692. ipForwardDest OBJECT-TYPE
  693.     SYNTAX   IpAddress
  694.     MAX-ACCESS read-only
  695.     STATUS   obsolete
  696.     DESCRIPTION
  697.        "The destination IP address of this route.   An
  698.        entry  with  a value of 0.0.0.0 is considered a
  699.        default route.
  700.  
  701.        This object may not take a Multicast (Class  D)
  702.        address value.
  703.  
  704.        Any assignment (implicit or  otherwise)  of  an
  705.        instance  of  this  object to a value x must be
  706.        rejected if the bitwise logical-AND of  x  with
  707.        the  value of the corresponding instance of the
  708.        ipForwardMask object is not equal to x."
  709.     ::= { ipForwardEntry 1 }
  710.  
  711. ipForwardMask OBJECT-TYPE
  712.     SYNTAX   IpAddress
  713.     MAX-ACCESS read-create
  714.     STATUS   obsolete
  715.     DESCRIPTION
  716.        "Indicate the mask to be logical-ANDed with the
  717.        destination  address  before  being compared to
  718.        the value  in  the  ipForwardDest  field.   For
  719.        those  systems  that  do  not support arbitrary
  720.        subnet masks, an agent constructs the value  of
  721.        the  ipForwardMask  by  reference to the IP Ad-
  722.        dress Class.
  723.  
  724.        Any assignment (implicit or  otherwise)  of  an
  725.        instance  of  this  object to a value x must be
  726.        rejected if the bitwise logical-AND of  x  with
  727.  
  728.  
  729.  
  730. Baker                       Standards Track                    [Page 13]
  731.  
  732. RFC 2096                IP Forwarding Table MIB             January 1997
  733.  
  734.  
  735.        the  value of the corresponding instance of the
  736.        ipForwardDest object is not equal to ipForward-
  737.        Dest."
  738.     DEFVAL { '00000000'h }      -- 0.0.0.0
  739.     ::= { ipForwardEntry 2 }
  740.  
  741. -- The following convention is included for specification
  742. -- of TOS Field contents.  At this time, the Host Requirements
  743. -- and the Router Requirements documents disagree on the width
  744. -- of the TOS field.  This mapping describes the Router
  745. -- Requirements mapping, and leaves room to widen the TOS field
  746. -- without impact to fielded systems.
  747.  
  748. ipForwardPolicy OBJECT-TYPE
  749.     SYNTAX   Integer32
  750.     MAX-ACCESS read-only
  751.     STATUS   obsolete
  752.     DESCRIPTION
  753.        "The general set of conditions that would cause
  754.        the  selection  of  one multipath route (set of
  755.        next hops for a given destination) is  referred
  756.        to as 'policy'.
  757.  
  758.        Unless the mechanism indicated by ipForwardPro-
  759.        to specifies otherwise, the policy specifier is
  760.        the IP TOS Field.  The encoding of IP TOS is as
  761.         specified  by  the  following convention.  Zero
  762.        indicates the default path if no more  specific
  763.        policy applies.
  764.  
  765.        +-----+-----+-----+-----+-----+-----+-----+-----+
  766.        |                 |                       |     |
  767.        |   PRECEDENCE    |    TYPE OF SERVICE    |  0  |
  768.        |                 |                       |     |
  769.        +-----+-----+-----+-----+-----+-----+-----+-----+
  770.  
  771.                 IP TOS                IP TOS
  772.            Field     Policy      Field     Policy
  773.            Contents    Code      Contents    Code
  774.            0 0 0 0  ==>   0      0 0 0 1  ==>   2
  775.            0 0 1 0  ==>   4      0 0 1 1  ==>   6
  776.            0 1 0 0  ==>   8      0 1 0 1  ==>  10
  777.            0 1 1 0  ==>  12      0 1 1 1  ==>  14
  778.            1 0 0 0  ==>  16      1 0 0 1  ==>  18
  779.            1 0 1 0  ==>  20      1 0 1 1  ==>  22
  780.            1 1 0 0  ==>  24      1 1 0 1  ==>  26
  781.            1 1 1 0  ==>  28      1 1 1 1  ==>  30
  782.  
  783.  
  784.  
  785.  
  786. Baker                       Standards Track                    [Page 14]
  787.  
  788. RFC 2096                IP Forwarding Table MIB             January 1997
  789.  
  790.  
  791.        Protocols defining 'policy' otherwise must  ei-
  792.        ther define a set of values which are valid for
  793.        this  object  or  must  implement  an  integer-
  794.        instanced  policy table for which this object's
  795.        value acts as an index."
  796.     ::= { ipForwardEntry 3 }
  797.  
  798. ipForwardNextHop OBJECT-TYPE
  799.     SYNTAX   IpAddress
  800.     MAX-ACCESS read-only
  801.     STATUS   obsolete
  802.     DESCRIPTION
  803.        "On remote routes, the address of the next sys-
  804.        tem en route; Otherwise, 0.0.0.0."
  805.     ::= { ipForwardEntry 4 }
  806.  
  807. ipForwardIfIndex OBJECT-TYPE
  808.     SYNTAX   Integer32
  809.     MAX-ACCESS read-create
  810.     STATUS   obsolete
  811.     DESCRIPTION
  812.        "The ifIndex value which identifies  the  local
  813.        interface  through  which  the next hop of this
  814.        route should be reached."
  815.     DEFVAL { 0 }
  816.     ::= { ipForwardEntry 5 }
  817.  
  818. ipForwardType OBJECT-TYPE
  819.     SYNTAX   INTEGER {
  820.                 other    (1), -- not specified by this MIB
  821.                 invalid  (2), -- logically deleted
  822.                 local    (3), -- local interface
  823.                 remote   (4)  -- remote destination
  824.              }
  825.     MAX-ACCESS read-create
  826.     STATUS   obsolete
  827.     DESCRIPTION
  828.        "The type of route.  Note that local(3)  refers
  829.        to  a route for which the next hop is the final
  830.        destination; remote(4) refers to  a  route  for
  831.        which  the  next  hop is not the final destina-
  832.        tion.
  833.  
  834.        Setting this object to the value invalid(2) has
  835.        the  effect  of  invalidating the corresponding
  836.        entry in the ipForwardTable object.   That  is,
  837.        it  effectively  disassociates  the destination
  838.        identified with said entry from the route iden-
  839.  
  840.  
  841.  
  842. Baker                       Standards Track                    [Page 15]
  843.  
  844. RFC 2096                IP Forwarding Table MIB             January 1997
  845.  
  846.  
  847.        tified    with    said   entry.    It   is   an
  848.        implementation-specific matter  as  to  whether
  849.        the agent removes an invalidated entry from the
  850.        table.  Accordingly, management  stations  must
  851.        be prepared to receive tabular information from
  852.        agents that corresponds to entries not current-
  853.        ly  in  use.  Proper interpretation of such en-
  854.        tries requires examination of the relevant  ip-
  855.        ForwardType object."
  856.     DEFVAL { invalid }
  857.     ::= { ipForwardEntry 6 }
  858.  
  859. ipForwardProto OBJECT-TYPE
  860.     SYNTAX   INTEGER {
  861.                 other     (1),  -- not specified
  862.                 local     (2),  -- local interface
  863.                 netmgmt   (3),  -- static route
  864.                 icmp      (4),  -- result of ICMP Redirect
  865.  
  866.                         -- the following are all dynamic
  867.                         -- routing protocols
  868.                 egp       (5),  -- Exterior Gateway Protocol
  869.                 ggp       (6),  -- Gateway-Gateway Protocol
  870.                 hello     (7),  -- FuzzBall HelloSpeak
  871.                 rip       (8),  -- Berkeley RIP or RIP-II
  872.                 is-is     (9),  -- Dual IS-IS
  873.                 es-is     (10), -- ISO 9542
  874.                 ciscoIgrp (11), -- Cisco IGRP
  875.                 bbnSpfIgp (12), -- BBN SPF IGP
  876.                 ospf      (13), -- Open Shortest Path First
  877.                 bgp       (14), -- Border Gateway Protocol
  878.                 idpr      (15)  -- InterDomain Policy Routing
  879.              }
  880.     MAX-ACCESS read-only
  881.     STATUS   obsolete
  882.     DESCRIPTION
  883.        "The routing mechanism via which this route was
  884.        learned.  Inclusion of values for gateway rout-
  885.        ing protocols is not  intended  to  imply  that
  886.        hosts should support those protocols."
  887.     ::= { ipForwardEntry 7 }
  888.  
  889. ipForwardAge OBJECT-TYPE
  890.     SYNTAX   Integer32
  891.     MAX-ACCESS read-only
  892.     STATUS   obsolete
  893.     DESCRIPTION
  894.        "The number of seconds  since  this  route  was
  895.  
  896.  
  897.  
  898. Baker                       Standards Track                    [Page 16]
  899.  
  900. RFC 2096                IP Forwarding Table MIB             January 1997
  901.  
  902.  
  903.        last  updated  or  otherwise  determined  to be
  904.        correct.  Note that no semantics of  `too  old'
  905.        can  be implied except through knowledge of the
  906.        routing  protocol  by  which  the   route   was
  907.        learned."
  908.     DEFVAL  { 0 }
  909.     ::= { ipForwardEntry 8 }
  910.  
  911. ipForwardInfo OBJECT-TYPE
  912.     SYNTAX   OBJECT IDENTIFIER
  913.     MAX-ACCESS read-create
  914.     STATUS   obsolete
  915.     DESCRIPTION
  916.        "A reference to MIB definitions specific to the
  917.        particular  routing protocol which is responsi-
  918.        ble for this route, as determined by the  value
  919.        specified  in the route's ipForwardProto value.
  920.        If this information is not present,  its  value
  921.        should be set to the OBJECT IDENTIFIER { 0 0 },
  922.        which is a syntactically valid object  identif-
  923.        ier, and any implementation conforming to ASN.1
  924.        and the Basic Encoding Rules must  be  able  to
  925.        generate and recognize this value."
  926.     ::= { ipForwardEntry 9 }
  927.  
  928. ipForwardNextHopAS OBJECT-TYPE
  929.     SYNTAX   Integer32
  930.     MAX-ACCESS read-create
  931.     STATUS   obsolete
  932.     DESCRIPTION
  933.        "The Autonomous System Number of the Next  Hop.
  934.        When  this  is  unknown  or not relevant to the
  935.        protocol indicated by ipForwardProto, zero."
  936.     DEFVAL { 0 }
  937.     ::= { ipForwardEntry 10 }
  938.  
  939. ipForwardMetric1 OBJECT-TYPE
  940.     SYNTAX   Integer32
  941.     MAX-ACCESS read-create
  942.     STATUS   obsolete
  943.     DESCRIPTION
  944.        "The primary routing  metric  for  this  route.
  945.        The  semantics of this metric are determined by
  946.        the routing-protocol specified in  the  route's
  947.        ipForwardProto  value.   If  this metric is not
  948.        used, its value should be set to -1."
  949.     DEFVAL { -1 }
  950.     ::= { ipForwardEntry 11 }
  951.  
  952.  
  953.  
  954. Baker                       Standards Track                    [Page 17]
  955.  
  956. RFC 2096                IP Forwarding Table MIB             January 1997
  957.  
  958.  
  959. ipForwardMetric2 OBJECT-TYPE
  960.     SYNTAX   Integer32
  961.     MAX-ACCESS read-create
  962.     STATUS   obsolete
  963.     DESCRIPTION
  964.        "An alternate routing metric  for  this  route.
  965.        The  semantics of this metric are determined by
  966.        the routing-protocol specified in  the  route's
  967.        ipForwardProto  value.   If  this metric is not
  968.        used, its value should be set to -1."
  969.  
  970.     DEFVAL { -1 }
  971.     ::= { ipForwardEntry 12 }
  972.  
  973. ipForwardMetric3 OBJECT-TYPE
  974.     SYNTAX   Integer32
  975.     MAX-ACCESS read-create
  976.     STATUS   obsolete
  977.     DESCRIPTION
  978.        "An alternate routing metric  for  this  route.
  979.        The  semantics of this metric are determined by
  980.        the routing-protocol specified in  the  route's
  981.        ipForwardProto  value.   If  this metric is not
  982.        used, its value should be set to -1."
  983.     DEFVAL { -1 }
  984.     ::= { ipForwardEntry 13 }
  985.  
  986. ipForwardMetric4 OBJECT-TYPE
  987.     SYNTAX   Integer32
  988.     MAX-ACCESS read-create
  989.     STATUS   obsolete
  990.     DESCRIPTION
  991.        "An alternate routing metric  for  this  route.
  992.        The  semantics of this metric are determined by
  993.        the routing-protocol specified in  the  route's
  994.        ipForwardProto  value.   If  this metric is not
  995.        used, its value should be set to -1."
  996.     DEFVAL { -1 }
  997.     ::= { ipForwardEntry 14 }
  998.  
  999. ipForwardMetric5 OBJECT-TYPE
  1000.     SYNTAX   Integer32
  1001.     MAX-ACCESS read-create
  1002.     STATUS   obsolete
  1003.     DESCRIPTION
  1004.        "An alternate routing metric  for  this  route.
  1005.        The  semantics of this metric are determined by
  1006.        the routing-protocol specified in  the  route's
  1007.  
  1008.  
  1009.  
  1010. Baker                       Standards Track                    [Page 18]
  1011.  
  1012. RFC 2096                IP Forwarding Table MIB             January 1997
  1013.  
  1014.  
  1015.        ipForwardProto  value.   If  this metric is not
  1016.        used, its value should be set to -1."
  1017.     DEFVAL { -1 }
  1018.     ::= { ipForwardEntry 15 }
  1019.  
  1020. -- Obsoleted Definitions - Groups
  1021. -- compliance statements
  1022.  
  1023. ipForwardOldCompliance MODULE-COMPLIANCE
  1024.    STATUS  obsolete
  1025.    DESCRIPTION
  1026.        "The compliance statement for SNMP entities
  1027.        which implement the ipForward MIB."
  1028.  
  1029.    MODULE  -- this module
  1030.    MANDATORY-GROUPS { ipForwardMultiPathGroup }
  1031.  
  1032.    ::= { ipForwardCompliances 2 }
  1033.  
  1034. ipForwardMultiPathGroup OBJECT-GROUP
  1035.     OBJECTS { ipForwardNumber,
  1036.               ipForwardDest, ipForwardMask, ipForwardPolicy,
  1037.               ipForwardNextHop, ipForwardIfIndex, ipForwardType,
  1038.               ipForwardProto, ipForwardAge, ipForwardInfo,
  1039.               ipForwardNextHopAS,
  1040.               ipForwardMetric1, ipForwardMetric2, ipForwardMetric3,
  1041.               ipForwardMetric4, ipForwardMetric5
  1042.         }
  1043.     STATUS  obsolete
  1044.     DESCRIPTION
  1045.        "IP Multipath Route Table."
  1046.     ::= { ipForwardGroups 2 }
  1047.  
  1048. END
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066. Baker                       Standards Track                    [Page 19]
  1067.  
  1068. RFC 2096                IP Forwarding Table MIB             January 1997
  1069.  
  1070.  
  1071. 5.  Acknowledgements
  1072.  
  1073.    This work was originally performed by the Router Requirements
  1074.    Working Group at the request of the OSPF Working Group.  This update
  1075.    was performed under the auspices of the OSPF Working Group.  John Moy
  1076.    of Proteon Incorporated is the chair.
  1077.  
  1078. 6.  References
  1079.  
  1080. [1]  Case, J., McCloghrie, K., Rose, M., and S. Waldbusser,
  1081.      "Structure of Management Information for version 2 of the
  1082.      Simple Network Management Protocol (SNMPv2)", RFC 1442,
  1083.      SNMP Research, Inc., Hughes LAN Systems, Dover Beach
  1084.      Consulting, Inc., Carnegie Mellon University, April 1993.
  1085.  
  1086. [2]  Galvin, J., and K. McCloghrie, "Administrative Model for
  1087.      version 2 of the Simple Network Management Protocol
  1088.      (SNMPv2)", RFC 1445, Trusted Information Systems, Hughes
  1089.      LAN Systems, April 1993.
  1090.  
  1091. [3]  Case, J., McCloghrie, K., Rose, M., and S. Waldbusser,
  1092.      "Protocol Operations for version 2 of the Simple Network
  1093.      Management Protocol (SNMPv2)", RFC 1448, SNMP Research,
  1094.      Inc., Hughes LAN Systems, Dover Beach Consulting, Inc.,
  1095.      Carnegie Mellon University, April 1993.
  1096.  
  1097. [4]  McCloghrie, K., and M. Rose, "Management Information Base
  1098.      for Network Management of TCP/IP-based internets - MIB-
  1099.      II", STD 17, RFC 1213, Hughes LAN Systems, Performance
  1100.      Systems International, March 1991.
  1101.  
  1102. [5]  Postel, J., "Internet Protocol", STD 5, RFC 791,
  1103.      USC/Information Sciences Institute, September 1981.
  1104.  
  1105. [6]  Case, J., McCloghrie, K., Rose, M., and S. Waldbusser,
  1106.      "Textual Conventions for version 2 of the Simple Network
  1107.      Management Protocol (SNMPv2)", RFC 1443, SNMP Research,
  1108.      Inc., Hughes LAN Systems, Dover Beach Consulting, Inc.,
  1109.      Carnegie Mellon University, April 1993.
  1110.  
  1111. [7]  Baker, F., "IP Forwarding Table MIB", RFC 1354, July 1992.
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122. Baker                       Standards Track                    [Page 20]
  1123.  
  1124. RFC 2096                IP Forwarding Table MIB             January 1997
  1125.  
  1126.  
  1127. 7.  Security Considerations
  1128.  
  1129.    Security is an objective not in this MIB view.
  1130.  
  1131. 8.  Author's Address
  1132.  
  1133.    Fred Baker
  1134.    Cisco Systems
  1135.    519 Lado Drive
  1136.    Santa Barbara, California 93111
  1137.  
  1138.    Phone: +1 805 681 0115
  1139.    EMail: fred@cisco.com
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178. Baker                       Standards Track                    [Page 21]
  1179.  
  1180.