#include <mysql_lease_mgr.h>

Inheritance diagram for isc::dhcp::MySqlLeaseMgr:

Public Types
enum	StatementIndex { DELETE_LEASE4 , DELETE_LEASE4_STATE_EXPIRED , DELETE_LEASE6 , DELETE_LEASE6_STATE_EXPIRED , GET_LEASE4 , GET_LEASE4_ADDR , GET_LEASE4_CLIENTID , GET_LEASE4_CLIENTID_SUBID , GET_LEASE4_HWADDR , GET_LEASE4_HWADDR_SUBID , GET_LEASE4_PAGE , GET_LEASE4_UCTX_PAGE , GET_LEASE4_SUBID , GET_LEASE4_HOSTNAME , GET_LEASE4_EXPIRE , GET_LEASE4_RELAYID , GET_LEASE4_RELAYID_QST , GET_LEASE4_RELAYID_QSET , GET_LEASE4_RELAYID_QET , GET_LEASE4_REMOTEID , GET_LEASE4_REMOTEID_QST , GET_LEASE4_REMOTEID_QSET , GET_LEASE4_REMOTEID_QET , GET_LEASE6 , GET_LEASE6_ADDR , GET_LEASE6_DUID_IAID , GET_LEASE6_DUID_IAID_SUBID , GET_LEASE6_PAGE , GET_LEASE6_UCTX_PAGE , GET_LEASE6_SUBID , GET_LEASE6_DUID , GET_LEASE6_HOSTNAME , GET_LEASE6_EXPIRE , GET_LEASE6_LINK , INSERT_LEASE4 , INSERT_LEASE6 , UPDATE_LEASE4 , UPDATE_LEASE6 , ALL_LEASE4_STATS , SUBNET_LEASE4_STATS , SUBNET_RANGE_LEASE4_STATS , ALL_POOL_LEASE4_STATS , ALL_LEASE6_STATS , SUBNET_LEASE6_STATS , SUBNET_RANGE_LEASE6_STATS , ALL_POOL_LEASE6_STATS , CHECK_LEASE4_LIMITS , CHECK_LEASE6_LIMITS , IS_JSON_SUPPORTED , GET_LEASE4_COUNT_BY_CLASS , GET_LEASE6_COUNT_BY_CLASS , WIPE_RELAY_ID6 , WIPE_REMOTE_ID6 , DELETE_RELAY_ID6 , DELETE_REMOTE_ID6 , ADD_RELAY_ID6 , ADD_REMOTE_ID6 , GET_RELAY_ID6 , GET_REMOTE_ID6 , GET_RELAY_ID6_LINK , GET_REMOTE_ID6_LINK , COUNT_RELAY_ID6 , COUNT_REMOTE_ID6 , NUM_STATEMENTS }
	Statement Tags. More...

Public Types inherited from isc::dhcp::TrackingLeaseMgr
typedef std::function< void(LeasePtr, bool)>	CallbackFn
	Type of a callback function invoked upon a lease insertion, update or deletion. More...

enum	CallbackType { TRACK_ADD_LEASE , TRACK_UPDATE_LEASE , TRACK_DELETE_LEASE }
	An enumeration differentiating between lease write operations. More...

Public Member Functions
	MySqlLeaseMgr (const db::DatabaseConnection::ParameterMap &parameters)
	Constructor. More...

virtual	~MySqlLeaseMgr ()
	Destructor (closes database) More...

virtual bool	addLease (const Lease4Ptr &lease) override
	Adds an IPv4 lease. More...

virtual bool	addLease (const Lease6Ptr &lease) override
	Adds an IPv6 lease. More...

virtual size_t	byRelayId6size () const override
	Return the by-relay-id table size. More...

virtual size_t	byRemoteId6size () const override
	Return the by-remote-id table size. More...

virtual void	commit () override
	Commit Transactions. More...

MySqlLeaseContextPtr	createContext () const
	Create a new context. More...

virtual uint64_t	deleteExpiredReclaimedLeases4 (const uint32_t secs) override
	Deletes all expired-reclaimed DHCPv4 leases. More...

virtual uint64_t	deleteExpiredReclaimedLeases6 (const uint32_t secs) override
	Deletes all expired-reclaimed DHCPv6 leases. More...

virtual bool	deleteLease (const Lease4Ptr &lease) override
	Deletes an IPv4 lease. More...

virtual bool	deleteLease (const Lease6Ptr &lease) override
	Deletes an IPv6 lease. More...

virtual std::string	getDescription () const override
	Returns description of the backend. More...

virtual void	getExpiredLeases4 (Lease4Collection &expired_leases, const size_t max_leases) const override
	Returns a collection of expired DHCPv4 leases. More...

virtual void	getExpiredLeases6 (Lease6Collection &expired_leases, const size_t max_leases) const override
	Returns a collection of expired DHCPv6 leases. More...

virtual Lease4Collection	getLease4 (const ClientId &clientid) const override
	Returns existing IPv4 leases for specified client-id. More...

virtual Lease4Ptr	getLease4 (const ClientId &clientid, SubnetID subnet_id) const override
	Returns existing IPv4 lease for specified client-id. More...

virtual Lease4Ptr	getLease4 (const isc::asiolink::IOAddress &addr) const override
	Returns an IPv4 lease for specified IPv4 address. More...

virtual Lease4Collection	getLease4 (const isc::dhcp::HWAddr &hwaddr) const override
	Returns existing IPv4 leases for specified hardware address. More...

virtual Lease4Ptr	getLease4 (const isc::dhcp::HWAddr &hwaddr, SubnetID subnet_id) const override
	Returns existing IPv4 leases for specified hardware address and a subnet. More...

virtual Lease6Ptr	getLease6 (Lease::Type type, const isc::asiolink::IOAddress &addr) const override
	Returns existing IPv6 lease for a given IPv6 address. More...

virtual Lease4Collection	getLeases4 () const override
	Returns all IPv4 leases. More...

virtual Lease4Collection	getLeases4 (const asiolink::IOAddress &lower_bound_address, const LeasePageSize &page_size) const override
	Returns range of IPv4 leases using paging. More...

virtual Lease4Collection	getLeases4 (const std::string &hostname) const override
	Returns all IPv4 leases for the particular hostname. More...

virtual Lease4Collection	getLeases4 (SubnetID subnet_id) const override
	Returns all IPv4 leases for the particular subnet identifier. More...

virtual Lease4Collection	getLeases4ByRelayId (const OptionBuffer &relay_id, const asiolink::IOAddress &lower_bound_address, const LeasePageSize &page_size, const time_t &qry_start_time=0, const time_t &qry_end_time=0) override
	The following queries are used to fulfill Bulk Lease Query queries. More...

virtual Lease4Collection	getLeases4ByRemoteId (const OptionBuffer &remote_id, const asiolink::IOAddress &lower_bound_address, const LeasePageSize &page_size, const time_t &qry_start_time=0, const time_t &qry_end_time=0) override
	Returns existing IPv4 leases with a given remote-id. More...

virtual Lease6Collection	getLeases6 () const override
	Returns all IPv6 leases. More...

virtual Lease6Collection	getLeases6 (const asiolink::IOAddress &lower_bound_address, const LeasePageSize &page_size) const override
	Returns range of IPv6 leases using paging. More...

virtual Lease6Collection	getLeases6 (const DUID &duid) const override
	Returns all IPv6 leases for the DUID. More...

virtual Lease6Collection	getLeases6 (const std::string &hostname) const override
	Returns all IPv6 leases for the particular hostname. More...

virtual Lease6Collection	getLeases6 (Lease::Type type, const DUID &duid, uint32_t iaid) const override
	Returns existing IPv6 leases for a given DUID+IA combination. More...

virtual Lease6Collection	getLeases6 (Lease::Type type, const DUID &duid, uint32_t iaid, SubnetID subnet_id) const override
	Returns existing IPv6 lease for a given DUID+IA combination. More...

virtual Lease6Collection	getLeases6 (SubnetID subnet_id) const override
	Returns all IPv6 leases for the particular subnet identifier. More...

virtual Lease6Collection	getLeases6ByLink (const asiolink::IOAddress &link_addr, uint8_t link_len, const asiolink::IOAddress &lower_bound_address, const LeasePageSize &page_size) override
	Returns existing IPv6 leases with on a given link. More...

virtual Lease6Collection	getLeases6ByRelayId (const DUID &relay_id, const asiolink::IOAddress &link_addr, uint8_t link_len, const asiolink::IOAddress &lower_bound_address, const LeasePageSize &page_size) override
	Returns existing IPv6 leases with a given relay-id. More...

virtual Lease6Collection	getLeases6ByRemoteId (const OptionBuffer &remote_id, const asiolink::IOAddress &link_addr, uint8_t link_len, const asiolink::IOAddress &lower_bound_address, const LeasePageSize &page_size) override
	Returns existing IPv6 leases with a given remote-id. More...

virtual std::string	getName () const override
	Returns backend name. More...

virtual std::string	getType () const override
	Return backend type. More...

virtual std::pair< uint32_t, uint32_t >	getVersion () const override
	Returns backend version. More...

virtual void	rollback () override
	Rollback Transactions. More...

virtual LeaseStatsQueryPtr	startLeaseStatsQuery4 () override
	Creates and runs the IPv4 lease stats query. More...

virtual LeaseStatsQueryPtr	startLeaseStatsQuery6 () override
	Creates and runs the IPv6 lease stats query. More...

virtual LeaseStatsQueryPtr	startPoolLeaseStatsQuery4 () override
	Creates and runs the IPv4 lease stats query for all subnets and pools. More...

virtual LeaseStatsQueryPtr	startPoolLeaseStatsQuery6 () override
	Creates and runs the IPv6 lease stats query for all subnets and pools. More...

virtual LeaseStatsQueryPtr	startSubnetLeaseStatsQuery4 (const SubnetID &subnet_id) override
	Creates and runs the IPv4 lease stats query for a single subnet. More...

virtual LeaseStatsQueryPtr	startSubnetLeaseStatsQuery6 (const SubnetID &subnet_id) override
	Creates and runs the IPv6 lease stats query for a single subnet. More...

virtual LeaseStatsQueryPtr	startSubnetRangeLeaseStatsQuery4 (const SubnetID &first_subnet_id, const SubnetID &last_subnet_id) override
	Creates and runs the IPv4 lease stats query for a single subnet. More...

