Internet Engineering Task Force (IETF) R. Droms Request for Comments: 7083 Cisco Systems Updates: 3315 November 2013 Category: Standards Track ISSN: 2070-1721 Modification to Default Values of SOL_MAX_RT and INF_MAX_RT Abstract This document updates RFC 3315 by redefining the default values for SOL_MAX_RT and INF_MAX_RT and defining options through which a DHCPv6 server can override the client's default value for SOL_MAX_RT and INF_MAX_RT with new values. Status of This Memo This is an Internet Standards Track document. This document is a product of the Internet Engineering Task Force (IETF). It represents the consensus of the IETF community. It has received public review and has been approved for publication by the Internet Engineering Steering Group (IESG). Further information on Internet Standards is available in Section 2 of RFC 5741. Information about the current status of this document, any errata, and how to provide feedback on it may be obtained at http://www.rfc-editor.org/info/rfc7083. Copyright Notice Copyright (c) 2013 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. Code Components extracted from this document must include Simplified BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Simplified BSD License. Droms Standards Track [Page 1] RFC 7083 DHCPv6 SOL_MAX_RT Option November 2013 Table of Contents 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 2 2. Requirements Language . . . . . . . . . . . . . . . . . . . . 2 3. Updates to SOL_MAX_RT and INF_MAX_RT in RFC 3315 . . . . . . 2 4. SOL_MAX_RT option . . . . . . . . . . . . . . . . . . . . . . 3 5. INF_MAX_RT Option . . . . . . . . . . . . . . . . . . . . . . 4 6. Updates for SOL_MAX_RT and INF_MAX_RT Options to RFC 3315 . . 4 7. DHCPv6 Client Behavior . . . . . . . . . . . . . . . . . . . 5 8. DHCPv6 Server Behavior . . . . . . . . . . . . . . . . . . . 6 9. DHCPv6 Relay Agent Behavior . . . . . . . . . . . . . . . . . 6 10. Security Considerations . . . . . . . . . . . . . . . . . . . 6 11. Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . 7 12. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 7 13. References . . . . . . . . . . . . . . . . . . . . . . . . . 7 13.1. Normative References . . . . . . . . . . . . . . . . . . 7 13.2. Informative References . . . . . . . . . . . . . . . . . 7 1. Introduction Section 5.5 of the DHCPv6 specification [RFC3315] defines the default values of SOL_MAX_RT and INF_MAX_RT to be 120 seconds. In some circumstances, these defaults will lead to an unacceptably high volume of aggregated traffic at a DHCPv6 server. The change to SOL_MAX_RT is in response to DHCPv6 message rates observed on a DHCPv6 server in a deployment in which many DHCPv6 clients are sending Solicit messages, but the DHCPv6 server has been configured not to respond to those Solicit messages. While no explicit observations of traffic due to INF_MAX_RT have been conducted, this document updates INF_MAX_RT for consistency with SOL_MAX_RT. 2. Requirements Language 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]. 3. Updates to SOL_MAX_RT and INF_MAX_RT in RFC 3315 This document changes Section 5.5 of RFC 3315 as follows: OLD: SOL_MAX_RT 120 secs Max Solicit timeout value NEW: SOL_MAX_RT 3600 secs Max Solicit timeout value Droms Standards Track [Page 2] RFC 7083 DHCPv6 SOL_MAX_RT Option November 2013 OLD: INF_MAX_RT 120 secs Max Information-request timeout value NEW: INF_MAX_RT 3600 secs Max Information-request timeout value With this change, a DHCPv6 client that does not receive a satisfactory response will send Solicit or Information-request messages with the same initial frequency and exponential backoff as specified in Sections 17.1.2 and 18.1.5 of RFC 3315. However, the long-term behavior of these DHCPv6 clients will be to send a Solicit or Information-request message every 3600 seconds rather than every 120 seconds, significantly reducing the aggregated traffic at the DHCPv6 server. 4. SOL_MAX_RT option A DHCPv6 server sends the SOL_MAX_RT option to a client to override the default value of SOL_MAX_RT. The value of SOL_MAX_RT in the option replaces the default value defined in Section 3. One use for the SOL_MAX_RT option is to set a longer value for SOL_MAX_RT, which reduces the Solicit traffic from a client that has not received a response to its Solicit messages. The format of the SOL_MAX_RT option is: 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-code | option-len | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | SOL_MAX_RT value | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ option-code OPTION_SOL_MAX_RT (82) option-len 4 SOL_MAX_RT value Overriding value for SOL_MAX_RT in seconds; MUST be in range: 60 <= "value" <= 86400 (1 day) Figure 1: SOL_MAX_RT Option Format Droms Standards Track [Page 3] RFC 7083 DHCPv6 SOL_MAX_RT Option November 2013 5. INF_MAX_RT Option A DHCPv6 server sends the INF_MAX_RT option to a client to override the default value of INF_MAX_RT. The value of INF_MAX_RT in the option replaces the default value defined in Section 3. One use for the INF_MAX_RT option is to set a longer value for INF_MAX_RT, which reduces the Information-request traffic from a client that has not received a response to its Information-request messages. The format of the INF_MAX_RT option is: 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-code | option-len | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | INF_MAX_RT value | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ option-code OPTION_INF_MAX_RT (83) option-len 4 INF_MAX_RT value Overriding value for INF_MAX_RT in seconds; MUST be in range: 60 <= "value" <= 86400 (1 day) Figure 2: INF_MAX_RT Option Format 6. Updates for SOL_MAX_RT and INF_MAX_RT Options to RFC 3315 Update to RFC 3315, Section 17.1.3: OLD: The client MUST ignore any Advertise message that includes a Status Code option containing the value NoAddrsAvail, with the exception that the client MAY display the associated status message to the user. NEW: The client MUST ignore any Advertise message that includes a Status Code option containing the value NoAddrsAvail, with the exception that the client MUST process an included SOL_MAX_RT option, MUST process an included INF_MAX_RT option, and MAY display the associated status message to the user. Droms Standards Track [Page 4] RFC 7083 DHCPv6 SOL_MAX_RT Option November 2013 Update to RFC 3315, Section 17.2.2: OLD: If the server will not assign any addresses to any IAs in a subsequent Request from the client, the server MUST send an Advertise message to the client that includes only a Status Code option with code NoAddrsAvail and a status message for the user, a Server Identifier option with the server's DUID, and a Client Identifier option with the client's DUID. NEW: If the server will not assign any addresses to any IAs in a subsequent Request from the client, the server MUST send an Advertise message to the client that includes only a Status Code option with code NoAddrsAvail and a status message for the user, a Server Identifier option with the server's DUID, a Client Identifier option with the client's DUID, and (optionally) SOL_MAX_RT and/or INF_MAX_RT options. Update to RFC 3315, Section 14 (Add text, clarifying client behavior while waiting for a response from a server): NEW: A client is not expected to listen for a response during the entire period between transmission of Solicit or Information-request messages. 7. DHCPv6 Client Behavior A DHCPv6 client MUST include the SOL_MAX_RT option code in any Option Request option [RFC3315] it sends as required by RFC 3315. A DHCPv6 client MUST include the INF_MAX_RT option code in any Option Request option it sends as required by RFC 3315. A DHCPv6 client MUST silently ignore any SOL_MAX_RT or INF_MAX_RT option values that are less than 60 or more than 86400. If a DHCPv6 client receives a message containing a SOL_MAX_RT option that has a valid value for SOL_MAX_RT, the client MUST set its internal SOL_MAX_RT parameter to the value contained in the SOL_MAX_RT option. This value of SOL_MAX_RT is then used by the retransmission mechanism defined in Sections 14 and 17.1.2 of RFC 3315. Droms Standards Track [Page 5] RFC 7083 DHCPv6 SOL_MAX_RT Option November 2013 If a DHCPv6 client receives a message containing an INF_MAX_RT option that has a valid value for INF_MAX_RT, the client MUST set its internal INF_MAX_RT parameter to the value contained in the INF_MAX_RT option. This value of INF_MAX_RT is then used by the retransmission mechanism defined in Sections 14 and 18.1.5 of RFC 3315. Updated SOL_MAX_RT and INF_MAX_RT values apply only to the network interface on which the client received SOL_MAX_RT and/or INF_MAX_RT options. 8. DHCPv6 Server Behavior Sections 17.2.2 and 18.2 of RFC 3315 govern server operation in regard to option assignment. As a convenience to the reader, we mention here that the server will send options SOL_MAX_RT and INF_MAX_RT only if configured with specific values for them, and the client requested those options using the Option Request option. The DHCPv6 server MAY include the SOL_MAX_RT option in any response it sends to a client that has included the SOL_MAX_RT option code in an Option Request option. The SOL_MAX_RT option is sent in the main body of the message to client, not as an encapsulated option in, e.g., an IA_NA, IA_TA [RFC3315], or IA_PD [RFC3633] option. The DHCPv6 server MAY include the INF_MAX_RT option in any response it sends to a client that has included the INF_MAX_RT option code in an Option Request option. The INF_MAX_RT option is sent in the main body of the message to client, not as an encapsulated option in, e.g., an IA_NA, IA_TA, or IA_PD option. 9. DHCPv6 Relay Agent Behavior There are no additional requirements for relays. 10. Security Considerations This document introduces one security consideration beyond those described in RFC 3315. A malicious DHCPv6 server might cause a client to set its SOL_MAX_RT and INF_MAX_RT parameters to an unreasonably high value with the SOL_MAX_RT and INF_MAX_RT options, which may cause an undue delay in a client completing its DHCPv6 protocol transaction in the case no other valid response is received. Assuming the client also receives a response from a valid DHCPv6 server, large values for SOL_MAX_RT and INF_MAX_RT will not have any effect. Droms Standards Track [Page 6] RFC 7083 DHCPv6 SOL_MAX_RT Option November 2013 11. Acknowledgments Tomek Mrugalski edited the text for compliance with "Guidelines for Creating New DHCPv6 Options" [DHC-OPTION] and added important details to the Security Considerations section. 12. IANA Considerations IANA has assigned one option code each for OPTION_SOL_MAX_RT (82) and OPTION_INF_MAX_RT (83) from the "DHCP Option Codes" table of the "Dynamic Host Configuration Protocol for IPv6 (DHCPv6)" registry. 13. References 13.1. Normative References [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997. [RFC3315] Droms, R., Bound, J., Volz, B., Lemon, T., Perkins, C., and M. Carney, "Dynamic Host Configuration Protocol for IPv6 (DHCPv6)", RFC 3315, July 2003. 13.2. Informative References [DHC-OPTION] Hankins, D., Mrugalski, T., Siodelski, M., Jiang, S., and S. Krishnan, "Guidelines for Creating New DHCPv6 Options", Work in Progress, September 2013. [RFC3633] Troan, O. and R. Droms, "IPv6 Prefix Options for Dynamic Host Configuration Protocol (DHCP) version 6", RFC 3633, December 2003. Author's Address Ralph Droms Cisco Systems 1414 Massachusetts Avenue Boxborough, MA 01719 USA Phone: +1 978 936 1674 EMail: rdroms@cisco.com Droms Standards Track [Page 7]