Context information for the DHCPv4 lease allocation. More...

#include <alloc_engine.h>

Inheritance diagram for isc::dhcp::AllocEngine::ClientContext4:

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	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...

Detailed Description

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 1356 of file alloc_engine.h.

Constructor & Destructor Documentation

isc::dhcp::AllocEngine::ClientContext4::ClientContext4 ( )

Default constructor.

Definition at line 3325 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.

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 3335 of file alloc_engine.cc.

References addHostIdentifier(), and isc::dhcp::Host::IDENT_HWADDR.

Here is the call graph for this function:

Member Function Documentation

void isc::dhcp::AllocEngine::ClientContext4::addHostIdentifier	(	const Host::IdentifierType &	id_type,
		const std::vector< uint8_t > &	identifier
	)

inline

Convenience function adding host identifier into host_identifiers_ list.

Parameters

id_type	Identifier type.
identifier	Identifier value.

Definition at line 1438 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.

Returns: Pointer to the host object.

Definition at line 3358 of file alloc_engine.cc.

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.

Returns: pointer to a DdnsParams instance

Definition at line 3382 of file alloc_engine.cc.

References isc::dhcp::CfgMgr::getCurrentCfg(), and isc::dhcp::CfgMgr::instance().

Here is the call graph for this function:

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.

Returns: Pointer to the host object.

Definition at line 3370 of file alloc_engine.cc.

Member Data Documentation

hooks::CalloutHandlePtr isc::dhcp::AllocEngine::ClientContext4::callout_handle_

Callout handle associated with the client's message.

Definition at line 1385 of file alloc_engine.h.

ClientIdPtr isc::dhcp::AllocEngine::ClientContext4::clientid_

Client identifier from the DHCP message.

Definition at line 1361 of file alloc_engine.h.

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 1412 of file alloc_engine.h.

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 1392 of file alloc_engine.h.

Referenced by isc::dhcp::AllocEngine::allocateLease4().

bool isc::dhcp::AllocEngine::ClientContext4::fwd_dns_update_

Perform forward DNS update.

Definition at line 1373 of file alloc_engine.h.

IdentifierList isc::dhcp::AllocEngine::ClientContext4::host_identifiers_

A list holding host identifiers extracted from a message received by the server.

Definition at line 1422 of file alloc_engine.h.

Referenced by 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 1382 of file alloc_engine.h.

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 1405 of file alloc_engine.h.

Referenced by isc::dhcp::AllocEngine::findReservation().

HWAddrPtr isc::dhcp::AllocEngine::ClientContext4::hwaddr_

HW address from the DHCP message.

Definition at line 1364 of file alloc_engine.h.

Referenced by isc::dhcp::AllocEngine::allocateLease4().

Lease4Ptr isc::dhcp::AllocEngine::ClientContext4::new_lease_

A pointer to a newly allocated lease.

Definition at line 1398 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 1395 of file alloc_engine.h.

Referenced by isc::dhcp::AllocEngine::allocateLease4().

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 1418 of file alloc_engine.h.

Referenced by isc::dhcp::AllocEngine::allocateLease4(), 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 1370 of file alloc_engine.h.

bool isc::dhcp::AllocEngine::ClientContext4::rev_dns_update_

Perform reverse DNS update.

Definition at line 1376 of file alloc_engine.h.

Subnet4Ptr isc::dhcp::AllocEngine::ClientContext4::subnet_

Subnet selected for the client by the server.

Definition at line 1358 of file alloc_engine.h.

Referenced by isc::dhcp::AllocEngine::allocateLease4(), isc::dhcp::AllocEngine::findReservation(), isc::dhcp::AllocEngine::getValidLft(), and isc::dhcp::AllocEngine::updateLease4ExtendedInfo().

The documentation for this struct was generated from the following files:

Public Member Functions

Public Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation