![]() |
Kea
2.3.5-git
|
Context information for the DHCPv4 lease allocation. More...
#include <alloc_engine.h>
Public Member Functions | |
ClientContext4 () | |
Default constructor. More... | |
ClientContext4 (const Subnet4Ptr &subnet, const ClientIdPtr &clientid, const HWAddrPtr &hwaddr, const asiolink::IOAddress &requested_addr, const bool fwd_dns_update, const bool rev_dns_update, const std::string &hostname, const bool fake_allocation) | |
Constructor with parameters. More... | |
void | addHostIdentifier (const Host::IdentifierType &id_type, const std::vector< uint8_t > &identifier) |
Convenience function adding host identifier into host_identifiers_ list. More... | |
ConstHostPtr | currentHost () const |
Returns host for currently selected subnet. More... | |
DdnsParamsPtr | getDdnsParams () |
Returns the set of DDNS behavioral parameters based on the selected subnet. More... | |
ConstHostPtr | globalHost () const |
Returns global host reservation if there is one. More... | |
Public Attributes | |
hooks::CalloutHandlePtr | callout_handle_ |
Callout handle associated with the client's message. More... | |
ClientIdPtr | clientid_ |
Client identifier from the DHCP message. More... | |
Lease4Ptr | conflicting_lease_ |
A pointer to the object representing a lease in conflict. More... | |
bool | early_global_reservations_lookup_ |
Indicates if early global reservation is enabled. More... | |
bool | fake_allocation_ |
Indicates if this is a real or fake allocation. More... | |
bool | fwd_dns_update_ |
Perform forward DNS update. More... | |
IdentifierList | host_identifiers_ |
A list holding host identifiers extracted from a message received by the server. More... | |
std::string | hostname_ |
Hostname. More... | |
std::map< SubnetID, ConstHostPtr > | hosts_ |
Holds a map of hosts belonging to the client within different subnets. More... | |
HWAddrPtr | hwaddr_ |
HW address from the DHCP message. More... | |
Lease4Ptr | new_lease_ |
A pointer to a newly allocated lease. More... | |
Lease4Ptr | old_lease_ |
A pointer to an old lease that the client had before update. More... | |
Pkt4Ptr | query_ |
A pointer to the client's message. More... | |
asiolink::IOAddress | requested_address_ |
An address that the client desires. More... | |
bool | rev_dns_update_ |
Perform reverse DNS update. More... | |
Subnet4Ptr | subnet_ |
Subnet selected for the client by the server. More... | |
bool | unknown_requested_addr_ |
True when the address DHCPREQUEST'ed by client is not within a dynamic pool the server knows about. More... | |
Context information for the DHCPv4 lease allocation.
This structure holds a set of information provided by the DHCPv4 server to the allocation engine. In particular, it holds the client identifying information, such as HW address or client identifier. It also holds the information about the subnet that the client is connected to.
This structure is also used to pass some information from the allocation engine back to the server, i.e. the old lease which the client had before the allocation.
This structure is meant to be extended in the future, if more information should be passed to the allocation engine. Note that the big advantage of using the context structure to pass information to the allocation engine methods is that adding new information doesn't modify the API of the allocation engine.
Definition at line 1192 of file alloc_engine.h.
isc::dhcp::AllocEngine::ClientContext4::ClientContext4 | ( | ) |
Default constructor.
Definition at line 3243 of file alloc_engine.cc.
isc::dhcp::AllocEngine::ClientContext4::ClientContext4 | ( | const Subnet4Ptr & | subnet, |
const ClientIdPtr & | clientid, | ||
const HWAddrPtr & | hwaddr, | ||
const asiolink::IOAddress & | requested_addr, | ||
const bool | fwd_dns_update, | ||
const bool | rev_dns_update, | ||
const std::string & | hostname, | ||
const bool | fake_allocation | ||
) |
Constructor with parameters.
subnet | subnet the allocation should come from (mandatory) |
clientid | Client identifier (optional) |
hwaddr | Client's hardware address info (mandatory) |
requested_addr | A hint that the client provided (may be 0.0.0.0) |
fwd_dns_update | Indicates whether forward DNS update will be performed for the client (true) or not (false). |
rev_dns_update | Indicates whether reverse DNS update will be performed for the client (true) or not (false). |
hostname | A string carrying hostname to be used for DNS updates. |
fake_allocation | Is this real i.e. REQUEST (false) or just picking an address for DISCOVER that is not really allocated (true) |
Definition at line 3254 of file alloc_engine.cc.
References addHostIdentifier(), and isc::dhcp::Host::IDENT_HWADDR.
|
inline |
Convenience function adding host identifier into host_identifiers_ list.
id_type | Identifier type. |
identifier | Identifier value. |
Definition at line 1284 of file alloc_engine.h.
Referenced by ClientContext4().
ConstHostPtr isc::dhcp::AllocEngine::ClientContext4::currentHost | ( | ) | const |
Returns host for currently selected subnet.
If there is no such host and global reservations are enabled returns the global host.
Definition at line 3278 of file alloc_engine.cc.
References globalHost(), hosts_, and subnet_.
Referenced by isc::dhcp::AllocEngine::findGlobalReservation().
DdnsParamsPtr isc::dhcp::AllocEngine::ClientContext4::getDdnsParams | ( | ) |
Returns the set of DDNS behavioral parameters based on the selected subnet.
If there is no selected subnet (i.e. subnet_ is empty), the returned set will contain default values.
Definition at line 3302 of file alloc_engine.cc.
References isc::dhcp::CfgMgr::getCurrentCfg(), isc::dhcp::CfgMgr::instance(), and subnet_.
ConstHostPtr isc::dhcp::AllocEngine::ClientContext4::globalHost | ( | ) | const |
Returns global host reservation if there is one.
If the current subnet's reservations-global is true and there is a global host (i.e. reservation belonging to the global subnet), return it. Otherwise return an empty pointer.
Definition at line 3290 of file alloc_engine.cc.
References hosts_, and subnet_.
Referenced by currentHost().
hooks::CalloutHandlePtr isc::dhcp::AllocEngine::ClientContext4::callout_handle_ |
Callout handle associated with the client's message.
Definition at line 1226 of file alloc_engine.h.
Referenced by isc::dhcp::AllocEngine::getValidLft().
ClientIdPtr isc::dhcp::AllocEngine::ClientContext4::clientid_ |
Client identifier from the DHCP message.
Definition at line 1202 of file alloc_engine.h.
Referenced by isc::dhcp::AllocEngine::deleteExpiredReclaimedLeases4(), isc::dhcp::AllocEngine::findGlobalReservation(), and isc::dhcp::AllocEngine::getValidLft().
Lease4Ptr isc::dhcp::AllocEngine::ClientContext4::conflicting_lease_ |
A pointer to the object representing a lease in conflict.
This pointer is set by some of the allocation methods when the lease can't be allocated because there is another lease which is in conflict with this allocation.
Definition at line 1253 of file alloc_engine.h.
Referenced by isc::dhcp::AllocEngine::findGlobalReservation(), and isc::dhcp::AllocEngine::getValidLft().
bool isc::dhcp::AllocEngine::ClientContext4::early_global_reservations_lookup_ |
Indicates if early global reservation is enabled.
This caches the early-global-reservations-lookup value.
Definition at line 1196 of file alloc_engine.h.
Referenced by isc::dhcp::AllocEngine::findReservation().
bool isc::dhcp::AllocEngine::ClientContext4::fake_allocation_ |
Indicates if this is a real or fake allocation.
The real allocation is when the allocation engine is supposed to make an update in a lease database: create new lease, or update existing lease.
Definition at line 1233 of file alloc_engine.h.
Referenced by isc::dhcp::AllocEngine::allocateLease4(), and isc::dhcp::AllocEngine::getValidLft().
bool isc::dhcp::AllocEngine::ClientContext4::fwd_dns_update_ |
Perform forward DNS update.
Definition at line 1214 of file alloc_engine.h.
Referenced by isc::dhcp::AllocEngine::getValidLft().
IdentifierList isc::dhcp::AllocEngine::ClientContext4::host_identifiers_ |
A list holding host identifiers extracted from a message received by the server.
Definition at line 1263 of file alloc_engine.h.
Referenced by isc::dhcp::AllocEngine::deleteExpiredReclaimedLeases4(), isc::dhcp::AllocEngine::findGlobalReservation(), and isc::dhcp::AllocEngine::findReservation().
std::string isc::dhcp::AllocEngine::ClientContext4::hostname_ |
Hostname.
The server retrieves the hostname from the Client FQDN option, Hostname option or the host reservation record for the client.
Definition at line 1223 of file alloc_engine.h.
Referenced by isc::dhcp::AllocEngine::getValidLft().
std::map<SubnetID, ConstHostPtr> isc::dhcp::AllocEngine::ClientContext4::hosts_ |
Holds a map of hosts belonging to the client within different subnets.
Multiple hosts may appear when the client belongs to a shared network.
Definition at line 1246 of file alloc_engine.h.
Referenced by currentHost(), isc::dhcp::AllocEngine::deleteExpiredReclaimedLeases4(), isc::dhcp::AllocEngine::findReservation(), and globalHost().
HWAddrPtr isc::dhcp::AllocEngine::ClientContext4::hwaddr_ |
HW address from the DHCP message.
Definition at line 1205 of file alloc_engine.h.
Referenced by isc::dhcp::AllocEngine::allocateLease4(), isc::dhcp::AllocEngine::deleteExpiredReclaimedLeases4(), isc::dhcp::AllocEngine::findGlobalReservation(), and isc::dhcp::AllocEngine::getValidLft().
Lease4Ptr isc::dhcp::AllocEngine::ClientContext4::new_lease_ |
A pointer to a newly allocated lease.
Definition at line 1239 of file alloc_engine.h.
Referenced by isc::dhcp::AllocEngine::allocateLease4().
Lease4Ptr isc::dhcp::AllocEngine::ClientContext4::old_lease_ |
A pointer to an old lease that the client had before update.
Definition at line 1236 of file alloc_engine.h.
Referenced by isc::dhcp::AllocEngine::allocateLease4(), isc::dhcp::AllocEngine::findGlobalReservation(), and isc::dhcp::AllocEngine::getValidLft().
Pkt4Ptr isc::dhcp::AllocEngine::ClientContext4::query_ |
A pointer to the client's message.
This is used in logging to retrieve the client's and the transaction identification information.
Definition at line 1259 of file alloc_engine.h.
Referenced by isc::dhcp::AllocEngine::allocateLease4(), isc::dhcp::AllocEngine::deleteExpiredReclaimedLeases4(), isc::dhcp::AllocEngine::findGlobalReservation(), isc::dhcp::AllocEngine::findReservation(), isc::dhcp::AllocEngine::getValidLft(), and isc::dhcp::AllocEngine::updateLease4ExtendedInfo().
asiolink::IOAddress isc::dhcp::AllocEngine::ClientContext4::requested_address_ |
An address that the client desires.
If this address is set to 0 it indicates that this address is unspecified.
Definition at line 1211 of file alloc_engine.h.
Referenced by isc::dhcp::AllocEngine::findGlobalReservation(), and isc::dhcp::AllocEngine::getValidLft().
bool isc::dhcp::AllocEngine::ClientContext4::rev_dns_update_ |
Perform reverse DNS update.
Definition at line 1217 of file alloc_engine.h.
Referenced by isc::dhcp::AllocEngine::getValidLft().
Subnet4Ptr isc::dhcp::AllocEngine::ClientContext4::subnet_ |
Subnet selected for the client by the server.
Definition at line 1199 of file alloc_engine.h.
Referenced by isc::dhcp::AllocEngine::allocateLease4(), currentHost(), isc::dhcp::AllocEngine::deleteExpiredReclaimedLeases4(), isc::dhcp::AllocEngine::findGlobalReservation(), isc::dhcp::AllocEngine::findReservation(), getDdnsParams(), isc::dhcp::AllocEngine::getValidLft(), globalHost(), isc::dhcp::AllocEngine::updateLease4ExtendedInfo(), and isc::dhcp::AllocEngine::updateLease6ExtendedInfo().
bool isc::dhcp::AllocEngine::ClientContext4::unknown_requested_addr_ |
True when the address DHCPREQUEST'ed by client is not within a dynamic pool the server knows about.
Definition at line 1267 of file alloc_engine.h.
Referenced by isc::dhcp::AllocEngine::findGlobalReservation().