Kea 3.1.1
config_backend_dhcp6.h
Go to the documentation of this file.
1// Copyright (C) 2019-2025 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 CONFIG_BACKEND_DHCP6_H
8#define CONFIG_BACKEND_DHCP6_H
9
10#include <cc/server_tag.h>
11#include <cc/stamped_value.h>
14#include <database/server.h>
17#include <dhcp/option.h>
19#include <dhcpsrv/cfg_option.h>
22#include <dhcpsrv/subnet.h>
23#include <boost/shared_ptr.hpp>
24#include <boost/date_time/posix_time/ptime.hpp>
25#include <string>
26
27namespace isc {
28namespace dhcp {
29
88public:
89
92
101 virtual Subnet6Ptr
102 getSubnet6(const db::ServerSelector& server_selector,
103 const std::string& subnet_prefix) const = 0;
104
113 virtual Subnet6Ptr
114 getSubnet6(const db::ServerSelector& server_selector, const SubnetID& subnet_id) const = 0;
115
123 virtual Subnet6Collection
124 getAllSubnets6(const db::ServerSelector& server_selector) const = 0;
125
135 virtual Subnet6Collection
137 const std::string& shared_network_name) const = 0;
138
147 virtual Subnet6Collection
149 const boost::posix_time::ptime& modification_time) const = 0;
150
159 virtual SharedNetwork6Ptr
160 getSharedNetwork6(const db::ServerSelector& server_selector,
161 const std::string& name) const = 0;
162
172 getAllSharedNetworks6(const db::ServerSelector& server_selector) const = 0;
173
185 const boost::posix_time::ptime& modification_time) const = 0;
186
196 virtual OptionDefinitionPtr
197 getOptionDef6(const db::ServerSelector& server_selector, const uint16_t code,
198 const std::string& space) const = 0;
199
208 virtual OptionDefContainer
209 getAllOptionDefs6(const db::ServerSelector& server_selector) const = 0;
210
221 virtual OptionDefContainer
223 const boost::posix_time::ptime& modification_time) const = 0;
224
237 virtual OptionDescriptorPtr
238 getOption6(const db::ServerSelector& server_selector, const uint16_t code,
239 const std::string& space,
240 const ClientClassesPtr client_classes = ClientClassesPtr()) const = 0;
241
250 virtual OptionContainer
251 getAllOptions6(const db::ServerSelector& server_selector) const = 0;
252
262 virtual OptionContainer
264 const boost::posix_time::ptime& modification_time) const = 0;
265
277 const std::string& name) const = 0;
278
287 getAllGlobalParameters6(const db::ServerSelector& selector) const = 0;
288
299 const boost::posix_time::ptime& modification_time) const = 0;
300
306 virtual ClientClassDefPtr
307 getClientClass6(const db::ServerSelector& selector, const std::string& name) const = 0;
308
314 getAllClientClasses6(const db::ServerSelector& selector) const = 0;
315
323 const boost::posix_time::ptime& modification_time) const = 0;
324
339 const boost::posix_time::ptime& modification_time,
340 const uint64_t& modification_id) const = 0;
341
349 getAllServers6() const = 0;
350
356 virtual db::ServerPtr
357 getServer6(const data::ServerTag& server_tag) const = 0;
358
366 virtual void
368 const Subnet6Ptr& subnet) = 0;
369
377 virtual void
379 const SharedNetwork6Ptr& shared_network) = 0;
380
388 virtual void
390 const OptionDefinitionPtr& option_def) = 0;
391
399 virtual void
401 const OptionDescriptorPtr& option) = 0;
402
412 virtual void
414 const std::string& shared_network_name,
415 const OptionDescriptorPtr& option) = 0;
416
425 virtual void
427 const SubnetID& subnet_id,
428 const OptionDescriptorPtr& option) = 0;
429
441 virtual void
443 const asiolink::IOAddress& pool_start_address,
444 const asiolink::IOAddress& pool_end_address,
445 const OptionDescriptorPtr& option) = 0;
446
458 virtual void
460 const asiolink::IOAddress& pd_pool_prefix,
461 const uint8_t pd_pool_prefix_length,
462 const OptionDescriptorPtr& option) = 0;
463
471 virtual void
473 const data::StampedValuePtr& value) = 0;
474
483 virtual void
485 const ClientClassDefPtr& client_class,
486 const std::string& follow_class_name) = 0;
487
491 virtual void
493
502 virtual uint64_t
503 deleteSubnet6(const db::ServerSelector& server_selector,
504 const std::string& subnet_prefix) = 0;
505
514 virtual uint64_t
515 deleteSubnet6(const db::ServerSelector& server_selector, const SubnetID& subnet_id) = 0;
516
524 virtual uint64_t
525 deleteAllSubnets6(const db::ServerSelector& server_selector) = 0;
526
536 virtual uint64_t
538 const std::string& shared_network_name) = 0;
539
548 virtual uint64_t
550 const std::string& name) = 0;
551
559 virtual uint64_t
560 deleteAllSharedNetworks6(const db::ServerSelector& server_selector) = 0;
561
571 virtual uint64_t
572 deleteOptionDef6(const db::ServerSelector& server_selector,
573 const uint16_t code,
574 const std::string& space) = 0;
575
583 virtual uint64_t
584 deleteAllOptionDefs6(const db::ServerSelector& server_selector) = 0;
585
597 virtual uint64_t
598 deleteOption6(const db::ServerSelector& server_selector,
599 const uint16_t code,
600 const std::string& space,
601 ClientClassesPtr client_classes = ClientClassesPtr()) = 0;
602
616 virtual uint64_t
618 const std::string& shared_network_name,
619 const uint16_t code,
620 const std::string& space,
621 ClientClassesPtr client_classes = ClientClassesPtr()) = 0;
622
636 virtual uint64_t
637 deleteOption6(const db::ServerSelector& server_selector,
638 const SubnetID& subnet_id,
639 const uint16_t code,
640 const std::string& space,
641 ClientClassesPtr client_classes = ClientClassesPtr()) = 0;
642
658 virtual uint64_t
659 deleteOption6(const db::ServerSelector& server_selector,
660 const asiolink::IOAddress& pool_start_address,
661 const asiolink::IOAddress& pool_end_address,
662 const uint16_t code,
663 const std::string& space,
664 ClientClassesPtr client_classes = ClientClassesPtr()) = 0;
665
681 virtual uint64_t
682 deleteOption6(const db::ServerSelector& server_selector,
683 const asiolink::IOAddress& pd_pool_prefix,
684 const uint8_t pd_pool_prefix_length,
685 const uint16_t code,
686 const std::string& space,
687 ClientClassesPtr client_classes = ClientClassesPtr()) = 0;
688
697 virtual uint64_t
699 const std::string& name) = 0;
700
708 virtual uint64_t
710
716 virtual uint64_t
718 const std::string& name) = 0;
719
724 virtual uint64_t
725 deleteAllClientClasses6(const db::ServerSelector& server_selector) = 0;
726
731 virtual uint64_t
732 deleteServer6(const data::ServerTag& server_tag) = 0;
733
738 virtual uint64_t
740};
741
743typedef boost::shared_ptr<ConfigBackendDHCPv6> ConfigBackendDHCPv6Ptr;
744
745} // end of namespace isc::dhcp
746} // end of namespace isc
747
748#endif // CONFIG_BACKEND_DHCP6_H
Interface for Kea server specific configuration backend implementations.
Represents a server tag.
Definition server_tag.h:25
Server selector for associating objects in a database with specific servers.
Maintains a list of ClientClassDef's.
Interface implemented by DHCPv6 configuration backends.
virtual ~ConfigBackendDHCPv6()
Virtual destructor.
virtual OptionDefinitionPtr getOptionDef6(const db::ServerSelector &server_selector, const uint16_t code, const std::string &space) const =0
Retrieves single option definition by code and space.
virtual data::StampedValueCollection getModifiedGlobalParameters6(const db::ServerSelector &selector, const boost::posix_time::ptime &modification_time) const =0
Retrieves global parameters modified after specified time.
virtual OptionDefContainer getAllOptionDefs6(const db::ServerSelector &server_selector) const =0
Retrieves all option definitions.
virtual uint64_t deleteAllSubnets6(const db::ServerSelector &server_selector)=0
Deletes all subnets.
virtual uint64_t deleteOption6(const db::ServerSelector &server_selector, const asiolink::IOAddress &pd_pool_prefix, const uint8_t pd_pool_prefix_length, const uint16_t code, const std::string &space, ClientClassesPtr client_classes=ClientClassesPtr())=0
Deletes prefix delegation pool level option.
virtual void createUpdateOption6(const db::ServerSelector &server_selector, const asiolink::IOAddress &pd_pool_prefix, const uint8_t pd_pool_prefix_length, const OptionDescriptorPtr &option)=0
Creates or updates prefix delegation pool level option.
virtual uint64_t deleteSubnet6(const db::ServerSelector &server_selector, const std::string &subnet_prefix)=0
Deletes subnet by prefix.
virtual void createUpdateOption6(const db::ServerSelector &server_selector, const asiolink::IOAddress &pool_start_address, const asiolink::IOAddress &pool_end_address, const OptionDescriptorPtr &option)=0
Creates or updates pool level option.
virtual data::StampedValueCollection getAllGlobalParameters6(const db::ServerSelector &selector) const =0
Retrieves all global parameters.
virtual ClientClassDefPtr getClientClass6(const db::ServerSelector &selector, const std::string &name) const =0
Retrieves a client class by name.
virtual uint64_t deleteClientClass6(const db::ServerSelector &server_selector, const std::string &name)=0
Deletes a client class.
virtual void createUpdateOption6(const db::ServerSelector &server_selector, const SubnetID &subnet_id, const OptionDescriptorPtr &option)=0
Creates or updates subnet level option.
virtual uint64_t deleteServer6(const data::ServerTag &server_tag)=0
Deletes a server from the backend.
virtual uint64_t deleteOption6(const db::ServerSelector &server_selector, const asiolink::IOAddress &pool_start_address, const asiolink::IOAddress &pool_end_address, const uint16_t code, const std::string &space, ClientClassesPtr client_classes=ClientClassesPtr())=0
Deletes pool level option.
virtual ClientClassDictionary getModifiedClientClasses6(const db::ServerSelector &selector, const boost::posix_time::ptime &modification_time) const =0
Retrieves client classes modified after specified time.
virtual SharedNetwork6Ptr getSharedNetwork6(const db::ServerSelector &server_selector, const std::string &name) const =0
Retrieves shared network by name.
virtual db::AuditEntryCollection getRecentAuditEntries(const db::ServerSelector &server_selector, const boost::posix_time::ptime &modification_time, const uint64_t &modification_id) const =0
Retrieves the most recent audit entries.
virtual SharedNetwork6Collection getAllSharedNetworks6(const db::ServerSelector &server_selector) const =0
Retrieves all shared networks.
virtual db::ServerPtr getServer6(const data::ServerTag &server_tag) const =0
Retrieves a server.
virtual ClientClassDictionary getAllClientClasses6(const db::ServerSelector &selector) const =0
Retrieves all client classes.
virtual void createUpdateClientClass6(const db::ServerSelector &server_selector, const ClientClassDefPtr &client_class, const std::string &follow_class_name)=0
Creates or updates a client class.
virtual uint64_t deleteSharedNetworkSubnets6(const db::ServerSelector &server_selector, const std::string &shared_network_name)=0
Deletes all subnets belonging to a specified shared network.
virtual uint64_t deleteOptionDef6(const db::ServerSelector &server_selector, const uint16_t code, const std::string &space)=0
Deletes option definition.
virtual uint64_t deleteGlobalParameter6(const db::ServerSelector &server_selector, const std::string &name)=0
Deletes global parameter.
virtual uint64_t deleteOption6(const db::ServerSelector &selector, const std::string &shared_network_name, const uint16_t code, const std::string &space, ClientClassesPtr client_classes=ClientClassesPtr())=0
Deletes shared network level option.
virtual void createUpdateServer6(const db::ServerPtr &server)=0
Creates or updates a server.
virtual Subnet6Ptr getSubnet6(const db::ServerSelector &server_selector, const std::string &subnet_prefix) const =0
Retrieves a single subnet by subnet_prefix.
virtual uint64_t deleteSharedNetwork6(const db::ServerSelector &server_selector, const std::string &name)=0
Deletes shared network by name.
virtual uint64_t deleteAllClientClasses6(const db::ServerSelector &server_selector)=0
Deletes all client classes.
virtual uint64_t deleteAllSharedNetworks6(const db::ServerSelector &server_selector)=0
Deletes all shared networks.
virtual db::ServerCollection getAllServers6() const =0
Retrieves all servers.
virtual OptionContainer getModifiedOptions6(const db::ServerSelector &selector, const boost::posix_time::ptime &modification_time) const =0
Retrieves options modified after specified time.
virtual Subnet6Ptr getSubnet6(const db::ServerSelector &server_selector, const SubnetID &subnet_id) const =0
Retrieves a single subnet by subnet identifier.
virtual OptionDescriptorPtr getOption6(const db::ServerSelector &server_selector, const uint16_t code, const std::string &space, const ClientClassesPtr client_classes=ClientClassesPtr()) const =0
Retrieves single option by code and space.
virtual data::StampedValuePtr getGlobalParameter6(const db::ServerSelector &selector, const std::string &name) const =0
Retrieves global parameter value.
virtual void createUpdateSubnet6(const db::ServerSelector &server_selector, const Subnet6Ptr &subnet)=0
Creates or updates a subnet.
virtual void createUpdateGlobalParameter6(const db::ServerSelector &server_selector, const data::StampedValuePtr &value)=0
Creates or updates global parameter.
virtual uint64_t deleteOption6(const db::ServerSelector &server_selector, const SubnetID &subnet_id, const uint16_t code, const std::string &space, ClientClassesPtr client_classes=ClientClassesPtr())=0
Deletes subnet level option.
virtual OptionContainer getAllOptions6(const db::ServerSelector &server_selector) const =0
Retrieves all global options.
virtual uint64_t deleteSubnet6(const db::ServerSelector &server_selector, const SubnetID &subnet_id)=0
Deletes subnet by identifier.
virtual void createUpdateOption6(const db::ServerSelector &server_selector, const OptionDescriptorPtr &option)=0
Creates or updates global option.
virtual Subnet6Collection getSharedNetworkSubnets6(const db::ServerSelector &server_selector, const std::string &shared_network_name) const =0
Retrieves all subnets belonging to a specified shared network.
virtual uint64_t deleteOption6(const db::ServerSelector &server_selector, const uint16_t code, const std::string &space, ClientClassesPtr client_classes=ClientClassesPtr())=0
Deletes global option.
virtual OptionDefContainer getModifiedOptionDefs6(const db::ServerSelector &server_selector, const boost::posix_time::ptime &modification_time) const =0
Retrieves option definitions modified after specified time.
virtual void createUpdateOption6(const db::ServerSelector &selector, const std::string &shared_network_name, const OptionDescriptorPtr &option)=0
Creates or updates shared network level option.
virtual Subnet6Collection getModifiedSubnets6(const db::ServerSelector &server_selector, const boost::posix_time::ptime &modification_time) const =0
Retrieves subnets modified after specified time.
virtual uint64_t deleteAllOptionDefs6(const db::ServerSelector &server_selector)=0
Deletes all option definitions.
virtual void createUpdateSharedNetwork6(const db::ServerSelector &server_selector, const SharedNetwork6Ptr &shared_network)=0
Creates or updates a shared network.
virtual Subnet6Collection getAllSubnets6(const db::ServerSelector &server_selector) const =0
Retrieves all subnets.
virtual uint64_t deleteAllGlobalParameters6(const db::ServerSelector &server_selector)=0
Deletes all global parameters.
virtual SharedNetwork6Collection getModifiedSharedNetworks6(const db::ServerSelector &server_selector, const boost::posix_time::ptime &modification_time) const =0
Retrieves shared networks modified after specified time.
virtual uint64_t deleteAllServers6()=0
Deletes all servers from the backend except the logical server 'all'.
virtual void createUpdateOptionDef6(const db::ServerSelector &server_selector, const OptionDefinitionPtr &option_def)=0
Creates or updates an option definition.
Defines classes for storing client class definitions.
boost::shared_ptr< StampedValue > StampedValuePtr
Pointer to the stamped value.
boost::multi_index_container< StampedValuePtr, boost::multi_index::indexed_by< boost::multi_index::hashed_non_unique< boost::multi_index::tag< StampedValueNameIndexTag >, boost::multi_index::const_mem_fun< StampedValue, std::string, &StampedValue::getName > >, boost::multi_index::ordered_non_unique< boost::multi_index::tag< StampedValueModificationTimeIndexTag >, boost::multi_index::const_mem_fun< BaseStampedElement, boost::posix_time::ptime, &BaseStampedElement::getModificationTime > > > > StampedValueCollection
Multi index container for StampedValue.
boost::shared_ptr< Server > ServerPtr
Shared pointer to the Server class.
Definition server.h:22
boost::multi_index_container< AuditEntryPtr, boost::multi_index::indexed_by< boost::multi_index::ordered_non_unique< boost::multi_index::tag< AuditEntryObjectTypeTag >, boost::multi_index::composite_key< AuditEntry, boost::multi_index::const_mem_fun< AuditEntry, std::string, &AuditEntry::getObjectType >, boost::multi_index::const_mem_fun< AuditEntry, AuditEntry::ModificationType, &AuditEntry::getModificationType > > >, boost::multi_index::ordered_non_unique< boost::multi_index::tag< AuditEntryModificationTimeIdTag >, boost::multi_index::composite_key< AuditEntry, boost::multi_index::const_mem_fun< AuditEntry, boost::posix_time::ptime, &AuditEntry::getModificationTime >, boost::multi_index::const_mem_fun< AuditEntry, uint64_t, &AuditEntry::getRevisionId > > >, boost::multi_index::hashed_non_unique< boost::multi_index::tag< AuditEntryObjectIdTag >, boost::multi_index::const_mem_fun< AuditEntry, uint64_t, &AuditEntry::getObjectId > > > > AuditEntryCollection
Multi index container holding AuditEntry instances.
boost::multi_index_container< ServerPtr, boost::multi_index::indexed_by< boost::multi_index::ordered_unique< boost::multi_index::tag< ServerTagIndexTag >, boost::multi_index::const_mem_fun< Server, std::string, &Server::getServerTagAsText > > > > ServerCollection
Multi index container for Server.
boost::shared_ptr< ConfigBackendDHCPv6 > ConfigBackendDHCPv6Ptr
Shared pointer to the ConfigBackendDHCPv6 instance.
boost::multi_index_container< OptionDescriptor, boost::multi_index::indexed_by< boost::multi_index::sequenced<>, boost::multi_index::hashed_non_unique< KeyFromKeyExtractor< boost::multi_index::const_mem_fun< Option, uint16_t, &Option::getType >, boost::multi_index::member< OptionDescriptor, OptionPtr, &OptionDescriptor::option_ > > >, boost::multi_index::hashed_non_unique< boost::multi_index::member< OptionDescriptor, bool, &OptionDescriptor::persistent_ > >, boost::multi_index::ordered_non_unique< boost::multi_index::const_mem_fun< data::BaseStampedElement, boost::posix_time::ptime, &data::BaseStampedElement::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 > >, boost::multi_index::hashed_non_unique< boost::multi_index::member< OptionDescriptor, bool, &OptionDescriptor::cancelled_ > >, boost::multi_index::hashed_non_unique< boost::multi_index::composite_key< OptionDescriptor, KeyFromKeyExtractor< boost::multi_index::const_mem_fun< Option, uint16_t, &Option::getType >, boost::multi_index::member< OptionDescriptor, OptionPtr, &OptionDescriptor::option_ > >, boost::multi_index::member< OptionDescriptor, ClientClasses, &OptionDescriptor::client_classes_ > > > > > OptionContainer
Multi index container for DHCP option descriptors.
Definition cfg_option.h:347
boost::multi_index_container< SharedNetwork6Ptr, boost::multi_index::indexed_by< boost::multi_index::random_access< boost::multi_index::tag< SharedNetworkRandomAccessIndexTag > >, boost::multi_index::hashed_non_unique< boost::multi_index::tag< SharedNetworkIdIndexTag >, boost::multi_index::const_mem_fun< data::BaseStampedElement, uint64_t, &data::BaseStampedElement::getId > >, boost::multi_index::ordered_unique< boost::multi_index::tag< SharedNetworkNameIndexTag >, boost::multi_index::const_mem_fun< SharedNetwork6, std::string, &SharedNetwork6::getName > >, boost::multi_index::ordered_non_unique< boost::multi_index::tag< SharedNetworkModificationTimeIndexTag >, boost::multi_index::const_mem_fun< data::BaseStampedElement, boost::posix_time::ptime, &data::BaseStampedElement::getModificationTime > > > > SharedNetwork6Collection
Multi index container holding shared networks.
boost::shared_ptr< Subnet6 > Subnet6Ptr
A pointer to a Subnet6 object.
Definition subnet.h:626
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:937
boost::shared_ptr< ClientClasses > ClientClassesPtr
Smart pointer to ClientClasses object.
Definition classify.h:281
boost::shared_ptr< ClientClassDef > ClientClassDefPtr
a pointer to an ClientClassDef
boost::shared_ptr< OptionDefinition > OptionDefinitionPtr
Pointer to option definition object.
boost::shared_ptr< SharedNetwork6 > SharedNetwork6Ptr
Pointer to SharedNetwork6 object.
boost::shared_ptr< OptionDescriptor > OptionDescriptorPtr
A pointer to option descriptor.
Definition cfg_option.h:38
uint32_t SubnetID
Defines unique IPv4 or IPv6 subnet identifier.
Definition subnet_id.h:25
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.
Defines the logger used by the top-level component of kea-lfc.