| Kea 3.0.2-git

command_interpreter.h
Go to the documentation of this file.
1// Copyright (C) 2009-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 COMMAND_INTERPRETER_H
8#define COMMAND_INTERPRETER_H
9
10#include <cc/data.h>
11#include <string>
12
19
20 namespace isc {
21 namespace config {
22
24 extern const char *CONTROL_COMMAND;
25
27 extern const char *CONTROL_RESULT;
28
30 extern const char *CONTROL_TEXT;
31
33 extern const char *CONTROL_ARGUMENTS;
34
36 extern const char *CONTROL_SERVICE;
37
39 extern const char *CONTROL_REMOTE_ADDRESS;
40
42 const int CONTROL_RESULT_SUCCESS = 0;
43
45 const int CONTROL_RESULT_ERROR = 1;
46
48 const int CONTROL_RESULT_COMMAND_UNSUPPORTED = 2;
49
53 const int CONTROL_RESULT_EMPTY = 3;
54
59 const int CONTROL_RESULT_CONFLICT = 4;
60
63 class CtrlChannelError : public isc::Exception {
64 public:
65 CtrlChannelError(const char* file, size_t line, const char* what) :
66 isc::Exception(file, line, what) {}
67};
68
72 isc::data::ConstElementPtr createAnswer();
73
80 isc::data::ConstElementPtr createAnswer(const int status_code,
81 const std::string& status_text);
82
90 isc::data::ConstElementPtr createAnswer(const int status_code,
91 const isc::data::ConstElementPtr& arg);
92
100 isc::data::ConstElementPtr createAnswer(const int status_code,
101 const std::string& status,
102 const isc::data::ConstElementPtr& arg);
103
113 isc::data::ConstElementPtr
114 parseAnswer(int &status_code, const isc::data::ConstElementPtr& msg);
115
125 isc::data::ConstElementPtr
126 parseAnswerText(int &rcode, const isc::data::ConstElementPtr& msg);
127
132std::string answerToText(const isc::data::ConstElementPtr& msg);
133
139 isc::data::ConstElementPtr createCommand(const std::string& command);
140
148 isc::data::ConstElementPtr createCommand(const std::string& command,
149 isc::data::ConstElementPtr arg);
150
158 isc::data::ConstElementPtr createCommand(const std::string& command,
159 const std::string& service);
160
170 isc::data::ConstElementPtr createCommand(const std::string& command,
171 isc::data::ConstElementPtr arg,
172 const std::string& service);
173
184std::string parseCommand(isc::data::ConstElementPtr& arg,
185 isc::data::ConstElementPtr command);
186
187
202std::string parseCommandWithArgs(isc::data::ConstElementPtr& arg,
203 isc::data::ConstElementPtr command);
204
218 isc::data::ConstElementPtr
219 combineCommandsLists(const isc::data::ConstElementPtr& response1,
220 const isc::data::ConstElementPtr& response2);
221
222} // namespace config
223} // namespace isc
224
225#endif // COMMAND_INTERPRETER_H
isc::Exception
This is a base class for exceptions thrown from the DNS library module.
Definition exceptions/exceptions.h:23
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::config::CtrlChannelError::CtrlChannelError
CtrlChannelError(const char *file, size_t line, const char *what)
Definition command_interpreter.h:65
data.h
isc::config
Definition command_interpreter.cc:23
isc::config::answerToText
std::string answerToText(const ConstElementPtr &msg)
Converts answer to printable text.
Definition command_interpreter.cc:130
isc::config::CONTROL_ARGUMENTS
const char * CONTROL_ARGUMENTS
String used for arguments map ("arguments").
Definition command_interpreter.cc:28
isc::config::parseAnswerText
ConstElementPtr parseAnswerText(int &rcode, const ConstElementPtr &msg)
Parses a standard config/command level answer and returns text status.
Definition command_interpreter.cc:69
isc::config::CONTROL_RESULT_EMPTY
const int CONTROL_RESULT_EMPTY
Status code indicating that the specified command was completed correctly, but failed to produce any ...
Definition command_interpreter.h:53
isc::config::CONTROL_TEXT
const char * CONTROL_TEXT
String used for storing textual description ("text").
Definition command_interpreter.cc:27
isc::config::CONTROL_COMMAND
const char * CONTROL_COMMAND
String used for commands ("command").
Definition command_interpreter.cc:25
isc::config::parseAnswer
ConstElementPtr parseAnswer(int &rcode, const ConstElementPtr &msg)
Parses a standard config/command level answer and returns arguments or text status code.
Definition command_interpreter.cc:96
isc::config::createCommand
ConstElementPtr createCommand(const std::string &command)
Creates a standard command message with no argument (of the form { "command": "my_command" }...
Definition command_interpreter.cc:168
isc::config::CONTROL_RESULT_ERROR
const int CONTROL_RESULT_ERROR
Status code indicating a general failure.
Definition command_interpreter.h:45
isc::config::combineCommandsLists
ConstElementPtr combineCommandsLists(const ConstElementPtr &response1, const ConstElementPtr &response2)
Combines lists of commands carried in two responses.
Definition command_interpreter.cc:267
isc::config::parseCommand
std::string parseCommand(ConstElementPtr &arg, ConstElementPtr command)
Parses the given command into a string containing the actual command and an ElementPtr containing the...
Definition command_interpreter.cc:201
isc::config::CONTROL_SERVICE
const char * CONTROL_SERVICE
String used for service list ("service").
Definition command_interpreter.cc:29
isc::config::parseCommandWithArgs
std::string parseCommandWithArgs(ConstElementPtr &arg, ConstElementPtr command)
Parses the given command into a string containing the command name and an ElementPtr containing the m...
Definition command_interpreter.cc:239
isc::config::createAnswer
ConstElementPtr createAnswer()
Creates a standard config/command level success answer message (i.e.
Definition command_interpreter.cc:54
isc::config::CONTROL_RESULT_CONFLICT
const int CONTROL_RESULT_CONFLICT
Status code indicating that the command was unsuccessful due to a conflict between the command argume...
Definition command_interpreter.h:59
isc::config::CONTROL_RESULT_COMMAND_UNSUPPORTED
const int CONTROL_RESULT_COMMAND_UNSUPPORTED
Status code indicating that the specified command is not supported.
Definition command_interpreter.h:48
isc::config::CONTROL_REMOTE_ADDRESS
const char * CONTROL_REMOTE_ADDRESS
String used for remote address ("remote-address").
Definition command_interpreter.cc:30
isc::config::CONTROL_RESULT
const char * CONTROL_RESULT
String used for result, i.e. integer status ("result").
Definition command_interpreter.cc:26
isc::config::CONTROL_RESULT_SUCCESS
const int CONTROL_RESULT_SUCCESS
Status code indicating a successful operation.
Definition command_interpreter.h:42
isc::data::ConstElementPtr
boost::shared_ptr< const Element > ConstElementPtr
Definition data.h:29
isc
Defines the logger used by the top-level component of kea-lfc.
Definition agent_parser.cc:148