1 IP-FORWARD-MIB DEFINITIONS ::= BEGIN
4 MODULE-IDENTITY, OBJECT-TYPE, IpAddress, Integer32, Gauge32
10 MODULE-COMPLIANCE, OBJECT-GROUP
13 ipForward MODULE-IDENTITY
14 LAST-UPDATED "9609190000Z" -- Thu Sep 26 16:34:47 PDT 1996
15 ORGANIZATION "IETF OSPF Working Group"
20 Santa Barbara, California 93111
22 Phone: +1 805 681 0115
26 "The MIB module for the display of CIDR multipath IP Routes."
27 REVISION "9609190000Z"
29 "Revisions made by the OSPF WG."
32 ipCidrRouteNumber OBJECT-TYPE
37 "The number of current ipCidrRouteTable entries
38 that are not invalid."
41 -- IP CIDR Route Table
43 -- The IP CIDR Route Table obsoletes and replaces the ipRoute
44 -- Table current in MIB-I and MIB-II and the IP Forwarding Table.
45 -- It adds knowledge of the autonomous system of the next hop,
46 -- multiple next hops, and policy routing, and Classless
48 -- Inter-Domain Routing.
50 ipCidrRouteTable OBJECT-TYPE
51 SYNTAX SEQUENCE OF IpCidrRouteEntry
52 MAX-ACCESS not-accessible
55 "This entity's IP Routing table."
57 "RFC 1213 Section 6.6, The IP Group"
60 ipCidrRouteEntry OBJECT-TYPE
61 SYNTAX IpCidrRouteEntry
62 MAX-ACCESS not-accessible
65 "A particular route to a particular destina-
66 tion, under a particular policy."
73 ::= { ipCidrRouteTable 1 }
112 ipCidrRouteDest OBJECT-TYPE
117 "The destination IP address of this route.
119 This object may not take a Multicast (Class D)
122 Any assignment (implicit or otherwise) of an
123 instance of this object to a value x must be
124 rejected if the bitwise logical-AND of x with
125 the value of the corresponding instance of the
126 ipCidrRouteMask object is not equal to x."
127 ::= { ipCidrRouteEntry 1 }
129 ipCidrRouteMask OBJECT-TYPE
134 "Indicate the mask to be logical-ANDed with the
135 destination address before being compared to
136 the value in the ipCidrRouteDest field. For
137 those systems that do not support arbitrary
138 subnet masks, an agent constructs the value of
139 the ipCidrRouteMask by reference to the IP Ad-
142 Any assignment (implicit or otherwise) of an
143 instance of this object to a value x must be
144 rejected if the bitwise logical-AND of x with
146 the value of the corresponding instance of the
147 ipCidrRouteDest object is not equal to ipCidrRoute-
149 ::= { ipCidrRouteEntry 2 }
151 -- The following convention is included for specification
152 -- of TOS Field contents. At this time, the Host Requirements
153 -- and the Router Requirements documents disagree on the width
154 -- of the TOS field. This mapping describes the Router
155 -- Requirements mapping, and leaves room to widen the TOS field
156 -- without impact to fielded systems.
158 ipCidrRouteTos OBJECT-TYPE
163 "The policy specifier is the IP TOS Field. The encoding
164 of IP TOS is as specified by the following convention.
165 Zero indicates the default path if no more specific
168 +-----+-----+-----+-----+-----+-----+-----+-----+
170 | PRECEDENCE | TYPE OF SERVICE | 0 |
172 +-----+-----+-----+-----+-----+-----+-----+-----+
175 Field Policy Field Policy
176 Contents Code Contents Code
177 0 0 0 0 ==> 0 0 0 0 1 ==> 2
178 0 0 1 0 ==> 4 0 0 1 1 ==> 6
179 0 1 0 0 ==> 8 0 1 0 1 ==> 10
180 0 1 1 0 ==> 12 0 1 1 1 ==> 14
181 1 0 0 0 ==> 16 1 0 0 1 ==> 18
182 1 0 1 0 ==> 20 1 0 1 1 ==> 22
183 1 1 0 0 ==> 24 1 1 0 1 ==> 26
184 1 1 1 0 ==> 28 1 1 1 1 ==> 30"
185 ::= { ipCidrRouteEntry 3 }
187 ipCidrRouteNextHop OBJECT-TYPE
192 "On remote routes, the address of the next sys-
193 tem en route; Otherwise, 0.0.0.0."
194 ::= { ipCidrRouteEntry 4 }
196 ipCidrRouteIfIndex OBJECT-TYPE
198 MAX-ACCESS read-create
201 "The ifIndex value which identifies the local
202 interface through which the next hop of this
203 route should be reached."
205 ::= { ipCidrRouteEntry 5 }
207 ipCidrRouteType OBJECT-TYPE
209 other (1), -- not specified by this MIB
210 reject (2), -- route which discards traffic
211 local (3), -- local interface
212 remote (4) -- remote destination
214 MAX-ACCESS read-create
217 "The type of route. Note that local(3) refers
218 to a route for which the next hop is the final
219 destination; remote(4) refers to a route for
220 which the next hop is not the final destina-
223 Routes which do not result in traffic forwarding or
224 rejection should not be displayed even if the
225 implementation keeps them stored internally.
227 reject (2) refers to a route which, if matched, discards
228 the message as unreachable. This is used in some
229 protocols as a means of correctly aggregating routes."
230 ::= { ipCidrRouteEntry 6 }
232 ipCidrRouteProto OBJECT-TYPE
234 other (1), -- not specified
235 local (2), -- local interface
236 netmgmt (3), -- static route
237 icmp (4), -- result of ICMP Redirect
239 -- the following are all dynamic
242 egp (5), -- Exterior Gateway Protocol
243 ggp (6), -- Gateway-Gateway Protocol
244 hello (7), -- FuzzBall HelloSpeak
245 rip (8), -- Berkeley RIP or RIP-II
246 isIs (9), -- Dual IS-IS
247 esIs (10), -- ISO 9542
248 ciscoIgrp (11), -- Cisco IGRP
249 bbnSpfIgp (12), -- BBN SPF IGP
250 ospf (13), -- Open Shortest Path First
251 bgp (14), -- Border Gateway Protocol
252 idpr (15), -- InterDomain Policy Routing
253 ciscoEigrp (16) -- Cisco EIGRP
258 "The routing mechanism via which this route was
259 learned. Inclusion of values for gateway rout-
260 ing protocols is not intended to imply that
261 hosts should support those protocols."
262 ::= { ipCidrRouteEntry 7 }
264 ipCidrRouteAge OBJECT-TYPE
269 "The number of seconds since this route was
270 last updated or otherwise determined to be
271 correct. Note that no semantics of `too old'
272 can be implied except through knowledge of the
273 routing protocol by which the route was
276 ::= { ipCidrRouteEntry 8 }
278 ipCidrRouteInfo OBJECT-TYPE
279 SYNTAX OBJECT IDENTIFIER
280 MAX-ACCESS read-create
283 "A reference to MIB definitions specific to the
284 particular routing protocol which is responsi-
285 ble for this route, as determined by the value
286 specified in the route's ipCidrRouteProto value.
287 If this information is not present, its value
288 should be set to the OBJECT IDENTIFIER { 0 0 },
289 which is a syntactically valid object identif-
291 ier, and any implementation conforming to ASN.1
292 and the Basic Encoding Rules must be able to
293 generate and recognize this value."
294 ::= { ipCidrRouteEntry 9 }
296 ipCidrRouteNextHopAS OBJECT-TYPE
298 MAX-ACCESS read-create
301 "The Autonomous System Number of the Next Hop.
302 The semantics of this object are determined by
303 the routing-protocol specified in the route's
304 ipCidrRouteProto value. When this object is
305 unknown or not relevant its value should be set
308 ::= { ipCidrRouteEntry 10 }
310 ipCidrRouteMetric1 OBJECT-TYPE
312 MAX-ACCESS read-create
315 "The primary routing metric for this route.
316 The semantics of this metric are determined by
317 the routing-protocol specified in the route's
318 ipCidrRouteProto value. If this metric is not
319 used, its value should be set to -1."
321 ::= { ipCidrRouteEntry 11 }
323 ipCidrRouteMetric2 OBJECT-TYPE
325 MAX-ACCESS read-create
328 "An alternate routing metric for this route.
329 The semantics of this metric are determined by
330 the routing-protocol specified in the route's
331 ipCidrRouteProto value. If this metric is not
332 used, its value should be set to -1."
334 ::= { ipCidrRouteEntry 12 }
336 ipCidrRouteMetric3 OBJECT-TYPE
338 MAX-ACCESS read-create
341 "An alternate routing metric for this route.
342 The semantics of this metric are determined by
343 the routing-protocol specified in the route's
344 ipCidrRouteProto value. If this metric is not
345 used, its value should be set to -1."
347 ::= { ipCidrRouteEntry 13 }
349 ipCidrRouteMetric4 OBJECT-TYPE
351 MAX-ACCESS read-create
354 "An alternate routing metric for this route.
355 The semantics of this metric are determined by
356 the routing-protocol specified in the route's
357 ipCidrRouteProto value. If this metric is not
358 used, its value should be set to -1."
360 ::= { ipCidrRouteEntry 14 }
362 ipCidrRouteMetric5 OBJECT-TYPE
364 MAX-ACCESS read-create
367 "An alternate routing metric for this route.
368 The semantics of this metric are determined by
369 the routing-protocol specified in the route's
370 ipCidrRouteProto value. If this metric is not
371 used, its value should be set to -1."
373 ::= { ipCidrRouteEntry 15 }
375 ipCidrRouteStatus OBJECT-TYPE
377 MAX-ACCESS read-create
380 "The row status variable, used according to
381 row installation and removal conventions."
382 ::= { ipCidrRouteEntry 16 }
384 -- conformance information
386 ipForwardConformance OBJECT IDENTIFIER ::= { ipForward 5 }
388 ipForwardGroups OBJECT IDENTIFIER ::= { ipForwardConformance 1 }
389 ipForwardCompliances OBJECT IDENTIFIER ::= { ipForwardConformance 2 }
391 -- compliance statements
393 ipForwardCompliance MODULE-COMPLIANCE
396 "The compliance statement for SNMPv2 entities
397 which implement the ipForward MIB."
399 MODULE -- this module
400 MANDATORY-GROUPS { ipForwardCidrRouteGroup }
401 ::= { ipForwardCompliances 1 }
403 -- units of conformance
405 ipForwardCidrRouteGroup OBJECT-GROUP
406 OBJECTS { ipCidrRouteNumber,
407 ipCidrRouteDest, ipCidrRouteMask, ipCidrRouteTos,
408 ipCidrRouteNextHop, ipCidrRouteIfIndex, ipCidrRouteType,
409 ipCidrRouteProto, ipCidrRouteAge, ipCidrRouteInfo,
410 ipCidrRouteNextHopAS, ipCidrRouteMetric1,
411 ipCidrRouteMetric2, ipCidrRouteMetric3,
412 ipCidrRouteMetric4, ipCidrRouteMetric5, ipCidrRouteStatus
416 "The CIDR Route Table."
417 ::= { ipForwardGroups 3 }
419 -- Obsoleted Definitions - Objects
421 ipForwardNumber OBJECT-TYPE
426 "The number of current ipForwardTable entries
427 that are not invalid."
430 -- IP Forwarding Table
432 -- The IP Forwarding Table obsoletes and replaces the ipRoute
433 -- Table current in MIB-I and MIB-II. It adds knowledge of
434 -- the autonomous system of the next hop, multiple next hop
436 -- support, and policy routing support.
438 ipForwardTable OBJECT-TYPE
439 SYNTAX SEQUENCE OF IpForwardEntry
440 MAX-ACCESS not-accessible
443 "This entity's IP Routing table."
445 "RFC 1213 Section 6.6, The IP Group"
448 ipForwardEntry OBJECT-TYPE
449 SYNTAX IpForwardEntry
450 MAX-ACCESS not-accessible
453 "A particular route to a particular destina-
454 tion, under a particular policy."
461 ::= { ipForwardTable 1 }
498 ipForwardDest OBJECT-TYPE
503 "The destination IP address of this route. An
504 entry with a value of 0.0.0.0 is considered a
507 This object may not take a Multicast (Class D)
510 Any assignment (implicit or otherwise) of an
511 instance of this object to a value x must be
512 rejected if the bitwise logical-AND of x with
513 the value of the corresponding instance of the
514 ipForwardMask object is not equal to x."
515 ::= { ipForwardEntry 1 }
517 ipForwardMask OBJECT-TYPE
519 MAX-ACCESS read-create
522 "Indicate the mask to be logical-ANDed with the
523 destination address before being compared to
524 the value in the ipForwardDest field. For
525 those systems that do not support arbitrary
526 subnet masks, an agent constructs the value of
527 the ipForwardMask by reference to the IP Ad-
530 Any assignment (implicit or otherwise) of an
531 instance of this object to a value x must be
532 rejected if the bitwise logical-AND of x with
534 the value of the corresponding instance of the
535 ipForwardDest object is not equal to ipForward-
537 DEFVAL { '00000000'h } -- 0.0.0.0
538 ::= { ipForwardEntry 2 }
540 -- The following convention is included for specification
541 -- of TOS Field contents. At this time, the Host Requirements
542 -- and the Router Requirements documents disagree on the width
543 -- of the TOS field. This mapping describes the Router
544 -- Requirements mapping, and leaves room to widen the TOS field
545 -- without impact to fielded systems.
547 ipForwardPolicy OBJECT-TYPE
552 "The general set of conditions that would cause
553 the selection of one multipath route (set of
554 next hops for a given destination) is referred
557 Unless the mechanism indicated by ipForwardPro-
558 to specifies otherwise, the policy specifier is
559 the IP TOS Field. The encoding of IP TOS is as
560 specified by the following convention. Zero
561 indicates the default path if no more specific
564 +-----+-----+-----+-----+-----+-----+-----+-----+
566 | PRECEDENCE | TYPE OF SERVICE | 0 |
568 +-----+-----+-----+-----+-----+-----+-----+-----+
571 Field Policy Field Policy
572 Contents Code Contents Code
573 0 0 0 0 ==> 0 0 0 0 1 ==> 2
574 0 0 1 0 ==> 4 0 0 1 1 ==> 6
575 0 1 0 0 ==> 8 0 1 0 1 ==> 10
576 0 1 1 0 ==> 12 0 1 1 1 ==> 14
577 1 0 0 0 ==> 16 1 0 0 1 ==> 18
578 1 0 1 0 ==> 20 1 0 1 1 ==> 22
579 1 1 0 0 ==> 24 1 1 0 1 ==> 26
580 1 1 1 0 ==> 28 1 1 1 1 ==> 30
582 Protocols defining 'policy' otherwise must ei-
583 ther define a set of values which are valid for
584 this object or must implement an integer-
585 instanced policy table for which this object's
586 value acts as an index."
587 ::= { ipForwardEntry 3 }
589 ipForwardNextHop OBJECT-TYPE
594 "On remote routes, the address of the next sys-
595 tem en route; Otherwise, 0.0.0.0."
596 ::= { ipForwardEntry 4 }
598 ipForwardIfIndex OBJECT-TYPE
600 MAX-ACCESS read-create
603 "The ifIndex value which identifies the local
604 interface through which the next hop of this
605 route should be reached."
607 ::= { ipForwardEntry 5 }
609 ipForwardType OBJECT-TYPE
611 other (1), -- not specified by this MIB
612 invalid (2), -- logically deleted
613 local (3), -- local interface
614 remote (4) -- remote destination
616 MAX-ACCESS read-create
619 "The type of route. Note that local(3) refers
620 to a route for which the next hop is the final
621 destination; remote(4) refers to a route for
622 which the next hop is not the final destina-
625 Setting this object to the value invalid(2) has
626 the effect of invalidating the corresponding
627 entry in the ipForwardTable object. That is,
628 it effectively disassociates the destination
629 identified with said entry from the route iden-
631 tified with said entry. It is an
632 implementation-specific matter as to whether
633 the agent removes an invalidated entry from the
634 table. Accordingly, management stations must
635 be prepared to receive tabular information from
636 agents that corresponds to entries not current-
637 ly in use. Proper interpretation of such en-
638 tries requires examination of the relevant ip-
641 ::= { ipForwardEntry 6 }
643 ipForwardProto OBJECT-TYPE
645 other (1), -- not specified
646 local (2), -- local interface
647 netmgmt (3), -- static route
648 icmp (4), -- result of ICMP Redirect
650 -- the following are all dynamic
652 egp (5), -- Exterior Gateway Protocol
653 ggp (6), -- Gateway-Gateway Protocol
654 hello (7), -- FuzzBall HelloSpeak
655 rip (8), -- Berkeley RIP or RIP-II
656 is-is (9), -- Dual IS-IS
657 es-is (10), -- ISO 9542
658 ciscoIgrp (11), -- Cisco IGRP
659 bbnSpfIgp (12), -- BBN SPF IGP
660 ospf (13), -- Open Shortest Path First
661 bgp (14), -- Border Gateway Protocol
662 idpr (15) -- InterDomain Policy Routing
667 "The routing mechanism via which this route was
668 learned. Inclusion of values for gateway rout-
669 ing protocols is not intended to imply that
670 hosts should support those protocols."
671 ::= { ipForwardEntry 7 }
673 ipForwardAge OBJECT-TYPE
678 "The number of seconds since this route was
680 last updated or otherwise determined to be
681 correct. Note that no semantics of `too old'
682 can be implied except through knowledge of the
683 routing protocol by which the route was
686 ::= { ipForwardEntry 8 }
688 ipForwardInfo OBJECT-TYPE
689 SYNTAX OBJECT IDENTIFIER
690 MAX-ACCESS read-create
693 "A reference to MIB definitions specific to the
694 particular routing protocol which is responsi-
695 ble for this route, as determined by the value
696 specified in the route's ipForwardProto value.
697 If this information is not present, its value
698 should be set to the OBJECT IDENTIFIER { 0 0 },
699 which is a syntactically valid object identif-
700 ier, and any implementation conforming to ASN.1
701 and the Basic Encoding Rules must be able to
702 generate and recognize this value."
703 ::= { ipForwardEntry 9 }
705 ipForwardNextHopAS OBJECT-TYPE
707 MAX-ACCESS read-create
710 "The Autonomous System Number of the Next Hop.
711 When this is unknown or not relevant to the
712 protocol indicated by ipForwardProto, zero."
714 ::= { ipForwardEntry 10 }
716 ipForwardMetric1 OBJECT-TYPE
718 MAX-ACCESS read-create
721 "The primary routing metric for this route.
722 The semantics of this metric are determined by
723 the routing-protocol specified in the route's
724 ipForwardProto value. If this metric is not
725 used, its value should be set to -1."
727 ::= { ipForwardEntry 11 }
729 ipForwardMetric2 OBJECT-TYPE
731 MAX-ACCESS read-create
734 "An alternate routing metric for this route.
735 The semantics of this metric are determined by
736 the routing-protocol specified in the route's
737 ipForwardProto value. If this metric is not
738 used, its value should be set to -1."
740 ::= { ipForwardEntry 12 }
742 ipForwardMetric3 OBJECT-TYPE
744 MAX-ACCESS read-create
747 "An alternate routing metric for this route.
748 The semantics of this metric are determined by
749 the routing-protocol specified in the route's
750 ipForwardProto value. If this metric is not
751 used, its value should be set to -1."
753 ::= { ipForwardEntry 13 }
755 ipForwardMetric4 OBJECT-TYPE
757 MAX-ACCESS read-create
760 "An alternate routing metric for this route.
761 The semantics of this metric are determined by
762 the routing-protocol specified in the route's
763 ipForwardProto value. If this metric is not
764 used, its value should be set to -1."
766 ::= { ipForwardEntry 14 }
768 ipForwardMetric5 OBJECT-TYPE
770 MAX-ACCESS read-create
773 "An alternate routing metric for this route.
774 The semantics of this metric are determined by
775 the routing-protocol specified in the route's
777 ipForwardProto value. If this metric is not
778 used, its value should be set to -1."
780 ::= { ipForwardEntry 15 }
782 -- Obsoleted Definitions - Groups
783 -- compliance statements
785 ipForwardOldCompliance MODULE-COMPLIANCE
788 "The compliance statement for SNMP entities
789 which implement the ipForward MIB."
791 MODULE -- this module
792 MANDATORY-GROUPS { ipForwardMultiPathGroup }
793 ::= { ipForwardCompliances 2 }
795 ipForwardMultiPathGroup OBJECT-GROUP
796 OBJECTS { ipForwardNumber,
797 ipForwardDest, ipForwardMask, ipForwardPolicy,
798 ipForwardNextHop, ipForwardIfIndex, ipForwardType,
799 ipForwardProto, ipForwardAge, ipForwardInfo,
801 ipForwardMetric1, ipForwardMetric2, ipForwardMetric3,
802 ipForwardMetric4, ipForwardMetric5
806 "IP Multipath Route Table."
807 ::= { ipForwardGroups 2 }