virtual LeaseStatsQueryPtr	startSubnetRangeLeaseStatsQuery6 (const SubnetID &first_subnet_id, const SubnetID &last_subnet_id) override
	Creates and runs the IPv6 lease stats query for a single subnet. More...

virtual void	updateLease4 (const Lease4Ptr &lease4) override
	Updates IPv4 lease. More...

virtual void	updateLease6 (const Lease6Ptr &lease6) override
	Updates IPv6 lease. More...

virtual size_t	upgradeExtendedInfo4 (const LeasePageSize &page_size) override
	Upgrade extended info (v4). More...

virtual size_t	upgradeExtendedInfo6 (const LeasePageSize &page_size) override
	Upgrade extended info (v6). More...

virtual void	wipeExtendedInfoTables6 () override
	Wipe by-relay-id table (v6). More...

virtual size_t	wipeLeases4 (const SubnetID &subnet_id) override
	Removes specified IPv4 leases. More...

virtual size_t	wipeLeases6 (const SubnetID &subnet_id) override
	Removed specified IPv6 leases. More...

Public Member Functions inherited from isc::dhcp::TrackingLeaseMgr
bool	hasCallbacks () const
	Checks if any callbacks have been registered. More...

bool	isLocked (const LeasePtr &lease)
	Checks if the lease is locked. More...

void	registerCallback (CallbackType type, std::string owner, Lease::Type lease_type, CallbackFn callback_fn)
	Registers a callback function for all subnets. More...

void	registerCallback (CallbackType type, std::string owner, SubnetID subnet_id, Lease::Type lease_type, CallbackFn callback_fn)
	Registers a callback function for a subnet. More...

void	unregisterAllCallbacks ()
	Unregisters all callbacks. More...

void	unregisterCallbacks (SubnetID subnet_id, Lease::Type lease_type)
	Unregisters all callbacks for a given subnet identifier. More...

Public Member Functions inherited from isc::dhcp::LeaseMgr
	LeaseMgr ()
	Constructor. More...

virtual	~LeaseMgr ()
	Destructor. More...

bool	getExtendedInfoTablesEnabled () const
	Returns the setting indicating if lease6 extended info tables are enabled. More...

Lease6Ptr	getLease6 (Lease::Type type, const DUID &duid, uint32_t iaid, SubnetID subnet_id) const
	returns zero or one IPv6 lease for a given duid+iaid+subnet_id More...

void	recountLeaseStats4 ()
	Recalculates per-subnet and global stats for IPv4 leases. More...

void	recountLeaseStats6 ()
	Recalculates per-subnet and global stats for IPv6 leases. More...

void	setExtendedInfoTablesEnabled (const bool enabled)
	Modifies the setting whether the lease6 extended info tables are enabled. More...

Static Public Member Functions
static bool	dbReconnect (util::ReconnectCtlPtr db_reconnect_ctl)
	Attempts to reconnect the server to the lease DB backend manager. More...

static std::string	getDBVersion ()
	Local version of getDBVersion() class method. More...

Static Public Member Functions inherited from isc::dhcp::LeaseMgr
static void	extractLease4ExtendedInfo (const Lease4Ptr &lease, bool ignore_errors=true)
	Extract relay and remote identifiers from the extended info. More...

static std::string	getDBVersion ()
	Class method to return extended version info This class method must be redeclared and redefined in derived classes. More...

static isc::asiolink::IOServicePtr &	getIOService ()
	Returns pointer to the IO service. More...

static void	setIOService (const isc::asiolink::IOServicePtr &io_service)
	Sets IO service to be used by the Lease Manager. More...

static bool	upgradeLease4ExtendedInfo (const Lease4Ptr &lease, CfgConsistency::ExtendedInfoSanity check=CfgConsistency::EXTENDED_INFO_CHECK_FIX)
	The following queries are used to fulfill Bulk Lease Query queries. More...

static bool	upgradeLease6ExtendedInfo (const Lease6Ptr &lease, CfgConsistency::ExtendedInfoSanity check=CfgConsistency::EXTENDED_INFO_CHECK_FIX)
	Upgrade a V6 lease user context to the new extended info entry. More...

Protected Member Functions
virtual void	addRelayId6 (const isc::asiolink::IOAddress &lease_addr, const std::vector< uint8_t > &relay_id) override
	Add lease6 extended info into by-relay-id table. More...

virtual void	addRemoteId6 (const isc::asiolink::IOAddress &lease_addr, const std::vector< uint8_t > &remote_id) override
	Add lease6 extended info into by-remote-id table. More...

virtual void	deleteExtendedInfo6 (const isc::asiolink::IOAddress &addr) override
	Extended information / Bulk Lease Query shared interface. More...

Protected Member Functions inherited from isc::dhcp::TrackingLeaseMgr
	TrackingLeaseMgr ()
	Constructor. More...

void	runCallbacks (CallbackType type, const LeasePtr &lease, bool mt_safe)
	Runs registered callbacks of the particular type. More...

void	runCallbacksForSubnetID (CallbackType type, SubnetID subnet_id, const LeasePtr &lease, bool mt_safe)
	Runs registered callbacks of the particular type for a subnet id. More...

void	trackAddLease (const LeasePtr &lease, bool mt_safe)
	Invokes the callbacks when a new lease is added. More...

void	trackDeleteLease (const LeasePtr &lease, bool mt_safe)
	Invokes the callbacks when a lease is deleted. More...

void	trackUpdateLease (const LeasePtr &lease, bool mt_safe)
	Invokes the callbacks when a lease is updated. More...

bool	tryLock (const LeasePtr &lease)
	Attempts to lock a lease. More...

void	unlock (const LeasePtr &lease)
	Attempts to unlock a lease. More...

Protected Member Functions inherited from isc::dhcp::LeaseMgr
virtual bool	addExtendedInfo6 (const Lease6Ptr &lease)
	Extract extended info from a lease6 and add it into tables. More...

void	setExtendedInfoTablesEnabled (const db::DatabaseConnection::ParameterMap &parameters)
	Extended information / Bulk Lease Query shared interface. More...

Additional Inherited Members
Protected Types inherited from isc::dhcp::TrackingLeaseMgr
typedef boost::multi_index_container< Callback, boost::multi_index::indexed_by< boost::multi_index::ordered_non_unique< boost::multi_index::composite_key< Callback, boost::multi_index::member< Callback, CallbackType, &Callback::type >, boost::multi_index::member< Callback, SubnetID, &Callback::subnet_id >, boost::multi_index::member< Callback, Lease::Type, &Callback::lease_type > > >, boost::multi_index::ordered_non_unique< boost::multi_index::composite_key< Callback, boost::multi_index::member< Callback, SubnetID, &Callback::subnet_id >, boost::multi_index::member< Callback, Lease::Type, &Callback::lease_type > > > > >	CallbackContainer
	A multi-index container holding registered callbacks. More...

typedef boost::shared_ptr< CallbackContainer >	CallbackContainerPtr
	Pointer to the callback container. More...

Static Protected Member Functions inherited from isc::dhcp::TrackingLeaseMgr
static std::string	callbackTypeToString (CallbackType type)
	Converts callback type to string for logging purposes. More...

Protected Attributes inherited from isc::dhcp::TrackingLeaseMgr
CallbackContainerPtr	callbacks_
	The multi-index container holding registered callbacks. More...

std::unordered_set< asiolink::IOAddress, asiolink::IOAddress::Hash >	locked_leases_
	A set of locked leases. More...

Detailed Description

MySQL Lease Manager.

This class provides the isc::dhcp::LeaseMgr interface to the MySQL database. Use of this backend presupposes that a MySQL database is available and that the Kea schema has been created within it.

Definition at line 92 of file mysql_lease_mgr.h.

Member Enumeration Documentation

◆ StatementIndex

enum isc::dhcp::MySqlLeaseMgr::StatementIndex

Statement Tags.

The contents of the enum are indexes into the list of compiled SQL statements

Enumerator
DELETE_LEASE4
DELETE_LEASE4_STATE_EXPIRED
DELETE_LEASE6
DELETE_LEASE6_STATE_EXPIRED
GET_LEASE4
GET_LEASE4_ADDR
GET_LEASE4_CLIENTID
GET_LEASE4_CLIENTID_SUBID
GET_LEASE4_HWADDR
GET_LEASE4_HWADDR_SUBID
GET_LEASE4_PAGE
GET_LEASE4_UCTX_PAGE
GET_LEASE4_SUBID
GET_LEASE4_HOSTNAME
GET_LEASE4_EXPIRE
GET_LEASE4_RELAYID
GET_LEASE4_RELAYID_QST
GET_LEASE4_RELAYID_QSET
GET_LEASE4_RELAYID_QET
GET_LEASE4_REMOTEID
GET_LEASE4_REMOTEID_QST
GET_LEASE4_REMOTEID_QSET
GET_LEASE4_REMOTEID_QET
GET_LEASE6
GET_LEASE6_ADDR
GET_LEASE6_DUID_IAID
GET_LEASE6_DUID_IAID_SUBID
GET_LEASE6_PAGE
GET_LEASE6_UCTX_PAGE
GET_LEASE6_SUBID
GET_LEASE6_DUID
GET_LEASE6_HOSTNAME
GET_LEASE6_EXPIRE
GET_LEASE6_LINK
INSERT_LEASE4
INSERT_LEASE6
UPDATE_LEASE4
UPDATE_LEASE6
ALL_LEASE4_STATS
SUBNET_LEASE4_STATS
SUBNET_RANGE_LEASE4_STATS
ALL_POOL_LEASE4_STATS
ALL_LEASE6_STATS
SUBNET_LEASE6_STATS
SUBNET_RANGE_LEASE6_STATS
ALL_POOL_LEASE6_STATS
CHECK_LEASE4_LIMITS
CHECK_LEASE6_LIMITS
IS_JSON_SUPPORTED
GET_LEASE4_COUNT_BY_CLASS
GET_LEASE6_COUNT_BY_CLASS
WIPE_RELAY_ID6
WIPE_REMOTE_ID6
DELETE_RELAY_ID6
DELETE_REMOTE_ID6
ADD_RELAY_ID6
ADD_REMOTE_ID6
GET_RELAY_ID6
GET_REMOTE_ID6
GET_RELAY_ID6_LINK
GET_REMOTE_ID6_LINK
COUNT_RELAY_ID6
COUNT_REMOTE_ID6
NUM_STATEMENTS

Definition at line 719 of file mysql_lease_mgr.h.

Constructor & Destructor Documentation

◆ MySqlLeaseMgr()

