Internet DRAFT - draft-stapp-dhc-dhcpv6-bulk-leasequery
draft-stapp-dhc-dhcpv6-bulk-leasequery
DHC M. Stapp
Internet-Draft Cisco Systems, Inc.
Expires: April 14, 2008 October 12, 2007
DHCPv6 Bulk Leasequery
draft-stapp-dhc-dhcpv6-bulk-leasequery-00.txt
Status of this Memo
By submitting this Internet-Draft, each author represents that any
applicable patent or other IPR claims of which he or she is aware
have been or will be disclosed, and any of which he or she becomes
aware will be disclosed, in accordance with Section 6 of BCP 79.
Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF), its areas, and its working groups. Note that
other groups may also distribute working documents as Internet-
Drafts.
Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress."
The list of current Internet-Drafts can be accessed at
http://www.ietf.org/ietf/1id-abstracts.txt.
The list of Internet-Draft Shadow Directories can be accessed at
http://www.ietf.org/shadow.html.
This Internet-Draft will expire on April 14, 2008.
Copyright Notice
Copyright (C) The IETF Trust (2007).
Abstract
The Dynamic Host Configuration Protocol for IPv6 (DHCPv6) has been
extended with a Leasequery capability that allows a client to request
information about DHCPv6 bindings. That mechanism is limited to
queries for individual bindings. In some situations individual
binding queries may not be efficient, or even possible. This
document specifies extensions to the Leasequery protocol that add new
query types and allow for bulk DHCPv6 binding data transfer.
Stapp Expires April 14, 2008 [Page 1]
Internet-Draft DHCPv6 Bulk Leasequery October 2007
Table of Contents
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3
2. Terminology . . . . . . . . . . . . . . . . . . . . . . . . . 3
3. Protocol Overview . . . . . . . . . . . . . . . . . . . . . . 4
4. Message and Option Definitions . . . . . . . . . . . . . . . . 4
4.1. Message Framing for TCP . . . . . . . . . . . . . . . . . 5
4.2. Messages . . . . . . . . . . . . . . . . . . . . . . . . . 5
4.2.1. LEASEQUERY-DATA . . . . . . . . . . . . . . . . . . . 5
4.2.2. LEASEQUERY-DONE . . . . . . . . . . . . . . . . . . . 6
4.3. Query Types . . . . . . . . . . . . . . . . . . . . . . . 6
4.3.1. QUERY_BY_RELAYID . . . . . . . . . . . . . . . . . . . 6
4.3.2. QUERY_BY_LINK_ADDRESS . . . . . . . . . . . . . . . . 7
4.3.3. QUERY_BY_REMOTE_ID . . . . . . . . . . . . . . . . . . 7
4.4. Options . . . . . . . . . . . . . . . . . . . . . . . . . 7
4.4.1. Relay-ID Option . . . . . . . . . . . . . . . . . . . 7
4.5. Status Codes . . . . . . . . . . . . . . . . . . . . . . . 8
4.6. Connection and Transmission Parameters . . . . . . . . . . 8
5. Requestor Behavior . . . . . . . . . . . . . . . . . . . . . . 9
5.1. Connecting . . . . . . . . . . . . . . . . . . . . . . . . 9
5.2. Forming Queries . . . . . . . . . . . . . . . . . . . . . 9
5.3. Processing Replies . . . . . . . . . . . . . . . . . . . . 9
5.4. Querying Multiple Servers . . . . . . . . . . . . . . . . 10
5.5. Multiple Queries to a Single Server . . . . . . . . . . . 10
5.6. Closing Connections . . . . . . . . . . . . . . . . . . . 10
6. Server Behavior . . . . . . . . . . . . . . . . . . . . . . . 11
6.1. Accepting Connections . . . . . . . . . . . . . . . . . . 11
6.2. Forming Replies . . . . . . . . . . . . . . . . . . . . . 11
6.3. Multiple or Parallel Queries . . . . . . . . . . . . . . . 12
6.4. Closing Connections . . . . . . . . . . . . . . . . . . . 13
7. Security Considerations . . . . . . . . . . . . . . . . . . . 13
8. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 13
9. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . 14
10. Modification History . . . . . . . . . . . . . . . . . . . . . 14
11. References . . . . . . . . . . . . . . . . . . . . . . . . . . 14
11.1. Normative References . . . . . . . . . . . . . . . . . . . 14
11.2. Informative References . . . . . . . . . . . . . . . . . . 15
Author's Address . . . . . . . . . . . . . . . . . . . . . . . . . 15
Intellectual Property and Copyright Statements . . . . . . . . . . 16
Stapp Expires April 14, 2008 [Page 2]
Internet-Draft DHCPv6 Bulk Leasequery October 2007
1. Introduction
The DHCPv6 [1] protocol specifies a mechanism for the assignment of
IPv6 address and configuration information to IPv6 nodes. IPv6
Prefix Delegation for DHCPv6 (PD) [2] specifies a mechanism for
DHCPv6 delegation of IPv6 prefixes and related data. DHCPv6 servers
maintain authoritative information including binding information for
delegated IPv6 prefixes.
The client of a PD binding is typically a router, which then
advertises the delegated prefix to locally-connected hosts. The
delegated IPv6 prefix must be routeable in order to be useful. The
actual DHCPv6 PD client may not be permitted to inject routes into
the delegating network. In service-provider (SP) networks, for
example, an edge router typically acts as a DHCPv6 relay agent, and
this edge router often has the responsibility to maintain routes
within the service-provider network for clients' PD bindings.
A DHCPv6 relay with this responsibility requires a means to recover
binding information from the authoritative DHCPv6 server(s) in the
event of replacement or reboot, in order to restore routeability to
delegated prefixes. The relay may be a network device without
adequate local storage to maintain the necessary binding-to-route
data. A DHCPv6 Leasequery protocol [6] has been developed that
allows queries for individual bindings from the authoritative DHCPv6
Server(s). The individual query mechanism is only useable when the
target binding is known to the requestor. In the case of DHCPv6
Prefix Delegation, the PD binding data may need to be known before
any traffic arrives from the client router. The DHCPv6 relay router
may not be able to form individual queries in such cases.
This document extends the DHCPv6 Leasequery protocol to add support
for queries that address these requirements. At the SP edge there
may be many thousands of delegated prefixes per relay, so we specify
the use of TCP [3] for efficiency of data transfer. We specify a new
DHCPv6 option, the Relay Identifier option, to support efficient
recovery of all data associated with a specific relay agent; we also
add a query-type for this purpose. We add query-types by network
segment and by Remote-ID option value, to assist a relay that needs
to recover a subset of its clients' bindings.
2. Terminology
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 [4].
Stapp Expires April 14, 2008 [Page 3]
Internet-Draft DHCPv6 Bulk Leasequery October 2007
DHCPv6 terminology is defined in [1]. DHCPv6 Leasequery terminology
is defined in [6].
3. Protocol Overview
The Bulk Leasequery mechanism is modeled on the existing individual
Leasequery protocol; most differences arise from the use of TCP. A
Bulk Leasequery client opens a TCP connection to a DHCPv6 Server,
using the DHCPv6 port 547. The client sends a LEASEQUERY message,
containing a query-type and data about bindings it is interested in.
The server uses the query-type and the data to identify any relevant
bindings. The server replies with a LEASEQUERY-REPLY message,
indicating the success or failure of the query. If the query was
successful, the server includes the first client's binding data in
the LEASEQUERY-REPLY message also. If more than one client's
bindings are being returned, the server then transmits the additional
client bindings in a series of LEASEQUERY-DATA messages. If the
server has sent at least one client's bindings, it sends a
LEASEQUERY-DONE message when it has finished sending its replies.
Each end of the TCP connection can be closed after all data has been
sent.
This specification includes a new DHCPv6 option, the Relay-ID option.
The option contains a DUID identifying a DHCPv6 relay agent. Relay
agents can include this option in Relay-Forward messages they send.
Servers can retain the Relay-ID and associate it with bindings made
on behalf of the relay's clients. A relay can then recover binding
information about downstream clients by using the Relay-ID in a
LEASEQUERY message. The Relay-ID option is defined in Section 4.4.1.
Bulk Leasequery supports the queries by IPv6 address and by Client
DUID as specified in [6], and adds the following new query types:
Query by Relay Identifier - This query asks a server for the
bindings associated with a specific relay; the relay is identified
by a DUID carried in a Relay-ID option.
Query by Link Address - This query asks a server for the bindings on
a particular network segment; the link is specified in the query's
link-address field.
Query by Remote ID - This query asks a server for the bindings
associated with a Relay Agent Remote-ID option [5] value.
4. Message and Option Definitions
Stapp Expires April 14, 2008 [Page 4]
Internet-Draft DHCPv6 Bulk Leasequery October 2007
4.1. Message Framing for TCP
The use of TCP for the Bulk Leasequery protocol permits one or more
DHCPv6 messages to be sent at a time. The receiver needs to be able
to determine how large each message is. Two octets containing the
message size in network byte-order are prepended to each DHCPv6
message sent on a Bulk Leasequery TCP connection. The two message-
size octets 'frame' each DHCPv6 message.
DHCPv6 message framed for TCP:
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
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| message-size | msg-type | trans-id |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| transaction-id (cont'd) | |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| .
. options .
. (variable) .
| |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
message-size the number of octets in the message that
follows, as a 16-bit integer in network
byte-order.
All other fields are as specified in DHCPv6 [1].
4.2. Messages
The LEASEQUERY and LEASEQUERY-REPLY messages are defined in [6]. In
a Bulk Leasequery exchange, a single LEASEQUERY-REPLY message is used
to indicate the success or failure of a query, and to carry data that
do not change in the context of a single query and answer, such as
the Server-ID and Client-ID options. If a query is successful, only
a single LEASEQUERY-REPLY message MUST appear. If the server is
returning binding data, the LEASEQUERY-REPLY also contains the first
client's binding data in an OPTION_CLIENT_DATA option.
4.2.1. LEASEQUERY-DATA
The LEASEQUERY-DATA message (message type TBD) carries data about a
single DHCPv6 client's leases and/or PD bindings on a single link.
Stapp Expires April 14, 2008 [Page 5]
Internet-Draft DHCPv6 Bulk Leasequery October 2007
The purpose of the message is to reduce redundant data when there are
multiple bindings to be sent. The LEASEQUERY-DATA message MUST be
preceded by a LEASEQUERY-REPLY message. The LEASEQUERY-REPLY conveys
the query's status, carries the Leasequery's Client-ID and Server-ID
options, and carries the first client's binding data if the query was
successful.
LEASEQUERY-DATA MUST ONLY be sent in response to a successful
LEASEQUERY, and only if more than one client's data is to be sent.
The LEASEQUERY-DATA message's transaction-id field MUST match the
transaction-id of the LEASEQUERY request message. The Server-ID,
Client-ID, and OPTION_STATUS_CODE options SHOULD NOT be included:
that data should be constant for any one Bulk Leasequery reply, and
should have been conveyed in the LEASEQUERY-REPLY message.
4.2.2. LEASEQUERY-DONE
The LEASEQUERY-DONE message (message type TBD) indicates the end of a
group of related Leasequery replies. The LEASEQUERY-DONE message's
transaction-id field MUST match the transaction-id of the LEASEQUERY
request message. The presence of the message itself signals the end
of a stream of reply messages. A single LEASEQUERY-DONE MUST BE sent
after all replies to a successful Bulk Leasequery request that
returned at least one binding.
A server may encounter an error condition after it has sent the
initial LEASEQUERY-REPLY. In that case, it SHOULD attempt to send a
LEASEQUERY-DONE with an OPTION_STATUS_CODE option indicating the
error condition to the requestor. Other DHCPv6 options SHOULD NOT be
included in the LEASEQUERY-DONE message.
4.3. Query Types
The OPTION_LQ_QUERY option is defined in [6]. We introduce three new
query-types: QUERY_BY_RELAYID, QUERY_BY_LINK_ADDRESS, and
QUERY_BY_REMOTE_ID. These queries are designed to assist relay
agents in recovering binding data in circumstances where some or all
of the relay's binding data has been lost.
4.3.1. QUERY_BY_RELAYID
This query asks the server to return bindings associated with the
specified relay DUID.
Stapp Expires April 14, 2008 [Page 6]
Internet-Draft DHCPv6 Bulk Leasequery October 2007
QUERY_BY_RELAYID (3) - The query-options MUST contain an
OPTION_RELAYID option. If the link-address field is 0::0, the
query asks for all bindings associated with the specified relay
DUID. If the link-address is specified, the query asks for
bindings on that link.
4.3.2. QUERY_BY_LINK_ADDRESS
The QUERY_BY_LINK_ADDRESS asks the server to return bindings on a
network segment identified by an link-address value from a relay's
Relay-Forward message.
QUERY_BY_LINK_ADDRESS (4) - The query's link-address contains an
address a relay may have used in the link-address of a Relay-
Forward message. The Server attempts to locate bindings on the
same network segment as the link-address.
4.3.3. QUERY_BY_REMOTE_ID
The QUERY_BY_REMOTE_ID asks the server to return bindings associated
with a Remote-ID option value from a relay's Relay-Forward message.
The query-options MUST include a Relay-ID option.
In order to support this query, a server needs to record the most-
recent Remote-ID option value seen in a Relay-Forward message along
with its other binding data.
QUERY_BY_REMOTE_ID (5) - The query-options MUST include a Relay
Agent Remote-ID option. If the Server has recorded Remote-ID
values with its bindings, it uses the option's value to identify
bindings to return.
4.4. Options
4.4.1. Relay-ID Option
The Relay-ID option carries a DUID. A relay agent MAY include the
option in Relay-Forward messages it sends. Obviously, it will not be
possible for a server to respond to QUERY_BY_RELAYID queries unless
the relay agent has included this option. A relay SHOULD be able to
generate a DUID for this purpose, and capture the result in stable
storage. A relay SHOULD also allow the DUID value to be
configurable: doing so allows an administrator to replace a relay
agent while retaining the association between the relay and existing
DHCPv6 bindings.
A DHCPv6 Server MAY associate Relay-ID options from Relay-Forward
messages it processes with PD and/or lease bindings that result.
Stapp Expires April 14, 2008 [Page 7]
Internet-Draft DHCPv6 Bulk Leasequery October 2007
Doing so allows it to respond to QUERY_BY_RELAYID Leasequeries.
The format of the Relay-ID option is shown below:
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_RELAYID | option-len |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
. .
. DUID .
. (variable length) .
. .
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
option-code OPTION_RELAYID (TBD).
option-len Length of DUID in octets.
DUID The DUID for the relay agent.
4.5. Status Codes
TODO: are any new status codes needed - to indicate a connection or
resource problem e.g.?
4.6. Connection and Transmission Parameters
DHCPv6 Servers that support Bulk Leasequery SHOULD listen for
incoming TCP connections on the DHCPv6 server port 547.
Implementations MAY offer to make the incoming port configurable, but
port 547 MUST be the default. Client implementations SHOULD make TCP
connections to port 547, and MAY offer to make the destination server
port configurable.
This section presents a table of values used to control Bulk
Leasequery behavior, including recommended defaults. Implementations
MAY make these values configurable.
Parameter Default Description
------------------------------------------
BULK_LQ_CONN_TIMEOUT 30 secs Bulk Leasequery connection timeout
BULK_LQ_DATA_TIMEOUT 30 secs Bulk Leasequery data timeout
BULK_LQ_MAX_RETRY 60 secs Max Bulk Leasequery retry timeout value
BULK_LQ_MAX_CONNS 10 Max Bulk Leasequery TCP connections
Stapp Expires April 14, 2008 [Page 8]
Internet-Draft DHCPv6 Bulk Leasequery October 2007
5. Requestor Behavior
5.1. Connecting
A Requestor attempts to establish a TCP connection to a DHCPv6 Server
in order to initiate a Leasequery exchange. The Requestor SHOULD be
prepared to abandon the connection attempt after
BULK_LQ_CONN_TIMEOUT. If the attempt fails, the Requestor MAY retry.
Retries MUST use an exponential backoff timer, increasing the
interval between attempts up to BULK_LQ_MAX_RETRY.
5.2. Forming Queries
After a connection is established, the Requestor constructs a
Leasequery message, as specified in [6]. The query may have any of
the defined query-types, and includes the options and data required
by the query-type chosen. The Requestor sends the message size then
sends the actual DHCPv6 message, as described in Section 4.1.
If the TCP connection becomes blocked while the Requestor is sending
its query, the Requestor SHOULD be prepared to terminate the
connection after BULK_LQ_DATA_TIMEOUT. We make this recommendation
to allow Requestors to control the period of time they are willing to
wait before abandoning a connection, independent of notifications
from the TCP implementations they may be using.
5.3. Processing Replies
The Requestor attempts to read a LEASEQUERY-REPLY message from the
TCP connection. If the stream of replies becomes blocked, the
Requestor SHOULD be prepared to terminate the connection after
BULK_LQ_DATA_TIMEOUT, and MAY begin retry processing if configured to
do so.
The Requestor examines the LEASEQUERY-REPLY message, and determines
how to proceed. Message validation rules are specified in DHCPv6
Leasequery [6]. If the reply contains an error status code (carried
in an OPTION_STATUS_CODE option), the Requestor follows the
recommendations in [6]. A successful reply that does not include an
OPTION_CLIENT_DATA option indicates that the target server had no
bindings matching the query.
The Leasequery protocol uses the OPTION_CLIENT_LINK option as an
indicator that multiple bindings were present in response to a single
query. For Bulk Leasequery, the OPTION_CLIENT_LINK option is not
used, and MUST NOT be present in replies.
A successful LEASEQUERY-REPLY that is returning binding data includes
Stapp Expires April 14, 2008 [Page 9]
Internet-Draft DHCPv6 Bulk Leasequery October 2007
an OPTION_CLIENT_DATA option and possibly additional options. If
there are additional bindings to be returned, they will be carried in
LEASEQUERY-DATA messages. Each LEASEQUERY-DATA message contains an
OPTION_CLIENT_DATA option, and possibly other options. A LEASEQUERY-
DATA message that does not contain an OPTION_CLIENT_DATA MUST BE
discarded.
A single bulk query can result in a large number of replies. For
example, a single relay agent might be responsible for routes for
thousands of clients' delegated prefixes. The Requestor MUST be
prepared to receive more than one LEASEQUERY-DATA with transaction-
ids matching a single LEASEQUERY message.
The LEASEQUERY-DONE message ends a successful Bulk Leasequery session
that returned at least one binding. A LEASEQUERY-REPLY without any
bindings MUST NOT be followed by a LEASEQUERY-DONE message for the
same transaction-id. After receiving LEASEQUERY-DONE from a server,
the Requestor MAY close the TCP connection to that server. If the
transaction-id in the LEASEQUERY-DONE does not match an outstanding
LEASEQUERY message, the client MUST close the TCP connection.
5.4. Querying Multiple Servers
A Bulk Leasequery client MAY be configured to attempt to connect to
and query from multiple DHCPv6 servers in parallel. The DHCPv6
Leasequery specification [6] includes a discussion about reconciling
binding data received from multiple DHCPv6 servers.
5.5. Multiple Queries to a Single Server
Bulk Leasequery clients may need to make multiple queries in order to
recover binding information. A Requestor MAY use a single connection
to issue multiple queries, each with a unique transaction id.
Requestors should be aware that servers are not required to process
queries in parallel, and that servers are likely to limit the rate at
which they process queries from any one Requestor.
5.6. Closing Connections
The Requestor MAY close its end of the TCP connection after sending a
LEASEQUERY message to the server. The Requestor MAY choose to retain
the connection if it intends to issue additional queries. Note that
this client behavior does not guarantee that the connection will be
available for additional queries: the server might decide to close
the connection based on its own configuration.
Stapp Expires April 14, 2008 [Page 10]
Internet-Draft DHCPv6 Bulk Leasequery October 2007
6. Server Behavior
6.1. Accepting Connections
Servers that implement DHCPv6 Bulk Leasequery listen for incoming TCP
connections. Port numbers are discussed in Section 4.6. Servers
MUST be able to limit the number of currently accepted and active
connections. The value BULK_LQ_MAX_CONNS MUST be the default;
implementations MAY permit the value to be configurable.
Servers MAY restrict Bulk Leasequery connections and LEASEQUERY
messages to certain clients. Connections not from permitted clients
SHOULD BE closed immediately, to avoid server connection resource
exhaustion. Servers MAY restrict some clients to certain query
types. Servers MAY reply to queries that are not permitted with the
NotAllowed status code [6], or MAY close the connection.
If the TCP connection becomes blocked while the Server is accepting a
connection or reading a query, it SHOULD be prepared to terminate the
connection after BULK_LQ_DATA_TIMEOUT. We make this recommendation
to allow Servers to control the period of time they are willing to
wait before abandoning an inactive connection, independent of the TCP
implementations they may be using.
6.2. Forming Replies
The DHCPv6 Leasequery [6] specification describes the initial
construction of LEASEQUERY-REPLY messages and the processing of
QUERY_BY_ADDRESS and QUERY_BY_CLIENTID. Use of the LEASEQUERY-REPLY
and LEASEQUERY-DATA messages to carry multiple bindings are described
in Section 4.2. Message transmission and framing for TCP is
described in Section 4.1. If the connection becomes blocked while
the server is attempting to send reply messages, the server SHOULD be
prepared to terminate the TCP connection after BULK_LQ_DATA_TIMEOUT.
If the server encounters an error during initial query processing,
before any reply has been sent, it SHOULD send a LEASEQUERY-REPLY
containing an error code in an OPTION_STATUS_CODE option. This
signals to the requestor that no data will be returned. If the
server encounters an error while processing a query that has already
resulted in one or more reply messages, the server SHOULD send a
LEASEQUERY-DONE message with an error status. The server SHOULD
close its end of the connection as an indication that it was not able
to complete query processing.
If the server does not find any bindings satisfying a query, it
SHOULD send a LEASEQUERY-REPLY without an OPTION_STATUS_CODE option
and without any OPTION_CLIENT_DATA option. Otherwise, the server
Stapp Expires April 14, 2008 [Page 11]
Internet-Draft DHCPv6 Bulk Leasequery October 2007
sends each binding's data in a reply message. The first reply
message is a LEASEQUERY-REPLY. The binding data is carried in an
OPTION_CLIENT_DATA option, as specified in [6] and extended below.
The server returns subsequent bindings in LEASEQUERY-DATA messages,
which can avoid redundant data (such as the requestor's Client-ID).
For QUERY_BY_RELAYID, the Server locates each binding associated with
the query's Relay-ID option value. In order to give a meaningful
reply to a QUERY_BY_RELAYID, the Server has to be able to maintain
this association in its DHCPv6 binding data. If the query's link-
address is not set to 0::0, the server only returns bindings on links
that could contain that address. If the link-address is not 0::0 and
the server cannot find any matching links, the server SHOULD return
the NotConfigured status in a LEASEQUERY-REPLY.
For QUERY_BY_LINK_ADDRESS, the Server locates each binding associated
with the link identified by the query's link-address value.
For QUERY_BY_REMOTE_ID, the Server locates each binding associated
with the query's Relay Remote-ID option value. In order to be able
to give meaningful replies to this query, the Server has to be able
to maintain this association in its binding database. If the query
message's link-address is not set to 0::0, the server only returns
bindings on links that could contain that address. If the link-
address is not 0::0 and the server cannot find any matching links,
the server SHOULD return the NotConfigured status in a LEASEQUERY-
REPLY.
The server sends the LEASEQUERY-DONE message as specified in
Section 4.2.
6.3. Multiple or Parallel Queries
As discussed in Section 5.5, Requestors may want to leverage an
existing connection if they need to make multiple queries. Servers
MAY support reading and processing multiple queries from a single
connection. A server MUST NOT read more query messages from a
connection than it is prepared to process simultaneously.
This MAY be a feature that is administratively controlled. Servers
that are able to process queries in parallel SHOULD offer
configuration that limits the number of simultaneous queries
permitted from any one Requestor, in order to control resource use if
there are multiple Requestors seeking service.
Stapp Expires April 14, 2008 [Page 12]
Internet-Draft DHCPv6 Bulk Leasequery October 2007
6.4. Closing Connections
The server MAY close its end of the TCP connection after sending its
last message (a LEASEQUERY-REPLY or a LEASEQUERY-DONE) in response to
a query. Alternatively, the server MAY retain the connection and
wait for additional queries from the client. The server SHOULD be
prepared to limit the number of connections it maintains, and SHOULD
be prepared to close idle connections to enforce the limit.
The server MUST close its end of the TCP connection if it finds that
it has to abort an in-process request, or if it encounters an error
sending data on the connection. If the server detects that the
client end has been closed, the server MUST close its end of the
connection after it has finished processing any outstanding requests
from the client.
7. Security Considerations
The "Security Considerations" section of [1] details the general
threats to DHCPv6. The DHCPv6 Leasequery specification [6] describes
recommendations for the Leasequery protocol, especially with regard
to relayed LEASEQUERY messages, mitigation of packet-flooding DOS
attacks, restriction to trusted clients, and use of IPsec [7].
The use of TCP introduces some additional concerns. Attacks that
attempt to exhaust the DHCPv6 server's available TCP connection
resources, such as SYN flooding attacks, can compromise the ability
of legitimate clients to receive service. Malicious clients who
succeed in establishing connections, but who then send invalid
queries, partial queries, or no queries at all also can exhaust a
server's pool of available connections. We recommend that servers
offer configuration to limit the sources of incoming connections,
that they limit the number of accepted connections and the number of
in-process queries from any one connection, and that they limit the
period of time during which an idle connection will be left open.
8. IANA Considerations
IANA is requested to assign a new DHCPv6 Option Code in the registry
maintained in http://www.iana.org/assignments/dhcpv6-parameters:
OPTION_RELAYID
IANA is requested to assign values for the following new DHCPv6
Message types in the registry maintained in
http://www.iana.org/assignments/dhcpv6-parameters:
Stapp Expires April 14, 2008 [Page 13]
Internet-Draft DHCPv6 Bulk Leasequery October 2007
LEASEQUERY-DONE
LEASEQUERY-DATA
IANA is requested to assign the following new values in the registry
of query-types for the DHCPv6 OPTION_LQ_QUERY option:
QUERY_BY_RELAYID 3
QUERY_BY_LINK_ADDRESS 4
QUERY_BY_REMOTE_ID 5
9. Acknowledgements
Many of the ideas in this document were proposed by Kim Kinnear,
Richard Johnson, Hemant Singh, Ole Troan, and Bernie Volz.
10. Modification History
11. References
11.1. Normative References
[1] Droms, R., Bound, J., Volz, B., Lemon, T., Perkins, C., and M.
Carney, "Dynamic Host Configuration Protocol for IPv6 (DHCPv6)",
RFC 3315, July 2003.
[2] Troan, O. and R. Droms, "IPv6 Prefix Options for Dynamic Host
Configuration Protocol (DHCP) version 6", RFC 3633,
December 2003.
[3] Duke, M., Braden, R., Eddy, W., and E. Blanton, "A Roadmap for
Transmission Control Protocol (TCP) Specification Documents",
RFC 4614, September 2006.
[4] Bradner, S., "Key words for use in RFCs to Indicate Requirement
Levels", BCP 14, RFC 2119, March 1997.
[5] Volz, B., "Dynamic Host Configuration Protocol for IPv6 (DHCPv6)
Relay Agent Remote-ID Option", RFC 4649, August 2006.
[6] Brzozowski, J., Kinnear, K., Volz, B., and S. Zeng, "DHCPv6
Leasequery", RFC 5007, September 2007.
Stapp Expires April 14, 2008 [Page 14]
Internet-Draft DHCPv6 Bulk Leasequery October 2007
11.2. Informative References
[7] Kent, S. and R. Atkinson, "Security Architecture for the
Internet Protocol", RFC 2401, November 1998.
Author's Address
Mark Stapp
Cisco Systems, Inc.
1414 Massachusetts Ave.
Boxborough, MA 01719
USA
Phone: +1 978 936 0000
Email: mjs@cisco.com
Stapp Expires April 14, 2008 [Page 15]
Internet-Draft DHCPv6 Bulk Leasequery October 2007
Full Copyright Statement
Copyright (C) The IETF Trust (2007).
This document is subject to the rights, licenses and restrictions
contained in BCP 78, and except as set forth therein, the authors
retain all their rights.
This document and the information contained herein are provided on an
"AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS
OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY, THE IETF TRUST AND
THE INTERNET ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS
OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF
THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
Intellectual Property
The IETF takes no position regarding the validity or scope of any
Intellectual Property Rights or other rights that might be claimed to
pertain to the implementation or use of the technology described in
this document or the extent to which any license under such rights
might or might not be available; nor does it represent that it has
made any independent effort to identify any such rights. Information
on the procedures with respect to rights in RFC documents can be
found in BCP 78 and BCP 79.
Copies of IPR disclosures made to the IETF Secretariat and any
assurances of licenses to be made available, or the result of an
attempt made to obtain a general license or permission for the use of
such proprietary rights by implementers or users of this
specification can be obtained from the IETF on-line IPR repository at
http://www.ietf.org/ipr.
The IETF invites any interested party to bring to its attention any
copyrights, patents or patent applications, or other proprietary
rights that may cover technology that may be required to implement
this standard. Please address the information to the IETF at
ietf-ipr@ietf.org.
Acknowledgment
Funding for the RFC Editor function is provided by the IETF
Administrative Support Activity (IASA).
Stapp Expires April 14, 2008 [Page 16]