Kea  1.9.9-git
isc::lease_cmds::LeaseCmdsImpl Class Reference

Wrapper class around reservation command handlers. More...

+ Inheritance diagram for isc::lease_cmds::LeaseCmdsImpl:

Classes

class  Parameters
 Parameters specified for lease commands. More...
 

Public Member Functions

ElementPtr createFailedLeaseMap (const Lease::Type &lease_type, const IOAddress &lease_address, const DuidPtr &duid, const int control_result, const std::string &error_message) const
 Returns a map holding brief information about a lease which failed to be deleted, updated or added. More...
 
Lease6Ptr getIPv6LeaseForDelete (const Parameters &parameters) const
 Convenience function fetching IPv6 address to be used to delete a lease. More...
 
Parameters getParameters (bool v6, const ConstElementPtr &args)
 Extracts parameters required for reservation-get and reservation-del. More...
 
int lease4DelHandler (CalloutHandle &handle)
 lease4-del command handler More...
 
int lease4ResendDdnsHandler (CalloutHandle &handle)
 lease4-resend-ddns handler More...
 
int lease4UpdateHandler (CalloutHandle &handle)
 lease4-update handler More...
 
int lease4WipeHandler (CalloutHandle &handle)
 lease4-wipe handler More...
 
int lease6BulkApplyHandler (CalloutHandle &handle)
 lease6-bulk-apply command handler More...
 
int lease6DelHandler (CalloutHandle &handle)
 lease6-del command handler More...
 
int lease6ResendDdnsHandler (CalloutHandle &handle)
 lease6-resend-ddns handler More...
 
int lease6UpdateHandler (CalloutHandle &handle)
 lease6-update handler More...
 
int lease6WipeHandler (CalloutHandle &handle)
 lease6-wipe handler More...
 
int leaseAddHandler (CalloutHandle &handle)
 lease4-add, lease6-add command handler More...
 
int leaseGetAllHandler (CalloutHandle &handle)
 lease4-get-all, lease6-get-all commands handler More...
 
int leaseGetByClientIdHandler (hooks::CalloutHandle &handle)
 lease4-get-by-client-id command handler More...
 
int leaseGetByDuidHandler (hooks::CalloutHandle &handle)
 lease6-get-by-duid command handler More...
 
int leaseGetByHostnameHandler (hooks::CalloutHandle &handle)
 lease4-get-by-hostname and lease6-get-by-hostname commands handler More...
 
int leaseGetByHwAddressHandler (hooks::CalloutHandle &handle)
 lease4-get-by-hw-address command handler More...
 
int leaseGetHandler (CalloutHandle &handle)
 lease4-get, lease6-get command handler More...
 
int leaseGetPageHandler (hooks::CalloutHandle &handle)
 lease4-get-page, lease6-get-page commands handler More...
 

name of the parameter desired

Fetches an IP address parameter from a map of parameters

Parameters
mapof parameters in which to look
familyexpected protocol family of the address parameter, AF_INET or AF_INET6
Returns
IOAddress containing the value of the parameter.
Exceptions
BadValueif the parameter is missing or invalid
IOAddress getAddressParam (ConstElementPtr params, const std::string name, short family=AF_INET) const
 
static void updateStatsOnAdd (const Lease4Ptr &lease)
 Update stats when adding lease. More...
 
static void updateStatsOnAdd (const Lease6Ptr &lease)
 Update stats when adding lease. More...
 
static void updateStatsOnUpdate (const Lease4Ptr &existing, const Lease4Ptr &lease)
 Update stats when updating lease. More...
 
static void updateStatsOnUpdate (const Lease6Ptr &existing, const Lease6Ptr &lease)
 Update stats when updating lease. More...
 
static void updateStatsOnDelete (const Lease4Ptr &lease)
 Update stats when deleting lease. More...
 
static void updateStatsOnDelete (const Lease6Ptr &lease)
 Update stats when deleting lease. More...
 
static bool addOrUpdate4 (Lease4Ptr lease, bool force_create)
 Add or update lease. More...
 
static bool addOrUpdate6 (Lease6Ptr lease, bool force_create)
 Add or update lease. More...
 

Detailed Description

Wrapper class around reservation command handlers.

Definition at line 52 of file lease_cmds.cc.

Member Function Documentation

bool isc::lease_cmds::LeaseCmdsImpl::addOrUpdate4 ( Lease4Ptr  lease,
bool  force_create 
)
static

Add or update lease.

Parameters
leaseThe lease to be added or updated (if exists).
force_createFlag to indicate if the function should try to create the lease if it does not exists, or simply update and fail in such case.
Returns
true if lease has been successfully added, false otherwise.

