#include <libdhcp++.h>

Public Types
typedef std::map< unsigned short, Option::Factory * >	FactoryMap
	Map of factory functions.

Static Public Member Functions
static void	clearRuntimeOptionDefs ()
	Removes runtime option definitions.

static void	commitRuntimeOptionDefs ()
	Commits runtime option definitions.

static const OptionDefinition &	D6O_BOOTFILE_URL_DEF ()
	Get definition of D6O_BOOTFILE_URL option.

static const OptionDefinition &	D6O_CLIENT_DATA_DEF ()
	Get definition of D6O_CLIENT_DATA option.

static const OptionDefinition &	D6O_CLIENT_FQDN_DEF ()
	Get definition of D6O_CLIENT_FQDN option.

static const OptionDefinition &	D6O_LQ_QUERY_DEF ()
	Get definition of D6O_LQ_QUERY option.

static const OptionDefinition &	D6O_LQ_RELAY_DATA_DEF ()
	Get definition of D6O_LQ_RELAY_DATA option.

static const OptionDefinition &	D6O_NTP_SERVER_DEF ()
	Get definition of D6O_NTP_SERVER option.

static const OptionDefinition &	D6O_RSOO_DEF ()
	Get definition of D6O_RSOO option.

static const OptionDefinition &	DHO_DHCP_AGENT_OPTIONS_DEF ()
	Get definition of DHO_DHCP_AGENT_OPTIONS option.

static const OptionDefinition &	DHO_DHCP_REQUESTED_ADDRESS_DEF ()
	Get definition of DHO_DHCP_REQUESTED_ADDRESS option.

static const OptionDefinition &	DHO_DHCP_SERVER_IDENTIFIER_DEF ()
	Get definition of DHO_DHCP_SERVER_IDENTIFIER option.

static const OptionDefinition &	DHO_DOMAIN_SEARCH_DEF ()
	Get definition of DHO_DOMAIN_SEARCH option.

static const OptionDefinition &	DHO_STATUS_CODE_DEF ()
	Get definition of DHO_STATUS_CODE option.

static const OptionDefinition &	DHO_SUBNET_SELECTION_DEF ()
	Get definition of DHO_SUBNET_SELECTION option.

static void	extendVendorOptions4 (isc::dhcp::OptionCollection &options)
	Extend vendor options from fused options in multiple OptionVendor or OptionVendorClass options and add respective suboptions or values.

static OptionDefinitionPtr	getLastResortOptionDef (const std::string &space, const std::string &name)
	Returns last resort option definition by space and option name.

static OptionDefinitionPtr	getLastResortOptionDef (const std::string &space, const uint16_t code)
	Returns last resort option definition by space and option code.

static OptionDefContainerPtr	getLastResortOptionDefs (const std::string &space)
	Returns last resort option definitions for specified option space name.

static OptionDefinitionPtr	getOptionDef (const std::string &space, const std::string &name)
	Return the definition of option having a specified name.

static OptionDefinitionPtr	getOptionDef (const std::string &space, const uint16_t code)
	Return the first option definition matching a particular option code.

static const OptionDefContainerPtr	getOptionDefs (const std::string &space)
	Returns collection of option definitions.

static OptionDefinitionPtr	getRuntimeOptionDef (const std::string &space, const std::string &name)
	Returns runtime (non-standard) option definition by space and option name.

static OptionDefinitionPtr	getRuntimeOptionDef (const std::string &space, const uint16_t code)
	Returns runtime (non-standard) option definition by space and option code.

static OptionDefContainerPtr	getRuntimeOptionDefs (const std::string &space)
	Returns runtime (non-standard) option definitions for specified option space name.

static OptionDefinitionPtr	getVendorOptionDef (const Option::Universe u, const uint32_t vendor_id, const std::string &name)
	Returns vendor option definition for a given vendor-id and option name.

static OptionDefinitionPtr	getVendorOptionDef (const Option::Universe u, const uint32_t vendor_id, const uint16_t code)
	Returns vendor option definition for a given vendor-id and code.

static const OptionDefContainerPtr	getVendorOptionDefs (Option::Universe u, const uint32_t vendor_id)
	Returns option definitions for given universe and vendor.

static isc::dhcp::OptionPtr	optionFactory (isc::dhcp::Option::Universe u, uint16_t type, const OptionBuffer &buf)
	Factory function to create instance of option.

static void	OptionFactoryRegister (Option::Universe u, uint16_t type, Option::Factory *factory)
	Registers factory method that produces options of specific option types.

static uint32_t	optionSpaceToVendorId (const std::string &option_space)
	Converts option space name to vendor id.

static void	packOptions4 (isc::util::OutputBuffer &buf, const isc::dhcp::OptionCollection &options, bool top=false, bool check=true)
	Stores DHCPv4 options in a buffer.

