Kea 2.7.5
isc::dhcp::Subnet6ConfigParser Class Reference

More...

#include <dhcp_parsers.h>

+ Inheritance diagram for isc::dhcp::Subnet6ConfigParser:

Public Member Functions

 Subnet6ConfigParser (bool check_iface=true)
 Constructor.
 
Subnet6Ptr parse (data::ConstElementPtr subnet, bool encapsulate_options=true)
 Parses a single IPv6 subnet configuration and adds to the Configuration Manager.
 
- Public Member Functions inherited from isc::dhcp::SubnetConfigParser
 SubnetConfigParser (uint16_t family, bool check_iface=true)
 constructor
 
virtual ~SubnetConfigParser ()
 virtual destructor (does nothing)
 
- Public Member Functions inherited from isc::data::SimpleParser
uint16_t getUint16 (isc::data::ConstElementPtr scope, const std::string &name)
 Returns a value converted to uint16_t.
 
uint32_t getUint32 (isc::data::ConstElementPtr scope, const std::string &name)
 Returns a value converted to uint32_t.
 
uint8_t getUint8 (ConstElementPtr scope, const std::string &name)
 Get an uint8_t value.
 
const isc::util::Triplet< uint32_t > parseIntTriplet (const data::ConstElementPtr &scope, const std::string &name)
 Parses an integer triplet.
 

Protected Member Functions

virtual boost::shared_ptr< PdPoolsListParsercreatePdPoolsListParser () const
 Returns an instance of the PdPools6ListParser to be used in parsing the prefix delegation pools.
 
virtual boost::shared_ptr< PoolsListParsercreatePoolsListParser () const
 Returns an instance of the Pools6ListParser to be used in parsing the address pools.
 
virtual void duplicateOptionWarning (uint32_t code, asiolink::IOAddress &addr)
 Issues a DHCP6 server specific warning regarding duplicate subnet options.
 
void initSubnet (isc::data::ConstElementPtr params, isc::asiolink::IOAddress addr, uint8_t len)
 Instantiates the IPv6 Subnet based on a given IPv6 address and prefix length.
 
void validateResvs (const Subnet6Ptr &subnet, ConstHostPtr host)
 Verifies host reservation addresses are in the subnet range.
 
- Protected Member Functions inherited from isc::dhcp::SubnetConfigParser
virtual boost::shared_ptr< OptionDataListParsercreateOptionDataListParser () const
 Returns an instance of the OptionDataListParser to be used in parsing the option-data structure.
 
void createSubnet (isc::data::ConstElementPtr data)
 Create a new subnet using a data from child parsers.
 
SubnetPtr parse (isc::data::ConstElementPtr subnet, bool encapsulate_options)
 parses a subnet description and returns Subnet{4,6} structure
 
- Protected Member Functions inherited from isc::dhcp::BaseNetworkParser
void parseAllocatorParams (const data::ConstElementPtr &network_data, NetworkPtr &network)
 Parses parameters pertaining to allocator selection.
 
void parseCacheParams (const data::ConstElementPtr &network_data, NetworkPtr &network)
 Parses parameters related to lease cache settings.
 
void parseCommon (const data::ConstElementPtr &network_data, NetworkPtr &network)
 Parses common parameters.
 
void parseDdnsParams (const data::ConstElementPtr &network_data, NetworkPtr &network)
 Parses parameters pertaining to DDNS behavior.
 
void parseOfferLft (const data::ConstElementPtr &network_data, Network4Ptr &network)
 Parses offer-lifetime parameter (v4 only)
 
void parsePdAllocatorParams (const data::ConstElementPtr &network_data, Network6Ptr &network)
 Parses parameters pertaining to prefix delegation allocator selection.
 
void parseTeePercents (const data::ConstElementPtr &network_data, NetworkPtr &network)
 Parses parameters related to "percent" timers settings.
 
- Protected Member Functions inherited from isc::data::SimpleParser
template<typename target_type , target_type convert>
target_type getAndConvert (isc::data::ConstElementPtr scope, const std::string &name, const std::string &type_name)
 Returns a converted value from a scope.
 
template<typename int_type >
int_type getIntType (isc::data::ConstElementPtr scope, const std::string &name)
 Returns an integer value with range checking from a scope.
 

Additional Inherited Members

- Public Types inherited from isc::dhcp::BaseNetworkParser
typedef std::function< void(const isc::dhcp::ClientClass &) ClassAdderFunc)
 
- Static Public Member Functions inherited from isc::dhcp::BaseNetworkParser
static void getAdditionalClassesElem (data::ConstElementPtr params, ClassAdderFunc adder_func)
 Fetches the element for either 'evaluate-additional-classes' or deprecated 'require-client-classes'.
 
static void getClientClassesElem (data::ConstElementPtr params, ClassAdderFunc adder_func)
 Fetches the element for either 'client-classes' or deprecated 'client-class'.
 
- Static Public Member Functions inherited from isc::data::SimpleParser
static void checkKeywords (const SimpleKeywords &keywords, isc::data::ConstElementPtr scope)
 Checks acceptable keywords with their expected type.
 
static void checkRequired (const SimpleRequiredKeywords &required, isc::data::ConstElementPtr scope)
 Checks that all required keywords are present.
 
static size_t deriveParams (isc::data::ConstElementPtr parent, isc::data::ElementPtr child, const ParamsList &params)
 Derives (inherits) parameters from parent scope to a child.
 
static isc::asiolink::IOAddress getAddress (const ConstElementPtr &scope, const std::string &name)
 Returns a IOAddress parameter from a scope.
 
static bool getBoolean (isc::data::ConstElementPtr scope, const std::string &name)
 Returns a boolean parameter from a scope.
 
