Kea: option_definition.h Source File

| Kea 3.0.3-git

option_definition.h
Go to the documentation of this file.
1// Copyright (C) 2012-2024 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#ifndef OPTION_DEFINITION_H
8#define OPTION_DEFINITION_H
9
10#include <dhcp/option.h>
11#include <dhcp/option_data_types.h>
12#include <dhcp/option_space_container.h>
13#include <cc/stamped_element.h>
14#include <cc/user_context.h>
15
16#include <boost/multi_index/hashed_index.hpp>
17#include <boost/multi_index/mem_fun.hpp>
18#include <boost/multi_index/ordered_index.hpp>
19#include <boost/multi_index/sequenced_index.hpp>
20#include <boost/multi_index_container.hpp>
21#include <boost/shared_ptr.hpp>
22#include <map>
23#include <string>
24
25namespace isc {
26namespace dhcp {
27
30 class InvalidOptionValue : public Exception {
31public:
32 InvalidOptionValue(const char* file, size_t line, const char* what) :
33 isc::Exception(file, line, what) { }
34};
35
37 class MalformedOptionDefinition : public Exception {
38public:
39 MalformedOptionDefinition(const char* file, size_t line, const char* what) :
40 isc::Exception(file, line, what) { }
41};
42
45 class DuplicateOptionDefinition : public Exception {
46public:
47 DuplicateOptionDefinition(const char* file, size_t line, const char* what) :
48 isc::Exception(file, line, what) { }
49};
50
52class OptionDefinition;
53
55 typedef boost::shared_ptr<OptionDefinition> OptionDefinitionPtr;
56
64template<typename T>
65class OptionInt;
66
74template<typename T>
75class OptionIntArray;
76
138 class OptionDefinition : public data::StampedElement {
139public:
140
142 typedef std::vector<OptionDataType> RecordFieldsCollection;
144 typedef std::vector<OptionDataType>::const_iterator RecordFieldsConstIter;
145
154 explicit OptionDefinition(const std::string& name,
155 const uint16_t code,
156 const std::string& space,
157 const std::string& type,
158 const bool array_type = false);
159
168 explicit OptionDefinition(const std::string& name,
169 const uint16_t code,
170 const std::string& space,
171 const OptionDataType type,
172 const bool array_type = false);
173
189 explicit OptionDefinition(const std::string& name,
190 const uint16_t code,
191 const std::string& space,
192 const std::string& type,
193 const char* encapsulated_space);
194
210 explicit OptionDefinition(const std::string& name,
211 const uint16_t code,
212 const std::string& space,
213 const OptionDataType type,
214 const char* encapsulated_space);
215
231 static OptionDefinitionPtr create(const std::string& name,
232 const uint16_t code,
233 const std::string& space,
234 const std::string& type,
235 const bool array_type = false);
236
252 static OptionDefinitionPtr create(const std::string& name,
253 const uint16_t code,
254 const std::string& space,
255 const OptionDataType type,
256 const bool array_type = false);
257
273 static OptionDefinitionPtr create(const std::string& name,
274 const uint16_t code,
275 const std::string& space,
276 const std::string& type,
277 const char* encapsulated_space);
278
294 static OptionDefinitionPtr create(const std::string& name,
295 const uint16_t code,
296 const std::string& space,
297 const OptionDataType type,
298 const char* encapsulated_space);
299
302
303
308 bool equals(const OptionDefinition& other) const;
309
315 bool operator==(const OptionDefinition& other) const {
316 return (equals(other));
317 }
318
324 bool operator!=(const OptionDefinition& other) const {
325 return (!equals(other));
326 }
327
328
335 void addRecordField(const std::string& data_type_name);
336
343 void addRecordField(const OptionDataType data_type);
344
351 bool getArrayType() const { return (array_type_); }
352
356 uint16_t getCode() const { return (code_); }
357
361 std::string getEncapsulatedSpace() const {
362 return (encapsulated_space_);
363 }
364
368 std::string getName() const { return (name_); }
369
373 const RecordFieldsCollection& getRecordFields() const {
374 return (record_fields_);
375 }
376
380 std::string getOptionSpaceName() const {
381 return (option_space_name_);
382 }
383
387 OptionDataType getType() const { return (type_); }
388
390 data::ConstElementPtr getContext() const {
391 return (user_context_.getContext());
392 }
393
396 void setContext(const data::ConstElementPtr& ctx) {
397 user_context_.setContext(ctx);
398 }
399
406 void contextToElement(data::ElementPtr map) const {
407 user_context_.contextToElement(map);
408 }
409
420 void validate() const;
421
443 OptionPtr optionFactory(Option::Universe u,
444 uint16_t type,
445 OptionBufferConstIter begin,
446 OptionBufferConstIter end,
447 bool convenient_notation = false) const;
448
465 OptionPtr optionFactory(Option::Universe u, uint16_t type,
466 const OptionBuffer& buf = OptionBuffer()) const;
467
492 OptionPtr optionFactory(Option::Universe u, uint16_t type,
493 const std::vector<std::string>& values) const;
494
505 static OptionPtr factoryAddrList4(uint16_t type,
506 OptionBufferConstIter begin,
507 OptionBufferConstIter end);
508
519 static OptionPtr factoryAddrList6(uint16_t type,
520 OptionBufferConstIter begin,
521 OptionBufferConstIter end);
522
527 static OptionPtr factoryEmpty(Option::Universe u, uint16_t type);
528
535 static OptionPtr factoryGeneric(Option::Universe u, uint16_t type,
536 OptionBufferConstIter begin,
537 OptionBufferConstIter end);
538
547 static OptionPtr factoryIA6(uint16_t type,
548 OptionBufferConstIter begin,
549 OptionBufferConstIter end);
550
559 static OptionPtr factoryIAAddr6(uint16_t type,
560 OptionBufferConstIter begin,
561 OptionBufferConstIter end);
562
571 static OptionPtr factoryIAPrefix6(uint16_t type,
572 OptionBufferConstIter begin,
573 OptionBufferConstIter end);
574
585 static OptionPtr factoryOpaqueDataTuples(Option::Universe u,
586 uint16_t type,
587 OptionBufferConstIter begin,
588 OptionBufferConstIter end);
589
602 static OptionPtr factoryOpaqueDataTuples(Option::Universe u,
603 uint16_t type,
604 OptionBufferConstIter begin,
605 OptionBufferConstIter end,
606 OpaqueDataTuple::LengthFieldType length_field_type);
607
620 template<typename T>
621 static OptionPtr factoryInteger(Option::Universe u, uint16_t type,
622 const std::string& encapsulated_space,
623 OptionBufferConstIter begin,
624 OptionBufferConstIter end) {
625 OptionPtr option(new OptionInt<T>(u, type, 0));
626 option->setEncapsulatedSpace(encapsulated_space);
627 option->unpack(begin, end);
628 return (option);
629 }
630
640 template<typename T>
641 static OptionPtr factoryIntegerArray(Option::Universe u,
642 uint16_t type,
643 OptionBufferConstIter begin,
644 OptionBufferConstIter end) {
645 OptionPtr option(new OptionIntArray<T>(u, type, begin, end));
646 return (option);
647 }
648
649private:
650
652 bool haveCompressedFqdnListFormat() const;
653
663 OptionPtr factoryFqdnList(Option::Universe u,
664 OptionBufferConstIter begin,
665 OptionBufferConstIter end) const;
666
687 OptionPtr factorySpecialFormatOption(Option::Universe u,
688 OptionBufferConstIter begin,
689 OptionBufferConstIter end,
690 bool convenient_notation = false) const;
691
695 inline bool haveType(const OptionDataType type) const {
696 return (type == type_);
697 }
698
702 inline bool haveSpace(const std::string& space) const {
703 return (space == option_space_name_);
704 }
705
724 bool convertToBool(const std::string& value_str) const;
725
738 template<typename T>
739 T lexicalCastWithRangeCheck(const std::string& value_str) const;
740
757 void writeToBuffer(Option::Universe u, const std::string& value,
758 const OptionDataType type, OptionBuffer& buf) const;
759
761 std::string name_;
763 uint16_t code_;
765 OptionDataType type_;
767 bool array_type_;
769 std::string encapsulated_space_;
771 RecordFieldsCollection record_fields_;
773 data::UserContext user_context_;
775 std::string option_space_name_;
776};
777
778
793typedef boost::multi_index_container<
794 // Container comprises elements of OptionDefinition type.
795 OptionDefinitionPtr,
796 // Here we start enumerating various indexes.
797 boost::multi_index::indexed_by<
798 // Sequenced index allows accessing elements in the same way
799 // as elements in std::list. Sequenced is an index #0.
800 boost::multi_index::sequenced<>,
801 // Start definition of index #1.
802 boost::multi_index::hashed_non_unique<
803 // Use option type as the index key. The type is held
804 // in OptionDefinition object so we have to call
805 // OptionDefinition::getCode to retrieve this key
806 // for each element. The option code is non-unique so
807 // multiple elements with the same option code can
808 // be returned by this index.
809 boost::multi_index::const_mem_fun<
810 OptionDefinition,
811 uint16_t,
812 &OptionDefinition::getCode
813 >
814 >,
815 // Start definition of index #2
816 boost::multi_index::hashed_non_unique<
817 // Use option name as the index key. This value is
818 // returned by the @c OptionDefinition::getName
819 // method.
820 boost::multi_index::const_mem_fun<
821 OptionDefinition,
822 std::string,
823 &OptionDefinition::getName
824 >
825 >,
826 // Start definition of index #3
827 boost::multi_index::ordered_non_unique<
828 // Use option definition modification time as the index key.
829 // This value is returned by the BaseStampedElement::getModificationTime
830 boost::multi_index::const_mem_fun<
831 data::BaseStampedElement,
832 boost::posix_time::ptime,
833 &data::StampedElement::getModificationTime
834 >
835 >,
836 // Start definition of index #4.
837 // Use StampedElement::getId as a key.
838 boost::multi_index::hashed_non_unique<
839 boost::multi_index::tag<OptionIdIndexTag>,
840 boost::multi_index::const_mem_fun<data::BaseStampedElement, uint64_t,
841 &data::BaseStampedElement::getId>
842 >
843 >
844> OptionDefContainer;
845
847 typedef boost::shared_ptr<OptionDefContainer> OptionDefContainerPtr;
848
850 typedef std::map<std::string, OptionDefContainerPtr> OptionDefContainers;
851
853 typedef std::map<uint32_t, OptionDefContainerPtr> VendorOptionDefContainers;
854
856 typedef OptionDefContainer::nth_index<1>::type OptionDefContainerTypeIndex;
861typedef std::pair<OptionDefContainerTypeIndex::const_iterator,
862 OptionDefContainerTypeIndex::const_iterator> OptionDefContainerTypeRange;
863
865 typedef OptionDefContainer::nth_index<2>::type OptionDefContainerNameIndex;
870typedef std::pair<OptionDefContainerNameIndex::const_iterator,
871 OptionDefContainerNameIndex::const_iterator> OptionDefContainerNameRange;
872
874typedef OptionSpaceContainer<
875 OptionDefContainer, OptionDefinitionPtr, std::string
876> BaseOptionDefSpaceContainer;
877
879 class OptionDefSpaceContainer : public BaseOptionDefSpaceContainer {
880public:
881
890 void addItem(const OptionDefinitionPtr& def) {
891 BaseOptionDefSpaceContainer::addItem(def, def->getOptionSpaceName());
892 }
893};
894
895} // namespace isc::dhcp
896} // namespace isc
897
898#endif // OPTION_DEFINITION_H
isc::Exception::Exception
Exception(const char *file, size_t line, const char *what)
Constructor for a given type for exceptions with file name and file line number.
Definition exceptions/exceptions.cc:17
isc::Exception::what
virtual const char * what() const
Returns a C-style character string of the cause of the exception.
Definition exceptions/exceptions.cc:32
isc::data::BaseStampedElement::getModificationTime
boost::posix_time::ptime getModificationTime() const
Returns timestamp.
Definition base_stamped_element.h:61
isc::data::BaseStampedElement::getId
uint64_t getId() const
Returns element's database identifier.
Definition base_stamped_element.h:46
isc::data::StampedElement
This class represents configuration element which is associated with database identifier,...
Definition stamped_element.h:34
isc::dhcp::DuplicateOptionDefinition::DuplicateOptionDefinition
DuplicateOptionDefinition(const char *file, size_t line, const char *what)
Definition option_definition.h:47
isc::dhcp::InvalidOptionValue::InvalidOptionValue
InvalidOptionValue(const char *file, size_t line, const char *what)
Definition option_definition.h:32
isc::dhcp::MalformedOptionDefinition::MalformedOptionDefinition
MalformedOptionDefinition(const char *file, size_t line, const char *what)
Definition option_definition.h:39
isc::dhcp::OpaqueDataTuple::LengthFieldType
LengthFieldType
Size of the length field in the tuple.
Definition opaque_data_tuple.h:56
isc::dhcp::OptionDefSpaceContainer
Class of option definition space container.
Definition option_definition.h:879
isc::dhcp::OptionDefSpaceContainer::addItem
void addItem(const OptionDefinitionPtr &def)
Adds a new option definition to the container.
Definition option_definition.h:890
isc::dhcp::OptionDefinition
Base class representing a DHCP option definition.
Definition option_definition.h:138
isc::dhcp::OptionDefinition::getCode
uint16_t getCode() const
Return option code.
Definition option_definition.h:356
isc::dhcp::OptionDefinition::operator==
bool operator==(const OptionDefinition &other) const
Equality operator.
Definition option_definition.h:315
isc::dhcp::OptionDefinition::factoryEmpty
static OptionPtr factoryEmpty(Option::Universe u, uint16_t type)
Empty option factory.
Definition option_definition.cc:758
isc::dhcp::OptionDefinition::factoryInteger
static OptionPtr factoryInteger(Option::Universe u, uint16_t type, const std::string &encapsulated_space, OptionBufferConstIter begin, OptionBufferConstIter end)
Factory function to create option with integer value.
Definition option_definition.h:621
isc::dhcp::OptionDefinition::factoryIAPrefix6
static OptionPtr factoryIAPrefix6(uint16_t type, OptionBufferConstIter begin, OptionBufferConstIter end)
Factory for IAPREFIX-type of option.
Definition option_definition.cc:799
isc::dhcp::OptionDefinition::factoryIntegerArray
static OptionPtr factoryIntegerArray(Option::Universe u, uint16_t type, OptionBufferConstIter begin, OptionBufferConstIter end)
Factory function to create option with array of integer values.
Definition option_definition.h:641
isc::dhcp::OptionDefinition::OptionDefinition
OptionDefinition(const std::string &name, const uint16_t code, const std::string &space, const std::string &type, const bool array_type=false)
Constructor.
Definition option_definition.cc:48
isc::dhcp::OptionDefinition::operator!=
bool operator!=(const OptionDefinition &other) const
Inequality operator.
Definition option_definition.h:324
isc::dhcp::OptionDefinition::getType
OptionDataType getType() const
Return option data type.
Definition option_definition.h:387
isc::dhcp::OptionDefinition::factoryAddrList6
static OptionPtr factoryAddrList6(uint16_t type, OptionBufferConstIter begin, OptionBufferConstIter end)
Factory to create option with address list.
Definition option_definition.cc:748
isc::dhcp::OptionDefinition::factoryAddrList4
static OptionPtr factoryAddrList4(uint16_t type, OptionBufferConstIter begin, OptionBufferConstIter end)
Factory to create option with address list.
Definition option_definition.cc:739
isc::dhcp::OptionDefinition::setContext
void setContext(const data::ConstElementPtr &ctx)
Sets user context.
Definition option_definition.h:396
isc::dhcp::OptionDefinition::getOptionSpaceName
std::string getOptionSpaceName() const
Returns option space name.
Definition option_definition.h:380
isc::dhcp::OptionDefinition::RecordFieldsConstIter
std::vector< OptionDataType >::const_iterator RecordFieldsConstIter
Const iterator for record data fields.
Definition option_definition.h:144
isc::dhcp::OptionDefinition::optionFactory
OptionPtr optionFactory(Option::Universe u, uint16_t type, OptionBufferConstIter begin, OptionBufferConstIter end, bool convenient_notation=false) const
Option factory.
Definition option_definition.cc:186
isc::dhcp::OptionDefinition::factoryIAAddr6
static OptionPtr factoryIAAddr6(uint16_t type, OptionBufferConstIter begin, OptionBufferConstIter end)
Factory for IAADDR-type of option.
Definition option_definition.cc:785
isc::dhcp::OptionDefinition::getContext
data::ConstElementPtr getContext() const
Returns const pointer to the user context.
Definition option_definition.h:390
isc::dhcp::OptionDefinition::addRecordField
void addRecordField(const std::string &data_type_name)
Adds data field to the record.
Definition option_definition.cc:161
isc::dhcp::OptionDefinition::equals
bool equals(const OptionDefinition &other) const
Check if option definition is equal to other.
Definition option_definition.cc:150
isc::dhcp::OptionDefinition::contextToElement
void contextToElement(data::ElementPtr map) const
Merge unparse a user_context object.
Definition option_definition.h:406
isc::dhcp::OptionDefinition::getName
std::string getName() const
Return option name.
Definition option_definition.h:368
isc::dhcp::OptionDefinition::getRecordFields
const RecordFieldsCollection & getRecordFields() const
Return list of record fields.
Definition option_definition.h:373
isc::dhcp::OptionDefinition::validate
void validate() const
Check if the option definition is valid.
Definition option_definition.cc:369
isc::dhcp::OptionDefinition::RecordFieldsCollection
std::vector< OptionDataType > RecordFieldsCollection
List of fields within the record.
Definition option_definition.h:142
isc::dhcp::OptionDefinition::factoryIA6
static OptionPtr factoryIA6(uint16_t type, OptionBufferConstIter begin, OptionBufferConstIter end)
Factory for IA-type of option.
Definition option_definition.cc:772
isc::dhcp::OptionDefinition::getEncapsulatedSpace
std::string getEncapsulatedSpace() const
Return name of the encapsulated option space.
Definition option_definition.h:361
isc::dhcp::OptionDefinition::create
static OptionDefinitionPtr create(const std::string &name, const uint16_t code, const std::string &space, const std::string &type, const bool array_type=false)
Factory function creating an instance of the OptionDefinition.
Definition option_definition.cc:114
isc::dhcp::OptionDefinition::factoryOpaqueDataTuples
static OptionPtr factoryOpaqueDataTuples(Option::Universe u, uint16_t type, OptionBufferConstIter begin, OptionBufferConstIter end)
Factory to create option with tuple list.
Definition option_definition.cc:813
isc::dhcp::OptionDefinition::getArrayType
bool getArrayType() const
Return array type indicator.
Definition option_definition.h:351
isc::dhcp::OptionDefinition::factoryGeneric
static OptionPtr factoryGeneric(Option::Universe u, uint16_t type, OptionBufferConstIter begin, OptionBufferConstIter end)
Factory to create generic option.
Definition option_definition.cc:764
isc::dhcp::OptionIntArray
Forward declaration to OptionIntArray.
Definition option_int_array.h:56
isc::dhcp::OptionInt
Forward declaration to OptionInt.
Definition option_int.h:49
isc::dhcp::OptionSpaceContainer
Simple container for option spaces holding various items.
Definition option_space_container.h:32
isc::dhcp::OptionSpaceContainer< OptionDefContainer, OptionDefinitionPtr, std::string >::addItem
void addItem(const OptionDefinitionPtr &item, const std::string &option_space)
Definition option_space_container.h:49
isc::dhcp::Option::Universe
Universe
defines option universe DHCPv4 or DHCPv6
Definition option.h:90
isc::data::ConstElementPtr
boost::shared_ptr< const Element > ConstElementPtr
Definition data.h:30
isc::data::ElementPtr
boost::shared_ptr< Element > ElementPtr
Definition data.h:29
isc::dhcp
Definition dhcp4/client_handler.cc:20
isc::dhcp::OptionBufferConstIter
OptionBuffer::const_iterator OptionBufferConstIter
const_iterator for walking over OptionBuffer
Definition option.h:30
isc::dhcp::OptionDataType
OptionDataType
Data types of DHCP option fields.
Definition option_data_types.h:45
isc::dhcp::BaseOptionDefSpaceContainer
OptionSpaceContainer< OptionDefContainer, OptionDefinitionPtr, std::string > BaseOptionDefSpaceContainer
Base type of option definition space container.
Definition option_definition.h:876
isc::dhcp::VendorOptionDefContainers
std::map< uint32_t, OptionDefContainerPtr > VendorOptionDefContainers
Container that holds various vendor option containers.
Definition option_definition.h:853
isc::dhcp::OptionDefinitionPtr
boost::shared_ptr< OptionDefinition > OptionDefinitionPtr
Pointer to option definition object.
Definition option_definition.h:55
isc::dhcp::OptionDefContainerNameRange
std::pair< OptionDefContainerNameIndex::const_iterator, OptionDefContainerNameIndex::const_iterator > OptionDefContainerNameRange
Pair of iterators to represent the range of options definitions having the same option name.
Definition option_definition.h:871
isc::dhcp::OptionDefContainers
std::map< std::string, OptionDefContainerPtr > OptionDefContainers
Container that holds option definitions for various option spaces.
Definition option_definition.h:850
isc::dhcp::OptionDefContainerNameIndex
OptionDefContainer::nth_index< 2 >::type OptionDefContainerNameIndex
Type of the index #2 - option name.
Definition option_definition.h:865
isc::dhcp::OptionBuffer
std::vector< uint8_t > OptionBuffer
buffer types used in DHCP code.
Definition option.h:24
isc::dhcp::OptionDefContainerTypeRange
std::pair< OptionDefContainerTypeIndex::const_iterator, OptionDefContainerTypeIndex::const_iterator > OptionDefContainerTypeRange
Pair of iterators to represent the range of options definitions having the same option type value.
Definition option_definition.h:862
isc::dhcp::OptionDefContainer
boost::multi_index_container< OptionDefinitionPtr, boost::multi_index::indexed_by< boost::multi_index::sequenced<>, boost::multi_index::hashed_non_unique< boost::multi_index::const_mem_fun< OptionDefinition, uint16_t, &OptionDefinition::getCode > >, boost::multi_index::hashed_non_unique< boost::multi_index::const_mem_fun< OptionDefinition, std::string, &OptionDefinition::getName > >, boost::multi_index::ordered_non_unique< boost::multi_index::const_mem_fun< data::BaseStampedElement, boost::posix_time::ptime, &data::StampedElement::getModificationTime > >, boost::multi_index::hashed_non_unique< boost::multi_index::tag< OptionIdIndexTag >, boost::multi_index::const_mem_fun< data::BaseStampedElement, uint64_t, &data::BaseStampedElement::getId > > > > OptionDefContainer
Multi index container for DHCP option definitions.
Definition option_definition.h:844
isc::dhcp::OptionDefContainerTypeIndex
OptionDefContainer::nth_index< 1 >::type OptionDefContainerTypeIndex
Type of the index #1 - option type.
Definition option_definition.h:856
isc::dhcp::OptionPtr
boost::shared_ptr< Option > OptionPtr
Definition option.h:37
isc::dhcp::OptionDefContainerPtr
boost::shared_ptr< OptionDefContainer > OptionDefContainerPtr
Pointer to an option definition container.
Definition option_definition.h:847
isc::util::file
Definition filesystem.cc:28
isc
Defines the logger used by the top-level component of kea-lfc.
Definition agent_parser.cc:148
option.h
option_data_types.h
option_space_container.h
stamped_element.h
user_context.h