<?xml version="1.0" ?>
<!DOCTYPE rfc SYSTEM "rfc2629.dtd">
<rfc ipr="trust200902" category="std" docName="draft-doi-roll-mpl-parameter-configuration-04">
  <?rfc toc="yes"?>         <!-- generate a table of contents -->
  <?rfc symrefs="yes"?>     <!-- use anchors instead of numbers for references -->
  <?rfc sortrefs="yes" ?>   <!-- alphabetize the references -->
  <?rfc compact="yes" ?>    <!-- conserve vertical whitespace -->
  <?rfc subcompact="no" ?>  <!-- but keep a blank line between list items -->
  <front>
    <title abbrev="MPL Conf. for DHCPv6">MPL Parameter Configuration Option for DHCPv6</title>

    <author initials="Y." surname="Doi"
	    fullname="Yusuke Doi">
      <organization>TOSHIBA Corporation</organization>

      <address>
	<postal>
	  <street>Komukai Toshiba Cho 1</street>
	  <street>Saiwai-Ku</street>
	  <city>Kawasaki</city> <region>Kanagawa</region>
	  <code>2128582</code>
	  <country>JAPAN</country>
	</postal>

	<phone>+81-45-342-7230</phone>
	<email>yusuke.doi@toshiba.co.jp</email>
	<uri></uri>
      </address>
    </author>

    <author initials="M." surname="Gillmore"
	    fullname="Matthew Gillmore">
      <organization>Itron, Inc</organization>

      <address>
	<postal>
	  <street>2111 N Molter Rd.</street>
	  <city>Liberty Lake</city> <region>WA</region>
	  <code>99019</code>
	  <country>USA</country>
	</postal>

	<email>matthew.gillmore@itron.com</email>
      </address>
    </author>


    <date month="February" year="2014"/>

    <area>rtg</area>
    <workgroup>roll</workgroup>
    <keyword>MPL, DHCPv6</keyword>
    <abstract>
      <t>
This draft is to define a way to configure MPL parameter via DHCPv6 option.
      </t>
    </abstract>
  </front>

  <middle>
<!-- This document was prepared using Pandoc2rfc, https://github.com/miekg/pandoc2rfc -->

  
<section title="Introduction" anchor="introduction">
  
  <t>
    Multicast Protocol for Low power and Lossy Networks
    <xref target="I-D.ietf-roll-trickle-mcast">(MPL)</xref> defines a
    protocol to make a multicast network among low power and lossy
    network i.e. wireless mesh networks. MPL has various parameters to
    control its behavior and tradeoff between end-to-end delay and
    network utilization. In some environments, the parameters shall be
    configured carefully to meet each environment and requirement.
    According to the MPL draft section 5.4, the parameter should be same
    for all nodes within an MPL domain. And the MPL draft does not
    define a method to configure it.
  </t>
  <t>
    Some managed wireless mesh networks may have a DHCP server to
    configure network parameters with DHCP relay in each node. MPL
    parameters shall be considered as a part of network parameters
    (parameter shall match within an MPL domain). This document is to
    define the way to distribute parameters for MPL forwarders as a
    simple <xref target="RFC3315">DHCPv6</xref> option.
  </t>
