Kea 3.1.5
unix_control_socket.cc
Go to the documentation of this file.
1// Copyright (C) 2018-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
9
10#include <config.h>
11
13#include <asiolink/io_service.h>
15#include <cc/json_feed.h>
17#include <config/timeouts.h>
20
21using namespace std;
22using namespace isc::asiolink;
23using namespace isc::config;
24using namespace isc::data;
25
26namespace isc {
27namespace netconf {
28
33
37
39UnixControlSocket::configGet(const string& /*service*/) {
40 return (sendCommand(createCommand("config-get")));
41}
42
45 const string& /*service*/) {
46 return (sendCommand(createCommand("config-test", config)));
47}
48
51 const string& /*service*/) {
52 return (sendCommand(createCommand("config-set", config)));
53}
54
56UnixControlSocket::sendCommand(ConstElementPtr command) {
57 // We are using our own IO service because this method is synchronous.
58 IOServicePtr io_service(new IOService());
59 ClientConnection conn(io_service);
60 boost::system::error_code received_ec;
61 ConstJSONFeedPtr received_feed;
62
63 string name(getName());
65
66 conn.start(ClientConnection::SocketPath(name),
67 ClientConnection::ControlCommand(command->toWire()),
68 [&io_service, &received_ec, &received_feed]
69 (const boost::system::error_code& ec, ConstJSONFeedPtr feed) {
70 // Capture error code and parsed data.
71 received_ec = ec;
72 received_feed = feed;
73 // Got the IO service so stop IO service. This causes to
74 // stop IO service when all handlers have been invoked.
75 io_service->stopWork();
76 },
78
79 // Perform this synchronously.
80 io_service->run();
81
82 if (received_ec) {
83 // Got an error.
84 isc_throw(ControlSocketError, "communication error: "
85 << received_ec.message());
86 }
87
88 if (!received_feed) {
89 // Failed to get the answer.
90 isc_throw(ControlSocketError, "empty response");
91 }
92
93 try {
94 return (received_feed->toElement());
95 } catch (exception const& ex) {
96 isc_throw(ControlSocketError, "unparsable response: " << ex.what());
97 }
98}
99
100} // namespace netconf
101} // namespace isc
Represents client side connection over the unix domain socket.
static std::string validatePath(const std::string socket_path)
Validates a path against the supported path for unix control sockets.
ControlSocketBase(CfgControlSocketPtr ctrl_sock)
Constructor.
const std::string getName() const
Returns the Unix socket name.
Exception thrown when the error during communication.
Class for control socket communication over UNIX socket.
data::ConstElementPtr configTest(data::ElementPtr config, const std::string &service) override final
Test configuration.
UnixControlSocket(CfgControlSocketPtr ctrl_sock)
Constructor.
data::ConstElementPtr configGet(const std::string &service) override final
Get configuration.
data::ConstElementPtr configSet(data::ElementPtr config, const std::string &service) override final
Set configuration.
This file contains several functions and constants that are used for handling commands and responses ...
#define isc_throw(type, stream)
A shortcut macro to insert known values into exception arguments.
boost::shared_ptr< const JSONFeed > ConstJSONFeedPtr
Pointer to the const JSONFeed.
Definition json_feed.h:27
ConstElementPtr createCommand(const std::string &command)
Creates a standard command message with no argument (of the form { "command": "my_command" }...
constexpr long TIMEOUT_AGENT_FORWARD_COMMAND
Timeout for the Control Agent to forward command to a Kea server, e.g.
Definition timeouts.h:31
boost::shared_ptr< const Element > ConstElementPtr
Definition data.h:29
boost::shared_ptr< Element > ElementPtr
Definition data.h:28
std::shared_ptr< ControlSocketBase > ControlSocketBasePtr
Type definition for the pointer to the ControlSocketBase.
ControlSocketBasePtr createControlSocket< CfgControlSocket::Type::UNIX >(CfgControlSocketPtr ctrl_sock)
Factory template specialization for unix control sockets.
std::shared_ptr< CfgControlSocket > CfgControlSocketPtr
Defines a pointer for CfgControlSocket instances.
std::shared_ptr< UnixControlSocket > UnixControlSocketPtr
Type definition for the pointer to the UnixControlSocket.
Defines the logger used by the top-level component of kea-lfc.
Contains declarations for UNIX control socket communication.