isc::dhcp::MySqlLeaseMgr::MySqlLeaseMgr ( const db::DatabaseConnection::ParameterMap & parameters )

Constructor.

Uses the following keywords in the parameters passed to it to connect to the database:

name - Name of the database to which to connect (mandatory)
host - Host to which to connect (optional, defaults to "localhost")
user - Username under which to connect (optional)
password - Password for "user" on the database (optional)

Check the schema version and create an initial context.

Parameters

parameters A data structure relating keywords and values concerned with the database.

Exceptions

isc::dhcp::NoDatabaseName	Mandatory database name not given
isc::db::DbOpenError	Error opening the database or the schema version is incorrect.
isc::db::DbOperationError	An operation on the open database has failed.

Definition at line 2215 of file mysql_lease_mgr.cc.

References createContext(), getVersion(), isc_throw, isc::db::MYSQL_SCHEMA_VERSION_MAJOR, isc::db::MYSQL_SCHEMA_VERSION_MINOR, and isc::dhcp::LeaseMgr::setExtendedInfoTablesEnabled().

Here is the call graph for this function:

◆ ~MySqlLeaseMgr()

isc::dhcp::MySqlLeaseMgr::~MySqlLeaseMgr ( )

virtual

Destructor (closes database)

Definition at line 2243 of file mysql_lease_mgr.cc.

Member Function Documentation

◆ addLease() [1/2]

bool isc::dhcp::MySqlLeaseMgr::addLease ( const Lease4Ptr & lease )

overridevirtual

Adds an IPv4 lease.

Parameters

lease lease to be added

Returns: true if the lease was added, false if not (because a lease with the same address was already there).

Exceptions

isc::db::DbOperationError An operation on the open database has failed.

Implements isc::dhcp::LeaseMgr.

Definition at line 2390 of file mysql_lease_mgr.cc.

References isc::dhcp::DHCPSRV_DBG_TRACE_DETAIL, isc::dhcp::dhcpsrv_logger, isc::dhcp::DHCPSRV_MYSQL_ADD_ADDR4, isc::dhcp::TrackingLeaseMgr::hasCallbacks(), INSERT_LEASE4, LOG_DEBUG, and isc::dhcp::TrackingLeaseMgr::trackAddLease().

Here is the call graph for this function:

◆ addLease() [2/2]

bool isc::dhcp::MySqlLeaseMgr::addLease ( const Lease6Ptr & lease )

overridevirtual

Adds an IPv6 lease.

Parameters

lease lease to be added

Returns: true if the lease was added, false if not (because a lease with the same address was already there).

Exceptions

isc::db::DbOperationError An operation on the open database has failed.

Implements isc::dhcp::LeaseMgr.

Definition at line 2417 of file mysql_lease_mgr.cc.

References isc::dhcp::Lease6::ACTION_IGNORE, isc::dhcp::LeaseMgr::addExtendedInfo6(), isc::dhcp::DHCPSRV_DBG_TRACE_DETAIL, isc::dhcp::dhcpsrv_logger, isc::dhcp::DHCPSRV_MYSQL_ADD_ADDR6, isc::dhcp::LeaseMgr::getExtendedInfoTablesEnabled(), isc::dhcp::TrackingLeaseMgr::hasCallbacks(), INSERT_LEASE6, LOG_DEBUG, and isc::dhcp::TrackingLeaseMgr::trackAddLease().

Here is the call graph for this function:

◆ addRelayId6()

void isc::dhcp::MySqlLeaseMgr::addRelayId6	(	const isc::asiolink::IOAddress &	lease_addr,
		const std::vector< uint8_t > &	relay_id
	)

overrideprotectedvirtual

Add lease6 extended info into by-relay-id table.

Parameters

lease_addr	The address of the lease.
relay_id	The relay id from the relay header options.

Implements isc::dhcp::LeaseMgr.

Definition at line 3945 of file mysql_lease_mgr.cc.

References ADD_RELAY_ID6, isc_throw, isc::db::MysqlExecuteStatement(), and isc::asiolink::IOAddress::toBytes().

Here is the call graph for this function:

◆ addRemoteId6()

void isc::dhcp::MySqlLeaseMgr::addRemoteId6	(	const isc::asiolink::IOAddress &	lease_addr,
		const std::vector< uint8_t > &	remote_id
	)

overrideprotectedvirtual

Add lease6 extended info into by-remote-id table.

Parameters

lease_addr	The address of the lease.
remote_id	The remote id from the relay header options.

Implements isc::dhcp::LeaseMgr.

Definition at line 3989 of file mysql_lease_mgr.cc.

References ADD_REMOTE_ID6, isc_throw, isc::db::MysqlExecuteStatement(), and isc::asiolink::IOAddress::toBytes().

Here is the call graph for this function:

◆ byRelayId6size()

size_t isc::dhcp::MySqlLeaseMgr::byRelayId6size ( ) const

overridevirtual

Return the by-relay-id table size.

Returns: The size of the by-relay-id table.

Reimplemented from isc::dhcp::LeaseMgr.

Definition at line 4823 of file mysql_lease_mgr.cc.

References COUNT_RELAY_ID6, and isc::db::MysqlExecuteStatement().

Here is the call graph for this function:

◆ byRemoteId6size()

size_t isc::dhcp::MySqlLeaseMgr::byRemoteId6size ( ) const

overridevirtual

Return the by-remote-id table size.

Returns: The size of the by-remote-id table.

Reimplemented from isc::dhcp::LeaseMgr.

Definition at line 4861 of file mysql_lease_mgr.cc.

References COUNT_REMOTE_ID6, and isc::db::MysqlExecuteStatement().

Here is the call graph for this function:

◆ commit()

void isc::dhcp::MySqlLeaseMgr::commit ( )

overridevirtual

Commit Transactions.

Commits all pending database operations. On databases that don't support transactions, this is a no-op.

MySQL supports transactions but this manager does not use them.

Implements isc::dhcp::LeaseMgr.

Definition at line 3862 of file mysql_lease_mgr.cc.

References isc::dhcp::DHCPSRV_DBG_TRACE_DETAIL, isc::dhcp::dhcpsrv_logger, isc::dhcp::DHCPSRV_MYSQL_COMMIT, and LOG_DEBUG.

◆ createContext()

MySqlLeaseContextPtr isc::dhcp::MySqlLeaseMgr::createContext ( ) const

Create a new context.

The database is opened with all the SQL commands pre-compiled.

Returns: A new (never null) context.

Exceptions

isc::dhcp::NoDatabaseName	Mandatory database name not given.
isc::db::DbOperationError	An operation on the open database has failed.

Definition at line 2316 of file mysql_lease_mgr.cc.

References dbReconnect(), isc::dhcp::DHCPSRV_DBG_TRACE, isc::dhcp::dhcpsrv_logger, isc::dhcp::DHCPSRV_MYSQL_NO_TLS, isc::dhcp::DHCPSRV_MYSQL_TLS_CIPHER, isc::dhcp::LeaseMgr::getIOService(), LOG_DEBUG, and LOG_ERROR.

Referenced by MySqlLeaseMgr().

Here is the call graph for this function:

◆ dbReconnect()

bool isc::dhcp::MySqlLeaseMgr::dbReconnect ( util::ReconnectCtlPtr db_reconnect_ctl )

static

Attempts to reconnect the server to the lease DB backend manager.

This is a self-rescheduling function that attempts to reconnect to the server's lease DB backends after connectivity to one or more have been lost. Upon entry it will attempt to reconnect via LeaseMgrFactory::create. If this is successful, DHCP servicing is re-enabled and server returns to normal operation.

If reconnection fails and the maximum number of retries has not been exhausted, it will schedule a call to itself to occur at the configured retry interval. DHCP service remains disabled.

If the maximum number of retries has been exhausted an error is logged and the server shuts down.

This function is passed to the connection recovery mechanism. It will be invoked when a connection loss is detected.

Parameters

db_reconnect_ctl pointer to the ReconnectCtl containing the configured reconnect parameters.

Returns: true if connection has been recovered, false otherwise.

Definition at line 2247 of file mysql_lease_mgr.cc.

References isc::dhcp::dhcpsrv_logger, isc::dhcp::DHCPSRV_MYSQL_LEASE_DB_RECONNECT_ATTEMPT_FAILED, isc::dhcp::DHCPSRV_MYSQL_LEASE_DB_RECONNECT_ATTEMPT_SCHEDULE, isc::dhcp::DHCPSRV_MYSQL_LEASE_DB_RECONNECT_FAILED, isc::dhcp::CfgMgr::getCurrentCfg(), isc::dhcp::CfgMgr::instance(), isc::dhcp::TimerMgr::instance(), isc::db::DatabaseConnection::invokeDbFailedCallback(), isc::db::DatabaseConnection::invokeDbLostCallback(), isc::db::DatabaseConnection::invokeDbRecoveredCallback(), LOG_ERROR, LOG_INFO, isc::asiolink::IntervalTimer::ONE_SHOT, and isc::dhcp::LeaseMgrFactory::recreate().

Referenced by createContext().

Here is the call graph for this function:

◆ deleteExpiredReclaimedLeases4()

uint64_t isc::dhcp::MySqlLeaseMgr::deleteExpiredReclaimedLeases4 ( const uint32_t secs )

overridevirtual

Deletes all expired-reclaimed DHCPv4 leases.

Parameters

secs	Number of seconds since expiration of leases before they can be removed. Leases which have expired later than this time will not be deleted.

Returns: Number of leases deleted.

Implements isc::dhcp::LeaseMgr.

Definition at line 3549 of file mysql_lease_mgr.cc.

References DELETE_LEASE4_STATE_EXPIRED, isc::dhcp::DHCPSRV_DBG_TRACE_DETAIL, isc::dhcp::dhcpsrv_logger, isc::dhcp::DHCPSRV_MYSQL_DELETE_EXPIRED_RECLAIMED4, and LOG_DEBUG.

◆ deleteExpiredReclaimedLeases6()

uint64_t isc::dhcp::MySqlLeaseMgr::deleteExpiredReclaimedLeases6 ( const uint32_t secs )

overridevirtual

Deletes all expired-reclaimed DHCPv6 leases.

Parameters

secs	Number of seconds since expiration of leases before they can be removed. Leases which have expired later than this time will not be deleted.

Returns: Number of leases deleted.

Implements isc::dhcp::LeaseMgr.

Definition at line 3556 of file mysql_lease_mgr.cc.