static void	packOptions6 (isc::util::OutputBuffer &buf, const isc::dhcp::OptionCollection &options)
	Stores DHCPv6 options in a buffer.

static void	revertRuntimeOptionDefs ()
	Reverts uncommitted changes to runtime option definitions.

static void	setRuntimeOptionDefs (const OptionDefSpaceContainer &defs)
	Copies option definitions created at runtime.

static bool	shouldDeferOptionUnpack (const std::string &space, const uint16_t code)
	Checks if an option unpacking has to be deferred.

static void	splitNtpServerOptions6 (isc::dhcp::OptionCollection &options)
	Split NTP server option to one suboption per instance.

static bool	splitOptions4 (isc::dhcp::OptionCollection &options, ScopedOptionsCopyContainer &scopedOptions, uint32_t used=0)
	Split long options in multiple options with the same option code (RFC3396).

static size_t	unpackOptions4 (const OptionBuffer &buf, const std::string &option_space, isc::dhcp::OptionCollection &options, std::list< uint16_t > &deferred, bool flexible_pad_end=false)
	Parses provided buffer as DHCPv4 options and creates Option objects.

static size_t	unpackOptions6 (const OptionBuffer &buf, const std::string &option_space, isc::dhcp::OptionCollection &options, size_t relay_msg_offset=0, size_t relay_msg_len=0)
	Parses provided buffer as DHCPv6 options and creates Option objects.

static size_t	unpackVendorOptions4 (const uint32_t vendor_id, const OptionBuffer &buf, isc::dhcp::OptionCollection &options)
	Parses provided buffer as DHCPv4 vendor options and creates Option objects.

static size_t	unpackVendorOptions6 (const uint32_t vendor_id, const OptionBuffer &buf, isc::dhcp::OptionCollection &options)
	Parses provided buffer as DHCPv6 vendor options and creates Option objects.

Detailed Description

Definition at line 52 of file libdhcp++.h.

Member Typedef Documentation

◆ FactoryMap

std::map<unsigned short, Option::Factory*> isc::dhcp::LibDHCP::FactoryMap

Map of factory functions.

Definition at line 57 of file libdhcp++.h.

Member Function Documentation

◆ clearRuntimeOptionDefs()

void LibDHCP::clearRuntimeOptionDefs ( )

static

Removes runtime option definitions.

Definition at line 238 of file libdhcp++.cc.

◆ commitRuntimeOptionDefs()

void LibDHCP::commitRuntimeOptionDefs ( )

static

Commits runtime option definitions.

Definition at line 248 of file libdhcp++.cc.

Referenced by isc::dhcp::ControlledDhcpv4Srv::processConfig(), and isc::dhcp::ControlledDhcpv6Srv::processConfig().

◆ D6O_BOOTFILE_URL_DEF()

const OptionDefinition & LibDHCP::D6O_BOOTFILE_URL_DEF ( )

static

Get definition of D6O_BOOTFILE_URL option.

Definition at line 1632 of file libdhcp++.cc.

References D6O_BOOTFILE_URL, DHCP6_OPTION_SPACE, getOptionDef(), isc_throw_assert, and isc::dhcp::OPT_STRING_TYPE.

Here is the call graph for this function:

◆ D6O_CLIENT_DATA_DEF()

const OptionDefinition & LibDHCP::D6O_CLIENT_DATA_DEF ( )

static

Get definition of D6O_CLIENT_DATA option.

Definition at line 1578 of file libdhcp++.cc.

References D6O_CLIENT_DATA, DHCP6_OPTION_SPACE, getOptionDef(), isc_throw_assert, and isc::dhcp::OPT_EMPTY_TYPE.

Here is the call graph for this function:

◆ D6O_CLIENT_FQDN_DEF()

const OptionDefinition & LibDHCP::D6O_CLIENT_FQDN_DEF ( )

static

Get definition of D6O_CLIENT_FQDN option.

Definition at line 1542 of file libdhcp++.cc.

References D6O_CLIENT_FQDN, DHCP6_OPTION_SPACE, getOptionDef(), isc_throw_assert, and isc::dhcp::OPT_RECORD_TYPE.

Here is the call graph for this function:

◆ D6O_LQ_QUERY_DEF()

const OptionDefinition & LibDHCP::D6O_LQ_QUERY_DEF ( )

static

Get definition of D6O_LQ_QUERY option.

Definition at line 1560 of file libdhcp++.cc.

References D6O_LQ_QUERY, DHCP6_OPTION_SPACE, getOptionDef(), isc_throw_assert, and isc::dhcp::OPT_RECORD_TYPE.

Here is the call graph for this function:

◆ D6O_LQ_RELAY_DATA_DEF()

const OptionDefinition & LibDHCP::D6O_LQ_RELAY_DATA_DEF ( )

static