Definition at line 645 of file lease_cmds.cc.

References isc::dhcp::LeaseMgr::getLease4(), isc::dhcp::LeaseMgrFactory::instance(), isc_throw, isc::dhcp::Lease::syncCurrentExpirationTime(), and isc::dhcp::LeaseMgr::updateLease4().

+ Here is the call graph for this function:

bool isc::lease_cmds::LeaseCmdsImpl::addOrUpdate6 ( Lease6Ptr  lease,
bool  force_create 
)
static

Add or update lease.

Parameters
leaseThe lease to be added or updated (if exists).
force_createFlag to indicate if the function should try to create the lease if it does not exists, or simply update and fail in such case.
Returns
true if lease has been successfully added, false otherwise.

Definition at line 676 of file lease_cmds.cc.

References isc::dhcp::LeaseMgr::getLease6(), isc::dhcp::LeaseMgrFactory::instance(), isc_throw, isc::dhcp::Lease::syncCurrentExpirationTime(), and isc::dhcp::LeaseMgr::updateLease6().

+ Here is the call graph for this function:

ElementPtr isc::lease_cmds::LeaseCmdsImpl::createFailedLeaseMap ( const Lease::Type lease_type,
const IOAddress lease_address,
const DuidPtr duid,
const int  control_result,
const std::string &  error_message 
) const

Returns a map holding brief information about a lease which failed to be deleted, updated or added.

The DUID is only included if it is non-null. The address is only included if it is non-zero.

Parameters
lease_typelease type.
lease_addresslease address.
duidDUID of the client.
control_resultControl result: "empty" of the lease was not found, "error" otherwise.
error_messageError message.
Returns
The JSON map of the failed leases.

Definition at line 2225 of file lease_cmds.cc.

References isc::asiolink::IOAddress::isV6Zero(), isc::asiolink::IOAddress::toText(), and isc::dhcp::Lease::typeToText().

+ Here is the call graph for this function:

IOAddress isc::lease_cmds::LeaseCmdsImpl::getAddressParam ( ConstElementPtr  params,
const std::string  name,
short  family = AF_INET 
) const

Definition at line 2106 of file lease_cmds.cc.

References isc::asiolink::IOAddress::getFamily(), and isc_throw.

+ Here is the call graph for this function:

Lease6Ptr isc::lease_cmds::LeaseCmdsImpl::getIPv6LeaseForDelete ( const Parameters parameters) const

Convenience function fetching IPv6 address to be used to delete a lease.

The returned parameter depends on the query_type value stored in the passed object. Note that the HW address is not allowed and this query type results in an exception. If the query type is of the address type, the address is returned. If the type is set to DUID, this function will try to find the lease for this DUID and return the corresponding address.

Parameters
parametersparameters extracted from the command.
Returns
Lease of the lease to be deleted.
Exceptions
InvalidParameterif the DUID is not found when needed to find the lease or if the query type is by HW address.
InvalidOperationif the query type is unknown.

Definition at line 2064 of file lease_cmds.cc.

References isc::lease_cmds::LeaseCmdsImpl::Parameters::addr, isc::lease_cmds::LeaseCmdsImpl::Parameters::duid, isc::dhcp::LeaseMgr::getLease6(), isc::lease_cmds::LeaseCmdsImpl::Parameters::iaid, isc::dhcp::LeaseMgrFactory::instance(), isc_throw, isc::lease_cmds::LeaseCmdsImpl::Parameters::lease_type, isc::lease_cmds::LeaseCmdsImpl::Parameters::query_type, and isc::lease_cmds::LeaseCmdsImpl::Parameters::subnet_id.

+ Here is the call graph for this function:

int isc::lease_cmds::LeaseCmdsImpl::lease4DelHandler ( CalloutHandle handle)
int isc::lease_cmds::LeaseCmdsImpl::lease4ResendDdnsHandler ( CalloutHandle handle)

lease4-resend-ddns handler

Provides the implementation for isc::lease_cmds::LeaseCmds::lease4ResendDdnsHandler

Parameters
handleCallout context - which is expected to contain the lease4-resend-ddns command JSON text in the "command" argument
Returns
0 upon success, non-zero otherwise

Definition at line 2135 of file lease_cmds.cc.

References isc::dhcp_ddns::CHG_ADD, isc::config::CONTROL_RESULT_EMPTY, isc::config::CONTROL_RESULT_ERROR, isc::dhcp::LeaseMgr::getLease4(), isc::dhcp::CfgMgr::instance(), isc::dhcp::LeaseMgrFactory::instance(), isc::lease_cmds::lease_cmds_logger, LEASE_CMDS_RESEND_DDNS4, LEASE_CMDS_RESEND_DDNS4_FAILED, LOG_ERROR, LOG_INFO, isc::dhcp::queueNCR(), and isc::asiolink::IOAddress::toText().