References DELETE_LEASE6_STATE_EXPIRED, isc::dhcp::DHCPSRV_DBG_TRACE_DETAIL, isc::dhcp::dhcpsrv_logger, isc::dhcp::DHCPSRV_MYSQL_DELETE_EXPIRED_RECLAIMED6, and LOG_DEBUG.

◆ deleteExtendedInfo6()

void isc::dhcp::MySqlLeaseMgr::deleteExtendedInfo6 ( const isc::asiolink::IOAddress & addr )

overrideprotectedvirtual

Extended information / Bulk Lease Query shared interface.

Delete lease6 extended info from tables.

Parameters

addr	The address of the lease.

Implements isc::dhcp::LeaseMgr.

Definition at line 3879 of file mysql_lease_mgr.cc.

Referenced by updateLease6().

◆ deleteLease() [1/2]

bool isc::dhcp::MySqlLeaseMgr::deleteLease ( const Lease4Ptr & lease )

overridevirtual

Deletes an IPv4 lease.

Parameters

lease IPv4 lease being deleted.

Returns: true if deletion was successful, false if no such lease exists.

Note: The current_cltt_ and current_valid_lft_ are used to maximize the chance that only one thread or process performs an update or delete operation on the lease by matching these values with the expiration time data in the database.; The DELETE query uses WHERE expire = ? to delete the lease only if the value matches the one received on the SELECT query, effectively enforcing no update on the lease between SELECT and DELETE with different expiration time.

Implements isc::dhcp::LeaseMgr.

Definition at line 3428 of file mysql_lease_mgr.cc.

References isc::db::MySqlConnection::convertToDatabaseTime(), DELETE_LEASE4, isc::dhcp::DHCPSRV_DBG_TRACE_DETAIL, isc::dhcp::dhcpsrv_logger, isc::dhcp::DHCPSRV_MYSQL_DELETE_ADDR, isc::dhcp::TrackingLeaseMgr::hasCallbacks(), isc::dhcp::Lease::INFINITY_LFT, isc_throw, LOG_DEBUG, isc::db::MLM_TRUE, isc::asiolink::IOAddress::toText(), isc::asiolink::IOAddress::toUint32(), and isc::dhcp::TrackingLeaseMgr::trackDeleteLease().

Here is the call graph for this function:

◆ deleteLease() [2/2]

bool isc::dhcp::MySqlLeaseMgr::deleteLease ( const Lease6Ptr & lease )

overridevirtual

Deletes an IPv6 lease.

Parameters

lease IPv6 lease being deleted.

Returns: true if deletion was successful, false if no such lease exists.

Note: The current_cltt_ and current_valid_lft_ are used to maximize the chance that only one thread or process performs an update or delete operation on the lease by matching these values with the expiration time data in the database.; The DELETE query uses WHERE expire = ? to delete the lease only if the value matches the one received on the SELECT query, effectively enforcing no update on the lease between SELECT and DELETE with different expiration time.

Implements isc::dhcp::LeaseMgr.

Definition at line 3482 of file mysql_lease_mgr.cc.

References isc::dhcp::Lease6::ACTION_IGNORE, isc::db::MySqlConnection::convertToDatabaseTime(), DELETE_LEASE6, isc::dhcp::DHCPSRV_DBG_TRACE_DETAIL, isc::dhcp::dhcpsrv_logger, isc::dhcp::DHCPSRV_MYSQL_DELETE_ADDR, isc::dhcp::TrackingLeaseMgr::hasCallbacks(), isc::dhcp::Lease::INFINITY_LFT, isc_throw, LOG_DEBUG, isc::asiolink::IOAddress::toBytes(), isc::asiolink::IOAddress::toText(), and isc::dhcp::TrackingLeaseMgr::trackDeleteLease().

Here is the call graph for this function:

◆ getDBVersion()

std::string isc::dhcp::MySqlLeaseMgr::getDBVersion ( )

static

Local version of getDBVersion() class method.

Definition at line 2352 of file mysql_lease_mgr.cc.

References isc::db::MYSQL_SCHEMA_VERSION_MAJOR, and isc::db::MYSQL_SCHEMA_VERSION_MINOR.

Referenced by isc::dhcp::Dhcpv4Srv::getVersion(), and isc::dhcp::Dhcpv6Srv::getVersion().

◆ getDescription()

std::string isc::dhcp::MySqlLeaseMgr::getDescription ( ) const

overridevirtual

Returns description of the backend.

This description may be multiline text that describes the backend.

Returns: Description of the backend.

Implements isc::dhcp::LeaseMgr.

Definition at line 3850 of file mysql_lease_mgr.cc.

◆ getExpiredLeases4()

void isc::dhcp::MySqlLeaseMgr::getExpiredLeases4	(	Lease4Collection &	expired_leases,
		const size_t	max_leases
	)		const

overridevirtual

Returns a collection of expired DHCPv4 leases.

This method returns at most max_leases expired leases. The leases returned haven't been reclaimed, i.e. the database query must exclude reclaimed leases from the results returned.

Parameters

[out]	expired_leases	A container to which expired leases returned by the database backend are added.
	max_leases	A maximum number of leases to be returned. If this value is set to 0, all expired (but not reclaimed) leases are returned.

Implements isc::dhcp::LeaseMgr.

Definition at line 3179 of file mysql_lease_mgr.cc.

References isc::dhcp::DHCPSRV_DBG_TRACE_DETAIL, isc::dhcp::dhcpsrv_logger, isc::dhcp::DHCPSRV_MYSQL_GET_EXPIRED4, GET_LEASE4_EXPIRE, and LOG_DEBUG.

◆ getExpiredLeases6()

void isc::dhcp::MySqlLeaseMgr::getExpiredLeases6	(	Lease6Collection &	expired_leases,
		const size_t	max_leases
	)		const

overridevirtual

Returns a collection of expired DHCPv6 leases.

This method returns at most max_leases expired leases. The leases returned haven't been reclaimed, i.e. the database query must exclude reclaimed leases from the results returned.

Parameters

[out]	expired_leases	A container to which expired leases returned by the database backend are added.
	max_leases	A maximum number of leases to be returned. If this value is set to 0, all expired (but not reclaimed) leases are returned.

Implements isc::dhcp::LeaseMgr.

Definition at line 3187 of file mysql_lease_mgr.cc.

References isc::dhcp::DHCPSRV_DBG_TRACE_DETAIL, isc::dhcp::dhcpsrv_logger, isc::dhcp::DHCPSRV_MYSQL_GET_EXPIRED6, GET_LEASE6_EXPIRE, and LOG_DEBUG.

◆ getLease4() [1/5]

Lease4Collection isc::dhcp::MySqlLeaseMgr::getLease4 ( const ClientId & clientid ) const

overridevirtual

Returns existing IPv4 leases for specified client-id.

Although in the usual case there will be only one lease, for mobile clients or clients with multiple static/fixed/reserved leases there can be more than one. Thus return type is a container, not a single pointer.

Parameters

clientid client identifier

Returns: lease collection

Exceptions

isc::dhcp::DataTruncation	Data was truncated on retrieval to fit into the space allocated for the result. This indicates a programming error.
isc::db::DbOperationError	An operation on the open database has failed.

Implements isc::dhcp::LeaseMgr.

Definition at line 2697 of file mysql_lease_mgr.cc.

References isc::dhcp::DHCPSRV_DBG_TRACE_DETAIL, isc::dhcp::dhcpsrv_logger, isc::dhcp::DHCPSRV_MYSQL_GET_CLIENTID, GET_LEASE4_CLIENTID, isc::dhcp::ClientId::getClientId(), LOG_DEBUG, and isc::dhcp::IdentifierType< min_size, max_size >::toText().

Here is the call graph for this function:

◆ getLease4() [2/5]

Lease4Ptr isc::dhcp::MySqlLeaseMgr::getLease4	(	const ClientId &	clientid,
		SubnetID	subnet_id
	)		const

overridevirtual

Returns existing IPv4 lease for specified client-id.

There can be at most one lease for a given HW address in a single pool, so this method with either return a single lease or NULL.

Parameters

clientid	client identifier
subnet_id	identifier of the subnet that lease must belong to

Returns: a pointer to the lease (or NULL if a lease is not found)

Exceptions

isc::dhcp::DataTruncation	Data was truncated on retrieval to fit into the space allocated for the result. This indicates a programming error.
isc::db::DbOperationError	An operation on the open database has failed.

Implements isc::dhcp::LeaseMgr.

Definition at line 2733 of file mysql_lease_mgr.cc.

References isc::dhcp::DHCPSRV_DBG_TRACE_DETAIL, isc::dhcp::dhcpsrv_logger, isc::dhcp::DHCPSRV_MYSQL_GET_SUBID_CLIENTID, GET_LEASE4_CLIENTID_SUBID, isc::dhcp::ClientId::getClientId(), LOG_DEBUG, isc::db::MLM_TRUE, and isc::dhcp::IdentifierType< min_size, max_size >::toText().

Here is the call graph for this function:

◆ getLease4() [3/5]

Lease4Ptr isc::dhcp::MySqlLeaseMgr::getLease4 ( const isc::asiolink::IOAddress & addr ) const

overridevirtual

Returns an IPv4 lease for specified IPv4 address.

This method return a lease that is associated with a given address. For other query types (by hardware addr, by Client ID) there can be several leases in different subnets (e.g. for mobile clients that got address in different subnets). However, for a single address there can be only one lease, so this method returns a pointer to a single lease, not a container of leases.

Parameters

addr	address of the searched lease

Returns: smart pointer to the lease (or NULL if a lease is not found)

Exceptions

isc::dhcp::DataTruncation	Data was truncated on retrieval to fit into the space allocated for the result. This indicates a programming error.
isc::db::DbOperationError	An operation on the open database has failed.

Implements isc::dhcp::LeaseMgr.

Definition at line 2584 of file mysql_lease_mgr.cc.

References isc::dhcp::DHCPSRV_DBG_TRACE_DETAIL, isc::dhcp::dhcpsrv_logger, isc::dhcp::DHCPSRV_MYSQL_GET_ADDR4, GET_LEASE4_ADDR, LOG_DEBUG, isc::db::MLM_TRUE, isc::asiolink::IOAddress::toText(), and isc::asiolink::IOAddress::toUint32().

Here is the call graph for this function:

◆ getLease4() [4/5]

Lease4Collection isc::dhcp::MySqlLeaseMgr::getLease4 ( const isc::dhcp::HWAddr & hwaddr ) const

overridevirtual

