Active DHCPv4 Lease Query
RFC 7724

Document Type RFC - Proposed Standard (December 2015; No errata)
Updates RFC 6926
Last updated 2015-12-18
Replaces draft-kinnear-dhc-dhcpv4-active-leasequery
Stream IETF
Formats plain text pdf html bibtex
Stream WG state Submitted to IESG for Publication
Document shepherd Tomek Mrugalski
Shepherd write-up Show (last changed 2015-08-12)
IESG IESG state RFC 7724 (Proposed Standard)
Consensus Boilerplate Yes
Telechat date
Responsible AD Brian Haberman
Send notices to (None)
IANA IANA review state Version Changed - Review Needed
IANA action state RFC-Ed-Ack
Internet Engineering Task Force (IETF)                        K. Kinnear
Request for Comments: 7724                                      M. Stapp
Updates: 6926                                                    B. Volz
Category: Standards Track                                  Cisco Systems
ISSN: 2070-1721                                               N. Russell
                                                                 Staples
                                                           December 2015

                       Active DHCPv4 Lease Query

Abstract

   The Dynamic Host Configuration Protocol for IPv4 (DHCPv4) has been
   extended with a Leasequery capability that allows a requestor to
   request information about DHCPv4 bindings (RFC 4388).  That mechanism
   is limited to queries for individual bindings.  In some situations,
   individual binding queries may not be efficient, or even possible.
   In addition, continuous update of an external requestor with
   Leasequery data is sometimes desired.  This document expands on the
   DHCPv4 Leasequery protocol, and allows for active transfer of near
   real-time DHCPv4 binding information data via TCP.  This document
   updates RFC 6926, "DHCPv4 Bulk Leasequery".

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/rfc7724.

Kinnear, et al.              Standards Track                    [Page 1]
RFC 7724                Active DHCPv4 Lease Query          December 2015

Copyright Notice

   Copyright (c) 2015 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.

Kinnear, et al.              Standards Track                    [Page 2]
RFC 7724                Active DHCPv4 Lease Query          December 2015

Table of Contents

   1.  Introduction  . . . . . . . . . . . . . . . . . . . . . . . .   3
   2.  Terminology . . . . . . . . . . . . . . . . . . . . . . . . .   4
   3.  Protocol Overview . . . . . . . . . . . . . . . . . . . . . .   6
   4.  Interaction Between Active Leasequery and Bulk Leasequery . .   8
   5.  Message and Option Definitions  . . . . . . . . . . . . . . .   9
     5.1.  Message Framing for TCP . . . . . . . . . . . . . . . . .   9
     5.2.  New or Changed Options  . . . . . . . . . . . . . . . . .   9
       5.2.1.  dhcp-message-type . . . . . . . . . . . . . . . . . .  10
       5.2.2.  dhcp-status-code  . . . . . . . . . . . . . . . . . .  10
     5.3.  Connection and Transmission Parameters  . . . . . . . . .  11
   6.  Information Communicated by Active Leasequery . . . . . . . .  11
   7.  Requestor Behavior  . . . . . . . . . . . . . . . . . . . . .  12
     7.1.  General Processing  . . . . . . . . . . . . . . . . . . .  12
     7.2.  Initiating a Connection . . . . . . . . . . . . . . . . .  13
     7.3.  Forming an Active Leasequery  . . . . . . . . . . . . . .  14
     7.4.  Processing Active Replies . . . . . . . . . . . . . . . .  15
       7.4.1.  Processing Replies from a Request Containing a
               query-start-time  . . . . . . . . . . . . . . . . . .  17
     7.5.  Closing Connections . . . . . . . . . . . . . . . . . . .  19
   8.  Server Behavior . . . . . . . . . . . . . . . . . . . . . . .  19
     8.1.  Accepting Connections . . . . . . . . . . . . . . . . . .  19
       8.1.1.  Update to RFC 6926  . . . . . . . . . . . . . . . . .  21
     8.2.  Replying to an Active Leasequery  . . . . . . . . . . . .  21
     8.3.  Multiple or Parallel Queries  . . . . . . . . . . . . . .  23
     8.4.  Closing Connections . . . . . . . . . . . . . . . . . . .  24
   9.  Security Considerations . . . . . . . . . . . . . . . . . . .  24
   10. IANA Considerations . . . . . . . . . . . . . . . . . . . . .  25
Show full document text