<?xml version="1.0" encoding="US-ASCII"?>
<!DOCTYPE rfc SYSTEM "rfc2629.dtd">
<?rfc strict="yes"?>
<?rfc toc="yes"?>
<?rfc tocdepth="4"?>
<?rfc symrefs="yes"?>
<?rfc sortrefs="yes"?>
<?rfc compact="yes"?>
<?rfc subcompact="no"?>

<rfc category="std" docName="draft-cai-softwire-6rd-mib-05" updates="" ipr="trust200902">
  <front>

    <title abbrev="6rd MIB">Definitions of Managed Objects for 6rd</title>

    <author fullname="Lei Cai" initials="L" surname="Cai">
      <organization>ZTE</organization>
    <address>
      <postal>
        <street>No. 68 Zijinhua Rd.,</street>
        <city>Nanjing</city>
        <region></region>
        <code>210012</code>
        <country>China</country>
      </postal>
        <phone>+86 25 5287 2205</phone>
        <email>cai.lei3@zte.com.cn</email>
      </address>
    </author>

    <author fullname="Jacni Qin" initials="J" surname="Qin">
      <organization>Cisco Systems</organization>
      <address>
      <postal>
        <street></street>
        <city>Shanghai</city>
        <region></region>
        <code></code>
        <country>China</country>
      </postal>
      <phone>+86 1891 836 3666</phone>
      <email>jacni@jacni.com</email>
      </address>
    </author>

    <author fullname="Shishio Tsuchiya" initials="S" surname="Tsuchiya" role="editor"> 
      <organization>Cisco Systems</organization>
      <address>
        <postal>
          <street>Midtown Tower, 9-7-1, Akasaka</street>
          <city>Minato-Ku</city>
          <region>Tokyo</region>
          <code>107-6227</code>
          <country>Japan</country>
        </postal>
        <phone>+81 3 6434 6543</phone>
        <email>shtsuchi@cisco.com</email>
      </address>
    </author>

    <date year="2013" />

    <area></area>

    <workgroup>Softwire</workgroup>

    <keyword>MIB</keyword>

    <abstract>
      <t>This document defines a portion of the Management Information Base
      (MIB) for use with network management protocols. In particular, it
      defines objects for managing 6rd devices.</t>

      <!--Remember, don't put any citations in the abstract, and expand your acronyms. -->
    </abstract>
  </front>

  <middle>
    <section title="Introduction">
      <t>This draft describes the Management Information Base (MIB) module for
      6rd (IPv6 Rapid Deployment, <xref target="RFC5969"></xref>), which specifies an automatic
      tunneling mechanism to deploy IPv6 to sites via a operator's IPv4
      network.</t>
    </section>

    <section title="The Internet-Standard Management Framework">
      <t>For a detailed
      overview of the documents that describe the current Internet-Standard
      Management Framework, please refer to section 7 of RFC 3410 <xref
      target="RFC3410"></xref>.</t>

      <t>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 <xref
      target="RFC2578"></xref>, STD 58, RFC 2579 <xref
      target="RFC2579"></xref> and STD 58, RFC 2580 <xref
      target="RFC2580"></xref>.</t>
    </section>

    <section title="Conventions">
      <t>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 <xref target="RFC2119"></xref>.</t>
    </section>

    <section title="Structure of the MIB Module">
      <t>The MIB Module specified herein provides one way to manage the 6rd
      devices through SNMP.</t>

      <section title="sixRdTable">
        <t>This table contains the configuration information for 6rd.</t>
      </section>

      <section title="sixRdBrIpv4AddressTable">
        <t>This table contains the BR IPv4 Address for configurations on
        given 6rd CE device.</t>
      </section>
	  
	  <section title="sixRdSecurityCeck">
        <t>This table contains counter of packets drop by 6rd receiving rule.</t>
      </section>
	  
    </section>

    <section title="Relationship to Other MIB Modules">
      <section title="Relationship to the SNMPv2-MIB">
        <t>The 'system' group in the SNMPv2-MIB <xref target="RFC3418"></xref>
        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
        SAMPLE-MIB does not duplicate those objects.</t>
      </section>

      <section title="Relationship to the IP Tunnel MIB">
        <t>The IP Tunnel MIB <xref target="RFC4087"></xref> contains objects common to all IP tunnels,
        including 6rd. Additionally, tunnel encapsulation specific MIB (like
        what is defined in this document) extend the IP tunnel MIB to further
        describe encapsulation specific information, for example (in case of
        6rd): 6rd prefix, 6rd Prefix Length, IPv4Mask Length and BR IPv4
        Address.</t>

        <t>The implementation of the IP Tunnel MIB is required for 6rd. The
        tunnelIfEncapsMethod in the tunnelIfEntry should be set to sixRd("xx"),
        and an entry in the 6rd MIB module will exist for every tunnelIfEntry
        with this tunnelIfEncapsMethod. The tunnelIfRemoteAddress must be set
        to 0.0.0.0.</t>

        <t>[Ed.Note:]This is similar to the situation of L2TP MIB <xref target="RFC3371"></xref> case,
        since the IANA is requested to assign a value for sixRdMIB under the "transmission"
        subtree. Also, a new IANAtunnelType (rather than IANAifType) value is
        needed and should be recorded in the IANAifType-MIB registry, refer to
        Section 8.</t>
      </section>
	  
	<section title="Relationship to the Interfaces MIB">
	<t>Each logical interface (physical or virtual) has an ifEntry in the Interfaces MIB<xref target="RFC2863"></xref>.
          Tunnels are handled by creating a logical interface (ifEntry) for each tunnel. </t>
	</section>
	  
        <section title="Relationship to the IP MIB">
	 <t>IP MIB<xref target="RFC4293"></xref> provides traffic statics counter and status for 6rd virtual interface.</t>
	  </section>
	  

      <section title="MIB modules required for IMPORTS">
        <t>This MIB module IMPORTs objects from <xref target="RFC4087"></xref>, <xref target="RFC2580"></xref>, <xref target="RFC2578"></xref>,
        <xref target="RFC2863"></xref>, <xref target="RFC3411"></xref>.</t>
      </section>
    
      </section>

    <section title="Definitions">
      <figure>
        <artwork align="center"><![CDATA[
SIXRD-MIB DEFINITIONS ::= BEGIN

    IMPORTS
        OBJECT-TYPE, transmission, Integer32
            FROM SNMPv2-SMI

        ifIndex
            FROM IF-MIB

        InetAddressIPv4, InetAddressPrefixLength, InetAddressIPv6
            FROM INET-ADDRESS-MIB;

    sixRdMIB MODULE-IDENTITY
        LAST-UPDATED "201208120000Z" -- August 12, 2012
        ORGANIZATION "IETF Softwire Working Group"
        CONTACT-INFO
            "Lei Cai
             ZTE
             No. 68 Zijinhua Rd.,
             Nanjing,   210012
             China
             Email: cai.lei3@zte.com.cn

             Jacni Qin
             Cisco Systems
             Shanghai,
             China
             Email: jacni@jacni.com
             
             Shishio Tsuchiya
             Cisco Systems
             Midtown Tower, 9-7-1, Akasaka
             Minato-Ku, Tokyo  107-6227
             Japan
             Email: shtsuchi@cisco.com"

        DESCRIPTION
            "The MIB module defines managed objects for 6rd."

        :: =  { transmission XX }   ---xx to be replaced

            sixRdDevice OBJECT-TYPE
                SYNTAX     Integer32 (0..1)
                MAX-ACCESS read-write
                STATUS     current
                DESCRIPTION
                    "A value of 1 indicates the device is a 6rd BR,
                    or 0 indicates the device is a 6rd CE."
                ::= { sixRdMIB 1 }

            sixRdTable OBJECT-TYPE
                SYNTAX     SEQUENCE OF SixRdEntry
                MAX-ACCESS not-accessible
                STATUS     current
                DESCRIPTION
                    "The table contains the configuration information
                    of 6rd on a particular tunnel."
                ::= { sixRdMIB 2 }

            sixRdEntry OBJECT-TYPE
                SYNTAX     SixRdEntry
                MAX-ACCESS not-accessible
                STATUS     current
                DESCRIPTION
                    "An entry containing the configuration
                    information of 6rd on a particular tunnel."
                INDEX      {ifIndex}
                ::= { sixRdTable 1 }

                SixRdEntry ::= SEQUENCE {
                    sixRdPrefix              InetAddressIPv6,
                    sixRdPrefixLen           InetAddressPrefixLength,
                    sixRdIpv4MaskLen         Integer32
                }                           

                sixRdPrefix OBJECT-TYPE
                    SYNTAX     InetAddressIPv6
                    MAX-ACCESS read-write
                    STATUS     current
                    DESCRIPTION
                        "The 6rd prefix of this 6rd domain."
                    ::= { sixRdEntry 1 }

                sixRdPrefixLen OBJECT-TYPE
                    SYNTAX     InetAddressPrefixLength
                    MAX-ACCESS read-write
                    STATUS     current
                    DESCRIPTION
                        "The length of 6rd prefix."
                    ::= { sixRdEntry 2 }

                sixRdIpv4MaskLen OBJECT-TYPE
                    SYNTAX     Integer32 (0..32)
                    MAX-ACCESS read-write
                    STATUS     current
                    DESCRIPTION
                        "The number of high-order bits that are
                        identical across all CE IPv4 addresses within
                        this 6rd domain."
                    ::= { sixRdEntry 3 }

            sixRdBrIpv4AddressTable OBJECT-TYPE
                SYNTAX     SEQUENCE OF SixRdBrIpv4AddressEntry
                MAX-ACCESS not-accessible
                STATUS     current
                DESCRIPTION
                    "The table contains the BR IPv4 Address of given
                    6rd domain if the value of 6rdDevice is 0 (i.e.,
                    6rd CE), or should be omitted if the value of
                    6rdDevice is 1 (i.e., 6rd BR)."
                ::= { sixRdMIB 3 }

            sixRdBrIpv4AddressEntry OBJECT-TYPE
                SYNTAX     SixRdBrIpv4AddressEntry
                MAX-ACCESS not-accessible
                STATUS     current
                DESCRIPTION
                    "An entry containing the BR IPv4 Address of given
                    6rd domain."
                INDEX      {ifIndex,
                            sixRdBrIpv4Address
                }
                ::= { sixRdBrIpv4AddressTable 1 }

                SixRdBrIpv4AddressEntry ::= SEQUENCE {
                    sixRdBrIpv4Address              InetAddressIPv4
                }

                sixRdBrIpv4Address OBJECT-TYPE
                    SYNTAX     InetAddressIPv4
                    MAX-ACCESS read-write
                    STATUS     current
                    DESCRIPTION
                        "The BR IPv4 Address of this 6rd domain."
                    ::= { sixRdBrIpv4AddressEntry 1 }


	  sixRdSecurityCeck OBJECT-TYPE
                SYNTAX     SEQUENCE OF sixRdSecurityCeckInvalidPackets
                MAX-ACCESS not-accessible
                STATUS     current
                DESCRIPTION
                    "This table contains counter of packets drop by 6rd 
		     receiving rule."
                ::= { sixRdMIB 4 }

           sixRdSecurityCeckInvalidPackets OBJECT-TYPE
                SYNTAX     Counter64
                MAX-ACCESS read-only
                STATUS     current
                DESCRIPTION
                    "6rd BR/CE MUST validate the embedded IPv4 source 
		    address of the encapsulated IPv6 packet with the IPv4 
		    source address it is encapsulated by according to the 
                    configured parameters of the 6rd domain.  If the two 
		    source addresses do not match, the packet MUST be dropped 
                    and a counter incremented. This counter indicates the total
                    number of octets dropped packets by the receiving rules."
                INDEX      {ifIndex}
                ::= { sixRdSecurityCeckInvalidPackets 1 }
    
END
		]]></artwork>
      </figure>
    </section>

    <section title="Security Considerations">
      <t>This document does not introduce any new security concern in addition
      to what is discussed in Section 6 of <xref target="RFC4087"></xref>.</t>
    </section>

    <section title="IANA Considerations">
      <t>The MIB module in this document uses the following IANA-assigned
      OBJECT IDENTIFIER values recorded in the SMI Numbers registry, and
      the following IANA-assigned tunnelType values recorded in the
      IANAifType-MIB registry:</t>

      <figure>
        <preamble></preamble>
        <artwork align="center"><![CDATA[
Descriptor        OBJECT IDENTIFIER value
----------        -----------------------

 sixRdMIB            { transmission XXX }


IANAtunnelType ::= TEXTUAL-CONVENTION
    SYNTAX     INTEGER {

               sixRd ("XX")        -- 6rd encapsulation

               }
      	]]></artwork>

        <postamble></postamble>
      </figure>
    </section>

  </middle>

  <back>
    <references title="Normative References">
      <?rfc include='reference.RFC.2119'?>

      <?rfc include='reference.RFC.2578'?>




      <?rfc include='reference.RFC.2579'?>

      <?rfc include='reference.RFC.2580'?>

      <?rfc include='reference.RFC.2863'?>

      <?rfc include='reference.RFC.3371'?>

      <?rfc include='reference.RFC.3410'?>

      <?rfc include='reference.RFC.3411'?>

      <?rfc include='reference.RFC.3418'?>

      <?rfc include='reference.RFC.4087'?>

      <?rfc include='reference.RFC.5969'?>
	  
	  <?rfc include='reference.RFC.4293'?>
    </references>

    <references title="Informative References">
      <?rfc include='reference.RFC.4181'?>
    </references>
  </back>
</rfc>
