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/README | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) create mode 100644 src/lib/asiolink/README (limited to 'src/lib/asiolink/README') diff --git a/src/lib/asiolink/README b/src/lib/asiolink/README new file mode 100644 index 0000000..83f66b8 --- /dev/null +++ b/src/lib/asiolink/README @@ -0,0 +1,28 @@ +The asiolink library is intended to provide an abstraction layer between +Kea modules and the socket I/O subsystem we are using (currently, the +headers-only version of ASIO included in Boost). This has several benefits, +including: + + - Simple interface + + - Back-end flexibility: It would be relatively easy to switch to any + other asynchronous I/O system. + + - Cleaner compilation: The ASIO headers include code which can + generate warnings in some compilers due to unused parameters and + such. Including ASIO header files throughout the Kea tree would + require us to relax the strictness of our error checking. Including + them in only one place allows us to relax strictness here, while + leaving it in place elsewhere. + +Some of the classes defined here--for example, IOSocket, IOEndpoint, +and IOAddress--are to be used by Kea modules as wrappers around +ASIO-specific classes. + + +Logging +------- + +At this point, nothing is logged by this low-level library. We may +revisit that in the future, if we find suitable messages to log, but +right now there are also no loggers initialized or called. -- cgit v1.2.3