• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1[/
2 / Copyright (c) 2003-2020 Christopher M. Kohlhoff (chris at kohlhoff dot com)
3 /
4 / Distributed under the Boost Software License, Version 1.0. (See accompanying
5 / file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
6 /]
7
8[section:history Revision History]
9
10[heading Asio 1.18.0 / Boost 1.74]
11
12* Added an implementation of the proposed standard executors
13	([@http://wg21.link/P0443r13 P0443r13], [@http://wg21.link/P1348r0 P1348r0],
14  and [@http://wg21.link/P1393r0 P1393r0]).
15* Added support for the proposed standard executors to Asio's I/O facilities:
16  * The `io_context::executor_type`, `thread_pool::executor_type`,
17    `system_executor`, and `strand` executors now meet the requirements for the
18    proposed standard executors. These classes also continue to meet the
19    existing requirements for the Networking TS model of executors.
20  * All I/O objects, asynchronous operations, and utilities including
21    `dispatch`, `post`, `defer`, `get_associated_executor`, `bind_executor`,
22    `make_work_guard`, `spawn`, `co_spawn`, `async_compose`, `use_future`,
23    etc., can interoperate with both new proposed standard executors, and with
24    existing Networking TS executors. The implementation determines at compile
25    time which model a particular executor meets; the proposed standard
26    executor model is used in preference if both are detected.
27  * The `any_io_executor` type alias has been introduced as the new default
28    runtime-polymorphic executor for all I/O objects. This type alias points to
29    the `execution::any_executor<>` template with a set of supportable
30    properties specified for use with I/O. This change may break existing code
31    that directly uses the old polymorphic wrapper, `executor`. If required for
32    backward compatibility, `BOOST_ASIO_USE_TS_EXECUTOR_AS_DEFAULT` can be
33    defined, which changes the `any_io_executor` type alias to instead point to
34    the `executor` polymorphic wrapper.
35  * Support for the existing Networking TS model of executors can be disabled
36    by defining `BOOST_ASIO_NO_TS_EXECUTORS`.
37* Added converting move construction and assignment to `basic_waitable_timer`.
38  This enables move construction and assignment between different timer
39  types, provided the executor types are convertible. For example:[br]
40  ``
41  basic_waitable_timer<
42      clock_type,
43      traits_type,
44      io_context::executor_type
45    > timer1(my_io_context);
46
47  basic_waitable_timer<
48      clock_type,
49      traits_type,
50      any_io_executor // polymorphic wrapper
51    > timer2(std::move(timer1));
52  ``[br]
53* Enabled C++20 coroutine support when using [^gcc] 10.
54* Added overloads of `co_spawn` that launch an awaitable. This change allows us
55  to write:[br]
56  ``
57  co_spawn(executor,
58      echo(std::move(socket)),
59      detached);
60  ``[br]
61  instead of:[br]
62  ``
63  co_spawn(executor,
64      [socket = std::move(socket)]() mutable
65      {
66        return echo(std::move(socket));
67      },
68      detached);
69  ``[br]
70* Added a new constructor overload to `use_awaitable_t`'s default executor
71  adapter, to enable conversion between executor types.
72* Added support for using `detached_t` as a default completion token, by
73  adding members `as_default_on()` and `as_default_on_t<>`.
74* Added a move constructor to `ssl::stream<>`.
75* Changed `ssl::stream<>` write operations to linearise gather-write buffer
76  sequences.
77* Added compile-time detection of the deprecated `asio_handler_invoke` hook.
78  This hook was deprecated with the introduction of the Networking TS trait
79  `associated_executor` and function `get_associated_executor()`. Compiling
80  an application with `BOOST_ASIO_NO_DEPRECATED` will now trigger a compile
81  error if any handler implements the `asio_handler_invoke` hook.
82* Added compile-time detection of the deprecated `asio_handler_allocate`
83  and `asio_handle_deallocate` hooks. These hooks were deprecated with the
84  introduction of the Networking TS trait `associated_allocator` and function
85  `get_associated_allocator()`. Compiling an application with
86  `BOOST_ASIO_NO_DEPRECATED` will now trigger a compile error if any handler
87  implements the `asio_handler_allocate` or `asio_handler_deallocate` hooks.
88* Implemented a number of performance optimisations, including:
89  * Specialising single-buffer operations to use `recv` rather than `recvmsg`,
90    `send` rather than `sendmsg`, `read` rather than `readv`, and `write`
91    rather than `writev`.
92  * Lightening the reference counting overhead of the polymorphic wrapper
93    `executor`.
94  * Returning from system call operation wrappers as early as possible, and
95    only accessing `errno` and error codes when on an error path.
96  * Applying additional optimisations if a "native" I/O executor (such as
97    `io_context::exeutor_type`) is detected.
98* Added source location support to handler tracking. The new
99  `BOOST_ASIO_HANDLER_LOCATION((file_name, line, function_name))` macro may be used
100  to inform the handler tracking mechanism of a source location. This macro
101  declares an object that is placed on the stack. Then, when an asynchronous
102  operation is launched with location information, it outputs lines using the
103  [*<action>] [^n^m], prior to the [^n*m] line that signifies the beginning
104  of the asynchronous operation. For example:
105  ``
106  @asio|1589423304.861944|>7|ec=system:0,bytes_transferred=5
107  @asio|1589423304.861952|7^8|in 'async_write' (./../../../include/asio/impl/write.hpp:330)
108  @asio|1589423304.861952|7^8|called from 'do_write' (handler_tracking/async_tcp_echo_server.cpp:62)
109  @asio|1589423304.861952|7^8|called from 'operator()' (handler_tracking/async_tcp_echo_server.cpp:51)
110  @asio|1589423304.861952|7*8|socket@0x7ff61c008230.async_send
111  @asio|1589423304.861975|.8|non_blocking_send,ec=system:0,bytes_transferred=5
112  @asio|1589423304.861980|<7|
113  ``[br]
114  If `std::source_location` or `std::experimental::source_location` are
115  available, the `use_awaitable_t` token (when default-constructed or used as a
116  default completion token) will also cause handler tracking to output a source
117  location for each newly created asynchronous operation. A `use_awaitable_t`
118  object may also be explicitly constructed with location information.
119* Implemented various improvements to the [^handlerviz.pl] tool.
120  * Add nodes for pending handlers at bottom of graph, outlined in red.
121  * Display source location in a tooltip on the edge label (for SVG).
122  * Use invisible nodes to enforce order to keep related control flow vertical.
123* Added the [^handlerlive.pl] tool, which processes handler tracking output to
124  produce a list of "live" handlers. Live handlers are those that are
125  associated with pending asynchronous operations, as well as handlers that are
126  currently executing. For example:
127  ``
128  cat output.txt | perl handlerlive.pl
129  ``
130  or:
131  ``
132  perl handerlive.pl < output.txt
133  ``
134  or:
135  ``
136  perl handlerlive.pl output.txt
137  ``[br]
138* Added the [^handlertree.pl] tool, which filters handler tracking output to
139  include only those events in the tree that produced the nominated handlers.
140  For example, to filter the output to include only the events associated with
141  handlers `123`, `456`, and their predecessors:
142  ``
143  cat output.txt | perl handlertree.pl 123 456
144  ``
145  or:
146  ``
147  perl handlertree.pl 123 456 < output.txt
148  ``[br]
149  This script may be combined with handerlive.pl and handlerviz.pl to produce a
150  graph of the "live" asynchronous operation chains. For example:
151  ``
152  cat output.txt | \
153    perl handlertree.pl `perl handlerlive.pl output.txt` | \
154    perl handlerviz.pl | \
155    dot -Tsvg > output.svg
156  ``[br]
157* Added changes for clang-based Embarcadero C++ compilers.
158* Fixed a deadlock that can occur when multiple threads concurrently initialise
159  the Windows I/O completion port backend.
160* Fixed `async_compose` to work with copyable handlers when passed by lvalue.
161* Fixed completion signature deduction in `co_spawn`.
162* Removed a spurious `Executor` base class from the `executor_binder`
163  implementation.
164* Various fixes and improvements in the documentation and examples.
165
166[heading Asio 1.16.1 / Boost 1.73]
167
168* Fixed compatibility with C++20 concept syntax.
169* Marked the POSIX descriptor classes' move constructors as `noexcept`.
170* Added the `ssl::host_name_verification` class, which is a drop-in replacement
171  for `ssl::rfc2818_verification`. The `ssl::rfc2818_verification` class has
172  been marked as deprecated. As a consequence of this change, SSL support now
173  depends on functions that were introduced in OpenSSL 1.0.2.
174* Added an `ssl::context` constructor to take ownership of a native handle.
175* Changed C++ language version detection with [^gcc] to use `__cplusplus` macro.
176* Fixed a work counting issue in the asynchronous resolve operation for
177  endpoints.
178* Fixed the `strand<>` converting constructors and assignment operators.
179* Ensured that resolvers are restarted correctly after a fork.
180* Fixed compatibility with the current NetBSD release.
181* Removed spurious handler requirement checks in some `async_read` overloads.
182* Changed the `ssl::context` class to propagate non-EOF errors from the
183  `add_certificate_authority` function.
184* Fixed a Windows-specific `thread_pool` destructor hang that occurred when the
185  pool had an associated I/O object.
186* Changed the [^select] reactor to recreate the "self pipe trick" sockets on
187  error. This addresses an issue on some versions of Windows, where these
188  sockets are discconected after a system sleep.
189* Fixed a compile error in the buffered streams due to the lack of reference
190  collapsing in C++98.
191* Changed the `priority_scheduler` example to demonstrate calls to `shutdown()`
192  and `destroy()`.
193* Removed some unnecessary null pointer checks.
194* Changed Windows platform detection to recognise TV titles as Windows apps.
195* Added some emscripten compatibility patches.
196* Fixed a compile error in the `use_awaitable_t::as_default_on` function.
197* Changed all uses of the boost.bind placeholders to use the
198  `boost::placeholders` namespace.
199* Fixed a potential compile error in the `async_compose` implementation due to
200  incorrect overload selection.
201* Suppressed some non-virtual destructor warnings.
202* Various documentation fixes and improvements.
203
204[heading Asio 1.16.0 / Boost 1.72]
205
206* Changed the `async_initiate` helper function to automatically deduce its
207  return type. This is enabled for C++11 or later.
208* Changed all asynchronous operations to use automatically deduced return
209  types. This allows completion token implementations to incorporate the
210  asynchronous operation initiation into the initiating function's return type,
211  without type erasure. Note that C++14 or later is required to support
212  completion tokens that use per-operation return type deduction. For C++11 or
213  earlier, a completion token's async_result specialisation must still provide
214  the nested typedef `return_type`.
215* Introduced three new concepts to support `async_initiate`.
216  * `completion_signature<T>`: Checks if `T` is a signature of the form
217    `R(Args...)`.
218  * `completion_handler_for<T, Signature>`: Checks if `T` is usable as a
219    completion handler with the specified signature.
220  * `completion_token_for<T, Signature>`: Checks if `T` is a completion token
221    that can be used with async_initiate and the specified signature.
222  * For backward compatibility with pre-concepts C++, the macros
223    `BOOST_ASIO_COMPLETION_SIGNATURE`, `BOOST_ASIO_COMPLETION_HANDLER_FOR`, and
224    `BOOST_ASIO_COMPLETION_TOKEN_FOR` are provided. These macros expand to
225    `typename` when concepts are unsupported.
226* Added the nested template type `rebind_executor` to all I/O object types, as
227  a way to generically rebind them to use alternative I/O executors. For
228  example:
229  ``
230  using my_socket_type = tcp::socket::rebind_executor<my_executor_type>::other;
231  ``[br]
232* Changed the asynchronous operations' initiation function objects to report
233  their associated I/O executor via the nested type `executor_type` and member
234  function `get_executor()`. Note that the presence of `executor_type` and
235  `get_executor()` should be treated as optional, and consequently it may be
236  preferable to access them via the `associated_executor` trait and the
237  `get_associated_executor()` helper function.
238* Added the `default_completion_token` trait, so that every I/O executor type
239  now has an associated default completion token type. This trait may be used
240  in asynchronous operation declarations as follows:
241  ``
242  template <
243      typename IoObject,
244      typename CompletionToken =
245        typename default_completion_token<
246          typename IoObject::executor_type
247        >::type
248    >
249  auto async_fyz(
250      IoObject& io_object,
251      CompletionToken&& token =
252        typename default_completion_token<
253          typename IoObject::executor_type
254        >::type{}
255    );
256  ``[br]
257  If not specialised, this trait type is `void`, meaning no default completion
258  token type is available for the given I/O executor.
259* Specialised the `default_completion_token` trait for the `use_awaitable`
260  completion token, so that it may be used as shown in the following example:
261  ``
262  auto socket = use_awaitable.as_default_on(tcp::socket(my_context));
263  // ...
264  co_await socket.async_connect(my_endpoint); // Defaults to use_awaitable.
265  ``[br]
266  In this example, the type of the `socket` object is transformed from
267  `tcp::socket` to have an I/O executor with the default completion token set
268  to `use_awaitable`. Alternatively, the socket type may be computed directly:
269  ``
270  using tcp_socket = use_awaitable_t<>::as_default_on_t<tcp::socket>;
271  tcp_socket socket(my_context);
272  // ...
273  co_await socket.async_connect(my_endpoint); // Defaults to use_awaitable.
274  ``[br]
275* Added missing `async_initiate` to the Windows-specific I/O objects'
276  asynchronous operations.
277* Ensured that the executor type is propagated to newly accepted sockets.
278  When synchronously or asynchronously accepting a new connection, but
279  without specifying an executor or execution context, the accept
280  operation will now correctly propagate the executor type from the
281  acceptor to the socket. For example, if your acceptor type is:
282  ``
283  basic_socket_acceptor<ip::tcp, my_executor_type>
284  ``[br]
285  then your accepted socket type will be:
286  ``
287  basic_stream_socket<ip::tcp, my_executor_type>
288  ``[br]
289* Changed to require that `Protocol` copy and move operations never throw.
290* Changed to require that `Endpoint` default constructor and move operations
291  never throw.
292* Added the `noexcept` qualifier to protocol accessors.
293* Added the `noexcept` qualifier to socket move constructors.
294* Fixed issues associated with opening serial ports on Windows:
295  * Use the correct constant to initialise the RTS control flag.
296  * Specify a default baud rate (9600).
297* Fixed a lost "outstanding work count" that can occur when an asynchronous
298  accept operation is automatically restarted.
299
300[heading Asio 1.14.1 / Boost 1.71]
301
302* Improved performance slightly by eliminating a redundant move construction
303  when completed handlers are dispatched.
304* Eliminated a compiler warning by annotating a `case` fall-through in
305  the free function `connect()` implementation.
306* Fixed the `is_*_buffer_sequence` detection traits for user-defined sequence
307  types.
308* Fixed some Windows-specific warnings about an incompatible pointer cast when
309  obtaining the `CancelIoEx` entry point.
310* Changed to automatically set the defaults when opening a serial port on
311  Windows.
312* Changed the serial port `get_option()` member function to be const.
313* Fixed a name hiding issue with the WinRT stream-oriented socket backend's
314  `shutdown` function.
315* Applied a minor fix to the documentation for `is_dynamic_buffer`.
316* Added some support for Haiku OS.
317* Added wolfSSL compatability.
318* Changed to require C++17 or later for coroutines TS support with clang.
319* Fixed a doxygen generation problem in the tutorial.
320* Ensured example programs are correctly incorporated into the documentation.
321
322[heading Asio 1.14.0 / Boost 1.70]
323
324* Added custom I/O executor support to I/O objects.
325  * All I/O objects now have an additional `Executor` template parameter. This
326    template parameter defaults to the `asio::executor` type (the polymorphic
327    executor wrapper) but can be used to specify a user-defined executor
328    type.
329  * I/O objects' constructors and functions that previously took an
330    `asio::io_context&` now accept either an `Executor` or a reference to a
331    concrete `ExecutionContext` (such as `asio::io_context` or
332    `asio::thread_pool`).
333  * Note: One potential source of breakage in existing user code is when reusing an
334    I/O object's `io_context` for constructing another I/O object, as in:
335    ``
336    asio::steady_timer my_timer(my_socket.get_executor().context());
337    ``[br]
338    To fix this, either construct the second I/O object using the first I/O
339    object's executor:[br]
340    ``
341    asio::steady_timer my_timer(my_socket.get_executor());
342    ``[br]
343    or otherwise explicitly pass the `io_context`:[br]
344    ``
345    asio::steady_timer my_timer(my_io_context);
346    ``[br]
347  * The previously deprecated `get_io_context` and `get_io_service`
348    member functions have now been removed.
349  * The previously deprecated service template parameters, and the
350    corresponding classes, have now been removed.
351* Added a new `async_result` form with an `initiate` static member function.
352  * The `async_result` template now supports a new form:
353    ``
354    template <typename CompletionToken, typename Signature>
355    struct async_result
356    {
357      typedef /* ... */ return_type;
358
359      template <typename Initiation,
360          typename RawCompletionToken,
361          typename... Args>
362      static return_type initiate(
363          Initiation&& initiation,
364          RawCompletionToken&& token,
365          Args&&... args);
366    };
367    ``[br]
368  * The `initiate` member function must: (a) transform the token into a
369    completion handler object `handler`; (b) cause the invocation of the
370    function object `initiation` as if by calling
371    `std::forward<Initiation>(initiation)(std::move(handler),
372    std::forward<Args>(args)...)`. Note that the invocation of `initiation`
373    may be deferred (e.g. lazily evaluated), in which case `initiation` and
374    `args` must be decay-copied and moved as required.
375  * A helper function template `async_initiate` has also been added as a
376    wrapper for the invocation of `async_result<>::initiate`. For backward
377    compatibility, this function supports both the old and new `async_result`
378    forms.
379  * The composed operations examples have been updated to use `async_initiate`.
380  * The previously deprecated `handler_type` trait and single-argument form of
381    `async_result` have now been removed.
382* Updated the Coroutines TS support and promoted it to the `asio` namespace.
383  * The `awaitable<>`, `co_spawn`, `this_coro`, `detached`, and
384    `redirect_error` facilities have been moved from the `asio::experimental`
385    namespace to namespace `asio`. As part of this change, the
386    `this_coro::token()` awaitable has been superseded by the
387    `asio::use_awaitable` completion token.
388  * Please note that the `use_awaitable` and `redirect_error` completion tokens
389    work only with asynchronous operations that use the new form of
390    `async_result` with member function `initiate`. Furthermore, when using
391    `use_awaitable`, please be aware that the asynchronous operation is not
392    initiated until `co_await` is applied to the `awaitable<>`.
393* Added a new `DynamicBuffer_v2` concept which is CopyConstructible.
394  * This change adds a new set of type requirements for dynamic buffers,
395    `DynamicBuffer_v2`, which supports copy construction. These new type
396    requirements enable dynamic buffers to be used as arguments to
397    user-defined composed operations, where the same dynamic buffer object
398    is used repeatedly for multiple underlying operations. For example:[br]
399    ``
400      template <typename DynamicBuffer>
401      void echo_line(tcp::socket& sock, DynamicBuffer buf)
402      {
403        n = asio::read_until(sock, buf, '\n');
404        asio::write(sock, buf, asio::transfer_exactly(n));
405      }
406    ``[br]
407  * The original `DynamicBuffer` type requirements have been renamed to
408    `DynamicBuffer_v1`. These requirements continue to be compatible with the
409    Networking TS.
410  * New type traits `is_dynamic_buffer_v1` and `is_dynamic_buffer_v2` have been
411    added to test for conformance to `DynamicBuffer_v1` and `DynamicBuffer_v2`
412    respectively. The existing `is_dynamic_buffer` trait has been retained and
413    delegates to `is_dynamic_buffer_v1` (unless `BOOST_ASIO_NO_DYNAMIC_BUFFER_V1` is
414    explicitly defined, in which case it delegates to `is_dynamic_buffer_v2`).
415  * For convenience, the `dynamic_string_buffer` and `dynamic_vector_buffer`
416    classes conform to both `DynamicBuffer_v1` and `DynamicBuffer_v2`
417    requirements.
418  * When `BOOST_ASIO_NO_DYNAMIC_BUFFER_V1` is defined, all support for
419    `DynamicBuffer_v1` types and functions is #ifdef-ed out. Support for using
420    `basic_streambuf` with the `read`, `async_read`, `read_until`,
421    `async_read_until`, `write`, and `async_write` functions is also disabled
422    as a consequence.
423  * Note: This change should have no impact on existing source code that simply
424    uses dynamic buffers in conjunction with Asio's composed operations.
425* Added a new `async_compose` function that simplifies the implementation of
426  user-defined asynchronous operations.
427* Added a `make_strand` function, which creates a `strand` with a deduced
428  `Executor` template argument.
429* Relaxed the completion condition type requirements to only require
430  move-constructibility rather than copy-constructibility.
431* Added a constructor for `local::basic_endpoint` that takes a `string_view`.
432* Added the noexcept qualifier to various member functions of the
433  `ip::address`, `ip::address_v4`, `ip::address_v6`, `ip::basic_endpoint`, and
434  `executor_work_guard` classes.
435* Added the noexcept qualifier to the `buffer_sequence_begin` and
436  `buffer_sequence_end` functions.
437* Added a new `BOOST_ASIO_DISABLE_VISIBILITY` configuration `#define` that allows
438  visibility pragmas to be disabled. (Note: If symbols are hidden, extra care
439  must be taken to ensure that Asio types are not passed across shared
440  library API boundaries.)
441* Enabled recycling of the memory used to type-erase a function object with the
442  polymorphic executor.
443* Changed receive operations to return the correct number of bytes transferred
444  when truncation (`error::message_size`) occurs on a datagram-oriented socket.
445* Fixed multicast behaviour on QNX by automatically applying `SO_REUSEPORT`
446  when the `reuse_address` option is set.
447* Added inclusion of `unistd.h` when targeting Haiku OS, to fix feature detection.
448* Added the `network_v[46].hpp` headers to the top-level convenience header.
449* Fixed calculation of absolute timeout when the backend uses
450  `pthread_cond_timedwait`.
451* Changed the range-based asynchronous connect operation to deduce the
452  `EndpointSequence` iterator type rather than assume the presence of a
453  `const_iterator` typedef.
454* Fixed `buffer_sequence_begin` and `buffer_sequence_end` to prevent implicit
455  conversion. This change addresses an issue where a call to
456  `buffer_sequence_begin` or `buffer_sequence_end` could trigger an implicit
457  conversion to `const_buffer` or `mutable_buffer`. Whenever this implicit
458  conversion occurred, the return value of `buffer_sequence_begin` or
459  `buffer_sequence_end` would point to a temporary object.
460* Ensured SSL handshake errors are propagated to the peer before the local
461  operation completes.
462* Suppressed the `eof` error on SSL shutdown as it actually indicates success.
463* Added a fallback error code for when we OpenSSL produces an
464  `SSL_ERROR_SYSCALL` result without an associated error.
465* Changed composed asynchronous read and write operations to move, rather than
466  copy, the buffer sequence objects when the composed operation implementation
467  is moved.
468* Changed to use `<atomic>` when targeting apple/clang/libc++ with recent Xcode
469  versions, even for C++03. This fixes a warning about the deprecation of
470  `OSMemoryBarrier`.
471* Fixed compile errors that occur when using the composed read and write
472  operations with MSVC 11.0, by disabling `decltype` support for that compiler.
473* Increased the default value of `_WIN32_WINNT` to `0x0601` (Windows 7).
474* Fixed `dispatch` documentation to note that it may call the supplied function
475  object in the current thread.
476* Updated `post` and `defer` documentation to clarify the the distinction
477  between them.
478* Fixed compilation errors in the read and write composed operations when used
479  with MSVC 11.0.
480* Fixed a Windows-specific issue where the execution context associated with
481  `system_executor` was not being correctly cleaned up on exit.
482
483[heading Asio 1.12.2 / Boost 1.69]
484
485* Fixed a problem with the detection of `std::future` availability with
486  libstdc++.
487* Fixed compile error in regex overload of `read_until`.
488* Fixed a timer heap corruption issue that can occur when moving a cancelled
489  timer.
490* Fixed detection of `std::experimental::string_view` and `std::string_view`
491  with newer clang/libc++.
492* Fixed MSVC version detection for availability of `std::invoke_result`.
493* Fixed the buffer sequence traits to test the new requirements, if `decltype`
494  is available.
495* Fixed an MSVC issue when building with exceptions disabled.
496* Added SSL context options for TLS v1.3.
497* Added a compile-time test for TLS v1 support.
498* Fixed the macro used to test for TLS v1.2 support.
499* Prevented global objects from being created once per thread on Windows.
500* Fixed a crash when using `size()`, `max_size()` or `empty()` on
501  default-constructed resolver results.
502* Changed to move the return value in basic_resolver_results::begin() to avoid
503  copying.
504* Enabled move support for the Intel Compiler.
505* Fixed `std::string_view` detection issue when using clang-cl.
506* Fixed the handler tracking operation name for
507  `io_context::executor_type::dispatch`.
508* Fixed a buffer overflow that could occur when parsing an address string with
509  a 64-bit scope id.
510* Added examples showing how to write composed operations.
511* Added C++11 versions of the Timeouts, Timers, SOCKS4 and SSL examples.
512* Fixed minor issues in documentation and examples.
513
514[heading Asio 1.12.1 / Boost 1.67]
515
516* Added missing const qualifier to `basic_socket_acceptor::get_option`.
517* Worked around a parsing error that occurs with some versions of gcc.
518* Fixed broken code samples in tutorial.
519* Added new experimental features. (Note that "experimental" features may be
520  changed without notice in subsequent releases.)
521  * Added `experimental::detached` completion token.
522  * Added `experimental::redirect_error` completion token.
523  * Added `experimental::co_spawn` facility for integration with the coroutines
524    technical specification.
525* Updated timeout examples to use latest features.
526  * Used `asio::steady_timer` rather than `asio::deadline_timer`.
527  * Used `asio::dynamic_buffer` rather than `asio::streambuf`.
528  * Used timed `asio::io_context::run_for()` function for blocking clients.
529  * Added example showing a custom completion token for blocking with timeouts.
530* Fixed unit tests to compile when `BOOST_ASIO_NO_DEPRECATED` is defined.
531* Changed socket iostreams to use chrono by default, to fix compatibility with
532	the Networking TS. Define `BOOST_ASIO_USE_BOOST_DATE_TIME_FOR_SOCKET_IOSTREAM`
533	to enable the old Boost.Date_Time interface in `basic_socket_streambuf` and
534	`basic_socket_iostream`.
535* Updated examples to use chrono rather than Boost.Date_Time.
536* Fixed an incorrect member function detector in the `is_dynamic_buffer` trait.
537* Fixed an `async_result` incompatibility with deprecated `handler_type`.
538* Added a missing move optimisation in the SSL stream implementation.
539* Fixed incorrect `basic_resolver_results::value_type` typedef.
540* Fixed a compile error with some OpenSSL versions when `SSL_OP_NO_COMPRESSION`
541  is defined.
542* Changed `add_certificate_authority` to process multiple certificates in a bundle.
543* Eliminated deprecation warning with MSVC by using `std::invoke_result` rather
544  than `std::result_of`.
545* Changed to use `std::string_view` for C++17 or later, and
546	`std::experimental::string_view` for C++14. Define the preprocessor macro
547	`BOOST_ASIO_DISABLE_STD_STRING_VIEW` to force the use of
548	std::experimental::string_view (assuming it is available) when compiling in
549	C++17 mode.
550* Ensured `DynamicBuffer` template arguments are decayed before using in
551  `enable_if` tests.
552* Changed documentation to distinguish legacy completion handlers (which are
553  still required to be CopyConstructible) from new MoveConstructible handlers.
554* Suppressed a discarded return value warning in the buffer debugging support.
555* Fixed `basic_yield_context` to work with completion signatures containing
556  reference parameters.
557* Ensured that stackful coroutines launched using `spawn()` correctly store
558  decayed copies of their function and handler arguments.
559* Fixed some compatibility issues with Android.
560* Added cross-compilation support to Jamfiles.
561* Fixed some minor portability issues in examples.
562
563[heading Asio 1.12.0 / Boost 1.66]
564
565* Implemented interface changes to reflect the Networking TS
566	([@www.open-std.org/jtc1/sc22/wg21/docs/papers/2017/n4656.pdf N4656]).
567	* See the [link boost_asio.net_ts list] of new interfaces and, where
568    applicable, the corresponding old interfaces that have been superseded.
569	* The service template parameters, and the corresponding classes, are disabled
570		by default. For example, instead of `basic_socket<Protocol, SocketService>` we
571		now have simply `basic_socket<Protocol>`. The old interface can be enabled by
572		defining the `BOOST_ASIO_ENABLE_OLD_SERVICES` macro.
573* Removed previously deprecated functions.
574* Added support for customised handler tracking.
575* Added reactor-related (i.e. descriptor readiness) events to handler tracking.
576* Added special [link boost_asio.overview.core.concurrency_hint concurrency
577  hint] values that may be used to disable locking on a per `io_context` basis.
578* Enabled perfect forwarding for the first `ssl::stream<>` constructor argument.
579* Added ability to release ownership of the underlying native socket. (Requires
580	Windows 8.1 or later when using the I/O completion port backend.)
581
582[heading Asio 1.10.10 / Boost 1.65]
583
584* Changed to require [^g++] versions >= 4.7 to use standard atomics, to fix
585  a linker error when using [^g++] 4.6 ([ticket 13121]).
586* Enabled use of `constexpr` and variadic templates with recent MSVC versions.
587* Fixed a race condition in the Linux epoll backend, which may occur when a
588  socket or descriptor is closed while another thread is blocked on epoll.
589* Eliminated use of deprecated `auto_ptr`.
590* Fixed misplaced use of `asio_handler_is_continuation` result in reactive
591  `async_accept` implementation.
592* Changed to use `poll.h` rather than `sys/poll.h` on some modern POSIX
593  platforms ([ticket 12419]).
594* Fixed MSVC intellisense detection.
595* Disabled use of the `__thread` keyword extension for android/clang/x86
596  targets.
597
598[heading Asio 1.10.9 / Boost 1.64]
599
600* Added limited support for using regular file descriptors (where I/O
601  operations should never fail with `EAGAIN` or `EWOULDBLOCK`) with
602  `posix::stream_descriptor`, when using the Linux epoll backend.
603* Changed to use `allocator_traits` to rebind allocators in C++11 or later.
604* Eliminated a double "construction" issue in the converting move constructors.
605* Added new `ssl::context_base` enumerations to enable support for any TLS
606  version, and improved consistency of SSL/TLS version handling across OpenSSL
607  releases.
608* Applied more changes to address OpenSSL 1.1 compatibility.
609* Fixed a compile error when OpenSSL compression is disabled at compile time.
610* Suppressed some spurious unused variable warnings issued by [^gcc] ([ticket
611  12302]).
612* Worked around a new clang warning issued for usage of the comma operator.
613* Fixed various header ordering problems.
614* Changed to refer `std::atomic_thread_fence`, when available, to eliminate a
615  deprecated function warning on newest macOS SDK ([ticket 12482]).
616* Added a workaround for broken `getaddrinfo` in Apple's NAT64 environment.
617* Fixed an exception safety issue in the internal hash map implementation.
618
619[heading Asio 1.10.8 / Boost 1.62]
620
621* Added compatibility with OpenSSL 1.1.0 ([ticket 12238]).
622* Fixed out-of-bounds iterator use in `asio::connect()` when the
623  `connect_condition` returns an end iterator ([ticket 12354]).
624* Added a workaround for a move detection problem on MSVC 2015 Update 2
625  ([ticket 12115]).
626* Changed a workaround that was previously added for broken Windows firewalls
627  to only bind to 127.0.0.1 if `getsockname` reports 0.0.0.0 ([ticket
628  12406]).
629* Added call to `SSL_COMP_free_compression_methods` to fix two memory leaks
630  reported at shutdown, for OpenSSL versions >= 1.0.2 and < 1.1.0 ([ticket
631  10795]).
632* Fixed `use_future` compile error encountered on some standard library
633  implementations, by changing `std::allocator<void>` use to a non-void
634  template parameter.
635* Enabled use of native `getaddrinfo` by default on Apple OSes, rather than
636  emulation in terms of `getipnodebyname`.
637
638[heading Asio 1.10.7 / Boost 1.60]
639
640* Added support for Windows 8.1 Store apps.
641* Fixed macro multiple definition error on Microsoft Visual Studio 2015
642  ([ticket 11539]).
643* Changed Asio's SSL wrapper to respect OpenSSL's `OPENSSL_NO_SSL3` feature
644  test `#define` ([ticket 11754]).
645* Changed Asio's SSL wrapper to use OpenSSL's new `SSL_CTX_clear_chain_certs`
646  function, if available.
647* Suppressed a clang 3.6+ warning about unused typedefs ([ticket 11767]).
648* Regenerated certificates used by SSL examples.
649* Fixed buffer sizes passed to `strncat` in the `getaddrinfo` emulation and in
650  the SSL wrapper's password handling.
651* Changed Windows backend to use non-macro `CreateEventW` rather than
652  `CreateEvent` ([ticket 11732]).
653
654[heading Asio 1.10.6 / Boost 1.58]
655
656* Ensured errors generated by Windows' `ConnectEx` function are mapped to their
657  portable equivalents ([ticket 10744]).
658* Added new macro `BOOST_ASIO_DISABLE_CONNECTEX` to allow use of `ConnectEx` to
659  be explicitly disabled.
660* Fixed a race condition in `windows::object_handle` when there are pending
661  wait operations on destruction ([ticket 10624]).
662* Fixed IPv6 address parsing on FreeBSD, where a trailing scope ID would cause
663  conversion to fail with `EINVAL`.
664* Worked around shared library visibility issues by ensuring Asio types use
665  default visibility ([ticket 9465], [ticket 11070]).
666* Changed the SSL wrapper to call the password callback when loading an
667  in-memory key ([ticket 10828]).
668* Fixed false SSL error reports by ensuring that the SSL error queue is cleared
669  prior to each operation.
670* Fixed an `ssl::stream<>` bug that may result in spurious 'short read' errors.
671* Removed a redundant null pointer check in the SSL engine ([ticket 10088]).
672* Added options for disabling TLS v1.1 and v1.2 ([ticket 10690]).
673* Removed use of deprecated OpenSSL function `ERR_remove_state`.
674* Fixed detection of various C++11 features with Clang ([ticket 8835],
675  [ticket 10884]).
676* Fixed detection of C++11 `std::addressof` with [^g++] ([ticket 10982]).
677* Changed multicast test to treat certain `join_group` failures as non-fatal.
678* Decoupled Asio unit tests from Boost.Test ([ticket 11116]).
679* Changed the tutorial to use `std::endl` to ensure output is flushed.
680* Fixed an unsigned integer overflow reported by Clang's integer sanitizer.
681* Added support for move-only return types when using a `yield_context` object
682  with asynchronous operations.
683* Changed `yield_context` to allow reentrant calls to the completion handler
684  from an initiating function.
685* Updated detection of Windows Runtime to work with latest Windows SDK.
686
687[heading Asio 1.10.5 / Boost 1.57]
688
689* Fixed the [^kqueue] reactor so that it works on FreeBSD ([ticket 10606]).
690* Fixed an issue in the [^kqueue] reactor which resulted in spinning when using
691  serial ports on Mac OS ([ticket 10496]).
692* Fixed [^kqueue] reactor support for read-only file descriptors
693  ([ticket 10367]).
694* Fixed a compile error when using the [^/dev/poll] reactor ([ticket 10350],
695  [ticket 10572]).
696* Changed the Windows backend to use `WSASocketW`, as `WSASocketA` has been
697  deprecated ([ticket 10534]).
698* Fixed some warnings reported by Visual C++ 2013 ([ticket 10376]).
699* Fixed integer type used in the WinRT version of the byte-order conversion
700  functions ([ticket 10539]).
701* Changed documentation to indicate that `use_future` and `spawn()` are not
702  made available when including the `asio.hpp` convenience header ([ticket
703  10567]).
704* Explicitly marked `asio::strand` as deprecated. Use
705  `asio::io_service::strand` instead.
706
707[heading Asio 1.10.4 / Boost 1.56]
708
709* Stopped using certain Winsock functions that are marked as deprecated in the
710  latest Visual C++ and Windows SDK.
711* Fixed a shadow variable warning on Windows.
712* Fixed a regression in the [^kqueue] backend that was introduced in Asio
713  1.10.2.
714* Added a workaround for building the unit tests with [^gcc] on AIX.
715
716[heading Asio 1.10.3]
717
718* Worked around a [^gcc] problem to do with anonymous enums ([ticket 10042]).
719* Reverted the Windows `HANDLE` backend change to ignore `ERROR_MORE_DATA`.
720  Instead, the error will be propagated as with any other (i.e. in an
721  `error_code` or thrown as a `system_error`), and the number of bytes
722  transferred will be returned. For code that needs to handle partial messages,
723  the `error_code` overload should be used ([ticket 10034]).
724* Fixed an off-by-one error in the `signal_set` implementation's signal
725  number check ([ticket 9324]).
726* Changed the Windows IOCP backend to not assume that
727  `SO_UPDATE_CONNECT_CONTEXT` is defined ([ticket 10016]).
728* Fixed a Windows-specific issue, introduced in Asio 1.10.2, by using
729  `VerifyVersionInfo` rather than `GetVersionEx`, as `GetVersionEx` has been
730  deprecated.
731* Changed to use SSE2 intrinsics rather than inline assembly, to allow the
732  Cray compiler to work.
733
734[heading Asio 1.10.2]
735
736* Fixed `asio::spawn()` to work correctly with new Boost.Coroutine interface
737  ([ticket 9442], [ticket 9928]).
738* Ensured that incomplete `asio::spawn()` coroutines are correctly unwound when
739  cleaned up by the `io_service` destructor ([ticket 9731]).
740* Fixed delegation of continuation hook for handlers produced by
741  `io_service::wrap()` and `strand::wrap()` ([ticket 9741]).
742* Changed the Windows I/O completion port backend to use `ConnectEx`, if
743  available, for connection-oriented IP sockets.
744* Changed the `io_service` backend for non-Windows (and non-IOCP Windows)
745  platforms to use a single condition variable per `io_service` instance.
746  This addresses a potential race condition when `run_one()` is used from
747  multiple threads.
748* Prevented integer overflow when computing timeouts based on some
749  `boost::chrono` and `std::chrono` clocks ([ticket 9662], [ticket 9778]).
750* Made further changes to `EV_CLEAR` handling in the kqueue backend, to address
751  other cases where the `close()` system call may hang on Mac OS X.
752* Fixed infinite recursion in implementation of
753  `resolver_query_base::flags::operator~` ([ticket 9548]).
754* Made the `select` reactor more efficient on Windows for large numbers of
755  sockets ([ticket 9528]).
756* Fixed a Windows-specific type-aliasing issue reported by [^gcc] ([ticket
757  9550]).
758* Prevented execution of compile-time-only buffer test to avoid triggering an
759  address sanitiser warning ([ticket 8295]).
760* Disabled the `GetQueuedCompletionStatus` timeout workaround on recent
761  versions of Windows.
762* Added support for string-based scope IDs when using link-local multicast
763  addresses.
764* Changed IPv6 multicast group join to use the address's scope ID as the
765  interface, if an interface is not explicitly specified.
766* Fixed multicast test failure on Mac OS X and the BSDs by using a link-local
767  multicast address.
768* Various minor documentation improvements ([ticket 8295], [ticket 9605],
769  [ticket 9771]).
770
771[heading Asio 1.10.1 / Boost 1.55]
772
773* Implemented a limited port to Windows Runtime. This support requires that the
774  language extensions be enabled. Due to the restricted facilities exposed by
775  the Windows Runtime API, the port also comes with the following caveats:
776  * The core facilities such as the `io_service`, `strand`, buffers, composed
777    operations, timers, etc., should all work as normal.
778  * For sockets, only client-side TCP is supported.
779  * Explicit binding of a client-side TCP socket is not supported.
780  * The `cancel()` function is not supported for sockets. Asynchronous
781    operations may only be cancelled by closing the socket.
782  * Operations that use `null_buffers` are not supported.
783  * Only `tcp::no_delay` and `socket_base::keep_alive` options are supported.
784  * Resolvers do not support service names, only numbers. I.e. you must
785    use "80" rather than "http".
786  * Most resolver query flags have no effect.
787* Fixed a regression (introduced in Boost 1.54) where, on some platforms, errors
788  from `async_connect` were not correctly propagated through to the completion
789  handler ([ticket 8795]).
790* Fixed a Windows-specific regression (introduced in Boost 1.54) that occurs
791  when multiple threads are running an `io_service`. When the bug occurs, the
792  result of an asynchronous operation (error and bytes tranferred) is
793  incorrectly discarded and zero values used instead. For TCP sockets this
794  results in spurious end-of-file notifications ([ticket 8933]).
795* Fixed a bug in handler tracking, where it was not correctly printing out some
796  handler IDs ([ticket 8808]).
797* Fixed the comparison used to test for successful synchronous accept
798  operations so that it works correctly with unsigned socket descriptors
799  ([ticket 8752]).
800* Ensured the signal number is correctly passed to the completion handler when
801  starting an `async_wait` on a signal that is already raised ([ticket 8738]).
802* Suppressed a g++ 4.8+ warning about unused typedefs ([ticket 8980]).
803* Enabled the move optimisation for handlers that use the default invocation
804  hook ([ticket 8624]).
805* Clarified that programs must not issue overlapping `async_write_at`
806  operations ([ticket 8669]).
807* Changed the Windows `HANDLE` backend to treat `ERROR_MORE_DATA` as a
808  non-fatal error when returned by `GetOverlappedResult` for a synchronous
809  read ([ticket 8722]).
810* Visual C++ language extensions use `generic` as a keyword. Added a
811  workaround that renames the namespace to `cpp_generic` when those language
812  extensions are in effect.
813* Fixed some asynchronous operations that missed out on getting `async_result`
814  support in Boost 1.54. In particular, the buffered stream templates have been
815  updated so that they adhere to current handler patterns ([ticket 9000],
816  [ticket 9001]).
817* Enabled move support for Microsoft Visual Studio 2012 ([ticket 8959]).
818* Added `use_future` support for Microsoft Visual Studio 2012.
819* Removed a use of `std::min` in the Windows IOCP backend to avoid a
820  dependency on the `<algorithm>` header ([ticket 8758]).
821* Eliminated some unnecessary handler copies.
822* Fixed support for older versions of OpenSSL that do not provide the
823  `SSL_CTX_clear_options` function ([ticket 9273]).
824* Fixed various minor and cosmetic issues in code and documentation
825  (including [ticket 8347], [ticket 8950], [ticket 8953], [ticket 8965],
826  [ticket 8997], [ticket 9230]).
827
828[heading Asio 1.10.0 / Boost 1.54]
829
830* Added new traits classes, `handler_type` and `async_result`, that allow the
831  customisation of the return type of an initiating function.
832* Added the `asio::spawn()` function, a high-level wrapper for running
833  stackful coroutines, based on the Boost.Coroutine library. The `spawn()`
834  function enables programs to implement asynchronous logic in a synchronous
835  manner. For example: `size_t n = my_socket.async_read_some(my_buffer, yield);`.
836  For further information, see [link boost_asio.overview.core.spawn Stackful
837  Coroutines].
838* Added the `asio::use_future` special value, which provides first-class
839  support for returning a C++11 `std::future` from an asynchronous
840  operation's initiating function. For example:
841  `future<size_t> = my_socket.async_read_some(my_buffer, asio::use_future);`.
842  For further information, see [link boost_asio.overview.cpp2011.futures C++
843  2011 Support - Futures].
844* Promoted the stackless coroutine class and macros to be part of Asio's
845  documented interface, rather than part of the HTTP server 4 example.
846  For further information, see [link boost_asio.overview.core.coroutine
847  Stackless Coroutines].
848* Added a new handler hook called `asio_handler_is_continuation`.
849  Asynchronous operations may represent a continuation of the asynchronous
850  control flow associated with the current executing handler. The
851  `asio_handler_is_continuation` hook can be customised to return `true` if
852  this is the case, and Asio's implementation can use this knowledge to
853  optimise scheduling of the new handler. To cover common cases, Asio
854  customises the hook for strands, `spawn()` and composed asynchronous
855  operations.
856* Added four new generic protocol classes, `generic::datagram_protocol`,
857  `generic::raw_protocol`, `generic::seq_packet_protocol` and
858  `generic::stream_protocol`, which implement the `Protocol` type
859  requirements, but allow the user to specify the address family (e.g.
860  `AF_INET`) and protocol type (e.g. `IPPROTO_TCP`) at runtime.
861  For further information, see [link
862  boost_asio.overview.networking.other_protocols Support for Other Protocols].
863* Added C++11 move constructors that allow the conversion of a socket (or
864  acceptor) into a more generic type. For example, an `ip::tcp::socket` can
865  be converted into a `generic::stream_protocol::socket` via move
866  construction.
867  For further information, see [link
868  boost_asio.overview.networking.other_protocols Support for Other Protocols].
869* Extended the `basic_socket_acceptor<>`'s `accept()` and `async_accept()`
870  functions to allow a new connection to be accepted directly into a socket
871  of a more generic type. For example, an `ip::tcp::acceptor` can be used to
872  accept into a `generic::stream_protocol::socket` object.
873  For further information, see [link
874  boost_asio.overview.networking.other_protocols Support for Other Protocols].
875* Moved existing examples into a C++03-specific directory, and added a new
876  directory for C++11-specific examples. A limited subset of the C++03
877  examples have been converted to their C++11 equivalents.
878* Various SSL enhancements. Thanks go to Nick Jones, on whose work these changes
879  are based.
880  * Added support for SSL handshakes with re-use of data already read from
881    the wire. New overloads of the `ssl::stream<>` class's `handshake()` and
882    `async_handshake()` functions have been added. These accept a
883    `ConstBufferSequence` to be used as initial input to the ssl engine for
884    the handshake procedure.
885  * Added support for creation of TLSv1.1 and TLSv1.2 `ssl::context` objects.
886  * Added a `set_verify_depth()` function to the `ssl::context` and
887    `ssl::stream<>` classes.
888  * Added the ability to load SSL certificate and key data from memory
889    buffers. New functions, `add_certificate_authority()`,
890    `use_certificate()`, `use_certificate_chain()`, `use_private_key()`,
891    `use_rsa_private_key()` and `use_tmp_dh()`, have been added to the
892    `ssl::context` class.
893  * Changed `ssl::context` to automatically disable SSL compression by
894    default. To enable, use the new `ssl::context::clear_options()` function,
895    as in `my_context.clear_options(ssl::context::no_compression)`.
896* Fixed a potential deadlock in `signal_set` implementation.
897* Fixed an error in acceptor example in documentation [ticket 8421].
898* Fixed copy-paste errors in waitable timer documentation [ticket 8602].
899* Added assertions to satisfy some code analysis tools [ticket 7739].
900* Fixed a malformed `#warning` directive [ticket 7939].
901* Fixed a potential data race in the Linux `epoll` implementation.
902* Fixed a Windows-specific bug, where certain operations might generate an
903  `error_code` with an invalid (i.e. `NULL`) `error_category` [ticket 8613].
904* Fixed `basic_waitable_timer`'s underlying implementation so that it can
905  handle any `time_point` value without overflowing the intermediate duration
906  objects.
907* Fixed a problem with lost thread wakeups that can occur when making
908  concurrent calls to `run()` and `poll()` on the same `io_service` object
909  [ticket 8354].
910* Fixed implementation of asynchronous connect operation so that it can cope
911  with spurious readiness notifications from the reactor [ticket 7961].
912* Fixed a memory leak in the `ssl::rfc2818_verification` class.
913* Added a mechanism for disabling automatic Winsock initialisation [ticket
914  3605]. See the header file [^boost/asio/detail/winsock_init.hpp] for details.
915
916[heading Asio 1.8.3 / Boost 1.53]
917
918* Fixed some 64-to-32-bit conversion warnings ([ticket 7459]).
919* Fixed some small errors in documentation and comments ([ticket 7761]).
920* Fixed an error in the example embedded in `basic_socket::get_option`'s
921  documentation ([ticket 7562]).
922* Changed to use `long` rather than `int` for SSL_CTX options, to match OpenSSL
923  ([ticket 7209]).
924* Changed to use `_snwprintf` to address a compile error due to the changed
925  `swprintf` signature in recent versions of MinGW ([ticket 7373]).
926* Fixed a deadlock that can occur on Windows when shutting down a pool of
927  `io_service` threads due to running out of work ([ticket 7552]).
928* Enabled the `noexcept` qualifier for error categories ([ticket 7797]).
929* Changed UNIX domain socket example to treat errors from `accept` as non-fatal
930  ([ticket 7488]).
931* Added a small block recycling optimisation to improve default memory
932  allocation behaviour.
933
934[heading Asio 1.8.2 / Boost 1.51]
935
936* Fixed an incompatibility between `ip::tcp::iostream` and C++11
937  ([@https://svn.boost.org/trac/boost/ticket/7162 #7162]).
938* Decorated GCC attribute names with underscores to prevent interaction
939  with user-defined macros
940  ([@https://svn.boost.org/trac/boost/ticket/6415 #6415]).
941* Added missing `#include <cctype>`, needed for some versions of MinGW.
942* Changed to use [^gcc]'s atomic builtins on ARM CPUs, when available
943  ([@https://svn.boost.org/trac/boost/ticket/7140 #7140]).
944* Changed strand destruction to be a no-op, to allow strand objects to be
945  destroyed after their associated `io_service` has been destroyed.
946* Added support for some newer versions of glibc which provide the
947  `epoll_create1()` function but always fail with `ENOSYS`
948  ([@https://svn.boost.org/trac/boost/ticket/7012 #7012]).
949* Changed the SSL implementation to throw an exception if SSL engine
950  initialisation fails
951  ([@https://svn.boost.org/trac/boost/ticket/6303 #6303]).
952* Fixed another regression in `buffered_write_stream`
953  ([@https://svn.boost.org/trac/boost/ticket/6310 #6310]).
954* Implemented various minor performance improvements, primarily targeted at
955  Linux x86 and x86-64 platforms.
956
957[heading Asio 1.8.1 / Boost 1.50]
958
959* Changed the `epoll_reactor` backend to do lazy registration for `EPOLLOUT`
960  events.
961* Fixed the `epoll_reactor` handling of out-of-band data, which was broken by
962  an incomplete fix in the last release.
963* Changed Asio's SSL wrapper to respect OpenSSL's `OPENSSL_NO_ENGINE` feature
964  test `#define` ([@https://svn.boost.org/trac/boost/ticket/6432 #6432]).
965* Fixed `windows::object_handle` so that it works with Windows compilers that
966  support C++11 move semantics (such as [^g++]).
967* Improved the performance of strand rescheduling.
968* Added support for [^g++] 4.7 when compiling in C++11 mode
969  ([@https://svn.boost.org/trac/boost/ticket/6620 #6620]).
970* Fixed a problem where `signal_set` handlers were not being delivered when
971  the `io_service` was constructed with a `concurrency_hint` of 1
972  ([@https://svn.boost.org/trac/boost/ticket/6657 #6657]).
973
974[heading Asio 1.8.0 / Boost 1.49]
975
976* Added a new class template `basic_waitable_timer` based around the C++11 clock
977  type requirements. It may be used with the clocks from the C++11 `<chrono>`
978  library facility or, if those are not available, Boost.Chrono. The typedefs
979  `high_resolution_timer`, `steady_timer` and `system_timer` may be used to
980  create timer objects for the standard clock types.
981* Added a new `windows::object_handle` class for performing waits on Windows
982  kernel objects. Thanks go to Boris Schaeling for contributing substantially
983  to the development of this feature.
984* On Linux, `connect()` can return EAGAIN in certain circumstances. Remapped
985  this to another error so that it doesn't look like a non-blocking operation
986  ([@https://svn.boost.org/trac/boost/ticket/6048 #6048]).
987* Fixed a compile error on NetBSD
988  ([@https://svn.boost.org/trac/boost/ticket/6098 #6098]).
989* Fixed deadlock on Mac OS X
990  ([@https://svn.boost.org/trac/boost/ticket/6275 #6275]).
991* Fixed a regression in `buffered_write_stream`
992  ([@https://svn.boost.org/trac/boost/ticket/6310 #6310]).
993* Fixed a non-paged pool "leak" on Windows when an `io_service` is repeatedly
994  run without anything to do
995  ([@https://svn.boost.org/trac/boost/ticket/6321 #6321]).
996* Reverted earlier change to allow some speculative operations to be performed
997  without holding the lock, as it introduced a race condition in some
998  multithreaded scenarios.
999* Fixed a bug where the second buffer in an array of two buffers may be ignored
1000  if the first buffer is empty.
1001
1002[heading Asio 1.6.1 / Boost 1.48]
1003
1004* Implemented various performance improvements, including:
1005  * Using thread-local operation queues in single-threaded use cases (i.e. when
1006    `concurrency_hint` is 1) to eliminate a lock/unlock pair.
1007  * Allowing some `epoll_reactor` speculative operations to be performed
1008    without holding the lock.
1009  * Improving locality of reference by performing an `epoll_reactor`'s I/O
1010    operation immediately before the corresponding handler is called. This also
1011    improves scalability across CPUs when multiple threads are running the
1012    `io_service`.
1013  * Specialising asynchronous read and write operations for buffer sequences
1014    that are arrays (`boost::array` or `std::array`) of exactly two buffers.
1015* Fixed a compile error in the regex overload of `async_read_until`
1016  ([@https://svn.boost.org/trac/boost/ticket/5688 #5688]).
1017* Fixed a Windows-specific compile error by explicitly specifying the
1018  `signal()` function from the global namespace
1019  ([@https://svn.boost.org/trac/boost/ticket/5722 #5722]).
1020* Changed the `deadline_timer` implementation so that it does not read the
1021  clock unless the timer heap is non-empty.
1022* Changed the SSL stream's buffers' sizes so that they are large enough to hold
1023  a complete TLS record ([@https://svn.boost.org/trac/boost/ticket/5854 #5854]).
1024* Fixed the behaviour of the synchronous `null_buffers` operations so that they
1025  obey the user's non-blocking setting
1026  ([@https://svn.boost.org/trac/boost/ticket/5756 #5756]).
1027* Changed to set the size of the select `fd_set` at runtime when using Windows.
1028* Disabled an MSVC warning due to const qualifier being applied to function type.
1029* Fixed a crash that occurs when using the Intel C++ compiler
1030  ([@https://svn.boost.org/trac/boost/ticket/5763 #5763]).
1031* Changed the initialisation of the OpenSSL library so that it supports all
1032  available algorithms.
1033* Fixed the SSL error mapping used when the session is gracefully shut down.
1034* Added some latency test programs.
1035* Clarified that a read operation ends when the buffer is full
1036  ([@https://svn.boost.org/trac/boost/ticket/5999 #5999]).
1037* Fixed an exception safety issue in `epoll_reactor` initialisation
1038  ([@https://svn.boost.org/trac/boost/ticket/6006 #6006]).
1039* Made the number of strand implementations configurable by defining
1040  `BOOST_ASIO_STRAND_IMPLEMENTATIONS` to the desired number.
1041* Added support for a new `BOOST_ASIO_ENABLE_SEQUENTIAL_STRAND_ALLOCATION` flag
1042  which switches the allocation of strand implementations to use a round-robin
1043  approach rather than hashing.
1044* Fixed potential strand starvation issue that can occur when `strand.post()`
1045  is used.
1046
1047[heading Asio 1.6.0 / Boost 1.47]
1048
1049* Added support for signal handling, using a new class called `signal_set`.
1050  Programs may add one or more signals to the set, and then perform an
1051  `async_wait()` operation. The specified handler will be called when one of
1052  the signals occurs. The same signal number may be registered with multiple
1053  `signal_set` objects, however the signal number must be used only with Asio.
1054  Addresses [@https://svn.boost.org/trac/boost/ticket/2879 #2879].
1055* Added handler tracking, a new debugging aid. When enabled by defining
1056  `BOOST_ASIO_ENABLE_HANDLER_TRACKING`, Asio writes debugging output to the
1057  standard error stream. The output records asynchronous operations and the
1058  relationships between their handlers. It may be post-processed using the
1059  included [^handlerviz.pl] tool to create a visual representation of the
1060  handlers (requires GraphViz).
1061* Added support for timeouts on socket iostreams, such as `ip::tcp::iostream`.
1062  A timeout is set by calling `expires_at()` or `expires_from_now()` to
1063  establish a deadline. Any socket operations which occur past the deadline
1064  will put the iostream into a bad state.
1065* Added a new `error()` member function to socket iostreams, for retrieving the
1066  error code from the most recent system call.
1067* Added a new `basic_deadline_timer::cancel_one()` function. This function lets
1068  you cancel a single waiting handler on a timer. Handlers are cancelled in
1069  FIFO order.
1070* Added a new `transfer_exactly()` completion condition. This can be used to
1071  send or receive a specified number of bytes even if the total size of the
1072  buffer (or buffer sequence) is larger.
1073* Added new free functions `connect()` and `async_connect()`. These operations
1074  try each endpoint in a list until the socket is successfully connected, and
1075  are useful for creating TCP clients that work with both IPv4 and IPv6.
1076* Extended the `buffer_size()` function so that it works for buffer sequences
1077  in addition to individual buffers.
1078* Added a new `buffer_copy()` function that can be used to copy the raw bytes
1079  between individual buffers and buffer sequences.
1080* Added new non-throwing overloads of `read()`, `read_at()`, `write()` and
1081  `write_at()` that do not require a completion condition.
1082* Added friendlier compiler errors for when a completion handler does not meet
1083  the necessary type requirements. When C++0x is available (currently supported
1084  for [^g++] 4.5 or later, and MSVC 10), `static_assert` is also used to
1085  generate an informative error message. This checking may be disabled by
1086  defining `BOOST_ASIO_DISABLE_HANDLER_TYPE_REQUIREMENTS`.
1087* Added a new, completely rewritten SSL implementation. The new implementation
1088  compiles faster, shows substantially improved performance, and supports
1089  custom memory allocation and handler invocation. It includes new API features
1090  such as certificate verification callbacks and has improved error reporting.
1091  The new implementation is source-compatible with the old for most uses.
1092  However, if necessary, the old implementation may still be used by defining
1093  `BOOST_ASIO_ENABLE_OLD_SSL`.
1094  Addresses [@https://svn.boost.org/trac/boost/ticket/3702 #3702],
1095  [@https://svn.boost.org/trac/boost/ticket/3958 #3958].
1096* Changed the separate compilation support such that, to use Asio's SSL
1097  capabilities, you should also include `boost/asio/ssl/impl/src.hpp` in one
1098  source file in your program.
1099* Changed the SSL implementation to support build environments where SSL v2 is
1100  explicitly disabled ([@https://svn.boost.org/trac/boost/ticket/5453 #5453]).
1101* Made the `is_loopback()`, `is_unspecified()` and `is_multicast()` functions
1102  consistently available across the `ip::address`, `ip::address_v4` and
1103  `ip::address_v6` classes
1104  ([@https://svn.boost.org/trac/boost/ticket/3939 #3939]).
1105* Added new `non_blocking()` functions for managing the non-blocking behaviour
1106  of a socket or descriptor. The `io_control()` commands named `non_blocking_io`
1107  are now deprecated in favour of these new functions.
1108* Added new `native_non_blocking()` functions for managing the non-blocking
1109  mode of the underlying socket or descriptor. These functions are intended to
1110  allow the encapsulation of arbitrary non-blocking system calls as
1111  asynchronous operations, in a way that is transparent to the user of the
1112  socket object. The functions have no effect on the behaviour of the
1113  synchronous operations of the socket or descriptor.
1114* Added the `io_control()` member function for socket acceptors
1115  ([@https://svn.boost.org/trac/boost/ticket/3297 #3297]).
1116* Added a `release()` member function to posix descriptors. This function
1117  releases ownership of the underlying native descriptor to the caller.
1118  Addresses [@https://svn.boost.org/trac/boost/ticket/3900 #3900].
1119* Added support for sequenced packet sockets (`SOCK_SEQPACKET`).
1120* Added a new `io_service::stopped()` function that can be used to determine
1121  whether the `io_service` has stopped (i.e. a `reset()` call is needed prior
1122  to any further calls to `run()`, `run_one()`, `poll()` or `poll_one()`).
1123* For consistency with the C++0x standard library, deprecated the `native_type`
1124  typedefs in favour of `native_handle_type`, and the `native()` member
1125  functions in favour of `native_handle()`.
1126* Added support for C++0x move construction and assignment to sockets, serial
1127  ports, POSIX descriptors and Windows handles.
1128* Reduced the copying of handler function objects.
1129* Added support for C++0x move construction to further reduce (and in some
1130  cases eliminate) copying of handler objects.
1131* Added support for the `fork()` system call. Programs that use `fork()` must
1132  call `io_service.notify_fork()` at the appropriate times. Two new examples
1133  have been added showing how to use this feature. Addresses
1134  [@https://svn.boost.org/trac/boost/ticket/3238 #3238],
1135  [@https://svn.boost.org/trac/boost/ticket/4162 #4162].
1136* Cleaned up the handling of errors reported by the `close()` system call. In
1137  particular, assume that most operating systems won't have `close()` fail with
1138  `EWOULDBLOCK`, but if it does then set the blocking mode and restart the call.
1139  If any other error occurs, assume the descriptor is closed. Addresses
1140  [@https://svn.boost.org/trac/boost/ticket/3307 #3307].
1141* Added new `asio::buffer()` overloads for `std::array`, when available.
1142* Changed the implementation to use the C++0x standard library templates
1143  `array`, `shared_ptr`, `weak_ptr` and `atomic` when they are available,
1144  rather than the Boost equivalents.
1145* Use C++0x variadic templates when available, rather than generating function
1146  overloads using Boost.Preprocessor.
1147* Changed exception reporting to include the function name in exception `what()`
1148  messages.
1149* Fixed insufficient initialisers warning with MinGW.
1150* Changed the `shutdown_service()` member functions to be private.
1151* Added archetypes for testing socket option functions.
1152* Changed the Boost.Asio examples so that they don't use Boost.Thread's
1153  convenience header. Use the header file that is specifically for the
1154  boost::thread class instead.
1155* Removed the dependency on OS-provided macros for the well-known IPv4 and IPv6
1156  addresses. This should eliminate annoying "missing braces around initializer"
1157  warnings ([@https://svn.boost.org/trac/boost/ticket/3741 #3741]).
1158* Reduced the size of `ip::basic_endpoint<>` objects (such as
1159  `ip::tcp::endpoint` and `ip::udp::endpoint`).
1160* Changed the reactor backends to assume that any descriptors or sockets added
1161  using `assign()` may have been `dup()`-ed, and so require explicit
1162  deregistration from the reactor
1163  ([@https://svn.boost.org/trac/boost/ticket/4971 #4971]).
1164* Removed the deprecated member functions named `io_service()`. The
1165  `get_io_service()` member functions should be used instead.
1166* Removed the deprecated typedefs `resolver_query` and `resolver_iterator` from
1167  the `ip::tcp`, `ip::udp` and `ip::icmp` classes.
1168* Modified the `buffers_iterator<>` and `ip::basic_resolver_iterator` classes
1169  so that the value_type typedefs are non-const byte types.
1170* Fixed warnings reported by g++'s [^-Wshadow] compiler option
1171  ([@https://svn.boost.org/trac/boost/ticket/3905 #3905]).
1172* Added an explicit cast to convert the `FIONBIO` constant to int, to suppress
1173  a compiler warning on some platforms
1174  ([@https://svn.boost.org/trac/boost/ticket/5128 #5128]).
1175* Changed most examples to treat a failure by an accept operation as non-fatal
1176  ([@https://svn.boost.org/trac/boost/ticket/5124 #5124]).
1177* Fixed an error in the [^tick_count_timer] example by making the duration type
1178  signed. Previously, a wait on an already-passed deadline would not return for
1179  a very long time ([@https://svn.boost.org/trac/boost/ticket/5418 #5418]).
1180
1181[heading Asio 1.4.9 / Boost 1.46.1]
1182
1183* `EV_ONESHOT` seems to cause problems on some versions of Mac OS X, with the
1184  `io_service` destructor getting stuck inside the `close()` system call.
1185  Changed the kqueue backend to use `EV_CLEAR` instead
1186  ([@https://svn.boost.org/trac/boost/ticket/5021 #5021]).
1187* Fixed compile failures with some versions of [^g++] due to the use of
1188  anonymous enums ([@https://svn.boost.org/trac/boost/ticket/4883 #4883]).
1189* Fixed a bug on kqueue-based platforms, where some system calls that
1190  repeatedly fail with `EWOULDBLOCK` are not correctly re-registered with
1191  kqueue.
1192* Changed `asio::streambuf` to ensure that its internal pointers are updated
1193  correctly after the data has been modified using `std::streambuf` member
1194  functions.
1195* Fixed a bug that prevented the linger socket option from working on platforms
1196  other than Windows.
1197
1198[heading Asio 1.4.8 / Boost 1.46]
1199
1200* Fixed an integer overflow problem that occurs when
1201  `ip::address_v4::broadcast()` is used on 64-bit platforms.
1202* Fixed a problem on older Linux kernels (where epoll is used without timerfd
1203  support) that prevents timely delivery of deadline_timer handlers, after the
1204  program has been running for some time
1205  ([@https://svn.boost.org/trac/boost/ticket/5045 #5045]).
1206
1207[heading Asio 1.4.7 / Boost 1.45]
1208
1209* Fixed a problem on kqueue-based platforms where a `deadline_timer` may
1210  never fire if the `io_service` is running in a background thread
1211  ([@https://svn.boost.org/trac/boost/ticket/4568 #4568]).
1212* Fixed a const-correctness issue that prevented valid uses of
1213  `has_service<>` from compiling
1214  ([@https://svn.boost.org/trac/boost/ticket/4638 #4638]).
1215* Fixed MinGW cross-compilation
1216  ([@https://svn.boost.org/trac/boost/ticket/4491 #4491]).
1217* Removed dependency on deprecated Boost.System functions
1218  ([@https://svn.boost.org/trac/boost/ticket/4672 #4672]).
1219* Ensured `close()`\/`closesocket()` failures are correctly propagated
1220  ([@https://svn.boost.org/trac/boost/ticket/4573 #4573]).
1221* Added a check for errors returned by `InitializeCriticalSectionAndSpinCount`
1222  ([@https://svn.boost.org/trac/boost/ticket/4574 #4574]).
1223* Added support for hardware flow control on QNX
1224  ([@https://svn.boost.org/trac/boost/ticket/4625 #4625]).
1225* Always use `pselect()` on HP-UX, if it is available
1226  ([@https://svn.boost.org/trac/boost/ticket/4578 #4578]).
1227* Ensured handler arguments are passed as lvalues
1228  ([@https://svn.boost.org/trac/boost/ticket/4744 #4744]).
1229* Fixed Windows build when thread support is disabled
1230  ([@https://svn.boost.org/trac/boost/ticket/4680 #4680]).
1231* Fixed a Windows-specific problem where `deadline_timer` objects with expiry
1232  times set more than 5 minutes in the future may never expire
1233  ([@https://svn.boost.org/trac/boost/ticket/4745 #4745]).
1234* Fixed the `resolver` backend on BSD platforms so that an empty service name
1235  resolves to port number `0`, as per the documentation
1236  ([@https://svn.boost.org/trac/boost/ticket/4690 #4690]).
1237* Fixed read operations so that they do not accept buffer sequences of type
1238  `const_buffers_1` ([@https://svn.boost.org/trac/boost/ticket/4746 #4746]).
1239* Redefined `Protocol` and `id` to avoid clashing with Objective-C++ keywords
1240  ([@https://svn.boost.org/trac/boost/ticket/4191 #4191]).
1241* Fixed a `vector` reallocation performance issue that can occur when there are
1242  many active `deadline_timer` objects
1243  ([@https://svn.boost.org/trac/boost/ticket/4780 #4780]).
1244* Fixed the kqueue backend so that it compiles on NetBSD
1245  ([@https://svn.boost.org/trac/boost/ticket/4662 #4662]).
1246* Fixed the socket `io_control()` implementation on 64-bit Mac OS X and BSD
1247  platforms ([@https://svn.boost.org/trac/boost/ticket/4782 #4782]).
1248* Fixed a Windows-specific problem where failures from `accept()` are
1249  incorrectly treated as successes
1250  ([@https://svn.boost.org/trac/boost/ticket/4859 #4859]).
1251* Deprecated the separate compilation header `<boost/asio/impl/src.cpp>` in
1252  favour of `<boost/asio/impl/src.hpp>`
1253  ([@https://svn.boost.org/trac/boost/ticket/4560 #4560]).
1254
1255[heading Asio 1.4.6 / Boost 1.44]
1256
1257* Reduced compile times. (Note that some programs may need to add additional
1258  `#include`s, e.g. if the program uses `boost::array` but does not explicitly
1259  include `<boost/array.hpp>`.)
1260* Reduced the size of generated code.
1261* Refactored `deadline_timer` implementation to improve performance.
1262* Improved multiprocessor scalability on Windows by using a dedicated hidden
1263  thread to wait for timers.
1264* Improved performance of `asio::streambuf` with `async_read()` and
1265  `async_read_until()`. These read operations now use the existing capacity of
1266  the `streambuf` when reading, rather than limiting the read to 512 bytes.
1267* Added optional separate compilation. To enable, add
1268  `#include <boost/asio/impl/src.cpp>` to one source file in a program, then
1269  build the program with `BOOST_ASIO_SEPARATE_COMPILATION` defined in the
1270  project\/compiler settings. Alternatively, `BOOST_ASIO_DYN_LINK` may be
1271  defined to build a separately-compiled Asio as part of a shared library.
1272* Added new macro `BOOST_ASIO_DISABLE_FENCED_BLOCK` to permit the disabling of
1273  memory fences around completion handlers, even if thread support is enabled.
1274* Reworked timeout examples to better illustrate typical use cases.
1275* Ensured that handler arguments are passed as `const` types.
1276* Fixed incorrect parameter order in `null_buffers` variant of `async_send_to`
1277  ([@https://svn.boost.org/trac/boost/ticket/4170 #4170]).
1278* Ensured `unsigned char` is used with `isdigit` in `getaddrinfo` emulation
1279  ([@https://svn.boost.org/trac/boost/ticket/4201 #4201]).
1280* Fixed handling of very small but non-zero timeouts
1281  ([@https://svn.boost.org/trac/boost/ticket/4205 #4205]).
1282* Fixed crash that occurred when an empty buffer sequence was passed to a
1283  composed read or write operation.
1284* Added missing `operator+` overload in `buffers_iterator`
1285  ([@https://svn.boost.org/trac/boost/ticket/4382 #4382]).
1286* Implemented cancellation of `null_buffers` operations on Windows.
1287
1288[heading Asio 1.4.5 / Boost 1.43]
1289
1290* Improved performance.
1291* Reduced compile times.
1292* Reduced the size of generated code.
1293* Extended the guarantee that background threads don't call user code to all
1294  asynchronous operations
1295  ([@https://svn.boost.org/trac/boost/ticket/3923 #3923]).
1296* Changed to use edge-triggered epoll on Linux.
1297* Changed to use `timerfd` for dispatching timers on Linux, when available.
1298* Changed to use one-shot notifications with kqueue on Mac OS X and BSD
1299  platforms.
1300* Added a bitmask type `ip::resolver_query_base::flags` as per the TR2 proposal.
1301  This type prevents implicit conversion from `int` to `flags`, allowing the
1302  compiler to catch cases where users incorrectly pass a numeric port number as
1303  the service name.
1304* Added `#define NOMINMAX` for all Windows compilers. Users can define
1305  `BOOST_ASIO_NO_NOMINMAX` to suppress this definition
1306  ([@https://svn.boost.org/trac/boost/ticket/3901 #3901]).
1307* Fixed a bug where 0-byte asynchronous reads were incorrectly passing an
1308  `error::eof` result to the completion handler
1309  ([@https://svn.boost.org/trac/boost/ticket/4023 #4023]).
1310* Changed the `io_control()` member functions to always call `ioctl` on the
1311  underlying descriptor when modifying blocking mode
1312  ([@https://svn.boost.org/trac/boost/ticket/3307 #3307]).
1313* Changed the resolver implementation to longer require the typedefs
1314  `InternetProtocol::resolver_query` and `InternetProtocol::resolver_iterator`,
1315  as neither typedef is part of the documented `InternetProtocol` requirements.
1316  The corresponding typedefs in the `ip::tcp`, `ip::udp` and `ip::icmp` classes
1317  have been deprecated.
1318* Fixed out-of-band handling for reactors not based on `select()`.
1319* Added new `BOOST_ASIO_DISABLE_THREADS` macro that allows Asio's threading
1320  support to be independently disabled.
1321* Minor documentation improvements.
1322
1323[heading Asio 1.4.4 / Boost 1.42]
1324
1325* Added a new HTTP Server 4 example illustrating the use of stackless coroutines
1326  with Asio.
1327* Changed handler allocation and invocation to use `boost::addressof` to get the
1328  address of handler objects, rather than applying `operator&` directly
1329  ([@https://svn.boost.org/trac/boost/ticket/2977 #2977]).
1330* Restricted MSVC buffer debugging workaround to 2008, as it causes a crash with
1331  2010 beta 2 ([@https://svn.boost.org/trac/boost/ticket/3796 #3796],
1332  [@https://svn.boost.org/trac/boost/ticket/3822 #3822]).
1333* Fixed a problem with the lifetime of handler memory, where Windows needs the
1334  `OVERLAPPED` structure to be valid until both the initiating function call
1335  has returned and the completion packet has been delivered.
1336* Don't block signals while performing system calls, but instead restart the
1337  calls if they are interrupted.
1338* Documented the guarantee made by strand objects with respect to order of
1339  handler invocation.
1340* Changed strands to use a pool of implementations, to make copying of strands
1341  cheaper.
1342* Ensured that kqueue support is enabled for BSD platforms
1343  ([@https://svn.boost.org/trac/boost/ticket/3626 #3626]).
1344* Added a `boost_` prefix to the `extern "C"` thread entry point function
1345  ([@https://svn.boost.org/trac/boost/ticket/3809 #3809]).
1346* In `getaddrinfo` emulation, only check the socket type (`SOCK_STREAM` or
1347  `SOCK_DGRAM`) if a service name has been specified. This should allow the
1348  emulation to work with raw sockets.
1349* Added a workaround for some broken Windows firewalls that make a socket
1350  appear bound to 0.0.0.0 when it is in fact bound to 127.0.0.1.
1351* Applied a fix for reported excessive CPU usage under Solaris
1352  ([@https://svn.boost.org/trac/boost/ticket/3670 #3670]).
1353* Added some support for platforms that use older compilers such as g++ 2.95
1354  ([@https://svn.boost.org/trac/boost/ticket/3743 #3743]).
1355
1356[heading Asio 1.4.3 / Boost 1.40]
1357
1358* Added a new ping example to illustrate the use of ICMP sockets.
1359* Changed the `buffered*_stream<>` templates to treat 0-byte reads and writes as
1360  no-ops, to comply with the documented type requirements for `SyncReadStream`,
1361  `AsyncReadStream`, `SyncWriteStream` and `AsyncWriteStream`.
1362* Changed some instances of the `throw` keyword to `boost::throw_exception()` to
1363  allow Asio to be used when exception support is disabled. Note that the SSL
1364  wrappers still require exception support
1365  ([@https://svn.boost.org/trac/boost/ticket/2754 #2754]).
1366* Made Asio compatible with the OpenSSL 1.0 beta
1367  ([@https://svn.boost.org/trac/boost/ticket/3256 #3256]).
1368* Eliminated a redundant system call in the Solaris [^/dev/poll] backend.
1369* Fixed a bug in resizing of the bucket array in the internal hash maps
1370  ([@https://svn.boost.org/trac/boost/ticket/3095 #3095]).
1371* Ensured correct propagation of the error code when a synchronous accept fails
1372  ([@https://svn.boost.org/trac/boost/ticket/3216 #3216]).
1373* Ensured correct propagation of the error code when a synchronous read or
1374  write on a Windows HANDLE fails.
1375* Fixed failures reported when `_GLIBCXX_DEBUG` is defined
1376  ([@https://svn.boost.org/trac/boost/ticket/3098 #3098]).
1377* Fixed custom memory allocation support for timers
1378  ([@https://svn.boost.org/trac/boost/ticket/3107 #3107]).
1379* Tidied up various warnings reported by g++
1380  ([@https://svn.boost.org/trac/boost/ticket/1341 #1341],
1381  [@https://svn.boost.org/trac/boost/ticket/2618 #2618]).
1382* Various documentation improvements, including more obvious hyperlinks to
1383  function overloads, header file information, examples for the handler type
1384  requirements, and adding enum values to the index
1385  ([@https://svn.boost.org/trac/boost/ticket/3157 #3157],
1386  [@https://svn.boost.org/trac/boost/ticket/2620 #2620]).
1387
1388[heading Asio 1.4.2 / Boost 1.39]
1389
1390* Implement automatic resizing of the bucket array in the internal hash maps.
1391  This is to improve performance for very large numbers of asynchronous
1392  operations and also to reduce memory usage for very small numbers. A new
1393  macro `BOOST_ASIO_HASH_MAP_BUCKETS` may be used to tweak the sizes used for
1394  the bucket arrays. (N.B. this feature introduced a bug which was fixed in
1395  Asio 1.4.3 / Boost 1.40.)
1396* Add performance optimisation for the Windows IOCP backend for when no timers
1397  are used.
1398* Prevent locale settings from affecting formatting of TCP and UDP endpoints
1399  ([@https://svn.boost.org/trac/boost/ticket/2682 #2682]).
1400* Fix a memory leak that occurred when an asynchronous SSL operation's
1401  completion handler threw an exception
1402  ([@https://svn.boost.org/trac/boost/ticket/2910 #2910]).
1403* Fix the implementation of `io_control()` so that it adheres to the
1404  documented type requirements for IoControlCommand
1405  ([@https://svn.boost.org/trac/boost/ticket/2820 #2820]).
1406* Fix incompatibility between Asio and ncurses.h
1407  ([@https://svn.boost.org/trac/boost/ticket/2156 #2156]).
1408* On Windows, specifically handle the case when an overlapped `ReadFile` call
1409  fails with `ERROR_MORE_DATA`. This enables a hack where a
1410  `windows::stream_handle` can be used with a message-oriented named pipe
1411  ([@https://svn.boost.org/trac/boost/ticket/2936 #2936]).
1412* Fix system call wrappers to always clear the error on success, as POSIX
1413  allows successful system calls to modify errno
1414  ([@https://svn.boost.org/trac/boost/ticket/2953 #2953]).
1415* Don't include termios.h if `BOOST_ASIO_DISABLE_SERIAL_PORT` is defined
1416  ([@https://svn.boost.org/trac/boost/ticket/2917 #2917]).
1417* Cleaned up some more MSVC level 4 warnings
1418  ([@https://svn.boost.org/trac/boost/ticket/2828 #2828]).
1419* Various documentation fixes
1420  ([@https://svn.boost.org/trac/boost/ticket/2871 #2871]).
1421
1422[heading Asio 1.4.1 / Boost 1.38]
1423
1424* Improved compatibility with some Windows firewall software.
1425* Ensured arguments to `windows::overlapped_ptr::complete()` are correctly
1426  passed to the completion handler
1427  ([@https://svn.boost.org/trac/boost/ticket/2614 #2614]).
1428* Fixed a link problem and multicast failure on QNX
1429  ([@https://svn.boost.org/trac/boost/ticket/2504 #2504],
1430  [@https://svn.boost.org/trac/boost/ticket/2530 #2530]).
1431* Fixed a compile error in SSL support on MinGW / g++ 3.4.5.
1432* Drop back to using a pipe for notification if eventfd is not available at
1433  runtime on Linux ([@https://svn.boost.org/trac/boost/ticket/2683 #2683]).
1434* Various minor bug and documentation fixes
1435  ([@https://svn.boost.org/trac/boost/ticket/2534 #2534],
1436  [@https://svn.boost.org/trac/boost/ticket/2541 #2541],
1437  [@https://svn.boost.org/trac/boost/ticket/2607 #2607],
1438  [@https://svn.boost.org/trac/boost/ticket/2617 #2617],
1439  [@https://svn.boost.org/trac/boost/ticket/2619 #2619]).
1440
1441[heading Asio 1.4.0 / Boost 1.37]
1442
1443* Enhanced CompletionCondition concept with the signature
1444  `size_t CompletionCondition(error_code ec, size_t total)`, where the return
1445  value indicates the maximum number of bytes to be transferred on the next
1446  read or write operation. (The old CompletionCondition signature is still
1447  supported for backwards compatibility).
1448* New windows::overlapped_ptr class to allow arbitrary overlapped I/O
1449  functions (such as TransmitFile) to be used with Asio.
1450* On recent versions of Linux, an eventfd descriptor is now used (rather than
1451  a pipe) to interrupt a blocked select/epoll reactor.
1452* Added const overloads of lowest_layer().
1453* Synchronous read, write, accept and connect operations are now thread safe
1454  (meaning that it is now permitted to perform concurrent synchronous
1455  operations on an individual socket, if supported by the OS).
1456* Reactor-based io_service implementations now use lazy initialisation to
1457  reduce the memory usage of an io_service object used only as a message
1458  queue.
1459
1460[heading Asio 1.2.0 / Boost 1.36]
1461
1462* Added support for serial ports.
1463* Added support for UNIX domain sockets.
1464* Added support for raw sockets and ICMP.
1465* Added wrappers for POSIX stream-oriented file descriptors (excluding regular
1466  files).
1467* Added wrappers for Windows stream-oriented `HANDLE`s such as named pipes
1468  (requires `HANDLE`s that work with I/O completion ports).
1469* Added wrappers for Windows random-access `HANDLE`s such as files (requires
1470  `HANDLE`s that work with I/O completion ports).
1471* Added support for reactor-style operations (i.e. they report readiness but
1472  perform no I/O) using a new `null_buffers` type.
1473* Added an iterator type for bytewise traversal of buffer sequences.
1474* Added new `read_until()` and `async_read_until()` overloads that take a
1475  user-defined function object for locating message boundaries.
1476* Added an experimental two-lock queue (enabled by defining
1477  `BOOST_ASIO_ENABLE_TWO_LOCK_QUEUE`) that may provide better `io_service`
1478  scalability across many processors.
1479* Various fixes, performance improvements, and more complete coverage of the
1480  custom memory allocation support.
1481
1482[heading Asio 1.0.0 / Boost 1.35]
1483
1484First release of Asio as part of Boost.
1485
1486[endsect]
1487