Get definition of D6O_LQ_RELAY_DATA option.

Definition at line 1596 of file libdhcp++.cc.

References D6O_LQ_RELAY_DATA, DHCP6_OPTION_SPACE, getOptionDef(), isc_throw_assert, and isc::dhcp::OPT_RECORD_TYPE.

Here is the call graph for this function:

◆ D6O_NTP_SERVER_DEF()

const OptionDefinition & LibDHCP::D6O_NTP_SERVER_DEF ( )

static

Get definition of D6O_NTP_SERVER option.

Definition at line 1614 of file libdhcp++.cc.

References D6O_NTP_SERVER, DHCP6_OPTION_SPACE, getOptionDef(), isc_throw_assert, isc::dhcp::OPT_EMPTY_TYPE, and V6_NTP_SERVER_SPACE.

Referenced by splitNtpServerOptions6().

Here is the call graph for this function:

◆ D6O_RSOO_DEF()

const OptionDefinition & LibDHCP::D6O_RSOO_DEF ( )

static

Get definition of D6O_RSOO option.

Definition at line 1650 of file libdhcp++.cc.

References D6O_RSOO, DHCP6_OPTION_SPACE, getOptionDef(), isc_throw_assert, and isc::dhcp::OPT_EMPTY_TYPE.

Here is the call graph for this function:

◆ DHO_DHCP_AGENT_OPTIONS_DEF()

const OptionDefinition & LibDHCP::DHO_DHCP_AGENT_OPTIONS_DEF ( )

static

Get definition of DHO_DHCP_AGENT_OPTIONS option.

Definition at line 1470 of file libdhcp++.cc.

References DHCP4_OPTION_SPACE, DHCP_AGENT_OPTION_SPACE, isc::dhcp::DHO_DHCP_AGENT_OPTIONS, getOptionDef(), isc_throw_assert, and isc::dhcp::OPT_EMPTY_TYPE.

Referenced by isc::dhcp::Dhcpv4Srv::recoverStashedAgentOption(), and isc::dhcp::LeaseMgr::upgradeLease4ExtendedInfo().

Here is the call graph for this function:

◆ DHO_DHCP_REQUESTED_ADDRESS_DEF()

const OptionDefinition & LibDHCP::DHO_DHCP_REQUESTED_ADDRESS_DEF ( )

static

Get definition of DHO_DHCP_REQUESTED_ADDRESS option.

Definition at line 1434 of file libdhcp++.cc.

References DHCP4_OPTION_SPACE, isc::dhcp::DHO_DHCP_REQUESTED_ADDRESS, getOptionDef(), isc_throw_assert, and isc::dhcp::OPT_IPV4_ADDRESS_TYPE.

Here is the call graph for this function:

◆ DHO_DHCP_SERVER_IDENTIFIER_DEF()

const OptionDefinition & LibDHCP::DHO_DHCP_SERVER_IDENTIFIER_DEF ( )

static

Get definition of DHO_DHCP_SERVER_IDENTIFIER option.

Definition at line 1452 of file libdhcp++.cc.

References DHCP4_OPTION_SPACE, isc::dhcp::DHO_DHCP_SERVER_IDENTIFIER, getOptionDef(), isc_throw_assert, and isc::dhcp::OPT_IPV4_ADDRESS_TYPE.

Referenced by isc::dhcp::Dhcpv4Srv::appendServerID().

Here is the call graph for this function:

◆ DHO_DOMAIN_SEARCH_DEF()

const OptionDefinition & LibDHCP::DHO_DOMAIN_SEARCH_DEF ( )

static

Get definition of DHO_DOMAIN_SEARCH option.

Definition at line 1506 of file libdhcp++.cc.

References DHCP4_OPTION_SPACE, isc::dhcp::DHO_DOMAIN_SEARCH, getOptionDef(), isc_throw_assert, and isc::dhcp::OPT_FQDN_TYPE.

Here is the call graph for this function:

◆ DHO_STATUS_CODE_DEF()

const OptionDefinition & LibDHCP::DHO_STATUS_CODE_DEF ( )

static

Get definition of DHO_STATUS_CODE option.

Definition at line 1524 of file libdhcp++.cc.

References DHCP4_OPTION_SPACE, isc::dhcp::DHO_STATUS_CODE, getOptionDef(), isc_throw_assert, and isc::dhcp::OPT_RECORD_TYPE.

Here is the call graph for this function:

◆ DHO_SUBNET_SELECTION_DEF()

const OptionDefinition & LibDHCP::DHO_SUBNET_SELECTION_DEF ( )

static

Get definition of DHO_SUBNET_SELECTION option.

Definition at line 1488 of file libdhcp++.cc.

References DHCP4_OPTION_SPACE, isc::dhcp::DHO_SUBNET_SELECTION, getOptionDef(), isc_throw_assert, and isc::dhcp::OPT_IPV4_ADDRESS_TYPE.

