Kea 1.9.11
shared_network_parser.cc
Go to the documentation of this file.
1// Copyright (C) 2017-2021 Internet Systems Consortium, Inc. ("ISC")
2//
3// This Source Code Form is subject to the terms of the Mozilla Public
4// License, v. 2.0. If a copy of the MPL was not distributed with this
5// file, You can obtain one at http://mozilla.org/MPL/2.0/.
6
7#include <config.h>
8
10#include <cc/data.h>
11#include <dhcpsrv/cfgmgr.h>
12#include <dhcpsrv/cfg_option.h>
19#include <boost/pointer_cast.hpp>
20#include <string>
21
22using namespace isc::asiolink;
23using namespace isc::data;
24using namespace isc::util;
25
26namespace isc {
27namespace dhcp {
28
30 : check_iface_(check_iface) {
31}
32
35 SharedNetwork4Ptr shared_network;
36 try {
37
38 // Check parameters.
40 shared_network_data);
41
42 // Make sure that the network name has been specified. The name is required
43 // to create a SharedNetwork4 object.
44 std::string name = getString(shared_network_data, "name");
45 shared_network.reset(new SharedNetwork4(name));
46
47 // Move from reservation mode to new reservations flags.
48 ElementPtr mutable_params;
49 mutable_params = boost::const_pointer_cast<Element>(shared_network_data);
51
52 // Parse parameters common to all Network derivations.
53 NetworkPtr network = boost::dynamic_pointer_cast<Network>(shared_network);
54 parseCommon(mutable_params, network);
55
56 // interface is an optional parameter
57 if (shared_network_data->contains("interface")) {
58 std::string iface = getString(shared_network_data, "interface");
59 if (!iface.empty()) {
60 if (check_iface_ && !IfaceMgr::instance().getIface(iface)) {
62 shared_network_data->get("interface");
64 "Specified network interface name " << iface
65 << " for shared network " << name
66 << " is not present in the system ("
67 << error->getPosition() << ")");
68 }
69 shared_network->setIface(iface);
70 }
71 }
72
73 if (shared_network_data->contains("option-data")) {
74 auto json = shared_network_data->get("option-data");
75 // Create parser instance for option-data.
76 CfgOptionPtr cfg_option = shared_network->getCfgOption();
77 OptionDataListParser parser(AF_INET);
78 parser.parse(cfg_option, json);
79 }
80
81 if (shared_network_data->contains("subnet4")) {
82 auto json = shared_network_data->get("subnet4");
83
84 // Create parser instance of subnet4.
86 Subnet4Collection subnets;
87 parser.parse(subnets, json);
88
89 // Add all returned subnets into shared network.
90 for (auto subnet = subnets.cbegin(); subnet != subnets.cend();
91 ++subnet) {
92 shared_network->add(*subnet);
93 }
94 }
95
96 if (shared_network_data->contains("match-client-id")) {
97 shared_network->setMatchClientId(getBoolean(shared_network_data,
98 "match-client-id"));
99 }
100
101 if (shared_network_data->contains("authoritative")) {
102 shared_network->setAuthoritative(getBoolean(shared_network_data,
103 "authoritative"));
104 }
105
106 // Set next-server
107 if (shared_network_data->contains("next-server")) {
108 std::string next_server;
109 try {
110 next_server = getString(shared_network_data, "next-server");
111 if (!next_server.empty()) {
112 shared_network->setSiaddr(IOAddress(next_server));
113 }
114 } catch (...) {
115 ConstElementPtr next = shared_network_data->get("next-server");
116 std::string pos;
117 if (next) {
118 pos = next->getPosition().str();
119 } else {
120 pos = shared_network_data->getPosition().str();
121 }
122 isc_throw(DhcpConfigError, "invalid parameter next-server : "
123 << next_server << "(" << pos << ")");
124 }
125 }
126
127 // Set server-hostname.
128 if (shared_network_data->contains("server-hostname")) {
129 std::string sname = getString(shared_network_data, "server-hostname");
130 if (!sname.empty()) {
131 if (sname.length() >= Pkt4::MAX_SNAME_LEN) {
132 ConstElementPtr error = shared_network_data->get("server-hostname");
133 isc_throw(DhcpConfigError, "server-hostname must be at most "
134 << Pkt4::MAX_SNAME_LEN - 1 << " bytes long, it is "
135 << sname.length() << " ("
136 << error->getPosition() << ")");
137 }
138 shared_network->setSname(sname);
139 }
140 }
141
142 // Set boot-file-name.
143 if (shared_network_data->contains("boot-file-name")) {
144 std::string filename = getString(shared_network_data, "boot-file-name");
145 if (!filename.empty()) {
146 if (filename.length() > Pkt4::MAX_FILE_LEN) {
147 ConstElementPtr error = shared_network_data->get("boot-file-name");
148 isc_throw(DhcpConfigError, "boot-file-name must be at most "
149 << Pkt4::MAX_FILE_LEN - 1 << " bytes long, it is "
150 << filename.length() << " ("
151 << error->getPosition() << ")");
152 }
153 shared_network->setFilename(filename);
154 }
155 }
156
157 if (shared_network_data->contains("client-class")) {
158 std::string client_class = getString(shared_network_data, "client-class");
159 if (!client_class.empty()) {
160 shared_network->allowClientClass(client_class);
161 }
162 }
163
164 ConstElementPtr user_context = shared_network_data->get("user-context");
165 if (user_context) {
166 shared_network->setContext(user_context);
167 }
168
169 if (shared_network_data->contains("require-client-classes")) {
170 const std::vector<data::ElementPtr>& class_list =
171 shared_network_data->get("require-client-classes")->listValue();
172 for (auto cclass = class_list.cbegin();
173 cclass != class_list.cend(); ++cclass) {
174 if (((*cclass)->getType() != Element::string) ||
175 (*cclass)->stringValue().empty()) {
176 isc_throw(DhcpConfigError, "invalid class name ("
177 << (*cclass)->getPosition() << ")");
178 }
179 shared_network->requireClientClass((*cclass)->stringValue());
180 }
181 }
182
183 if (shared_network_data->contains("relay")) {
184 auto relay_parms = shared_network_data->get("relay");
185 if (relay_parms) {
188 parser.parse(relay_info, relay_parms);
189 shared_network->setRelayInfo(*relay_info);
190 }
191 }
192
193 parseTeePercents(shared_network_data, network);
194
195 // Parse DDNS parameters
196 parseDdnsParams(shared_network_data, network);
197
198 // Parse lease cache parameters
199 parseCacheParams(shared_network_data, network);
200 } catch (const DhcpConfigError&) {
201 // Position was already added
202 throw;
203 } catch (const std::exception& ex) {
204 isc_throw(DhcpConfigError, ex.what() << " ("
205 << shared_network_data->getPosition() << ")");
206 }
207
208 // In order to take advantage of the dynamic inheritance of global
209 // parameters to a shared network we need to set a callback function
210 // for each shared network to allow for fetching global parameters.
211 shared_network->setFetchGlobalsFn([]() -> ConstElementPtr {
212 return (CfgMgr::instance().getCurrentCfg()->getConfiguredGlobals());
213 });
214
215 return (shared_network);
216}
217
219 : check_iface_(check_iface) {
220}
221
224 SharedNetwork6Ptr shared_network;
225 std::string name;
226 try {
227 // Check parameters.
229 shared_network_data);
230
231 // Make sure that the network name has been specified. The name is required
232 // to create a SharedNetwork6 object.
233 std::string name = getString(shared_network_data, "name");
234 shared_network.reset(new SharedNetwork6(name));
235
236 // Move from reservation mode to new reservations flags.
237 ElementPtr mutable_params;
238 mutable_params = boost::const_pointer_cast<Element>(shared_network_data);
240
241 // Parse parameters common to all Network derivations.
242 NetworkPtr network = boost::dynamic_pointer_cast<Network>(shared_network);
243 parseCommon(mutable_params, network);
244
245 // preferred-lifetime
246 shared_network->setPreferred(parseIntTriplet(shared_network_data,
247 "preferred-lifetime"));
248
249 // Get interface-id option content. For now we support string
250 // representation only
251 Optional<std::string> ifaceid;
252 if (shared_network_data->contains("interface-id")) {
253 ifaceid = getString(shared_network_data, "interface-id");
254 }
255
256 // Interface is an optional parameter
258 if (shared_network_data->contains("interface")) {
259 iface = getString(shared_network_data, "interface");
260 }
261
262 // Specifying both interface for locally reachable subnets and
263 // interface id for relays is mutually exclusive. Need to test for
264 // this condition.
265 if (!ifaceid.unspecified() && !iface.unspecified() && !ifaceid.empty() &&
266 !iface.empty()) {
268 "parser error: interface (defined for locally reachable "
269 "subnets) and interface-id (defined for subnets reachable"
270 " via relays) cannot be defined at the same time for "
271 "shared network " << name << "("
272 << shared_network_data->getPosition() << ")");
273 }
274
275 // Configure interface-id for remote interfaces, if defined
276 if (!ifaceid.unspecified() && !ifaceid.empty()) {
277 std::string ifaceid_value = ifaceid.get();
278 OptionBuffer tmp(ifaceid_value.begin(), ifaceid_value.end());
280 shared_network->setInterfaceId(opt);
281 }
282
283 // Set interface name. If it is defined, then subnets are available
284 // directly over specified network interface.
285 if (!iface.unspecified() && !iface.empty()) {
286 if (check_iface_ && !IfaceMgr::instance().getIface(iface)) {
287 ConstElementPtr error = shared_network_data->get("interface");
289 "Specified network interface name " << iface
290 << " for shared network " << name
291 << " is not present in the system ("
292 << error->getPosition() << ")");
293 }
294 shared_network->setIface(iface);
295 }
296
297 if (shared_network_data->contains("rapid-commit")) {
298 shared_network->setRapidCommit(getBoolean(shared_network_data,
299 "rapid-commit"));
300 }
301
302 if (shared_network_data->contains("option-data")) {
303 auto json = shared_network_data->get("option-data");
304 // Create parser instance for option-data.
305 CfgOptionPtr cfg_option = shared_network->getCfgOption();
306 OptionDataListParser parser(AF_INET6);
307 parser.parse(cfg_option, json);
308 }
309
310 if (shared_network_data->contains("client-class")) {
311 std::string client_class = getString(shared_network_data, "client-class");
312 if (!client_class.empty()) {
313 shared_network->allowClientClass(client_class);
314 }
315 }
316
317 ConstElementPtr user_context = shared_network_data->get("user-context");
318 if (user_context) {
319 shared_network->setContext(user_context);
320 }
321
322 if (shared_network_data->contains("require-client-classes")) {
323 const std::vector<data::ElementPtr>& class_list =
324 shared_network_data->get("require-client-classes")->listValue();
325 for (auto cclass = class_list.cbegin();
326 cclass != class_list.cend(); ++cclass) {
327 if (((*cclass)->getType() != Element::string) ||
328 (*cclass)->stringValue().empty()) {
329 isc_throw(DhcpConfigError, "invalid class name ("
330 << (*cclass)->getPosition() << ")");
331 }
332 shared_network->requireClientClass((*cclass)->stringValue());
333 }
334 }
335
336 if (shared_network_data->contains("subnet6")) {
337 auto json = shared_network_data->get("subnet6");
338
339 // Create parser instance of subnet6.
341 Subnet6Collection subnets;
342 parser.parse(subnets, json);
343
344 // Add all returned subnets into shared network.
345 for (auto subnet = subnets.cbegin(); subnet != subnets.cend();
346 ++subnet) {
347 shared_network->add(*subnet);
348 }
349 }
350
351 if (shared_network_data->contains("relay")) {
352 auto relay_parms = shared_network_data->get("relay");
353 if (relay_parms) {
356 parser.parse(relay_info, relay_parms);
357 shared_network->setRelayInfo(*relay_info);
358 }
359 }
360
361 parseTeePercents(shared_network_data, network);
362
363 // Parse DDNS parameters
364 parseDdnsParams(shared_network_data, network);
365
366 // Parse lease cache parameters
367 parseCacheParams(shared_network_data, network);
368 } catch (const std::exception& ex) {
369 isc_throw(DhcpConfigError, ex.what() << " ("
370 << shared_network_data->getPosition() << ")");
371 }
372
373 // In order to take advantage of the dynamic inheritance of global
374 // parameters to a shared network we need to set a callback function
375 // for each shared network which can be used to fetch global parameters.
376 shared_network->setFetchGlobalsFn([]() -> ConstElementPtr {
377 return (CfgMgr::instance().getCurrentCfg()->getConfiguredGlobals());
378 });
379
380 return (shared_network);
381}
382
383} // end of namespace isc::dhcp
384} // end of namespace isc
virtual const char * what() const
Returns a C-style character string of the cause of the exception.
static void checkKeywords(const SimpleKeywords &keywords, isc::data::ConstElementPtr scope)
Checks acceptable keywords with their expected type.
const dhcp::Triplet< uint32_t > parseIntTriplet(const data::ConstElementPtr &scope, const std::string &name)
Parses an integer triplet.
static std::string getString(isc::data::ConstElementPtr scope, const std::string &name)
Returns a string parameter from a scope.
static bool getBoolean(isc::data::ConstElementPtr scope, const std::string &name)
Returns a boolean parameter from a scope.
void parseCacheParams(const data::ConstElementPtr &network_data, NetworkPtr &network)
Parses parameters related to lease cache settings.
void parseDdnsParams(const data::ConstElementPtr &network_data, NetworkPtr &network)
Parses parameters pertaining to DDNS behavior.
void parseCommon(const data::ConstElementPtr &network_data, NetworkPtr &network)
Parses common parameters.
static void moveReservationMode(isc::data::ElementPtr config)
Moves deprecated reservation-mode parameter to new reservations flags.
void parseTeePercents(const data::ConstElementPtr &network_data, NetworkPtr &network)
Parses parameters related to "percent" timers settings.
static CfgMgr & instance()
returns a single instance of Configuration Manager
Definition: cfgmgr.cc:25
To be removed. Please use ConfigError instead.
static IfaceMgr & instance()
IfaceMgr is a singleton class.
Definition: iface_mgr.cc:53
Holds optional information about relay.
Definition: network.h:132
boost::shared_ptr< Network::RelayInfo > RelayInfoPtr
Pointer to the RelayInfo structure.
Definition: network.h:180
Parser for option data values within a subnet.
void parse(const CfgOptionPtr &cfg, isc::data::ConstElementPtr option_data_list)
Parses a list of options, instantiates them and stores in cfg.
static const size_t MAX_SNAME_LEN
length of the SNAME field in DHCPv4 message
Definition: pkt4.h:44
static const size_t MAX_FILE_LEN
length of the FILE field in DHCPv4 message
Definition: pkt4.h:47
parser for additional relay information
Definition: dhcp_parsers.h:405
void parse(const isc::dhcp::Network::RelayInfoPtr &relay_info, isc::data::ConstElementPtr relay_elem)
parses the actual relay parameters
SharedNetwork4Parser(bool check_iface=true)
Constructor.
SharedNetwork4Ptr parse(const data::ConstElementPtr &shared_network_data)
Parses shared configuration information for IPv4 shared network.
bool check_iface_
Check if the specified interface exists in the system.
Shared network holding IPv4 subnets.
SharedNetwork6Parser(bool check_iface=true)
Constructor.
SharedNetwork6Ptr parse(const data::ConstElementPtr &shared_network_data)
Parses shared configuration information for IPv6 shared network.
bool check_iface_
Check if the specified interface exists in the system.
Shared network holding IPv6 subnets.
static const isc::data::SimpleKeywords SHARED_NETWORK4_PARAMETERS
This table defines all shared network parameters for DHCPv4.
static const isc::data::SimpleKeywords SHARED_NETWORK6_PARAMETERS
This table defines all shared network parameters for DHCPv6.
this class parses list of DHCP4 subnets
Definition: dhcp_parsers.h:579
size_t parse(SrvConfigPtr cfg, data::ConstElementPtr subnets_list)
parses contents of the list
this class parses a list of DHCP6 subnets
Definition: dhcp_parsers.h:793
size_t parse(SrvConfigPtr cfg, data::ConstElementPtr subnets_list)
parses contents of the list
A template representing an optional value.
Definition: optional.h:36
T get() const
Retrieves the encapsulated value.
Definition: optional.h:112
bool empty() const
Checks if the encapsulated value is empty.
Definition: optional.h:138
void unspecified(bool unspecified)
Modifies the flag that indicates whether the value is specified or unspecified.
Definition: optional.h:121
@ D6O_INTERFACE_ID
Definition: dhcp6.h:38
#define isc_throw(type, stream)
A shortcut macro to insert known values into exception arguments.
boost::shared_ptr< const Element > ConstElementPtr
Definition: data.h:27
boost::shared_ptr< Element > ElementPtr
Definition: data.h:24
@ error
Definition: db_log.h:118
boost::shared_ptr< CfgOption > CfgOptionPtr
Non-const pointer.
Definition: cfg_option.h:706
boost::multi_index_container< Subnet6Ptr, boost::multi_index::indexed_by< boost::multi_index::ordered_unique< boost::multi_index::tag< SubnetSubnetIdIndexTag >, boost::multi_index::const_mem_fun< Subnet, SubnetID, &Subnet::getID > >, boost::multi_index::ordered_unique< boost::multi_index::tag< SubnetPrefixIndexTag >, boost::multi_index::const_mem_fun< Subnet, std::string, &Subnet::toText > >, boost::multi_index::ordered_non_unique< boost::multi_index::tag< SubnetModificationTimeIndexTag >, boost::multi_index::const_mem_fun< data::BaseStampedElement, boost::posix_time::ptime, &data::BaseStampedElement::getModificationTime > > > > Subnet6Collection
A collection of Subnet6 objects.
Definition: subnet.h:914
boost::shared_ptr< SharedNetwork6 > SharedNetwork6Ptr
Pointer to SharedNetwork6 object.
boost::multi_index_container< Subnet4Ptr, boost::multi_index::indexed_by< boost::multi_index::ordered_unique< boost::multi_index::tag< SubnetSubnetIdIndexTag >, boost::multi_index::const_mem_fun< Subnet, SubnetID, &Subnet::getID > >, boost::multi_index::ordered_unique< boost::multi_index::tag< SubnetPrefixIndexTag >, boost::multi_index::const_mem_fun< Subnet, std::string, &Subnet::toText > >, boost::multi_index::ordered_non_unique< boost::multi_index::tag< SubnetServerIdIndexTag >, boost::multi_index::const_mem_fun< Network4, asiolink::IOAddress, &Network4::getServerId > >, boost::multi_index::ordered_non_unique< boost::multi_index::tag< SubnetModificationTimeIndexTag >, boost::multi_index::const_mem_fun< data::BaseStampedElement, boost::posix_time::ptime, &data::BaseStampedElement::getModificationTime > > > > Subnet4Collection
A collection of Subnet4 objects.
Definition: subnet.h:867
boost::shared_ptr< Network > NetworkPtr
Pointer to the Network object.
Definition: network.h:40
std::vector< uint8_t > OptionBuffer
buffer types used in DHCP code.
Definition: option.h:24
boost::shared_ptr< SharedNetwork4 > SharedNetwork4Ptr
Pointer to SharedNetwork4 object.
boost::shared_ptr< Option > OptionPtr
Definition: option.h:36
Definition: edns.h:19
Defines the logger used by the top-level component of kea-lfc.