Returns existing IPv4 leases for specified hardware address.

Although in the usual case there will be only one lease, for mobile clients or clients with multiple static/fixed/reserved leases there can be more than one. Thus return type is a container, not a single pointer.

Parameters

hwaddr hardware address of the client

Returns: lease collection

Exceptions

isc::dhcp::DataTruncation	Data was truncated on retrieval to fit into the space allocated for the result. This indicates a programming error.
isc::db::DbOperationError	An operation on the open database has failed.

Implements isc::dhcp::LeaseMgr.

Definition at line 2610 of file mysql_lease_mgr.cc.

References isc::dhcp::DHCPSRV_DBG_TRACE_DETAIL, isc::dhcp::dhcpsrv_logger, isc::dhcp::DHCPSRV_MYSQL_GET_HWADDR, GET_LEASE4_HWADDR, isc::dhcp::HWAddr::hwaddr_, LOG_DEBUG, and isc::dhcp::HWAddr::toText().

Here is the call graph for this function:

◆ getLease4() [5/5]

Lease4Ptr isc::dhcp::MySqlLeaseMgr::getLease4	(	const isc::dhcp::HWAddr &	hwaddr,
		SubnetID	subnet_id
	)		const

overridevirtual

Returns existing IPv4 leases for specified hardware address and a subnet.

There can be at most one lease for a given HW address in a single pool, so this method with either return a single lease or NULL.

Parameters

hwaddr	hardware address of the client
subnet_id	identifier of the subnet that lease must belong to

Returns: a pointer to the lease (or NULL if a lease is not found)

Exceptions

isc::dhcp::DataTruncation	Data was truncated on retrieval to fit into the space allocated for the result. This indicates a programming error.
isc::db::DbOperationError	An operation on the open database has failed.

Implements isc::dhcp::LeaseMgr.

Definition at line 2651 of file mysql_lease_mgr.cc.

References isc::dhcp::DHCPSRV_DBG_TRACE_DETAIL, isc::dhcp::dhcpsrv_logger, isc::dhcp::DHCPSRV_MYSQL_GET_SUBID_HWADDR, GET_LEASE4_HWADDR_SUBID, isc::dhcp::HWAddr::hwaddr_, LOG_DEBUG, isc::db::MLM_TRUE, and isc::dhcp::HWAddr::toText().

Here is the call graph for this function:

◆ getLease6()

Lease6Ptr isc::dhcp::MySqlLeaseMgr::getLease6	(	Lease::Type	type,
		const isc::asiolink::IOAddress &	addr
	)		const

overridevirtual

Returns existing IPv6 lease for a given IPv6 address.

For a given address, we assume that there will be only one lease. The assumption here is that there will not be site or link-local addresses used, so there is no way of having address duplication.

Parameters

type	specifies lease type: (NA, TA or PD)
addr	address of the searched lease

Returns: smart pointer to the lease (or NULL if a lease is not found)

Exceptions

isc::BadValue	record retrieved from database had an invalid lease type field.
isc::dhcp::DataTruncation	Data was truncated on retrieval to fit into the space allocated for the result. This indicates a programming error.
isc::db::DbOperationError	An operation on the open database has failed.

Implements isc::dhcp::LeaseMgr.

Definition at line 2883 of file mysql_lease_mgr.cc.

References isc::dhcp::DHCPSRV_DBG_TRACE_DETAIL, isc::dhcp::dhcpsrv_logger, isc::dhcp::DHCPSRV_MYSQL_GET_ADDR6, GET_LEASE6_ADDR, isc_throw, LOG_DEBUG, isc::db::MLM_TRUE, isc::asiolink::IOAddress::toBytes(), and isc::asiolink::IOAddress::toText().

Here is the call graph for this function:

◆ getLeases4() [1/4]

Lease4Collection isc::dhcp::MySqlLeaseMgr::getLeases4 ( ) const

overridevirtual

Returns all IPv4 leases.

Returns: Lease collection (may be empty if no IPv4 lease found).

Implements isc::dhcp::LeaseMgr.

Definition at line 2826 of file mysql_lease_mgr.cc.

References isc::dhcp::DHCPSRV_DBG_TRACE_DETAIL, isc::dhcp::dhcpsrv_logger, isc::dhcp::DHCPSRV_MYSQL_GET4, GET_LEASE4, and LOG_DEBUG.

◆ getLeases4() [2/4]

Lease4Collection isc::dhcp::MySqlLeaseMgr::getLeases4	(	const asiolink::IOAddress &	lower_bound_address,
		const LeasePageSize &	page_size
	)		const

overridevirtual

Returns range of IPv4 leases using paging.

This method implements paged browsing of the lease database. The first parameter specifies a page size. The second parameter is optional and specifies the starting address of the range. This address is excluded from the returned range. The IPv4 zero address (default) denotes that the first page should be returned. There is no guarantee about the order of returned leases.

The typical usage of this method is as follows:

Get the first page of leases by specifying IPv4 zero address as the beginning of the range.
Last address of the returned range should be used as a starting address for the next page in the subsequent call.
If the number of leases returned is lower than the page size, it indicates that the last page has been retrieved.
If there are no leases returned it indicates that the previous page was the last page.

Parameters

lower_bound_address	IPv4 address used as lower bound for the returned range.
page_size	maximum size of the page returned.

Returns: Lease collection (may be empty if no IPv4 lease found).

Implements isc::dhcp::LeaseMgr.

Definition at line 2841 of file mysql_lease_mgr.cc.

References isc::dhcp::DHCPSRV_DBG_TRACE_DETAIL, isc::dhcp::dhcpsrv_logger, isc::dhcp::DHCPSRV_MYSQL_GET_PAGE4, GET_LEASE4_PAGE, isc_throw, isc::asiolink::IOAddress::isV4(), LOG_DEBUG, isc::db::MLM_TRUE, isc::dhcp::LeasePageSize::page_size_, isc::asiolink::IOAddress::toText(), and isc::asiolink::IOAddress::toUint32().

Here is the call graph for this function:

◆ getLeases4() [3/4]

Lease4Collection isc::dhcp::MySqlLeaseMgr::getLeases4 ( const std::string & hostname ) const

overridevirtual

Returns all IPv4 leases for the particular hostname.

Parameters

hostname hostname in lower case.

Returns: Lease collection (may be empty if no IPv4 lease found).

Implements isc::dhcp::LeaseMgr.

Definition at line 2800 of file mysql_lease_mgr.cc.

References isc::dhcp::DHCPSRV_DBG_TRACE_DETAIL, isc::dhcp::dhcpsrv_logger, isc::dhcp::DHCPSRV_MYSQL_GET_HOSTNAME4, GET_LEASE4_HOSTNAME, and LOG_DEBUG.

◆ getLeases4() [4/4]

Lease4Collection isc::dhcp::MySqlLeaseMgr::getLeases4 ( SubnetID subnet_id ) const

overridevirtual

Returns all IPv4 leases for the particular subnet identifier.

Parameters

subnet_id subnet identifier.

Returns: Lease collection (may be empty if no IPv4 lease found).

Implements isc::dhcp::LeaseMgr.

Definition at line 2774 of file mysql_lease_mgr.cc.

References isc::dhcp::DHCPSRV_DBG_TRACE_DETAIL, isc::dhcp::dhcpsrv_logger, isc::dhcp::DHCPSRV_MYSQL_GET_SUBID4, GET_LEASE4_SUBID, LOG_DEBUG, and isc::db::MLM_TRUE.

◆ getLeases4ByRelayId()

Lease4Collection isc::dhcp::MySqlLeaseMgr::getLeases4ByRelayId	(	const OptionBuffer &	relay_id,
		const asiolink::IOAddress &	lower_bound_address,
		const LeasePageSize &	page_size,
		const time_t &	qry_start_time = `0`,
		const time_t &	qry_end_time = `0`
	)

overridevirtual

The following queries are used to fulfill Bulk Lease Query queries.

They rely on relay data contained in lease's user-context when the extended-store-info flag is enabled.

Returns existing IPv4 leases with a given relay-id.

Parameters

relay_id	RAI Relay-ID sub-option value for relay_id of interest
lower_bound_address	IPv4 address used as lower bound for the returned range.
page_size	maximum size of the page returned.
qry_start_time	when not zero, only leases whose CLTT is greater than or equal to this value will be included
qry_end_time	when not zero, only leases whose CLTT is less than or equal to this value will be included

Returns: collection of IPv4 leases

Implements isc::dhcp::LeaseMgr.

Definition at line 4054 of file mysql_lease_mgr.cc.

References isc::dhcp::DHCPSRV_DBG_TRACE_DETAIL, isc::dhcp::dhcpsrv_logger, isc::dhcp::DHCPSRV_MYSQL_GET_RELAYID4, GET_LEASE4_RELAYID, GET_LEASE4_RELAYID_QET, GET_LEASE4_RELAYID_QSET, GET_LEASE4_RELAYID_QST, isc_throw, isc::asiolink::IOAddress::isV4(), LOG_DEBUG, isc::db::MLM_TRUE, isc::dhcp::LeasePageSize::page_size_, isc::asiolink::IOAddress::toText(), and isc::asiolink::IOAddress::toUint32().

Here is the call graph for this function:

◆ getLeases4ByRemoteId()

Lease4Collection isc::dhcp::MySqlLeaseMgr::getLeases4ByRemoteId	(	const OptionBuffer &	remote_id,
		const asiolink::IOAddress &	lower_bound_address,
		const LeasePageSize &	page_size,
		const time_t &	qry_start_time = `0`,
		const time_t &	qry_end_time = `0`
	)

overridevirtual

Returns existing IPv4 leases with a given remote-id.

Parameters

remote_id	RAI Remote-ID sub-option value for remote-id of interest
lower_bound_address	IPv4 address used as lower bound for the returned range.
page_size	maximum size of the page returned.
qry_start_time	when not zero, only leases whose CLTT is greater than or equal to this value will be included. Defaults to zero.
qry_end_time	when not zero, only leases whose CLTT is less than or equal to this value will be included. Defaults to zero.

Returns: collection of IPv4 leases

Implements isc::dhcp::LeaseMgr.

Definition at line 4166 of file mysql_lease_mgr.cc.

