mirror of
https://github.com/boostorg/asio.git
synced 2026-02-01 20:12:09 +00:00
7139b456d2
* Added support for timeouts on socket iostreams, such as ip::tcp::iostream. A timeout is set by calling expires_at() or expires_from_now() to establish a deadline. Any socket operations which occur past the deadline will put the iostream into a bad state. * Added a new error() member function to socket iostreams, for retrieving the error code from the most recent system call. * Added a new basic_deadline_timer::cancel_one() function. This function lets you cancel a single waiting handler on a timer. Handlers are cancelled in FIFO order. * Added a new transfer_exactly() completion condition. This can be used to send or receive a specified number of bytes even if the total size of the buffer (or buffer sequence) is larger. * Added new free functions connect() and async_connect(). These operations try each endpoint in a list until the socket is successfully connected. * Extended the buffer_size() function so that it works for buffer sequences in addition to individual buffers. * Added a new buffer_copy() function that can be used to copy the raw bytes between individual buffers and buffer sequences. * Added new non-throwing overloads of read(), read_at(), write() and write_at() that do not require a completion condition. * Added friendlier compiler errors for when a completion handler does not meet the necessary type requirements. When C++0x is available (currently supported for g++ 4.5 or later, and MSVC 10), static_assert is also used to generate an informative error message. Checking may be disabled by defining BOOST_ASIO_DISABLE_HANDLER_TYPE_REQUIREMENTS. * Made the is_loopback(), is_unspecified() and is_multicast() functions consistently available across the ip::address, ip::address_v4 and ip::address_v6 classes. Refs #3939. * Added new non_blocking() functions for managing the non-blocking behaviour of a socket or descriptor. The io_control() commands named non_blocking_io are now deprecated in favour of these new functions. * Added new native_non_blocking() functions for managing the non-blocking mode of the underlying socket or descriptor. These functions are intended to allow the encapsulation of arbitrary non-blocking system calls as asynchronous operations, in a way that is transparent to the user of the socket object. The functions have no effect on the behaviour of the synchronous operations of the socket or descriptor. Refs #3307. * Added the io_control() member function for socket acceptors. Refs #3297. * For consistency with the C++0x standard library, deprecated the native_type typedefs in favour of native_handle_type, and the native() member functions in favour of native_handle(). * Added a release() member function to posix descriptors. This function releases ownership of the underlying native descriptor to the caller. Refs #3900. * Added support for sequenced packet sockets (SOCK_SEQPACKET). * Added a new io_service::stopped() function that can be used to determine whether the io_service has stopped (i.e. a reset() call is needed prior to any further calls to run(), run_one(), poll() or poll_one()). * Reduced the copying of handler function objects. * Added support for C++0x move construction to further reduce copying of handler objects. Move support is enabled when compiling in -std=c++0x mode on g++ 4.5 or higher, or when using MSVC10. * Removed the dependency on OS-provided macros for the well-known IPv4 and IPv6 addresses. This should eliminate the annoying "missing braces around initializer" warnings. Refs #3741. * Reduced the size of ip::basic_endpoint<> objects (such as ip::tcp::endpoint and ip::udp::endpoint). * Changed the reactor backends to assume that any descriptors or sockets added using assign() may have been dup()-ed, and so require explicit deregistration from the reactor. Refs #4971. * Changed the SSL error category to return error strings from the OpenSSL library. * Changed the separate compilation support such that, to use Asio's SSL capabilities, you should also include 'asio/ssl/impl/src.hpp in one source file in your program. * Removed the deprecated member functions named io_service(). The get_io_service() member functions should be used instead. * Removed the deprecated typedefs resolver_query and resolver_iterator from the ip::tcp, ip::udp and ip::icmp classes. * Fixed a compile error on some versions of g++ due to anonymous enums. Refs #4883. * Added an explicit cast to the FIONBIO constant to int to suppress a compiler warning on some platforms. Refs #5128. * Fixed warnings reported by g++'s -Wshadow compiler option. Refs #3905. [SVN r69194]
264 lines
7.9 KiB
Plaintext
264 lines
7.9 KiB
Plaintext
[/
|
|
/ Copyright (c) 2003-2011 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
|
/
|
|
/ Distributed under the Boost Software License, Version 1.0. (See accompanying
|
|
/ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
|
/]
|
|
|
|
[section:implementation Platform-Specific Implementation Notes]
|
|
|
|
This section lists platform-specific implementation details, such as the
|
|
default demultiplexing mechanism, the number of threads created internally, and
|
|
when threads are created.
|
|
|
|
|
|
[heading Linux Kernel 2.4]
|
|
|
|
Demultiplexing mechanism:
|
|
|
|
* Uses `select` for demultiplexing. This means that the number of file
|
|
descriptors in the process cannot be permitted to exceed `FD_SETSIZE`.
|
|
|
|
Threads:
|
|
|
|
* Demultiplexing using `select` is performed in one of the threads that calls
|
|
`io_service::run()`, `io_service::run_one()`, `io_service::poll()` or
|
|
`io_service::poll_one()`.
|
|
|
|
* An additional thread per `io_service` is used to emulate asynchronous host
|
|
resolution. This thread is created on the first call to either
|
|
`ip::tcp::resolver::async_resolve()` or `ip::udp::resolver::async_resolve()`.
|
|
|
|
Scatter-Gather:
|
|
|
|
* At most `min(64,IOV_MAX)` buffers may be transferred in a single operation.
|
|
|
|
[heading Linux Kernel 2.6]
|
|
|
|
Demultiplexing mechanism:
|
|
|
|
* Uses `epoll` for demultiplexing.
|
|
|
|
Threads:
|
|
|
|
* Demultiplexing using `epoll` is performed in one of the threads that calls
|
|
`io_service::run()`, `io_service::run_one()`, `io_service::poll()` or
|
|
`io_service::poll_one()`.
|
|
|
|
* An additional thread per `io_service` is used to emulate asynchronous host
|
|
resolution. This thread is created on the first call to either
|
|
`ip::tcp::resolver::async_resolve()` or `ip::udp::resolver::async_resolve()`.
|
|
|
|
Scatter-Gather:
|
|
|
|
* At most `min(64,IOV_MAX)` buffers may be transferred in a single operation.
|
|
|
|
|
|
[heading Solaris]
|
|
|
|
Demultiplexing mechanism:
|
|
|
|
* Uses [^/dev/poll] for demultiplexing.
|
|
|
|
Threads:
|
|
|
|
* Demultiplexing using [^/dev/poll] is performed in one of the threads that
|
|
calls `io_service::run()`, `io_service::run_one()`, `io_service::poll()` or
|
|
`io_service::poll_one()`.
|
|
|
|
* An additional thread per `io_service` is used to emulate asynchronous host
|
|
resolution. This thread is created on the first call to either
|
|
`ip::tcp::resolver::async_resolve()` or `ip::udp::resolver::async_resolve()`.
|
|
|
|
Scatter-Gather:
|
|
|
|
* At most `min(64,IOV_MAX)` buffers may be transferred in a single operation.
|
|
|
|
|
|
[heading QNX Neutrino]
|
|
|
|
Demultiplexing mechanism:
|
|
|
|
* Uses `select` for demultiplexing. This means that the number of file
|
|
descriptors in the process cannot be permitted to exceed `FD_SETSIZE`.
|
|
|
|
Threads:
|
|
|
|
* Demultiplexing using `select` is performed in one of the threads that calls
|
|
`io_service::run()`, `io_service::run_one()`, `io_service::poll()` or
|
|
`io_service::poll_one()`.
|
|
|
|
* An additional thread per `io_service` is used to emulate asynchronous host
|
|
resolution. This thread is created on the first call to either
|
|
`ip::tcp::resolver::async_resolve()` or `ip::udp::resolver::async_resolve()`.
|
|
|
|
Scatter-Gather:
|
|
|
|
* At most `min(64,IOV_MAX)` buffers may be transferred in a single operation.
|
|
|
|
|
|
[heading Mac OS X]
|
|
|
|
Demultiplexing mechanism:
|
|
|
|
* Uses `kqueue` for demultiplexing.
|
|
|
|
Threads:
|
|
|
|
* Demultiplexing using `kqueue` is performed in one of the threads that calls
|
|
`io_service::run()`, `io_service::run_one()`, `io_service::poll()` or
|
|
`io_service::poll_one()`.
|
|
|
|
* An additional thread per `io_service` is used to emulate asynchronous host
|
|
resolution. This thread is created on the first call to either
|
|
`ip::tcp::resolver::async_resolve()` or `ip::udp::resolver::async_resolve()`.
|
|
|
|
Scatter-Gather:
|
|
|
|
* At most `min(64,IOV_MAX)` buffers may be transferred in a single operation.
|
|
|
|
|
|
[heading FreeBSD]
|
|
|
|
Demultiplexing mechanism:
|
|
|
|
* Uses `kqueue` for demultiplexing.
|
|
|
|
Threads:
|
|
|
|
* Demultiplexing using `kqueue` is performed in one of the threads that calls
|
|
`io_service::run()`, `io_service::run_one()`, `io_service::poll()` or
|
|
`io_service::poll_one()`.
|
|
|
|
* An additional thread per `io_service` is used to emulate asynchronous host
|
|
resolution. This thread is created on the first call to either
|
|
`ip::tcp::resolver::async_resolve()` or `ip::udp::resolver::async_resolve()`.
|
|
|
|
Scatter-Gather:
|
|
|
|
* At most `min(64,IOV_MAX)` buffers may be transferred in a single operation.
|
|
|
|
|
|
[heading AIX]
|
|
|
|
Demultiplexing mechanism:
|
|
|
|
* Uses `select` for demultiplexing. This means that the number of file
|
|
descriptors in the process cannot be permitted to exceed `FD_SETSIZE`.
|
|
|
|
Threads:
|
|
|
|
* Demultiplexing using `select` is performed in one of the threads that calls
|
|
`io_service::run()`, `io_service::run_one()`, `io_service::poll()` or
|
|
`io_service::poll_one()`.
|
|
|
|
* An additional thread per `io_service` is used to emulate asynchronous host
|
|
resolution. This thread is created on the first call to either
|
|
`ip::tcp::resolver::async_resolve()` or `ip::udp::resolver::async_resolve()`.
|
|
|
|
Scatter-Gather:
|
|
|
|
* At most `min(64,IOV_MAX)` buffers may be transferred in a single operation.
|
|
|
|
|
|
[heading HP-UX]
|
|
|
|
Demultiplexing mechanism:
|
|
|
|
* Uses `select` for demultiplexing. This means that the number of file
|
|
descriptors in the process cannot be permitted to exceed `FD_SETSIZE`.
|
|
|
|
Threads:
|
|
|
|
* Demultiplexing using `select` is performed in one of the threads that calls
|
|
`io_service::run()`, `io_service::run_one()`, `io_service::poll()` or
|
|
`io_service::poll_one()`.
|
|
|
|
* An additional thread per `io_service` is used to emulate asynchronous host
|
|
resolution. This thread is created on the first call to either
|
|
`ip::tcp::resolver::async_resolve()` or `ip::udp::resolver::async_resolve()`.
|
|
|
|
Scatter-Gather:
|
|
|
|
* At most `min(64,IOV_MAX)` buffers may be transferred in a single operation.
|
|
|
|
|
|
[heading Tru64]
|
|
|
|
Demultiplexing mechanism:
|
|
|
|
* Uses `select` for demultiplexing. This means that the number of file
|
|
descriptors in the process cannot be permitted to exceed `FD_SETSIZE`.
|
|
|
|
Threads:
|
|
|
|
* Demultiplexing using `select` is performed in one of the threads that calls
|
|
`io_service::run()`, `io_service::run_one()`, `io_service::poll()` or
|
|
`io_service::poll_one()`.
|
|
|
|
* An additional thread per `io_service` is used to emulate asynchronous host
|
|
resolution. This thread is created on the first call to either
|
|
`ip::tcp::resolver::async_resolve()` or `ip::udp::resolver::async_resolve()`.
|
|
|
|
Scatter-Gather:
|
|
|
|
* At most `min(64,IOV_MAX)` buffers may be transferred in a single operation.
|
|
|
|
|
|
[heading Windows 95, 98 and Me]
|
|
|
|
Demultiplexing mechanism:
|
|
|
|
* Uses `select` for demultiplexing.
|
|
|
|
Threads:
|
|
|
|
* Demultiplexing using `select` is performed in one of the threads that calls
|
|
`io_service::run()`, `io_service::run_one()`, `io_service::poll()` or
|
|
`io_service::poll_one()`.
|
|
|
|
* An additional thread per `io_service` is used to emulate asynchronous host
|
|
resolution. This thread is created on the first call to either
|
|
`ip::tcp::resolver::async_resolve()` or `ip::udp::resolver::async_resolve()`.
|
|
|
|
Scatter-Gather:
|
|
|
|
* For sockets, at most 16 buffers may be transferred in a single operation.
|
|
|
|
|
|
[heading Windows NT, 2000, XP, 2003 and Vista]
|
|
|
|
Demultiplexing mechanism:
|
|
|
|
* Uses overlapped I/O and I/O completion ports for all asynchronous socket
|
|
operations except for asynchronous connect.
|
|
|
|
* Uses `select` for emulating asynchronous connect.
|
|
|
|
Threads:
|
|
|
|
* Demultiplexing using I/O completion ports is performed in all threads that call
|
|
`io_service::run()`, `io_service::run_one()`, `io_service::poll()` or
|
|
`io_service::poll_one()`.
|
|
|
|
* An additional thread per `io_service` is used to trigger timers. This thread
|
|
is created on construction of the first `deadline_timer` or
|
|
`deadline_timer_service` objects.
|
|
|
|
* An additional thread per `io_service` is used for the `select`
|
|
demultiplexing. This thread is created on the first call to `async_connect()`.
|
|
|
|
* An additional thread per `io_service` is used to emulate asynchronous host
|
|
resolution. This thread is created on the first call to either
|
|
`ip::tcp::resolver::async_resolve()` or `ip::udp::resolver::async_resolve()`.
|
|
|
|
Scatter-Gather:
|
|
|
|
* For sockets, at most 64 buffers may be transferred in a single operation.
|
|
|
|
* For stream-oriented handles, only one buffer may be transferred in a single
|
|
operation.
|
|
|
|
|
|
[endsect]
|