Here is the call graph for this function:

◆ extendVendorOptions4()

void LibDHCP::extendVendorOptions4 ( isc::dhcp::OptionCollection & options )

static

Extend vendor options from fused options in multiple OptionVendor or OptionVendorClass options and add respective suboptions or values.

Parameters

options The option container which needs to be updated with extended vendor options.

Definition at line 817 of file libdhcp++.cc.

Referenced by isc::dhcp::Pkt4::unpack().

◆ getLastResortOptionDef() [1/2]

OptionDefinitionPtr LibDHCP::getLastResortOptionDef	(	const std::string &	space,
		const std::string &	name )

static

Returns last resort option definition by space and option name.

Parameters

space	Option space name.
name	Option name.

Returns: Pointer to option definition or NULL if it doesn't exist.

Definition at line 265 of file libdhcp++.cc.

References getLastResortOptionDefs().

Here is the call graph for this function:

◆ getLastResortOptionDef() [2/2]

OptionDefinitionPtr LibDHCP::getLastResortOptionDef	(	const std::string &	space,
		const uint16_t	code )

static

Returns last resort option definition by space and option code.

Parameters

space	Option space name.
code	Option code.

Returns: Pointer to option definition or NULL if it doesn't exist.

Definition at line 253 of file libdhcp++.cc.

References getLastResortOptionDefs().

Referenced by isc::eval::EvalContext::convertOptionName(), isc::dhcp::CfgOption::createDescriptorOption(), isc::dhcp::Dhcpv4Srv::deferredUnpack(), isc::dhcp::OptionDataParser::findOptionDefinition(), and isc::dhcp::CfgOption::toElementWithMetadata().

Here is the call graph for this function:

◆ getLastResortOptionDefs()

OptionDefContainerPtr LibDHCP::getLastResortOptionDefs ( const std::string & space )

static

Returns last resort option definitions for specified option space name.

Parameters

space Option space name.

Returns: Pointer to the container holding option definitions or NULL.

Definition at line 277 of file libdhcp++.cc.

References DHCP4_OPTION_SPACE, getOptionDefs(), LAST_RESORT_V4_OPTION_SPACE, and null_option_def_container_().

Referenced by getLastResortOptionDef(), and getLastResortOptionDef().

Here is the call graph for this function:

◆ getOptionDef() [1/2]

OptionDefinitionPtr LibDHCP::getOptionDef	(	const std::string &	space,
		const std::string &	name )

static

Return the definition of option having a specified name.

Parameters

space	option space.
name	Option name.

Returns: Pointer to the option definition or NULL pointer if option definition has not been found.

Definition at line 144 of file libdhcp++.cc.

References getOptionDefs().

Here is the call graph for this function:

◆ getOptionDef() [2/2]

OptionDefinitionPtr LibDHCP::getOptionDef	(	const std::string &	space,
		const uint16_t	code )

static

Return the first option definition matching a particular option code.

Parameters

space	option space.
code	option code.

Returns: reference to an option definition being requested or NULL pointer if option definition has not been found.

Definition at line 132 of file libdhcp++.cc.

References getOptionDefs().

Referenced by isc::dhcp::CfgOptionDef::add(), isc::eval::EvalContext::convertOptionName(), isc::dhcp::CfgOption::createDescriptorOption(), D6O_BOOTFILE_URL_DEF(), D6O_CLIENT_DATA_DEF(), D6O_CLIENT_FQDN_DEF(), D6O_LQ_QUERY_DEF(), D6O_LQ_RELAY_DATA_DEF(), D6O_NTP_SERVER_DEF(), D6O_RSOO_DEF(), isc::dhcp::Dhcpv4Srv::deferredUnpack(), DHO_DHCP_AGENT_OPTIONS_DEF(), DHO_DHCP_REQUESTED_ADDRESS_DEF(), DHO_DHCP_SERVER_IDENTIFIER_DEF(), DHO_DOMAIN_SEARCH_DEF(), DHO_STATUS_CODE_DEF(), DHO_SUBNET_SELECTION_DEF(), isc::dhcp::OptionDataParser::findOptionDefinition(), and isc::dhcp::CfgOption::toElementWithMetadata().

Here is the call graph for this function:

◆ getOptionDefs()

const OptionDefContainerPtr LibDHCP::getOptionDefs ( const std::string & space )

static

Returns collection of option definitions.

This method returns a collection of option definitions for a specified option space.

Parameters

space Option space.

Returns: Pointer to a collection of option definitions.

Definition at line 105 of file libdhcp++.cc.

References null_option_def_container_().

Referenced by getLastResortOptionDefs(), getOptionDef(), getOptionDef(), getVendorOptionDefs(), unpackOptions4(), and unpackOptions6().