References isc::dhcp::DHCPSRV_DBG_TRACE_DETAIL, isc::dhcp::dhcpsrv_logger, isc::dhcp::DHCPSRV_MYSQL_GET_REMOTEID4, GET_LEASE4_REMOTEID, GET_LEASE4_REMOTEID_QET, GET_LEASE4_REMOTEID_QSET, GET_LEASE4_REMOTEID_QST, isc_throw, isc::asiolink::IOAddress::isV4(), LOG_DEBUG, isc::db::MLM_TRUE, isc::dhcp::LeasePageSize::page_size_, isc::asiolink::IOAddress::toText(), and isc::asiolink::IOAddress::toUint32().

Here is the call graph for this function:

◆ getLeases6() [1/7]

Lease6Collection isc::dhcp::MySqlLeaseMgr::getLeases6 ( ) const

overridevirtual

Returns all IPv6 leases.

Returns: Lease collection (may be empty if no IPv6 lease found).

Implements isc::dhcp::LeaseMgr.

Definition at line 3061 of file mysql_lease_mgr.cc.

References isc::dhcp::DHCPSRV_DBG_TRACE_DETAIL, isc::dhcp::dhcpsrv_logger, isc::dhcp::DHCPSRV_MYSQL_GET6, GET_LEASE6, and LOG_DEBUG.

◆ getLeases6() [2/7]

Lease6Collection isc::dhcp::MySqlLeaseMgr::getLeases6	(	const asiolink::IOAddress &	lower_bound_address,
		const LeasePageSize &	page_size
	)		const

overridevirtual

Returns range of IPv6 leases using paging.

This method implements paged browsing of the lease database. The first parameter specifies a page size. The second parameter is optional and specifies the starting address of the range. This address is excluded from the returned range. The IPv6 zero address (default) denotes that the first page should be returned. There is no guarantee about the order of returned leases.

The typical usage of this method is as follows:

Get the first page of leases by specifying IPv6 zero address as the beginning of the range.
Last address of the returned range should be used as a starting address for the next page in the subsequent call.
If the number of leases returned is lower than the page size, it indicates that the last page has been retrieved.
If there are no leases returned it indicates that the previous page was the last page.

Parameters

lower_bound_address	IPv6 address used as lower bound for the returned range.
page_size	maximum size of the page returned.

Returns: Lease collection (may be empty if no IPv6 lease found).

Implements isc::dhcp::LeaseMgr.

Definition at line 3131 of file mysql_lease_mgr.cc.

References isc::dhcp::DHCPSRV_DBG_TRACE_DETAIL, isc::dhcp::dhcpsrv_logger, isc::dhcp::DHCPSRV_MYSQL_GET_PAGE6, GET_LEASE6_PAGE, isc_throw, isc::asiolink::IOAddress::isV6(), LOG_DEBUG, isc::db::MLM_TRUE, isc::dhcp::LeasePageSize::page_size_, isc::asiolink::IOAddress::toBytes(), and isc::asiolink::IOAddress::toText().

Here is the call graph for this function:

◆ getLeases6() [3/7]

Lease6Collection isc::dhcp::MySqlLeaseMgr::getLeases6 ( const DUID & duid ) const

overridevirtual

Returns all IPv6 leases for the DUID.

Todo:: : implement an optimised of the query using index.

Returns: Lease collection (may be empty if no IPv6 lease found) for the DUID.

Implements isc::dhcp::LeaseMgr.

Definition at line 3076 of file mysql_lease_mgr.cc.

References isc::dhcp::DHCPSRV_DBG_TRACE_DETAIL, isc::dhcp::dhcpsrv_logger, isc::dhcp::DHCPSRV_MYSQL_GET_DUID, GET_LEASE6_DUID, isc::dhcp::DUID::getDuid(), LOG_DEBUG, and isc::dhcp::IdentifierType< min_size, max_size >::toText().

Here is the call graph for this function:

◆ getLeases6() [4/7]

Lease6Collection isc::dhcp::MySqlLeaseMgr::getLeases6 ( const std::string & hostname ) const

overridevirtual

Returns all IPv6 leases for the particular hostname.

Parameters

hostname hostname in lower case.

Returns: Lease collection (may be empty if no IPv6 lease found).

Implements isc::dhcp::LeaseMgr.

Definition at line 3105 of file mysql_lease_mgr.cc.

References isc::dhcp::DHCPSRV_DBG_TRACE_DETAIL, isc::dhcp::dhcpsrv_logger, isc::dhcp::DHCPSRV_MYSQL_GET_HOSTNAME6, GET_LEASE6_HOSTNAME, and LOG_DEBUG.

◆ getLeases6() [5/7]

Lease6Collection isc::dhcp::MySqlLeaseMgr::getLeases6	(	Lease::Type	type,
		const DUID &	duid,
		uint32_t	iaid
	)		const

overridevirtual

Returns existing IPv6 leases for a given DUID+IA combination.

Although in the usual case there will be only one lease, for mobile clients or clients with multiple static/fixed/reserved leases there can be more than one. Thus return type is a container, not a single pointer.

Parameters

type	specifies lease type: (NA, TA or PD)
duid	client DUID
iaid	IA identifier

Returns: smart pointer to the lease (or NULL if a lease is not found)

Exceptions

isc::BadValue	record retrieved from database had an invalid lease type field.
isc::dhcp::DataTruncation	Data was truncated on retrieval to fit into the space allocated for the result. This indicates a programming error.
isc::db::DbOperationError	An operation on the open database has failed.

Implements isc::dhcp::LeaseMgr.

Definition at line 2922 of file mysql_lease_mgr.cc.

References isc::dhcp::DHCPSRV_DBG_TRACE_DETAIL, isc::dhcp::dhcpsrv_logger, isc::dhcp::DHCPSRV_MYSQL_GET_IAID_DUID, GET_LEASE6_DUID_IAID, isc::dhcp::DUID::getDuid(), LOG_DEBUG, isc::db::MLM_TRUE, and isc::dhcp::IdentifierType< min_size, max_size >::toText().

Here is the call graph for this function:

◆ getLeases6() [6/7]

Lease6Collection isc::dhcp::MySqlLeaseMgr::getLeases6	(	Lease::Type	type,
		const DUID &	duid,
		uint32_t	iaid,
		SubnetID	subnet_id
	)		const

overridevirtual

Returns existing IPv6 lease for a given DUID+IA combination.

Parameters

type	specifies lease type: (NA, TA or PD)
duid	client DUID
iaid	IA identifier
subnet_id	subnet id of the subnet the lease belongs to

Returns: lease collection (may be empty if no lease is found)

Exceptions

isc::BadValue	record retrieved from database had an invalid lease type field.
isc::dhcp::DataTruncation	Data was truncated on retrieval to fit into the space allocated for the result. This indicates a programming error.
isc::db::DbOperationError	An operation on the open database has failed.

Implements isc::dhcp::LeaseMgr.

Definition at line 2985 of file mysql_lease_mgr.cc.

References isc::dhcp::DHCPSRV_DBG_TRACE_DETAIL, isc::dhcp::dhcpsrv_logger, isc::dhcp::DHCPSRV_MYSQL_GET_IAID_SUBID_DUID, GET_LEASE6_DUID_IAID_SUBID, isc::dhcp::DUID::getDuid(), LOG_DEBUG, isc::db::MLM_TRUE, and isc::dhcp::IdentifierType< min_size, max_size >::toText().

Here is the call graph for this function:

◆ getLeases6() [7/7]

Lease6Collection isc::dhcp::MySqlLeaseMgr::getLeases6 ( SubnetID subnet_id ) const

overridevirtual

Returns all IPv6 leases for the particular subnet identifier.

Parameters

subnet_id subnet identifier.

Returns: Lease collection (may be empty if no IPv6 lease found).

Implements isc::dhcp::LeaseMgr.

Definition at line 3035 of file mysql_lease_mgr.cc.

References isc::dhcp::DHCPSRV_DBG_TRACE_DETAIL, isc::dhcp::dhcpsrv_logger, isc::dhcp::DHCPSRV_MYSQL_GET_SUBID6, GET_LEASE6_SUBID, LOG_DEBUG, and isc::db::MLM_TRUE.

◆ getLeases6ByLink()

Lease6Collection isc::dhcp::MySqlLeaseMgr::getLeases6ByLink	(	const asiolink::IOAddress &	link_addr,
		uint8_t	link_len,
		const asiolink::IOAddress &	lower_bound_address,
		const LeasePageSize &	page_size
	)

overridevirtual

Returns existing IPv6 leases with on a given link.

Parameters

link_addr	limit results to leases on this link (prefix).
link_len	limit results to leases on this link (length).
lower_bound_address	IPv4 address used as lower bound for the returned range.
page_size	maximum size of the page returned.

Returns: collection of IPv6 leases

Implements isc::dhcp::LeaseMgr.

Definition at line 4629 of file mysql_lease_mgr.cc.

References isc::dhcp::DHCPSRV_DBG_TRACE_DETAIL, isc::dhcp::dhcpsrv_logger, isc::dhcp::DHCPSRV_MYSQL_GET_LINKADDR6, isc::asiolink::firstAddrInPrefix(), GET_LEASE6_LINK, isc::asiolink::IOAddress::increase(), isc_throw, isc::asiolink::IOAddress::isV6(), isc::asiolink::lastAddrInPrefix(), LOG_DEBUG, isc::db::MLM_TRUE, isc::dhcp::LeasePageSize::page_size_, isc::asiolink::IOAddress::toBytes(), and isc::asiolink::IOAddress::toText().

Here is the call graph for this function:

◆ getLeases6ByRelayId()

Lease6Collection isc::dhcp::MySqlLeaseMgr::getLeases6ByRelayId	(	const DUID &	relay_id,
		const asiolink::IOAddress &	link_addr,
		uint8_t	link_len,
		const asiolink::IOAddress &	lower_bound_address,
		const LeasePageSize &	page_size
	)

overridevirtual

Returns existing IPv6 leases with a given relay-id.

Parameters

relay_id	DUID for relay_id of interest.
link_addr	limit results to leases on this link (prefix).
link_len	limit results to leases on this link (length).
lower_bound_address	IPv4 address used as lower bound for the returned range.
page_size	maximum size of the page returned.

Returns: collection of IPv6 leases

Implements isc::dhcp::LeaseMgr.

Definition at line 4367 of file mysql_lease_mgr.cc.