</section>
<section title="MPL Parameter Configuration Option" anchor="mpl-parameter-configuration-option">
  
  <t>
    Per MPL domain, there are following 10 parameters. An MPL domain is
    defined by an MPL domain address.
  </t>
  <t><list style="symbols">
    <t>
      
        PROACTIVE_FORWARDING
      
    </t>
    <t>
      
        SEED_SET_ENTRY_LIFETIME
      
    </t>
    <t>
      
        DATA_MESSAGE_IMIN
      
    </t>
    <t>
      
        DATA_MESSAGE_IMAX
      
    </t>
    <t>
      
        DATA_MESSAGE_K
      
    </t>
    <t>
      
        DATA_MESSAGE_TIMER_EXPIRATIONS
      
    </t>
    <t>
      
        CONTROL_MESSAGE_IMIN
      
    </t>
    <t>
      
        CONTROL_MESSAGE_IMAX
      
    </t>
    <t>
      
        CONTROL_MESSAGE_K
      
    </t>
    <t>
      
        CONTROL_MESSAGE_TIMER_EXPIRATIONS
      
    </t>
  </list></t>
  <t>
    One network may have multiple MPL domains with different
    configuration. To configure plural of MPL domains via DHCP, there
    may be more than one MPL Parameter Configuration Option given to
    DHCP clients from a DHCP server.
  </t>
  <section title="Unsigned Short Floating Point" anchor="unsigned-short-floating-point">
    
    <t>
      MPL has many timer parameters. Expected range of the timers
      depends on the network topology or MAC/PHY nature. To accommodate
      wide range of timer values efficiently, the MPL Parameter
      Configuration Option uses base-10 unsigned short floating point
      number with 3-bit exponent and 13-bit significand defined as
      follows (exp. stands for exponent).
    </t>
    <figure><artwork>
 0                   1           
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| exp.|      significand        |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
</artwork></figure>
    <t>
      The represented value is (significand) * 10^(exp.). Minimum
      exponent is 0 (binary 000) and maximum is 6 (binary 110). exp=7
      (binary 111) is reserved for future use. Minimum significand is 0
      (all 0) and maximum is 8191 (all 1).
    </t>
    <t>
      Unlike IEEE754 half precision floating point (binary16), there is
      no sign bit (no negative value for a timer), exponent is not
      biased (no fractional value for a timer), no implicit leading 1 in
      siginificand, and base is 10. Therefore, there could be more than
      one representation for a value.
    </t>
    <t>
      Followings are examples of common timer values represented by unit
      of milliseconds.
    </t>
    <t><list style="hanging">
      <t hangText="One second (1,000 ms.):">
          
            exp = 3, significand = 1. 0x6001.
          
        </t>
      <t hangText="One minute (60,000 ms.):">
          
            exp = 4, significand = 6, 0x8006.
          
        </t>
      <t hangText="One hour (3,600,000 ms.):">
          
            exp = 5, significand = 36, 0xa024.
          
        </t>
      <t hangText="One day (86,400,000 ms.):">
          
            exp = 5, significand = 864, 0xa360
          
        </t>
    </list></t>
    <t>
      Maximum timer length represented by unsigned short floating point
      with millisecond precision is 8191*10^6 milliseconds (13 weeks 3
      days 19 hours 16 minutes 40 seconds).
    </t>
    <t>
      With exponent and significand, an unsigned short floating point
      (usfp) can be encoded as follows.
    </t>
    <figure><artwork>
usfp = (exponent &lt;&lt; 13)|(0x1fff &amp; significand);
</artwork></figure>
  </section>
  <section title="MPL Parameter Configuration Option Format" anchor="mpl-parameter-configuration-option-format">
    
    <t>
      To distribute a configuration of an MPL domain or a default value
      for all MPL domains (wildcard) under the network managed by the
      DHCP server, this document defines a DHCPv6 option format as
      follows. Short floating point format is used to describe wide
      range of timer values.
    </t>
    <figure><artwork>
 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|    OPTION_MPL_PARAMETERS      |          option_len           |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|P| Z |   C_K   | Z2  |  DM_K   |         SE_LIFETIME           |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|         DM_IMIN               |          DM_IMAX              |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|         DM_T_EXP              |          C_IMIN               |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|         C_IMAX                |          C_T_EXP              |     
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