Here is the call graph for this function:

◆ getRuntimeOptionDef() [1/2]

OptionDefinitionPtr LibDHCP::getRuntimeOptionDef	(	const std::string &	space,
		const std::string &	name )

static

Returns runtime (non-standard) option definition by space and option name.

Parameters

space	Option space name.
name	Option name.

Returns: Pointer to option definition or NULL if it doesn't exist.

Definition at line 207 of file libdhcp++.cc.

◆ getRuntimeOptionDef() [2/2]

OptionDefinitionPtr LibDHCP::getRuntimeOptionDef	(	const std::string &	space,
		const uint16_t	code )

static

Returns runtime (non-standard) option definition by space and option code.

Parameters

space	Option space name.
code	Option code.

Returns: Pointer to option definition or NULL if it doesn't exist.

Definition at line 195 of file libdhcp++.cc.

Referenced by isc::eval::EvalContext::convertOptionName(), isc::dhcp::Dhcpv4Srv::deferredUnpack(), isc::dhcp::OptionDataParser::findOptionDefinition(), and isc::dhcp::CfgOption::toElementWithMetadata().

◆ getRuntimeOptionDefs()

OptionDefContainerPtr LibDHCP::getRuntimeOptionDefs ( const std::string & space )

static

Returns runtime (non-standard) option definitions for specified option space name.

Parameters

space Option space name.

Returns: Pointer to the container holding option definitions or NULL.

Definition at line 219 of file libdhcp++.cc.

Referenced by unpackOptions4(), and unpackOptions6().

◆ getVendorOptionDef() [1/2]

OptionDefinitionPtr LibDHCP::getVendorOptionDef	(	const Option::Universe	u,
		const uint32_t	vendor_id,
		const std::string &	name )

static

Returns vendor option definition for a given vendor-id and option name.

Parameters

u	Universe (V4 or V6)
vendor_id	Enterprise-id for a given vendor
name	Option name.

Returns: A pointer to an option definition or NULL pointer if no option definition found.

Definition at line 156 of file libdhcp++.cc.

References getVendorOptionDefs().

Here is the call graph for this function:

◆ getVendorOptionDef() [2/2]

OptionDefinitionPtr LibDHCP::getVendorOptionDef	(	const Option::Universe	u,
		const uint32_t	vendor_id,
		const uint16_t	code )

static

Returns vendor option definition for a given vendor-id and code.

Parameters

u	universe (V4 or V6)
vendor_id	enterprise-id for a given vendor
code	option code

Returns: reference to an option definition being requested or NULL pointer if option definition has not been found.

Definition at line 174 of file libdhcp++.cc.

References getVendorOptionDefs().

Referenced by isc::dhcp::CfgOption::createDescriptorOption(), isc::dhcp::OptionDataParser::findOptionDefinition(), and isc::dhcp::CfgOption::toElementWithMetadata().

Here is the call graph for this function:

◆ getVendorOptionDefs()

const OptionDefContainerPtr LibDHCP::getVendorOptionDefs	(	Option::Universe	u,
		const uint32_t	vendor_id )

static

Returns option definitions for given universe and vendor.

Parameters

u	option universe
vendor_id	enterprise-id of a given vendor

Returns: a container for a given vendor (or NULL if no option definitions are defined)

Definition at line 115 of file libdhcp++.cc.

References DOCSIS3_V4_OPTION_SPACE, DOCSIS3_V6_OPTION_SPACE, getOptionDefs(), ISC_V6_OPTION_SPACE, null_option_def_container_(), isc::dhcp::Option::V4, isc::dhcp::Option::V6, and VENDOR_ID_CABLE_LABS.

Referenced by getVendorOptionDef(), getVendorOptionDef(), unpackVendorOptions4(), and unpackVendorOptions6().

Here is the call graph for this function:

◆ optionFactory()

OptionPtr LibDHCP::optionFactory	(	isc::dhcp::Option::Universe	u,
		uint16_t	type,
		const OptionBuffer &	buf )

static

Factory function to create instance of option.

Factory method creates instance of specified option. The option to be created has to have corresponding factory function registered with LibDHCP::OptionFactoryRegister.

Parameters

u	universe of the option (V4 or V6)
type	option-type
buf	option-buffer

Returns: instance of option.

Exceptions

isc::InvalidOperation if there is no factory function registered for the specified option type.

Definition at line 293 of file libdhcp++.cc.

References isc_throw, isc::dhcp::Option::V4, and isc::dhcp::Option::V6.

Referenced by isc::dhcp::Option::factory().

◆ OptionFactoryRegister()

void LibDHCP::OptionFactoryRegister	(	Option::Universe	u,
		uint16_t	type,
		Option::Factory *	factory )

static

Registers factory method that produces options of specific option types.

Exceptions