References isc::dhcp::DHCPSRV_DBG_TRACE_DETAIL, isc::dhcp::dhcpsrv_logger, isc::dhcp::DHCPSRV_MYSQL_GET_RELAYID6, isc::asiolink::firstAddrInPrefix(), GET_RELAY_ID6, GET_RELAY_ID6_LINK, isc::dhcp::DUID::getDuid(), isc::asiolink::IOAddress::increase(), isc_throw, isc::asiolink::IOAddress::isV6(), isc::asiolink::lastAddrInPrefix(), LOG_DEBUG, isc::db::MLM_TRUE, isc::dhcp::LeasePageSize::page_size_, isc::asiolink::IOAddress::toBytes(), isc::asiolink::IOAddress::toText(), and isc::dhcp::IdentifierType< min_size, max_size >::toText().

Here is the call graph for this function:

◆ getLeases6ByRemoteId()

Lease6Collection isc::dhcp::MySqlLeaseMgr::getLeases6ByRemoteId	(	const OptionBuffer &	remote_id,
		const asiolink::IOAddress &	link_addr,
		uint8_t	link_len,
		const asiolink::IOAddress &	lower_bound_address,
		const LeasePageSize &	page_size
	)

overridevirtual

Returns existing IPv6 leases with a given remote-id.

Parameters

remote_id	remote-id option data of interest.
link_addr	limit results to leases on this link (prefix).
link_len	limit results to leases on this link (length).
lower_bound_address	IPv4 address used as lower bound for the returned range.
page_size	maximum size of the page returned.

Returns: collection of IPv6 leases

Implements isc::dhcp::LeaseMgr.

Definition at line 4498 of file mysql_lease_mgr.cc.

References isc::dhcp::DHCPSRV_DBG_TRACE_DETAIL, isc::dhcp::dhcpsrv_logger, isc::dhcp::DHCPSRV_MYSQL_GET_REMOTEID6, isc::asiolink::firstAddrInPrefix(), GET_REMOTE_ID6, GET_REMOTE_ID6_LINK, isc::asiolink::IOAddress::increase(), isc_throw, isc::asiolink::IOAddress::isV6(), isc::asiolink::lastAddrInPrefix(), LOG_DEBUG, isc::db::MLM_TRUE, isc::dhcp::LeasePageSize::page_size_, isc::asiolink::IOAddress::toBytes(), and isc::asiolink::IOAddress::toText().

Here is the call graph for this function:

◆ getName()

std::string isc::dhcp::MySqlLeaseMgr::getName ( ) const

overridevirtual

Returns backend name.

Each backend have specific name.

Returns: Name of the backend.

Implements isc::dhcp::LeaseMgr.

Definition at line 3835 of file mysql_lease_mgr.cc.

◆ getType()

virtual std::string isc::dhcp::MySqlLeaseMgr::getType ( ) const

inlineoverridevirtual

Return backend type.

Returns the type of the backend (e.g. "mysql", "memfile" etc.)

Returns: Type of the backend.

Implements isc::dhcp::LeaseMgr.

Definition at line 672 of file mysql_lease_mgr.h.

◆ getVersion()

std::pair< uint32_t, uint32_t > isc::dhcp::MySqlLeaseMgr::getVersion ( ) const

overridevirtual

Returns backend version.

Returns: Version number as a pair of unsigned integers. "first" is the major version number, "second" the minor number.

Exceptions

isc::db::DbOperationError An operation on the open database has failed.

Implements isc::dhcp::LeaseMgr.

Definition at line 3855 of file mysql_lease_mgr.cc.

References isc::dhcp::DHCPSRV_DBG_TRACE_DETAIL, isc::dhcp::dhcpsrv_logger, isc::dhcp::DHCPSRV_MYSQL_GET_VERSION, isc::db::MySqlConnection::getVersion(), and LOG_DEBUG.

Referenced by MySqlLeaseMgr().

Here is the call graph for this function:

◆ rollback()

void isc::dhcp::MySqlLeaseMgr::rollback ( )

overridevirtual

Rollback Transactions.

Rolls back all pending database operations. On databases that don't support transactions, this is a no-op.

MySQL supports transactions but this manager does not use them.

Implements isc::dhcp::LeaseMgr.

Definition at line 3867 of file mysql_lease_mgr.cc.

References isc::dhcp::DHCPSRV_DBG_TRACE_DETAIL, isc::dhcp::dhcpsrv_logger, isc::dhcp::DHCPSRV_MYSQL_ROLLBACK, and LOG_DEBUG.

◆ startLeaseStatsQuery4()

LeaseStatsQueryPtr isc::dhcp::MySqlLeaseMgr::startLeaseStatsQuery4 ( )

overridevirtual

Creates and runs the IPv4 lease stats query.

It creates an instance of a MySqlLeaseStatsQuery4 and then invokes its start method, which fetches its statistical data result set by executing the ALL_LEASE_STATS4 query. The query object is then returned.

Returns: The populated query as a pointer to an LeaseStatsQuery

Reimplemented from isc::dhcp::LeaseMgr.

Definition at line 3711 of file mysql_lease_mgr.cc.

References ALL_LEASE4_STATS.

◆ startLeaseStatsQuery6()

LeaseStatsQueryPtr isc::dhcp::MySqlLeaseMgr::startLeaseStatsQuery6 ( )

overridevirtual

Creates and runs the IPv6 lease stats query.

It creates an instance of a MySqlLeaseStatsQuery6 and then invokes its start method, which fetches its statistical data result set by executing the ALL_LEASE_STATS6 query. The query object is then returned.

Returns: The populated query as a pointer to an LeaseStatsQuery

Reimplemented from isc::dhcp::LeaseMgr.

Definition at line 3767 of file mysql_lease_mgr.cc.

References ALL_LEASE6_STATS.

◆ startPoolLeaseStatsQuery4()

LeaseStatsQueryPtr isc::dhcp::MySqlLeaseMgr::startPoolLeaseStatsQuery4 ( )

overridevirtual

Creates and runs the IPv4 lease stats query for all subnets and pools.

LeaseMgr derivations implement this method such that it creates and returns an instance of an LeaseStatsQuery whose result set has been populated with up to date IPv4 lease statistical data for all subnets and pools. Each row of the result set is an LeaseStatRow which ordered ascending by subnet ID and pool ID.

Returns: A populated LeaseStatsQuery

Reimplemented from isc::dhcp::LeaseMgr.

Definition at line 3724 of file mysql_lease_mgr.cc.

References ALL_POOL_LEASE4_STATS.

◆ startPoolLeaseStatsQuery6()

LeaseStatsQueryPtr isc::dhcp::MySqlLeaseMgr::startPoolLeaseStatsQuery6 ( )

overridevirtual

Creates and runs the IPv6 lease stats query for all subnets and pools.

LeaseMgr derivations implement this method such that it creates and returns an instance of an LeaseStatsQuery whose result set has been populated with up to date IPv6 lease statistical data for all subnets and pools. Each row of the result set is an LeaseStatRow which ordered ascending by subnet ID and pool ID.

Returns: A populated LeaseStatsQuery

Reimplemented from isc::dhcp::LeaseMgr.

Definition at line 3780 of file mysql_lease_mgr.cc.

References ALL_POOL_LEASE6_STATS.

◆ startSubnetLeaseStatsQuery4()

LeaseStatsQueryPtr isc::dhcp::MySqlLeaseMgr::startSubnetLeaseStatsQuery4 ( const SubnetID & subnet_id )

overridevirtual

Creates and runs the IPv4 lease stats query for a single subnet.

It creates an instance of a MySqlLeaseStatsQuery4 for a single subnet query and then invokes its start method in which the query constructs its statistical data result set. The query object is then returned.

Parameters

subnet_id id of the subnet for which stats are desired

Returns: A populated LeaseStatsQuery

Reimplemented from isc::dhcp::LeaseMgr.

Definition at line 3737 of file mysql_lease_mgr.cc.

References SUBNET_LEASE4_STATS.

◆ startSubnetLeaseStatsQuery6()

LeaseStatsQueryPtr isc::dhcp::MySqlLeaseMgr::startSubnetLeaseStatsQuery6 ( const SubnetID & subnet_id )

overridevirtual

Creates and runs the IPv6 lease stats query for a single subnet.

It creates an instance of a MySqlLeaseStatsQuery6 for a single subnet query and then invokes its start method in which the query constructs its statistical data result set. The query object is then returned.

Parameters

subnet_id id of the subnet for which stats are desired

Returns: A populated LeaseStatsQuery

Reimplemented from isc::dhcp::LeaseMgr.

Definition at line 3793 of file mysql_lease_mgr.cc.

References SUBNET_LEASE6_STATS.

◆ startSubnetRangeLeaseStatsQuery4()

LeaseStatsQueryPtr isc::dhcp::MySqlLeaseMgr::startSubnetRangeLeaseStatsQuery4	(	const SubnetID &	first_subnet_id,
		const SubnetID &	last_subnet_id
	)

overridevirtual

Creates and runs the IPv4 lease stats query for a single subnet.

It creates an instance of a MySqlLeaseStatsQuery4 for a subnet range query and then invokes its start method in which the query constructs its statistical data result set. The query object is then returned.

Parameters

first_subnet_id	first subnet in the range of subnets
last_subnet_id	last subnet in the range of subnets

Returns: A populated LeaseStatsQuery

Reimplemented from isc::dhcp::LeaseMgr.

Definition at line 3751 of file mysql_lease_mgr.cc.

References SUBNET_RANGE_LEASE4_STATS.

◆ startSubnetRangeLeaseStatsQuery6()

LeaseStatsQueryPtr isc::dhcp::MySqlLeaseMgr::startSubnetRangeLeaseStatsQuery6	(	const SubnetID &	first_subnet_id,
		const SubnetID &	last_subnet_id
	)

overridevirtual

Creates and runs the IPv6 lease stats query for a single subnet.

It creates an instance of a MySqlLeaseStatsQuery6 for a subnet range query and then invokes its start method in which the query constructs its statistical data result set. The query object is then returned.

Parameters

first_subnet_id	first subnet in the range of subnets
last_subnet_id	last subnet in the range of subnets

Returns: A populated LeaseStatsQuery

Reimplemented from isc::dhcp::LeaseMgr.

Definition at line 3807 of file mysql_lease_mgr.cc.

References SUBNET_RANGE_LEASE6_STATS.

◆ updateLease4()

void isc::dhcp::MySqlLeaseMgr::updateLease4 ( const Lease4Ptr & lease4 )

overridevirtual

Updates IPv4 lease.

Updates the record of the lease in the database (as identified by the address) with the data in the passed lease object.

Parameters

lease4 The lease to be updated.

Exceptions

isc::dhcp::NoSuchLease	Attempt to update a lease that did not exist.
isc::db::DbOperationError	An operation on the open database has failed.

