BIND 10 trac3295, updated. 19d1259543556766580099ed8f67e497d9c04ec3 [3295] Added documentation for new functions in DHCPv6 server code.
BIND 10 source code commits
bind10-changes at lists.isc.org
Wed Jan 22 08:39:17 UTC 2014
The branch, trac3295 has been updated
via 19d1259543556766580099ed8f67e497d9c04ec3 (commit)
from e5edf11fa4350e0b9a47691b9aa1f09ba0e6b4b8 (commit)
Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.
- Log -----------------------------------------------------------------
commit 19d1259543556766580099ed8f67e497d9c04ec3
Author: Marcin Siodelski <marcin at isc.org>
Date: Wed Jan 22 09:39:11 2014 +0100
[3295] Added documentation for new functions in DHCPv6 server code.
-----------------------------------------------------------------------
Summary of changes:
src/bin/dhcp4/dhcp4_srv.h | 2 +-
src/bin/dhcp6/dhcp6_srv.h | 32 ++++++++++++++++++++++++++++++++
2 files changed, 33 insertions(+), 1 deletion(-)
-----------------------------------------------------------------------
diff --git a/src/bin/dhcp4/dhcp4_srv.h b/src/bin/dhcp4/dhcp4_srv.h
index 85051ef..9a78baa 100644
--- a/src/bin/dhcp4/dhcp4_srv.h
+++ b/src/bin/dhcp4/dhcp4_srv.h
@@ -353,7 +353,7 @@ protected:
/// @brief Creates NameChangeRequests which correspond to the lease
/// which has been acquired.
///
- /// If this function is called whe an existing lease is renewed, it
+ /// If this function is called when an existing lease is renewed, it
/// may generate NameChangeRequest to remove existing DNS entries which
/// correspond to the old lease instance. This function may cease to
/// generate NameChangeRequests if the notion of the client's FQDN hasn't
diff --git a/src/bin/dhcp6/dhcp6_srv.h b/src/bin/dhcp6/dhcp6_srv.h
index ce9fcd3..c861b2d 100644
--- a/src/bin/dhcp6/dhcp6_srv.h
+++ b/src/bin/dhcp6/dhcp6_srv.h
@@ -402,6 +402,38 @@ protected:
/// Client FQDN option, this option is used to create NameChangeRequests.
void createNameChangeRequests(const Pkt6Ptr& answer);
+ /// @brief Create NameChangeRequests which correspond to the lease which
+ /// has been acquired.
+ ///
+ /// This function is called when a new lease is acquired (or old lease is
+ /// renewed). If the new lease is acquired (old_lease is NULL), a single
+ /// NameChangeRequest is generated to add a corresponding DNS entry.
+ /// If the lease is renewed, the old_lease must be non-NULL. In this case,
+ /// the function will compare FQDN data between old and new lease. If the
+ /// FQDN data has changed, two NameChangeRequests are generated - first
+ /// removes DNS entry for the old lease, second adds DNS entry for a new
+ /// lease.
+ ///
+ /// @param lease Pointer to the new lease being acquired.
+ /// @param old_lease Pointer to the old lease which has been replaced by the
+ /// new lease. The NULL value indicates that the new lease has been
+ /// allocated, rather than lease being renewed.
+ ///
+ /// @throw isc::Unexpected if the lease objects hold invalid data. This
+ /// should not happen, because lease should be validated by the caller.
+ /// @throw DhcidComputeError if failed to compute DHCID for the
+ /// NameChangeRequests. This typically means that the FQDN was malformed.
+ void createNameChangeRequests(const Lease6Ptr& lease,
+ const Lease6Ptr& old_lease);
+
+ /// @brief Creates a NameChangeRequest and adds to the queue for processing.
+ ///
+ /// This function adds the @c isc::dhcp_ddns::NameChangeRequest to the
+ /// queue and emits a debug message which indicates whether the request
+ /// being added is to remove DNS entry or add a new entry.
+ void queueNameChangeRequest(isc::dhcp_ddns::NameChangeType chg_type,
+ const Lease6Ptr& lease);
+
/// @brief Creates a @c isc::dhcp_ddns::NameChangeRequest which requests
/// removal of DNS entries for a particular lease.
///
More information about the bind10-changes
mailing list