Kea 2.5.8
isc::dhcp::SimpleParser4 Class Reference

#include <simple_parser4.h>

+ Inheritance diagram for isc::dhcp::SimpleParser4:

Static Public Member Functions

static size_t deriveParameters (isc::data::ElementPtr global)
 Derives (inherits) all parameters from global to more specific scopes.
 
static size_t setAllDefaults (isc::data::ElementPtr global)
 Sets all defaults for DHCPv4 configuration.
 
- 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.
 

Static Public Attributes

static const isc::data::SimpleKeywords GLOBAL4_PARAMETERS
 This table defines all global parameters in DHCPv4.
 
static const isc::data::SimpleDefaults GLOBAL4_DEFAULTS
 This table defines default global values for DHCPv4.
 
static const isc::data::SimpleKeywords OPTION4_DEF_PARAMETERS
 This table defines all option definition parameters.
 
static const isc::data::SimpleDefaults OPTION4_DEF_DEFAULTS
 This table defines default values for option definitions in DHCPv4.
 
static const isc::data::SimpleKeywords OPTION4_PARAMETERS
 This table defines all option parameters.
 
static const isc::data::SimpleDefaults OPTION4_DEFAULTS
 This table defines default values for options in DHCPv4.
 
static const isc::data::SimpleKeywords SUBNET4_PARAMETERS
 This table defines all subnet parameters for DHCPv4.
 
static const isc::data::SimpleDefaults SUBNET4_DEFAULTS
 This table defines default values for each IPv4 subnet.
 
static const isc::data::SimpleDefaults SHARED_SUBNET4_DEFAULTS
 This table defines default values for each IPv4 subnet that is part of a shared network.
 
static const isc::data::ParamsList INHERIT_TO_SUBNET4
 List of parameters that can be inherited to subnet4 scope.
 
static const isc::data::SimpleKeywords POOL4_PARAMETERS
 This table defines all pool parameters.
 
static const isc::data::SimpleKeywords SHARED_NETWORK4_PARAMETERS
 This table defines all shared network parameters for DHCPv4.
 
static const isc::data::SimpleDefaults SHARED_NETWORK4_DEFAULTS
 This table defines default values for each IPv4 shared network.
 
static const isc::data::SimpleDefaults IFACE4_DEFAULTS
 This table defines default values for interfaces for DHCPv4.
 
static const isc::data::SimpleDefaults DHCP_QUEUE_CONTROL4_DEFAULTS
 This table defines default values for dhcp-queue-control in DHCPv4.
 
static const isc::data::SimpleDefaults DHCP_MULTI_THREADING4_DEFAULTS
 This table defines default values for multi-threading in DHCPv4.
 
static const isc::data::SimpleDefaults SANITY_CHECKS4_DEFAULTS
 This defines default values for sanity checking for DHCPv4.
 

Additional Inherited Members

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

Detailed Description

Definition at line 21 of file simple_parser4.h.

Member Function Documentation

◆ deriveParameters()

size_t isc::dhcp::SimpleParser4::deriveParameters ( isc::data::ElementPtr  global)
static

Derives (inherits) all parameters from global to more specific scopes.

This method currently does the following:

  • derives global parameters to subnets (lifetimes for now)
    Parameters
    globalscope to be modified if needed (subnet4 will be extracted)
    Returns
    number of default values derived

Definition at line 508 of file simple_parser4.cc.

References isc::data::SimpleParser::deriveParams(), and INHERIT_TO_SUBNET4.

Referenced by isc::dhcp::processDhcp4Config().

+ Here is the call graph for this function:

◆ setAllDefaults()

size_t isc::dhcp::SimpleParser4::setAllDefaults ( isc::data::ElementPtr  global)
static

Sets all defaults for DHCPv4 configuration.

This method sets global, option data and option definitions defaults.

Parameters
globalscope to be filled in with defaults.
Returns
number of default values added

— end of default values ----------------------------------------------—

Definition at line 421 of file simple_parser4.cc.

References isc::data::Element::createMap(), DHCP_MULTI_THREADING4_DEFAULTS, DHCP_QUEUE_CONTROL4_DEFAULTS, GLOBAL4_DEFAULTS, IFACE4_DEFAULTS, OPTION4_DEF_DEFAULTS, OPTION4_DEFAULTS, SANITY_CHECKS4_DEFAULTS, isc::data::SimpleParser::setDefaults(), isc::data::SimpleParser::setListDefaults(), SHARED_NETWORK4_DEFAULTS, SHARED_SUBNET4_DEFAULTS, and SUBNET4_DEFAULTS.

Referenced by isc::dhcp::processDhcp4Config().

+ Here is the call graph for this function:

Member Data Documentation

◆ DHCP_MULTI_THREADING4_DEFAULTS