isc::BadValue if provided the type is already registered, has too large a value or an invalid universe is specified.

Parameters

u	universe of the option (V4 or V6)
type	option-type
factory	function pointer

Definition at line 1277 of file libdhcp++.cc.

References isc_throw, isc::dhcp::Option::V4, and isc::dhcp::Option::V6.

Referenced by isc::perfdhcp::TestControl::registerOptionFactories4(), and isc::perfdhcp::TestControl::registerOptionFactories6().

◆ optionSpaceToVendorId()

uint32_t LibDHCP::optionSpaceToVendorId ( const std::string & option_space )

static

Converts option space name to vendor id.

If the option space name is specified in the following format: "vendor-X" where X is an uint32_t number, it is assumed to be a vendor space and the uint32_t number is returned by this function. If the option space name is invalid this method will return 0, which is not a valid vendor-id, to signal an error.

Todo: remove this function once when the conversion is dealt by the appropriate functions returning options by option space names.

Parameters

option_space Option space name.

Returns: vendor id.

Definition at line 1344 of file libdhcp++.cc.

Referenced by isc::dhcp::CfgOption::add(), isc::dhcp::CfgOption::createDescriptorOption(), isc::dhcp::OptionDataParser::findOptionDefinition(), and isc::dhcp::CfgOption::getAllCombined().

◆ packOptions4()

void LibDHCP::packOptions4	(	isc::util::OutputBuffer &	buf,
		const isc::dhcp::OptionCollection &	options,
		bool	top = false,
		bool	check = true )

static

Stores DHCPv4 options in a buffer.

Stores all options defined in options containers in a on-wire format in output buffer specified by buf.

May throw different exceptions if option assembly fails. There may be different reasons (option too large, option malformed, too many options etc.)

This is v4 specific version, which stores DHCP message type first, and the Relay Agent Information option and END options last. This function is initially called to pack the options for a packet in Pkt4::pack(). That call leads to it being called recursively in Option::packOptions(). Thus the logic used to output the message type should only be executed by the top-most. This is governed by the parameter top, below.

Parameters

buf	output buffer (assembled options will be stored here)
options	collection of options to store to
top	indicates if this is the first call to pack the options. When true logic to emit the message type first is executed. It defaults to false.
check	indicates if the code should be more flexible with PAD and END options. If true, PAD and END options will not be parsed. This is useful for partial parsing and slightly broken packets.

Definition at line 1025 of file libdhcp++.cc.

References isc::dhcp::DHO_DHCP_AGENT_OPTIONS, isc::dhcp::DHO_DHCP_MESSAGE_TYPE, and isc::dhcp::DHO_END.

Referenced by isc::dhcp::Pkt4::pack(), and isc::dhcp::Option::packOptions().

◆ packOptions6()

void LibDHCP::packOptions6	(	isc::util::OutputBuffer &	buf,
		const isc::dhcp::OptionCollection &	options )

static

Stores DHCPv6 options in a buffer.

Stores all options defined in options containers in a on-wire format in output buffer specified by buf.

May throw different exceptions if option assembly fails. There may be different reasons (option too large, option malformed, too many options etc.)

Currently there's no special logic in it. Options are stored in the order of their option codes.

Parameters

buf	output buffer (assembled options will be stored here)
options	collection of options to store to

Definition at line 1251 of file libdhcp++.cc.

Referenced by isc::dhcp::Option::packOptions(), isc::dhcp::Pkt6::packUDP(), and isc::dhcp::AllocEngine::updateLease6ExtendedInfo().

◆ revertRuntimeOptionDefs()

void LibDHCP::revertRuntimeOptionDefs ( )

static

Reverts uncommitted changes to runtime option definitions.

Definition at line 243 of file libdhcp++.cc.

Referenced by isc::dhcp::configureDhcp4Server(), isc::dhcp::configureDhcp6Server(), isc::dhcp::processDhcp4Config(), and isc::dhcp::processDhcp6Config().

◆ setRuntimeOptionDefs()

void LibDHCP::setRuntimeOptionDefs ( const OptionDefSpaceContainer & defs )

static

Copies option definitions created at runtime.

Copied option definitions will be used as "runtime" option definitions. A typical use case is to set option definitions specified by the user in the server configuration. These option definitions should be removed or replaced with new option definitions upon reconfiguration.

Parameters

defs	Const reference to a container holding option definitions grouped by option spaces.

Definition at line 224 of file libdhcp++.cc.

References isc::dhcp::OptionDefSpaceContainer::addItem(), isc::dhcp::OptionSpaceContainer< ContainerType, ItemType, Selector >::getItems(), and isc::dhcp::OptionSpaceContainer< ContainerType, ItemType, Selector >::getOptionSpaceNames().