static double getDouble (const ConstElementPtr &scope, const std::string &name)
 Returns a floating point parameter from a scope.
 
static int64_t getInteger (isc::data::ConstElementPtr scope, const std::string &name)
 Returns an integer parameter from a scope.
 
static int64_t getInteger (isc::data::ConstElementPtr scope, const std::string &name, int64_t min, int64_t max)
 Returns an integer parameter from a scope and checks its range.
 
static const data::Element::PositiongetPosition (const std::string &name, const data::ConstElementPtr parent)
 Utility method that returns position of an element.
 
static std::string getString (isc::data::ConstElementPtr scope, const std::string &name)
 Returns a string parameter from a scope.
 
static size_t setDefaults (isc::data::ElementPtr scope, const SimpleDefaults &default_values)
 Sets the default values.
 
static size_t setListDefaults (isc::data::ConstElementPtr list, const SimpleDefaults &default_values)
 Sets the default values for all entries in a list.
 
- Protected Attributes inherited from isc::dhcp::SubnetConfigParser
uint16_t address_family_
 Address family: AF_INET or AF_INET6.
 
bool check_iface_
 Check if the specified interface exists in the system.
 
PoolStoragePtr pools_
 Storage for pools belonging to this subnet.
 
isc::dhcp::Network::RelayInfoPtr relay_info_
 Pointer to relay information.
 
isc::dhcp::SubnetPtr subnet_
 Pointer to the created subnet object.
 

Detailed Description

This class parses a single IPv6 subnet.

This is the IPv6 derivation of the SubnetConfigParser class and it parses the whole subnet definition. It creates parsersfor received configuration parameters as needed.

Definition at line 878 of file dhcp_parsers.h.

Constructor & Destructor Documentation

◆ Subnet6ConfigParser()

isc::dhcp::Subnet6ConfigParser::Subnet6ConfigParser ( bool check_iface = true)

Constructor.

stores global scope parameters, options, option definitions.

Parameters
check_ifaceCheck if the specified interface exists in the system.

Definition at line 1216 of file dhcp_parsers.cc.

Member Function Documentation

◆ createPdPoolsListParser()

boost::shared_ptr< PdPoolsListParser > isc::dhcp::Subnet6ConfigParser::createPdPoolsListParser ( ) const
protectedvirtual

Returns an instance of the PdPools6ListParser to be used in parsing the prefix delegation pools.

This function can be overridden in the child classes to supply a custom parser for the pools.

Returns
an instance of the PdPools6ListParser.

Definition at line 1456 of file dhcp_parsers.cc.

Referenced by parse().

◆ createPoolsListParser()

boost::shared_ptr< PoolsListParser > isc::dhcp::Subnet6ConfigParser::createPoolsListParser ( ) const
protectedvirtual

Returns an instance of the Pools6ListParser to be used in parsing the address pools.

This function can be overridden in the child classes to supply a custom parser for the pools.

Returns
an instance of the Pools6ListParser.

Implements isc::dhcp::SubnetConfigParser.

Definition at line 1451 of file dhcp_parsers.cc.

Referenced by parse().

◆ duplicateOptionWarning()

void isc::dhcp::Subnet6ConfigParser::duplicateOptionWarning ( uint32_t code,
asiolink::IOAddress & addr )
protectedvirtual

Issues a DHCP6 server specific warning regarding duplicate subnet options.

Parameters
codeis the numeric option code of the duplicate option
addris the subnet address
Todo
A means to know the correct logger and perhaps a common message would allow this message to be emitted by the base class.

Definition at line 1286 of file dhcp_parsers.cc.

References isc::dhcp::DHCPSRV_CFGMGR_OPTION_DUPLICATE, isc::dhcp::dhcpsrv_logger, LOG_WARN, and isc::asiolink::IOAddress::toText().

+ Here is the call graph for this function:

◆ initSubnet()

void isc::dhcp::Subnet6ConfigParser::initSubnet ( isc::data::ConstElementPtr params,
isc::asiolink::IOAddress addr,
uint8_t len )
protectedvirtual

◆ parse()

Subnet6Ptr isc::dhcp::Subnet6ConfigParser::parse ( data::ConstElementPtr subnet,
bool encapsulate_options = true )

Parses a single IPv6 subnet configuration and adds to the Configuration Manager.

Parameters
subnetA new subnet being configured.
encapsulate_optionsa boolean parameter indicating if the parsed options should be encapsulated with suboptions.
Returns
a pointer to created Subnet6 object

Parse all pools first.

Definition at line 1221 of file dhcp_parsers.cc.

References isc::data::SimpleParser::checkKeywords(), createPdPoolsListParser(), createPoolsListParser(), isc::dhcp::CfgMgr::instance(), isc_throw, isc::dhcp::SubnetConfigParser::parse(), isc::dhcp::BaseNetworkParser::parseAllocatorParams(), isc::dhcp::BaseNetworkParser::parsePdAllocatorParams(), isc::dhcp::SubnetConfigParser::pools_, isc::dhcp::SubnetConfigParser::relay_info_, isc::dhcp::SimpleParser6::SUBNET6_PARAMETERS, isc::dhcp::SubnetConfigParser::subnet_, and validateResvs().

+ Here is the call graph for this function:

◆ validateResvs()

void isc::dhcp::Subnet6ConfigParser::validateResvs ( const Subnet6Ptr & subnet,
ConstHostPtr host )
protected

Verifies host reservation addresses are in the subnet range.

Parameters
subnetpointer to the subnet
hostpointer to the host reservation
Exceptions
DhcpConfigErrorwhen an address is not in the subnet range.

Definition at line 1438 of file dhcp_parsers.cc.

References isc_throw, and isc::dhcp::IPv6Resrv::TYPE_NA.

Referenced by parse().


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