const SimpleDefaults isc::dhcp::SimpleParser4::DHCP_MULTI_THREADING4_DEFAULTS
static
Initial value:
= {
{ "enable-multi-threading", Element::boolean, "true" },
{ "thread-pool-size", Element::integer, "0" },
{ "packet-queue-size", Element::integer, "64" }
}

This table defines default values for multi-threading in DHCPv4.

Definition at line 62 of file simple_parser4.h.

Referenced by setAllDefaults().

◆ DHCP_QUEUE_CONTROL4_DEFAULTS

const SimpleDefaults isc::dhcp::SimpleParser4::DHCP_QUEUE_CONTROL4_DEFAULTS
static
Initial value:
= {
{ "enable-queue", Element::boolean, "false"},
{ "queue-type", Element::string, "kea-ring4"},
{ "capacity", Element::integer, "64"}
}

This table defines default values for dhcp-queue-control in DHCPv4.

Definition at line 61 of file simple_parser4.h.

Referenced by setAllDefaults().

◆ GLOBAL4_DEFAULTS

const SimpleDefaults isc::dhcp::SimpleParser4::GLOBAL4_DEFAULTS
static

This table defines default global values for DHCPv4.

Some of the global parameters defined in the global scope (i.e. directly in Dhcp4) are optional. If not defined, the following values will be used.

Definition at line 42 of file simple_parser4.h.

Referenced by isc::dhcp::CBControlDHCPv4::databaseConfigApply(), and setAllDefaults().

◆ GLOBAL4_PARAMETERS

const SimpleKeywords isc::dhcp::SimpleParser4::GLOBAL4_PARAMETERS
static

This table defines all global parameters in DHCPv4.

Boolean, integer, real and string types are for scalar parameters, list and map types for entries. Order follows global_param rule in bison grammar.

Definition at line 41 of file simple_parser4.h.

◆ IFACE4_DEFAULTS

const SimpleDefaults isc::dhcp::SimpleParser4::IFACE4_DEFAULTS
static
Initial value:
= {
{ "re-detect", Element::boolean, "true" }
}

This table defines default values for interfaces for DHCPv4.

Definition at line 60 of file simple_parser4.h.

Referenced by setAllDefaults().

◆ INHERIT_TO_SUBNET4

const ParamsList isc::dhcp::SimpleParser4::INHERIT_TO_SUBNET4
static
Initial value:
= {
"rebind-timer",
"relay",
"renew-timer",
"valid-lifetime",
"min-valid-lifetime",
"max-valid-lifetime",
"calculate-tee-times",
"t1-percent",
"t2-percent",
"store-extended-info",
"cache-threshold",
"cache-max-age",
"allocator",
"offer-lifetime",
}

List of parameters that can be inherited to subnet4 scope.

Some parameters may be defined on both global (directly in Dhcp4) and subnet (Dhcp4/subnet4/...) scope. If not defined in the subnet scope, the value is being inherited (derived) from the global scope. This array lists all of such parameters.

This list is also used for inheriting from global to shared networks and from shared networks to subnets within it.

Definition at line 53 of file simple_parser4.h.

Referenced by deriveParameters().

◆ OPTION4_DEF_DEFAULTS

const SimpleDefaults isc::dhcp::SimpleParser4::OPTION4_DEF_DEFAULTS
static
Initial value:
= {
{ "record-types", Element::string, ""},
{ "space", Element::string, "dhcp4"},
{ "array", Element::boolean, "false"},
{ "encapsulate", Element::string, "" }
}

This table defines default values for option definitions in DHCPv4.

Dhcp4 may contain an array called option-def that enumerates new option definitions. This array lists default values for those option definitions.

Definition at line 45 of file simple_parser4.h.

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

◆ OPTION4_DEF_PARAMETERS

const SimpleKeywords isc::dhcp::SimpleParser4::OPTION4_DEF_PARAMETERS
static
Initial value:
= {
{ "name", Element::string },
{ "code", Element::integer },
{ "type", Element::string },
{ "record-types", Element::string },
{ "space", Element::string },
{ "encapsulate", Element::string },
{ "array", Element::boolean, },
{ "user-context", Element::map },
{ "comment", Element::string },
{ "metadata", Element::map }
}

This table defines all option definition parameters.

Boolean, integer, real and string types are for scalar parameters, list and map types for entries. Order follows option_def_param rules in bison grammar.

Definition at line 44 of file simple_parser4.h.

Referenced by isc::dhcp::OptionDefParser::parse().

◆ OPTION4_DEFAULTS

const SimpleDefaults isc::dhcp::SimpleParser4::OPTION4_DEFAULTS
static
Initial value:
= {
{ "space", Element::string, "dhcp4"},
{ "csv-format", Element::boolean, "true"},
{ "always-send", Element::boolean, "false"},
{ "never-send", Element::boolean, "false"}
}

This table defines default values for options in DHCPv4.