Referenced by isc::dhcp::CfgMgr::mergeIntoCurrentCfg(), isc::dhcp::OptionDefListParser::parse(), isc::dhcp::processDhcp4Config(), and isc::dhcp::processDhcp6Config().

Here is the call graph for this function:

◆ shouldDeferOptionUnpack()

bool LibDHCP::shouldDeferOptionUnpack	(	const std::string &	space,
		const uint16_t	code )

static

Checks if an option unpacking has to be deferred.

DHCPv4 option 43 and 224-254 unpacking is done after classification.

Parameters

space	Option space name.
code	Option code.

Returns: True if option processing should be deferred.

Definition at line 286 of file libdhcp++.cc.

References DHCP4_OPTION_SPACE, and isc::dhcp::DHO_VENDOR_ENCAPSULATED_OPTIONS.

Referenced by isc::dhcp::ClientClassDefParser::parse(), and unpackOptions4().

◆ splitNtpServerOptions6()

void LibDHCP::splitNtpServerOptions6 ( isc::dhcp::OptionCollection & options )

static

Split NTP server option to one suboption per instance.

See RFC 5908 for the requirement.

Parameters

options The option container which needs to be updated with split options.

Definition at line 1258 of file libdhcp++.cc.

References D6O_NTP_SERVER, D6O_NTP_SERVER_DEF(), and isc::dhcp::Option::V6.

Referenced by isc::dhcp::Dhcpv6Srv::processPacketPktSend().

Here is the call graph for this function:

◆ splitOptions4()

bool LibDHCP::splitOptions4	(	isc::dhcp::OptionCollection &	options,
		ScopedOptionsCopyContainer &	scopedOptions,
		uint32_t	used = 0 )

static

Split long options in multiple options with the same option code (RFC3396).

Parameters

options	The option container which needs to be updated with split options.
scopedOptions	temporary storage for options that are going to be split. See ScopedPktOptionsCopy for explanation.
used	The size of the buffer that has already been used by the parent option effectively shrinking the maximum supported length for each options in the container.

Returns: True if any option has been split, false otherwise.

Definition at line 1070 of file libdhcp++.cc.

References isc::data::copy(), isc::util::OutputBuffer::getData(), isc::util::OutputBuffer::getLength(), isc_throw, and splitOptions4().

Referenced by isc::dhcp::Pkt4::pack(), and splitOptions4().

Here is the call graph for this function:

◆ unpackOptions4()

size_t LibDHCP::unpackOptions4	(	const OptionBuffer &	buf,
		const std::string &	option_space,
		isc::dhcp::OptionCollection &	options,
		std::list< uint16_t > &	deferred,
		bool	flexible_pad_end = false )

static

Parses provided buffer as DHCPv4 options and creates Option objects.

Parses provided buffer and stores created Option objects in options container.

Parameters

buf	Buffer to be parsed.
option_space	A name of the option space which holds definitions to be used to parse options in the packets.
options	Reference to option container. Options will be put here.
deferred	Reference to an option code list. Options which processing is deferred will be put here.
flexible_pad_end	Parse options 0 and 255 as PAD and END when they are not defined in the option space.

Returns: offset to the first byte after the last successfully parsed option or the offset of the DHO_END option type.

The unpackOptions6 note applies too.

Definition at line 471 of file libdhcp++.cc.

References DHCP4_OPTION_SPACE, isc::dhcp::DHO_END, isc::dhcp::DHO_HOST_NAME, isc::dhcp::DHO_PAD, isc::dhcp::DHO_VIVCO_SUBOPTIONS, isc::dhcp::DHO_VIVSO_SUBOPTIONS, getOptionDefs(), getRuntimeOptionDefs(), isc_throw, isc_throw_assert, shouldDeferOptionUnpack(), and isc::dhcp::Option::V4.

Referenced by isc::dhcp::Pkt4::unpack(), and isc::dhcp::Option::unpackOptions().

Here is the call graph for this function:

◆ unpackOptions6()

size_t LibDHCP::unpackOptions6	(	const OptionBuffer &	buf,
		const std::string &	option_space,
		isc::dhcp::OptionCollection &	options,
		size_t *	relay_msg_offset = 0,
		size_t *	relay_msg_len = 0 )

static

Parses provided buffer as DHCPv6 options and creates Option objects.

Parses provided buffer and stores created Option objects in options container. The last two parameters are optional and are used in relay parsing. If they are specified, relay-msg option is not created, but rather those two parameters are specified to point out where the relay-msg option resides and what is its length. This is a performance optimization that avoids unnecessary copying of potentially large relay-msg option. It is not used for anything, except in the next iteration its content will be treated as buffer to be parsed.

Parameters

buf	Buffer to be parsed.
option_space	A name of the option space which holds definitions to be used to parse options in the packets.
options	Reference to option container. Options will be put here.
relay_msg_offset	reference to a size_t structure. If specified, offset to beginning of relay_msg option will be stored in it.
relay_msg_len	reference to a size_t structure. If specified, length of the relay_msg option will be stored in it.