+ Here is the call graph for this function:

int isc::lease_cmds::LeaseCmdsImpl::lease4UpdateHandler ( CalloutHandle handle)

lease4-update handler

Provides the implementation for isc::lease_cmds::LeaseCmds::lease4UpdateHandler

Parameters
handleCallout context - which is expected to contain the update command JSON text in the "command" argument
Returns
0 upon success, non-zero otherwise

Definition at line 1795 of file lease_cmds.cc.

References isc::dhcp::CfgMgr::getCurrentCfg(), isc::dhcp::CfgMgr::instance(), isc_throw, isc::lease_cmds::Lease4Parser::parse(), and isc::dhcp::ResourceHandler4::tryLock4().

+ Here is the call graph for this function:

int isc::lease_cmds::LeaseCmdsImpl::lease4WipeHandler ( CalloutHandle handle)

lease4-wipe handler

Provides the implementation for isc::lease_cmds::LeaseCmds::lease4WipeHandler

Parameters
handleCallout context - which is expected to contain the wipe command JSON text in the "command" argument
Returns
0 upon success, non-zero otherwise

Definition at line 1902 of file lease_cmds.cc.

References isc::config::CONTROL_RESULT_EMPTY, isc::config::CONTROL_RESULT_SUCCESS, isc::config::createAnswer(), isc::dhcp::CfgMgr::getCurrentCfg(), isc::data::SimpleParser::getUint32(), isc::dhcp::CfgMgr::instance(), isc::dhcp::LeaseMgrFactory::instance(), and isc::dhcp::LeaseMgr::wipeLeases4().

+ Here is the call graph for this function:

int isc::lease_cmds::LeaseCmdsImpl::lease6BulkApplyHandler ( CalloutHandle handle)
int isc::lease_cmds::LeaseCmdsImpl::lease6ResendDdnsHandler ( CalloutHandle handle)

lease6-resend-ddns handler

Provides the implementation for isc::lease_cmds::LeaseCmds::lease6ResendDdnsHandler

Parameters
handleCallout context - which is expected to contain the lease6-resend-ddns command JSON text in the "command" argument
Returns
0 upon success, non-zero otherwise

Definition at line 2180 of file lease_cmds.cc.

References isc::dhcp_ddns::CHG_ADD, isc::config::CONTROL_RESULT_EMPTY, isc::config::CONTROL_RESULT_ERROR, isc::dhcp::LeaseMgr::getLease6(), isc::dhcp::CfgMgr::instance(), isc::dhcp::LeaseMgrFactory::instance(), isc::lease_cmds::lease_cmds_logger, LEASE_CMDS_RESEND_DDNS6, LEASE_CMDS_RESEND_DDNS6_FAILED, LOG_ERROR, LOG_INFO, isc::dhcp::queueNCR(), isc::asiolink::IOAddress::toText(), and isc::dhcp::Lease::TYPE_NA.

+ Here is the call graph for this function:

int isc::lease_cmds::LeaseCmdsImpl::lease6UpdateHandler ( CalloutHandle handle)

lease6-update handler

Provides the implementation for isc::lease_cmds::LeaseCmds::lease6UpdateHandler

Parameters
handleCallout context - which is expected to contain the update command JSON text in the "command" argument
Returns
0 upon success, non-zero otherwise

Definition at line 1848 of file lease_cmds.cc.

References isc::dhcp::CfgMgr::getCurrentCfg(), isc::dhcp::CfgMgr::instance(), isc_throw, isc::lease_cmds::Lease6Parser::parse(), and isc::dhcp::ResourceHandler::tryLock().

+ Here is the call graph for this function:

int isc::lease_cmds::LeaseCmdsImpl::lease6WipeHandler ( CalloutHandle handle)

lease6-wipe handler

Provides the implementation for isc::lease_cmds::LeaseCmds::lease6WipeHandler

Parameters
handleCallout context - which is expected to contain the wipe command JSON text in the "command" argument
Returns
0 upon success, non-zero otherwise
Todo:
: consider extending the code with wipe-leases:

Definition at line 1976 of file lease_cmds.cc.

References isc::config::CONTROL_RESULT_EMPTY, isc::config::CONTROL_RESULT_SUCCESS, isc::config::createAnswer(), isc::dhcp::CfgMgr::getCurrentCfg(), isc::data::SimpleParser::getUint32(), isc::dhcp::CfgMgr::instance(), isc::dhcp::LeaseMgrFactory::instance(), and isc::dhcp::LeaseMgr::wipeLeases6().

