[Boost-commit] svn:boost r44684 - trunk/libs/asio/doc/design

From: chris_at_[hidden]
Date: 2008-04-21 02:20:32

Author: chris_kohlhoff
Date: 2008-04-21 02:20:32 EDT (Mon, 21 Apr 2008)
New Revision: 44684
URL: http://svn.boost.org/trac/boost/changeset/44684

Log:
Add documentation on the limits of the number of buffers that may be
transferred in individual operations.

Text files modified: 
   trunk/libs/asio/doc/design/implementation.qbk |    46 ++++++++++++++++++++++++++++++++++++++++
   1 files changed, 46 insertions(+), 0 deletions(-)

Modified: trunk/libs/asio/doc/design/implementation.qbk
==============================================================================
--- trunk/libs/asio/doc/design/implementation.qbk	(original)
+++ trunk/libs/asio/doc/design/implementation.qbk	2008-04-21 02:20:32 EDT (Mon, 21 Apr 2008)
@@ -29,6 +29,9 @@
 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]
 
@@ -46,6 +49,10 @@
 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]
 
@@ -63,6 +70,10 @@
 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]
 
@@ -81,6 +92,10 @@
 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]
 
@@ -98,6 +113,10 @@
 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]
 
@@ -115,6 +134,10 @@
 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]
 
@@ -133,6 +156,10 @@
 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]
 
@@ -151,6 +178,10 @@
 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]
 
@@ -169,6 +200,10 @@
 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]
 
@@ -186,6 +221,10 @@
 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]
 
@@ -209,5 +248,12 @@
 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]