(if option_len = 32 )
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|          MPL Domain Address  (128bits)                        |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|          (cont'ed)                                            |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|          (cont'ed)                                            |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|          (cont'ed)                                            |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
</artwork></figure>
    <t><list style="hanging">
      <t hangText="OPTION_MPL_PARAMETERS:">
          
            not yet assigned.
          
        </t>
      <t hangText="option_len:">
          
            Length of the option. It SHOULD be 16 (without MPL domain
            address) or 32 (with MPL domain address)
          
        </t>
      <t hangText="P (1 bit):">
          
            A flag to indicate PROACTIVE_FORWARDING
          
        </t>
      <t hangText="Z (1 bit)">
          
            Reserved. Should be 0.
          
        </t>
      <t hangText="C_K (5 bits):">
          
            Value of CONTROL_MESSAGE_K.
          
        </t>
      <t hangText="Z2 (3 bit)">
          
            Reserved. Should be all 0.
          
        </t>
      <t hangText="DM_K (5 bits):">
          
            Value of DATA_MESSAGE_K.
          
        </t>
      <t hangText="SE_LIFETIME:">
          
            SEED_SET_ENTRY_LIFETIME. The value is milliseconds in
            unsigned short floating point.
          
        </t>
      <t hangText="DM_IMIN:">
          
            Value of DATA_MESSAGE_IMIN. The value is milliseconds in
            unsigned short floating point.
          
        </t>
      <t hangText="DM_IMAX:">
          
            Value of DATA_MESSAGE_IMAX. The value is milliseconds in
            unsigned short floating point.
          
        </t>
      <t hangText="DM_T_EXP:">
          
            Value of DATA_MESSAGE_TIMER_EXPIRATIONS. The value is
            milliseconds in unsigned short floating point.
          
        </t>
      <t hangText="C_IMIN:">
          
            Value of CONTROL_MESSAGE_IMIN. The value is milliseconds in
            unsigned short floating point.
          
        </t>
      <t hangText="C_IMAX:">
          
            Value of CONTROL_MESSAGE_IMAX. The value is milliseconds in
            unsigned short floating point.
          
        </t>
      <t hangText="C_T_EXP:">
          
            Value of CONTROL_MESSAGE_TIMER_EXPIRATIONS. The value is
            milliseconds in unsigned short floating point.
          
        </t>
    </list></t>
  </section>
  <section title="DHCPv6 Client Behavior" anchor="dhcpv6-client-behavior">
    
    <t>
      Clients MAY request MPL Parameter Configuration Option, as
      described in <xref target="RFC3315">RFC3315</xref>, sections
      17.1.1, 18.1.1, 18.1.3, 18.1.4, 18.1.5 and 22.7. As a convenience
      to the reader, we mention here that the client includes requested
      option codes in Option Request Option.
    </t>
    <t>
      Clients MUST discard MPL Parameter Configuration Option if it is
      invalid (i.e. it sets reserved bits or it has timers with reserved
      exp=7 in Unsigned Short Floating Point).
    </t>
  </section>
  <section title="MPL Forwarder Behavior" anchor="mpl-forwarder-behavior">
    
    <t>
      If a DHCPv6 client requests and receives MPL parameter
      configuration option, the node SHOULD join the MPL domain given by
      the option and act as an MPL forwarder. Nodes SHOULD configure MPL
      forwarders with the given parameters when it joins to the MPL
      domain.
    </t>
    <t>
      The priority of MPL Parameter configuration applied for an MPL
      Domain is as follows (high to low).
    </t>
    <t><list style="symbols">
      <t>
        
          Specific MPL Parameter Configuration to the MPL Domain
          (optlen=32)
        
      </t>
      <t>
        
          Wildcard MPL Parameter Configuration (optlen=16)
        
      </t>
      <t>
        
          Default configuration given in the MPL specification.
        
      </t>
    </list></t>
    <t>
      There SHALL be no more than one MPL parameter configuration option
      for a MPL domain or the wildcard. Thus, the order of DHCPv6 option
      in the packet has no effect on precedence.
    </t>
    <t>
      A node MAY leave from an MPL domain if the node is attached to the
      MPL domain according to previously received MPL parameter
      configuration option, and, the node received updated MPL parameter
      configuration option without specific configuration option for the
      MPL domain.
    </t>
    <t>
      MPL parameter may be updated occasionally. With stateful DHCPv6,
      updates can be done when the renewal timer expires. However, on
      stateless DHCPv6 there are no way to update the parameters
      properly. There is a DHCPv6 option to push updates
      <xref target="I-D.jiang-dhc-stateless-reconfiguration"/>.
    </t>
  </section>
  <section title="DHCPv6 Server Behavior" anchor="dhcpv6-server-behavior">
    
    <t>
      Sections 17.2.2 and 18.2 of <xref target="RFC3315">RFC3315</xref>
      govern server operation in regards to option assignment. As a
      convenience to the reader, we mention here that the server will
      send MPL Parameter Configuration Option only if configured with
      specific value for MPL Parameter Configuration Option and the
      client requested it.
    </t>
    <t>
      Servers MUST ignore incoming MPL Parameter Configuration Option.
    </t>
  </section>
  <section title="DHCPv6 Relay Behavior" anchor="dhcpv6-relay-behavior">
    
    <t>
      It's never appropriate for a relay agent to add options to a
      message heading toward the client, and relay agents don't actually
      construct Relay-Reply messages anyway. There are no additional
      requirements for relays.
    </t>
  </section>
</section>
<section title="IANA Considerations" anchor="iana-considerations">
  
  <t>
    A DHCPv6 option code for MPL Parameter Configuration Option needs to
    be assigned from IANA.
  </t>
</section>
<section title="Security Considerations" anchor="security-considerations">
  
  <t>
    Forged option may cause too many MAC broadcasting. Reasonable bound
    of parameters (not too high K, not too low IMIN) may be defined by
    implementations or derived from MAC/PHY specifications. DHCP server
    or the network itself shall be trusted by some means including
    network access control or DHCP authentications.
  </t>
</section>

  </middle>

  <back>
    <references title="Normative References">
<?xml version='1.0' encoding='UTF-8'?>

<reference anchor='RFC3315'>

<front>
<title>Dynamic Host Configuration Protocol for IPv6 (DHCPv6)</title>
<author initials='R.' surname='Droms' fullname='R. Droms'>
<organization /></author>
<author initials='J.' surname='Bound' fullname='J. Bound'>
<organization /></author>
<author initials='B.' surname='Volz' fullname='B. Volz'>
<organization /></author>
<author initials='T.' surname='Lemon' fullname='T. Lemon'>
<organization /></author>
<author initials='C.' surname='Perkins' fullname='C. Perkins'>
<organization /></author>
<author initials='M.' surname='Carney' fullname='M. Carney'>
<organization /></author>
<date year='2003' month='July' /></front>

<seriesInfo name='RFC' value='3315' />
<format type='TXT' octets='231402' target='http://www.rfc-editor.org/rfc/rfc3315.txt' />
</reference>
      <!-- ?rfc include="refs/reference.RFC.6282.xml"? -->
<?xml version='1.0' encoding='UTF-8'?>

<reference anchor='I-D.ietf-roll-trickle-mcast'>
<front>
<title>Multicast Forwarding Using Trickle</title>

<author initials='J' surname='Hui' fullname='Jonathan Hui'>
    <organization />
</author>

<author initials='R' surname='Kelsey' fullname='Richard Kelsey'>
    <organization />
</author>

<date month='Feburary' day='25' year='2013' />

<abstract><t> This document specifies the Multicast Protocol for Low power and Lossy Networks (MPL) that provides IPv6 multicast forwarding in constrained networks.  MPL avoids the need to construct or maintain any multicast forwarding topology, disseminating messages to all MPL Forwarders in an MPL Domain.  MPL uses the Trickle algorithm to manage message transmissions for both control and data-plane messages.  Different Trickle parameter configurations allow MPL to trade between dissemination latency and transmission efficiency.  </t></abstract>
</front>

<seriesInfo name='Internet-Draft' value='draft-ietf-roll-trickle-mcast-04' />
<format type='TXT'
        target='http://www.ietf.org/internet-drafts/draft-ietf-roll-trickle-mcast-04.txt' />
</reference>
    </references>
    <references title="Non-Normative References">
<?xml version="1.0" encoding="UTF-8"?>
<reference anchor="I-D.jiang-dhc-stateless-reconfiguration">
<front>
<title>Stateless Reconfiguration in Dynamic Host Configuration Protocol for IPv6 (DHCPv6)</title>

<author initials="S" surname="Jiang" fullname="Sheng Jiang">
    <organization/>
</author>

<author initials="B" surname="Liu" fullname="Bing Liu">
    <organization/>
</author>

<date month="October" day="7" year="2013"/>

<abstract><t>This document defines a mechanism to propagate reconfigure messages towards stateless configured DHCPv6 clients.</t></abstract>

</front>

<seriesInfo name="Internet-Draft" value="draft-jiang-dhc-stateless-reconfiguration-00"/>
<format type="TXT" target="http://www.ietf.org/internet-drafts/draft-jiang-dhc-stateless-reconfiguration-00.txt"/>
</reference>    </references>
<!-- This document was prepared using Pandoc2rfc, https://github.com/miekg/pandoc2rfc -->

  
<section title="Update History" anchor="update-history">
  
  <t>
    Updates on 03 to 04:
  </t>
  <t><list style="symbols">
    <t>
      
        Added more sections according to dhc-options-guidelines
      
    </t>
    <t>
      
        Removed 'no update' requirement on MPL forwarder behavior
      
    </t>
    <t>
      
        Added reference to I-D.jiang-dhc-stateless-reconfiguration
      
    </t>
  </list></t>
  <t>
    Updates on 02 to 03:
  </t>
  <t><list style="symbols">
    <t>
      
        C flag is removed and wildcard shall be identified by optlen
      
    </t>
    <t>
      
        Added some description on update of MPL parameters
      
    </t>
    <t>
      
        Clearly stated there shall not be two or more configuration for
        an MPL domain and option order is not significant.
      
    </t>
  </list></t>
  <t>
    Updates on 01 to 02:
  </t>
  <t><list style="symbols">
    <t>
      
        Added co-author
      
    </t>
  </list></t>
  <t>
    Updates on 00 to 01:
  </t>
  <t><list style="symbols">
    <t>
      
        Corrected target area, track, etc.
      
    </t>
  </list></t>
</section>
<section title="Acknowledgements" anchor="acknowledgements">
  
  <t>
    The authors thank Richard Kelsey and Yoshi Ohba for technical
    advices to improve this draft.
  </t>
</section>

  </back>
</rfc>
