mir/kea
2
0
Fork 0
mirror of https://gitlab.isc.org/isc-projects/kea synced 2025-09-03 07:25:18 +00:00
Code Issues Releases Wiki Activity

[#3067] addressed review comments

Browse Source
This commit is contained in:
Piotrek Zadroga
2023-09-19 10:58:27 +02:00
parent 5d49294772
commit a181a097cc
1 changed files with 12 additions and 15 deletions
Download Patch File Download Diff File Expand all files Collapse all files

27
src/bin/dhcp4/dhcp4_hooks.dox
View File

@@ -326,25 +326,22 @@ called before "subnet4_select".
- name: @b old_lease, type: isc::dhcp::Lease4Ptr, direction: <b>in</b> - name: @b old_lease, type: isc::dhcp::Lease4Ptr, direction: <b>in</b>
- @b Description: this callout is executed when the server has received - @b Description: this callout is executed when the server has received
DHCPDISCOVER from the client and the DHCPOFFER is yet to be sent back DHCPDISCOVER from the client and the DHCPOFFER has been constructed but not
to the client. The argument "query4" contains a pointer to an isc::dhcp::Pkt4 yet sent back. The argument "query4" contains a pointer to an isc::dhcp::Pkt4
object that contains all information regarding incoming DHCPDISCOVER packet. object that contains all information regarding incoming DHCPDISCOVER packet.
The "leases4" object will hold the pointer to the new candidate lease for this The "leases4" object will hold the pointer to the new candidate lease for this
client. The "offer_lifetime" argument comes from the context information for the client. The "offer_lifetime" argument comes from the context information for the
DHCPv4 lease allocation. If "offer_lifetime" is not zero, it indicates that the DHCPv4 lease allocation. If "offer_lifetime" is not zero, it indicates that temporary
lease already exists in the lease store. The "old_lease" argument also comes from allocation on DHCPDISCOVER is enabled and the lease to be offered already exists in
the context information for the DHCPv4 lease allocation. If not Null, it is a pointer the lease store. The "old_lease" argument also comes from the context information
to an old lease that the client had before. for the DHCPv4 lease allocation. If not Null, it is a pointer to an old lease that
the client had before.
- <b>Next step status</b>: If any callout installed on the "lease4_offer" - <b>Next step status</b>: If any callout installed on the "lease4_offer" hook point
sets the next step action to DROP, the server will drop the processed query. sets the next step action to DROP, the server will drop the processed query
The callout is responsible for dealing with Declined lease for the Offer that and discard the prepared DHCPOFFER rather than sending it to the client.
in this case will NOT be sent back to the client. Any further action, such as marking the discarded DHCPOFFER's lease as declined,
If any callout installed on the "lease4_offer" sets the next step action to PARK, is the responsibility of the callout.
the server will park the processed packet (hold packet processing) until the hook
libraries explicitly unpark the packet after they are done performing asynchronous
operations. Upon the packet UNPARK, the Offer will be sent to the client.
This was originally intended to be used by "ping-check" premium hook.
@subsection dhcpv4HooksPkt4Send pkt4_send @subsection dhcpv4HooksPkt4Send pkt4_send