<?xml version='1.0' ?>
<?rfc toc="yes"?>
<?rfc symrefs="yes"?>
<rfc docName="draft-liu-lsr-p2poverlan-03" ipr="trust200902" category="info">
	<front>
		<title abbrev='IfStackTable for P2poverLAN interface'>Interface Stack Table Definition for Point to Point (P2P) Interface over LAN</title>
		<author initials="D." surname="Liu" fullname="Daiying Liu">
			<organization>Ericsson</organization>
			<address>
				<postal>
					<street>No.5 Lize East street</street>
					<code>100102</code>
					<city>Beijing</city>
					<country>China</country>
				</postal>
				<email>harold.liu@ericsson.com</email>
			</address>
		</author>
		<author initials="J." surname="Halpern" fullname="Joel Halpern">
			<organization>Ericsson</organization>
			<address>
				<email>joel.halpern@ericsson.com</email>
			</address>
		</author>
		<author initials="C." surname="Zhang" fullname="Congjie Zhang">
			<organization>Ericsson</organization>
			<address>
				<email>congjie.zhang@ericsson.com</email>
			</address>
		</author>
		<date month="June" year="2021"/>
		<area>General</area>
		<keyword>RFC</keyword>
		<keyword>Internet-Draft</keyword>
		<keyword>XML</keyword>
		<keyword>Extensible Markup Language</keyword>
		<abstract>
			<t>In <xref target="RFC5309"/> defines the Point to Point (P2P) circuit type is one of the mainly used circuit types in link state routing protocol,
				 and highlights it is important to identify the correct circuit type when forming adjacencies, flooding 
         link state database packets, and monitor the link state.
      </t>
      <t>
         Point to Point (P2P) Interface over LAN ifType value is assigned by IANA experts review.
         This document provides an example of the ifStack for Point to Point (P2P) Interface over LAN ifType
         to facilitate operational control, maintenance and statistics.
			</t>
		</abstract>
	</front>





	<middle>
		<section title="Introduction">
      <t>The assignment of a value (303, available at https://www.iana.org/assignments/smi-numbers/smi-numbers.xhtml#smi-numbers-5) to p2pOverLan ifType was made by expert review. 
      	 To simplify configuration and operational control, it is helpful
      	 to represent the fact that an interface is to be considered
      	 a Point to Point (P2P) Interface over LAN type explicitly in the interface stack. This
      	 enables, for example, routing protocols to automatically inherit 
      	 the correct operating mode from interface stack without further configuration(Not need to explicitly configure Point to Point Interface in routing protocols).
      </t>
      <t>So it is helpful to map Point to Point (P2P) Interface over LAN type in interface management stack table. 
      	 And if no entry specify Point to Point (P2P) Interface lower layer, the management will suffer 
      	 since lose the ability to get to the lower layer specific management properties via many tools.
      </t>
    </section>

    <section title="Requirements Language">
      <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 <xref target="RFC2119"/> <xref target="RFC8174"/>.
      </t>
    </section>

    <section title="Interface Stack Table for Point to Point (P2P) Interface Type">
    	<t>If the device implements the IF-MIB <xref target="RFC2863"/>, each entry in the
         "/interfaces/interface" list (in "Interface Management YANG") in the operational state is typically
         mapped to one ifEntry is required in <xref target="RFC8343"/>, therefore Point to Point (P2P) Interface over LAN type 
         should also fully map to one ifEntry by defining the "ifStackTable" ("higher-layer-if" and "lower-layer-if").
    	</t>
    	<t>Point to Point (P2P) interface higher layer should be network layer "ipForward" 
    	   (defined in IANA) 
    	   to run routing protocol, 
    		 Point to Point (P2P) interface lower layer is link data layer "ethernetCsmacd" (defined in IANA).
    	</t>
    	<t>Point to Point (P2P) interface type ifStackTable can be defined along the lines of following example which complies with <xref target="RFC8343"/>:
    	</t>
    	<figure align="center" anchor="xml_happy_2">
        <artwork align="center"><![CDATA[
          <interface>
            <name>isis_int</name>
            <type>ianaift:ipForward</type>
          </interface>
 
          <interface>
            <name>eth1</name>
            <type>ianaift:ethernetCsmacd</type>
          </interface>
 
          <interface>
            <name>p2p</name>
            <type>ianaift:p2pOverLan</type>
            <higher-layer-if>isis_int</higher-layer-if>
            <lower-layer-if>eth1</lower-layer-if>
            <enabled>false</enabled>
            <admin-status>down</admin-status>
            <oper-status>down</oper-status>
            <statistics>
              <discontinuity-time>
                2021-04-01T03:00:00+00:00
              </discontinuity-time>
              <!-- counters now shown here -->
            </statistics>
          </interface>
            ]]></artwork>
      </figure>
    </section>

    <section title="Security Considerations">
      <t>The interface stack table specified in this document is read-only.
      	 Read operation to this table without complete protection shouldn't have a negative
         effect on network operations.
      </t>
    </section>

    <section title="IANA Considerations">
    	<t>In the Interface Types registry, IANA has previously assigned a value of 303 
    		 for p2pOverLan with a reference of <xref target="RFC5309"/>, as shown in following table 
    		 (available at https://www.iana.org/assignments/smi-numbers/smi-numbers.xhtml#smi-numbers-5).
    		 IANA is requested to amend the reference to point to this document 
    		 and to make a similar amendment in the YANG iana-if-type module <xref target="RFC7224"/> which currently points to <xref target="RFC8561"/>, 
    		 as this document explains how the ifType is to be used.
    	</t>
    	<figure align="center" anchor="xml_happy_5">
        <artwork align="center"><![CDATA[
+=========+==================+==================+
| Decimal |    Name          |    references    |
+=========+==================+==================+
|  303    |  p2pOverLan      |      RFC5309     |
+---------+------------------+------------------+
            ]]></artwork>
      </figure>
    </section>
	</middle>


	<back>
		<references title="Normative references">
			<reference anchor="RFC2119" target="https://www.rfc-editor.org/info/rfc2119">
				<front>
					<title>Key words for use in RFCs to Indicate Requirement Levels</title>
					<author initials="S." surname="Bradner">
						<organization/>
					</author>
					<date year="1997" month="March"/>
				</front>
				<seriesInfo name="BCP" value="14"/>
				<seriesInfo name="RFC" value="2119"/>
				<seriesInfo name="DOI" value="10.17487/RFC2119"/>
			</reference>
			<reference anchor="RFC2863" target="https://www.rfc-editor.org/info/rfc2863">
				<front>
					<title>The Interfaces Group MIB</title>
					<author initials="K." surname="McCloghrie">
						<organization/>
					</author>
					<author initials="F." surname="Kastenholz">
						<organization/>
					</author>
					<date year="2000" month="June"/>
				</front>
				<seriesInfo name="RFC" value="2863"/>
				<seriesInfo name="DOI" value="10.17487/RFC2863"/>
			</reference>
			<reference anchor="RFC5309" target="https://www.rfc-editor.org/info/rfc5309">
				<front>
					<title>Point-to-Point Operation over LAN in Link State Routing Protocols</title>
					<author initials="A." surname="Zinin">
						<organization/>
					</author>
					<author initials="N." surname="Shen">
						<organization/>
					</author>
					<date year="2008" month="October"/>
				</front>
				<seriesInfo name="RFC" value="5309"/>
				<seriesInfo name="DOI" value="10.17487/RFC5309"/>
			</reference>
			<reference anchor="RFC7224" target="https://www.rfc-editor.org/info/rfc7224">
				<front>
					<title>IANA Interface Type YANG Module</title>
					<author initials="M." surname="Bjorklund">
						<organization/>
					</author>
					<date year="2014" month="May"/>
				</front>
				<seriesInfo name="RFC" value="7224"/>
				<seriesInfo name="DOI" value="10.17487/RFC7224"/>
			</reference>
			<reference anchor="RFC8174" target="https://www.rfc-editor.org/info/rfc8174">
				<front>
					<title>Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words</title>
					<author initials="B." surname="Leiba">
						<organization/>
					</author>
					<date year="2017" month="May"/>
				</front>
				<seriesInfo name="RFC" value="8174"/>
				<seriesInfo name="IETF RFC" value="8174"/>
				<seriesInfo name="DOI" value="10.17487/RFC8174"/>
			</reference>
			<reference anchor="RFC8343" target="https://www.rfc-editor.org/info/rfc8343">
				<front>
					<title>A YANG Data Model for Interface Management</title>
					<author initials="M." surname="Bjorklund">
						<organization/>
					</author>
					<date year="2018" month="March"/>
				</front>
				<seriesInfo name="RFC" value="8343"/>
				<seriesInfo name="DOI" value="10.17487/RFC8343"/>
			</reference>
			<reference anchor="RFC8561" target="https://www.rfc-editor.org/info/rfc8561">
				<front>
					<title>A YANG Data Model for Microwave Radio Link</title>
					<author initials="J." surname="Ahlberg">
						<organization/>
					</author>
					<author initials="M." surname="Ye">
						<organization/>
					</author>
					<author initials="X." surname="Li">
						<organization/>
					</author>
					<author initials="D." surname="Spreafico">
						<organization/>
					</author>
					<author initials="M." surname="Ahlberg">
						<organization/>
					</author>
					<date year="2019" month="June"/>
				</front>
				<seriesInfo name="RFC" value="8561"/>
				<seriesInfo name="DOI" value="10.17487/RFC8561"/>
			</reference>
		</references>







		<references title="Informative References">
			<reference anchor="RFC6991" target="https://www.rfc-editor.org/info/rfc6991">
				<front>
					<title>Common YANG Data Types</title>
					<author initials="J." surname="Schoenwaelder">
						<organization/>
					</author>
					<date year="2011" month="June"/>
				</front>
				<seriesInfo name="RFC" value="6991"/>
				<seriesInfo name="DOI" value="10.17487/RFC6991"/>
			</reference>
			<reference anchor="RFC8340" target="https://www.rfc-editor.org/info/rfc8340">
				<front>
					<title>YANG Tree Diagrams</title>
					<author initials="M." surname="Bjorklund">
						<organization/>
					</author>
					<author initials="L." surname="Berger">
						<organization/>
					</author>
					<date year="2018" month="March"/>
				</front>
				<seriesInfo name="BCP" value="215"/>
				<seriesInfo name="RFC" value="8340"/>
				<seriesInfo name="DOI" value="10.17487/RFC8340"/>
			</reference>
		</references>
	</back>
</rfc>