![]() |
Kea 2.2.0
|
Common interface representing a network to which the DHCP clients are connected. More...
#include <network.h>
Inheritance diagram for isc::dhcp::Network:Classes | |
| class | RelayInfo |
| Holds optional information about relay. More... | |
Public Types | |
| enum class | Inheritance { NONE , PARENT_NETWORK , GLOBAL , ALL } |
Inheritance "mode" used when fetching an optional Network parameter. More... | |
| typedef boost::shared_ptr< Network::RelayInfo > | RelayInfoPtr |
| Pointer to the RelayInfo structure. More... | |
Public Member Functions | |
| Network () | |
| Constructor. More... | |
| virtual | ~Network () |
| Virtual destructor. More... | |
| void | addRelayAddress (const asiolink::IOAddress &addr) |
| Adds an address to the list addresses in the network's relay info. More... | |
| void | allowClientClass (const isc::dhcp::ClientClass &class_name) |
| Sets the supported class to class class_name. More... | |
| virtual bool | clientSupported (const isc::dhcp::ClientClasses &client_classes) const |
| Checks whether this network supports client that belongs to specified classes. More... | |
| util::Optional< uint32_t > | getCacheMaxAge (const Inheritance &inheritance=Inheritance::ALL) const |
| Returns value in seconds to use as cache maximum age. More... | |
| util::Optional< double > | getCacheThreshold (const Inheritance &inheritance=Inheritance::ALL) const |
| Returns percentage to use as cache threshold. More... | |
| util::Optional< bool > | getCalculateTeeTimes (const Inheritance &inheritance=Inheritance::ALL) const |
| Returns whether or not T1/T2 calculation is enabled. More... | |
| CfgOptionPtr | getCfgOption () |
| Returns pointer to the option data configuration for this network. More... | |
| ConstCfgOptionPtr | getCfgOption () const |
| Returns const pointer to the option data configuration for this network. More... | |
| util::Optional< ClientClass > | getClientClass (const Inheritance &inheritance=Inheritance::ALL) const |
| returns the client class More... | |
| util::Optional< std::string > | getDdnsGeneratedPrefix (const Inheritance &inheritance=Inheritance::ALL) const |
| Returns ddns-generated-prefix. More... | |
| util::Optional< bool > | getDdnsOverrideClientUpdate (const Inheritance &inheritance=Inheritance::ALL) const |
| Returns ddns-override-client-update. More... | |
| util::Optional< bool > | getDdnsOverrideNoUpdate (const Inheritance &inheritance=Inheritance::ALL) const |
| Returns ddns-override-no-update. More... | |
| util::Optional< std::string > | getDdnsQualifyingSuffix (const Inheritance &inheritance=Inheritance::ALL) const |
| Returns ddns-qualifying-suffix. More... | |
| util::Optional< D2ClientConfig::ReplaceClientNameMode > | getDdnsReplaceClientNameMode (const Inheritance &inheritance=Inheritance::ALL) const |
| Returns ddns-replace-client-name-mode. More... | |
| util::Optional< bool > | getDdnsSendUpdates (const Inheritance &inheritance=Inheritance::ALL) const |
| Returns ddns-send-updates. More... | |
| util::Optional< bool > | getDdnsUpdateOnRenew (const Inheritance &inheritance=Inheritance::ALL) const |
| Returns ddns-update-on-renew. More... | |
| util::Optional< bool > | getDdnsUseConflictResolution (const Inheritance &inheritance=Inheritance::ALL) const |
| Returns ddns-use-conflict-resolution. More... | |
| util::Optional< std::string > | getHostnameCharReplacement (const Inheritance &inheritance=Inheritance::ALL) const |
| Return the invalid char replacement used to sanitize client hostnames. More... | |
| util::Optional< std::string > | getHostnameCharSet (const Inheritance &inheritance=Inheritance::ALL) const |
| Return the char set regexp used to sanitize client hostnames. More... | |
| util::Optional< std::string > | getIface (const Inheritance &inheritance=Inheritance::ALL) const |
| Returns name of the local interface for which this network is selected. More... | |
| const IOAddressList & | getRelayAddresses () const |
| Returns the list of relay addresses from the network's relay info. More... | |
| const RelayInfo & | getRelayInfo () const |
| Returns const reference to relay information. More... | |
| const ClientClasses & | getRequiredClasses () const |
| Returns classes which are required to be evaluated. More... | |
| util::Optional< bool > | getReservationsGlobal (const Inheritance &inheritance=Inheritance::ALL) const |
| Returns whether global reservations should be fetched. More... | |
| util::Optional< bool > | getReservationsInSubnet (const Inheritance &inheritance=Inheritance::ALL) const |
| Returns whether subnet reservations should be fetched. More... | |
| util::Optional< bool > | getReservationsOutOfPool (const Inheritance &inheritance=Inheritance::ALL) const |
| Returns whether only out-of-pool reservations are allowed. More... | |
| util::Optional< bool > | getStoreExtendedInfo (const Inheritance &inheritance=Inheritance::ALL) const |
| Returns store-extended-info. More... | |
| isc::util::Triplet< uint32_t > | getT1 (const Inheritance &inheritance=Inheritance::ALL) const |
| Returns T1 (renew timer), expressed in seconds. More... | |
| util::Optional< double > | getT1Percent (const Inheritance &inheritance=Inheritance::ALL) const |
| Returns percentage to use when calculating the T1 (renew timer). More... | |
| isc::util::Triplet< uint32_t > | getT2 (const Inheritance &inheritance=Inheritance::ALL) const |
| Returns T2 (rebind timer), expressed in seconds. More... | |
| util::Optional< double > | getT2Percent (const Inheritance &inheritance=Inheritance::ALL) const |
| Returns percentage to use when calculating the T2 (rebind timer). More... | |
| isc::util::Triplet< uint32_t > | getValid (const Inheritance &inheritance=Inheritance::ALL) const |
| Return valid-lifetime for addresses in that prefix. More... | |
| bool | hasFetchGlobalsFn () const |
| Checks if the network is associated with a function used to fetch globally configured parameters. More... | |
| bool | hasRelayAddress (const asiolink::IOAddress &address) const |
| Tests if the network's relay info contains the given address. More... | |
| bool | hasRelays () const |
| Indicates if network's relay info has relay addresses. More... | |
| void | requireClientClass (const isc::dhcp::ClientClass &class_name) |
| Adds class class_name to classes required to be evaluated. More... | |
| void | setCacheMaxAge (const util::Optional< uint32_t > &cache_max_age) |
| Sets cache max for a network. More... | |
| void | setCacheThreshold (const util::Optional< double > &cache_threshold) |
| Sets cache threshold for a network. More... | |
| void | setCalculateTeeTimes (const util::Optional< bool > &calculate_tee_times) |
| Sets whether or not T1/T2 calculation is enabled. More... | |
| void | setDdnsGeneratedPrefix (const util::Optional< std::string > &ddns_generated_prefix) |
| Sets new ddns-generated-prefix. More... | |
| void | setDdnsOverrideClientUpdate (const util::Optional< bool > &ddns_override_client_update) |
| Sets new ddns-override-client-update. More... | |
| void | setDdnsOverrideNoUpdate (const util::Optional< bool > &ddns_override_no_update) |
| Sets new ddns-override-no-update. More... | |
| void | setDdnsQualifyingSuffix (const util::Optional< std::string > &ddns_qualifying_suffix) |
| Sets new ddns-qualifying-suffix. More... | |
| void | setDdnsReplaceClientNameMode (const util::Optional< D2ClientConfig::ReplaceClientNameMode > &ddns_replace_client_name_mode) |
| Sets new ddns-replace-client-name-mode. More... | |
| void | setDdnsSendUpdates (const util::Optional< bool > &ddns_send_updates) |
| Sets new ddns-send-updates. More... | |
| void | setDdnsUpdateOnRenew (const util::Optional< bool > &ddns_update_on_renew) |
| Sets new ddns-update-on-renew. More... | |
| void | setDdnsUseConflictResolution (const util::Optional< bool > &ddns_use_conflict_resolution) |
| Sets new ddns-use-conflict-resolution. More... | |
| void | setFetchGlobalsFn (FetchNetworkGlobalsFn fetch_globals_fn) |
| Sets the optional callback function used to fetch globally configured parameters. More... | |
| void | setHostnameCharReplacement (const util::Optional< std::string > &hostname_char_replacement) |
| Sets new hostname-char-replacement. More... | |
| void | setHostnameCharSet (const util::Optional< std::string > &hostname_char_set) |
| Sets new hostname-char-set. More... | |
| void | setIface (const util::Optional< std::string > &iface_name) |
| Sets local name of the interface for which this network is selected. More... | |
| void | setRelayInfo (const RelayInfo &relay) |
| Sets information about relay. More... | |
| void | setReservationsGlobal (const util::Optional< bool > &reservations_global) |
| Sets whether global reservations should be fetched. More... | |
| void | setReservationsInSubnet (const util::Optional< bool > &reservations_in_subnet) |
| Sets whether subnet reservations should be fetched. More... | |
| void | setReservationsOutOfPool (const util::Optional< bool > &reservations_out_of_pool) |
| Sets whether only out-of-pool reservations are allowed. More... | |
| void | setStoreExtendedInfo (const util::Optional< bool > &store_extended_info) |
| Sets new store-extended-info. More... | |
| void | setT1 (const isc::util::Triplet< uint32_t > &t1) |
| Sets new renew timer for a network. More... | |
| void | setT1Percent (const util::Optional< double > &t1_percent) |
| Sets new percentage for calculating T1 (renew timer). More... | |
| void | setT2 (const isc::util::Triplet< uint32_t > &t2) |
| Sets new rebind timer for a network. More... | |
| void | setT2Percent (const util::Optional< double > &t2_percent) |
| Sets new percentage for calculating T2 (rebind timer). More... | |
| void | setValid (const isc::util::Triplet< uint32_t > &valid) |
| Sets new valid lifetime for a network. More... | |
| virtual data::ElementPtr | toElement () const |
| Unparses network object. More... | |
Public Member Functions inherited from isc::data::StampedElement | |
| StampedElement () | |
| Constructor. More... | |
| void | delServerTag (const std::string &server_tag) |
| Deletes server tag. More... | |
| isc::data::ElementPtr | getMetadata () const |
| Returns an object representing metadata to be returned with objects from the configuration backend. More... | |
| std::set< ServerTag > | getServerTags () const |
| Returns server tags. More... | |
| bool | hasAllServerTag () const |
| Checks if the element has 'all' server tag. More... | |
| bool | hasServerTag (const ServerTag &server_tag) const |
| Checks if the element has the given server tag. More... | |
| void | setServerTag (const std::string &server_tag) |
| Adds new server tag. More... | |
Public Member Functions inherited from isc::data::BaseStampedElement | |
| BaseStampedElement () | |
| Constructor. More... | |
| uint64_t | getId () const |
| Returns element's database identifier. More... | |
| boost::posix_time::ptime | getModificationTime () const |
| Returns timestamp. More... | |
| void | setId (const uint64_t id) |
| Sets element's database identifier. More... | |
| void | setModificationTime (const boost::posix_time::ptime ×tamp) |
| Sets timestamp to the explicitly provided value. More... | |
| void | updateModificationTime () |
| Sets timestamp to the current time. More... | |
Public Member Functions inherited from isc::data::UserContext | |
| void | contextToElement (data::ElementPtr map) const |
| Merge unparse a user_context object. More... | |
| data::ConstElementPtr | getContext () const |
| Returns const pointer to the user context. More... | |
| void | setContext (const data::ConstElementPtr &ctx) |
| Sets user context. More... | |
Public Member Functions inherited from isc::data::CfgToElement | |
| virtual | ~CfgToElement () |
| Destructor. More... | |
| virtual isc::data::ElementPtr | toElement () const =0 |
| Unparse a configuration object. More... | |
Protected Member Functions | |
| FetchNetworkGlobalsFn | getFetchGlobalsFn () const |
| Gets the optional callback function used to fetch globally configured parameters. More... | |
| template<typename NumType > | |
| isc::util::Triplet< NumType > | getGlobalProperty (isc::util::Triplet< NumType > property, const int global_index, const int min_index=-1, const int max_index=-1) const |
The getGlobalProperty specialization for isc::util::Triplet<T>. More... | |
| template<typename ReturnType > | |
| ReturnType | getGlobalProperty (ReturnType property, const int global_index, const int min_index=-1, const int max_index=-1) const |
| Returns a value of global configuration parameter with a given index. More... | |
| util::Optional< asiolink::IOAddress > | getGlobalProperty (util::Optional< asiolink::IOAddress > property, const int global_index, const int min_index=-1, const int max_index=-1) const |
The getGlobalProperty specialization for Optional<IOAddress>. More... | |
| template<typename BaseType > | |
| OptionPtr | getOptionProperty (OptionPtr(BaseType::*MethodPointer)(const Inheritance &inheritance) const, OptionPtr property, const Inheritance &inheritance) const |
| Returns option pointer associated with a network using inheritance. More... | |
| template<typename BaseType , typename ReturnType > | |
| ReturnType | getProperty (ReturnType(BaseType::*MethodPointer)(const Inheritance &) const, ReturnType property, const Inheritance &inheritance, const int global_index=-1, const int min_index=-1, const int max_index=-1) const |
| Returns a value associated with a network using inheritance. More... | |
Protected Attributes | |
| util::Optional< uint32_t > | cache_max_age_ |
| Value in seconds to use as cache maximal age. More... | |
| util::Optional< double > | cache_threshold_ |
| Percentage of the lease lifetime to use as cache threshold. More... | |
| util::Optional< bool > | calculate_tee_times_ |
| Enables calculation of T1 and T2 timers. More... | |
| CfgOptionPtr | cfg_option_ |
| Pointer to the option data configuration for this subnet. More... | |
| util::Optional< ClientClass > | client_class_ |
| Optional definition of a client class. More... | |
| util::Optional< std::string > | ddns_generated_prefix_ |
| Prefix Kea should use when generating domain-names. More... | |
| util::Optional< bool > | ddns_override_client_update_ |
| Should Kea perform updates, even if client requested delegation. More... | |
| util::Optional< bool > | ddns_override_no_update_ |
| Should Kea perform updates, even if client requested no updates. More... | |
| util::Optional< std::string > | ddns_qualifying_suffix_ |
| Suffix Kea should use when to qualify partial domain-names. More... | |
| util::Optional< D2ClientConfig::ReplaceClientNameMode > | ddns_replace_client_name_mode_ |
| How Kea should handle the domain-name supplied by the client. More... | |
| util::Optional< bool > | ddns_send_updates_ |
| Should Kea perform DNS updates. More... | |
| util::Optional< bool > | ddns_update_on_renew_ |
| Should Kea perform updates when leases are extended. More... | |
| util::Optional< bool > | ddns_use_conflict_resolution_ |
| Used to to tell kea-dhcp-ddns whether or not to use conflict resolution. More... | |
| FetchNetworkGlobalsFn | fetch_globals_fn_ |
Pointer to the optional callback used to fetch globally configured parameters inherited to the Network object. More... | |
| util::Optional< std::string > | hostname_char_replacement_ |
| A string to replace invalid characters when scrubbing hostnames. More... | |
| util::Optional< std::string > | hostname_char_set_ |
| Regular expression describing invalid characters for client hostnames. More... | |
| util::Optional< std::string > | iface_name_ |
| Holds interface name for which this network is selected. More... | |
| WeakNetworkPtr | parent_network_ |
| Pointer to another network that this network belongs to. More... | |
| RelayInfo | relay_ |
| Relay information. More... | |
| ClientClasses | required_classes_ |
| Required classes. More... | |
| util::Optional< bool > | reservations_global_ |
| Enables global reservations. More... | |
| util::Optional< bool > | reservations_in_subnet_ |
| Enables subnet reservations. More... | |
| util::Optional< bool > | reservations_out_of_pool_ |
| Enables out-of-pool reservations optimization. More... | |
| util::Optional< bool > | store_extended_info_ |
| Should Kea store additional client query data (e.g. More... | |
| isc::util::Triplet< uint32_t > | t1_ |
| a isc::util::Triplet (min/default/max) holding allowed renew timer values More... | |
| util::Optional< double > | t1_percent_ |
| Percentage of the lease lifetime to use when calculating T1 timer. More... | |
| isc::util::Triplet< uint32_t > | t2_ |
| a isc::util::Triplet (min/default/max) holding allowed rebind timer values More... | |
| util::Optional< double > | t2_percent_ |
| Percentage of the lease lifetime to use when calculating T2 timer. More... | |
| isc::util::Triplet< uint32_t > | valid_ |
| a isc::util::Triplet (min/default/max) holding allowed valid lifetime values More... | |
Protected Attributes inherited from isc::data::BaseStampedElement | |
| uint64_t | id_ |
| Database identifier of the configuration element. More... | |
| boost::posix_time::ptime | timestamp_ |
| Holds timestamp value. More... | |
Protected Attributes inherited from isc::data::UserContext | |
| data::ConstElementPtr | user_context_ |
| Pointer to the user context (may be NULL) More... | |
Additional Inherited Members | |
Static Public Member Functions inherited from isc::data::UserContext | |
| static data::ElementPtr | toElement (data::ConstElementPtr map) |
| Copy an Element map. More... | |
Common interface representing a network to which the DHCP clients are connected.
The most common type of network, in Kea's terminology, is a subnet. The Subnet derives from this class. Another types of objects implementing this interface are SharedNetwork4 and SharedNetwork6 objects. They group multiple subnets together to provide means for extending available address pools (a single client may obtain IP address from any of the pools belonging to subnets in the shared network), or for selecting a subnet on a given link, depending on the class of the client (e.g. cable network case: different subnet is selected for cable modems, different one for routers).
The subnets and shared networks share many data structures, e.g. DHCP options, local interface name, address manipulation methods. Both subnets and shared networks derive from this class to provide the common functionality.
The DHCP server configuration is complex because many parameters may be specified at different levels of hierarchy. The lower level values, e.g. subnet specific values, take precedence over upper level values, e.g. shared network specific ones. For historical reasons, the DHCP servers expect that the appropriate values are inherited from the upper configuration levels to the lower configuration levels upon the reconfiguration. For example: if a user didn't specify valid-lifetime for a subnet, calling Subnet4::getValid() should result in returning a global value of valid-lifetime. In the early Kea days it was achieved by the configuration parsers which would explicitly assign the global valid lifetime to the Subnet4 instances for which the subnet specific value was not provided. This approach has a major benefit that it is fast. However, it makes the subnets tightly dependent on the global values (and shared network specific values). Modification of the global value must result in modification of this value in all subnets for which there is no explicit value provided. This issue became a serious road block during the implementation of the Configuration Backend.
The Network object has been modified to address the problem of inheritance of global, shared network specific and subnet specific parameters in a generic way, at the same time minimizing the need to change the existing server logic.
The Network object now holds the pointer to the "parent" Network object. Thus subnets which belong to a shared network will have that shared network as its parent. Stand-alone subnets, will have no parent.
The general idea is that the accessor functions of the network will first check if the accessed value is specified or not (that is handled by util::Optional object). If the value is specified it is returned. Otherwise, the object will check if there is a parent object it belongs to and will call the appropriate method of that object. If the value is present it is returned. Otherwise the global value is returned.
Accessing global values from the Network object is troublesome. There is no uniform way to access those values. For example, the given network may be in a staging or current configuration and it really has no means to know in which of the two it belongs. In fact, an attempt to pass the pointer to the SrvConfig object would cause a circular dependency between the Network and the SrvConfig. Even if it was possible and the Network had access to the specific SrvConfig instance, it doesn't handle the cases when the SrvConfig instance was modified.
To deal with the problem of accessing the global parameters in a flexible manner, we elected to use an optional callback function which can be associated with the Network object. This callback implements the logic to retrieve global parameters and return them in a well known form, so as the Network accessors can use them.
| typedef boost::shared_ptr<Network::RelayInfo> isc::dhcp::Network::RelayInfoPtr |
|
strong |
Inheritance "mode" used when fetching an optional Network parameter.
The following modes are currently supported:
| Enumerator | |
|---|---|
| NONE | |
| PARENT_NETWORK | |
| GLOBAL | |
| ALL | |
|
inlinevirtual |
| void isc::dhcp::Network::addRelayAddress | ( | const asiolink::IOAddress & | addr | ) |
Adds an address to the list addresses in the network's relay info.
| addr | address of the relay |
| BadValue | if the address is already in the list |
Definition at line 55 of file network.cc.
References isc::dhcp::Network::RelayInfo::addAddress(), and relay_.
Here is the call graph for this function:| void isc::dhcp::Network::allowClientClass | ( | const isc::dhcp::ClientClass & | class_name | ) |
Sets the supported class to class class_name.
| class_name | client class to be supported by this network |
Definition at line 86 of file network.cc.
References client_class_.
Referenced by isc::dhcp::Subnet6ConfigParser::initSubnet().
|
virtual |
Checks whether this network supports client that belongs to specified classes.
This method checks whether a client that belongs to given classes can use this network. For example, if this class is reserved for client class "foo" and the client belongs to classes "foo", "bar" and "baz", it is supported. On the other hand, client belonging to classes "foobar" and "zyxxy" is not supported.
| client_classes | list of all classes the client belongs to |
Reimplemented in isc::dhcp::Subnet4, and isc::dhcp::Subnet6.
Definition at line 75 of file network.cc.
References client_class_, isc::dhcp::ClientClasses::contains(), and isc::util::Optional< T >::empty().
Referenced by isc::dhcp::Subnet4::clientSupported(), and isc::dhcp::Subnet6::clientSupported().
Here is the call graph for this function:
|
inline |
Returns value in seconds to use as cache maximum age.
| inheritance | inheritance mode to be used. |
Definition at line 706 of file network.h.
References isc::dhcp::CfgGlobals::CACHE_MAX_AGE, cache_max_age_, and getCacheMaxAge().
Referenced by getCacheMaxAge().
Here is the call graph for this function:
|
inline |
Returns percentage to use as cache threshold.
| inheritance | inheritance mode to be used. |
Definition at line 689 of file network.h.
References isc::dhcp::CfgGlobals::CACHE_THRESHOLD, cache_threshold_, and getCacheThreshold().
Referenced by getCacheThreshold().
Here is the call graph for this function:
|
inline |
Returns whether or not T1/T2 calculation is enabled.
| inheritance | inheritance mode to be used. |
Definition at line 459 of file network.h.
References isc::dhcp::CfgGlobals::CALCULATE_TEE_TIMES, calculate_tee_times_, and getCalculateTeeTimes().
Referenced by getCalculateTeeTimes().
Here is the call graph for this function:
|
inline |
Returns pointer to the option data configuration for this network.
Definition at line 445 of file network.h.
References cfg_option_.
Referenced by isc::dhcp::Subnet6ConfigParser::initSubnet(), and toElement().
|
inline |
Returns const pointer to the option data configuration for this network.
Definition at line 451 of file network.h.
References cfg_option_.
|
inline |
returns the client class
| inheritance | inheritance mode to be used. |
Definition at line 338 of file network.h.
References client_class_, and getClientClass().
Referenced by getClientClass().
Here is the call graph for this function:
|
inline |
Returns ddns-generated-prefix.
| inheritance | inheritance mode to be used. |
Definition at line 607 of file network.h.
References isc::dhcp::CfgGlobals::DDNS_GENERATED_PREFIX, ddns_generated_prefix_, and getDdnsGeneratedPrefix().
Referenced by getDdnsGeneratedPrefix().
Here is the call graph for this function:
|
inline |
Returns ddns-override-client-update.
| inheritance | inheritance mode to be used. |
Definition at line 543 of file network.h.
References isc::dhcp::CfgGlobals::DDNS_OVERRIDE_CLIENT_UPDATE, ddns_override_client_update_, and getDdnsOverrideClientUpdate().
Referenced by getDdnsOverrideClientUpdate().
Here is the call graph for this function:
|
inline |
Returns ddns-override-no-update.
| inheritance | inheritance mode to be used. |
Definition at line 526 of file network.h.
References isc::dhcp::CfgGlobals::DDNS_OVERRIDE_NO_UPDATE, ddns_override_no_update_, and getDdnsOverrideNoUpdate().
Referenced by getDdnsOverrideNoUpdate().
Here is the call graph for this function:
|
inline |
Returns ddns-qualifying-suffix.
| inheritance | inheritance mode to be used. |
Definition at line 624 of file network.h.
References isc::dhcp::CfgGlobals::DDNS_QUALIFYING_SUFFIX, ddns_qualifying_suffix_, and getDdnsQualifyingSuffix().
Referenced by getDdnsQualifyingSuffix().
Here is the call graph for this function:
|
inline |
Returns ddns-replace-client-name-mode.
| inheritance | inheritance mode to be used. |
Definition at line 561 of file network.h.
References isc::dhcp::CfgGlobals::DDNS_REPLACE_CLIENT_NAME, ddns_replace_client_name_mode_, isc::util::Optional< T >::get(), getDdnsReplaceClientNameMode(), getGlobalProperty(), NONE, PARENT_NETWORK, isc::dhcp::D2ClientConfig::stringToReplaceClientNameMode(), and isc::util::Optional< T >::unspecified().
Referenced by getDdnsReplaceClientNameMode().
Here is the call graph for this function:
|
inline |
Returns ddns-send-updates.
| inheritance | inheritance mode to be used. |
Definition at line 509 of file network.h.
References isc::dhcp::CfgGlobals::DDNS_SEND_UPDATES, ddns_send_updates_, and getDdnsSendUpdates().
Referenced by getDdnsSendUpdates().
Here is the call graph for this function:
|
inline |
Returns ddns-update-on-renew.
| inheritance | inheritance mode to be used. |
Definition at line 722 of file network.h.
References isc::dhcp::CfgGlobals::DDNS_UPDATE_ON_RENEW, ddns_update_on_renew_, and getDdnsUpdateOnRenew().
Referenced by getDdnsUpdateOnRenew().
Here is the call graph for this function:
|
inline |
Returns ddns-use-conflict-resolution.
| inheritance | inheritance mode to be used. |
Definition at line 739 of file network.h.
References isc::dhcp::CfgGlobals::DDNS_USE_CONFLICT_RESOLUTION, ddns_use_conflict_resolution_, and getDdnsUseConflictResolution().
Referenced by getDdnsUseConflictResolution().
Here is the call graph for this function:
|
inlineprotected |
Gets the optional callback function used to fetch globally configured parameters.
Definition at line 764 of file network.h.
References fetch_globals_fn_.
|
inlineprotected |
The getGlobalProperty specialization for isc::util::Triplet<T>.
| NumType | Type of the encapsulated value(s). |
| property | Value to be returned when it is specified or when no global value is found. |
| global_index | Index of the global parameter which value should be returned |
| min_index | Index of the min global parameter which value should be returned for triplets |
| max_index | Index of the max global parameter which value should be returned for triplets |
property. Definition at line 833 of file network.h.
References fetch_globals_fn_.
|
inlineprotected |
Returns a value of global configuration parameter with a given index.
If the ferch_globals_fn_ function is non-null, this method will invoke this function to retrieve a global value having the given index. Typically, this method is invoked by getProperty when network specific value of the parameter is not found. In some cases it may be called by other methods. One such example is the getDdnsReplaceClientNameMode which needs to call getGlobalProperty explicitly to convert the global replace client name mode value from a string to an enum.
| ReturnType | Type of the returned value, e.g. Optional<std::string>. |
| property | Value to be returned when it is specified or when no global value is found. |
| global_index | Index of the global parameter which value should be returned |
| min_index | Index of the min global parameter which value should be returned for triplets |
| max_index | Index of the max global parameter which value should be returned for triplets |
property. Definition at line 795 of file network.h.
References fetch_globals_fn_.
Referenced by getDdnsReplaceClientNameMode(), and getProperty().
|
protected |
The getGlobalProperty specialization for Optional<IOAddress>.
This does two things:
| property | Value to be returned when it is specified or when no global value is found. |
| global_index | Index of the global parameter which value should be returned |
| min_index | Index of the min global parameter which value should be returned for triplets |
| max_index | Index of the max global parameter which value should be returned for triplets |
property. Definition at line 103 of file network.cc.
References fetch_globals_fn_.
|
inline |
Return the invalid char replacement used to sanitize client hostnames.
Definition at line 654 of file network.h.
References getHostnameCharReplacement(), isc::dhcp::CfgGlobals::HOSTNAME_CHAR_REPLACEMENT, and hostname_char_replacement_.
Referenced by getHostnameCharReplacement().
Here is the call graph for this function:
|
inline |
Return the char set regexp used to sanitize client hostnames.
Definition at line 639 of file network.h.
References getHostnameCharSet(), isc::dhcp::CfgGlobals::HOSTNAME_CHAR_SET, and hostname_char_set_.
Referenced by getHostnameCharSet().
Here is the call graph for this function:
|
inline |
Returns name of the local interface for which this network is selected.
| inheritance | inheritance mode to be used. |
Definition at line 240 of file network.h.
References getIface(), and iface_name_.
Referenced by getIface().
Here is the call graph for this function:
|
inlineprotected |
Returns option pointer associated with a network using inheritance.
This template method provides a generic mechanism to retrieve a network parameter using inheritance. It is called from public accessor methods which return an OptionPtr.
| BaseType | Type of this instance, e.g. Network, Network4 etc, which exposes a method to be called. |
| MethodPointer | Pointer to the method of the base class which should be called on the parent network instance (typically on SharedNetwork4 or SharedNetwork6) to fetch the parent specific value if the value is unspecified for this instance. |
| property | the value to return when inheritance mode is NONE, or when the mode is PARENT_NETWORK and the property has not been specified by a parent network. |
| inheritance | inheritance mode to be used. |
Definition at line 998 of file network.h.
References GLOBAL, NONE, PARENT_NETWORK, and parent_network_.
|
inlineprotected |
Returns a value associated with a network using inheritance.
This template method provides a generic mechanism to retrieve a network parameter using inheritance. It is called from public accessor methods which return an OptionalValue or isc::util::Triplet.
| BaseType | Type of this instance, e.g. Network, Network4 etc, which exposes a method to be called. |
| ReturnType | Type of the returned value, e.g. Optional<std::string>. |
| MethodPointer | Pointer to the method of the base class which should be called on the parent network instance (typically on SharedNetwork4 or SharedNetwork6) to fetch the parent specific value if the value is unspecified for this instance. |
| property | Value to be returned when it is specified or when no explicit value is specified on upper inheritance levels. |
| inheritance | inheritance mode to be used. |
| global_index | Optional index of the global parameter which value should be returned if the given parameter is not specified on network level. This value is empty by default, which indicates that the global value for the given parameter is not supported and shouldn't be fetched. |
| min_index | Index of the min global parameter which value should be returned for triplets |
| max_index | Index of the max global parameter which value should be returned for triplets |
Definition at line 922 of file network.h.
References getGlobalProperty(), GLOBAL, NONE, PARENT_NETWORK, and parent_network_.
Here is the call graph for this function:| const IOAddressList & isc::dhcp::Network::getRelayAddresses | ( | ) | const |
Returns the list of relay addresses from the network's relay info.
Definition at line 70 of file network.cc.
References isc::dhcp::Network::RelayInfo::getAddresses(), and relay_.
Referenced by toElement().
Here is the call graph for this function:
|
inline |
| const ClientClasses & isc::dhcp::Network::getRequiredClasses | ( | ) | const |
Returns classes which are required to be evaluated.
Definition at line 98 of file network.cc.
References required_classes_.
Referenced by toElement().
|
inline |
Returns whether global reservations should be fetched.
| inheritance | inheritance mode to be used. |
Definition at line 394 of file network.h.
References getReservationsGlobal(), isc::dhcp::CfgGlobals::RESERVATIONS_GLOBAL, and reservations_global_.
Referenced by getReservationsGlobal().
Here is the call graph for this function:
|
inline |
Returns whether subnet reservations should be fetched.
| inheritance | inheritance mode to be used. |
Definition at line 412 of file network.h.
References getReservationsInSubnet(), isc::dhcp::CfgGlobals::RESERVATIONS_IN_SUBNET, and reservations_in_subnet_.
Referenced by getReservationsInSubnet().
Here is the call graph for this function:
|
inline |
Returns whether only out-of-pool reservations are allowed.
| inheritance | inheritance mode to be used. |
Definition at line 430 of file network.h.
References getReservationsOutOfPool(), isc::dhcp::CfgGlobals::RESERVATIONS_OUT_OF_POOL, and reservations_out_of_pool_.
Referenced by getReservationsOutOfPool().
Here is the call graph for this function:
|
inline |
Returns store-extended-info.
| inheritance | inheritance mode to be used. |
Definition at line 672 of file network.h.
References getStoreExtendedInfo(), isc::dhcp::CfgGlobals::STORE_EXTENDED_INFO, and store_extended_info_.
Referenced by getStoreExtendedInfo().
Here is the call graph for this function:
|
inline |
Returns T1 (renew timer), expressed in seconds.
| inheritance | inheritance mode to be used. |
Definition at line 363 of file network.h.
References getT1(), isc::dhcp::CfgGlobals::RENEW_TIMER, and t1_.
Referenced by getT1(), and isc::dhcp::Subnet6ConfigParser::initSubnet().
Here is the call graph for this function:
|
inline |
Returns percentage to use when calculating the T1 (renew timer).
| inheritance | inheritance mode to be used. |
Definition at line 477 of file network.h.
References getT1Percent(), isc::dhcp::CfgGlobals::T1_PERCENT, and t1_percent_.
Referenced by getT1Percent().
Here is the call graph for this function:
|
inline |
Returns T2 (rebind timer), expressed in seconds.
| inheritance | inheritance mode to be used. |
Definition at line 378 of file network.h.
References getT2(), isc::dhcp::CfgGlobals::REBIND_TIMER, and t2_.
Referenced by getT2(), and isc::dhcp::Subnet6ConfigParser::initSubnet().
Here is the call graph for this function:
|
inline |
Returns percentage to use when calculating the T2 (rebind timer).
| inheritance | inheritance mode to be used. |
Definition at line 493 of file network.h.
References getT2Percent(), isc::dhcp::CfgGlobals::T2_PERCENT, and t2_percent_.
Referenced by getT2Percent().
Here is the call graph for this function:
|
inline |
Return valid-lifetime for addresses in that prefix.
| inheritance | inheritance mode to be used. |
Definition at line 346 of file network.h.
References getValid(), isc::dhcp::CfgGlobals::MAX_VALID_LIFETIME, isc::dhcp::CfgGlobals::MIN_VALID_LIFETIME, valid_, and isc::dhcp::CfgGlobals::VALID_LIFETIME.
Referenced by getValid(), and isc::dhcp::Subnet6ConfigParser::initSubnet().
Here is the call graph for this function:
|
inline |
Checks if the network is associated with a function used to fetch globally configured parameters.
Definition at line 213 of file network.h.
References fetch_globals_fn_.
| bool isc::dhcp::Network::hasRelayAddress | ( | const asiolink::IOAddress & | address | ) | const |
Tests if the network's relay info contains the given address.
| address | address to search for in the relay list |
Definition at line 65 of file network.cc.
References isc::dhcp::Network::RelayInfo::containsAddress(), and relay_.
Here is the call graph for this function:| bool isc::dhcp::Network::hasRelays | ( | ) | const |
Indicates if network's relay info has relay addresses.
Definition at line 60 of file network.cc.
References isc::dhcp::Network::RelayInfo::hasAddresses(), and relay_.
Here is the call graph for this function:| void isc::dhcp::Network::requireClientClass | ( | const isc::dhcp::ClientClass & | class_name | ) |
Adds class class_name to classes required to be evaluated.
| class_name | client class required to be evaluated |
Definition at line 91 of file network.cc.
References isc::dhcp::ClientClasses::contains(), isc::dhcp::ClientClasses::insert(), and required_classes_.
Referenced by isc::dhcp::Subnet6ConfigParser::initSubnet().
Here is the call graph for this function:
|
inline |
Sets cache max for a network.
| cache_max_age | New cache maximum value in seconds to use. |
Definition at line 714 of file network.h.
References cache_max_age_.
|
inline |
Sets cache threshold for a network.
| cache_threshold | New cache threshold percentage to use. |
Definition at line 698 of file network.h.
References cache_threshold_.
|
inline |
Sets whether or not T1/T2 calculation is enabled.
| calculate_tee_times | new value of enabled/disabled. |
Definition at line 469 of file network.h.
References calculate_tee_times_.
|
inline |
Sets new ddns-generated-prefix.
| ddns_generated_prefix | New value to use. |
Definition at line 616 of file network.h.
References ddns_generated_prefix_.
|
inline |
Sets new ddns-override-client-update.
| ddns_override_client_update | New value to use. |
Definition at line 552 of file network.h.
References ddns_override_client_update_.
|
inline |
Sets new ddns-override-no-update.
| ddns_override_no_update | New value to use. |
Definition at line 535 of file network.h.
References ddns_override_no_update_.
|
inline |
Sets new ddns-qualifying-suffix.
| ddns_qualifying_suffix | New value to use. |
Definition at line 633 of file network.h.
References ddns_qualifying_suffix_.
|
inline |
Sets new ddns-replace-client-name-mode.
| ddns_replace_client_name_mode | New value to use. |
Definition at line 598 of file network.h.
References ddns_replace_client_name_mode_.
|
inline |
Sets new ddns-send-updates.
| ddns_send_updates | New value to use. |
Definition at line 518 of file network.h.
References ddns_send_updates_.
|
inline |
Sets new ddns-update-on-renew.
| ddns_update_on_renew | New value to use. |
Definition at line 731 of file network.h.
References ddns_update_on_renew_.
|
inline |
Sets new ddns-use-conflict-resolution.
| ddns_use_conflict_resolution | New value to use. |
Definition at line 749 of file network.h.
References ddns_use_conflict_resolution_.
|
inline |
Sets the optional callback function used to fetch globally configured parameters.
| fetch_globals_fn | Pointer to the function. |
Definition at line 205 of file network.h.
References fetch_globals_fn_.
|
inline |
Sets new hostname-char-replacement.
| hostname_char_replacement | New value to use. |
Definition at line 663 of file network.h.
References hostname_char_replacement_.
|
inline |
Sets new hostname-char-set.
| hostname_char_set | New value to use. |
Definition at line 648 of file network.h.
References hostname_char_set_.
|
inline |
Sets local name of the interface for which this network is selected.
If the interface is specified, the server will use the network associated with this local interface to allocate IP addresses and other resources to a client. Empty values are translated into unspecified.
| iface_name | Interface name. |
Definition at line 226 of file network.h.
References isc::util::Optional< T >::empty(), and iface_name_.
Referenced by isc::dhcp::Subnet6ConfigParser::initSubnet().
Here is the call graph for this function:
|
inline |
Sets information about relay.
In some situations where there are shared subnets (i.e. two different subnets are available on the same physical link), there is only one relay that handles incoming requests from clients. In such a case, the usual subnet selection criteria based on relay belonging to the subnet being selected are no longer sufficient and we need to explicitly specify a relay. One notable example of such uncommon, but valid scenario is a cable network, where there is only one CMTS (one relay), but there are 2 distinct subnets behind it: one for cable modems and another one for CPEs and other user equipment behind modems. From manageability perspective, it is essential that modems get addresses from different subnet, so users won't tinker with their modems.
Setting this parameter is not needed in most deployments. This structure holds IP address only for now, but it is expected to be extended in the future.
| relay | structure that contains relay information |
Definition at line 264 of file network.h.
References relay_.
|
inline |
Sets whether global reservations should be fetched.
| reservations_global | new value of enabled/disabled. |
Definition at line 404 of file network.h.
References reservations_global_.
|
inline |
Sets whether subnet reservations should be fetched.
| reservations_in_subnet | new value of enabled/disabled. |
Definition at line 422 of file network.h.
References reservations_in_subnet_.
|
inline |
Sets whether only out-of-pool reservations are allowed.
| reservations_out_of_pool | new value of enabled/disabled. |
Definition at line 440 of file network.h.
References reservations_out_of_pool_.
|
inline |
Sets new store-extended-info.
| store_extended_info | New value to use. |
Definition at line 681 of file network.h.
References store_extended_info_.
|
inline |
Sets new renew timer for a network.
| t1 | New renew timer value in seconds. |
Definition at line 371 of file network.h.
References t1_.
Referenced by isc::dhcp::Subnet4::Subnet4(), and isc::dhcp::Subnet6::Subnet6().
|
inline |
Sets new percentage for calculating T1 (renew timer).
| t1_percent | New percentage to use. |
Definition at line 485 of file network.h.
References t1_percent_.
|
inline |
Sets new rebind timer for a network.
| t2 | New rebind timer value in seconds. |
Definition at line 386 of file network.h.
References t2_.
Referenced by isc::dhcp::Subnet4::Subnet4(), and isc::dhcp::Subnet6::Subnet6().
|
inline |
Sets new percentage for calculating T2 (rebind timer).
| t2_percent | New percentage to use. |
Definition at line 501 of file network.h.
References t2_percent_.
|
inline |
Sets new valid lifetime for a network.
| valid | New valid lifetime in seconds. |
Definition at line 356 of file network.h.
References valid_.
Referenced by isc::dhcp::Subnet4::Subnet4(), and isc::dhcp::Subnet6::Subnet6().
|
virtual |
Unparses network object.
Implements isc::data::CfgToElement.
Reimplemented in isc::dhcp::Network4, isc::dhcp::Network6, isc::dhcp::SharedNetwork4, isc::dhcp::SharedNetwork6, isc::dhcp::Subnet, isc::dhcp::Subnet4, and isc::dhcp::Subnet6.
Definition at line 123 of file network.cc.
References cache_max_age_, cache_threshold_, calculate_tee_times_, isc::dhcp::ClientClasses::cbegin(), isc::dhcp::ClientClasses::cend(), client_class_, isc::data::UserContext::contextToElement(), isc::data::Element::create(), isc::data::Element::createList(), isc::data::Element::createMap(), ddns_generated_prefix_, ddns_override_client_update_, ddns_override_no_update_, ddns_qualifying_suffix_, ddns_replace_client_name_mode_, ddns_send_updates_, ddns_update_on_renew_, ddns_use_conflict_resolution_, isc::dhcp::ClientClasses::empty(), isc::util::Optional< T >::get(), isc::util::Triplet< T >::get(), getCfgOption(), isc::util::Triplet< T >::getMax(), isc::util::Triplet< T >::getMin(), getRelayAddresses(), getRequiredClasses(), hostname_char_replacement_, hostname_char_set_, iface_name_, reservations_global_, reservations_in_subnet_, reservations_out_of_pool_, store_extended_info_, t1_, t1_percent_, t2_, t2_percent_, isc::util::Optional< T >::unspecified(), and valid_.
Referenced by isc::dhcp::Network4::toElement(), and isc::dhcp::Network6::toElement().
Here is the call graph for this function:
|
protected |
Value in seconds to use as cache maximal age.
Definition at line 1129 of file network.h.
Referenced by getCacheMaxAge(), setCacheMaxAge(), and toElement().
|
protected |
Percentage of the lease lifetime to use as cache threshold.
Definition at line 1126 of file network.h.
Referenced by getCacheThreshold(), setCacheThreshold(), and toElement().
|
protected |
Enables calculation of T1 and T2 timers.
Definition at line 1085 of file network.h.
Referenced by getCalculateTeeTimes(), setCalculateTeeTimes(), and toElement().
|
protected |
Pointer to the option data configuration for this subnet.
Definition at line 1082 of file network.h.
Referenced by getCfgOption(), and isc::dhcp::Network4::getServerId().
|
protected |
Optional definition of a client class.
If defined, only clients belonging to that class will be allowed to use this particular network. The default value for this is an empty string, which means that any client is allowed, regardless of its class.
Definition at line 1051 of file network.h.
Referenced by allowClientClass(), clientSupported(), getClientClass(), and toElement().
|
protected |
Prefix Kea should use when generating domain-names.
Definition at line 1108 of file network.h.
Referenced by getDdnsGeneratedPrefix(), setDdnsGeneratedPrefix(), and toElement().
|
protected |
Should Kea perform updates, even if client requested delegation.
Definition at line 1102 of file network.h.
Referenced by getDdnsOverrideClientUpdate(), setDdnsOverrideClientUpdate(), and toElement().
|
protected |
Should Kea perform updates, even if client requested no updates.
Overrides the client request for no updates via the N flag.
Definition at line 1099 of file network.h.
Referenced by getDdnsOverrideNoUpdate(), setDdnsOverrideNoUpdate(), and toElement().
|
protected |
Suffix Kea should use when to qualify partial domain-names.
Definition at line 1111 of file network.h.
Referenced by getDdnsQualifyingSuffix(), setDdnsQualifyingSuffix(), and toElement().
|
protected |
How Kea should handle the domain-name supplied by the client.
Definition at line 1105 of file network.h.
Referenced by getDdnsReplaceClientNameMode(), setDdnsReplaceClientNameMode(), and toElement().
|
protected |
Should Kea perform DNS updates.
Used to provide scoped enabling and disabling of updates.
Definition at line 1095 of file network.h.
Referenced by getDdnsSendUpdates(), setDdnsSendUpdates(), and toElement().
|
protected |
Should Kea perform updates when leases are extended.
Definition at line 1132 of file network.h.
Referenced by getDdnsUpdateOnRenew(), setDdnsUpdateOnRenew(), and toElement().
|
protected |
Used to to tell kea-dhcp-ddns whether or not to use conflict resolution.
Definition at line 1135 of file network.h.
Referenced by getDdnsUseConflictResolution(), setDdnsUseConflictResolution(), and toElement().
|
protected |
Pointer to the optional callback used to fetch globally configured parameters inherited to the Network object.
Definition at line 1147 of file network.h.
Referenced by getFetchGlobalsFn(), getGlobalProperty(), hasFetchGlobalsFn(), and setFetchGlobalsFn().
|
protected |
A string to replace invalid characters when scrubbing hostnames.
Meaningful only if hostname_char_set_ is not empty.
Definition at line 1119 of file network.h.
Referenced by getHostnameCharReplacement(), setHostnameCharReplacement(), and toElement().
|
protected |
Regular expression describing invalid characters for client hostnames.
Definition at line 1115 of file network.h.
Referenced by getHostnameCharSet(), setHostnameCharSet(), and toElement().
|
protected |
Holds interface name for which this network is selected.
Definition at line 1039 of file network.h.
Referenced by getIface(), setIface(), and toElement().
|
protected |
Pointer to another network that this network belongs to.
The most common case is that this instance is a subnet which belongs to a shared network and the parent_network_ points to the shared network object. If the network instance (subnet) doesn't belong to a shared network this pointer is null.
Definition at line 1143 of file network.h.
Referenced by getOptionProperty(), getProperty(), isc::dhcp::Subnet::getSharedNetwork(), and isc::dhcp::Subnet::setSharedNetwork().
|
protected |
Relay information.
See RelayInfo for detailed description.
Definition at line 1044 of file network.h.
Referenced by addRelayAddress(), getRelayAddresses(), getRelayInfo(), hasRelayAddress(), hasRelays(), and setRelayInfo().
|
protected |
Required classes.
If the network is selected these classes will be added to the incoming packet and their evaluation will be required.
Definition at line 1057 of file network.h.
Referenced by getRequiredClasses(), and requireClientClass().
|
protected |
Enables global reservations.
Definition at line 1069 of file network.h.
Referenced by getReservationsGlobal(), setReservationsGlobal(), and toElement().
|
protected |
Enables subnet reservations.
Definition at line 1072 of file network.h.
Referenced by getReservationsInSubnet(), setReservationsInSubnet(), and toElement().
|
protected |
Enables out-of-pool reservations optimization.
When true only out-of-pool reservations are allowed. This allows AllocEngine to skip reservation checks when dealing with addresses that are in pool.
Definition at line 1079 of file network.h.
Referenced by getReservationsOutOfPool(), setReservationsOutOfPool(), and toElement().
|
protected |
Should Kea store additional client query data (e.g.
relay-agent-info) on the lease.
Definition at line 1123 of file network.h.
Referenced by getStoreExtendedInfo(), setStoreExtendedInfo(), and toElement().
|
protected |
a isc::util::Triplet (min/default/max) holding allowed renew timer values
Definition at line 1060 of file network.h.
Referenced by getT1(), setT1(), and toElement().
|
protected |
Percentage of the lease lifetime to use when calculating T1 timer.
Definition at line 1088 of file network.h.
Referenced by getT1Percent(), setT1Percent(), and toElement().
|
protected |
a isc::util::Triplet (min/default/max) holding allowed rebind timer values
Definition at line 1063 of file network.h.
Referenced by getT2(), setT2(), and toElement().
|
protected |
Percentage of the lease lifetime to use when calculating T2 timer.
Definition at line 1091 of file network.h.
Referenced by getT2Percent(), setT2Percent(), and toElement().
|
protected |
a isc::util::Triplet (min/default/max) holding allowed valid lifetime values
Definition at line 1066 of file network.h.
Referenced by getValid(), setValid(), and toElement().