+ Here is the call graph for this function:

int isc::lease_cmds::LeaseCmdsImpl::leaseAddHandler ( CalloutHandle handle)

lease4-add, lease6-add command handler

Provides the implementation for isc::lease_cmds::LeaseCmds::leaseAddHandler

Parameters
handleCallout context - which is expected to contain the add command JSON text in the "command" argument
Returns
0 upon success, non-zero otherwise

Definition at line 708 of file lease_cmds.cc.

References isc::dhcp::LeaseMgr::addLease(), isc::dhcp::CfgMgr::getCurrentCfg(), isc::dhcp::CfgMgr::instance(), isc::dhcp::LeaseMgrFactory::instance(), isc_throw, LEASE_CMDS_ADD4, LEASE_CMDS_ADD4_FAILED, LEASE_CMDS_ADD6, LEASE_CMDS_ADD6_FAILED, isc::lease_cmds::lease_cmds_logger, LOG_ERROR, LOG_INFO, isc::lease_cmds::Lease4Parser::parse(), isc::lease_cmds::Lease6Parser::parse(), isc::dhcp::ResourceHandler::tryLock(), isc::dhcp::ResourceHandler4::tryLock4(), and isc::dhcp::Lease::TYPE_NA.

+ Here is the call graph for this function:

int isc::lease_cmds::LeaseCmdsImpl::leaseGetAllHandler ( CalloutHandle handle)

lease4-get-all, lease6-get-all commands handler

These commands attempt to retrieve all IPv4 or IPv6 leases, or all IPv4 or all IPv6 leases belonging to the particular subnets. If no subnet identifiers are provided, it returns all IPv4 or IPv6 leases from the database.

Parameters
handleCallout context - which is expected to contain the get command JSON text in the "command" argument
Returns
0 upon success, non-zero otherwise.

Definition at line 1031 of file lease_cmds.cc.

References isc::config::CONTROL_RESULT_EMPTY, isc::config::CONTROL_RESULT_ERROR, isc::config::CONTROL_RESULT_SUCCESS, isc::config::createAnswer(), isc::dhcp::LeaseMgr::getLeases4(), isc::dhcp::LeaseMgr::getLeases6(), isc::dhcp::LeaseMgrFactory::instance(), and isc_throw.

+ Here is the call graph for this function:

int isc::lease_cmds::LeaseCmdsImpl::leaseGetByClientIdHandler ( hooks::CalloutHandle handle)

lease4-get-by-client-id command handler

Provides the implementation for isc::lease_cmds::LeaseCmds::leaseGetByClientIdHandler

Parameters
handleCallout context - which is expected to contain the get command JSON text in the "command" argument
Returns
0 if the handler has been invoked successfully, 1 if an error occurs, 3 if no leases are returned.

Definition at line 1283 of file lease_cmds.cc.

References isc::config::CONTROL_RESULT_EMPTY, isc::config::CONTROL_RESULT_ERROR, isc::config::CONTROL_RESULT_SUCCESS, isc::config::createAnswer(), isc::dhcp::ClientId::fromText(), isc::dhcp::LeaseMgr::getLease4(), isc::dhcp::LeaseMgrFactory::instance(), and isc_throw.

+ Here is the call graph for this function:

int isc::lease_cmds::LeaseCmdsImpl::leaseGetByDuidHandler ( hooks::CalloutHandle handle)

lease6-get-by-duid command handler

Provides the implementation for isc::lease_cmds::LeaseCmds::leaseGetByDuidHandler

Parameters
handleCallout context - which is expected to contain the get command JSON text in the "command" argument
Returns
0 if the handler has been invoked successfully, 1 if an error occurs, 3 if no leases are returned.

Definition at line 1333 of file lease_cmds.cc.

References isc::config::CONTROL_RESULT_EMPTY, isc::config::CONTROL_RESULT_ERROR, isc::config::CONTROL_RESULT_SUCCESS, isc::config::createAnswer(), isc::dhcp::DUID::fromText(), isc::dhcp::LeaseMgr::getLeases6(), isc::dhcp::LeaseMgrFactory::instance(), and isc_throw.

+ Here is the call graph for this function:

int isc::lease_cmds::LeaseCmdsImpl::leaseGetByHostnameHandler ( hooks::CalloutHandle handle)

lease4-get-by-hostname and lease6-get-by-hostname commands handler

Provides the implementation for isc::lease_cmds::LeaseCmds::leaseGetByHostnameHandler

