From f5f56e1a1c4d9e9496fcb9d81131066a964ccd23 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sat, 13 Apr 2024 14:15:43 +0200 Subject: Adding upstream version 2.4.1. Signed-off-by: Daniel Baumann --- src/lib/asiolink/dummy_io_cb.h | 65 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 65 insertions(+) create mode 100644 src/lib/asiolink/dummy_io_cb.h (limited to 'src/lib/asiolink/dummy_io_cb.h') diff --git a/src/lib/asiolink/dummy_io_cb.h b/src/lib/asiolink/dummy_io_cb.h new file mode 100644 index 0000000..795fad9 --- /dev/null +++ b/src/lib/asiolink/dummy_io_cb.h @@ -0,0 +1,65 @@ +// Copyright (C) 2011-2015 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 +// file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef DUMMY_IO_CB_H +#define DUMMY_IO_CB_H + +#include + +#include + +#include + +namespace isc { +namespace asiolink { + +/// \brief Asynchronous I/O Completion Callback +/// +/// The two socket classes (UDPSocket and TCPSocket) require that the I/O +/// completion callback function have an operator() method with the appropriate +/// signature. The classes are templates, any class with that method and +/// signature can be passed as the callback object - there is no need for a +/// base class defining the interface. However, some users of the socket +/// classes do not use the asynchronous I/O operations, yet have to supply a +/// template parameter. This is the reason for this class - it is the dummy +/// template parameter. + +class DummyIOCallback { +public: + + /// \brief Asynchronous I/O callback method + /// + /// Should never be called, as this class is a convenience class provided + /// for instances where a socket is required but it is known that no + /// asynchronous operations will be carried out. + void operator()(boost::system::error_code) { + // If the function is called, there is a serious logic error in + // the program (this class should not be used as the callback + // class). As the asiolink module is too low-level for logging + // errors, throw an exception. + isc_throw(isc::Unexpected, + "DummyIOCallback::operator() must not be called"); + } + + /// \brief Asynchronous I/O callback method + /// + /// Should never be called, as this class is a convenience class provided + /// for instances where a socket is required but it is known that no + /// asynchronous operations will be carried out. + void operator()(boost::system::error_code, size_t) { + // If the function is called, there is a serious logic error in + // the program (this class should not be used as the callback + // class). As the asiolink module is too low-level for logging + // errors, throw an exception. + isc_throw(isc::Unexpected, + "DummyIOCallback::operator() must not be called"); + } +}; + +} // namespace asiolink +} // namespace isc + +#endif // DUMMY_IO_CB_H -- cgit v1.2.3