From: Francis Dupont Date: Sat, 7 Oct 2017 15:57:41 +0000 (+0200) Subject: [5371] Applied trc5368 doc fixes X-Git-Tag: trac5371_base X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=fdc6f97ae5332cb452fa7e1157254fd20c7908e9;p=thirdparty%2Fkea.git [5371] Applied trc5368 doc fixes --- diff --git a/doc/devel/mainpage.dox b/doc/devel/mainpage.dox index 602cdfc22e..e363dae0b7 100644 --- a/doc/devel/mainpage.dox +++ b/doc/devel/mainpage.dox @@ -50,6 +50,7 @@ * - @subpage hooksComponentDeveloperGuide * - @subpage hooksmgMaintenanceGuide * - @subpage libdhcp_user_chk + * - @subpage libdhcp_lease_cmds * * @section dhcpMaintenanceGuide DHCP Maintenance Guide * - @subpage dhcp4 diff --git a/src/bin/dhcp6/dhcp6_hooks.dox b/src/bin/dhcp6/dhcp6_hooks.dox index f52322dc6d..1b0e19e7f4 100644 --- a/src/bin/dhcp6/dhcp6_hooks.dox +++ b/src/bin/dhcp6/dhcp6_hooks.dox @@ -157,14 +157,16 @@ to the end of this list. - @b Arguments: - name: @b query6, type: isc::dhcp::PktPtr, direction: in - name: @b lease6, type: isc::dhcp::Lease6Ptr, direction: in/out - - name: @b ia_na, type: boost::shared_ptr, direction: in/out + - name: @b ia_na, type: isc::dhcp::Option6IAPtr direction: in/out + - name: @b ia_pd, type: isc::dhcp::Option6IAPtr, direction: in/out - @b Description: This callout is executed when the server engine is about to renew an existing lease. The client's request is provided as the "query6" argument and the existing lease with the appropriate fields - already modified is given in the "lease6" argument. The final argument, - ia_na, is the IA_NA option that will be sent back to the client. - Callouts installed on the "lease6_renew" may modify the content of + already modified is given in the "lease6" argument. The remaining two + arguments, "ia_na" and "ia_pd", are mutually exclusive and they provide + pointers to the IA_NA or IA_PD option which will be sent back to the + client. Callouts installed on the "lease6_renew" may modify the content of the "lease6" object. Care should be taken however, as that modified information will be written to the database without any further checking. \n\n Although the envisaged usage assumes modification of T1, @@ -172,31 +174,34 @@ to the end of this list. with the lease may be modified as well. The only exception is the @c addr_ field, which must not be modified as it is used by the database to select the existing lease to be updated. Care should also be taken to - modify the "ia_na" argument to match any changes in the "lease6" argument. - If a client sends more than one IA_NA option, callouts will be called - separately for each IA_NA instance. The callout will be called only - when the update is valid, i.e. conditions such as an invalid addresses - or invalid iaid renewal attempts will not trigger this hook point. + modify the "ia_na" and "ia_pd" arguments to match any changes in the + "lease6" argument. If a client sends more than one IA (IA_NA/IA_PD) + option, callouts will be called separately for each IA instance. The + callout will be called only when the update is valid, i.e. conditions + such as an invalid addresses or invalid iaid renewal attempts will + not trigger this hook point. - Next step status: If any callout installed on "lease6_renew" sets the status to SKIP, the server will not renew the lease. Under these - circumstances, the callout should modify the "ia_na" argument to reflect - this fact; otherwise the client will think the lease was renewed and continue - to operate under this assumption. + circumstances, the callout should modify the "ia_na" or "ia_pd" + argument to reflect this fact; otherwise the client will think the + lease was renewed and continue to operate under this assumption. @subsection dhcpv6HooksLease6Rebind lease6_rebind - @b Arguments: - name: @b query6, type: isc::dhcp::PktPtr, direction: in - name: @b lease6, type: isc::dhcp::Lease6Ptr, direction: in/out - - name: @b ia_na, type: boost::shared_ptr, direction: in/out + - name: @b ia_na, type: isc::dhcp::Option6IAPtr direction: in/out + - name: @b ia_pd, type: isc::dhcp::Option6IAPtr, direction: in/out - @b Description: This callout is executed when the server engine is about to rebind an existing lease. The client's request is provided as the "query6" argument and the existing lease with the appropriate fields - already modified is given in the "lease6" argument. The final argument, - ia_na, is the IA_NA option that will be sent back to the client. - Callouts installed on the "lease6_rebind" may modify the content of + already modified is given in the "lease6" argument. The remaining two + arguments, "ia_na" and "ia_pd", are mutually exclusive and they provide + pointers to the IA_NA or IA_PD option which will be sent back to the + client. Callouts installed on the "lease6_renew" may modify the content of the "lease6" object. Care should be taken however, as that modified information will be written to the database without any further checking. \n\n Although the envisaged usage assumes modification of T1, @@ -204,17 +209,18 @@ to the end of this list. with the lease may be modified as well. The only exception is the @c addr_ field, which must not be modified as it is used by the database to select the existing lease to be updated. Care should also be taken to - modify the "ia_na" argument to match any changes in the "lease6" argument. - If a client sends more than one IA_NA option, callouts will be called - separately for each IA_NA instance. The callout will be called only - when the update is valid, i.e. conditions such as an invalid addresses - or invalid iaid rebinding attempts will not trigger this hook point. + modify the "ia_na" and "ia_pd" arguments to match any changes in the + "lease6" argument. If a client sends more than one IA (IA_NA/IA_PD) + option, callouts will be called separately for each IA instance. The + callout will be called only when the update is valid, i.e. conditions + such as an invalid addresses or invalid iaid renewal attempts will + not trigger this hook point. - Next step status: If any callout installed on "lease6_rebind" sets the status to SKIP, the server will not rebind the lease. Under these - circumstances, the callout should modify the "ia_na" argument to reflect - this fact; otherwise the client will think the lease was rebound and continue - to operate under this assumption. + circumstances, the callout should modify the "ia_na" or "ia_pd" + argument to reflect this fact; otherwise the client will think the + lease was rebound and continue to operate under this assumption. @subsection dhcpv6HooksLease6Decline lease6_decline diff --git a/src/hooks/dhcp/lease_cmds/lease_cmds.dox b/src/hooks/dhcp/lease_cmds/lease_cmds.dox index 6f1649fc5e..e6f9e5241a 100644 --- a/src/hooks/dhcp/lease_cmds/lease_cmds.dox +++ b/src/hooks/dhcp/lease_cmds/lease_cmds.dox @@ -6,7 +6,9 @@ /** -@mainpage Kea Lease Commands Hooks Library +@page libdhcp_lease_cmds Kea Lease Commands Hooks Library + +@section libdhcp_lease_cmdsIntro Introduction Welcome to Kea Lease Commands Hooks Library. This documentation is addressed to developers who are interested in the internal operation of the Lease Commands