Dhcp4 usually contains option values (option-data) defined in global, subnet, class or host reservations scopes. This array lists default values for those option-data declarations.

Definition at line 48 of file simple_parser4.h.

Referenced by setAllDefaults().

◆ OPTION4_PARAMETERS

const SimpleKeywords isc::dhcp::SimpleParser4::OPTION4_PARAMETERS
static
Initial value:
= {
{ "name", Element::string },
{ "data", Element::string },
{ "code", Element::integer },
{ "space", Element::string },
{ "csv-format", Element::boolean },
{ "always-send", Element::boolean },
{ "never-send", Element::boolean },
{ "user-context", Element::map },
{ "comment", Element::string },
{ "metadata", Element::map }
}

This table defines all option parameters.

Boolean, integer, real and string types are for scalar parameters, list and map types for entries. Order follows option_param rules in bison grammar.

Definition at line 47 of file simple_parser4.h.

Referenced by isc::dhcp::OptionDataParser::parse().

◆ POOL4_PARAMETERS

const SimpleKeywords isc::dhcp::SimpleParser4::POOL4_PARAMETERS
static
Initial value:
= {
{ "pool", Element::string },
{ "pool-id", Element::integer },
{ "option-data", Element::list },
{ "client-class", Element::string },
{ "require-client-classes", Element::list },
{ "user-context", Element::map },
{ "comment", Element::string },
{ "metadata", Element::map }
}

This table defines all pool parameters.

Boolean, integer, real and string types are for scalar parameters, list and map types for entries. Order follows pool_param rules in bison grammar.

Definition at line 55 of file simple_parser4.h.

Referenced by isc::dhcp::PoolParser::parse().

◆ SANITY_CHECKS4_DEFAULTS

const SimpleDefaults isc::dhcp::SimpleParser4::SANITY_CHECKS4_DEFAULTS
static
Initial value:
= {
{ "lease-checks", Element::string, "warn" }
}

This defines default values for sanity checking for DHCPv4.

Definition at line 63 of file simple_parser4.h.

Referenced by setAllDefaults().

◆ SHARED_NETWORK4_DEFAULTS

const SimpleDefaults isc::dhcp::SimpleParser4::SHARED_NETWORK4_DEFAULTS
static
Initial value:
= {
{ "client-class", Element::string, "" },
{ "interface", Element::string, "" }
}

This table defines default values for each IPv4 shared network.

Definition at line 58 of file simple_parser4.h.

Referenced by setAllDefaults().

◆ SHARED_NETWORK4_PARAMETERS

const SimpleKeywords isc::dhcp::SimpleParser4::SHARED_NETWORK4_PARAMETERS
static

This table defines all shared network parameters for DHCPv4.

Boolean, integer, real and string types are for scalar parameters, list and map types for entries. Order follows shared_network_param rule in bison grammar.

Definition at line 57 of file simple_parser4.h.

Referenced by isc::dhcp::SharedNetwork4Parser::parse().

◆ SHARED_SUBNET4_DEFAULTS

const SimpleDefaults isc::dhcp::SimpleParser4::SHARED_SUBNET4_DEFAULTS
static
Initial value:
= {
{ "id", Element::integer, "0" },
{ "4o6-interface", Element::string, "" },
{ "4o6-interface-id", Element::string, "" },
{ "4o6-subnet", Element::string, "" },
}

This table defines default values for each IPv4 subnet that is part of a shared network.

This is mostly the same as SUBNET4_DEFAULTS, except two parameters that can be derived from shared-network, but cannot from global scope. Those are: interface and reservation-mode.

Definition at line 52 of file simple_parser4.h.

Referenced by setAllDefaults().

◆ SUBNET4_DEFAULTS

const SimpleDefaults isc::dhcp::SimpleParser4::SUBNET4_DEFAULTS
static
Initial value:
= {
{ "id", Element::integer, "0" },
{ "interface", Element::string, "" },
{ "client-class", Element::string, "" },
{ "4o6-interface", Element::string, "" },
{ "4o6-interface-id", Element::string, "" },
{ "4o6-subnet", Element::string, "" },
}

This table defines default values for each IPv4 subnet.

Note: When updating this array, please also update SHARED_SUBNET4_DEFAULTS below. In most cases, those two should be kept in sync, except cases where a parameter can be derived from shared-networks, but is not defined on global level. Currently there are two such parameters: interface and reservation-mode

Definition at line 51 of file simple_parser4.h.

Referenced by setAllDefaults().

◆ SUBNET4_PARAMETERS

const SimpleKeywords isc::dhcp::SimpleParser4::SUBNET4_PARAMETERS
static

This table defines all subnet parameters for DHCPv4.

Boolean, integer, real and string types are for scalar parameters, list and map types for entries. Order follows subnet4_param rule in bison grammar.

Definition at line 50 of file simple_parser4.h.

Referenced by isc::dhcp::Subnet4ConfigParser::parse().


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