idnits 2.17.1 draft-ietf-idmr-multicast-routmib-00.txt: Checking boilerplate required by RFC 5378 and the IETF Trust (see https://trustee.ietf.org/license-info): ---------------------------------------------------------------------------- ** Cannot find the required boilerplate sections (Copyright, IPR, etc.) in this document. Expected boilerplate is as follows today (2024-04-26) according to https://trustee.ietf.org/license-info : IETF Trust Legal Provisions of 28-dec-2009, Section 6.a: This Internet-Draft is submitted in full conformance with the provisions of BCP 78 and BCP 79. IETF Trust Legal Provisions of 28-dec-2009, Section 6.b(i), paragraph 2: Copyright (c) 2024 IETF Trust and the persons identified as the document authors. All rights reserved. IETF Trust Legal Provisions of 28-dec-2009, Section 6.b(i), paragraph 3: This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (https://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Simplified BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Simplified BSD License. Checking nits according to https://www.ietf.org/id-info/1id-guidelines.txt: ---------------------------------------------------------------------------- ** Missing expiration date. The document expiration date should appear on the first and last page. ** The document seems to lack a 1id_guidelines paragraph about Internet-Drafts being working documents. ** The document seems to lack a 1id_guidelines paragraph about 6 months document validity. ** The document seems to lack a 1id_guidelines paragraph about the list of current Internet-Drafts. ** The document seems to lack a 1id_guidelines paragraph about the list of Shadow Directories. == No 'Intended status' indicated for this document; assuming Proposed Standard Checking nits according to https://www.ietf.org/id-info/checklist : ---------------------------------------------------------------------------- ** The document seems to lack an Abstract section. ** The document seems to lack an IANA Considerations section. (See Section 2.2 of https://www.ietf.org/id-info/checklist for how to handle the case when there are no actions for IANA.) ** The document seems to lack separate sections for Informative/Normative References. All references will be assumed normative when checking for downward references. ** There are 90 instances of too long lines in the document, the longest one being 4 characters in excess of 72. Miscellaneous warnings: ---------------------------------------------------------------------------- -- The document seems to lack a disclaimer for pre-RFC5378 work, but may have content which was first submitted before 10 November 2008. If you have contacted all the original authors and they are all willing to grant the BCP78 rights to the IETF Trust, then this is fine, and you can ignore this comment. If not, you may need to add the pre-RFC5378 disclaimer. (See the Legal Provisions document at https://trustee.ietf.org/license-info for more information.) -- The document date (15 July 1994) is 10878 days in the past. Is this intentional? Checking references for intended status: Proposed Standard ---------------------------------------------------------------------------- (See RFCs 3967 and 4897 for information about using normative references to lower-maturity documents in RFCs) ** Obsolete normative reference: RFC 1442 (ref. '1') (Obsoleted by RFC 1902) ** Downref: Normative reference to an Historic RFC: RFC 1445 (ref. '3') ** Obsolete normative reference: RFC 1448 (ref. '4') (Obsoleted by RFC 1905) -- Possible downref: Non-RFC (?) normative reference: ref. '5' ** Downref: Normative reference to an Experimental RFC: RFC 1075 (ref. '6') -- Possible downref: Non-RFC (?) normative reference: ref. '7' Summary: 14 errors (**), 0 flaws (~~), 1 warning (==), 4 comments (--). Run idnits with the --verbose option for more detailed information about the items above. -------------------------------------------------------------------------------- 1 IDMR Working Group Keith McCloghrie 2 INTERNET-DRAFT Dino Farinacci 3 Expires January 1995 Cisco Systems 4 15 July 1994 6 IP Multicast Routing MIB 7 9 Status of this Memo 11 This document is an Internet Draft. Internet Drafts are working 12 documents of the Internet Engineering Task Force (IETF), its Areas, and 13 its Working Groups. Note that other groups may also distribute working 14 documents as Internet Drafts. 16 Internet Drafts are valid for a maximum of six months and may be 17 updated, replaced, or obsoleted by other documents at any time. It is 18 inappropriate to use Internet Drafts as reference material or to cite 19 them other than as a "work in progress". 21 1. Introduction 23 This memo defines an experimental portion of the Management Information 24 Base (MIB) for use with network management protocols in the Internet 25 community. In particular, it describes managed objects used for 26 managing IP Multicast Routing [5], independent of the specific multicast 27 routing protocol [6,7] in use. Managed objects specific to particular 28 multicast routing protocols are specified elsewhere. 30 2. The SNMPv2 Network Management Framework 32 The SNMPv2 Network Management Framework consists of four major 33 components. They are: 35 o RFC 1442 [1] which defines the SMI, the mechanisms used for 36 describing and naming objects for the purpose of management. 38 Draft IP Multicast Routing MIB July 1994 40 o STD 17, RFC 1213 [2] defines MIB-II, the core set of managed 41 objects for the Internet suite of protocols. 43 o RFC 1445 [3] which defines the administrative and other 44 architectural aspects of the framework. 46 o RFC 1448 [4] which defines the protocol used for network access to 47 managed objects. 49 The Framework permits new objects to be defined for the purpose of 50 experimentation and evaluation. 52 2.1. Object Definitions 54 Managed objects are accessed via a virtual information store, termed the 55 Management Information Base or MIB. Objects in the MIB are defined 56 using the subset of Abstract Syntax Notation One (ASN.1) defined in the 57 SMI. In particular, each object type is named by an OBJECT IDENTIFIER, 58 an administratively assigned name. The object type together with an 59 object instance serves to uniquely identify a specific instantiation of 60 the object. For human convenience, we often use a textual string, 61 termed the descriptor, to refer to the object type. 63 3. Overview 65 This MIB module contains one scalar and three tables. The tables are: 67 (1) the IP Multicast Route Table containing multicast routing 68 information for IP datagrams sent by particular sources to the IP 69 multicast groups known to a router; 71 (2) the IP Multicast Routing Next Hop Table containing information on 72 the outgoing interfaces and next hops for the routing IP multicast 73 datagrams. Each entry is one of a list of outgoing interface and 74 next hops for a particular source and multicast group address; and 76 (3) the Multicast Routing Interface Table containing multicast routing 77 information specific to interfaces. 79 Draft IP Multicast Routing MIB July 1994 81 4. Definitions 83 IPMROUTE-MIB DEFINITIONS ::= BEGIN 85 IMPORTS 86 MODULE-IDENTITY, OBJECT-TYPE, experimental, 87 Integer32, Counter32, 88 IpAddress, TimeTicks FROM SNMPv2-SMI 89 MODULE-COMPLIANCE, OBJECT-GROUP FROM SNMPv2-CONF; 91 ipMRouteMIB MODULE-IDENTITY 92 LAST-UPDATED "9407152359Z" 93 ORGANIZATION "IETF IDMR Working Group." 94 CONTACT-INFO 95 " Keith McCloghrie 96 cisco Systems, Inc. 97 1525 O'Brien Dr. 98 Menlo Park, CA 94025 99 EMail: kzm@cisco.com" 100 DESCRIPTION 101 "The MIB module for IP Multicast Management." 102 ::= { experimental xx } -- to be assigned by the IANA 104 ipMRouteMIBObjects OBJECT IDENTIFIER ::= { ipMRouteMIB 1 } 106 ipMRoute OBJECT IDENTIFIER ::= { ipMRouteMIBObjects 1 } 107 Draft IP Multicast Routing MIB July 1994 109 -- the IP Multicast Routing MIB-Group 110 -- 111 -- a collection of objects providing information about 112 -- IP Multicast Groups 114 ipMRouteEnable OBJECT-TYPE 115 SYNTAX INTEGER { enabled(1), disabled(2) } 116 MAX-ACCESS read-write 117 STATUS current 118 DESCRIPTION 119 "The enabled status of IP Multicast routing on this router." 120 ::= { ipMRoute 1 } 122 ipMRouteTable OBJECT-TYPE 123 SYNTAX SEQUENCE OF IpMRouteEntry 124 MAX-ACCESS not-accessible 125 STATUS current 126 DESCRIPTION 127 "The (conceptual) table containg multicast routing 128 information for IP datagrams sent by particular sources to 129 the IP multicast groups known to this router." 130 ::= { ipMRoute 2 } 132 ipMRouteEntry OBJECT-TYPE 133 SYNTAX IpMRouteEntry 134 MAX-ACCESS not-accessible 135 STATUS current 136 DESCRIPTION 137 "An entry (conceptual row) containing the multicast routing 138 information for IP datagrams from a particular source and 139 addressed to a particular IP multicast group address." 140 INDEX { ipMRouteGroup, 141 ipMRouteSource, 142 ipMRouteSourceMask } 143 ::= { ipMRouteTable 1 } 145 Draft IP Multicast Routing MIB July 1994 147 IpMRouteEntry ::= SEQUENCE { 148 ipMRouteGroup IpAddress, 149 ipMRouteSource IpAddress, 150 ipMRouteSourceMask IpAddress, 151 ipMRouteRpfNeighbor IpAddress, 152 ipMRouteInIfIndex Integer32, 153 ipMRouteOutList Integer32, 154 ipMRouteUpTime TimeTicks, 155 ipMRouteExpiryTime TimeTicks, 156 ipMRoutePkts Counter32, 157 ipMRouteRpfFails Counter32, 158 ipMRouteOctets Counter32 159 } 161 ipMRouteGroup OBJECT-TYPE 162 SYNTAX IpAddress 163 MAX-ACCESS not-accessible 164 STATUS current 165 DESCRIPTION 166 "The IP multicast group address for which this entry 167 contains multicast routing information." 168 ::= { ipMRouteEntry 1 } 170 ipMRouteSource OBJECT-TYPE 171 SYNTAX IpAddress 172 MAX-ACCESS not-accessible 173 STATUS current 174 DESCRIPTION 175 "The source network address for which this entry contains 176 multicast routing information." 177 ::= { ipMRouteEntry 2 } 179 ipMRouteSourceMask OBJECT-TYPE 180 SYNTAX IpAddress 181 MAX-ACCESS not-accessible 182 STATUS current 183 DESCRIPTION 184 "The network mask of the source address for which this entry 185 contains multicast routing information." 186 ::= { ipMRouteEntry 3 } 188 ipMRouteRpfNeighbor OBJECT-TYPE 189 SYNTAX IpAddress 190 MAX-ACCESS read-only 191 STATUS current 193 Draft IP Multicast Routing MIB July 1994 195 DESCRIPTION 196 "The address of the RPF neighbor from which IP datagrams 197 from this source to this multicast address are received." 198 ::= { ipMRouteEntry 4 } 200 ipMRouteInIfIndex OBJECT-TYPE 201 SYNTAX Integer32 202 MAX-ACCESS read-only 203 STATUS current 204 DESCRIPTION 205 "The value of ifIndex for the interface on which IP 206 datagrams sent by this source to this multicast address are 207 received." 208 ::= { ipMRouteEntry 5 } 210 ipMRouteOutList OBJECT-TYPE 211 SYNTAX Integer32 212 MAX-ACCESS read-only 213 STATUS current 214 DESCRIPTION 215 "The value of ipMRouteNextHopList which identifies the list 216 of entries in the ipMRouteNextHopTable representing outgoing 217 interfaces to which IP datagrams from this source to this 218 multicast group address are forwarded." 219 ::= { ipMRouteEntry 6 } 221 ipMRouteUpTime OBJECT-TYPE 222 SYNTAX TimeTicks 223 MAX-ACCESS read-only 224 STATUS current 225 DESCRIPTION 226 "The time since the multicast routing information 227 represented by this entry was learned by the router." 228 ::= { ipMRouteEntry 7 } 230 ipMRouteExpiryTime OBJECT-TYPE 231 SYNTAX TimeTicks 232 MAX-ACCESS read-only 233 STATUS current 234 DESCRIPTION 235 "The minimum amount of time remaining before this entry will 236 be aged out." 237 ::= { ipMRouteEntry 8 } 239 ipMRoutePkts OBJECT-TYPE 240 Draft IP Multicast Routing MIB July 1994 242 SYNTAX Counter32 243 MAX-ACCESS read-only 244 STATUS current 245 DESCRIPTION 246 "The number of packets which this router has received from 247 this source and addressed to this multicast group address." 248 ::= { ipMRouteEntry 9 } 250 ipMRouteRpfFails OBJECT-TYPE 251 SYNTAX Counter32 252 MAX-ACCESS read-only 253 STATUS current 254 DESCRIPTION 255 "The number of packets which this router has received from 256 this source and addressed to this multicast group address, 257 which were not received from the interface indicated by 258 ipMRouteInIfIndex." 259 ::= { ipMRouteEntry 10 } 261 ipMRouteOctets OBJECT-TYPE 262 SYNTAX Counter32 263 MAX-ACCESS read-only 264 STATUS current 265 DESCRIPTION 266 "The number of octets contained in IP datagrams which were 267 received from this source and addressed to this multicast 268 group address, and which were forwarded by this router." 269 ::= { ipMRouteEntry 11 } 271 Draft IP Multicast Routing MIB July 1994 273 -- 274 -- The IP Multicast Routing Next Hop Table 275 -- 277 ipMRouteNextHopTable OBJECT-TYPE 278 SYNTAX SEQUENCE OF IpMRouteNextHopEntry 279 MAX-ACCESS not-accessible 280 STATUS current 281 DESCRIPTION 282 "The (conceptual) table containing information on the 283 outgoing interfaces and next hops for the routing IP 284 multicast datagrams. Each entry is one of a list of 285 outgoing interface and next hops for a particular source and 286 multicast group address." 287 ::= { ipMRoute 3 } 289 ipMRouteNextHopEntry OBJECT-TYPE 290 SYNTAX IpMRouteNextHopEntry 291 MAX-ACCESS not-accessible 292 STATUS current 293 DESCRIPTION 294 "An entry (conceptual row) containing a particular outgoing 295 interface and next hop for an IP multicast datagram." 296 INDEX { ipMRouteNextHopList, ipMRouteNextHopIndex } 297 ::= { ipMRouteNextHopTable 1 } 299 IpMRouteNextHopEntry ::= SEQUENCE { 300 ipMRouteNextHopList INTEGER, 301 ipMRouteNextHopIndex INTEGER, 302 ipMRouteNextHopState INTEGER, 303 ipMRouteNextHopAddress IpAddress, 304 ipMRouteNextHopIfIndex Integer32, 305 ipMRouteNextHopUpTime TimeTicks, 306 ipMRouteNextHopExpiryTime TimeTicks 307 } 309 ipMRouteNextHopList OBJECT-TYPE 310 SYNTAX INTEGER (0..65535) 311 MAX-ACCESS not-accessible 312 STATUS current 313 DESCRIPTION 314 "A value which uniquely identifies a list of outgoing 315 interfaces and next hop addresses." 316 ::= { ipMRouteNextHopEntry 1 } 318 Draft IP Multicast Routing MIB July 1994 320 ipMRouteNextHopIndex OBJECT-TYPE 321 SYNTAX INTEGER (0..65535) 322 MAX-ACCESS not-accessible 323 STATUS current 324 DESCRIPTION 325 "A value which uniquely identifies an outgoing interface and 326 next hop address within a list of outgoing interfaces and 327 next hop addresses." 328 ::= { ipMRouteNextHopEntry 2 } 330 ipMRouteNextHopState OBJECT-TYPE 331 SYNTAX INTEGER { pruned(1), forwarding(2) } 332 MAX-ACCESS read-only 333 STATUS current 334 DESCRIPTION 335 "An indication of whether the outgoing interface and next 336 hop represented by this entry is currently being used to 337 forward IP datagrams. The value 'forwarding' indicates it 338 is currently being used; the value 'pruned' indicates it is 339 not." 340 ::= { ipMRouteNextHopEntry 3 } 342 ipMRouteNextHopAddress OBJECT-TYPE 343 SYNTAX IpAddress 344 MAX-ACCESS read-only 345 STATUS current 346 DESCRIPTION 347 "The address of the next hop for this outgoing interface and 348 next hop." 349 ::= { ipMRouteNextHopEntry 4 } 351 ipMRouteNextHopIfIndex OBJECT-TYPE 352 SYNTAX Integer32 353 MAX-ACCESS read-only 354 STATUS current 355 DESCRIPTION 356 "The ifIndex value of the interface for this outgoing 357 interface and next hop." 358 ::= { ipMRouteNextHopEntry 5 } 360 ipMRouteNextHopUpTime OBJECT-TYPE 361 SYNTAX TimeTicks 362 MAX-ACCESS read-only 363 STATUS current 364 DESCRIPTION 366 Draft IP Multicast Routing MIB July 1994 368 "The time since the multicast routing information 369 represented by this entry was learned by the router." 370 ::= { ipMRouteNextHopEntry 6 } 372 ipMRouteNextHopExpiryTime OBJECT-TYPE 373 SYNTAX TimeTicks 374 MAX-ACCESS read-only 375 STATUS current 376 DESCRIPTION 377 "The minimum time before this entry will be aged out." 378 ::= { ipMRouteNextHopEntry 7 } 380 -- 381 -- The Multicast Routing Interface Table 382 -- 384 ipMRouteInterfaceTable OBJECT-TYPE 385 SYNTAX SEQUENCE OF IpMRouteInterfaceEntry 386 MAX-ACCESS not-accessible 387 STATUS current 388 DESCRIPTION 389 "The (conceptual) table containg multicast routing 390 information specific to interfaces." 391 ::= { ipMRoute 4 } 393 ipMRouteInterfaceEntry OBJECT-TYPE 394 SYNTAX IpMRouteInterfaceEntry 395 MAX-ACCESS not-accessible 396 STATUS current 397 DESCRIPTION 398 "An entry (conceptual row) containing the multicast routing 399 information for a particular interface." 400 INDEX { ipMRouteInterfaceIfIndex } 401 ::= { ipMRouteInterfaceTable 1 } 403 Draft IP Multicast Routing MIB July 1994 405 IpMRouteInterfaceEntry ::= SEQUENCE { 406 ipMRouteInterfaceIfIndex Integer32, 407 ipMRouteInterfaceTtl Integer32 408 } 410 ipMRouteInterfaceIfIndex OBJECT-TYPE 411 SYNTAX Integer32 412 MAX-ACCESS not-accessible 413 STATUS current 414 DESCRIPTION 415 "The ifIndex value of the interface for which this entry 416 contains information." 417 ::= { ipMRouteInterfaceEntry 1 } 419 ipMRouteInterfaceTtl OBJECT-TYPE 420 SYNTAX Integer32 421 MAX-ACCESS read-write 422 STATUS current 423 DESCRIPTION 424 "The datagram TTL threshold for the interface. Any IP 425 multicast datagrams with a TTL less than this threshold will 426 not be forwarded out the interface. The default value of 0 427 means all multicast packets are forwarded out interface." 428 ::= { ipMRouteInterfaceEntry 2 } 430 Draft IP Multicast Routing MIB July 1994 432 -- conformance information 434 ipMRouteMIBConformance 435 OBJECT IDENTIFIER ::= { ipMRouteMIB 2 } 436 ipMRouteMIBCompliances 437 OBJECT IDENTIFIER ::= { ipMRouteMIBConformance 1 } 438 ipMRouteMIBGroups OBJECT IDENTIFIER ::= { ipMRouteMIBConformance 2 } 440 -- compliance statements 442 ipMRouteMIBCompliance MODULE-COMPLIANCE 443 STATUS current 444 DESCRIPTION 445 "The compliance statement for the IP Multicast MIB." 446 MODULE -- this module 447 MANDATORY-GROUPS { ipMRouteMIBGroup } 449 ::= { ipMRouteMIBCompliances 1 } 451 -- units of conformance 453 ipMRouteMIBGroup OBJECT-GROUP 454 OBJECTS { ipMRouteEnable, ipMRouteRpfNeighbor, 455 ipMRouteInIfIndex, ipMRouteOutList, 456 ipMRouteUpTime, ipMRouteExpiryTime, 457 ipMRoutePkts, ipMRouteRpfFails, 458 ipMRouteOctets, 459 ipMRouteNextHopAddress, 460 ipMRouteNextHopState, 461 ipMRouteNextHopIfIndex, 462 ipMRouteNextHopUpTime, 463 ipMRouteNextHopExpiryTime, 464 ipMRouteInterfaceTtl 465 } 466 STATUS current 467 DESCRIPTION 468 "A collection of objects to support management of IP 469 Multicast routing." 470 ::= { ipMRouteMIBGroups 1 } 472 END 473 Draft IP Multicast Routing MIB July 1994 475 5. Acknowledgements 477 This MIB module will be presented to the IETF's Inter-Domain Multicast 478 Routing (IDMR) Working Group. 480 6. References 482 [1] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Structure 483 of Management Information for version 2 of the Simple Network 484 Management Protocol (SNMPv2)", RFC 1442, SNMP Research,Inc., Hughes 485 LAN Systems, Dover Beach Consulting, Inc., Carnegie Mellon 486 University, April 1993. 488 [2] McCloghrie, K., and M. Rose, Editors, "Management Information Base 489 for Network Management of TCP/IP-based internets: MIB-II", STD 17, 490 RFC 1213, Hughes LAN Systems, Performance Systems International, 491 March 1991. 493 [3] Galvin, J., and K. McCloghrie, "Administrative Model for version 2 494 of the Simple Network Management Protocol (SNMPv2)", RFC 1445, 495 Trusted Information Systems, Hughes LAN Systems, April 1993. 497 [4] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Protocol 498 Operations for version 2 of the Simple Network Management Protocol 499 (SNMPv2)", RFC 1448, SNMP Research,Inc., Hughes LAN Systems, Dover 500 Beach Consulting, Inc., Carnegie Mellon University, April 1993. 502 [5] Deering, S., "Multicast Routing in a Datagram Internetwork", PhD 503 thesis, Electrical Engineering Dept., Stanford University, December 504 1991. 506 [6] Waitzman, D., Partridge, C., and S. Deering, "Distance Vector 507 Multicast Routing Protocol", RFC 1075, November 1988. 509 [7] Deering, S., Estrin, D., Farinacci, D., Jacobson, V., Liu, G., and 510 L. Wei, "Protocol Independent Multicast (PIM): Motivation and 511 Architecture", March 1994. 513 Draft IP Multicast Routing MIB July 1994 515 7. Security Considerations 517 Security issues are not discussed in this memo. 519 8. Author's Address 521 Keith McCloghrie 522 cisco Systems, Inc. 523 1525 O'Brien Dr. 524 Menlo Park, CA 94025 525 Phone: (415) 324-5260 526 EMail: kzm@cisco.com 528 Dino Farinacci 529 cisco Systems, Inc. 530 1525 O'Brien Dr. 531 Menlo Park, CA 94025 532 Phone: (415) 688-4696 533 EMail: dino@cisco.com 535 Draft IP Multicast Routing MIB July 1994 537 Table of Contents 539 1 Introduction .................................................... 1 540 2 The SNMPv2 Network Management Framework ......................... 1 541 2.1 Object Definitions ............................................ 2 542 3 Overview ........................................................ 2 543 4 Definitions ..................................................... 3 544 5 Acknowledgements ................................................ 13 545 6 References ...................................................... 13 546 7 Security Considerations ......................................... 14 547 8 Author's Address ................................................ 14