Note: The current_cltt_ and current_valid_lft_ are used to maximize the chance that only one thread or process performs an update or delete operation on the lease by matching these values with the expiration time data in the database.; The UPDATE query uses WHERE expire = ? to update the lease only if the value matches the one received on the SELECT query, effectively enforcing no update on the lease between SELECT and UPDATE with different expiration time.

Implements isc::dhcp::LeaseMgr.

Definition at line 3273 of file mysql_lease_mgr.cc.

References isc::db::MySqlConnection::convertToDatabaseTime(), isc::dhcp::DHCPSRV_DBG_TRACE_DETAIL, isc::dhcp::dhcpsrv_logger, isc::dhcp::DHCPSRV_MYSQL_UPDATE_ADDR4, isc::dhcp::TrackingLeaseMgr::hasCallbacks(), isc::dhcp::Lease::INFINITY_LFT, LOG_DEBUG, isc::db::MLM_TRUE, isc::dhcp::TrackingLeaseMgr::trackUpdateLease(), and UPDATE_LEASE4.

Referenced by upgradeExtendedInfo4().

Here is the call graph for this function:

◆ updateLease6()

void isc::dhcp::MySqlLeaseMgr::updateLease6 ( const Lease6Ptr & lease6 )

overridevirtual

Updates IPv6 lease.

Updates the record of the lease in the database (as identified by the address) with the data in the passed lease object.

Parameters

lease6 The lease to be updated.

Exceptions

isc::dhcp::NoSuchLease	Attempt to update a lease that did not exist.
isc::db::DbOperationError	An operation on the open database has failed.

Note: The current_cltt_ and current_valid_lft_ are used to maximize the chance that only one thread or process performs an update or delete operation on the lease by matching these values with the expiration time data in the database.; The UPDATE query uses WHERE expire = ? to update the lease only if the value matches the one received on the SELECT query, effectively enforcing no update on the lease between SELECT and UPDATE with different expiration time.

Implements isc::dhcp::LeaseMgr.

Definition at line 3325 of file mysql_lease_mgr.cc.

References isc::dhcp::Lease6::ACTION_DELETE, isc::dhcp::Lease6::ACTION_IGNORE, isc::dhcp::Lease6::ACTION_UPDATE, isc::dhcp::LeaseMgr::addExtendedInfo6(), isc::db::MySqlConnection::convertToDatabaseTime(), deleteExtendedInfo6(), isc::dhcp::DHCPSRV_DBG_TRACE_DETAIL, isc::dhcp::dhcpsrv_logger, isc::dhcp::DHCPSRV_MYSQL_UPDATE_ADDR6, isc::dhcp::LeaseMgr::getExtendedInfoTablesEnabled(), isc::dhcp::TrackingLeaseMgr::hasCallbacks(), isc::dhcp::Lease::INFINITY_LFT, isc_throw, LOG_DEBUG, isc::dhcp::TrackingLeaseMgr::trackUpdateLease(), and UPDATE_LEASE6.

Referenced by upgradeExtendedInfo6().

Here is the call graph for this function:

◆ upgradeExtendedInfo4()

size_t isc::dhcp::MySqlLeaseMgr::upgradeExtendedInfo4 ( const LeasePageSize & page_size )

overridevirtual

Upgrade extended info (v4).

For all leases with a not null user context.

sanitize the user context
update relay and remote ids
when the lease was modified update it in the database This function implements the new BLQ hook command named "extended-info4-upgrade".

Parameters

page_size The page size used for retrieval.

Returns: The number of updates in the database.

Implements isc::dhcp::LeaseMgr.

Definition at line 4278 of file mysql_lease_mgr.cc.

References isc::dhcp::DHCPSRV_DBG_TRACE, isc::dhcp::DHCPSRV_DBG_TRACE_DETAIL, isc::dhcp::dhcpsrv_logger, isc::dhcp::DHCPSRV_MYSQL_UPGRADE_EXTENDED_INFO4, isc::dhcp::DHCPSRV_MYSQL_UPGRADE_EXTENDED_INFO4_ERROR, isc::dhcp::DHCPSRV_MYSQL_UPGRADE_EXTENDED_INFO4_PAGE, isc::dhcp::LeaseMgr::extractLease4ExtendedInfo(), GET_LEASE4_UCTX_PAGE, isc::dhcp::CfgMgr::getCurrentCfg(), isc::dhcp::CfgMgr::instance(), isc::asiolink::IOAddress::IPV4_ZERO_ADDRESS(), LOG_DEBUG, LOG_INFO, isc::db::MLM_TRUE, isc::dhcp::LeasePageSize::page_size_, isc::asiolink::IOAddress::toText(), isc::asiolink::IOAddress::toUint32(), updateLease4(), and isc::dhcp::LeaseMgr::upgradeLease4ExtendedInfo().

Here is the call graph for this function:

◆ upgradeExtendedInfo6()

size_t isc::dhcp::MySqlLeaseMgr::upgradeExtendedInfo6 ( const LeasePageSize & page_size )

overridevirtual

Upgrade extended info (v6).

All leases with a not null user context.

sanitize the user context
update relay and remote id tables
when the lease was modified update it in the database This function implements the new BLQ hook command named "extended-info6-upgrade".

Parameters

page_size The page size used for retrieval.

Returns: The number of updates in the database.

Implements isc::dhcp::LeaseMgr.

Definition at line 4713 of file mysql_lease_mgr.cc.

References isc::dhcp::LeaseMgr::addExtendedInfo6(), isc::dhcp::DHCPSRV_DBG_TRACE, isc::dhcp::DHCPSRV_DBG_TRACE_DETAIL, isc::dhcp::dhcpsrv_logger, isc::dhcp::DHCPSRV_MYSQL_UPGRADE_EXTENDED_INFO6, isc::dhcp::DHCPSRV_MYSQL_UPGRADE_EXTENDED_INFO6_ERROR, isc::dhcp::DHCPSRV_MYSQL_UPGRADE_EXTENDED_INFO6_PAGE, GET_LEASE6_UCTX_PAGE, isc::dhcp::CfgMgr::getCurrentCfg(), isc::dhcp::LeaseMgr::getExtendedInfoTablesEnabled(), isc::dhcp::CfgMgr::instance(), isc::asiolink::IOAddress::IPV6_ZERO_ADDRESS(), isc_throw, LOG_DEBUG, LOG_INFO, isc::db::MLM_TRUE, isc::dhcp::LeasePageSize::page_size_, isc::asiolink::IOAddress::toBytes(), isc::asiolink::IOAddress::toText(), updateLease6(), isc::dhcp::LeaseMgr::upgradeLease6ExtendedInfo(), and wipeExtendedInfoTables6().

Here is the call graph for this function:

◆ wipeExtendedInfoTables6()

void isc::dhcp::MySqlLeaseMgr::wipeExtendedInfoTables6 ( )

overridevirtual

Wipe by-relay-id table (v6).

Implements isc::dhcp::LeaseMgr.

Definition at line 4804 of file mysql_lease_mgr.cc.

References isc::db::MysqlExecuteStatement(), WIPE_RELAY_ID6, and WIPE_REMOTE_ID6.

Referenced by upgradeExtendedInfo6().

Here is the call graph for this function:

◆ wipeLeases4()

size_t isc::dhcp::MySqlLeaseMgr::wipeLeases4 ( const SubnetID & subnet_id )

overridevirtual

Removes specified IPv4 leases.

This rather dangerous method is able to remove all leases from specified subnet.

Todo:: : Not implemented yet.

Parameters

subnet_id identifier of the subnet

Returns: number of leases removed.

Implements isc::dhcp::LeaseMgr.

Definition at line 3823 of file mysql_lease_mgr.cc.

References isc_throw.

◆ wipeLeases6()

size_t isc::dhcp::MySqlLeaseMgr::wipeLeases6 ( const SubnetID & subnet_id )

overridevirtual

Removed specified IPv6 leases.

This rather dangerous method is able to remove all leases from specified subnet.

Todo:: : Not implemented yet.

Parameters

subnet_id identifier of the subnet

Returns: number of leases removed.

Implements isc::dhcp::LeaseMgr.

Definition at line 3828 of file mysql_lease_mgr.cc.

References isc_throw.

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

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

◆ StatementIndex

Constructor & Destructor Documentation

◆ MySqlLeaseMgr()

◆ ~MySqlLeaseMgr()

Member Function Documentation

◆ addLease() [1/2]

◆ addLease() [2/2]

◆ addRelayId6()

◆ addRemoteId6()

◆ byRelayId6size()

◆ byRemoteId6size()

◆ commit()

◆ createContext()

◆ dbReconnect()

◆ deleteExpiredReclaimedLeases4()

◆ deleteExpiredReclaimedLeases6()

◆ deleteExtendedInfo6()

◆ deleteLease() [1/2]

◆ deleteLease() [2/2]

◆ getDBVersion()

◆ getDescription()

◆ getExpiredLeases4()

◆ getExpiredLeases6()

◆ getLease4() [1/5]

◆ getLease4() [2/5]

◆ getLease4() [3/5]

◆ getLease4() [4/5]

◆ getLease4() [5/5]

◆ getLease6()

◆ getLeases4() [1/4]

◆ getLeases4() [2/4]

◆ getLeases4() [3/4]

◆ getLeases4() [4/4]

◆ getLeases4ByRelayId()

◆ getLeases4ByRemoteId()

◆ getLeases6() [1/7]

◆ getLeases6() [2/7]

◆ getLeases6() [3/7]

◆ getLeases6() [4/7]

◆ getLeases6() [5/7]

◆ getLeases6() [6/7]

◆ getLeases6() [7/7]

◆ getLeases6ByLink()

◆ getLeases6ByRelayId()

◆ getLeases6ByRemoteId()

◆ getName()

◆ getType()

◆ getVersion()

◆ rollback()

◆ startLeaseStatsQuery4()

◆ startLeaseStatsQuery6()

◆ startPoolLeaseStatsQuery4()

◆ startPoolLeaseStatsQuery6()

◆ startSubnetLeaseStatsQuery4()

◆ startSubnetLeaseStatsQuery6()

◆ startSubnetRangeLeaseStatsQuery4()

◆ startSubnetRangeLeaseStatsQuery6()

◆ updateLease4()

◆ updateLease6()

◆ upgradeExtendedInfo4()

◆ upgradeExtendedInfo6()

◆ wipeExtendedInfoTables6()

◆ wipeLeases4()

◆ wipeLeases6()