-- extracted from draft-ietf-ipngwg-mld-mib-03.txt -- at Tue Jun 6 07:07:27 2000 MLD-MIB DEFINITIONS ::= BEGIN IMPORTS MODULE-IDENTITY, OBJECT-TYPE, Counter32, Gauge32, Integer32, TimeTicks, mib-2 FROM SNMPv2-SMI RowStatus, TruthValue FROM SNMPv2-TC Ipv6Address, Ipv6IfIndexOrZero FROM IPV6-TC MODULE-COMPLIANCE, OBJECT-GROUP FROM SNMPv2-CONF; mldMIB MODULE-IDENTITY LAST-UPDATED "200006021500Z" ORGANIZATION "IETF IPNGWG Working Group." CONTACT-INFO " Brian Haberman Nortel Networks 4309 Emperor Blvd. Durham, NC 27703 USA Haberman, Worzella 3 Internet Draft MIB for MLD December 1999 Phone: +1 919 992 4439 e-mail: haberman@nortelnetworks.com" DESCRIPTION "The MIB module for MLD Management." REVISION "9912171600Z" ::= { mib-2 xx } -- NOTE TO RFC EDITOR: When this document is published as -- an RFC, replace xx with IANA-assigned value and delete -- this comment. mldMIBObjects OBJECT IDENTIFIER ::= { mldMIB 1 } mld OBJECT IDENTIFIER ::= { mldMIBObjects 1 } -- -- The MLD Interface Table -- mldInterfaceTable OBJECT-TYPE SYNTAX SEQUENCE OF MldInterfaceEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The (conceptual) table listing the interfaces on which MLD is enabled." ::= { mld 1 } mldInterfaceEntry OBJECT-TYPE SYNTAX MldInterfaceEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry (conceptual row) representing an interface on which MLD is enabled." INDEX { mldInterfaceIfIndex } ::= { mldInterfaceTable 1 } MldInterfaceEntry ::= SEQUENCE { mldInterfaceIfIndex Ipv6IfIndexOrZero, mldInterfaceQueryInterval Integer32, mldInterfaceStatus RowStatus, mldInterfaceVersion Integer32, mldInterfaceQuerier Ipv6Address, mldInterfaceQueryMaxResponseDelay Integer32, mldInterfaceJoins Counter32, mldInterfaceGroups Gauge32, mldInterfaceRobustness Integer32, mldInterfaceLastListenQueryIntvl Integer32, mldInterfaceProxyIfIndex InterfaceIndexOrZero, Haberman, Worzella 4 Internet Draft MIB for MLD December 1999 mldInterfaceQuerierUpTime TimeTicks, mldInterfaceQuerierExpiryTime TimeTicks } mldInterfaceIfIndex OBJECT-TYPE SYNTAX Ipv6IfIndexOrZero MAX-ACCESS not-accessible STATUS current DESCRIPTION "The ifIndex value of the interface for which MLD is enabled." ::= { mldInterfaceEntry 1 } mldInterfaceQueryInterval OBJECT-TYPE SYNTAX Integer32 UNITS "seconds" MAX-ACCESS read-create STATUS current DESCRIPTION "The frequency at which MLD Host-Query packets are transmitted on this interface." DEFVAL { 125 } ::= { mldInterfaceEntry 2 } mldInterfaceStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The activation of a row enables MLD on the interface. The destruction of a row disables MLD on the interface." ::= { mldInterfaceEntry 3 } mldInterfaceVersion OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-create STATUS current DESCRIPTION "The version of MLD which is running on this interface. This object is a place holder to allow for new versions of MLD to be introduced." DEFVAL { 1 } ::= {mldInterfaceEntry 4 } mldInterfaceQuerier OBJECT-TYPE SYNTAX Ipv6Address MAX-ACCESS read-only STATUS current DESCRIPTION "The address of the MLD Querier on the IPv6 subnet to which this interface is attached." Haberman, Worzella 5 Internet Draft MIB for MLD December 1999 ::= { mldInterfaceEntry 5 } mldInterfaceQueryMaxResponseDelay OBJECT-TYPE SYNTAX Integer32 UNITS "seconds" MAX-ACCESS read-create STATUS current DESCRIPTION "The maximum query response time advertised in MLD queries on this interface." DEFVAL { 10 } ::= { mldInterfaceEntry 6 } mldInterfaceJoins OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times a group membership has been added on this interface; that is, the number of times an entry for this interface has been added to the Cache Table. This object gives an indication of the amount of MLD activity over time." ::= { mldInterfaceEntry 7 } mldInterfaceGroups OBJECT-TYPE SYNTAX Gauge32 MAX-ACCESS read-only STATUS current DESCRIPTION "The current number of entries for this interface in the Cache Table." ::= { mldInterfaceEntry 8 } mldInterfaceRobustness OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-create STATUS current DESCRIPTION "The Robustness Variable allows tuning for the expected packet loss on a subnet. If a subnet is expected to be lossy, the Robustness Variable may be increased. MLD is robust to (Robustness Variable-1) packet losses." DEFVAL { 2 } ::= { mldInterfaceEntry 9 } mldInterfaceLastListenQueryIntvl OBJECT-TYPE SYNTAX Integer32 UNITS "seconds" MAX-ACCESS read-create STATUS current DESCRIPTION Haberman, Worzella 6 Internet Draft MIB for MLD December 1999 "The Last Member Query Interval is the Max Response Delay inserted into Group-Specific Queries sent in response to Leave Group messages, and is also the amount of time between Group-Specific Query messages. This value may be tuned to modify the leave latency of the network. A reduced value results in reduced time to detect the loss of the last member of a group." DEFVAL { 1 } ::= { mldInterfaceEntry 10 } mldInterfaceProxtIfIndex SYNTAX InterfaceIndexOrZero MAX-ACCESS read-create STATUS current DESCRIPTION "Some devices implement a form of IGMP proxying whereby memberships learned on the interface represented by this row, cause MLD Multicast Listener Reports to be sent on the interface whose ifIndex value is given by this object. Such a device would implement mldRouterMIBGroup only on its router interfaces (those interfaces with non-zero mldInterfaceProxyIfIndex). Typically, the value of this object is 0, indicating that no proxying is being done. DEFVAL { 0 } ::= { mldInterfaceEntry 11 } mldInterfaceQuerierUpTime OBJECT-TYPE SYNTAX TimeTicks MAX-ACCESS read-only STATUS current DESCRIPTION "The time since mldInterfaceQuerier was last changed." ::= { mldInterfaceEntry 12 } mldInterfaceQuerierExpiryTime OBJECT-TYPE SYNTAX TimeTicks MAX-ACCESS read-only STATUS current DESCRIPTION "The time remaining before the Other Querier Present Timer expires. If the local system is the querier, the value of this object is zero." ::= { mldInterfaceEntry 13 } -- -- The MLD Cache Table -- mldCacheTable OBJECT-TYPE SYNTAX SEQUENCE OF MldCacheEntry Haberman, Worzella 7 Internet Draft MIB for MLD December 1999 MAX-ACCESS not-accessible STATUS current DESCRIPTION "The (conceptual) table listing the IPv6 multicast groups for which there are members on a particular interface." ::= { mld 2 } mldCacheEntry OBJECT-TYPE SYNTAX MldCacheEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry (conceptual row) in the mldCacheTable." INDEX { mldCacheAddress, mldCacheIfIndex } ::= { mldCacheTable 1 } MldCacheEntry ::= SEQUENCE { mldCacheAddress Ipv6Address, mldCacheIfIndex Ipv6IfIndexOrZero, mldCacheSelf TruthValue, mldCacheLastReporter Ipv6Address, mldCacheUpTime TimeTicks, mldCacheExpiryTime TimeTicks, mldCacheStatus RowStatus } mldCacheAddress OBJECT-TYPE SYNTAX Ipv6Address MAX-ACCESS not-accessible STATUS current DESCRIPTION "The IPv6 multicast group address for which this entry contains information." ::= { mldCacheEntry 1 } mldCacheIfIndex OBJECT-TYPE SYNTAX Ipv6IfIndexOrZero MAX-ACCESS not-accessible STATUS current DESCRIPTION "The interface for which this entry contains information for an IPv6 multicast group address." ::= { mldCacheEntry 2 } mldCacheSelf OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-create STATUS current DESCRIPTION "An indication of whether the local system is a member of this group address on this interface." Haberman, Worzella 8 Internet Draft MIB for MLD December 1999 DEFVAL { true } ::= { mldCacheEntry 3 } mldCacheLastReporter OBJECT-TYPE SYNTAX Ipv6Address MAX-ACCESS read-only STATUS current DESCRIPTION "The IPv6 address of the source of the last membership report received for this IPv6 Multicast group address on this interface. If no membership report has been received, this object has the value 0::0. ::= { mldCacheEntry 4 } mldCacheUpTime OBJECT-TYPE SYNTAX TimeTicks MAX-ACCESS read-only STATUS current DESCRIPTION "The time elapsed since this entry was created." ::= { mldCacheEntry 5 } mldCacheExpiryTime OBJECT-TYPE SYNTAX TimeTicks MAX-ACCESS read-only STATUS current DESCRIPTION "The minimum amount of time remaining before this entry will be aged out. A value of 0 indicates that the entry is only present because mldCacheSelf is true and that if the router left the group, this entry would be aged out immediately. Note that some implementations may process Membership Reports from the local system in the same way as reports from other hosts, so a value of 0 is not required." ::= { mldCacheEntry 6 } mldCacheStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The status of this entry." ::= { mldCacheEntry 7 } -- conformance information mldMIBConformance OBJECT IDENTIFIER ::= { mldMIB 2 } mldMIBCompliances OBJECT IDENTIFIER ::= { mldMIBConformance 1 } Haberman, Worzella 9 Internet Draft MIB for MLD December 1999 MldMIBGroups OBJECT IDENTIFIER ::= { mldMIBConformance 2 } -- compliance statements mldHostMIBCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for hosts running MLD and implementing the MLD MIB." MODULE -- this module MANDATORY-GROUPS { mldBaseMIBGroup, mldHostMIBGroup } OBJECT mldInterfaceStatus MIN-ACCESS read-only DESCRIPTION "Write access is not required." ::= { mldMIBCompliances 1 } mldRouterMIBCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for routers running MLD and implementing the MLD MIB." MODULE -- this module MANDATORY-GROUPS { mldBaseMIBGroup, mldRouterMIBGroup } OBJECT mldInterfaceStatus MIN-ACCESS read-only DESCRIPTION "Write access is not required." ::= { mldMIBCompliances 2 } -- units of conformance mldBaseMIBGroup OBJECT-GROUP OBJECTS { mldCacheSelf, mldCacheStatus, mldInterfaceStatus } STATUS current DESCRIPTION "The basic collection of objects providing management of MLD." ::= { mldMIBGroups 1 } Haberman, Worzella 10 Internet Draft MIB for MLD December 1999 mldRouterMIBGroup OBJECT-GROUP OBJECTS { mldCacheUpTime, mldCacheExpiryTime, mldInterfaceQueryInterval, mldInterfaceJoins, mldInterfaceGroups, mldCacheLastReporter, mldInterfaceQuerierUpTime, mldInterfaceQuerierExpiryTime, mldInterfaceQuerier, mldInterfaceQueryMaxResponseTime, mldInterfaceRobustness, mldInterfaceLastMemQueryIntvl } STATUS current DESCRIPTION "A collection of additional objects for management of MLD in routers." ::= { mldMIBGroups 2 } mldHostMIBGroup OBJECT-GROUP OBJECTS { mldInterfaceQuerier } STATUS current DESCRIPTION "A collection of additional objects for management of MLD in hosts." ::= { mldMIBGroups 3 } END -- -- Copyright (C) The Internet Society (1999). All Rights Reserved. -- -- This document and translations of it may be copied and furnished to -- others, and derivative works that comment on or otherwise explain it -- or assist in its implementation may be prepared, copied, published -- and distributed, in whole or in part, without restriction of any -- kind, provided that the above copyright notice and this paragraph are -- included on all such copies and derivative works. However, this -- document itself may not be modified in any way, such as by removing -- the copyright notice or references to the Internet Society or other -- Internet organizations, except as needed for the purpose of -- developing Internet standards in which case the procedures for -- copyrights defined in the Internet Standards process must be -- followed, or as required to translate it into languages other than -- English. -- -- The limited permissions granted above are perpetual and will not be -- revoked by the Internet Society or its successors or assigns. -- -- This document and the information contained herein is provided on an -- "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING -- TASK FORCE DISCLAIMS 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. -- -- -- -- -- -- -- -- -- -- -- -- -- -- Haberman, Worzella 14