IETF D. McWalter Internet-Draft Data Connection Ltd Expires: March 25, 2006 D. Thaler Microsoft Corporation A. Kessler Cisco Systems September 21, 2005 IP Multicast MIB draft-mcwalter-ip-mcast-mib-00.txt Status of this Memo By submitting this Internet-Draft, each author represents that any applicable patent or other IPR claims of which he or she is aware have been or will be disclosed, and any of which he or she becomes aware will be disclosed, in accordance with Section 6 of BCP 79. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF), its areas, and its working groups. Note that other groups may also distribute working documents as Internet- Drafts. Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress." The list of current Internet-Drafts can be accessed at http://www.ietf.org/ietf/1id-abstracts.txt. The list of Internet-Draft Shadow Directories can be accessed at http://www.ietf.org/shadow.html. This Internet-Draft will expire on March 25, 2006. Copyright Notice Copyright (C) The Internet Society (2005). Abstract This memo defines a portion of the Management Information Base (MIB) for use with network management protocols in the Internet community. In particular, it describes objects used for managing multicast function, independent of the specific multicast protocol(s) in use. This document obsoletes RFC 2932. McWalter, et al. Expires March 25, 2006 [Page 1] Internet-Draft IP MCAST MIB September 2005 Table of Contents 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3 2. The Internet-Standard Management Framework . . . . . . . . . . 3 3. Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 4. Definitions . . . . . . . . . . . . . . . . . . . . . . . . . 4 5. Security Considerations . . . . . . . . . . . . . . . . . . . 33 6. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 34 7. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . 34 8. References . . . . . . . . . . . . . . . . . . . . . . . . . . 34 8.1 Normative References . . . . . . . . . . . . . . . . . . . 34 8.2 Informative References . . . . . . . . . . . . . . . . . . 35 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . 36 Intellectual Property and Copyright Statements . . . . . . . . 37 McWalter, et al. Expires March 25, 2006 [Page 2] Internet-Draft IP MCAST MIB September 2005 1. Introduction This MIB describes objects used for managing IP multicast function, including IP multicast routing. These objects are independent of the specific multicast routing protocol in use. Managed objects specific to particular multicast protocols are defined elsewhere. This document obsoletes [RFC2932]. The MIB module defined by this document is a re-working of the MIB module from [RFC2932], with changes that include the following. o This MIB module is independent of address type, whereas [RFC2932] only supported IPv4. o This MIB module includes objects that are not specific to multicast routing. It allows management of multicast function on systems that do not perform routing, whereas RFC 2932 was restricted to multicast routing. o This MIB module includes a table of Source-Specific Multicast (SSM) address ranges to which SSM semantics [RFC3569] should be applied. o This MIB module includes a table of local applications that are receiving multicast data. The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in [RFC2119]. 2. The Internet-Standard Management Framework For a detailed overview of the documents that describe the current Internet-Standard Management Framework, please refer to section 7 of [RFC3410]. Managed objects are accessed via a virtual information store, termed the Management Information Base or MIB. MIB objects are generally accessed through the Simple Network Management Protocol (SNMP). Objects in the MIB are defined using the mechanisms defined in the Structure of Management Information (SMI). This memo specifies a MIB module that is compliant to the SMIv2, which is described in STD 58, [RFC2578], STD 58, [RFC2579] and STD 58, [RFC2580]. 3. Overview This MIB module contains two scalars and seven tables. The tables are: McWalter, et al. Expires March 25, 2006 [Page 3] Internet-Draft IP MCAST MIB September 2005 1. The IP Multicast Interface Table containing multicast information specific to interfaces. 2. The IP Multicast SSM Range Table, which contains one row per range of multicast group addresses to which Source-Specific Multicast semantics [RFC3569] should be applied. 3. The IP Multicast Route Table containing multicast routing information for IP datagrams sent by particular sources to the IP multicast groups known to a system. 4. The IP Multicast Routing Next Hop Table containing information on next-hops for the routing of IP multicast datagrams. Each entry is one of a list of next-hops on outgoing interfaces for particular sources sending to a particular multicast group address. 5. The IP Multicast Scope Boundary Table containing the boundaries configured for multicast scopes [RFC2365]. 6. The IP Multicast Scope Name Table containing human-readable names of multicast scope. 7. The IP Multicast Local Listener Table containing identifiers for local applications that are receiving multicast data. This MIB module uses textual conventions defined in the IF-MIB [RFC2863], the INET-ADDRESS-MIB [RFC4001] and the IANA-RTPROTO-MIB. 4. Definitions IPMCAST-MIB DEFINITIONS ::= BEGIN IMPORTS MODULE-IDENTITY, OBJECT-TYPE, mib-2, Integer32, Counter32, Counter64, Gauge32, TimeTicks FROM SNMPv2-SMI RowStatus, TEXTUAL-CONVENTION, TruthValue FROM SNMPv2-TC MODULE-COMPLIANCE, OBJECT-GROUP FROM SNMPv2-CONF SnmpAdminString FROM SNMP-FRAMEWORK-MIB InterfaceIndexOrZero, InterfaceIndex FROM IF-MIB IANAipRouteProtocol, IANAipMRouteProtocol FROM IANA-RTPROTO-MIB InetAddress, InetAddressType, InetAddressPrefixLength FROM INET-ADDRESS-MIB; McWalter, et al. Expires March 25, 2006 [Page 4] Internet-Draft IP MCAST MIB September 2005 ipMcastMIB MODULE-IDENTITY LAST-UPDATED "200509210000Z" -- 21 September 2005 ORGANIZATION "IETF MBONED Working Group" CONTACT-INFO "David McWalter Data Connection Limited 100 Church Street Enfield, EN2 6BQ UK Phone: +44 208 366 1177 EMail: dmcw@dataconnection.com Dave Thaler Microsoft Corporation One Microsoft Way Redmond, WA 98052-6399 US Phone: +1 425 703 8835 EMail: dthaler@dthaler.microsoft.com Andrew Kessler Cisco Systems 425 E. Tasman Drive San Jose, CA 95134 US Phone: +1 408 526 5139 EMail: kessler@cisco.com" DESCRIPTION "The MIB module for management of IP Multicast function. Copyright (C) The Internet Society (2005). This version of this MIB module is part of RFC yyyy; see the RFC itself for full legal notices." -- RFC Ed.: replace yyyy with actual RFC number & remove this note REVISION "200509210000Z" -- 21 September 2005 DESCRIPTION "Initial version, published as RFC yyyy." -- RFC Ed.: replace yyyy with actual RFC number & remove this note ::= { mib-2 XXX } -- RFC Ed.: replace XXX with IANA-assigned number & remove this note -- -- Textual conventions -- LanguageTag ::= TEXTUAL-CONVENTION DISPLAY-HINT "100a" McWalter, et al. Expires March 25, 2006 [Page 5] Internet-Draft IP MCAST MIB September 2005 STATUS current DESCRIPTION "A language tag with all alphabetic characters converted to lowercase. This restriction is intended to make the lexical ordering imposed by SNMP useful when applied to language tags. Note that it is theoretically possible for a valid language tag to exceed the allowed length of this syntax, and thus be impossible to represent with this syntax. Sampling of language tags in current use on the Internet suggests that this limit does not pose a serious problem in practice." REFERENCE "RFC 1766" SYNTAX OCTET STRING (SIZE (1..100)) -- -- Top-level structure of the MIB -- ipMcastMIBObjects OBJECT IDENTIFIER ::= { ipMcastMIB 1 } ipMcast OBJECT IDENTIFIER ::= { ipMcastMIBObjects 1 } ipMcastEnable OBJECT-TYPE SYNTAX INTEGER { enabled(1), disabled(2) } MAX-ACCESS read-write STATUS current DESCRIPTION "The enabled status of IP Multicast function on this system." ::= { ipMcast 1 } ipMcastRouteEntryCount OBJECT-TYPE SYNTAX Gauge32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of rows in the ipMcastRouteTable. This can be used to check for multicast routing activity, and to monitor the multicast routing table size." ::= { ipMcast 7 } -- -- The Multicast Interface Table -- ipMcastInterfaceTable OBJECT-TYPE SYNTAX SEQUENCE OF IpMcastInterfaceEntry MAX-ACCESS not-accessible McWalter, et al. Expires March 25, 2006 [Page 6] Internet-Draft IP MCAST MIB September 2005 STATUS current DESCRIPTION "The (conceptual) table used to manage the multicast protocol active on an interface." ::= { ipMcast 4 } ipMcastInterfaceEntry OBJECT-TYPE SYNTAX IpMcastInterfaceEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry (conceptual row) containing the multicast protocol information for a particular interface. This entry is preserved on agent restart." INDEX { ipMcastInterfaceIfIndex } ::= { ipMcastInterfaceTable 1 } IpMcastInterfaceEntry ::= SEQUENCE { ipMcastInterfaceIfIndex InterfaceIndex, ipMcastInterfaceTtl Integer32, ipMcastInterfaceProtocol IANAipMRouteProtocol, ipMcastInterfaceRateLimit Integer32, ipMcastInterfaceInMcastOctets Counter32, ipMcastInterfaceOutMcastOctets Counter32, ipMcastInterfaceInMcastPkts Counter32, ipMcastInterfaceOutMcastPkts Counter32, ipMcastInterfaceHCInMcastOctets Counter64, ipMcastInterfaceHCOutMcastOctets Counter64, ipMcastInterfaceHCInMcastPkts Counter64, ipMcastInterfaceHCOutMcastPkts Counter64 } ipMcastInterfaceIfIndex OBJECT-TYPE SYNTAX InterfaceIndex MAX-ACCESS not-accessible STATUS current DESCRIPTION "The ifIndex value of the interface for which this entry contains information." ::= { ipMcastInterfaceEntry 1 } ipMcastInterfaceTtl OBJECT-TYPE SYNTAX Integer32 (0..255) MAX-ACCESS read-write STATUS current DESCRIPTION "The datagram TTL threshold for the interface. Any IP multicast datagrams with a TTL (IPv4) or Hop Count (IPv6) McWalter, et al. Expires March 25, 2006 [Page 7] Internet-Draft IP MCAST MIB September 2005 less than this threshold will not be forwarded out the interface. The default value of 0 means all multicast packets are forwarded out the interface." ::= { ipMcastInterfaceEntry 2 } ipMcastInterfaceProtocol OBJECT-TYPE SYNTAX IANAipMRouteProtocol MAX-ACCESS read-write STATUS current DESCRIPTION "The multicast protocol running on this interface." ::= { ipMcastInterfaceEntry 3 } ipMcastInterfaceRateLimit OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-write STATUS current DESCRIPTION "The rate-limit, in kilobits per second, of forwarded multicast traffic on the interface. A rate-limit of 0 indicates that no rate limiting is done." DEFVAL { 0 } ::= { ipMcastInterfaceEntry 4 } ipMcastInterfaceInMcastOctets OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of octets of multicast packets that have arrived on the interface, including framing characters. This object is similar to ifInOctets in the Interfaces MIB, except that only multicast packets are counted." ::= { ipMcastInterfaceEntry 5 } ipMcastInterfaceOutMcastOctets OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of octets of multicast packets that have been sent on the interface." ::= { ipMcastInterfaceEntry 6 } ipMcastInterfaceInMcastPkts OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current McWalter, et al. Expires March 25, 2006 [Page 8] Internet-Draft IP MCAST MIB September 2005 DESCRIPTION "The number of multicast packets that have arrived on the interface. In many cases, this object is identical to ifInMulticastPkts in the Interfaces MIB. However, some implementations use ifXTable for Layer 2 traffic statistics and ipMcastInterfaceTable at Layer 3. In this case a difference between these objects probably indicates that some Layer 3 multicast packets are being transmitted as unicast at Layer 2." REFERENCE "RFC 2863 ifInMulticastPkts" ::= { ipMcastInterfaceEntry 7 } ipMcastInterfaceOutMcastPkts OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of multicast packets that have been sent on the interface. In many cases, this object is identical to ifOutMulticastPkts in the Interfaces MIB. However, some implementations use ifXTable for Layer 2 traffic statistics and ipMcastInterfaceTable at Layer 3. In this case a difference between these objects probably indicates that some Layer 3 multicast packets are being transmitted as unicast at Layer 2." REFERENCE "RFC 2863 ifOutMulticastPkts" ::= { ipMcastInterfaceEntry 8 } ipMcastInterfaceHCInMcastOctets OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of octets of multicast packets that have arrived on the interface, including framing characters. This object is a 64-bit version of ipMcastRouteInterfaceInMcastOctets. It is similar to ifHCInOctets in the Interfaces MIB, except that only multicast packets are counted." ::= { ipMcastInterfaceEntry 9 } ipMcastInterfaceHCOutMcastOctets OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of octets of multicast packets that have been McWalter, et al. Expires March 25, 2006 [Page 9] Internet-Draft IP MCAST MIB September 2005 sent on the interface. This object is a 64-bit version of ipMcastRouteInterfaceOutMcastOctets." ::= { ipMcastInterfaceEntry 10 } ipMcastInterfaceHCInMcastPkts OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of multicast packets that have arrived on the interface. In many cases, this object is identical to ifHCInMulticastPkts in the Interfaces MIB. However, some implementations use ifXTable for Layer 2 traffic statistics and ipMcastInterfaceTable at Layer 3. In this case a difference between these objects probably indicates that some Layer 3 multicast packets are being transmitted as unicast at Layer 2." REFERENCE "RFC 2863 ifHCInMulticastPkts" ::= { ipMcastInterfaceEntry 11 } ipMcastInterfaceHCOutMcastPkts OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of multicast packets that have been sent on the interface. In many cases, this object is identical to ifHCOutMulticastPkts in the Interfaces MIB. However, some implementations use ifXTable for Layer 2 traffic statistics and ipMcastInterfaceTable at Layer 3. In this case a difference between these objects probably indicates that some Layer 3 multicast packets are being transmitted as unicast at Layer 2." REFERENCE "RFC 2863 ifHCOutMulticastPkts" ::= { ipMcastInterfaceEntry 12 } -- -- The SSM Range Table -- ipMcastSsmRangeTable OBJECT-TYPE SYNTAX SEQUENCE OF IpMcastSsmRangeEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table is used to create and manage the range(s) of McWalter, et al. Expires March 25, 2006 [Page 10] Internet-Draft IP MCAST MIB September 2005 group addresses to which SSM semantics should be applied." REFERENCE "RFC 3569" ::= { ipMcast 8 } ipMcastSsmRangeEntry OBJECT-TYPE SYNTAX IpMcastSsmRangeEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry (conceptual row) in the ssmRangeTable. This entry is preserved on agent restart." INDEX { ipMcastSsmRangeAddressType, ipMcastSsmRangeAddress, ipMcastSsmRangePrefixLength } ::= { ipMcastSsmRangeTable 1 } IpMcastSsmRangeEntry ::= SEQUENCE { ipMcastSsmRangeAddressType InetAddressType, ipMcastSsmRangeAddress InetAddress, ipMcastSsmRangePrefixLength InetAddressPrefixLength, ipMcastSsmRangeRowStatus RowStatus } ipMcastSsmRangeAddressType OBJECT-TYPE SYNTAX InetAddressType MAX-ACCESS not-accessible STATUS current DESCRIPTION "The address type of the multicast group prefix." ::= { ipMcastSsmRangeEntry 1 } ipMcastSsmRangeAddress OBJECT-TYPE SYNTAX InetAddress (SIZE (4|8|16|20)) MAX-ACCESS not-accessible STATUS current DESCRIPTION "The multicast group address which, when combined with ipMcastSsmRangePrefixLength, gives the group prefix for this SSM range. The InetAddressType is given by the ipMcastSsmRangeAddressType object. This address object is only significant up to ipMcastSsmRangePrefixLength bits. The remainder of the address bits are zero. This is especially important for this index field, which is part of the index of this entry. Any non-zero bits would signify an entirely different entry." ::= { ipMcastSsmRangeEntry 2 } McWalter, et al. Expires March 25, 2006 [Page 11] Internet-Draft IP MCAST MIB September 2005 ipMcastSsmRangePrefixLength OBJECT-TYPE SYNTAX InetAddressPrefixLength (4..128) MAX-ACCESS not-accessible STATUS current DESCRIPTION "The multicast group prefix length, which, when combined with ipMcastSsmRangeAddress, gives the group prefix for this SSM range. The InetAddressType is given by the ipMcastSsmRangeAddressType object. If 'ipv4' or 'ipv4z', this object must be in the range 4..32. If ipMcastSsmRangeAddressType is 'ipv6' or 'ipv6z', this object must be in the range 8..128." ::= { ipMcastSsmRangeEntry 3 } ipMcastSsmRangeRowStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The status of this row, by which rows in this table can be created and destroyed. There are no other other writeable columnar objects in this entry." ::= { ipMcastSsmRangeEntry 4 } -- -- The IP Multicast Routing Table -- ipMcastRouteTable OBJECT-TYPE SYNTAX SEQUENCE OF IpMcastRouteEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The (conceptual) table containing multicast routing information for IP datagrams sent by particular sources to to the IP multicast groups known to this router." ::= { ipMcast 2 } ipMcastRouteEntry OBJECT-TYPE SYNTAX IpMcastRouteEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry (conceptual row) containing the multicast routing information for IP datagrams from a particular source and addressed to a particular IP multicast group address. Discontinuities in counters in this entry can be detected by observing the value of ipMcastRouteUpTime." McWalter, et al. Expires March 25, 2006 [Page 12] Internet-Draft IP MCAST MIB September 2005 INDEX { ipMcastRouteGroupAddressType, ipMcastRouteGroup, ipMcastRouteGroupPrefixLength, ipMcastRouteSourceAddressType, ipMcastRouteSource, ipMcastRouteSourcePrefixLength } ::= { ipMcastRouteTable 1 } IpMcastRouteEntry ::= SEQUENCE { ipMcastRouteGroupAddressType InetAddressType, ipMcastRouteGroup InetAddress, ipMcastRouteGroupPrefixLength InetAddressPrefixLength, ipMcastRouteSourceAddressType InetAddressType, ipMcastRouteSource InetAddress, ipMcastRouteSourcePrefixLength InetAddressPrefixLength, ipMcastRouteUpstreamNeighborType InetAddressType, ipMcastRouteUpstreamNeighbor InetAddress, ipMcastRouteInIfIndex InterfaceIndexOrZero, ipMcastRouteUpTime TimeTicks, ipMcastRouteExpiryTime TimeTicks, ipMcastRoutePkts Counter32, ipMcastRouteDifferentInIfPackets Counter32, ipMcastRouteOctets Counter32, ipMcastRouteProtocol IANAipMRouteProtocol, ipMcastRouteRtProto IANAipRouteProtocol, ipMcastRouteRtAddressType InetAddressType, ipMcastRouteRtAddress InetAddress, ipMcastRouteRtPrefixLength InetAddressPrefixLength, ipMcastRouteRtType INTEGER, ipMcastRouteHCOctets Counter64 } ipMcastRouteGroupAddressType OBJECT-TYPE SYNTAX InetAddressType MAX-ACCESS not-accessible STATUS current DESCRIPTION "A value indicating the address family of the address contained in ipMcastRouteGroup. Legal values correspond to the subset of address families for which multicast forwarding is supported." ::= { ipMcastRouteEntry 1 } ipMcastRouteGroup OBJECT-TYPE SYNTAX InetAddress MAX-ACCESS not-accessible STATUS current DESCRIPTION McWalter, et al. Expires March 25, 2006 [Page 13] Internet-Draft IP MCAST MIB September 2005 "The IP multicast group address which when combined with the corresponding value specified in ipMcastRouteGroupPrefixLength identifies the groups for which this entry contains multicast routing information. This address object is only significant up to ipMcastRouteGroupPrefixLength bits. The remainder of the address bits are zero. This is especially important for this index field, which is part of the index of this entry. Any non-zero bits would signify an entirely different entry." ::= { ipMcastRouteEntry 2 } ipMcastRouteGroupPrefixLength OBJECT-TYPE SYNTAX InetAddressPrefixLength (4..128) MAX-ACCESS not-accessible STATUS current DESCRIPTION "The length in bits of the mask which when combined with the corresponding value of ipMcastRouteGroup identifies the groups for which this entry contains multicast routing information." ::= { ipMcastRouteEntry 3 } ipMcastRouteSourceAddressType OBJECT-TYPE SYNTAX InetAddressType MAX-ACCESS not-accessible STATUS current DESCRIPTION "A value indicating the address family of the address contained in ipMcastRouteSource. The value MUST be the same as the value of ipMcastRouteGroupType." ::= { ipMcastRouteEntry 4 } ipMcastRouteSource OBJECT-TYPE SYNTAX InetAddress MAX-ACCESS not-accessible STATUS current DESCRIPTION "The network address which when combined with the corresponding value of ipMcastRouteSourcePrefixLength identifies the sources for which this entry contains multicast routing information. This address object is only significant up to ipMcastRouteGroupPrefixLength bits. The remainder of the address bits are zero. This is especially important for this index field, which is part of the index of this entry. McWalter, et al. Expires March 25, 2006 [Page 14] Internet-Draft IP MCAST MIB September 2005 Any non-zero bits would signify an entirely different entry." ::= { ipMcastRouteEntry 5 } ipMcastRouteSourcePrefixLength OBJECT-TYPE SYNTAX InetAddressPrefixLength (4..128) MAX-ACCESS not-accessible STATUS current DESCRIPTION "The length in bits of the mask which when combined with the corresponding value of ipMcastRouteSource identifies the sources for which this entry contains multicast routing information." ::= { ipMcastRouteEntry 6 } ipMcastRouteUpstreamNeighborType OBJECT-TYPE SYNTAX InetAddressType MAX-ACCESS read-only STATUS current DESCRIPTION "A value indicating the address family of the address contained in ipMcastRouteUpstreamNeighbor. The value MUST be the same as the value of ipMcastRouteGroupType." ::= { ipMcastRouteEntry 7 } ipMcastRouteUpstreamNeighbor OBJECT-TYPE SYNTAX InetAddress MAX-ACCESS read-only STATUS current DESCRIPTION "The address of the upstream neighbor (for example, RPF neighbor) from which IP datagrams from these sources to this multicast address are received. If the upstream neighbor is unknown, then ipMcastRouteUpstreamNeighbor will be 0.0.0.0 in the case of an IPv4 entry, and 0:0:0:0:0:0:0:0 in the case of an IPv6 entry (for example, in CBT)." ::= { ipMcastRouteEntry 8 } ipMcastRouteInIfIndex OBJECT-TYPE SYNTAX InterfaceIndexOrZero MAX-ACCESS read-only STATUS current DESCRIPTION "The value of ifIndex for the interface on which IP datagrams sent by these sources to this multicast address are received. A value of 0 indicates that datagrams are not subject to an incoming interface check, but may be accepted McWalter, et al. Expires March 25, 2006 [Page 15] Internet-Draft IP MCAST MIB September 2005 on multiple interfaces (for example, in CBT)." ::= { ipMcastRouteEntry 9 } ipMcastRouteUpTime OBJECT-TYPE SYNTAX TimeTicks MAX-ACCESS read-only STATUS current DESCRIPTION "The time since the multicast routing information represented by this entry was learned by the router." ::= { ipMcastRouteEntry 10 } ipMcastRouteExpiryTime OBJECT-TYPE SYNTAX TimeTicks MAX-ACCESS read-only STATUS current DESCRIPTION "The minimum amount of time remaining before this entry will be aged out. The value 0 indicates that the entry is not subject to aging." ::= { ipMcastRouteEntry 11 } ipMcastRoutePkts OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of packets which this router has received from these sources and addressed to this multicast group address." ::= { ipMcastRouteEntry 12 } ipMcastRouteDifferentInIfPackets OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of packets which this router has received from these sources and addressed to this multicast group address, which were dropped because they were not received on the interface indicated by ipMcastRouteInIfIndex. Packets which are not subject to an incoming interface check (for example, using CBT) are not counted." ::= { ipMcastRouteEntry 13 } ipMcastRouteOctets OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only McWalter, et al. Expires March 25, 2006 [Page 16] Internet-Draft IP MCAST MIB September 2005 STATUS current DESCRIPTION "The number of octets contained in IP datagrams which were received from these sources and addressed to this multicast group address, and which were forwarded by this router." ::= { ipMcastRouteEntry 14 } ipMcastRouteProtocol OBJECT-TYPE SYNTAX IANAipMRouteProtocol MAX-ACCESS read-only STATUS current DESCRIPTION "The multicast routing protocol via which this multicast forwarding entry was learned." ::= { ipMcastRouteEntry 15 } ipMcastRouteRtProto OBJECT-TYPE SYNTAX IANAipRouteProtocol MAX-ACCESS read-only STATUS current DESCRIPTION "The routing mechanism via which the route used to find the upstream or parent interface for this multicast forwarding entry was learned. Inclusion of values for routing protocols is not intended to imply that those protocols need be supported." ::= { ipMcastRouteEntry 16 } ipMcastRouteRtAddressType OBJECT-TYPE SYNTAX InetAddressType MAX-ACCESS read-only STATUS current DESCRIPTION "A value indicating the address family of the address contained in ipMcastRouteRtAddress. The value MUST be the same as the value of ipMcastRouteGroupType." ::= { ipMcastRouteEntry 17 } ipMcastRouteRtAddress OBJECT-TYPE SYNTAX InetAddress MAX-ACCESS read-only STATUS current DESCRIPTION "The address portion of the route used to find the upstream or parent interface for this multicast forwarding entry. This address object is only significant up to ipMcastRouteGroupPrefixLength bits. The remainder of the McWalter, et al. Expires March 25, 2006 [Page 17] Internet-Draft IP MCAST MIB September 2005 address bits are zero." ::= { ipMcastRouteEntry 18 } ipMcastRouteRtPrefixLength OBJECT-TYPE SYNTAX InetAddressPrefixLength (4..128) MAX-ACCESS read-only STATUS current DESCRIPTION "The length of the mask associated with the route used to find the upstream or parent interface for this multicast forwarding entry." ::= { ipMcastRouteEntry 19 } ipMcastRouteRtType OBJECT-TYPE SYNTAX INTEGER { unicast (1), -- Unicast route used in multicast RIB multicast (2) -- Multicast route } MAX-ACCESS read-only STATUS current DESCRIPTION "The reason the given route was placed in the (logical) multicast Routing Information Base (RIB). A value of unicast means that the route would normally be placed only in the unicast RIB, but was placed in the multicast RIB (instead or in addition) due to local configuration, such as when running PIM over RIP. A value of multicast means that the route was explicitly added to the multicast RIB by the routing protocol, such as DVMRP or Multiprotocol BGP." ::= { ipMcastRouteEntry 20 } ipMcastRouteHCOctets OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of octets contained in IP datagrams which were received from these sources and addressed to this multicast group address, and which were forwarded by this router. This object is a 64-bit version of ipMcastRouteOctets." ::= { ipMcastRouteEntry 21 } -- -- The IP Multicast Routing Next Hop Table -- ipMcastRouteNextHopTable OBJECT-TYPE SYNTAX SEQUENCE OF IpMcastRouteNextHopEntry McWalter, et al. Expires March 25, 2006 [Page 18] Internet-Draft IP MCAST MIB September 2005 MAX-ACCESS not-accessible STATUS current DESCRIPTION "The (conceptual) table containing information on the next-hops on outgoing interfaces for routing IP multicast datagrams. Each entry is one of a list of next-hops on outgoing interfaces for particular sources sending to a particular multicast group address." ::= { ipMcast 3 } ipMcastRouteNextHopEntry OBJECT-TYPE SYNTAX IpMcastRouteNextHopEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry (conceptual row) in the list of next-hops on outgoing interfaces to which IP multicast datagrams from particular sources to an IP multicast group address are routed. Discontinuities in counters in this entry can be detected by observing the value of ipMcastRouteNextHopUpTime." INDEX { ipMcastRouteNextHopGroupAddressType, ipMcastRouteNextHopGroup, ipMcastRouteNextHopSourceAddressType, ipMcastRouteNextHopSource, ipMcastRouteNextHopSourcePrefixLength, ipMcastRouteNextHopIfIndex, ipMcastRouteNextHopAddressType, ipMcastRouteNextHopAddress } ::= { ipMcastRouteNextHopTable 1 } IpMcastRouteNextHopEntry ::= SEQUENCE { ipMcastRouteNextHopGroupAddressType InetAddressType, ipMcastRouteNextHopGroup InetAddress, ipMcastRouteNextHopSourceAddressType InetAddressType, ipMcastRouteNextHopSource InetAddress, ipMcastRouteNextHopSourcePrefixLength InetAddressPrefixLength, ipMcastRouteNextHopIfIndex InterfaceIndex, ipMcastRouteNextHopAddressType InetAddressType, ipMcastRouteNextHopAddress InetAddress, ipMcastRouteNextHopState INTEGER, ipMcastRouteNextHopUpTime TimeTicks, ipMcastRouteNextHopExpiryTime TimeTicks, ipMcastRouteNextHopClosestMemberHops Integer32, ipMcastRouteNextHopProtocol IANAipMRouteProtocol, ipMcastRouteNextHopPkts Counter32 } McWalter, et al. Expires March 25, 2006 [Page 19] Internet-Draft IP MCAST MIB September 2005 ipMcastRouteNextHopGroupAddressType OBJECT-TYPE SYNTAX InetAddressType MAX-ACCESS not-accessible STATUS current DESCRIPTION "A value indicating the address family of the address contained in ipMcastRouteNextHopGroup. Legal values correspond to the subset of address families for which multicast forwarding is supported." ::= { ipMcastRouteNextHopEntry 1 } ipMcastRouteNextHopGroup OBJECT-TYPE SYNTAX InetAddress MAX-ACCESS not-accessible STATUS current DESCRIPTION "The IP multicast group for which this entry specifies a next-hop on an outgoing interface." ::= { ipMcastRouteNextHopEntry 2 } ipMcastRouteNextHopSourceAddressType OBJECT-TYPE SYNTAX InetAddressType MAX-ACCESS not-accessible STATUS current DESCRIPTION "A value indicating the address family of the address contained in ipMcastRouteNextHopSource. The value MUST be the same as the value of ipMcastRouteNextHopGroupType." ::= { ipMcastRouteNextHopEntry 3 } ipMcastRouteNextHopSource OBJECT-TYPE SYNTAX InetAddress MAX-ACCESS not-accessible STATUS current DESCRIPTION "The network address which when combined with the corresponding value of the mask specified in ipMcastRouteNextHopSourcePrefixLength identifies the sources for which this entry specifies a next-hop on an outgoing interface. This address object is only significant up to ipMcastRouteNextHopSourcePrefixLength bits. The remainder of the address bits are zero. This is especially important for this index field, which is part of the index of this entry. Any non-zero bits would signify an entirely different entry." ::= { ipMcastRouteNextHopEntry 4 } McWalter, et al. Expires March 25, 2006 [Page 20] Internet-Draft IP MCAST MIB September 2005 ipMcastRouteNextHopSourcePrefixLength OBJECT-TYPE SYNTAX InetAddressPrefixLength (4..128) MAX-ACCESS not-accessible STATUS current DESCRIPTION "The length in bits of the mask which when combined with the corresponding value specified in ipMcastRouteNextHopSource identifies the sources for which this entry specifies a next-hop on an outgoing interface." ::= { ipMcastRouteNextHopEntry 5 } ipMcastRouteNextHopIfIndex OBJECT-TYPE SYNTAX InterfaceIndex MAX-ACCESS not-accessible STATUS current DESCRIPTION "The ifIndex value of the interface for the outgoing interface for this next-hop." ::= { ipMcastRouteNextHopEntry 6 } ipMcastRouteNextHopAddressType OBJECT-TYPE SYNTAX InetAddressType MAX-ACCESS not-accessible STATUS current DESCRIPTION "A value indicating the address family of the address contained in ipMcastRouteNextHopAddress. The value MUST be the same as the value of ipMcastRouteNextHopGroupType." ::= { ipMcastRouteNextHopEntry 7 } ipMcastRouteNextHopAddress OBJECT-TYPE SYNTAX InetAddress MAX-ACCESS not-accessible STATUS current DESCRIPTION "The address of the next-hop specific to this entry. For most interfaces, this is identical to ipMcastRouteNextHopGroup. NBMA interfaces, however, may have multiple next-hop addresses out a single outgoing interface." ::= { ipMcastRouteNextHopEntry 8 } ipMcastRouteNextHopState OBJECT-TYPE SYNTAX INTEGER { pruned(1), forwarding(2) } MAX-ACCESS read-only STATUS current DESCRIPTION "An indication of whether the outgoing interface and next- McWalter, et al. Expires March 25, 2006 [Page 21] Internet-Draft IP MCAST MIB September 2005 hop represented by this entry is currently being used to forward IP datagrams. The value 'forwarding' indicates it is currently being used; the value 'pruned' indicates it is not." ::= { ipMcastRouteNextHopEntry 9 } ipMcastRouteNextHopUpTime OBJECT-TYPE SYNTAX TimeTicks MAX-ACCESS read-only STATUS current DESCRIPTION "The time since the multicast routing information represented by this entry was learned by the router." ::= { ipMcastRouteNextHopEntry 10 } ipMcastRouteNextHopExpiryTime OBJECT-TYPE SYNTAX TimeTicks MAX-ACCESS read-only STATUS current DESCRIPTION "The minimum amount of time remaining before this entry will be aged out. If ipMcastRouteNextHopState is pruned(1), the remaining time until the prune expires and the state reverts to forwarding(2). Otherwise, the remaining time until this entry is removed from the table. The time remaining may be copied from ipMcastRouteExpiryTime if the protocol in use for this entry does not specify next-hop timers. The value 0 indicates that the entry is not subject to aging." ::= { ipMcastRouteNextHopEntry 11 } ipMcastRouteNextHopClosestMemberHops OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current DESCRIPTION "The minimum number of hops between this router and any member of this IP multicast group reached via this next-hop on this outgoing interface. Any IP multicast datagrams for the group which have a TTL (IPv4) or Hop Count (IPv6) less than this number of hops will not be forwarded to this next-hop." ::= { ipMcastRouteNextHopEntry 12 } ipMcastRouteNextHopProtocol OBJECT-TYPE SYNTAX IANAipMRouteProtocol MAX-ACCESS read-only STATUS current DESCRIPTION McWalter, et al. Expires March 25, 2006 [Page 22] Internet-Draft IP MCAST MIB September 2005 "The routing mechanism via which this next-hop was learned." ::= { ipMcastRouteNextHopEntry 13 } ipMcastRouteNextHopPkts OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of packets which have been forwarded using this route." ::= { ipMcastRouteNextHopEntry 14 } -- -- The IP Multicast Scope Boundary Table -- ipMcastBoundaryTable OBJECT-TYPE SYNTAX SEQUENCE OF IpMcastBoundaryEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The (conceptual) table listing the system's scoped multicast address boundaries." ::= { ipMcast 5 } ipMcastBoundaryEntry OBJECT-TYPE SYNTAX IpMcastBoundaryEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry (conceptual row) in the ipMcastBoundaryTable representing a scoped boundary. This entry is preserved on agent restart." INDEX { ipMcastBoundaryIfIndex, ipMcastBoundaryAddressType, ipMcastBoundaryAddress, ipMcastBoundaryAddressPrefixLength } ::= { ipMcastBoundaryTable 1 } IpMcastBoundaryEntry ::= SEQUENCE { ipMcastBoundaryIfIndex InterfaceIndex, ipMcastBoundaryAddressType InetAddressType, ipMcastBoundaryAddress InetAddress, ipMcastBoundaryAddressPrefixLength InetAddressPrefixLength, ipMcastBoundaryStatus RowStatus } ipMcastBoundaryIfIndex OBJECT-TYPE McWalter, et al. Expires March 25, 2006 [Page 23] Internet-Draft IP MCAST MIB September 2005 SYNTAX InterfaceIndex MAX-ACCESS not-accessible STATUS current DESCRIPTION "The IfIndex value for the interface to which this boundary applies. Packets with a destination address in the associated address/mask range will not be forwarded out this interface." ::= { ipMcastBoundaryEntry 1 } ipMcastBoundaryAddressType OBJECT-TYPE SYNTAX InetAddressType MAX-ACCESS not-accessible STATUS current DESCRIPTION "A value indicating the address family of the address contained in ipMcastBoundaryAddress. Legal values correspond to the subset of address families for which multicast forwarding is supported." ::= { ipMcastBoundaryEntry 2 } ipMcastBoundaryAddress OBJECT-TYPE SYNTAX InetAddress MAX-ACCESS not-accessible STATUS current DESCRIPTION "The group address which when combined with the corresponding value of ipMcastBoundaryAddressPrefixLength identifies the group range for which the scoped boundary exists. Scoped IPv4 addresses must come from the range 239.x.x.x. Scoped IPv6 addresses must come from range ff.nn.nn.nn.nn.nn.nn.nn, where nn encodes the scope type and group identifier. This address object is only significant up to ipMcastBoundaryAddressPrefixLength bits. The remainder of the address bits are zero. This is especially important for this index field, which is part of the index of this entry. Any non-zero bits would signify an entirely different entry." REFERENCE "RFC 2365, RFC 2373" ::= { ipMcastBoundaryEntry 3 } ipMcastBoundaryAddressPrefixLength OBJECT-TYPE SYNTAX InetAddressPrefixLength (4..128) MAX-ACCESS not-accessible STATUS current DESCRIPTION McWalter, et al. Expires March 25, 2006 [Page 24] Internet-Draft IP MCAST MIB September 2005 "The length in bits of the mask which when combined with the corresponding value of ipMcastBoundaryAddress identifies the group range for which the scoped boundary exists." ::= { ipMcastBoundaryEntry 4 } ipMcastBoundaryStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The status of this row, by which rows in this table can be created and destroyed. There are no other other writeable columnar objects in this entry." ::= { ipMcastBoundaryEntry 5 } -- -- The IP Multicast Scope Name Table -- ipMcastScopeNameTable OBJECT-TYPE SYNTAX SEQUENCE OF IpMcastScopeNameEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The (conceptual) table listing multicast scope names." ::= { ipMcast 6 } ipMcastScopeNameEntry OBJECT-TYPE SYNTAX IpMcastScopeNameEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry (conceptual row) in the ipMcastScopeNameTable representing a multicast scope name. This entry is preserved on agent restart." INDEX { ipMcastScopeNameAddressType, ipMcastScopeNameAddress, ipMcastScopeNameAddressPrefixLength, IMPLIED ipMcastScopeNameLanguage } ::= { ipMcastScopeNameTable 1 } IpMcastScopeNameEntry ::= SEQUENCE { ipMcastScopeNameAddressType InetAddressType, ipMcastScopeNameAddress InetAddress, ipMcastScopeNameAddressPrefixLength InetAddressPrefixLength, ipMcastScopeNameLanguage LanguageTag, ipMcastScopeNameString SnmpAdminString, ipMcastScopeNameDefault TruthValue, McWalter, et al. Expires March 25, 2006 [Page 25] Internet-Draft IP MCAST MIB September 2005 ipMcastScopeNameStatus RowStatus } ipMcastScopeNameAddressType OBJECT-TYPE SYNTAX InetAddressType MAX-ACCESS not-accessible STATUS current DESCRIPTION "A value indicating the address family of the address contained in ipMcastScopeNameAddress. Legal values correspond to the subset of address families for which multicast forwarding is supported." ::= { ipMcastScopeNameEntry 1 } ipMcastScopeNameAddress OBJECT-TYPE SYNTAX InetAddress MAX-ACCESS not-accessible STATUS current DESCRIPTION "The group address which when combined with the corresponding value of ipMcastScopeNameAddressPrefixLength identifies the group range associated with the multicast scope. Scoped IPv4 addresses must come from the range 239.x.x.x. Scoped IPv6 addresses must come from the range ff.nn.nn.nn.nn.nn.nn.nn, where nn encodes the scope type and group identifier. This address object is only significant up to ipMcastScopeNameAddressPrefixLength bits. The remainder of the address bits are zero. This is especially important for this index field, which is part of the index of this entry. Any non-zero bits would signify an entirely different entry." REFERENCE "RFC 2365, RFC 2373" ::= { ipMcastScopeNameEntry 2 } ipMcastScopeNameAddressPrefixLength OBJECT-TYPE SYNTAX InetAddressPrefixLength (4..128) MAX-ACCESS not-accessible STATUS current DESCRIPTION "The length in bits of the mask which when combined with the corresponding value of ipMcastScopeNameAddress identifies the group range associated with the multicast scope." ::= { ipMcastScopeNameEntry 3 } ipMcastScopeNameLanguage OBJECT-TYPE SYNTAX LanguageTag McWalter, et al. Expires March 25, 2006 [Page 26] Internet-Draft IP MCAST MIB September 2005 MAX-ACCESS not-accessible STATUS current DESCRIPTION "Language tag associated with the scope name." REFERENCE "RFC 1766" ::= { ipMcastScopeNameEntry 4 } ipMcastScopeNameString OBJECT-TYPE SYNTAX SnmpAdminString MAX-ACCESS read-create STATUS current DESCRIPTION "The textual name associated with the multicast scope. The value of this object should be suitable for displaying to end-users, such as when allocating a multicast address in this scope. When no name is specified, the default value of this object for IPv4 should be the string 239.x.x.x/y with x and y replaced appropriately to describe the address and mask length associated with the scope. Scoped IPv6 addresses must come from range ff.nn.nn.nn.nn.nn.nn.nn, where nn encodes the scope type and group identifier." ::= { ipMcastScopeNameEntry 5 } ipMcastScopeNameDefault OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-create STATUS current DESCRIPTION "If true, indicates a preference that the name in the following language should be used by applications if no name is available in a desired language." DEFVAL { false } ::= { ipMcastScopeNameEntry 6 } ipMcastScopeNameStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The status of this row, by which rows in this table can be created and destroyed. Before the row can be activated, the object ipMcastScopeNameString must be set to a valid value. All writeable objects in this entry can be modified when the status is active(1)." ::= { ipMcastScopeNameEntry 7 } -- -- The Multicast Listeners Table McWalter, et al. Expires March 25, 2006 [Page 27] Internet-Draft IP MCAST MIB September 2005 -- ipMcastLocalListenerTable OBJECT-TYPE SYNTAX SEQUENCE OF IpMcastLocalListenerEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The (conceptual) table listing local applications or services that have joined multicast groups as listeners." ::= { ipMcast 9 } ipMcastLocalListenerEntry OBJECT-TYPE SYNTAX IpMcastLocalListenerEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry (conceptual row) in the LocalListenerTable." INDEX { ipMcastLocalListenerGroupAddressType, ipMcastLocalListenerGroupAddress, ipMcastLocalListenerSourceAddressType, ipMcastLocalListenerSourceAddress, ipMcastLocalListenerSourcePrefixLength, ipMcastLocalListenerRunIndex } ::= { ipMcastLocalListenerTable 1 } IpMcastLocalListenerEntry ::= SEQUENCE { ipMcastLocalListenerGroupAddressType InetAddressType, ipMcastLocalListenerGroupAddress InetAddress, ipMcastLocalListenerSourceAddressType InetAddressType, ipMcastLocalListenerSourceAddress InetAddress, ipMcastLocalListenerSourcePrefixLength InetAddressPrefixLength, ipMcastLocalListenerRunIndex Integer32 } ipMcastLocalListenerGroupAddressType OBJECT-TYPE SYNTAX InetAddressType MAX-ACCESS not-accessible STATUS current DESCRIPTION "A value indicating the address family of the address contained in ipMcastLocalListenerGroupAddress. Legal values correspond to the subset of address families for which multicast is supported." ::= { ipMcastLocalListenerEntry 1 } ipMcastLocalListenerGroupAddress OBJECT-TYPE SYNTAX InetAddress MAX-ACCESS not-accessible McWalter, et al. Expires March 25, 2006 [Page 28] Internet-Draft IP MCAST MIB September 2005 STATUS current DESCRIPTION "The IP multicast group for which this entry specifies locally joined applications or services." ::= { ipMcastLocalListenerEntry 2 } ipMcastLocalListenerSourceAddressType OBJECT-TYPE SYNTAX InetAddressType MAX-ACCESS not-accessible STATUS current DESCRIPTION "A value indicating the address family of the address contained in ipMcastLocalListenerSource. The value MUST be the same as the value of ipMcastLocalListenerAddressType." ::= { ipMcastLocalListenerEntry 3 } ipMcastLocalListenerSourceAddress OBJECT-TYPE SYNTAX InetAddress MAX-ACCESS not-accessible STATUS current DESCRIPTION "The network address which when combined with the corresponding value of the mask specified in ipMcastLocalListenerSourcePrefixLength identifies the sources for which this entry specifies a local listener. This address object is only significant up to ipMcastLocalListenerSourcePrefixLength bits. The remainder of the address bits are zero. This is especially important for this index field, which is part of the index of this entry. Any non-zero bits would signify an entirely different entry." ::= { ipMcastLocalListenerEntry 4 } ipMcastLocalListenerSourcePrefixLength OBJECT-TYPE SYNTAX InetAddressPrefixLength (4..128) MAX-ACCESS not-accessible STATUS current DESCRIPTION "The length in bits of the mask which when combined with the corresponding value specified in ipMcastLocalListenerSource identifies the sources for which this entry specifies a locally listener. A mask length of zero corresponds to all sources within the group." ::= { ipMcastLocalListenerEntry 5 } ipMcastLocalListenerRunIndex OBJECT-TYPE SYNTAX Integer32 (1..2147483647) McWalter, et al. Expires March 25, 2006 [Page 29] Internet-Draft IP MCAST MIB September 2005 MAX-ACCESS read-only STATUS current DESCRIPTION "A unique value corresponding to a piece of software running on this router or host system. Where possible, this should be the system's native, unique identification number." ::= { ipMcastLocalListenerEntry 6 } -- -- Conformance information -- ipMcastMIBConformance OBJECT IDENTIFIER ::= { ipMcastMIB 2 } ipMcastMIBCompliances OBJECT IDENTIFIER ::= { ipMcastMIBConformance 1 } ipMcastMIBGroups OBJECT IDENTIFIER ::= { ipMcastMIBConformance 2 } -- -- Compliance statements -- ipMcastMIBCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for the IP Multicast MIB." MODULE -- this module MANDATORY-GROUPS { ipMcastMIBBasicGroup} GROUP ipMcastMIBRouteGroup DESCRIPTION "This group is mandatory if the system is a router." GROUP ipMcastMIBSsmGroup DESCRIPTION "This group is mandatory if the system is a router that supports Source-Specific Multicast. Write access is not required." GROUP ipMcastMIBBoundaryGroup DESCRIPTION "This group is mandatory if the system is a router that supports administratively-scoped multicast address boundaries." OBJECT ipMcastBoundaryStatus MIN-ACCESS read-only DESCRIPTION McWalter, et al. Expires March 25, 2006 [Page 30] Internet-Draft IP MCAST MIB September 2005 "Write access is not required." OBJECT ipMcastScopeNameStatus MIN-ACCESS read-only DESCRIPTION "Write access is not required." GROUP ipMcastMIBHCInterfaceGroup DESCRIPTION "This group is mandatory only for those network interfaces for which the value of the corresponding instance of ifSpeed is greater than 20,000,000 bits/second." GROUP ipMcastMIBRouteProtoGroup DESCRIPTION "This group is mandatory if the system is a router." ::= { ipMcastMIBCompliances 1 } -- -- Units of conformance -- ipMcastMIBBasicGroup OBJECT-GROUP OBJECTS { ipMcastEnable, ipMcastRouteEntryCount } STATUS current DESCRIPTION "A collection of objects to support basic management of IP Multicast protocols." ::= { ipMcastMIBGroups 1 } ipMcastMIBRouteGroup OBJECT-GROUP OBJECTS { ipMcastRouteUpstreamNeighborType, ipMcastRouteUpstreamNeighbor, ipMcastRouteInIfIndex, ipMcastRouteUpTime, ipMcastRouteExpiryTime, ipMcastRouteNextHopState, ipMcastRouteNextHopUpTime, ipMcastRouteNextHopExpiryTime, ipMcastRouteNextHopProtocol, ipMcastRouteNextHopPkts, ipMcastInterfaceTtl, ipMcastInterfaceProtocol, ipMcastInterfaceRateLimit, ipMcastInterfaceInMcastOctets, ipMcastInterfaceOutMcastOctets, ipMcastInterfaceInMcastPkts, ipMcastInterfaceOutMcastPkts, McWalter, et al. Expires March 25, 2006 [Page 31] Internet-Draft IP MCAST MIB September 2005 ipMcastInterfaceProtocol } STATUS current DESCRIPTION "A collection of objects to support basic management of IP Multicast routing." ::= { ipMcastMIBGroups 2 } ipMcastMIBSsmGroup OBJECT-GROUP OBJECTS { ipMcastSsmRangeRowStatus } STATUS current DESCRIPTION "A collection of objects to support management of the use of Source-Specific Multicast routing." ::= { ipMcastMIBGroups 3 } ipMcastMIBHopCountGroup OBJECT-GROUP OBJECTS { ipMcastRouteNextHopClosestMemberHops } STATUS current DESCRIPTION "A collection of objects to support management of the use of hop counts in IP Multicast routing." ::= { ipMcastMIBGroups 4 } ipMcastMIBBoundaryGroup OBJECT-GROUP OBJECTS { ipMcastBoundaryStatus, ipMcastScopeNameString, ipMcastScopeNameDefault, ipMcastScopeNameStatus } STATUS current DESCRIPTION "A collection of objects to support management of scoped multicast address boundaries." ::= { ipMcastMIBGroups 5 } ipMcastMIBPktsOutGroup OBJECT-GROUP OBJECTS { ipMcastRouteNextHopPkts } STATUS current DESCRIPTION "A collection of objects to support management of packet counters for each outgoing interface entry of a route." ::= { ipMcastMIBGroups 6 } ipMcastMIBHCInterfaceGroup OBJECT-GROUP OBJECTS { ipMcastInterfaceHCInMcastOctets, ipMcastInterfaceHCOutMcastOctets, ipMcastInterfaceHCInMcastPkts, ipMcastInterfaceHCOutMcastPkts, ipMcastRouteHCOctets } STATUS current McWalter, et al. Expires March 25, 2006 [Page 32] Internet-Draft IP MCAST MIB September 2005 DESCRIPTION "A collection of objects providing information specific to high speed (greater than 20,000,000 bits/second) network interfaces." ::= { ipMcastMIBGroups 7 } ipMcastMIBRouteProtoGroup OBJECT-GROUP OBJECTS { ipMcastRouteProtocol, ipMcastRouteRtProto, ipMcastRouteRtAddressType, ipMcastRouteRtAddress, ipMcastRouteRtPrefixLength, ipMcastRouteRtType } STATUS current DESCRIPTION "A collection of objects providing information on the relationship between multicast routing information, and the IP Forwarding Table." ::= { ipMcastMIBGroups 8 } ipMcastMIBPktsGroup OBJECT-GROUP OBJECTS { ipMcastRoutePkts, ipMcastRouteDifferentInIfPackets, ipMcastRouteOctets } STATUS current DESCRIPTION "A collection of objects to support management of packet counters for each forwarding entry." ::= { ipMcastMIBGroups 9 } ipMcastMIBLocalListenerGroup OBJECT-GROUP OBJECTS { ipMcastLocalListenerRunIndex } STATUS current DESCRIPTION "A collection of objects to support management of local listeners on hosts or routers." ::= { ipMcastMIBGroups 10 } END 5. Security Considerations There are a number of management objects defined in this MIB module with a MAX-ACCESS clause of read-write and/or read-create. Such objects may be considered sensitive or vulnerable in some network environments. The support for SET operations in a non-secure environment without proper protection can have a negative effect on network operations. These are the tables and objects and their sensitivity/vulnerability: Authors' note: To do, when fields are agreed. McWalter, et al. Expires March 25, 2006 [Page 33] Internet-Draft IP MCAST MIB September 2005 Some of the readable objects in this MIB module (i.e., objects with a MAX-ACCESS other than not-accessible) may be considered sensitive or vulnerable in some network environments. It is thus important to control even GET and/or NOTIFY access to these objects and possibly to even encrypt the values of these objects when sending them over the network via SNMP. These are the tables and objects and their sensitivity/vulnerability: Authors' note: To do, when fields are agreed. SNMP versions prior to SNMPv3 did not include adequate security. Even if the network itself is secure (for example by using IPSec), there is still no control over whom on the secure network is allowed to access (read/change/create/delete) the objects in this MIB module. It is RECOMMENDED that implementers consider the security features as provided by the SNMPv3 framework (see [RFC3410], section 8), including full support for the SNMPv3 cryptographic mechanisms (for authentication and privacy). Further, deployment of SNMP versions prior to SNMPv3 is NOT RECOMMENDED. Instead, it is RECOMMENDED to deploy SNMPv3 and to enable cryptographic security. It is then a customer/operator responsibility to ensure that the SNMP entity giving access to an instance of this MIB module is properly configured to give access to the objects only to those principals (users) that have legitimate rights to access (read/change/create/delete) them. 6. IANA Considerations IP-MCAST-MIB should be rooted under the mib-2 subtree. IANA is requested to assign { mib-2 XXX } to the IP-MCAST-MIB module specified in this document. 7. Acknowledgements This MIB module is based on the original work in [RFC2932] by K. McCloghrie, D. Farinacci and D. Thaler. Suggested IPv6 multicast MIBs by R. Sivaramu and R. Raghunarayan have been used for comparison while editing this MIB module. 8. References 8.1 Normative References [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997. McWalter, et al. Expires March 25, 2006 [Page 34] Internet-Draft IP MCAST MIB September 2005 [RFC2365] Meyer, D., "Administratively Scoped IP Multicast", BCP 23, RFC 2365, July 1998. [RFC2434] Narten, T. and H. Alvestrand, "Guidelines for Writing an IANA Considerations Section in RFCs", BCP 26, RFC 2434, October 1998. [RFC2578] McCloghrie, K., Ed., Perkins, D., Ed., and J. Schoenwaelder, Ed., "Structure of Management Information Version 2 (SMIv2)", STD 58, RFC 2578, April 1999. [RFC2579] McCloghrie, K., Ed., Perkins, D., Ed., and J. Schoenwaelder, Ed., "Textual Conventions for SMIv2", STD 58, RFC 2579, April 1999. [RFC2580] McCloghrie, K., Perkins, D., and J. Schoenwaelder, "Conformance Statements for SMIv2", STD 58, RFC 2580, April 1999. [RFC2863] McCloghrie, K. and F. Kastenholz, "The Interfaces Group MIB", RFC 2863, June 2000. [RFC3569] Bhattacharyya, S., "An Overview of Source-Specific Multicast (SSM)", RFC 3569, July 2003. [RFC4001] Daniele, M., Haberman, B., Routhier, S., and J. Schoenwaelder, "Textual Conventions for Internet Network Addresses", RFC 4001, February 2005. 8.2 Informative References [RFC1075] Waitzman, D., Partridge, C., and S. Deering, "Distance Vector Multicast Routing Protocol", RFC 1075, November 1988. [RFC1584] Moy, J., "Multicast Extensions to OSPF", RFC 1584, March 1994. [RFC2189] Ballardie, T., "Core Based Trees (CBT version 2) Multicast Routing -- Protocol Specification --", RFC 2189, September 1997. [RFC2932] McCloghrie, K., Farinacci, D., and D. Thaler, "IPv4 Multicast Routing MIB", RFC 2932, October 2000. [RFC2934] McCloghrie, K., Farinacci, D., Thaler, D., and B. Fenner, "Protocol Independent Multicast MIB for IPv4", RFC 2934, October 2000. McWalter, et al. Expires March 25, 2006 [Page 35] Internet-Draft IP MCAST MIB September 2005 [RFC3410] Case, J., Mundy, R., Partain, D., and B. Stewart, "Introduction and Applicability Statements for Internet- Standard Management Framework", RFC 3410, December 2002. [I-D.ietf-pim-sm-v2-new] Fenner, B., Handley, M., Holbrook, H., and I. Kouvelas, "Protocol Independent Multicast - Sparse Mode PIM-SM): Protocol Specification (Revised)", draft-ietf-pim-sm-v2-new-11 (work in progress), October 2004. [I-D.ietf-pim-bidir] Handley, M., Kouvelas, I., Speakman, T., and L. Vicisano, "Bi-directional Protocol Independent Multicast (BIDIR- PIM)", draft-ietf-pim-bidir-07 (work in progress), March 2005. Authors' Addresses David McWalter Data Connection Ltd 100 Church Street Enfield EN2 6BQ UK Email: dmcw@dataconnection.com Dave Thaler Microsoft Corporation One Microsoft Way Redmond WA 98052-6399 USA Email: dthaler@windows.microsoft.com Andrew Kessler Cisco Systems 425 E. Tasman Drive San Jose CA 95134 USA Email: kessler@cisco.com McWalter, et al. Expires March 25, 2006 [Page 36] Internet-Draft IP MCAST MIB September 2005 Intellectual Property Statement The IETF takes no position regarding the validity or scope of any Intellectual Property Rights or other rights that might be claimed to pertain to the implementation or use of the technology described in this document or the extent to which any license under such rights might or might not be available; nor does it represent that it has made any independent effort to identify any such rights. Information on the procedures with respect to rights in RFC documents can be found in BCP 78 and BCP 79. Copies of IPR disclosures made to the IETF Secretariat and any assurances of licenses to be made available, or the result of an attempt made to obtain a general license or permission for the use of such proprietary rights by implementers or users of this specification can be obtained from the IETF on-line IPR repository at http://www.ietf.org/ipr. The IETF invites any interested party to bring to its attention any copyrights, patents or patent applications, or other proprietary rights that may cover technology that may be required to implement this standard. Please address the information to the IETF at ietf-ipr@ietf.org. Disclaimer of Validity This document and the information contained herein are provided on an "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Copyright Statement Copyright (C) The Internet Society (2005). This document is subject to the rights, licenses and restrictions contained in BCP 78, and except as set forth therein, the authors retain all their rights. Acknowledgment Funding for the RFC Editor function is currently provided by the Internet Society. McWalter, et al. Expires March 25, 2006 [Page 37]