Parameters
handleCallout context - which is expected to contain the get command JSON text in the "command" argument
Returns
0 if the handler has been invoked successfully, 1 if an error occurs, 3 if no leases are returned.

The 'hostname' argument should not be empty.

Definition at line 1383 of file lease_cmds.cc.

References isc::config::CONTROL_RESULT_EMPTY, isc::config::CONTROL_RESULT_ERROR, isc::config::CONTROL_RESULT_SUCCESS, isc::config::createAnswer(), isc::dhcp::LeaseMgr::getLeases4(), isc::dhcp::LeaseMgr::getLeases6(), isc::dhcp::LeaseMgrFactory::instance(), and isc_throw.

+ Here is the call graph for this function:

int isc::lease_cmds::LeaseCmdsImpl::leaseGetByHwAddressHandler ( hooks::CalloutHandle handle)

lease4-get-by-hw-address command handler

Provides the implementation for isc::lease_cmds::LeaseCmds::leaseGetByHwAddressHandler

Parameters
handleCallout context - which is expected to contain the get command JSON text in the "command" argument
Returns
0 if the handler has been invoked successfully, 1 if an error occurs, 3 if no leases are returned.

Definition at line 1233 of file lease_cmds.cc.

References isc::config::CONTROL_RESULT_EMPTY, isc::config::CONTROL_RESULT_ERROR, isc::config::CONTROL_RESULT_SUCCESS, isc::config::createAnswer(), isc::dhcp::HWAddr::fromText(), isc::dhcp::LeaseMgr::getLease4(), isc::dhcp::LeaseMgrFactory::instance(), and isc_throw.

+ Here is the call graph for this function:

int isc::lease_cmds::LeaseCmdsImpl::leaseGetPageHandler ( hooks::CalloutHandle handle)

lease4-get-page, lease6-get-page commands handler

These commands attempt to retrieve 1 page of leases. The maximum size of the page is specified by the caller. The caller also specifies the last address returned in the previous page. The new page starts from the first address following the address specified by the caller. If the first page should be returned the IPv4 zero address, IPv6 zero address or the keyword "start" should be provided instead of the last address.

Parameters
handleCallout context - which is expected to contain the get commands JSON text in the "command" argument.
Returns
0 if the handler has been invoked successfully, 1 if an error occurs, 3 if no leases are returned.

Definition at line 1114 of file lease_cmds.cc.

References isc::config::CONTROL_RESULT_EMPTY, isc::config::CONTROL_RESULT_ERROR, isc::config::CONTROL_RESULT_SUCCESS, isc::config::createAnswer(), isc::dhcp::LeaseMgr::getLeases4(), isc::dhcp::LeaseMgr::getLeases6(), isc::dhcp::LeaseMgrFactory::instance(), and isc_throw.

+ Here is the call graph for this function:

void isc::lease_cmds::LeaseCmdsImpl::updateStatsOnAdd ( const Lease4Ptr lease)
static

Update stats when adding lease.

Parameters
leaseAdded lease.

Definition at line 450 of file lease_cmds.cc.

void isc::lease_cmds::LeaseCmdsImpl::updateStatsOnAdd ( const Lease6Ptr lease)
static

Update stats when adding lease.

Parameters
leaseAdded lease.

Definition at line 468 of file lease_cmds.cc.

References isc::dhcp::Lease::TYPE_NA.

void isc::lease_cmds::LeaseCmdsImpl::updateStatsOnDelete ( const Lease4Ptr lease)
static

Update stats when deleting lease.

Parameters
leaseDeleted lease.

Definition at line 608 of file lease_cmds.cc.

void isc::lease_cmds::LeaseCmdsImpl::updateStatsOnDelete ( const Lease6Ptr lease)
static

Update stats when deleting lease.

Parameters
leaseDeleted lease.

Definition at line 626 of file lease_cmds.cc.

References isc::dhcp::Lease::TYPE_NA.

void isc::lease_cmds::LeaseCmdsImpl::updateStatsOnUpdate ( const Lease4Ptr existing,
const Lease4Ptr lease 
)
static

Update stats when updating lease.

Parameters
existingLease data before update.
leaseLease data after update.

Definition at line 487 of file lease_cmds.cc.

void isc::lease_cmds::LeaseCmdsImpl::updateStatsOnUpdate ( const Lease6Ptr existing,
const Lease6Ptr lease 
)
static

Update stats when updating lease.

Parameters
existingLease data before update.
leaseLease data after update.

Definition at line 546 of file lease_cmds.cc.

References isc::dhcp::Lease::TYPE_NA.


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