The following steps may involve changing files in the repository.
1. [ ] Run [update-code-for-release.py](https://gitlab.isc.org/isc-private/qa-dhcp/-/blob/master/kea/build/update-code-for-release.py) <br>
- Example command: `GITLAB_TOKEN='...' ./update-code-for-release.py 1.9.7 'Apr 28, 2021' ~/isc/repos/kea/` <br>
- Help: `GITLAB_TOKEN="..." update-code-for-release.py --help`<br>
+ Example command: `GITLAB_TOKEN='...' ./update-code-for-release.py 1.9.7 ~/isc/repos/kea/` <br>
+ Help: `GITLAB_TOKEN="..." ./update-code-for-release.py --help`<br>
This script makes the following changes and actions:
1. run prepare_kea_release.sh that does:
- 1.1. add release entries in ChangeLogs
- 1.2. update Kea version in configure.ac
- 1.3. update copyright years in files that were changed in current year
- 1.4. sort message files
- 1.5. regenerate message files headers
+ 1. add release entries in ChangeLogs
+ 1. update Kea version in configure.ac
+ 1. update copyright years in files that were changed in current year
+ 1. sort message files
+ 1. regenerate message files headers
2. regenerate parsers using Bison from Docker<br>
- using with --upload:
+ With `--upload`:
3. create an issue in GitLab for release changes in kea repo
4. create branches and merge requests for kea and kea-premium
5. commit the changes in both repos
+Kea 2.3.3 (development) released on November 30, 2022
+
2078. [build] andrei
The library version numbers have been bumped for the Kea 2.3.3
development release.
2076. [doc] razvan
Add documentation for template classes and the new parameter
'template-test' which evaluates to a string value. This indicates
- if the class is spaning classes with the name containing the
+ if the class is spawning classes with the name containing the
evaluated value: 'SPAWN_<template-class-name>_<evaluated-value>'
only if the value is not empty string. This will also add the
packet to the <template-class-name> class.
{
"dhcp4":
{
- "comment": "control socket for DHCP4 server",
+ "comment": "control socket for DHCPv4 server",
"socket-type": "unix",
"socket-name": "/tmp/kea4-ctrl-socket"
}
// This is how the Agent can communicate with the DHCPv4 server.
"dhcp4":
{
- "comment": "socket to DHCP4 server",
+ "comment": "socket to DHCPv4 server",
"socket-type": "unix",
"socket-name": "/tmp/kea4-ctrl-socket"
},
// further. The default value is 60000ms (60 seconds).
"sync-timeout": 60000,
// To not experience performance degradation when the Kea server is
- // processing packets on multiple threads, the High Availablility module
+ // processing packets on multiple threads, the High Availability module
// must have multi-threading enabled.
"multi-threading": {
"enable-multi-threading": true,
// further. The default value is 60000ms (60 seconds).
"sync-timeout": 60000,
// To not experience performance degradation when the Kea server is
- // processing packets on multiple threads, the High Availablility module
+ // processing packets on multiple threads, the High Availability module
// must have multi-threading enabled.
"multi-threading": {
"enable-multi-threading": true,
},
// Comment is optional. You can put some notes here.
- "comment": "Kea DHCP4 server serving network on floor 13"
+ "comment": "Kea DHCPv4 server serving network on floor 13"
}
},
},
// Comment is optional. You can put some notes here.
- "comment": "Kea DHCP6 server serving network on floor 13"
+ "comment": "Kea DHCPv6 server serving network on floor 13"
}
},
To deploy this setup, follow the steps provided in the power user home setup with the following distinctions:
1. Install CA only if the administrator is planning to manage Kea using RESTful API.
- Otherwise, the High Availablility Kea server with multi-threading does not require CA to run.
+ Otherwise, the High Availability Kea server with multi-threading does not require CA to run.
2. Alter the following to match the local setup:
// This is how the Agent can communicate with the DHCPv4 server.
"dhcp4":
{
- "comment": "socket to DHCP4 server",
+ "comment": "socket to DHCPv4 server",
"socket-type": "unix",
"socket-name": "/tmp/kea4-ctrl-socket"
},
// This is how the Agent can communicate with the DHCPv4 server.
"dhcp4":
{
- "comment": "socket to DHCP4 server",
+ "comment": "socket to DHCPv4 server",
"socket-type": "unix",
"socket-name": "/tmp/kea4-ctrl-socket"
},
"sync-timeout": 60000,
// Multi-threading parameters.
// To not experience performance degradation when the Kea server is
- // processing packets on multiple threads, the High Availablility module
+ // processing packets on multiple threads, the High Availability module
// must have multi-threading enabled.
"multi-threading": {
"enable-multi-threading": true,
"sync-timeout": 60000,
// Multi-threading parameters.
// To not experience performance degradation when the Kea server is
- // processing packets on multiple threads, the High Availablility module
+ // processing packets on multiple threads, the High Availability module
// must have multi-threading enabled.
"multi-threading": {
"enable-multi-threading": true,
// This is how the Agent can communicate with the DHCPv4 server.
"dhcp4":
{
- "comment": "socket to DHCP4 server",
+ "comment": "socket to DHCPv4 server",
"socket-type": "unix",
"socket-name": "/tmp/kea4-ctrl-socket"
},
// This is how the Agent can communicate with the DHCPv4 server.
"dhcp4":
{
- "comment": "socket to DHCP4 server",
+ "comment": "socket to DHCPv4 server",
"socket-type": "unix",
"socket-name": "/tmp/kea4-ctrl-socket"
},
effectively associating the regular class to the packet. In this second case,
both ``SPAWN_Client-ID_foobar`` and ``Client-ID`` classes will be associated
with the packet.
-The ``test`` expression on the regular classs ``SPAWN_Client-ID_foobar`` is not
+The ``test`` expression on the regular class ``SPAWN_Client-ID_foobar`` is not
mandatory and can be omitted, but it is used here with a different match
expression for example purposes.
options, are associated with the spawned class. This permits configuring
limits which apply for all packets associated with a class spawned at
runtime, according to the ``template-test`` expression in the parent template
- class. For a more detaild description on how to configure limits using the
+ class. For a more detailed description on how to configure limits using the
limits hooks library see the :ref:`hooks-limits-configuration`.
For example, using the configuration below, ingress DHCPv6 packets that have
client ID values (in the format expressed by the Kea evaluator) ``foobar``
We encourage Kea users to utilize these functions to store information
used by other systems and custom hooks.
-For example, the `subnet4-update` command can be used to add user context data
+For example, the ``subnet4-update`` command can be used to add user context data
to an existing subnet.
::
Kea also uses user context to store non-standard data.
Currently, only :ref:`dhcp4-store-extended-info` uses this feature.
-When enabled, it adds the ISC key in `user-context` to differentiate automatically
+When enabled, it adds the ISC key in ``user-context`` to differentiate automatically
added content.
Example of relay information stored in a lease:
This example shows a configuration using an automatically generated
``VENDOR_CLASS_`` class. The administrator of the network has decided that
addresses in the range 2001:db8:1::1 to 2001:db8:1::ffff are to be
-managed by the DHCP6 server and that only clients belonging to the
+managed by the DHCPv6 server and that only clients belonging to the
eRouter1.0 client class are allowed to use that pool.
::
// This is how kea-netconf can communicate with the DHCPv4 server.
"dhcp4":
{
- "comment": "DHCP4 server",
+ "comment": "DHCPv4 server",
"model": "kea-dhcp4-server",
"control-socket":
{
If the packet contains only one IA_NA, the IAID value will be changed to ``0``
and stored as such in the lease storage. Similarly if the packet contains only
one IA_PD, the IAID value will be changed to ``0`` and stored as such in the
-lease storage. The IAID is restored to its intitial value in the response back
+lease storage. The IAID is restored to its initial value in the response back
to the client. The change is visible in the identifier expression if the IAID is
part of the expression.
Hook libraries are loaded by individual Kea processes, not by Kea as a
whole. This means, among other things, that it is possible to associate one set
-of libraries with the DHCP4 server and a different set with the DHCP6
+of libraries with the DHCPv4 server and a different set with the DHCPv6
server.
It is also possible for a process to load
If your goal is to have the entire Kea software suite installed, it is
recommended that you simply ``apt install isc-kea`` after upgrading, which
-will install all of the relevent subpackages that make up Kea.
+will install all of the relevant subpackages that make up Kea.
This upgrade path hiccup is not present on RPM and Alpine systems, however
if you experience issues with upgrading past 2.3.1, please inform us on the
Kea is officially supported on Alpine, CentOS, Fedora, Ubuntu, Debian,
and FreeBSD systems. Kea-|release| builds have been tested on:
-* Alpine — 3.13, 3.14, 3.15, 3.16
+* Alpine — 3.14, 3.15, 3.16
* CentOS — 7
* Debian — 10, 11
-* Fedora — 35, 36
+* Fedora — 36
* FreeBSD — 12, 13
* RHEL — 8, 9
* Ubuntu — 18.04, 20.04, 22.04
do so quickly due to lack of hardware, less familiarity on the part of
engineering staff, and other constraints.
-* FreeBSD — 11
-* macOS — 10.15, 11, 12
+* macOS — 11, 12, 13
Community-Maintained
--------------------
-These systems may not all have the required dependencies for building Kea
-easily available, although it is possible in many cases to compile
-those directly from source. The community and interested parties may wish
-to help with maintenance, and we welcome patch contributions, although we
-cannot guarantee that we will accept them. All contributions are
-assessed against the risk of adverse effect on officially supported
-platforms.
+These systems have once been regularly tested, but official support for it has
+been abandoned, usually due to discontinued support on their own part. Older
+versions may not have the required dependencies for building Kea easily
+available, although it is possible in many cases to compile on those directly
+from source. The community and interested parties may wish to help with
+maintenance, and we welcome patch contributions, although we cannot guarantee
+that we will accept them. All contributions are assessed against the risk of
+adverse effect on officially supported platforms.
These include platforms past their respective EOL dates, such as:
-* Alpine — 3.10 (1 May 2021), 3.11, 3.12
-* CentOS — 6 (30 November 2020), 8 (31 December 2021)
-* Debian — 8 (30 June 2020), 9 (June 30, 2022)
-* Fedora — 31, 32, 33, 34
-* FreeBSD — 10 (31 October 2018)
-* macOS — 10.13, 10.14
-* Ubuntu — 14.04, 18.10, 19.04, 19.10, 21.04
+* Alpine — 3.10, 3.11, 3.12, 3.13 (EOL 01 November 2022)
+* CentOS — 6, 8 (EOL 31 December 2021)
+* Debian — 8, 9 (EOL 30 June 2022)
+* Fedora — 31, 32, 33, 34, 35 (EOL 13 December 2022)
+* FreeBSD — 10, 11 (EOL 30 September 2021)
+* macOS — 10.13, 10.14, 10.15 (EOL 12 September 2022)
+* Ubuntu — 14.04, 18.10, 19.04, 19.10, 21.04 (EOL 20 January 2022)
Unsupported Platforms
---------------------
-// Copyright (C) 2017 Internet Systems Consortium, Inc. ("ISC")
+// Copyright (C) 2017-2022 Internet Systems Consortium, Inc. ("ISC")
//
// This Source Code Form is subject to the terms of the Mozilla Public
// License, v. 2.0. If a copy of the MPL was not distributed with this
burden on Kea maintenance.
In the installations where securing command channel is critical (most of the
-installations?), a reverse HTTP proxy can be setup using one of the third
+installations?), a reverse HTTP proxy can be set up using one of the third
party HTTP server implementations, e.g. Apache, nginx etc.
*/
-// Copyright (C) 2012-2018 Internet Systems Consortium, Inc. ("ISC")
+// Copyright (C) 2012-2022 Internet Systems Consortium, Inc. ("ISC")
//
// This Source Code Form is subject to the terms of the Mozilla Public
// License, v. 2.0. If a copy of the MPL was not distributed with this
right revision in the sysrepo repository. The name, expected and
available revisions of the module are printed.
+% NETCONF_NOTIFICATION_RECEIVED Received notification of type %1 for module %1: %2
+This informational message logs any YANG notification that has been signaled
+by the server, sent to kea-netconf which then was forwarded to subscribed
+clients. To achieve this, kea-netconf subscribes itself as a client to all
+notifications for the configured module.
+
% NETCONF_NOT_SUBSCRIBED_TO_NOTIFICATIONS subscribing to notifications for %1 server with %2 module failed: %3
The warning message indicates that kea-netconf got an error subscribing to
notifications for a Kea server. The most probable cause is probably that the
there may be other more unxpected causes as well.
The server name, module name and the error are printed.
-% NETCONF_NOTIFICATION_RECEIVED Received notification of type %1 for module %1: %2
-This informational message logs any YANG notification that has been signaled
-by the server, sent to kea-netconf which then was forwarded to subscribed
-clients. To achieve this, kea-netconf subscribes itself as a client to all
-notifications for the configured module.
-
% NETCONF_RUN_EXIT application is exiting the event loop
This is a debug message issued when kea-netconf exits its
event loop. This is a normal step during kea-netconf shutdown.
// The empty status can occur for the lease6-bulk-apply command. In that
// case, the response may contain conflicted or erred leases within the
// arguments, rather than globally. For other error cases let's construct
- // the error message from tyhe global values.
+ // the error message from the global values.
if (rcode != CONTROL_RESULT_EMPTY) {
// Include an error text if available.
if (args && args->getType() == Element::string) {
-// Copyright (C) 2018-2021 Internet Systems Consortium, Inc. ("ISC")
+// Copyright (C) 2018-2022 Internet Systems Consortium, Inc. ("ISC")
//
// This Source Code Form is subject to the terms of the Mozilla Public
// License, v. 2.0. If a copy of the MPL was not distributed with this
-// Copyright (C) 2011-2021 Internet Systems Consortium, Inc. ("ISC")
+// Copyright (C) 2011-2022 Internet Systems Consortium, Inc. ("ISC")
//
// This Source Code Form is subject to the terms of the Mozilla Public
// License, v. 2.0. If a copy of the MPL was not distributed with this
}
}
- // If we timeout, we stop, which will can cancel outstanding I/Os and
- // shutdown everything.
+ // If we timeout, we stop, which cancels outstanding I/O operations and
+ // shuts down everything.
if (data_->timeout != -1) {
data_->timer.expires_from_now(boost::posix_time::milliseconds(
data_->timeout));
-// Copyright (C) 2013-2021 Internet Systems Consortium, Inc. ("ISC")
+// Copyright (C) 2013-2022 Internet Systems Consortium, Inc. ("ISC")
//
// This Source Code Form is subject to the terms of the Mozilla Public
// License, v. 2.0. If a copy of the MPL was not distributed with this
class TSIGKeyInfo : public isc::data::UserContext, public isc::data::CfgToElement {
public:
/// @brief Defines string values for the supported TSIG algorithms
- //@{
+ /// @{
static const char* HMAC_MD5_STR;
static const char* HMAC_SHA1_STR;
static const char* HMAC_SHA256_STR;
static const char* HMAC_SHA224_STR;
static const char* HMAC_SHA384_STR;
static const char* HMAC_SHA512_STR;
- //}@
+ /// @}
/// @brief Constructor
///
-// Copyright (C) 2012-2021 Internet Systems Consortium, Inc. ("ISC")
+// Copyright (C) 2012-2022 Internet Systems Consortium, Inc. ("ISC")
//
// This Source Code Form is subject to the terms of the Mozilla Public
// License, v. 2.0. If a copy of the MPL was not distributed with this
/// @brief Return array type indicator.
///
/// The method returns the bool value to indicate whether the option is a
- /// a single value or an array of values.
+ /// single value or an array of values.
///
/// @return true if option comprises an array of values.
bool getArrayType() const { return (array_type_); }
/// Kea configuration. To prevent this, option copying should be
/// enabled prior to passing the pointer to a packet to a hook library.
///
- /// Note that only only does this method causes the server to copy
+ /// Not only does this method cause the server to copy
/// an option, but the copied option also replaces the original
/// option within the packet. The option can be then freely modified
/// and the modifications will only affect the instance of this
HWAddrPtr remote_hw_addr(new HWAddr(dest_hw_addr, 6, 1));
ASSERT_NO_THROW(pkt->setRemoteHWAddr(remote_hw_addr));
- // Set the broadcast flasg.
+ // Set the broadcast flags.
pkt->setFlags(pkt->getFlags() | Pkt4::FLAG_BROADCAST_MASK);
// Construct the ethernet header using HW addresses stored
HWAddrPtr remote_hw_addr(new HWAddr(dest_hw_addr, 6, 1));
ASSERT_NO_THROW(pkt->setRemoteHWAddr(remote_hw_addr));
- // Set the broadcast flasg.
+ // Set the broadcast flags.
pkt->setFlags(pkt->getFlags() | Pkt4::FLAG_BROADCAST_MASK);
// Set a gateway address: the broadcast flag is now for
-// Copyright (C) 2012-2019 Internet Systems Consortium, Inc. ("ISC")
+// Copyright (C) 2012-2022 Internet Systems Consortium, Inc. ("ISC")
//
// This Source Code Form is subject to the terms of the Mozilla Public
// License, v. 2.0. If a copy of the MPL was not distributed with this
/// @brief Removes staging configuration.
///
/// This function should be called when there is a staging configuration
- /// (likely created in the previous configuration attempt) but the entirely
+ /// (likely created in the previous configuration attempt) but the entire
/// new configuration should be created. It removes the existing staging
/// configuration and the next call to @c CfgMgr::getStagingCfg will return a
/// fresh (default) configuration.
/// If incoming packet is associated with the template class, the name of
/// generated spawned class is prepended with this prefix.
/// For example, a packet that associates with the template class "FOO" by
- /// evaluating the templeta class expression to BAR will cause the packet to
+ /// evaluating the template class expression to BAR will cause the packet to
/// be assigned to class SPAWN_FOO_BAR.
static const std::string SPAWN_CLASS_PREFIX;
};
The code has issued a begin transaction call. For the memory file database, this is
a no-op.
-% DHCPSRV_MEMFILE_BUILD_EXTENDED_INFO_TABLES6_ERROR building extended info tables got an exception on the lease for %1: %2
-A debug message issued when the server is building extended info tables and
-receives an exception processing a lease.
-
% DHCPSRV_MEMFILE_BUILD_EXTENDED_INFO_TABLES6 building extended info tables saw %1 leases, extended info sanity checks modified %2 / updated %3 leases and %4 leases were entered into tables
Extended info tables build was finished. Some statistics are displayed, the
updated in database is returned to the command interface.
+% DHCPSRV_MEMFILE_BUILD_EXTENDED_INFO_TABLES6_ERROR building extended info tables got an exception on the lease for %1: %2
+A debug message issued when the server is building extended info tables and
+receives an exception processing a lease.
+
% DHCPSRV_MEMFILE_COMMIT committing to memory file database
The code has issued a commit call. For the memory file database, this is
a no-op.
}
namespace {
+
std::string
-idtoText(const OptionBuffer& id) {
+idToText(const OptionBuffer& id) {
std::stringstream tmp;
tmp << std::hex;
bool delim = false;
}
return (tmp.str());
}
+
} // anonymous namespace
Lease4Collection
DHCPSRV_MEMFILE_GET_RELAYID4)
.arg(page_size.page_size_)
.arg(lower_bound_address.toText())
- .arg(idtoText(relay_id))
+ .arg(idToText(relay_id))
.arg(qry_start_time)
.arg(qry_end_time);
DHCPSRV_MEMFILE_GET_REMOTEID4)
.arg(page_size.page_size_)
.arg(lower_bound_address.toText())
- .arg(idtoText(remote_id))
+ .arg(idToText(remote_id))
.arg(qry_start_time)
.arg(qry_end_time);
DHCPSRV_MEMFILE_GET_REMOTEID6)
.arg(page_size.page_size_)
.arg(lower_bound_address.toText())
- .arg(idtoText(remote_id))
+ .arg(idToText(remote_id))
.arg(link_addr.toText())
.arg(static_cast<unsigned>(link_len));
-// Copyright (C) 2012-2020 Internet Systems Consortium, Inc. ("ISC")
+// Copyright (C) 2012-2022 Internet Systems Consortium, Inc. ("ISC")
//
// This Source Code Form is subject to the terms of the Mozilla Public
// License, v. 2.0. If a copy of the MPL was not distributed with this
EXPECT_FALSE(state->isLastAllocatedValid());
}
-} // end of anonymouns namespace
+} // anonymous namespace
// Note that with persist when the database is reloaded the user context
// is still there so tables will be updated: the ACTION_IGNORE setting
- // has no persistent effect: instead clenup the user context before
+ // has no persistent effect: instead cleanup the user context before
// calling updateLease6...
}
-// Copyright (C) 2011-2015,2017 Internet Systems Consortium, Inc. ("ISC")
+// Copyright (C) 2011-2022 Internet Systems Consortium, Inc. ("ISC")
//
// This Source Code Form is subject to the terms of the Mozilla Public
// License, v. 2.0. If a copy of the MPL was not distributed with this
/// This is a helper class to add a set of message IDs and associated text to
/// the global dictionary.
///
-/// It should be declared outside an execution unit and initialized with a
+/// It should be declared outside an execution unit and initialized with
/// an array of values, alternating identifier, associated text and ending with
/// a NULL, e.g.
///
/// will be stored.
/// @param buffer_size size of the output buffer
/// @param[out] bytes_converted number of bytes converted
- /// value
///
/// @throw DbOperationError if the value cannot be fetched or is
/// invalid.
/// @brief Returns an empty end point.
///
- /// @return an unitialized endpoint.
+ /// @return an uninitialized endpoint.
static const boost::asio::ip::tcp::endpoint& NO_ENDPOINT() {
static boost::asio::ip::tcp::endpoint endpoint;
return (endpoint);
$NAMESPACE isc::tcp
+% MT_TCP_LISTENER_MGR_STARTED MtTcpListenerMgr started with %1 threads, listening on %2:%3, use TLS: %4
+This debug messages is issued when an MtTcpListenerMgr has been started to
+accept connections. Arguments detail the number of threads that the listener
+is using, the address and port at which it is listening, and if TLS is used
+or not.
+
+% MT_TCP_LISTENER_MGR_STOPPED MtTcpListenerMgr for %1:%2 stopped.
+This debug messages is issued when the MtTcpListenerMgr, listening
+at the given address and port, has completed shutdown.
+
+% MT_TCP_LISTENER_MGR_STOPPING Stopping MtTcpListenerMgr for %1:%2
+This debug messages is issued when the MtTcpListenerMgr, listening
+at the given address and port, has begun to shutdown.
+
% TCP_CLIENT_REQUEST_RECEIVED received TCP request from %1
This debug message is issued when the server finished receiving a TCP
request from the remote endpoint. The address of the remote endpoint is
of the remote endpoint. The second argument specifies request timeout in
seconds.
+% TCP_CONNECTION_REJECTED_BY_FILTER connection from %1 has been denied by the connection filter.
+This debug message is issued when the server's connection filter rejects
+a new connection based on the client's ip address.
+
% TCP_CONNECTION_SHUTDOWN shutting down TCP connection from %1
This debug message is issued when one of the TCP connections is shut down.
The connection can be stopped as a result of an error or after the
or as a result of synchronization with a time server. Any ongoing transactions
will be interrupted. New transactions should be conducted normally.
-% TCP_CONNECTION_REJECTED_BY_FILTER connection from %1 has been denied by the connection filter.
-This debug message is issued when the server's connection filter rejects
-a new connection based on the client's ip address.
+% TCP_REQUEST_RECEIVED_FAILED An unexpected error occurred processing a request from %1, error: %2
+This error message is issued when an unexpected error occurred while the
+server attempted to process a received request. The first argument specifies
+the address of the remote endpoint. The second argument describes the nature
+error.
% TCP_REQUEST_RECEIVE_START start receiving request from %1 with timeout %2
This debug message is issued when the server starts receiving new request
of the remote endpoint. The second argument specifies request timeout in
seconds.
-% TCP_REQUEST_RECEIVED_FAILED An unexpected error occurred processing a request from %1, error: %2
-This error message is issued when an unexpected error occurred while the
-server attempted to process a received request. The first argument specifies
-the address of the remote endpoint. The second argument describes the nature
-error.
-
% TCP_SERVER_RESPONSE_SEND sending TCP response %1 to %2
This debug message is issued when the server is starting to send a TCP
response to a remote endpoint. The first argument holds basic information
response is being sent. The second argument provides a response in the
textual form. The response is truncated by the logger if it is too large
to be printed.
-
-% MT_TCP_LISTENER_MGR_STARTED MtTcpListenerMgr started with %1 threads, listening on %2:%3, use TLS: %4
-This debug messages is issued when an MtTcpListenerMgr has been started to
-accept connections. Arguments detail the number of threads that the listener
-is using, the address and port at which it is listening, and if TLS is used
-or not.
-
-% MT_TCP_LISTENER_MGR_STOPPED MtTcpListenerMgr for %1:%2 stopped.
-This debug messages is issued when the MtTcpListenerMgr, listening
-at the given address and port, has completed shutdown.
-
-% MT_TCP_LISTENER_MGR_STOPPING Stopping MtTcpListenerMgr for %1:%2
-This debug messages is issued when the MtTcpListenerMgr, listening
-at the given address and port, has begun to shutdown.
/// @brief Id to use for the next connection.
size_t next_connection_id_;
- /// @brief Callback connection invokes in requestReceived to construct a respsonse.
+ /// @brief Callback connection invokes in requestReceived to construct a response.
TcpTestConnection::ResponseHandler response_handler_;
public:
///
/// Note to developers: it may make more sense to introduce an abstract base
/// class for the \c OutputBuffer and define the simple implementation as a
-/// a concrete derived class. That way we can provide flexibility for future
+/// concrete derived class. That way we can provide flexibility for future
/// extension such as more efficient buffer implementation or allowing users
/// to have their own customized version without modifying the source code.
/// We in fact considered that option, but at the moment chose the simpler
/// in the sysrepo datastore by calling Session::getData(). It should be
/// used sparingly in production code. It is primarily meant for unit tests.
///
- /// @param xpath the xpath to be travelled
- /// @param f the function to be called on the node itself and each
- /// descendant
+ /// @param xpath the xpath of the root node belonging to the the tree being traversed
+ /// @param f the function to be called on the node itself and each descendant
template <typename functor_t>
void forAll(std::string const& xpath, functor_t f) const {
std::optional<libyang::DataNode> const& data_node(session_.getData(xpath));
projects / thirdparty / kea.git / commitdiff
