Internet Engineering Task Force R. Cole Internet-Draft Johns Hopkins University Intended status: Standards Track J. Macker Expires: September 1, 2009 B. Adamson Naval Research Laboratory S. Harnedy Booz Allen Hamilton February 28, 2009 Definition of Managed Objects for the Manet Simplified Multicast Framework Relay Set Process draft-cole-manet-smf-mib-02 Status of This Memo This Internet-Draft is submitted to IETF in full conformance with the provisions of BCP 78 and 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 September 1, 2009. Copyright Notice Copyright (c) 2009 IETF Trust and the persons identified as the document authors. All rights reserved. This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (http://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. Cole, et al. Expires September 1, 2009 [Page 1] Internet-Draft The SMF MIB February 2009 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 for configuring aspects of the Simplified Multicast Forwarding (SMF) process. The SMF MIB also reports state information, performance metrics, and notifications. In addition to configuration, this additional state and performance information is useful to management stations troubleshooting multicast forwarding problems. Table of Contents 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3 2. The Internet-Standard Management Framework . . . . . . . . . . 3 3. Conventions . . . . . . . . . . . . . . . . . . . . . . . . . 3 4. Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 4.1. SMF Management Model . . . . . . . . . . . . . . . . . . . 4 4.2. Terms . . . . . . . . . . . . . . . . . . . . . . . . . . 5 5. Structure of the MIB Module . . . . . . . . . . . . . . . . . 6 5.1. Textual Conventions . . . . . . . . . . . . . . . . . . . 6 5.2. The Capabilities Group . . . . . . . . . . . . . . . . . . 6 5.3. The Configuration Group . . . . . . . . . . . . . . . . . 7 5.4. The State Group . . . . . . . . . . . . . . . . . . . . . 7 5.5. The Performance Group . . . . . . . . . . . . . . . . . . 7 5.6. The Reports Group . . . . . . . . . . . . . . . . . . . . 8 5.7. The Notifications Group . . . . . . . . . . . . . . . . . 8 6. Relationship to Other MIB Modules . . . . . . . . . . . . . . 8 6.1. Relationship to the SNMPv2-MIB . . . . . . . . . . . . . . 9 6.2. Relationship to the IF-MIB . . . . . . . . . . . . . . . . 9 6.3. MIB modules required for IMPORTS . . . . . . . . . . . . . 9 7. Definitions . . . . . . . . . . . . . . . . . . . . . . . . . 9 8. Security Considerations . . . . . . . . . . . . . . . . . . . 51 9. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 53 10. Contributors . . . . . . . . . . . . . . . . . . . . . . . . . 54 11. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . 54 12. References . . . . . . . . . . . . . . . . . . . . . . . . . . 54 12.1. Normative References . . . . . . . . . . . . . . . . . . . 54 12.2. Informative References . . . . . . . . . . . . . . . . . . 55 Appendix A. Change Log . . . . . . . . . . . . . . . . . . . . . 55 Appendix B. Open Issues . . . . . . . . . . . . . . . . . . . . . 55 Appendix C. . . . . . . . . . . . . . . . . . . . . . . . . . . 56 Cole, et al. Expires September 1, 2009 [Page 2] Internet-Draft The SMF MIB February 2009 1. Introduction 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 for configuring aspects of a process implementing Simplified Multicast Forwarding (SMF) [I-D.ietf-manet-smf]. SMF provides multicast duplicate packet detection (DPD) and supports algorithms for constructing an estimate of a mobile ad hoc network (MANET) Minimum Connected Dominating Set (MCDS) for efficient multicast forwarding. The SMF MIB also reports state information, performance metrics, and notifications. In addition to configuration, this additional state and performance information is useful to management stations troubleshooting multicast forwarding problems. 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 RFC 3410 [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, RFC 2578 [RFC2578], STD 58, RFC 2579 [RFC2579] and STD 58, RFC 2580 [RFC2580]. 3. Conventions 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 RFC 2119 [RFC2119]. 4. Overview SMF provides methods for implementing DPD-based multicast forwarding with the optional use of CDS-based relay sets. The MCDS is the smallest set of MANET nodes (comprising a connected cluster) which cover all the nodes in the cluster with their transmissions. As the density of the MANET nodes increase, the fraction of nodes required in an MCDS decreases. Using the MCDS as a multicast forwarding set then becomes an efficient multicast mechanism for MANETs. Various algorithms for the construction of estimates of the MCDS exist. The Simplified Multicast Framework [I-D.ietf-manet-smf] Cole, et al. Expires September 1, 2009 [Page 3] Internet-Draft The SMF MIB February 2009 describes some of these. It further defines various operational modes for a node which is participating in the collective creation of the MCDS estimates. These modes depend upon the set of related MANET routing and discovery protocols and mechanisms in operation in the specific MANET node. A SMF routers' MIB contains SMF process configuration parameters (e.g. specific CDS algorithm), state information (e.g., current membership in the CDS), performance counters (e.g., packet counters), and notifications. 4.1. SMF Management Model This section describes the management model for the SMF node process. Figure 1 (reproduced from Figure 4 of [I-D.ietf-manet-smf]) shows the relationship between the SMF Relay Set selection algorithm and the related algorithms, processes and protocols running in the MANET nodes. The Relay Set Selection Algorithm (RSSA) can rely upon topology information gotten from the MANET Neighborhood Discovery Protocol (NHDP), from the specific MANET routing protocol running on the node, or from Layer 2 information passed up to the higher layer protocol processes. Cole, et al. Expires September 1, 2009 [Page 4] Internet-Draft The SMF MIB February 2009 Possible L2 Trigger/Information | | ______________ ______|_____ __________________ | MANET | | | | | | Neighborhood | | Relay Set | | Other Heuristics | | Discovery |------------| Selection |-------| (Preference,etc) | | Protocol | neighbor | Algorithm | | | |______________| info |____________| |__________________| \ / \ / neighbor\ / Dynamic Relay info* \ ____________ / Set Status \ | SMF | / (State, {neighbor info}) `---| Relay Set |---' | State | ---|____________| / / ______________ | Coexistent | | MANET | | Unicast | | Process | |______________| Figure 1: SMF Relay Set Control Options 4.2. Terms The following definitions apply throughout this document: o Configuration Objects - switches, tables, objects which are initialized to default settings or set through the management interface defined by this MIB. o Tunable Configuration Objects - objects whose values affect timing or attempt bounds on the SMF RS process. o State Objects - automatically generated values which define the current operating state of the SMF RS process in the router. o Performance Objects - automatically generated values which help an administrator or automated tool to assess the performance of the CDS multicast process on the router and the overall multicasting performance within the MANET routing domain. Cole, et al. Expires September 1, 2009 [Page 5] Internet-Draft The SMF MIB February 2009 5. Structure of the MIB Module This section presents the structure of the SMF MIB module. The objects are arranged into the following groups: o smfMIBNotifications - defines the notifications associated with the SMF MIB. o smfMIBObjects - defines the objects forming the basis for the SMF MIB. These objects are divided up by function into the following groups: o * Capabilities Group - This group contains the SMF objects that the device uses to advertise its local capabilities with respect to, e.g., the supported RSSAs. * Configuration Group - This group contains the SMF objects that configure specific options that determine the overall operation of the SMF RSSA and the resulting multicast performance. * State Group - Contains information describing the current state of the SMF RSSA process such as the Neighbor Table. * Performance Group - Contains objects which help to characterize the performance of the SMF RSSA process, typically statistics counters. * Reports Group - Contains objects which allow the device to develop and locally store performance related reports. The management application can then pull these locally stored reports when it wishes. o smfMIBConformance - defines minimal and full conformance of implementations to this SMF MIB. 5.1. Textual Conventions The textual conventions used in the SMF MIB are as follows. The RowStatus textual convention is imported from RFC 2579 [RFC2579]. 5.2. The Capabilities Group The SMF device supports a set of capabilities. The list of capabilities which the device can advertise are: Cole, et al. Expires September 1, 2009 [Page 6] Internet-Draft The SMF MIB February 2009 o Operational Mode - topology information from NHDP, CDS-aware unicast routing or Cross-layer from Layer 2 o SMF RSSA - the specific RSSA operational on the device 5.3. The Configuration Group The SMF device is configured with a set of controls. The list of configuration controls for the SMF device follow. o Operational Mode - topology information from NHDP, CDS-aware unicast routing or Cross-layer from Layer 2 o SMF RSSA - the specific RSSA operational on the device o Duplicate Packet detection for IPv4 - Identification-based or Hash-based DPD o Duplicate Packet detection for IPv6 - Identification-based or Hash-based DPD o NHDP RSSA Message TLV - if NHDP mode is selected, then is the RSSA Message TLV included in the NHDP exchanges. (Question: Is this and the following two TLVs optional and are they included as a group or independently of one another?) o NHDP RSSA Address Block TLV - if NHDP mode is selected, then is the RSSA Address Block TLV included in the NHDP exchanges. o Router Priority TLV - if NHDP mode is selected, then is the Router Priority TLV included in the NHDP exchanges. 5.4. The State Group The State Subtree reports current state information. o Node RSS State - is the node currently in or out of the Relay Set. o Neighbors Table - a table containing current neighbors and their operational RSSA. 5.5. The Performance Group The Performance subtree reports primarily counters that relate to SMF RSSA performance. The SMF performance counters consists of per node and per interface objects: (Note: Need to have a discussion of the important and measurable events related to SMF RSSA multicast performance.) (Note: Do we need to break these out by type, i.e., v4 Cole, et al. Expires September 1, 2009 [Page 7] Internet-Draft The SMF MIB February 2009 versus v6?) o Total multicast packets received - o Total multicast packets forwarded - o Total duplicate multicast packets detected - o Per interface statistics table with the following entries: o * Multicast packets received * Multicast packets forwarded * Duplicate multicast packets detected 5.6. The Reports Group The SMF device supports a a capability to generate and store locally a set of performance reports. The objects to control the generation of these reports and to identify the information contained within these reports are contained within this group. These objects include: o Report Control Objects - which specify the storage requirements, the time and duration and the authorship of the reports. o Report Objects - which identify the information, i.e., metrics, contained within these reports. Currently, these objects represent a sub-set of the objects found within the Performance Group discussed above. 5.7. The Notifications Group The Notifications Subtree contains the list of notifications supported within the SMF-MIB and their intended purpose or utility. This group is currently empty. 6. Relationship to Other MIB Modules [TODO]: The text of this section specifies the relationship of the MIB modules contained in this document to other standards, particularly to standards containing other MIB modules. Definitions imported from other MIB modules and other MIB modules that SHOULD be implemented in conjunction with the MIB module contained within this document are identified in this section. Cole, et al. Expires September 1, 2009 [Page 8] Internet-Draft The SMF MIB February 2009 6.1. Relationship to the SNMPv2-MIB The 'system' group in the SNMPv2-MIB [RFC3418] is defined as being mandatory for all systems, and the objects apply to the entity as a whole. The 'system' group provides identification of the management entity and certain other system-wide data. The SMF-MIB does not duplicate those objects. 6.2. Relationship to the IF-MIB [TODO] This section is included as an example; If the MIB module is not an adjunct of the Interface MIB, then this section should be removed. 6.3. MIB modules required for IMPORTS [TODO]: Citations are not permitted within a MIB module, but any module mentioned in an IMPORTS clause or document mentioned in a REFERENCE clause is a Normative reference, and must be cited someplace within the narrative sections. If there are imported items in the MIB module, such as Textual Conventions, that are not already cited, they can be cited in text here. Since relationships to other MIB modules should be described in the narrative text, this section is typically used to cite modules from which Textual Conventions are imported. The following SMF-MIB module IMPORTS objects from SNMPv2-SMI [RFC2578], SNMPv2-TC [RFC2579], SNMPv2-CONF [RFC2580], and IF-MIB [RFC2863] 7. Definitions MANET-SMF-MIB DEFINITIONS ::= BEGIN IMPORTS ZeroBasedCounter32 FROM RMON2-MIB -- [RFC2021] MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE, Counter32, Unsigned32, Integer32, mib-2 FROM SNMPv2-SMI -- [RFC2578] TEXTUAL-CONVENTION, RowStatus, TruthValue, TimeStamp, StorageType FROM SNMPv2-TC -- [RFC2579] Cole, et al. Expires September 1, 2009 [Page 9] Internet-Draft The SMF MIB February 2009 MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP FROM SNMPv2-CONF -- [RFC2580] OwnerString FROM RMON-MIB -- [RFC2819] InterfaceIndexOrZero FROM IF-MIB -- [RFC2863] SnmpAdminString FROM SNMP-FRAMEWORK-MIB -- [RFC3411] InetAddress, InetAddressType, InetAddressPrefixLength FROM INET-ADDRESS-MIB -- [RFC4001] ; manetSmfMIB MODULE-IDENTITY LAST-UPDATED "200902271300Z" -- February 27, 2009 ORGANIZATION "IETF MANET Working Group" CONTACT-INFO "WG E-Mail: manet@ietf.org WG Chairs: ian.chakeres@gmail.com jmacker@nrl.navy.mil Editors: Robert G. Cole Johns Hopkins University Applied Physics Lab and Department of Computer Science 11000 Johns Hopkins Road Room 02-257 Laurel, MD 22014 USA +1 443 778-6951 robert.cole@jhuapl.edu Joseph Macker Naval Research Laboratory Washington, D.C. 20375 USA macker@itd.nrl.navy.mil Brian Adamson Naval Research Laboratory Washington, D.C. 20375 Cole, et al. Expires September 1, 2009 [Page 10] Internet-Draft The SMF MIB February 2009 USA adamson@itd.nrl.navy.mil Sean Harnedy Booz Allen Hamilton 333 City Boulevard West Orange, CA 92868 USA +1 714 938-3898 harnedy_sean@bah.com" DESCRIPTION "This MIB module contains managed object definitions for the Manet SMF RSSA process defined in: Macker, J.(ed.), Simplified Multicast Forwarding draft-ietf-manet-smf-08, November 03, 2008. Copyright (C) The IETF Trust (2008). This version of this MIB module is part of RFC xxxx; see the RFC itself for full legal notices." -- Revision History REVISION "200902271300Z" -- February 27, 2009 DESCRIPTION "Updated draft of this MIB module published as draft-cole-manet-smf-mib-02.txt. Fairly extensive revisions and additions to this MIB were made in this version. Specifically, the following changes were made in development of this version: - added a Capabilities Group within the Objects Group to allow the device to report supported capabilities, e.g., RSSAs supported. - added administrative status objects for device and interfaces - added multicast address forwarding tables, both for configured (within Configuration Group) and discovered (within the State Group). - added additional Performance counters related to DPD functions. - Split up the performance counters into IPv4 and IPv6, for both global and per interface statistics. - Split out the reports capability into a seperate Reports Group under the Objects Group. " REVISION "200811031300Z" -- November 03, 2008 DESCRIPTION "Updated draft of this MIB module published as Cole, et al. Expires September 1, 2009 [Page 11] Internet-Draft The SMF MIB February 2009 draft-cole-manet-smf-mib-01.txt. Added gateway filter table and reports capabilities following rmon." REVISION "200807071200Z" -- July 07, 2008 DESCRIPTION "Initial draft of this MIB module published as draft-cole-manet-smf-mib-00.txt." -- RFC-Editor assigns XXXX ::= { mib-2 998 } -- to be assigned by IANA -- -- TEXTUAL CONVENTIONs -- Status ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "An indication of the operability of a DYMO function or feature. For example, the status of an interface: 'enabled' indicates that it is willing to communicate with other DYMO routers, and 'disabled' indicates that it is not." SYNTAX INTEGER { enabled (1), disabled (2) } SmfOpModeID ::= TEXTUAL-CONVENTION DISPLAY-HINT "d" STATUS current DESCRIPTION "An index that identifies through reference to a specific SMF operations mode ... " SYNTAX Unsigned32 (1..2147483647) SmfRssaID ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "An index that identifies through reference to a specific RSSA algorithms ... " SYNTAX INTEGER { cF(1), sMPR(2), eCDS(3), mprCDS(4) Cole, et al. Expires September 1, 2009 [Page 12] Internet-Draft The SMF MIB February 2009 -- future(5-127) -- noStdAction(128-239) -- experimental(240-255) } -- -- Top-Level Object Identifier Assignments -- smfMIBNotifications OBJECT IDENTIFIER ::= { manetSmfMIB 0 } smfMIBObjects OBJECT IDENTIFIER ::= { manetSmfMIB 1 } smfMIBConformance OBJECT IDENTIFIER ::= { manetSmfMIB 2 } -- -- smfMIBObjects Assignments: -- smfCapabilitiesGroup - 1 -- smfConfigurationGroup - 2 -- smfStateGroup - 3 -- smfPerformanceGroup - 4 -- smfReportsGroup - 5 -- -- -- smfCapabilitiesGroup -- -- This group contains the SMF objects that identify specific -- capabilities within this device related to SMF functions. -- smfCapabilitiesGroup OBJECT IDENTIFIER ::= { smfMIBObjects 1 } -- -- SMF Operational Mode Capabilities Table -- smfOpModeCapabilitiesTable OBJECT-TYPE SYNTAX SEQUENCE OF SmfOpModeCapabilitiesEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The smfOpModeCapabilitiesTable contains ... " ::= { smfCapabilitiesGroup 1 } Cole, et al. Expires September 1, 2009 [Page 13] Internet-Draft The SMF MIB February 2009 smfOpModeCapabilitiesEntry OBJECT-TYPE SYNTAX SmfOpModeCapabilitiesEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Information about a particular operational mode. " INDEX { smfOpModeCapabilitiesID } ::= { smfOpModeCapabilitiesTable 1 } SmfOpModeCapabilitiesEntry ::= SEQUENCE { smfOpModeCapabilitiesID SmfOpModeID, smfOpModeCapabilitiesName SnmpAdminString, smfOpModeCapabilitiesReference SnmpAdminString } smfOpModeCapabilitiesID OBJECT-TYPE SYNTAX SmfOpModeID MAX-ACCESS not-accessible STATUS current DESCRIPTION "The index for this entry. This object identifies the particular operational mode for this device. " ::= { smfOpModeCapabilitiesEntry 1 } smfOpModeCapabilitiesName OBJECT-TYPE SYNTAX SnmpAdminString MAX-ACCESS read-only STATUS current DESCRIPTION "The textual name of this operational mode. " ::= { smfOpModeCapabilitiesEntry 2 } smfOpModeCapabilitiesReference OBJECT-TYPE SYNTAX SnmpAdminString MAX-ACCESS read-only STATUS current DESCRIPTION "This object contains a reference to the document that defines this operational mode. " ::= { smfOpModeCapabilitiesEntry 3 } Cole, et al. Expires September 1, 2009 [Page 14] Internet-Draft The SMF MIB February 2009 -- -- SMF RSSA Capabilities Table -- smfRssaCapabilitiesTable OBJECT-TYPE SYNTAX SEQUENCE OF SmfRssaCapabilitiesEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The smfRssaCapabilitiesTable contains ... " ::= { smfCapabilitiesGroup 2 } smfRssaCapabilitiesEntry OBJECT-TYPE SYNTAX SmfRssaCapabilitiesEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Information about a particular algorithm." INDEX { smfRssaCapabilitiesID } ::= { smfRssaCapabilitiesTable 1 } SmfRssaCapabilitiesEntry ::= SEQUENCE { smfRssaCapabilitiesID SmfRssaID, smfRssaCapabilitiesName SnmpAdminString, smfRssaCapabilitiesReference SnmpAdminString } smfRssaCapabilitiesID OBJECT-TYPE SYNTAX SmfRssaID MAX-ACCESS not-accessible STATUS current DESCRIPTION "The index for this entry. This object identifies the particular algorithm in this MIB module." ::= { smfRssaCapabilitiesEntry 1 } smfRssaCapabilitiesName OBJECT-TYPE SYNTAX SnmpAdminString MAX-ACCESS read-only STATUS current DESCRIPTION "The textual name of this algorithm. " ::= { smfRssaCapabilitiesEntry 2 } smfRssaCapabilitiesReference OBJECT-TYPE SYNTAX SnmpAdminString Cole, et al. Expires September 1, 2009 [Page 15] Internet-Draft The SMF MIB February 2009 MAX-ACCESS read-only STATUS current DESCRIPTION "This object contains a reference to the document that defines this algorithm. " ::= { smfRssaCapabilitiesEntry 3 } -- -- smfConfigurationGroup -- -- This group contains the SMF objects that configure specific -- options that determine the overall performance and operation -- of the multicast forwarding process for the router device -- and its interfaces. -- smfConfigurationGroup OBJECT IDENTIFIER ::= { smfMIBObjects 2 } smfAdminStatus OBJECT-TYPE SYNTAX Status MAX-ACCESS read-write STATUS current DESCRIPTION "The configured status of the SMF process on this device. Enabled(1) means that SMF is configured to run on this device. Disabled(2) mean that the SMF process is configured off." ::= { smfConfigurationGroup 1 } smfConfiguredOpMode OBJECT-TYPE SYNTAX INTEGER { withNHDP(1), cdsAwareRouting(2), crossLayer(3), other(4) } MAX-ACCESS read-write STATUS current DESCRIPTION "The SMF RSS node operational mode. Cole, et al. Expires September 1, 2009 [Page 16] Internet-Draft The SMF MIB February 2009 The value withNHDP(1) indicates ... The value cdsAwareRouting(2) indicates ... The value crossLayer(3) indicates... ." ::= { smfConfigurationGroup 2 } smfConfiguredRssa OBJECT-TYPE SYNTAX SmfRssaID MAX-ACCESS read-write STATUS current DESCRIPTION "The SMF RSS currently operational algorithm. The value cf(1) indicates ... The value experimental(240-255) indicates... ." ::= { smfConfigurationGroup 3 } smfRssaMember OBJECT-TYPE SYNTAX INTEGER { potential(1), always(2), never(3) } MAX-ACCESS read-write STATUS current DESCRIPTION "The RSSA downselects a set of forwarders for multicast forwarding. Sometimes it is useful to force an agent to be included or excluded from the resulting RSS. This object is a switch to allow for this behavior. The value potential(1) allows the selected RSSA to determine if this agent is included or excluded from the RSS. The value always(1) forces the selected RSSA include this agent in the RSS. The value never(3) forces the selected RSSA to exclude this agent from the RSS." ::= { smfConfigurationGroup 4 } smfIpv4Dpd OBJECT-TYPE SYNTAX INTEGER { identificationBased(1), hashBased(2) Cole, et al. Expires September 1, 2009 [Page 17] Internet-Draft The SMF MIB February 2009 } MAX-ACCESS read-write STATUS current DESCRIPTION "The current method for IPv4 duplicate packet detection. The value identificationBased(1) indicates... The value 'hashBased(2) indicates... ." ::= { smfConfigurationGroup 5 } smfIpv6Dpd OBJECT-TYPE SYNTAX INTEGER { identificationBased(1), hashBased(2) } MAX-ACCESS read-write STATUS current DESCRIPTION "The current method for IPv6 duplicate packet detection. The value identificationBased(1) indicates... The value 'hashBased(2) indicates... ." ::= { smfConfigurationGroup 6 } smfMaxPktLifetime OBJECT-TYPE SYNTAX Integer32 (0..65535) UNITS "Seconds" MAX-ACCESS read-write STATUS current DESCRIPTION "The estimate of the network packet traversal time. " DEFVAL { 60 } ::= { smfConfigurationGroup 7 } smfDpdMaxMemorySize OBJECT-TYPE SYNTAX Integer32 (0..65535) UNITS "Kilo-Bytes" MAX-ACCESS read-write STATUS current DESCRIPTION "The locally reserved memory for storage of cached DPD records for both IPv4 and Cole, et al. Expires September 1, 2009 [Page 18] Internet-Draft The SMF MIB February 2009 IPv6 methods. " DEFVAL { 1024 } ::= { smfConfigurationGroup 8 } smfDpdEntryMaxLifetime OBJECT-TYPE SYNTAX Integer32 (0..65525) UNITS "Seconds" MAX-ACCESS read-write STATUS current DESCRIPTION "The maximum lifetime of a cached DPD record in the local device storage. " DEFVAL { 600 } ::= { smfConfigurationGroup 9 } -- -- Configuration of messages to be included in -- NHDP message exchanges in support of SMF -- operations. -- smfNhdpRssaMesgTLVIncluded OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-write STATUS current DESCRIPTION "Indicates whether the associated NHDP messages include the RSSA Message TLV, or not. This is an optional SMF operational setting. The value true(1) indicates that this TLV is included; the value false(2) indicates that it is not included." ::= { smfConfigurationGroup 10 } smfNhdpRssaAddrBlockTLVIncluded OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-write STATUS current DESCRIPTION "Indicates whether the associated NHDP messages include the RSSA Address Block TLV, or not. This is an optional SMF operational setting. The value true(1) indicates that this TLV is included; the value false(2) indicates that it is not included." Cole, et al. Expires September 1, 2009 [Page 19] Internet-Draft The SMF MIB February 2009 ::= { smfConfigurationGroup 11 } smfNhdpRouterPriorityTLVIncluded OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-write STATUS current DESCRIPTION "Indicates whether the associated NHDP messages include the RSSA Router Priority TLV, or not. This is an optional SMF operational setting. The value true(1) indicates that this TLV is included; the value false(2) indicates that it is not included." ::= { smfConfigurationGroup 12 } -- -- Table identifying configured multicast addresses to be forwarded. -- smfConfiguredAddrForwardingTable OBJECT-TYPE SYNTAX SEQUENCE OF SmfConfiguredAddrForwardingEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The (conceptual) table containing information on multicast addresses which are to be forwarded by the SMF process. Entries in this table are configured. As well, addresses to be forwarded by the SMF device can be dynamically discovered by other means. The corresponding state table, smfDiscoveredAddrForwardingTable contains these additional, dynamically discovered address for forwarding. Each row is associated with a range of multicast addresses, and ranges for different rows must be disjoint. " ::= { smfConfigurationGroup 13 } smfConfiguredAddrForwardingEntry OBJECT-TYPE SYNTAX SmfConfiguredAddrForwardingEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry (conceptual row) containing the information on a particular multicast scope." INDEX { smfConfiguredAddrForwardingAddrType, Cole, et al. Expires September 1, 2009 [Page 20] Internet-Draft The SMF MIB February 2009 smfConfiguredAddrForwardingFirstAddr } ::= { smfConfiguredAddrForwardingTable 1 } SmfConfiguredAddrForwardingEntry ::= SEQUENCE { smfConfiguredAddrForwardingAddrType InetAddressType, smfConfiguredAddrForwardingFirstAddr InetAddress, smfConfiguredAddrForwardingLastAddr InetAddress, smfConfiguredAddrForwardingStatus RowStatus } smfConfiguredAddrForwardingAddrType OBJECT-TYPE SYNTAX InetAddressType MAX-ACCESS not-accessible STATUS current DESCRIPTION "The type of the addresses in the multicast forwarding range. Legal values correspond to the subset of address families for which multicast address allocation is supported." ::= { smfConfiguredAddrForwardingEntry 1 } smfConfiguredAddrForwardingFirstAddr OBJECT-TYPE SYNTAX InetAddress (SIZE(0..20)) MAX-ACCESS not-accessible STATUS current DESCRIPTION "The first address in the multicast scope range. The type of this address is determined by the value of the smfConfiguredAddrForwardingAddrType object." ::= { smfConfiguredAddrForwardingEntry 2 } smfConfiguredAddrForwardingLastAddr OBJECT-TYPE SYNTAX InetAddress (SIZE(0..20)) MAX-ACCESS read-create STATUS current DESCRIPTION "The last address in the multicast scope range. The type of this address is determined by the value of the smfConfiguredAddrForwardingAddrType object." ::= { smfConfiguredAddrForwardingEntry 3 } smfConfiguredAddrForwardingStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The status of this row, by which new entries may be Cole, et al. Expires September 1, 2009 [Page 21] Internet-Draft The SMF MIB February 2009 created, or old entries deleted from this table. If write access is supported, the other writable objects in this table may be modified even while the status is `active'." ::= { smfConfiguredAddrForwardingEntry 4 } -- -- SMF Interfaces Configuration Table -- smfInterfaceTable OBJECT-TYPE SYNTAX SEQUENCE OF SmfInterfaceEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The SMF Interface Table describes the SMF interfaces that are participating in the SMF packet forwarding process. The ifIndex is from the interfaces group defined in the Interfaces Group MIB. " REFERENCE "RFC 2863 - The Interfaces Group MIB, McCloghrie, K., and F. Kastenholtz, June 2000." ::= { smfConfigurationGroup 14 } smfInterfaceEntry OBJECT-TYPE SYNTAX SmfInterfaceEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The SMF interface entry describes one SMF interface as indexed by its ifIndex." INDEX { smfIfIndex } ::= { smfInterfaceTable 1 } SmfInterfaceEntry ::= SEQUENCE { smfIfIndex InterfaceIndexOrZero, smfIfAdminStatus Status, smfIfRowStatus RowStatus } smfIfIndex OBJECT-TYPE SYNTAX InterfaceIndexOrZero MAX-ACCESS not-accessible STATUS current Cole, et al. Expires September 1, 2009 [Page 22] Internet-Draft The SMF MIB February 2009 DESCRIPTION "The ifIndex for this SMF interface." ::= { smfInterfaceEntry 1 } smfIfAdminStatus OBJECT-TYPE SYNTAX Status MAX-ACCESS read-create STATUS current DESCRIPTION "The SMF interface's administrative status. The value 'enabled' denotes that the interface is running the SMF forwarding process. The value 'disabled' denotes that the interface is external to the SMF forwarding process. " ::= { smfInterfaceEntry 2 } smfIfRowStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "This object permits management of the table by facilitating actions such as row creation, construction, and destruction. The value of this object has no effect on whether other objects in this conceptual row can be modified." ::= { smfInterfaceEntry 3 } -- -- SMF Gateway Filter Table -- (Note: Not sure at this point what to do with this -- table. Most likely want to move to a seperate MIB.) -- smfGatewayFilterTable OBJECT-TYPE SYNTAX SEQUENCE OF SmfGatewayFilterEntry MAX-ACCESS not-accessible STATUS obsolete DESCRIPTION "The SMF Gateway can be configured to filter multicast packets into and outof the SMF MANET domain. This table defines the filter rules which define packet matching and related actions. The rules are in order ..." Cole, et al. Expires September 1, 2009 [Page 23] Internet-Draft The SMF MIB February 2009 REFERENCE "The SMF draft." ::= { smfConfigurationGroup 15 } smfGatewayFilterEntry OBJECT-TYPE SYNTAX SmfGatewayFilterEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A single entry in the smfGatewayFilterTable." REFERENCE "The SMF draft." INDEX { smfGatewayFilterIndex } ::= { smfGatewayFilterTable 1 } SmfGatewayFilterEntry ::= SEQUENCE { smfGatewayFilterIndex InterfaceIndexOrZero, smfGatewayFilterIf InterfaceIndexOrZero, smfGatewayFilterIfDirection INTEGER, smfGatewayFilterRuleRank Integer32, smfGatewayFilterDestAddrType InetAddressType, smfGatewayFilterDestAddr InetAddress, smfGatewayFilterDestAddrPrefixLen InetAddressPrefixLength, smfGatewayFilterSrcAddrType InetAddressType, smfGatewayFilterSrcAddr InetAddress, smfGatewayFilterSrcAddrPrefixLen InetAddressPrefixLength, smfGatewayFilterProtocolNumber Integer32, smfGatewayFilterDestPortNumber Integer32, smfGatewayFilterAction INTEGER, smfGatewayFilterRowStatus RowStatus } smfGatewayFilterIndex OBJECT-TYPE SYNTAX InterfaceIndexOrZero MAX-ACCESS not-accessible STATUS current DESCRIPTION "The Index for this filter rule. " ::= { smfGatewayFilterEntry 1 } smfGatewayFilterIf OBJECT-TYPE SYNTAX InterfaceIndexOrZero MAX-ACCESS read-create STATUS current DESCRIPTION "The ifIndex for this node interface Cole, et al. Expires September 1, 2009 [Page 24] Internet-Draft The SMF MIB February 2009 that is filtering this rule." ::= { smfGatewayFilterEntry 2 } smfGatewayFilterIfDirection OBJECT-TYPE SYNTAX INTEGER { in(1), out(2) } MAX-ACCESS read-create STATUS current DESCRIPTION "The ifIndex direction for this interface filtering rule." ::= { smfGatewayFilterEntry 3 } smfGatewayFilterRuleRank OBJECT-TYPE SYNTAX Integer32 (1..65535) MAX-ACCESS read-create STATUS current DESCRIPTION "The rank of the rule specified in this entry. This rank is specified by the management application. The rules applied on this device are rank ordered by this rank, from smallest (applied first) to largest (applied last). The rule ranks do not have to be contiguous, but they must be unique. When a management application changes this rank and the new rank is identical to the rank of another entry, then that entry's rank and all other entries with a rank greater than this rank must be incremented by one. " REFERENCE "The SMF draft." ::= { smfGatewayFilterEntry 4 } smfGatewayFilterDestAddrType OBJECT-TYPE SYNTAX InetAddressType MAX-ACCESS read-create STATUS current DESCRIPTION "The type of the DestAddr, as defined in the InetAddress MIB [RFC 4001]." REFERENCE "The SMF draft." ::= { smfGatewayFilterEntry 5 } Cole, et al. Expires September 1, 2009 [Page 25] Internet-Draft The SMF MIB February 2009 smfGatewayFilterDestAddr OBJECT-TYPE SYNTAX InetAddress MAX-ACCESS read-create STATUS current DESCRIPTION "The destination IP address of this rule. The type of this address is determined by the value of the smfGatewayFilterDestAddrType object." REFERENCE "The SMF draft." ::= { smfGatewayFilterEntry 6 } smfGatewayFilterDestAddrPrefixLen OBJECT-TYPE SYNTAX InetAddressPrefixLength MAX-ACCESS read-create STATUS current DESCRIPTION "Indicates the number of leading one bits that form the mask to be logical-ANDed with the destination address before being compared to the value in the smfGatewayFilterDestAddr field." REFERENCE "The SMF draft." ::= { smfGatewayFilterEntry 7 } smfGatewayFilterSrcAddrType OBJECT-TYPE SYNTAX InetAddressType MAX-ACCESS read-create STATUS current DESCRIPTION "The type of the SrcAddr, as defined in the InetAddress MIB [RFC 4001]." REFERENCE "The SMF draft." ::= { smfGatewayFilterEntry 8 } smfGatewayFilterSrcAddr OBJECT-TYPE SYNTAX InetAddress MAX-ACCESS read-create STATUS current DESCRIPTION "The source IP address of this rule. The type of this address is determined by the value of the smfGatewayFilterSrcAddrType object." REFERENCE "The SMF draft." ::= { smfGatewayFilterEntry 9 } Cole, et al. Expires September 1, 2009 [Page 26] Internet-Draft The SMF MIB February 2009 smfGatewayFilterSrcAddrPrefixLen OBJECT-TYPE SYNTAX InetAddressPrefixLength MAX-ACCESS read-create STATUS current DESCRIPTION "Indicates the number of leading one bits that form the mask to be logical-ANDed with the destination address before being compared to the value in the smfGatewayFilterSrcAddr field." REFERENCE "The SMF draft." ::= { smfGatewayFilterEntry 10 } -- Note: check out the necessary range for protocol -- and port numbers. smfGatewayFilterProtocolNumber OBJECT-TYPE SYNTAX Integer32(0..65535) MAX-ACCESS read-create STATUS current DESCRIPTION "The Protocol Number defined in RFC 5237." ::= { smfGatewayFilterEntry 11 } smfGatewayFilterDestPortNumber OBJECT-TYPE SYNTAX Integer32(0..65535) MAX-ACCESS read-create STATUS current DESCRIPTION "The destination Port Number defined in RFC XXXX." ::= { smfGatewayFilterEntry 12 } smfGatewayFilterAction OBJECT-TYPE SYNTAX INTEGER { drop(1), pass(2), other(3) } MAX-ACCESS read-create STATUS current DESCRIPTION "The action to be taken if the rule is matched." ::= { smfGatewayFilterEntry 13 } smfGatewayFilterRowStatus OBJECT-TYPE SYNTAX RowStatus Cole, et al. Expires September 1, 2009 [Page 27] Internet-Draft The SMF MIB February 2009 MAX-ACCESS read-create STATUS current DESCRIPTION "This object permits management of the table by facilitating actions such as row creation, construction, and destruction. The value of this object has no effect on whether other objects in this conceptual row can be modified." ::= { smfGatewayFilterEntry 14 } -- -- smfStateGroup -- -- Contains information describing the current state of the SMF -- process such as the current inclusion in the RS or not. -- smfStateGroup OBJECT IDENTIFIER ::= { smfMIBObjects 3 } smfNodeRsStatusIncluded OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-only STATUS current DESCRIPTION "The current status of the SMF node in the context of the MANETs relay set. A value of true(1) indicates that the node is currently part of the MANET Relay Set. A value of false(2) indicates that the node is currently not part of the MANET Relay Set." ::= { smfStateGroup 1 } smfDpdMemoryOverflow OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times that the memory for caching records for DPD overran and records had to be flushed. The number of records to be flushed upon a buffer overflow is an implementation specific decision. " ::= { smfStateGroup 2 } Cole, et al. Expires September 1, 2009 [Page 28] Internet-Draft The SMF MIB February 2009 -- -- Dynamically Discovered Multicast Addr Table -- smfDiscoveredAddrForwardingTable OBJECT-TYPE SYNTAX SEQUENCE OF SmfDiscoveredAddrForwardingEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The (conceptual) table containing information on multicast addresses which are to be forwarded by the SMF process. Entries in this table are configured. As well, addresses to be forwarded by the SMF device can be dynamically discovered by other means. The corresponding state table, smfDiscoveredAddrForwardingTable contains these additional, dynamically discovered address for forwarding. Each row is associated with a range of multicast addresses, and ranges for different rows must be disjoint. " ::= { smfStateGroup 3 } smfDiscoveredAddrForwardingEntry OBJECT-TYPE SYNTAX SmfDiscoveredAddrForwardingEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry (conceptual row) containing the information on a particular multicast scope." INDEX { smfDiscoveredAddrForwardingAddrType, smfDiscoveredAddrForwardingFirstAddr } ::= { smfDiscoveredAddrForwardingTable 1 } SmfDiscoveredAddrForwardingEntry ::= SEQUENCE { smfDiscoveredAddrForwardingAddrType InetAddressType, smfDiscoveredAddrForwardingFirstAddr InetAddress, smfDiscoveredAddrForwardingLastAddr InetAddress, smfDiscoveredAddrForwardingStatus RowStatus } smfDiscoveredAddrForwardingAddrType OBJECT-TYPE SYNTAX InetAddressType MAX-ACCESS not-accessible STATUS current DESCRIPTION "The type of the addresses in the multicast forwarding Cole, et al. Expires September 1, 2009 [Page 29] Internet-Draft The SMF MIB February 2009 range. Legal values correspond to the subset of address families for which multicast address allocation is supported." ::= { smfDiscoveredAddrForwardingEntry 1 } smfDiscoveredAddrForwardingFirstAddr OBJECT-TYPE SYNTAX InetAddress (SIZE(0..20)) MAX-ACCESS not-accessible STATUS current DESCRIPTION "The first address in the multicast scope range. The type of this address is determined by the value of the smfConfiguredAddrForwardingAddrType object." ::= { smfDiscoveredAddrForwardingEntry 2 } smfDiscoveredAddrForwardingLastAddr OBJECT-TYPE SYNTAX InetAddress (SIZE(0..20)) MAX-ACCESS read-create STATUS current DESCRIPTION "The last address in the multicast scope range. The type of this address is determined by the value of the smfConfiguredAddrForwardingAddrType object." ::= { smfDiscoveredAddrForwardingEntry 3 } smfDiscoveredAddrForwardingStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The status of this row, by which new entries may be created, or old entries deleted from this table. If write access is supported, the other writable objects in this table may be modified even while the status is `active'." ::= { smfDiscoveredAddrForwardingEntry 4 } -- -- SMF Neighbor Table -- smfNeighborTable OBJECT-TYPE SYNTAX SEQUENCE OF SmfNeighborEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION Cole, et al. Expires September 1, 2009 [Page 30] Internet-Draft The SMF MIB February 2009 "The SMF NeighborTable describes the current neighbor nodes, their address and SMF RSSA and the interface on which they can be reached." REFERENCE "Simplified Multicast Forwarding for MANET (SMF), Macker, J., February 2008. Section 7: SMF Neighborhood Discovery Requirements." ::= { smfStateGroup 4 } smfNeighborEntry OBJECT-TYPE SYNTAX SmfNeighborEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The SMF Neighbor Table contains the set of one-hop neighbors, the interface they are reachable on and the SMF RSSA they are currently running." INDEX { smfNeighborIpAddrType, smfNeighborIpAddr, smfNeighborPrefixLen } ::= { smfNeighborTable 1 } SmfNeighborEntry ::= SEQUENCE { smfNeighborIpAddrType InetAddressType, smfNeighborIpAddr InetAddress, smfNeighborPrefixLen InetAddressPrefixLength, smfNeighborRSSA SmfRssaID, smfNeighborNextHopInterface InterfaceIndexOrZero } smfNeighborIpAddrType OBJECT-TYPE SYNTAX InetAddressType MAX-ACCESS not-accessible STATUS current DESCRIPTION "The neighbor IP address type." ::= { smfNeighborEntry 1 } smfNeighborIpAddr OBJECT-TYPE SYNTAX InetAddress MAX-ACCESS not-accessible STATUS current DESCRIPTION "The neighbor Inet IPv4 or IPv6 address." Cole, et al. Expires September 1, 2009 [Page 31] Internet-Draft The SMF MIB February 2009 ::= { smfNeighborEntry 2 } smfNeighborPrefixLen OBJECT-TYPE SYNTAX InetAddressPrefixLength MAX-ACCESS not-accessible STATUS current DESCRIPTION "The prefix length. This is a decimal value that indicates the number of contiguous, higher-order bits of the address that make up the network portion of the address." ::= { smfNeighborEntry 3 } smfNeighborRSSA OBJECT-TYPE SYNTAX SmfRssaID MAX-ACCESS read-only STATUS current DESCRIPTION "The current RSSA running on the neighbor. The list is identical to that described above for the smfRssa object." ::= { smfNeighborEntry 4 } smfNeighborNextHopInterface OBJECT-TYPE SYNTAX InterfaceIndexOrZero MAX-ACCESS read-only STATUS current DESCRIPTION "The interface ifIndex over which the neighbor is reachable in one-hop." ::= { smfNeighborEntry 5 } -- -- SMF Performance Group -- -- Contains objects which help to characterize the -- performance of the SMF RSSA process, such as statistics -- counters. There are two types of SMF RSSA statistics: -- global counters and per interface counters. -- smfPerformanceGroup OBJECT IDENTIFIER ::= { smfMIBObjects 4 } smfGlobalPerfGroup OBJECT IDENTIFIER ::= { smfPerformanceGroup 1 } Cole, et al. Expires September 1, 2009 [Page 32] Internet-Draft The SMF MIB February 2009 -- -- IPv4 packet counters -- smfIpv4MultiPktsRecvTotal OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A counter of the total number of multicast IPv4 packets received by the device." ::= { smfGlobalPerfGroup 1 } smfIpv4MultiPktsForwardedTotal OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A counter of the total number of multicast IPv4 packets forwarded by the device." ::= { smfGlobalPerfGroup 2 } smfIpv4DuplMultiPktsDetectedTotal OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A counter of the total number of duplicate multicast IPv4 packets detected by the device." ::= { smfGlobalPerfGroup 3 } smfIpv4DroppedMultiPktsTTLExceededTotal OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A counter of the total number of dropped multicast IPv4 packets by the device due to TTL exceeded." ::= { smfGlobalPerfGroup 4 } smfIpv4TTLLargerThanPreviousTotal OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current Cole, et al. Expires September 1, 2009 [Page 33] Internet-Draft The SMF MIB February 2009 DESCRIPTION "A counter of the total number of IPv4 packets recieved which have a TTL larger than that of a previously recived identical packet. " ::= { smfGlobalPerfGroup 5 } -- -- IPv6 packet counters -- smfIpv6MultiPktsRecvTotal OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A counter of the total number of multicast IPv6 packets received by the device." ::= { smfGlobalPerfGroup 6 } smfIpv6MultiPktsForwardedTotal OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A counter of the total number of multicast IPv6 packets forwarded by the device." ::= { smfGlobalPerfGroup 7 } smfIpv6DuplMultiPktsDetectedTotal OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A counter of the total number of duplicate multicast IPv6 packets detected by the device." ::= { smfGlobalPerfGroup 8 } smfIpv6DroppedMultiPktsTTLExceededTotal OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A counter of the total number of dropped multicast IPv6 packets by the Cole, et al. Expires September 1, 2009 [Page 34] Internet-Draft The SMF MIB February 2009 device due to TTL exceeded." ::= { smfGlobalPerfGroup 9 } smfIpv6TTLLargerThanPreviousTotal OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A counter of the total number of IPv6 packets recieved which have a TTL larger than that of a previously recived identical packet. " ::= { smfGlobalPerfGroup 10 } smfIpv6HAVAssistsReqdTotal OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A counter of the total number of IPv6 packets recieved which required the HAV assist for DPD. " ::= { smfGlobalPerfGroup 11 } smfIpv6DpdHeaderInsertionsTotal OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A counter of the total number of IPv6 packets recieved which the device inserted the DPD header option. " ::= { smfGlobalPerfGroup 12 } -- -- Per SMF Interface Performance Table -- smfInterfacePerfGroup OBJECT IDENTIFIER ::= { smfPerformanceGroup 2 } smfIpv4InterfacePerfTable OBJECT-TYPE SYNTAX SEQUENCE OF SmfIpv4InterfacePerfEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The SMF Interface Performance Table Cole, et al. Expires September 1, 2009 [Page 35] Internet-Draft The SMF MIB February 2009 describes the SMF statistics per interface." ::= { smfInterfacePerfGroup 1 } smfIpv4InterfacePerfEntry OBJECT-TYPE SYNTAX SmfIpv4InterfacePerfEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The SMF Interface Performance entry describes the statistics for a particular node interface." INDEX { smfIpv4IfPerfIfIndex } ::= { smfIpv4InterfacePerfTable 1 } SmfIpv4InterfacePerfEntry ::= SEQUENCE { smfIpv4IfPerfIfIndex InterfaceIndexOrZero, smfIpv4MultiPktsRecvPerIf Counter32, smfIpv4MultiPktsForwardedPerIf Counter32, smfIpv4DuplMultiPktsDetectedPerIf Counter32, smfIpv4DroppedMultiPktsTTLExceededPerIf Counter32, smfIpv4TTLLargerThanPreviousPerIf Counter32 } smfIpv4IfPerfIfIndex OBJECT-TYPE SYNTAX InterfaceIndexOrZero MAX-ACCESS not-accessible STATUS current DESCRIPTION "The ifIndex for this node interface that is collecting this set of performance management statistics." ::= { smfIpv4InterfacePerfEntry 1 } smfIpv4MultiPktsRecvPerIf OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A counter of the number of multicast IP packets received by the device on this interface." ::= { smfIpv4InterfacePerfEntry 2 } smfIpv4MultiPktsForwardedPerIf OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only Cole, et al. Expires September 1, 2009 [Page 36] Internet-Draft The SMF MIB February 2009 STATUS current DESCRIPTION "A counter of the number of multicast IP packets forwarded by the device on this interface." ::= { smfIpv4InterfacePerfEntry 3 } smfIpv4DuplMultiPktsDetectedPerIf OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A counter of the number of duplicate multicast IP packets detected by the device on this interface." ::= { smfIpv4InterfacePerfEntry 4 } smfIpv4DroppedMultiPktsTTLExceededPerIf OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A counter of the total number of dropped multicast IPv4 packets by the device due to TTL exceeded." ::= { smfIpv4InterfacePerfEntry 5 } smfIpv4TTLLargerThanPreviousPerIf OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A counter of the total number of IPv4 packets recieved which have a TTL larger than that of a previously recived identical packet. " ::= { smfIpv4InterfacePerfEntry 6 } smfIpv6InterfacePerfTable OBJECT-TYPE SYNTAX SEQUENCE OF SmfIpv6InterfacePerfEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The SMF Interface Performance Table describes the SMF statistics per interface." ::= { smfInterfacePerfGroup 2 } Cole, et al. Expires September 1, 2009 [Page 37] Internet-Draft The SMF MIB February 2009 smfIpv6InterfacePerfEntry OBJECT-TYPE SYNTAX SmfIpv6InterfacePerfEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The SMF Interface Performance entry describes the statistics for a particular node interface." INDEX { smfIpv6IfPerfIfIndex } ::= { smfIpv6InterfacePerfTable 1 } SmfIpv6InterfacePerfEntry ::= SEQUENCE { smfIpv6IfPerfIfIndex InterfaceIndexOrZero, smfIpv6MultiPktsRecvPerIf Counter32, smfIpv6MultiPktsForwardedPerIf Counter32, smfIpv6DuplMultiPktsDetectedPerIf Counter32, smfIpv6DroppedMultiPktsTTLExceededPerIf Counter32, smfIpv6TTLLargerThanPreviousPerIf Counter32, smfIpv6HAVAssistsReqdPerIf Counter32, smfIpv6DpdHeaderInsertionsPerIf Counter32 } smfIpv6IfPerfIfIndex OBJECT-TYPE SYNTAX InterfaceIndexOrZero MAX-ACCESS not-accessible STATUS current DESCRIPTION "The ifIndex for this node interface that is collecting this set of performance management statistics. For packets generated locally at this node, performance counters are assigned to the loopback interface. " ::= { smfIpv6InterfacePerfEntry 1 } smfIpv6MultiPktsRecvPerIf OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A counter of the number of multicast IP packets received by the device on this interface." ::= { smfIpv6InterfacePerfEntry 2 } Cole, et al. Expires September 1, 2009 [Page 38] Internet-Draft The SMF MIB February 2009 smfIpv6MultiPktsForwardedPerIf OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A counter of the number of multicast IP packets forwarded by the device on this interface." ::= { smfIpv6InterfacePerfEntry 3 } smfIpv6DuplMultiPktsDetectedPerIf OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A counter of the number of duplicate multicast IP packets detected by the device on this interface." ::= { smfIpv6InterfacePerfEntry 4 } smfIpv6DroppedMultiPktsTTLExceededPerIf OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A counter of the number of dropped multicast IP packets by the device on this interface due to TTL exceeded." ::= { smfIpv6InterfacePerfEntry 5 } smfIpv6TTLLargerThanPreviousPerIf OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A counter of the total number of IPv6 packets recieved which have a TTL larger than that of a previously recived identical packet. " ::= { smfIpv6InterfacePerfEntry 6 } smfIpv6HAVAssistsReqdPerIf OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A counter of the total number of IPv6 packets Cole, et al. Expires September 1, 2009 [Page 39] Internet-Draft The SMF MIB February 2009 recieved which required the HAV assist for DPD. " ::= { smfIpv6InterfacePerfEntry 7 } smfIpv6DpdHeaderInsertionsPerIf OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A counter of the total number of IPv6 packets recieved which the device inserted the DPD header option. " ::= { smfIpv6InterfacePerfEntry 8 } -- -- Reports Control -- This and the following tables are modeled -- after the report control and collection -- capabilities found in RMON II, RFC XXXX -- -- Note: Starting down this road only for general performance -- measures first. If desireable, then will add reports for -- IF specific measurements. -- smfReportsGroup OBJECT IDENTIFIER ::= { smfMIBObjects 5 } smfGenReportCntrlTable OBJECT-TYPE SYNTAX SEQUENCE OF SmfGenReportCntrlEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The smfGenReportCntrlTable is the controlling entry that manages the population of studies in the Report for selected time intervals. Note that this is not like the typical RMON controlTable and dataTable in which each entry creates its own data table. Each entry in this table enables the creation of multiple data tables on a study basis. For each interval, the study is updated in place, and the current data content of the table becomes invalid. The control table entries are persistent across system reboots." ::= { smfReportsGroup 1 } Cole, et al. Expires September 1, 2009 [Page 40] Internet-Draft The SMF MIB February 2009 smfGenReportCntrlEntry OBJECT-TYPE SYNTAX SmfGenReportCntrlEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A conceptual row in the smfGenReportCntrlTable. An example of the indexing of this entry is smfGenReportCntrInterval.1" INDEX { smfGenReportCntrlIndex } ::= { smfGenReportCntrlTable 1 } SmfGenReportCntrlEntry ::= SEQUENCE { smfGenReportCntrlIndex Unsigned32, smfGenReportCntrlInterval Unsigned32, smfGenReportCntrlReqSize Unsigned32, smfGenReportCntrlGrantedSize Unsigned32, smfGenReportCntrlReqReports Unsigned32, smfGenReportCntrlGrantedReports Unsigned32, smfGenReportCntrlStartTime TimeStamp, smfGenReportCntrlReportNumber Unsigned32, smfGenReportCntrlInsertsDenied Counter32, smfGenReportCntrlOwner OwnerString, smfGenReportCntrlStorageType StorageType, smfGenReportCntrlStatus RowStatus } smfGenReportCntrlIndex OBJECT-TYPE SYNTAX Unsigned32 (1..65535) MAX-ACCESS not-accessible STATUS current DESCRIPTION "An index that uniquely identifies an entry in the smfGenReportCntrlTable. Each such entry defines a unique report whose results are placed in the smfGenReportTable on behalf of this smfGenReportCntrlEntry." ::= { smfGenReportCntrlEntry 1 } smfGenReportCntrlInterval OBJECT-TYPE SYNTAX Unsigned32 UNITS "Seconds" MAX-ACCESS read-create STATUS current DESCRIPTION "The interval in seconds over which data is accumulated before being aggregated into a report in the smfGenReportTable. All reports with the same smfGenReportCntrlIndex will be Cole, et al. Expires September 1, 2009 [Page 41] Internet-Draft The SMF MIB February 2009 based on the same interval. This object may not be modified if the associated smfGenReportCntrlStatus object is equal to active(1)." DEFVAL { 3600 } ::= { smfGenReportCntrlEntry 2 } smfGenReportCntrlReqSize OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-create STATUS current DESCRIPTION "The maximum number of Client and Server combination entries requested for this report. When this object is created or modified, the probe should set smfGenReportCntrlGrantedSize as closely to this object as is possible for the particular probe implementation and available resources. It is important to note that this value is the number of requested entries in the smfGenReportTable only. This object may not be modified if the associated smfGenReportCntrlStatus object is equal to active(1)." ::= { smfGenReportCntrlEntry 3 } smfGenReportCntrlGrantedSize OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "The maximum number of performance entries in this report. When the associated smfGenReportCntrlReqSize object is created or modified, the probe should set this object as closely to the requested value as is possible for the particular implementation and available resources. The probe must not lower this value except as a result of a set to the associated smfGenReportCntrlReqSize object. It is an implementation-specific matter as to whether zero-valued entries are available." ::= { smfGenReportCntrlEntry 4 } smfGenReportCntrlReqReports OBJECT-TYPE SYNTAX Unsigned32 (1..65535) Cole, et al. Expires September 1, 2009 [Page 42] Internet-Draft The SMF MIB February 2009 MAX-ACCESS read-create STATUS current DESCRIPTION "The number of saved reports requested to be allocated on behalf of this entry. This object may not be modified if the associated smfGenReportCntrlStatus object is equal to active(1)." ::= { smfGenReportCntrlEntry 5 } smfGenReportCntrlGrantedReports OBJECT-TYPE SYNTAX Unsigned32 (0..65535) MAX-ACCESS read-only STATUS current DESCRIPTION "The number of saved reports the agent has allocated based on the requested amount in smfGenReportCntrlReqReports. Because each report can have many entries, the total number of entries allocated will be this number multiplied by the value of smfGenReportCntrlGrantedSize, or by 1 if that object doesn't exist. When the associated smfGenReportCntrlReqReports object is created or modified, the agent should set this object as closely to the requested value as is possible for the particular implementation and available resources. When considering available resources, the agent must consider its ability to allocate this many reports, each with the number of entries represented by smfGenReportCntrlGrantedSize, or by 1 if that object doesn't exist. Note that although the storage required for each report may fluctuate due to changing conditions, the agent must continue to have storage available to satisfy the full report size for all reports, when necessary. Further, the agent must not lower this value except as a result of a set to the associated smfGenReportCntrlReqSize object." ::= { smfGenReportCntrlEntry 6 } smfGenReportCntrlStartTime OBJECT-TYPE SYNTAX TimeStamp MAX-ACCESS read-only STATUS current DESCRIPTION "The value of sysUpTime when the system began processing the report in progress. Note that the report in progress is not available. Cole, et al. Expires September 1, 2009 [Page 43] Internet-Draft The SMF MIB February 2009 This object may be used by the management station to figure out the start time for all previous reports saved for this smfGenReportCntrlEntry, as reports are started at fixed intervals." ::= { smfGenReportCntrlEntry 7 } smfGenReportCntrlReportNumber OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of the report in progress. When an smfGenReportCntrlEntry is activated, the first report will be numbered zero." ::= { smfGenReportCntrlEntry 8 } smfGenReportCntrlInsertsDenied OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of attempts to add an entry to reports for this SmfGenReportCntrlEntry that failed because the number of entries would have exceeded smfGenReportCntrlGrantedSize. This number is valuable in determining if enough entries have been allocated for reports in light of fluctuating network usage. Note that an entry that is denied will often be attempted again, so this number will not predict the exact number of additional entries needed, but it can be used to understand the relative magnitude of the problem. Also note that there is no ordering specified for the entries in the report; thus, there are no rules for which entries will be omitted when not enough entries are available. As a consequence, the agent is not required to delete 'least valuable' entries first." ::= { smfGenReportCntrlEntry 9 } smfGenReportCntrlOwner OBJECT-TYPE SYNTAX OwnerString MAX-ACCESS read-create STATUS current DESCRIPTION "The entity that configured this entry and is therefore using the resources assigned to it. This object may not be modified if the associated Cole, et al. Expires September 1, 2009 [Page 44] Internet-Draft The SMF MIB February 2009 smfGenReportCntrlStatus object is equal to active(1)." ::= { smfGenReportCntrlEntry 10 } smfGenReportCntrlStorageType OBJECT-TYPE SYNTAX StorageType MAX-ACCESS read-create STATUS current DESCRIPTION "The storage type of this smfGenReportCntrlEntry. If the value of this object is 'permanent', no objects in this row need to be writable." ::= { smfGenReportCntrlEntry 11 } smfGenReportCntrlStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The status of this performance control entry. An entry may not exist in the active state unless each object in the entry has an appropriate value. Once this object is set to active(1), no objects in the smfGenReportCntrlTable can be changed. If this object is not equal to active(1), all associated entries in the smfGenReportTable shall be deleted." ::= { smfGenReportCntrlEntry 12 } -- -- Reports -- (Note: This represents a rather conservative list -- of objects for inclusion within offline report -- generation. As discussions evolve, more objects -- may be added to the below set. -- -- Also, it is typical to use this construct to define -- objects representing statistical information and not -- counter associated information. We need to define a set -- of statistical objects for these remote reports and -- replace this place-holder set prior to finalizing this MIB.) -- smfGenReportTable OBJECT-TYPE SYNTAX SEQUENCE OF SmfGenReportEntry MAX-ACCESS not-accessible Cole, et al. Expires September 1, 2009 [Page 45] Internet-Draft The SMF MIB February 2009 STATUS current DESCRIPTION "This table contains studies for each of the control table entries in smfGenReportCntrlTable. These studies are provided based on the selections and parameters found for the entry in the smfGenReportCntrlTable. The performance counter are the same as those specified in the smfPerformanceGroup." ::= { smfReportsGroup 2 } smfGenReportEntry OBJECT-TYPE SYNTAX SmfGenReportEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A conceptual row in the smfGenReportTable. The smfGenReportCntrlIndex value in the index identifies the smfGenReportCntrlEntry on whose behalf this entry was created. The smfGenReportIndex value in the index identifies which report (in the series of reports) this entry is a part of. An example of the indexing of this entry is smfGenReportMultiPktsForwarded.3.15" INDEX { smfGenReportCntrlIndex, smfGenReportIndex } ::= { smfGenReportTable 1 } SmfGenReportEntry ::= SEQUENCE { smfGenReportIndex Unsigned32, smfGenReportIpv4MultiPktsRecvTot ZeroBasedCounter32, smfGenReportIpv4MultiPktsForwardedTot ZeroBasedCounter32, smfGenReportIpv4DuplMultiPktsDetectedTot ZeroBasedCounter32, smfGenReportIpv4DroppedMultiPktsTTLExceededTot ZeroBasedCounter32 } smfGenReportIndex OBJECT-TYPE SYNTAX Unsigned32 (1..2147483647) MAX-ACCESS not-accessible STATUS current DESCRIPTION "The value of smfGenReportCntrlNumber for the report to Cole, et al. Expires September 1, 2009 [Page 46] Internet-Draft The SMF MIB February 2009 which this entry belongs." ::= { smfGenReportEntry 1 } smfGenReportIpv4MultiPktsRecvTot OBJECT-TYPE SYNTAX ZeroBasedCounter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The count of the total number of ...." ::= { smfGenReportEntry 2 } smfGenReportIpv4MultiPktsForwardedTot OBJECT-TYPE SYNTAX ZeroBasedCounter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The count of the total number of ...." ::= { smfGenReportEntry 3 } smfGenReportIpv4DuplMultiPktsDetectedTot OBJECT-TYPE SYNTAX ZeroBasedCounter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The count of the total number of ...." ::= { smfGenReportEntry 4 } smfGenReportIpv4DroppedMultiPktsTTLExceededTot OBJECT-TYPE SYNTAX ZeroBasedCounter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The count of the total number of ...." ::= { smfGenReportEntry 5 } -- -- Notifications -- -- Note: What notifications do we want for this MIB? -- -- Compliance Statements -- Cole, et al. Expires September 1, 2009 [Page 47] Internet-Draft The SMF MIB February 2009 -- Note: need to update the Compliance section once the mib -- objects stablize. smfCompliances OBJECT IDENTIFIER ::= { smfMIBConformance 1 } smfMIBGroups OBJECT IDENTIFIER ::= { smfMIBConformance 2 } smfBasicCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The basic implementation requirements for managed network entities that implement the SMF RSSA process." MODULE -- this module MANDATORY-GROUPS { smfCapabObjectsGroup, smfConfigObjectsGroup } ::= { smfCompliances 1 } smfFullCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The full implementation requirements for managed network entities that implement the SMF RSSA process." MODULE -- this module MANDATORY-GROUPS { smfCapabObjectsGroup, smfConfigObjectsGroup, smfStateObjectsGroup, smfPerfObjectsGroup, smfRepObjectsGroup } ::= { smfCompliances 2 } -- -- Units of Conformance -- smfCapabObjectsGroup OBJECT-GROUP OBJECTS { smfOpModeCapabilitiesName, smfOpModeCapabilitiesReference, smfRssaCapabilitiesName, smfRssaCapabilitiesReference } STATUS current DESCRIPTION "Set of SMF configuration objects implemented in this module." ::= { smfMIBGroups 1 } Cole, et al. Expires September 1, 2009 [Page 48] Internet-Draft The SMF MIB February 2009 smfConfigObjectsGroup OBJECT-GROUP OBJECTS { smfAdminStatus, smfConfiguredOpMode, smfConfiguredRssa, smfRssaMember, smfIpv4Dpd, smfIpv6Dpd, smfMaxPktLifetime, smfDpdMaxMemorySize, smfDpdEntryMaxLifetime, smfNhdpRssaMesgTLVIncluded, smfNhdpRssaAddrBlockTLVIncluded, smfNhdpRouterPriorityTLVIncluded, smfConfiguredAddrForwardingLastAddr, smfConfiguredAddrForwardingStatus, smfIfAdminStatus, smfIfRowStatus, smfGatewayFilterIf, smfGatewayFilterIfDirection, smfGatewayFilterRuleRank, smfGatewayFilterDestAddrType, smfGatewayFilterDestAddr, smfGatewayFilterDestAddrPrefixLen, smfGatewayFilterSrcAddrType, smfGatewayFilterSrcAddr, smfGatewayFilterSrcAddrPrefixLen, smfGatewayFilterProtocolNumber, smfGatewayFilterDestPortNumber, smfGatewayFilterAction, smfGatewayFilterRowStatus } STATUS current DESCRIPTION "Set of SMF configuration objects implemented in this module." ::= { smfMIBGroups 2 } smfStateObjectsGroup OBJECT-GROUP OBJECTS { smfNodeRsStatusIncluded, smfDpdMemoryOverflow, smfDiscoveredAddrForwardingLastAddr, smfDiscoveredAddrForwardingStatus, Cole, et al. Expires September 1, 2009 [Page 49] Internet-Draft The SMF MIB February 2009 smfNeighborRSSA, smfNeighborNextHopInterface } STATUS current DESCRIPTION "Set of SMF state objects implemented in this module." ::= { smfMIBGroups 3 } smfPerfObjectsGroup OBJECT-GROUP OBJECTS { smfIpv4MultiPktsRecvTotal, smfIpv4MultiPktsForwardedTotal, smfIpv4DuplMultiPktsDetectedTotal, smfIpv4DroppedMultiPktsTTLExceededTotal, smfIpv4TTLLargerThanPreviousTotal, smfIpv6MultiPktsRecvTotal, smfIpv6MultiPktsForwardedTotal, smfIpv6DuplMultiPktsDetectedTotal, smfIpv6DroppedMultiPktsTTLExceededTotal, smfIpv6TTLLargerThanPreviousTotal, smfIpv6HAVAssistsReqdTotal, smfIpv6DpdHeaderInsertionsTotal, smfIpv4MultiPktsRecvPerIf, smfIpv4MultiPktsForwardedPerIf, smfIpv4DuplMultiPktsDetectedPerIf, smfIpv4DroppedMultiPktsTTLExceededPerIf, smfIpv4TTLLargerThanPreviousPerIf, smfIpv6MultiPktsRecvPerIf, smfIpv6MultiPktsForwardedPerIf, smfIpv6DuplMultiPktsDetectedPerIf, smfIpv6DroppedMultiPktsTTLExceededPerIf, smfIpv6TTLLargerThanPreviousPerIf, smfIpv6HAVAssistsReqdPerIf, smfIpv6DpdHeaderInsertionsPerIf } STATUS current DESCRIPTION "Set of SMF performance objects implemented in this module by total and per interface." ::= { smfMIBGroups 4 } smfRepObjectsGroup OBJECT-GROUP OBJECTS { smfGenReportCntrlInterval, Cole, et al. Expires September 1, 2009 [Page 50] Internet-Draft The SMF MIB February 2009 smfGenReportCntrlReqSize, smfGenReportCntrlGrantedSize, smfGenReportCntrlReqReports, smfGenReportCntrlGrantedReports, smfGenReportCntrlStartTime, smfGenReportCntrlReportNumber, smfGenReportCntrlInsertsDenied, smfGenReportCntrlOwner, smfGenReportCntrlStorageType, smfGenReportCntrlStatus, smfGenReportIpv4MultiPktsRecvTot, smfGenReportIpv4MultiPktsForwardedTot, smfGenReportIpv4DuplMultiPktsDetectedTot, smfGenReportIpv4DroppedMultiPktsTTLExceededTot } STATUS current DESCRIPTION "Set of SMF reports objects implemented in this module." ::= { smfMIBGroups 5 } END 8. Security Considerations [TODO] Each specification that defines one or more MIB modules MUST contain a section that discusses security considerations relevant to those modules. This section MUST be patterned after the latest approved template (available at http://www.ops.ietf.org/mib-security.html). Remember that the objective is not to blindly copy text from the template, but rather to think and evaluate the risks/vulnerabilities and then state/ document the result of this evaluation. [TODO] if you have any read-write and/or read-create objects, please include the following boilerplate paragraph. 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: Cole, et al. Expires September 1, 2009 [Page 51] Internet-Draft The SMF MIB February 2009 o [TODO] writable MIB objects that could be especially disruptive if abused MUST be explicitly listed by name and the associated security risks MUST be spelled out; RFC 2669 has a very good example. o [TODO] list the writable tables and objects and state why they are sensitive. [TODO] else if there are no read-write objects in your MIB module, use the following boilerplate paragraph. There are no management objects defined in this MIB module that have a MAX-ACCESS clause of read-write and/or read-create. So, if this MIB module is implemented correctly, then there is no risk that an intruder can alter or create any management objects of this MIB module via direct SNMP SET operations. [TODO] if you have any sensitive readable objects, please include the following boilerplate paragraph. 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: o [TODO] you must explicitly list by name any readable objects that are sensitive or vulnerable and the associated security risks MUST be spelled out (for instance, if they might reveal customer information or violate personal privacy laws such as those of the European Union if exposed to unauthorized parties) o [TODO] list the tables and objects and state why they are sensitive. [TODO] discuss what security the protocol used to carry the information should have. The following three boilerplate paragraphs should not be changed without very good reason. Changes will almost certainly require justification during IESG review. SNMP versions prior to SNMPv3 did not include adequate security. Even if the network itself is secure (for example by using IPSec), even then, there is no control as to who on the secure network is allowed to access and GET/SET (read/change/create/delete) the objects in this MIB module. Cole, et al. Expires September 1, 2009 [Page 52] Internet-Draft The SMF MIB February 2009 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 indeed GET or SET (change/create/delete) them. 9. IANA Considerations [TODO] In order to comply with IESG policy as set forth in http://www.ietf.org/ID-Checklist.html, every Internet-Draft that is submitted to the IESG for publication MUST contain an IANA Considerations section. The requirements for this section vary depending what actions are required of the IANA. see RFC4181 section 3.5 for more information on writing an IANA clause for a MIB module document. [TODO] select an option and provide the necessary details. Option #1: The MIB module in this document uses the following IANA-assigned OBJECT IDENTIFIER values recorded in the SMI Numbers registry: Descriptor OBJECT IDENTIFIER value ---------- ----------------------- sampleMIB { mib-2 XXX } Option #2: Editor's Note (to be removed prior to publication): the IANA is requested to assign a value for "XXX" under the 'mib-2' subtree and to record the assignment in the SMI Numbers registry. When the assignment has been made, the RFC Editor is asked to replace "XXX" (here and in the MIB module) with the assigned value and to remove this note. Note well: prior to official assignment by the IANA, a draft document MUST use placeholders (such as "XXX" above) rather than actual numbers. See RFC4181 Section 4.5 for an example of how this is done Cole, et al. Expires September 1, 2009 [Page 53] Internet-Draft The SMF MIB February 2009 in a draft MIB module. Option #3: This memo includes no request to IANA. 10. Contributors This MIB document uses the template authored by D. Harrington which is based on contributions from the MIB Doctors, especially Juergen Schoenwaelder, Dave Perkins, C.M.Heard and Randy Presuhn. 11. Acknowledgements 12. References 12.1. Normative References [RFC2863] McCloghrie, K. and F. Kastenholz, "The Interfaces Group MIB", RFC 2863, June 2000. [RFC3418] Presuhn, R., "Management Information Base (MIB) for the Simple Network Management Protocol (SNMP)", STD 62, RFC 3418, December 2002. [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997. [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. [I-D.ietf-manet-smf] Macker, J. and S. Team, "Simplified Multicast Forwarding for MANET", draft-ietf-manet-smf-08 (work in progress), November 2008. Cole, et al. Expires September 1, 2009 [Page 54] Internet-Draft The SMF MIB February 2009 12.2. Informative References [RFC3410] Case, J., Mundy, R., Partain, D., and B. Stewart, "Introduction and Applicability Statements for Internet-Standard Management Framework", RFC 3410, December 2002. Appendix A. Change Log Not applicable to draft 00 1. Appendix B. Open Issues This section contains the set of open issues related to the development and design of the SMF-MIB. This section will not be present in the final version of the MIB and will be removed once all the open issues have been resolved. 1. Clarify handling of the NHDP TLV message inclusions? 2. Can we develop a capabilities table for the supported RSSA algorithms? And, if so, can each supported RSSA have a different set of configuration parameters? 3. Is the Gateway Filter table appropriate for this MIB or should it be handled in a separate MIB worked elsewhere? How should this table be indexed and how should it represent the ordering of the rules (or chains)? Should this be greatly simplified? How do we handle null values in the rules? 4. Is it useful to track the effectiveness of the coverage of the current RSSA? Is it possible to track this? 5. Complete notification group. 6. Complete conformance group. 7. Work on the relationship to other MIBs, IF-MIB, NHDP-MIB. 8. Update the text of the document to reflect the final state of the MIB. 9. Identify all objects requiring non-volatile storage in their DESCRIPTION clauses. Cole, et al. Expires September 1, 2009 [Page 55] Internet-Draft The SMF MIB February 2009 10. Incorporate parameter relationship conditions into their DESCRIPTION clauses. 11. Complete the security analysis and section. 12. Cleanup all the [TODOs] from the MIB template. Appendix C. *************************************************************** * Note to the RFC Editor (to be removed prior to publication) * * * * 1) The reference to RFCXXXX within the DESCRIPTION clauses * * of the MIB module point to this draft and are to be * * assigned by the RFC Editor. * * * * 2) The reference to RFCXXX2 throughout this document point * * to the current draft-ietf-manet-smf-xx.txt. This * * need to be replaced with the XXX RFC number. * * * *************************************************************** Authors' Addresses Robert G. Cole Johns Hopkins University 11100 Johns Hopkins Road, Room 257 Laurel, Maryland 21073 USA Phone: +1 443 778 6951 EMail: robert.cole@jhuapl.edu URI: http://www.cs.jhu.edu/~rgcole/ Joseph Macker Naval Research Laboratory Washington, D.C. 20375 USA EMail: macker@itd.nrl.navy.mil Cole, et al. Expires September 1, 2009 [Page 56] Internet-Draft The SMF MIB February 2009 Brian Adamson Naval Research Laboratory Washington, D.C. 20375 USA EMail: adamson@itd.nrl.navy.mil Sean Harnedy Booz Allen Hamilton 333 City Boulevard West Orange, CA 92868 USA EMail: harnedy_sean@bah.com Cole, et al. Expires September 1, 2009 [Page 57]