Returns: offset to the first byte after the last successfully parsed option

Note: This function throws when an option type is defined more than once, and it calls option building routines which can throw. Partial parsing does not throw: it is the responsibility of the caller to handle this condition.

Definition at line 317 of file libdhcp++.cc.

References D6O_RELAY_MSG, D6O_VENDOR_OPTS, getOptionDefs(), getRuntimeOptionDefs(), isc_throw, isc_throw_assert, isc::util::readUint16(), and isc::dhcp::Option::V6.

Referenced by isc::dhcp::Pkt6::unpackMsg(), isc::dhcp::Option::unpackOptions(), isc::dhcp::Pkt6::unpackRelayMsg(), and isc::dhcp::LeaseMgr::upgradeLease6ExtendedInfo().

Here is the call graph for this function:

◆ unpackVendorOptions4()

size_t LibDHCP::unpackVendorOptions4	(	const uint32_t	vendor_id,
		const OptionBuffer &	buf,
		isc::dhcp::OptionCollection &	options )

static

Parses provided buffer as DHCPv4 vendor options and creates Option objects.

Parses provided buffer and stores created Option objects in options container.

Parameters

vendor_id	enterprise-id of the vendor
buf	Buffer to be parsed.
options	Reference to option container. Suboptions will be put here.

Returns: offset to the first byte after the last successfully parsed suboption

The unpackVendorOptions6 note applies

Definition at line 919 of file libdhcp++.cc.

References getVendorOptionDefs(), isc_throw, isc_throw_assert, and isc::dhcp::Option::V4.

Referenced by isc::dhcp::OptionVendor::unpack().

Here is the call graph for this function:

◆ unpackVendorOptions6()

size_t LibDHCP::unpackVendorOptions6	(	const uint32_t	vendor_id,
		const OptionBuffer &	buf,
		isc::dhcp::OptionCollection &	options )

static

Parses provided buffer as DHCPv6 vendor options and creates Option objects.

Parses provided buffer and stores created Option objects in options container.

Parameters

vendor_id	enterprise-id of the vendor
buf	Buffer to be parsed.
options	Reference to option container. Suboptions will be put here.

Returns: offset to the first byte after the last successfully parsed suboption

Note: unpackVendorOptions6 throws when it fails to parse a suboption so the return value is currently always the buffer length.

Definition at line 823 of file libdhcp++.cc.

References getVendorOptionDefs(), isc_throw, isc_throw_assert, isc::util::readUint16(), and isc::dhcp::Option::V6.

Referenced by isc::dhcp::OptionVendor::unpack().

Here is the call graph for this function:

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

Public Types

Static Public Member Functions

Detailed Description

Member Typedef Documentation

◆ FactoryMap

Member Function Documentation

◆ clearRuntimeOptionDefs()

◆ commitRuntimeOptionDefs()

◆ D6O_BOOTFILE_URL_DEF()

◆ D6O_CLIENT_DATA_DEF()

◆ D6O_CLIENT_FQDN_DEF()

◆ D6O_LQ_QUERY_DEF()

◆ D6O_LQ_RELAY_DATA_DEF()

◆ D6O_NTP_SERVER_DEF()

◆ D6O_RSOO_DEF()

◆ DHO_DHCP_AGENT_OPTIONS_DEF()

◆ DHO_DHCP_REQUESTED_ADDRESS_DEF()

◆ DHO_DHCP_SERVER_IDENTIFIER_DEF()

◆ DHO_DOMAIN_SEARCH_DEF()

◆ DHO_STATUS_CODE_DEF()

◆ DHO_SUBNET_SELECTION_DEF()

◆ extendVendorOptions4()

◆ getLastResortOptionDef() [1/2]

◆ getLastResortOptionDef() [2/2]

◆ getLastResortOptionDefs()

◆ getOptionDef() [1/2]

◆ getOptionDef() [2/2]

◆ getOptionDefs()

◆ getRuntimeOptionDef() [1/2]

◆ getRuntimeOptionDef() [2/2]

◆ getRuntimeOptionDefs()

◆ getVendorOptionDef() [1/2]

◆ getVendorOptionDef() [2/2]

◆ getVendorOptionDefs()

◆ optionFactory()

◆ OptionFactoryRegister()

◆ optionSpaceToVendorId()

◆ packOptions4()

◆ packOptions6()

◆ revertRuntimeOptionDefs()

◆ setRuntimeOptionDefs()

◆ shouldDeferOptionUnpack()

◆ splitNtpServerOptions6()

◆ splitOptions4()

◆ unpackOptions4()

◆ unpackOptions6()

◆ unpackVendorOptions4()

◆ unpackVendorOptions6()