Kea 2.7.1
netconf.h
Go to the documentation of this file.
1// Copyright (C) 2018-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
8
9#ifndef NETCONF_H
10#define NETCONF_H
11
17
18#include <map>
19
20#include <sysrepo-cpp/Session.hpp>
21
22namespace isc {
23namespace netconf {
24
26class NetconfAgent;
27
29using NetconfAgentPtr = std::shared_ptr<NetconfAgent>;
30
40public:
42 virtual ~NetconfAgent();
43
48 void initSysrepo();
49
58 void init(NetconfCfgMgrPtr cfg_mgr);
59
63 void clear();
64
72 static sysrepo::ErrorCode change(sysrepo::Session sess, const CfgServersMapPair& service_pair);
73
82 static sysrepo::ErrorCode done(sysrepo::Session sess, const CfgServersMapPair& service_pair);
83
92 static void logChanges(sysrepo::Session sess, std::string_view const& model);
93
94protected:
102 void keaConfig(const CfgServersMapPair& service_pair);
103
111 bool checkModule(const std::string& module_name) const;
112
117 void getModules();
118
130 void checkModules(CfgServersMapPtr const& servers = {}) const;
131
143 void yangConfig(const CfgServersMapPair& service_pair);
144
148 void subscribeToDataChanges(const CfgServersMapPair& service_pair);
149
153 void subscribeToNotifications(const CfgServersMapPair& service_pair);
154
157 void announceShutdown() const;
158
160 bool shouldShutdown() const;
161
163 std::optional<sysrepo::Session> startup_sess_;
164
166 std::optional<sysrepo::Session> running_sess_;
167
169 std::map<const std::string, const std::string> modules_;
170
172 std::map<const std::string, sysrepo::Subscription> subscriptions_;
173}; // NetconfAgent
174
175} // namespace netconf
176} // namespace isc
177
178#endif // NETCONF_H
void subscribeToDataChanges(const CfgServersMapPair &service_pair)
Subscribe changes for a module in YANG datastore.
Definition netconf.cc:427
std::optional< sysrepo::Session > running_sess_
Sysrepo running datastore session.
Definition netconf.h:166
void getModules()
Retrieve names and revisions of installed modules through the sysrepo API.
Definition netconf.cc:265
static void logChanges(sysrepo::Session sess, std::string_view const &model)
Log changes.
Definition netconf.cc:699
void yangConfig(const CfgServersMapPair &service_pair)
Retrieve Kea server configuration from the YANG startup datastore and applies it to servers.
Definition netconf.cc:342
virtual ~NetconfAgent()
Destructor (call clear).
Definition netconf.cc:150
void initSysrepo()
Initialize sysrepo sessions.
Definition netconf.cc:250
void keaConfig(const CfgServersMapPair &service_pair)
Get and display Kea server configuration.
Definition netconf.cc:190
void announceShutdown() const
Set the shutdown flag of the process to true so that it can exit at the earliest convenient time.
Definition netconf.cc:746
void checkModules(CfgServersMapPtr const &servers={}) const
Check module availability.
Definition netconf.cc:310
std::map< const std::string, sysrepo::Subscription > subscriptions_
Subscription map.
Definition netconf.h:172
bool shouldShutdown() const
Check the shutdown flag of the process.
Definition netconf.cc:756
static sysrepo::ErrorCode change(sysrepo::Session sess, const CfgServersMapPair &service_pair)
Event::Change callback.
Definition netconf.cc:522
std::optional< sysrepo::Session > startup_sess_
Sysrepo startup datastore session.
Definition netconf.h:163
static sysrepo::ErrorCode done(sysrepo::Session sess, const CfgServersMapPair &service_pair)
Event::Done callback.
Definition netconf.cc:606
void init(NetconfCfgMgrPtr cfg_mgr)
Initialization.
Definition netconf.cc:155
void subscribeToNotifications(const CfgServersMapPair &service_pair)
Subscribe to notifications for a given YANG module.
Definition netconf.cc:476
bool checkModule(const std::string &module_name) const
Check essential module availability.
Definition netconf.cc:285
std::map< const std::string, const std::string > modules_
Available modules and revisions in Sysrepo.
Definition netconf.h:169
Contains declarations for control socket communication.
Contains declarations for HTTP control socket communication.
std::pair< std::string, CfgServerPtr > CfgServersMapPair
Defines a iterator pairing of name and CfgServer.
std::shared_ptr< NetconfAgent > NetconfAgentPtr
Type definition for the pointer to the NetconfAgent.
Definition netconf.h:29
boost::shared_ptr< NetconfCfgMgr > NetconfCfgMgrPtr
Defines a shared pointer to NetconfCfgMgr.
std::shared_ptr< CfgServersMap > CfgServersMapPtr
Defines a pointer to map of CfgServers.
Defines the logger used by the top-level component of kea-lfc.
Contains declarations for stdout control socket communication.
Contains declarations for UNIX control socket communication.