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

From: chris_at_[hidden]
Date: 2008-04-21 02:15:52

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

Log:
Regenerate documentation.

Text files modified: 
   trunk/libs/asio/doc/reference.qbk | 15701 +++++++++++++++++++++++++++++++-------- 
   1 files changed, 12240 insertions(+), 3461 deletions(-)

Modified: trunk/libs/asio/doc/reference.qbk
==============================================================================
--- trunk/libs/asio/doc/reference.qbk	(original)
+++ trunk/libs/asio/doc/reference.qbk	2008-04-21 02:15:50 EDT (Mon, 21 Apr 2008)
@@ -19,9 +19,11 @@
 [include requirements/ConvertibleToConstBuffer.qbk]
 [include requirements/ConvertibleToMutableBuffer.qbk]
 [include requirements/DatagramSocketService.qbk]
+[include requirements/DescriptorService.qbk]
 [include requirements/Endpoint.qbk]
 [include requirements/GettableSocketOption.qbk]
 [include requirements/Handler.qbk]
+[include requirements/HandleService.qbk]
 [include requirements/InternetProtocol.qbk]
 [include requirements/IoControlCommand.qbk]
 [include requirements/IoObjectService.qbk]
@@ -34,6 +36,8 @@
 [include requirements/SettableSocketOption.qbk]
 [include requirements/SocketAcceptorService.qbk]
 [include requirements/SocketService.qbk]
+[include requirements/StreamDescriptorService.qbk]
+[include requirements/StreamHandleService.qbk]
 [include requirements/StreamSocketService.qbk]
 [include requirements/SyncReadStream.qbk]
 [include requirements/SyncWriteStream.qbk]
@@ -1495,6 +1499,22 @@
 
 ]
 
+[heading Protected Data Members]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.basic_datagram_socket.implementation [*implementation]]]
+    [The underlying implementation of the I/O object. ]
+  ]
+
+  [
+    [[link boost_asio.reference.basic_datagram_socket.service [*service]]]
+    [The service associated with the I/O object. ]
+  ]
+
+]
+
 The basic_datagram_socket class template provides asynchronous and blocking datagram-oriented socket functionality.
 
 
@@ -3207,6 +3227,21 @@
 [endsect]
 
 
+[section:implementation basic_datagram_socket::implementation]
+
+
+['Inherited from basic_io_object.]
+
+The underlying implementation of the I/O object. 
+
+  implementation_type implementation;
+
+
+
+[endsect]
+
+
+
 [section:implementation_type basic_datagram_socket::implementation_type]
 
 
@@ -3862,6 +3897,17 @@
   
 ]
 
+[heading Protected Member Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.basic_socket._basic_socket [*~basic_socket]]]
+    [Protected destructor to prevent deletion through this type. ]
+  ]
+  
+]
+
 [heading Data Members]
 [table
   [[Name][Description]]
@@ -3888,6 +3934,22 @@
 
 ]
 
+[heading Protected Data Members]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.basic_socket.implementation [*implementation]]]
+    [The underlying implementation of the I/O object. ]
+  ]
+
+  [
+    [[link boost_asio.reference.basic_socket.service [*service]]]
+    [The service associated with the I/O object. ]
+  ]
+
+]
+
 The basic_socket class template provides functionality that is common to both stream-oriented and datagram-oriented sockets.
 
 
@@ -5165,6 +5227,21 @@
 [endsect]
 
 
+[section:service basic_datagram_socket::service]
+
+
+['Inherited from basic_io_object.]
+
+The service associated with the I/O object. 
+
+  service_type & service;
+
+
+
+[endsect]
+
+
+
 [section:service_type basic_datagram_socket::service_type]
 
 
@@ -5539,6 +5616,22 @@
   
 ]
 
+[heading Protected Data Members]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.basic_deadline_timer.implementation [*implementation]]]
+    [The underlying implementation of the I/O object. ]
+  ]
+
+  [
+    [[link boost_asio.reference.basic_deadline_timer.service [*service]]]
+    [The service associated with the I/O object. ]
+  ]
+
+]
+
 The basic_deadline_timer class template provides the ability to perform a blocking or asynchronous wait for a timer to expire.
 
 Most applications will use the boost::asio::deadline\_timer typedef.
@@ -6081,6 +6174,21 @@
 
 
 
+[section:implementation basic_deadline_timer::implementation]
+
+
+['Inherited from basic_io_object.]
+
+The underlying implementation of the I/O object. 
+
+  implementation_type implementation;
+
+
+
+[endsect]
+
+
+
 [section:implementation_type basic_deadline_timer::implementation_type]
 
 
@@ -6120,6 +6228,21 @@
 
 
 
+[section:service basic_deadline_timer::service]
+
+
+['Inherited from basic_io_object.]
+
+The service associated with the I/O object. 
+
+  service_type & service;
+
+
+
+[endsect]
+
+
+
 [section:service_type basic_deadline_timer::service_type]
 
 
@@ -6272,6 +6395,58 @@
   
 ]
 
+[heading Protected Member Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.basic_io_object.basic_io_object [*basic_io_object]]]
+    [Construct a basic_io_object. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_io_object._basic_io_object [*~basic_io_object]]]
+    [Protected destructor to prevent deletion through this type. ]
+  ]
+  
+]
+
+[heading Protected Data Members]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.basic_io_object.implementation [*implementation]]]
+    [The underlying implementation of the I/O object. ]
+  ]
+
+  [
+    [[link boost_asio.reference.basic_io_object.service [*service]]]
+    [The service associated with the I/O object. ]
+  ]
+
+]
+
+
+[section:basic_io_object basic_io_object::basic_io_object]
+
+Construct a basic_io_object. 
+
+  basic_io_object(
+      boost::asio::io_service & io_service);
+
+
+Performs: 
+
+   service.construct(implementation); 
+
+
+
+
+
+[endsect]
+
+
 
 [section:get_io_service basic_io_object::get_io_service]
 
@@ -6293,6 +6468,18 @@
 
 
 
+[section:implementation basic_io_object::implementation]
+
+The underlying implementation of the I/O object. 
+
+  implementation_type implementation;
+
+
+
+[endsect]
+
+
+
 [section:implementation_type basic_io_object::implementation_type]
 
 The underlying implementation type of I/O object. 
@@ -6326,6 +6513,18 @@
 
 
 
+[section:service basic_io_object::service]
+
+The service associated with the I/O object. 
+
+  service_type & service;
+
+
+
+[endsect]
+
+
+
 [section:service_type basic_io_object::service_type]
 
 The type of the service that will be used to provide I/O operations. 
@@ -6339,6 +6538,25 @@
 
 
 
+[section:_basic_io_object basic_io_object::~basic_io_object]
+
+Protected destructor to prevent deletion through this type. 
+
+  ~basic_io_object();
+
+
+Performs: 
+
+   service.destroy(implementation); 
+
+
+
+
+
+[endsect]
+
+
+
 [endsect]
 
 [section:basic_socket basic_socket]
@@ -6617,6 +6835,17 @@
   
 ]
 
+[heading Protected Member Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.basic_socket._basic_socket [*~basic_socket]]]
+    [Protected destructor to prevent deletion through this type. ]
+  ]
+  
+]
+
 [heading Data Members]
 [table
   [[Name][Description]]
@@ -6643,6 +6872,22 @@
 
 ]
 
+[heading Protected Data Members]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.basic_socket.implementation [*implementation]]]
+    [The underlying implementation of the I/O object. ]
+  ]
+
+  [
+    [[link boost_asio.reference.basic_socket.service [*service]]]
+    [The service associated with the I/O object. ]
+  ]
+
+]
+
 The basic_socket class template provides functionality that is common to both stream-oriented and datagram-oriented sockets.
 
 
@@ -7818,6 +8063,21 @@
 [endsect]
 
 
+[section:implementation basic_socket::implementation]
+
+
+['Inherited from basic_io_object.]
+
+The underlying implementation of the I/O object. 
+
+  implementation_type implementation;
+
+
+
+[endsect]
+
+
+
 [section:implementation_type basic_socket::implementation_type]
 
 
@@ -8460,6 +8720,17 @@
   
 ]
 
+[heading Protected Member Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.basic_socket._basic_socket [*~basic_socket]]]
+    [Protected destructor to prevent deletion through this type. ]
+  ]
+  
+]
+
 [heading Data Members]
 [table
   [[Name][Description]]
@@ -8486,6 +8757,22 @@
 
 ]
 
+[heading Protected Data Members]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.basic_socket.implementation [*implementation]]]
+    [The underlying implementation of the I/O object. ]
+  ]
+
+  [
+    [[link boost_asio.reference.basic_socket.service [*service]]]
+    [The service associated with the I/O object. ]
+  ]
+
+]
+
 The basic_socket class template provides functionality that is common to both stream-oriented and datagram-oriented sockets.
 
 
@@ -9064,6 +9351,21 @@
 
 
 
+[section:service basic_socket::service]
+
+
+['Inherited from basic_io_object.]
+
+The service associated with the I/O object. 
+
+  service_type & service;
+
+
+
+[endsect]
+
+
+
 [section:service_type basic_socket::service_type]
 
 
@@ -9333,6 +9635,18 @@
 
 
 
+[section:_basic_socket basic_socket::~basic_socket]
+
+Protected destructor to prevent deletion through this type. 
+
+  ~basic_socket();
+
+
+
+[endsect]
+
+
+
 [endsect]
 
 [section:basic_socket_acceptor basic_socket_acceptor]
@@ -9605,6 +9919,22 @@
 
 ]
 
+[heading Protected Data Members]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.basic_socket_acceptor.implementation [*implementation]]]
+    [The underlying implementation of the I/O object. ]
+  ]
+
+  [
+    [[link boost_asio.reference.basic_socket_acceptor.service [*service]]]
+    [The service associated with the I/O object. ]
+  ]
+
+]
+
 The basic_socket_acceptor class template is used for accepting new socket connections.
 
 
@@ -10818,6 +11148,21 @@
 [endsect]
 
 
+[section:implementation basic_socket_acceptor::implementation]
+
+
+['Inherited from basic_io_object.]
+
+The underlying implementation of the I/O object. 
+
+  implementation_type implementation;
+
+
+
+[endsect]
+
+
+
 [section:implementation_type basic_socket_acceptor::implementation_type]
 
 
@@ -11611,6 +11956,21 @@
 
 
 
+[section:service basic_socket_acceptor::service]
+
+
+['Inherited from basic_io_object.]
+
+The service associated with the I/O object. 
+
+  service_type & service;
+
+
+
+[endsect]
+
+
+
 [section:service_type basic_socket_acceptor::service_type]
 
 
@@ -12192,6 +12552,32 @@
   
 ]
 
+[heading Protected Member Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.basic_socket_streambuf.overflow [*overflow]]]
+    []
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_socket_streambuf.setbuf [*setbuf]]]
+    []
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_socket_streambuf.sync [*sync]]]
+    []
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_socket_streambuf.underflow [*underflow]]]
+    []
+  ]
+  
+]
+
 [heading Data Members]
 [table
   [[Name][Description]]
@@ -12218,6 +12604,22 @@
 
 ]
 
+[heading Protected Data Members]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.basic_socket_streambuf.implementation [*implementation]]]
+    [The underlying implementation of the I/O object. ]
+  ]
+
+  [
+    [[link boost_asio.reference.basic_socket_streambuf.service [*service]]]
+    [The service associated with the I/O object. ]
+  ]
+
+]
+
 [section:assign basic_socket_streambuf::assign]
 
 Assign an existing native socket to the socket. 
@@ -13262,6 +13664,21 @@
 [endsect]
 
 
+[section:implementation basic_socket_streambuf::implementation]
+
+
+['Inherited from basic_io_object.]
+
+The underlying implementation of the I/O object. 
+
+  implementation_type implementation;
+
+
+
+[endsect]
+
+
+
 [section:implementation_type basic_socket_streambuf::implementation_type]
 
 
@@ -13917,6 +14334,17 @@
   
 ]
 
+[heading Protected Member Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.basic_socket._basic_socket [*~basic_socket]]]
+    [Protected destructor to prevent deletion through this type. ]
+  ]
+  
+]
+
 [heading Data Members]
 [table
   [[Name][Description]]
@@ -13943,6 +14371,22 @@
 
 ]
 
+[heading Protected Data Members]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.basic_socket.implementation [*implementation]]]
+    [The underlying implementation of the I/O object. ]
+  ]
+
+  [
+    [[link boost_asio.reference.basic_socket.service [*service]]]
+    [The service associated with the I/O object. ]
+  ]
+
+]
+
 The basic_socket class template provides functionality that is common to both stream-oriented and datagram-oriented sockets.
 
 
@@ -14208,6 +14652,19 @@
 [endsect]
 
 
+[section:overflow basic_socket_streambuf::overflow]
+
+
+
+  int_type overflow(
+      int_type c);
+
+
+
+[endsect]
+
+
+
 [section:protocol_type basic_socket_streambuf::protocol_type]
 
 
@@ -14542,6 +14999,21 @@
 
 
 
+[section:service basic_socket_streambuf::service]
+
+
+['Inherited from basic_io_object.]
+
+The service associated with the I/O object. 
+
+  service_type & service;
+
+
+
+[endsect]
+
+
+
 [section:service_type basic_socket_streambuf::service_type]
 
 
@@ -14669,6 +15141,20 @@
 
 [endsect]
 
+
+[section:setbuf basic_socket_streambuf::setbuf]
+
+
+
+  std::streambuf * setbuf(
+      char_type * s,
+      std::streamsize n);
+
+
+
+[endsect]
+
+
 [section:shutdown basic_socket_streambuf::shutdown]
 
 Disable sends or receives on the socket. 
@@ -14815,6 +15301,30 @@
 
 
 
+[section:sync basic_socket_streambuf::sync]
+
+
+
+  int sync();
+
+
+
+[endsect]
+
+
+
+[section:underflow basic_socket_streambuf::underflow]
+
+
+
+  int_type underflow();
+
+
+
+[endsect]
+
+
+
 [section:_basic_socket_streambuf basic_socket_streambuf::~basic_socket_streambuf]
 
 Destructor flushes buffered data. 
@@ -15170,6 +15680,22 @@
 
 ]
 
+[heading Protected Data Members]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.basic_stream_socket.implementation [*implementation]]]
+    [The underlying implementation of the I/O object. ]
+  ]
+
+  [
+    [[link boost_asio.reference.basic_stream_socket.service [*service]]]
+    [The service associated with the I/O object. ]
+  ]
+
+]
+
 The basic_stream_socket class template provides asynchronous and blocking stream-oriented socket functionality.
 
 
@@ -16770,6 +17296,21 @@
 [endsect]
 
 
+[section:implementation basic_stream_socket::implementation]
+
+
+['Inherited from basic_io_object.]
+
+The underlying implementation of the I/O object. 
+
+  implementation_type implementation;
+
+
+
+[endsect]
+
+
+
 [section:implementation_type basic_stream_socket::implementation_type]
 
 
@@ -17425,6 +17966,17 @@
   
 ]
 
+[heading Protected Member Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.basic_socket._basic_socket [*~basic_socket]]]
+    [Protected destructor to prevent deletion through this type. ]
+  ]
+  
+]
+
 [heading Data Members]
 [table
   [[Name][Description]]
@@ -17451,6 +18003,22 @@
 
 ]
 
+[heading Protected Data Members]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.basic_socket.implementation [*implementation]]]
+    [The underlying implementation of the I/O object. ]
+  ]
+
+  [
+    [[link boost_asio.reference.basic_socket.service [*service]]]
+    [The service associated with the I/O object. ]
+  ]
+
+]
+
 The basic_socket class template provides functionality that is common to both stream-oriented and datagram-oriented sockets.
 
 
@@ -18526,6 +19094,21 @@
 
 
 
+[section:service basic_stream_socket::service]
+
+
+['Inherited from basic_io_object.]
+
+The service associated with the I/O object. 
+
+  service_type & service;
+
+
+
+[endsect]
+
+
+
 [section:service_type basic_stream_socket::service_type]
 
 
@@ -18986,6 +19569,27 @@
   
 ]
 
+[heading Protected Member Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.basic_streambuf.overflow [*overflow]]]
+    []
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_streambuf.reserve [*reserve]]]
+    []
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_streambuf.underflow [*underflow]]]
+    []
+  ]
+  
+]
+
 
 [section:basic_streambuf basic_streambuf::basic_streambuf]
 
@@ -19077,6 +19681,19 @@
 
 
 
+[section:overflow basic_streambuf::overflow]
+
+
+
+  int_type overflow(
+      int_type c);
+
+
+
+[endsect]
+
+
+
 [section:prepare basic_streambuf::prepare]
 
 Get a list of buffers that represents the put area, with the given size. 
@@ -19090,6 +19707,19 @@
 
 
 
+[section:reserve basic_streambuf::reserve]
+
+
+
+  void reserve(
+      std::size_t n);
+
+
+
+[endsect]
+
+
+
 [section:size basic_streambuf::size]
 
 Return the size of the get area in characters. 
@@ -19102,6 +19732,18 @@
 
 
 
+[section:underflow basic_streambuf::underflow]
+
+
+
+  int_type underflow();
+
+
+
+[endsect]
+
+
+
 [endsect]
 
 [section:buffer buffer]
@@ -21409,18 +22051,23 @@
   
 ]
 
-[heading Friends]
+[heading Related Functions]
 [table
   [[Name][Description]]
 
   [
-    [[link boost_asio.reference.const_buffer.buffer_cast_helper [*buffer_cast_helper]]]
-    []
+    [[link boost_asio.reference.const_buffer.buffer_cast [*buffer_cast]]]
+    [Cast a non-modifiable buffer to a specified pointer to POD type. ]
   ]
   
   [
-    [[link boost_asio.reference.const_buffer.buffer_size_helper [*buffer_size_helper]]]
-    []
+    [[link boost_asio.reference.const_buffer.buffer_size [*buffer_size]]]
+    [Get the number of bytes in a non-modifiable buffer. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.const_buffer.operator_plus_ [*operator+]]]
+    [Create a new non-modifiable buffer that is offset from the start of another. ]
   ]
   
 ]
@@ -21428,11 +22075,13 @@
 The const_buffer class provides a safe representation of a buffer that cannot be modified. It does not own the underlying data, and so is cheap to copy or assign. 
 
 
-[section:buffer_cast_helper const_buffer::buffer_cast_helper]
-
+[section:buffer_cast const_buffer::buffer_cast]
 
+Cast a non-modifiable buffer to a specified pointer to POD type. 
 
-  friend const void * buffer_cast_helper(
+  template<
+      typename ``[link boost_asio.reference.PointerToPodType PointerToPodType]``>
+  PointerToPodType buffer_cast(
       const const_buffer & b);
 
 
@@ -21441,11 +22090,11 @@
 
 
 
-[section:buffer_size_helper const_buffer::buffer_size_helper]
-
+[section:buffer_size const_buffer::buffer_size]
 
+Get the number of bytes in a non-modifiable buffer. 
 
-  friend std::size_t buffer_size_helper(
+  std::size_t buffer_size(
       const const_buffer & b);
 
 
@@ -21507,34 +22156,76 @@
 
 [endsect]
 
+[section:operator_plus_ const_buffer::operator+]
 
-[endsect]
+Create a new non-modifiable buffer that is offset from the start of another. 
 
-[section:const_buffers_1 const_buffers_1]
+  const_buffer ``[link boost_asio.reference.const_buffer.operator_plus_.overload1 operator+]``(
+      const const_buffer & b,
+      std::size_t start);
 
-Adapts a single non-modifiable buffer so that it meets the requirements of the ConstBufferSequence concept. 
+  const_buffer ``[link boost_asio.reference.const_buffer.operator_plus_.overload2 operator+]``(
+      std::size_t start,
+      const const_buffer & b);
 
-  class const_buffers_1 :
-    public const_buffer
 
+[section:overload1 const_buffer::operator+ (1 of 2 overloads)]
 
-[heading Types]
-[table
-  [[Name][Description]]
+Create a new non-modifiable buffer that is offset from the start of another. 
 
-  [
+  const_buffer operator+(
+      const const_buffer & b,
+      std::size_t start);
 
-    [[link boost_asio.reference.const_buffers_1.const_iterator [*const_iterator]]]
-    [A random-access iterator type that may be used to read elements. ]
-  
-  ]
 
-  [
 
-    [[link boost_asio.reference.const_buffers_1.value_type [*value_type]]]
-    [The type for each element in the list of buffers. ]
-  
-  ]
+[endsect]
+
+
+
+[section:overload2 const_buffer::operator+ (2 of 2 overloads)]
+
+Create a new non-modifiable buffer that is offset from the start of another. 
+
+  const_buffer operator+(
+      std::size_t start,
+      const const_buffer & b);
+
+
+
+[endsect]
+
+
+[endsect]
+
+
+[endsect]
+
+[section:const_buffers_1 const_buffers_1]
+
+Adapts a single non-modifiable buffer so that it meets the requirements of the ConstBufferSequence concept. 
+
+  class const_buffers_1 :
+    public const_buffer
+
+
+[heading Types]
+[table
+  [[Name][Description]]
+
+  [
+
+    [[link boost_asio.reference.const_buffers_1.const_iterator [*const_iterator]]]
+    [A random-access iterator type that may be used to read elements. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.const_buffers_1.value_type [*value_type]]]
+    [The type for each element in the list of buffers. ]
+  
+  ]
 
 ]
 
@@ -21559,6 +22250,27 @@
   
 ]
 
+[heading Related Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.const_buffers_1.buffer_cast [*buffer_cast]]]
+    [Cast a non-modifiable buffer to a specified pointer to POD type. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.const_buffers_1.buffer_size [*buffer_size]]]
+    [Get the number of bytes in a non-modifiable buffer. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.const_buffers_1.operator_plus_ [*operator+]]]
+    [Create a new non-modifiable buffer that is offset from the start of another. ]
+  ]
+  
+]
+
 
 [section:begin const_buffers_1::begin]
 
@@ -21572,6 +22284,40 @@
 
 
 
+[section:buffer_cast const_buffers_1::buffer_cast]
+
+
+['Inherited from const_buffer.]
+
+Cast a non-modifiable buffer to a specified pointer to POD type. 
+
+  template<
+      typename ``[link boost_asio.reference.PointerToPodType PointerToPodType]``>
+  PointerToPodType buffer_cast(
+      const const_buffer & b);
+
+
+
+[endsect]
+
+
+
+[section:buffer_size const_buffers_1::buffer_size]
+
+
+['Inherited from const_buffer.]
+
+Get the number of bytes in a non-modifiable buffer. 
+
+  std::size_t buffer_size(
+      const const_buffer & b);
+
+
+
+[endsect]
+
+
+
 [section:const_buffers_1 const_buffers_1::const_buffers_1]
 
 Construct to represent a single non-modifiable buffer. 
@@ -21609,6 +22355,54 @@
 [endsect]
 
 
+[section:operator_plus_ const_buffers_1::operator+]
+
+Create a new non-modifiable buffer that is offset from the start of another. 
+
+  const_buffer ``[link boost_asio.reference.const_buffers_1.operator_plus_.overload1 operator+]``(
+      const const_buffer & b,
+      std::size_t start);
+
+  const_buffer ``[link boost_asio.reference.const_buffers_1.operator_plus_.overload2 operator+]``(
+      std::size_t start,
+      const const_buffer & b);
+
+
+[section:overload1 const_buffers_1::operator+ (1 of 2 overloads)]
+
+
+['Inherited from const_buffer.]
+
+Create a new non-modifiable buffer that is offset from the start of another. 
+
+  const_buffer operator+(
+      const const_buffer & b,
+      std::size_t start);
+
+
+
+[endsect]
+
+
+
+[section:overload2 const_buffers_1::operator+ (2 of 2 overloads)]
+
+
+['Inherited from const_buffer.]
+
+Create a new non-modifiable buffer that is offset from the start of another. 
+
+  const_buffer operator+(
+      std::size_t start,
+      const const_buffer & b);
+
+
+
+[endsect]
+
+
+[endsect]
+
 
 [section:value_type const_buffers_1::value_type]
 
@@ -21628,18 +22422,23 @@
   
 ]
 
-[heading Friends]
+[heading Related Functions]
 [table
   [[Name][Description]]
 
   [
-    [[link boost_asio.reference.const_buffer.buffer_cast_helper [*buffer_cast_helper]]]
-    []
+    [[link boost_asio.reference.const_buffer.buffer_cast [*buffer_cast]]]
+    [Cast a non-modifiable buffer to a specified pointer to POD type. ]
   ]
   
   [
-    [[link boost_asio.reference.const_buffer.buffer_size_helper [*buffer_size_helper]]]
-    []
+    [[link boost_asio.reference.const_buffer.buffer_size [*buffer_size]]]
+    [Get the number of bytes in a non-modifiable buffer. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.const_buffer.operator_plus_ [*operator+]]]
+    [Create a new non-modifiable buffer that is offset from the start of another. ]
   ]
   
 ]
@@ -22519,6 +23318,22 @@
   
 ]
 
+[heading Protected Data Members]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.basic_deadline_timer.implementation [*implementation]]]
+    [The underlying implementation of the I/O object. ]
+  ]
+
+  [
+    [[link boost_asio.reference.basic_deadline_timer.service [*service]]]
+    [The service associated with the I/O object. ]
+  ]
+
+]
+
 The basic_deadline_timer class template provides the ability to perform a blocking or asynchronous wait for a timer to expire.
 
 Most applications will use the boost::asio::deadline\_timer typedef.
@@ -23134,6 +23949,11 @@
   ]
 
   [
+    [name_too_long]
+    [The name was too long. ]
+  ]
+
+  [
     [network_down]
     [Network is down. ]
   ]
@@ -24422,6 +25242,22 @@
   
 ]
 
+[heading Protected Member Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.io_service__service.service [*service]]]
+    [Constructor. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.io_service__service._service [*~service]]]
+    [Destructor. ]
+  ]
+  
+]
+
 
 [section:get_io_service io_service::service::get_io_service]
 
@@ -24447,6 +25283,42 @@
 
 
 
+[section:service io_service::service::service]
+
+Constructor. 
+
+  service(
+      boost::asio::io_service & owner);
+
+
+
+[heading Parameters]
+    
+
+[variablelist
+  
+[[owner][The io\_service object that owns the service. ]]
+
+]
+
+
+
+[endsect]
+
+
+
+[section:_service io_service::service::~service]
+
+Destructor. 
+
+  virtual ~service();
+
+
+
+[endsect]
+
+
+
 [endsect]
 
 [section:io_service__strand io_service::strand]
@@ -24915,6 +25787,17 @@
   
 ]
 
+[heading Related Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.ip__address.operator_lt__lt_ [*operator<<]]]
+    [Output an address as a string. ]
+  ]
+  
+]
+
 The 
 [link boost_asio.reference.ip__address ip::address] class provides the ability to use either IP version 4 or version 6 addresses.
 
@@ -25120,6 +26003,42 @@
 [endsect]
 
 
+
+[section:operator_lt__lt_ ip::address::operator<<]
+
+Output an address as a string. 
+
+  template<
+      typename ``[link boost_asio.reference.Elem Elem]``,
+      typename ``[link boost_asio.reference.Traits Traits]``>
+  std::basic_ostream< Elem, Traits > & operator<<(
+      std::basic_ostream< Elem, Traits > & os,
+      const address & addr);
+
+
+Used to output a human-readable string for a specified address.
+
+
+[heading Parameters]
+    
+
+[variablelist
+  
+[[os][The output stream to which the string will be written.]]
+
+[[addr][The address to be written.]]
+
+]
+
+[heading Return Value]
+      
+The output stream. 
+
+
+
+[endsect]
+
+
 [section:operator_eq_ ip::address::operator=]
 
 Assign from another address. 
@@ -25383,6 +26302,17 @@
   
 ]
 
+[heading Related Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.ip__address_v4.operator_lt__lt_ [*operator<<]]]
+    [Output an address as a string. ]
+  ]
+  
+]
+
 The 
 [link boost_asio.reference.ip__address_v4 ip::address_v4] class provides the ability to use and manipulate IP version 4 addresses.
 
@@ -25701,6 +26631,42 @@
 
 
 
+[section:operator_lt__lt_ ip::address_v4::operator<<]
+
+Output an address as a string. 
+
+  template<
+      typename ``[link boost_asio.reference.Elem Elem]``,
+      typename ``[link boost_asio.reference.Traits Traits]``>
+  std::basic_ostream< Elem, Traits > & operator<<(
+      std::basic_ostream< Elem, Traits > & os,
+      const address_v4 & addr);
+
+
+Used to output a human-readable string for a specified address.
+
+
+[heading Parameters]
+    
+
+[variablelist
+  
+[[os][The output stream to which the string will be written.]]
+
+[[addr][The address to be written.]]
+
+]
+
+[heading Return Value]
+      
+The output stream. 
+
+
+
+[endsect]
+
+
+
 [section:operator_lt__eq_ ip::address_v4::operator<=]
 
 Compare addresses for ordering. 
@@ -26009,6 +26975,17 @@
   
 ]
 
+[heading Related Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.ip__address_v6.operator_lt__lt_ [*operator<<]]]
+    [Output an address as a string. ]
+  ]
+  
+]
+
 The 
 [link boost_asio.reference.ip__address_v6 ip::address_v6] class provides the ability to use and manipulate IP version 6 addresses.
 
@@ -26358,6 +27335,42 @@
 
 
 
+[section:operator_lt__lt_ ip::address_v6::operator<<]
+
+Output an address as a string. 
+
+  template<
+      typename ``[link boost_asio.reference.Elem Elem]``,
+      typename ``[link boost_asio.reference.Traits Traits]``>
+  std::basic_ostream< Elem, Traits > & operator<<(
+      std::basic_ostream< Elem, Traits > & os,
+      const address_v6 & addr);
+
+
+Used to output a human-readable string for a specified address.
+
+
+[heading Parameters]
+    
+
+[variablelist
+  
+[[os][The output stream to which the string will be written.]]
+
+[[addr][The address to be written.]]
+
+]
+
+[heading Return Value]
+      
+The output stream. 
+
+
+
+[endsect]
+
+
+
 [section:operator_lt__eq_ ip::address_v6::operator<=]
 
 Compare addresses for ordering. 
@@ -26656,6 +27669,17 @@
   
 ]
 
+[heading Related Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.ip__basic_endpoint.operator_lt__lt_ [*operator<<]]]
+    [Output an endpoint as a string. ]
+  ]
+  
+]
+
 The 
 [link boost_asio.reference.ip__basic_endpoint ip::basic_endpoint] class template describes an endpoint that may be associated with a particular socket.
 
@@ -26880,6 +27904,39 @@
 
 
 
+[section:operator_lt__lt_ ip::basic_endpoint::operator<<]
+
+Output an endpoint as a string. 
+
+  std::basic_ostream< Elem, Traits > & operator<<(
+      std::basic_ostream< Elem, Traits > & os,
+      const basic_endpoint< InternetProtocol > & endpoint);
+
+
+Used to output a human-readable string for a specified endpoint.
+
+
+[heading Parameters]
+    
+
+[variablelist
+  
+[[os][The output stream to which the string will be written.]]
+
+[[endpoint][The endpoint to be written.]]
+
+]
+
+[heading Return Value]
+      
+The output stream. 
+
+
+
+[endsect]
+
+
+
 [section:operator_eq_ ip::basic_endpoint::operator=]
 
 Assign from another endpoint. 
@@ -27090,6 +28147,22 @@
   
 ]
 
+[heading Protected Data Members]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.ip__basic_resolver.implementation [*implementation]]]
+    [The underlying implementation of the I/O object. ]
+  ]
+
+  [
+    [[link boost_asio.reference.ip__basic_resolver.service [*service]]]
+    [The service associated with the I/O object. ]
+  ]
+
+]
+
 The basic_resolver class template provides the ability to resolve a query to a list of endpoints.
 
 
@@ -27287,6 +28360,21 @@
 
 
 
+[section:implementation ip::basic_resolver::implementation]
+
+
+['Inherited from basic_io_object.]
+
+The underlying implementation of the I/O object. 
+
+  implementation_type implementation;
+
+
+
+[endsect]
+
+
+
 [section:implementation_type ip::basic_resolver::implementation_type]
 
 
@@ -27549,6 +28637,21 @@
 [endsect]
 
 
+[section:service ip::basic_resolver::service]
+
+
+['Inherited from basic_io_object.]
+
+The service associated with the I/O object. 
+
+  service_type & service;
+
+
+
+[endsect]
+
+
+
 [section:service_type ip::basic_resolver::service_type]
 
 
@@ -28419,6 +29522,17 @@
   class resolver_query_base
 
 
+[heading Protected Member Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.ip__resolver_query_base._resolver_query_base [*~resolver_query_base]]]
+    [Protected destructor to prevent deletion through this type. ]
+  ]
+  
+]
+
 [heading Data Members]
 [table
   [[Name][Description]]
@@ -28545,6 +29659,18 @@
 
 
 
+[section:_resolver_query_base ip::resolver_query_base::~resolver_query_base]
+
+Protected destructor to prevent deletion through this type. 
+
+  ~resolver_query_base();
+
+
+
+[endsect]
+
+
+
 [endsect]
 
 [section:ip__resolver_service ip::resolver_service]
@@ -29327,6 +30453,22 @@
 
 ]
 
+[heading Protected Data Members]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.basic_socket_acceptor.implementation [*implementation]]]
+    [The underlying implementation of the I/O object. ]
+  ]
+
+  [
+    [[link boost_asio.reference.basic_socket_acceptor.service [*service]]]
+    [The service associated with the I/O object. ]
+  ]
+
+]
+
 The basic_socket_acceptor class template is used for accepting new socket connections.
 
 
@@ -29456,6 +30598,17 @@
   
 ]
 
+[heading Related Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.ip__basic_endpoint.operator_lt__lt_ [*operator<<]]]
+    [Output an endpoint as a string. ]
+  ]
+  
+]
+
 The 
 [link boost_asio.reference.ip__basic_endpoint ip::basic_endpoint] class template describes an endpoint that may be associated with a particular socket.
 
@@ -29695,6 +30848,22 @@
   
 ]
 
+[heading Protected Data Members]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.ip__basic_resolver.implementation [*implementation]]]
+    [The underlying implementation of the I/O object. ]
+  ]
+
+  [
+    [[link boost_asio.reference.ip__basic_resolver.service [*service]]]
+    [The service associated with the I/O object. ]
+  ]
+
+]
+
 The basic_resolver class template provides the ability to resolve a query to a list of endpoints.
 
 
@@ -30199,6 +31368,22 @@
 
 ]
 
+[heading Protected Data Members]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.basic_stream_socket.implementation [*implementation]]]
+    [The underlying implementation of the I/O object. ]
+  ]
+
+  [
+    [[link boost_asio.reference.basic_stream_socket.service [*service]]]
+    [The service associated with the I/O object. ]
+  ]
+
+]
+
 The basic_stream_socket class template provides asynchronous and blocking stream-oriented socket functionality.
 
 
@@ -30459,6 +31644,17 @@
   
 ]
 
+[heading Related Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.ip__basic_endpoint.operator_lt__lt_ [*operator<<]]]
+    [Output an endpoint as a string. ]
+  ]
+  
+]
+
 The 
 [link boost_asio.reference.ip__basic_endpoint ip::basic_endpoint] class template describes an endpoint that may be associated with a particular socket.
 
@@ -30619,6 +31815,22 @@
   
 ]
 
+[heading Protected Data Members]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.ip__basic_resolver.implementation [*implementation]]]
+    [The underlying implementation of the I/O object. ]
+  ]
+
+  [
+    [[link boost_asio.reference.ip__basic_resolver.service [*service]]]
+    [The service associated with the I/O object. ]
+  ]
+
+]
+
 The basic_resolver class template provides the ability to resolve a query to a list of endpoints.
 
 
@@ -31123,6 +32335,22 @@
 
 ]
 
+[heading Protected Data Members]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.basic_datagram_socket.implementation [*implementation]]]
+    [The underlying implementation of the I/O object. ]
+  ]
+
+  [
+    [[link boost_asio.reference.basic_datagram_socket.service [*service]]]
+    [The service associated with the I/O object. ]
+  ]
+
+]
+
 The basic_datagram_socket class template provides asynchronous and blocking datagram-oriented socket functionality.
 
 
@@ -31327,20 +32555,77 @@
 
 [endsect]
 
-[section:mutable_buffer mutable_buffer]
+[section:local__basic_endpoint local::basic_endpoint]
 
-Holds a buffer that can be modified. 
+Describes an endpoint for a UNIX socket. 
 
-  class mutable_buffer
+  template<
+      typename ``[link boost_asio.reference.Protocol Protocol]``>
+  class basic_endpoint
+
+
+[heading Types]
+[table
+  [[Name][Description]]
+
+  [
+
+    [[link boost_asio.reference.local__basic_endpoint.data_type [*data_type]]]
+    [The type of the endpoint structure. This type is dependent on the underlying implementation of the socket layer. ]
+  
+  ]
 
+  [
+
+    [[link boost_asio.reference.local__basic_endpoint.protocol_type [*protocol_type]]]
+    [The protocol type associated with the endpoint. ]
+  
+  ]
+
+]
 
 [heading Member Functions]
 [table
   [[Name][Description]]
 
   [
-    [[link boost_asio.reference.mutable_buffer.mutable_buffer [*mutable_buffer]]]
-    [Construct an empty buffer. ]
+    [[link boost_asio.reference.local__basic_endpoint.basic_endpoint [*basic_endpoint]]]
+    [Default constructor. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.local__basic_endpoint.capacity [*capacity]]]
+    [Get the capacity of the endpoint in the native type. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.local__basic_endpoint.data [*data]]]
+    [Get the underlying endpoint in the native type. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.local__basic_endpoint.operator_eq_ [*operator=]]]
+    [Assign from another endpoint. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.local__basic_endpoint.path [*path]]]
+    [Get the path associated with the endpoint. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.local__basic_endpoint.protocol [*protocol]]]
+    [The protocol associated with the endpoint. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.local__basic_endpoint.resize [*resize]]]
+    [Set the underlying size of the endpoint in the native type. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.local__basic_endpoint.size [*size]]]
+    [Get the underlying size of the endpoint in the native type. ]
   ]
   
 ]
@@ -31350,61 +32635,91 @@
   [[Name][Description]]
 
   [
-    [[link boost_asio.reference.mutable_buffer.buffer_cast_helper [*buffer_cast_helper]]]
-    []
+    [[link boost_asio.reference.local__basic_endpoint.operator_not__eq_ [*operator!=]]]
+    [Compare two endpoints for inequality. ]
   ]
   
   [
-    [[link boost_asio.reference.mutable_buffer.buffer_size_helper [*buffer_size_helper]]]
-    []
+    [[link boost_asio.reference.local__basic_endpoint.operator_lt_ [*operator<]]]
+    [Compare endpoints for ordering. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.local__basic_endpoint.operator_eq__eq_ [*operator==]]]
+    [Compare two endpoints for equality. ]
   ]
   
 ]
 
-The mutable_buffer class provides a safe representation of a buffer that can be modified. It does not own the underlying data, and so is cheap to copy or assign. 
+[heading Related Functions]
+[table
+  [[Name][Description]]
 
+  [
+    [[link boost_asio.reference.local__basic_endpoint.operator_lt__lt_ [*operator<<]]]
+    [Output an endpoint as a string. ]
+  ]
+  
+]
 
-[section:buffer_cast_helper mutable_buffer::buffer_cast_helper]
+The 
+[link boost_asio.reference.local__basic_endpoint local::basic_endpoint] class template describes an endpoint that may be associated with a particular UNIX socket.
 
 
+[heading Thread Safety]
+  
+[*Distinct] [*objects:]  Safe.
 
-  friend void * buffer_cast_helper(
-      const mutable_buffer & b);
+[*Shared] [*objects:]  Unsafe.
 
 
+[section:basic_endpoint local::basic_endpoint::basic_endpoint]
 
-[endsect]
+Default constructor. 
 
+  ``[link boost_asio.reference.local__basic_endpoint.basic_endpoint.overload1 basic_endpoint]``();
 
+  ``[link boost_asio.reference.local__basic_endpoint.basic_endpoint.overload2 basic_endpoint]``(
+      const char * path);
 
-[section:buffer_size_helper mutable_buffer::buffer_size_helper]
+  ``[link boost_asio.reference.local__basic_endpoint.basic_endpoint.overload3 basic_endpoint]``(
+      const std::string & path);
 
+  ``[link boost_asio.reference.local__basic_endpoint.basic_endpoint.overload4 basic_endpoint]``(
+      const basic_endpoint & other);
 
 
-  friend std::size_t buffer_size_helper(
-      const mutable_buffer & b);
+[section:overload1 local::basic_endpoint::basic_endpoint (1 of 4 overloads)]
+
+Default constructor. 
+
+  basic_endpoint();
 
 
 
 [endsect]
 
 
-[section:mutable_buffer mutable_buffer::mutable_buffer]
 
-Construct an empty buffer. 
+[section:overload2 local::basic_endpoint::basic_endpoint (2 of 4 overloads)]
 
-  ``[link boost_asio.reference.mutable_buffer.mutable_buffer.overload1 mutable_buffer]``();
+Construct an endpoint using the specified path name. 
 
-  ``[link boost_asio.reference.mutable_buffer.mutable_buffer.overload2 mutable_buffer]``(
-      void * data,
-      std::size_t size);
+  basic_endpoint(
+      const char * path);
 
 
-[section:overload1 mutable_buffer::mutable_buffer (1 of 2 overloads)]
 
-Construct an empty buffer. 
+[endsect]
 
-  mutable_buffer();
+
+
+[section:overload3 local::basic_endpoint::basic_endpoint (3 of 4 overloads)]
+
+Construct an endpoint using the specified path name. 
+
+  basic_endpoint(
+      const std::string & path);
 
 
 
@@ -31412,13 +32727,12 @@
 
 
 
-[section:overload2 mutable_buffer::mutable_buffer (2 of 2 overloads)]
+[section:overload4 local::basic_endpoint::basic_endpoint (4 of 4 overloads)]
 
-Construct a buffer to represent a given memory range. 
+Copy constructor. 
 
-  mutable_buffer(
-      void * data,
-      std::size_t size);
+  basic_endpoint(
+      const basic_endpoint & other);
 
 
 
@@ -31428,75 +32742,57 @@
 [endsect]
 
 
+[section:capacity local::basic_endpoint::capacity]
+
+Get the capacity of the endpoint in the native type. 
+
+  std::size_t capacity() const;
+
+
+
 [endsect]
 
-[section:mutable_buffers_1 mutable_buffers_1]
 
-Adapts a single modifiable buffer so that it meets the requirements of the MutableBufferSequence concept. 
+[section:data local::basic_endpoint::data]
 
-  class mutable_buffers_1 :
-    public mutable_buffer
+Get the underlying endpoint in the native type. 
 
+  data_type * ``[link boost_asio.reference.local__basic_endpoint.data.overload1 data]``();
 
-[heading Types]
-[table
-  [[Name][Description]]
+  const data_type * ``[link boost_asio.reference.local__basic_endpoint.data.overload2 data]``() const;
 
-  [
 
-    [[link boost_asio.reference.mutable_buffers_1.const_iterator [*const_iterator]]]
-    [A random-access iterator type that may be used to read elements. ]
-  
-  ]
+[section:overload1 local::basic_endpoint::data (1 of 2 overloads)]
 
-  [
+Get the underlying endpoint in the native type. 
 
-    [[link boost_asio.reference.mutable_buffers_1.value_type [*value_type]]]
-    [The type for each element in the list of buffers. ]
-  
-  ]
+  data_type * data();
 
-]
 
-[heading Member Functions]
-[table
-  [[Name][Description]]
 
-  [
-    [[link boost_asio.reference.mutable_buffers_1.begin [*begin]]]
-    [Get a random-access iterator to the first element. ]
-  ]
-  
-  [
-    [[link boost_asio.reference.mutable_buffers_1.end [*end]]]
-    [Get a random-access iterator for one past the last element. ]
-  ]
-  
-  [
-    [[link boost_asio.reference.mutable_buffers_1.mutable_buffers_1 [*mutable_buffers_1]]]
-    [Construct to represent a single modifiable buffer. ]
-  ]
-  
-]
+[endsect]
 
 
-[section:begin mutable_buffers_1::begin]
 
-Get a random-access iterator to the first element. 
+[section:overload2 local::basic_endpoint::data (2 of 2 overloads)]
 
-  const_iterator begin() const;
+Get the underlying endpoint in the native type. 
+
+  const data_type * data() const;
 
 
 
 [endsect]
 
 
+[endsect]
 
-[section:const_iterator mutable_buffers_1::const_iterator]
 
-A random-access iterator type that may be used to read elements. 
+[section:data_type local::basic_endpoint::data_type]
 
-  typedef const mutable_buffer * const_iterator;
+The type of the endpoint structure. This type is dependent on the underlying implementation of the socket layer. 
+
+  typedef implementation_defined data_type;
 
 
 
@@ -31505,11 +32801,13 @@
 
 
 
-[section:end mutable_buffers_1::end]
+[section:operator_not__eq_ local::basic_endpoint::operator!=]
 
-Get a random-access iterator for one past the last element. 
+Compare two endpoints for inequality. 
 
-  const_iterator end() const;
+  friend bool operator!=(
+      const basic_endpoint< Protocol > & e1,
+      const basic_endpoint< Protocol > & e2);
 
 
 
@@ -31517,12 +32815,13 @@
 
 
 
-[section:mutable_buffers_1 mutable_buffers_1::mutable_buffers_1]
+[section:operator_lt_ local::basic_endpoint::operator<]
 
-Construct to represent a single modifiable buffer. 
+Compare endpoints for ordering. 
 
-  mutable_buffers_1(
-      const mutable_buffer & b);
+  friend bool operator<(
+      const basic_endpoint< Protocol > & e1,
+      const basic_endpoint< Protocol > & e2);
 
 
 
@@ -31530,56 +32829,45 @@
 
 
 
-[section:value_type mutable_buffers_1::value_type]
+[section:operator_lt__lt_ local::basic_endpoint::operator<<]
 
-The type for each element in the list of buffers. 
+Output an endpoint as a string. 
 
-  typedef mutable_buffer value_type;
+  std::basic_ostream< Elem, Traits > & operator<<(
+      std::basic_ostream< Elem, Traits > & os,
+      const basic_endpoint< Protocol > & endpoint);
 
 
-[heading Member Functions]
-[table
-  [[Name][Description]]
+Used to output a human-readable string for a specified endpoint.
 
-  [
-    [[link boost_asio.reference.mutable_buffer.mutable_buffer [*mutable_buffer]]]
-    [Construct an empty buffer. ]
-  ]
-  
-]
 
-[heading Friends]
-[table
-  [[Name][Description]]
+[heading Parameters]
+    
 
-  [
-    [[link boost_asio.reference.mutable_buffer.buffer_cast_helper [*buffer_cast_helper]]]
-    []
-  ]
-  
-  [
-    [[link boost_asio.reference.mutable_buffer.buffer_size_helper [*buffer_size_helper]]]
-    []
-  ]
+[variablelist
   
-]
-
-The mutable_buffer class provides a safe representation of a buffer that can be modified. It does not own the underlying data, and so is cheap to copy or assign. 
+[[os][The output stream to which the string will be written.]]
 
+[[endpoint][The endpoint to be written.]]
 
+]
 
-[endsect]
+[heading Return Value]
+      
+The output stream. 
 
 
 
 [endsect]
 
 
-[section:placeholders__bytes_transferred placeholders::bytes_transferred]
 
-An argument placeholder, for use with boost::bind(), that corresponds to the bytes_transferred argument of a handler for asynchronous functions such as boost::asio::basic_stream_socket::async_write_some or boost::asio::async_write. 
+[section:operator_eq_ local::basic_endpoint::operator=]
 
-  unspecified bytes_transferred;
+Assign from another endpoint. 
+
+  basic_endpoint & operator=(
+      const basic_endpoint & other);
 
 
 
@@ -31587,152 +32875,89 @@
 
 
 
-[section:placeholders__error placeholders::error]
+[section:operator_eq__eq_ local::basic_endpoint::operator==]
 
-An argument placeholder, for use with boost::bind(), that corresponds to the error argument of a handler for any of the asynchronous functions. 
+Compare two endpoints for equality. 
 
-  unspecified error;
+  friend bool operator==(
+      const basic_endpoint< Protocol > & e1,
+      const basic_endpoint< Protocol > & e2);
 
 
 
 [endsect]
 
 
+[section:path local::basic_endpoint::path]
 
-[section:placeholders__iterator placeholders::iterator]
-
-An argument placeholder, for use with boost::bind(), that corresponds to the iterator argument of a handler for asynchronous functions such as boost::asio::basic_resolver::resolve. 
+Get the path associated with the endpoint. 
 
-  unspecified iterator;
+  std::string ``[link boost_asio.reference.local__basic_endpoint.path.overload1 path]``() const;
 
+  void ``[link boost_asio.reference.local__basic_endpoint.path.overload2 path]``(
+      const char * p);
 
+  void ``[link boost_asio.reference.local__basic_endpoint.path.overload3 path]``(
+      const std::string & p);
 
-[endsect]
 
+[section:overload1 local::basic_endpoint::path (1 of 3 overloads)]
 
-[section:read read]
+Get the path associated with the endpoint. 
 
-Attempt to read a certain amount of data from a stream before returning. 
+  std::string path() const;
 
-  template<
-      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
-      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``>
-  std::size_t ``[link boost_asio.reference.read.overload1 read]``(
-      SyncReadStream & s,
-      const MutableBufferSequence & buffers);
 
-  template<
-      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
-      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``,
-      typename CompletionCondition>
-  std::size_t ``[link boost_asio.reference.read.overload2 read]``(
-      SyncReadStream & s,
-      const MutableBufferSequence & buffers,
-      CompletionCondition completion_condition);
 
-  template<
-      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
-      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``,
-      typename CompletionCondition>
-  std::size_t ``[link boost_asio.reference.read.overload3 read]``(
-      SyncReadStream & s,
-      const MutableBufferSequence & buffers,
-      CompletionCondition completion_condition,
-      boost::system::error_code & ec);
+[endsect]
 
-  template<
-      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
-      typename Allocator>
-  std::size_t ``[link boost_asio.reference.read.overload4 read]``(
-      SyncReadStream & s,
-      basic_streambuf< Allocator > & b);
 
-  template<
-      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
-      typename Allocator,
-      typename CompletionCondition>
-  std::size_t ``[link boost_asio.reference.read.overload5 read]``(
-      SyncReadStream & s,
-      basic_streambuf< Allocator > & b,
-      CompletionCondition completion_condition);
 
-  template<
-      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
-      typename Allocator,
-      typename CompletionCondition>
-  std::size_t ``[link boost_asio.reference.read.overload6 read]``(
-      SyncReadStream & s,
-      basic_streambuf< Allocator > & b,
-      CompletionCondition completion_condition,
-      boost::system::error_code & ec);
+[section:overload2 local::basic_endpoint::path (2 of 3 overloads)]
 
+Set the path associated with the endpoint. 
 
-[section:overload1 read (1 of 6 overloads)]
+  void path(
+      const char * p);
 
-Attempt to read a certain amount of data from a stream before returning. 
 
-  template<
-      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
-      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``>
-  std::size_t read(
-      SyncReadStream & s,
-      const MutableBufferSequence & buffers);
 
+[endsect]
 
-This function is used to read a certain number of bytes of data from a stream. The call will block until one of the following conditions is true:
 
 
-* The supplied buffers are full. That is, the bytes transferred is equal to the sum of the buffer sizes.
+[section:overload3 local::basic_endpoint::path (3 of 3 overloads)]
 
-* An error occurred.
+Set the path associated with the endpoint. 
 
-This operation is implemented in terms of one or more calls to the stream's read\_some function.
+  void path(
+      const std::string & p);
 
 
-[heading Parameters]
-    
 
-[variablelist
-  
-[[s][The stream from which the data is to be read. The type must support the SyncReadStream concept.]]
+[endsect]
 
-[[buffers][One or more buffers into which the data will be read. The sum of the buffer sizes indicates the maximum number of bytes to read from the stream.]]
 
-]
+[endsect]
 
-[heading Return Value]
-      
-The number of bytes transferred.
 
-[heading Exceptions]
-    
+[section:protocol local::basic_endpoint::protocol]
 
-[variablelist
-  
-[[boost::system::system_error][Thrown on failure.]]
+The protocol associated with the endpoint. 
 
-]
+  protocol_type protocol() const;
 
-[heading Example]
-  
-To read into a single data buffer use the 
-[link boost_asio.reference.buffer buffer]  function as follows: 
 
-   boost::asio::read(s, boost::asio::buffer(data, size)); 
 
+[endsect]
 
-See the 
-[link boost_asio.reference.buffer buffer]  documentation for information on reading into multiple buffers in one go, and how to use it with arrays, boost::array or std::vector.
 
-[heading Remarks]
-      
-This overload is equivalent to calling: 
 
-   boost::asio::read(
-       s, buffers,
-       boost::asio::transfer_all()); 
+[section:protocol_type local::basic_endpoint::protocol_type]
 
+The protocol type associated with the endpoint. 
 
+  typedef Protocol protocol_type;
 
 
 
@@ -31741,78 +32966,66 @@
 
 
 
-[section:overload2 read (2 of 6 overloads)]
+[section:resize local::basic_endpoint::resize]
 
-Attempt to read a certain amount of data from a stream before returning. 
+Set the underlying size of the endpoint in the native type. 
 
-  template<
-      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
-      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``,
-      typename CompletionCondition>
-  std::size_t read(
-      SyncReadStream & s,
-      const MutableBufferSequence & buffers,
-      CompletionCondition completion_condition);
+  void resize(
+      std::size_t size);
 
 
-This function is used to read a certain number of bytes of data from a stream. The call will block until one of the following conditions is true:
 
+[endsect]
 
-* The supplied buffers are full. That is, the bytes transferred is equal to the sum of the buffer sizes.
 
-* The completion_condition function object returns true.
 
-This operation is implemented in terms of one or more calls to the stream's read\_some function.
+[section:size local::basic_endpoint::size]
 
+Get the underlying size of the endpoint in the native type. 
 
-[heading Parameters]
-    
+  std::size_t size() const;
 
-[variablelist
-  
-[[s][The stream from which the data is to be read. The type must support the SyncReadStream concept.]]
 
-[[buffers][One or more buffers into which the data will be read. The sum of the buffer sizes indicates the maximum number of bytes to read from the stream.]]
 
-[[completion_condition][The function object to be called to determine whether the read operation is complete. The signature of the function object must be: 
-``
-   bool completion_condition(
-     const boost::system::error_code& error, // Result of latest read_some
-                                             // operation.
+[endsect]
 
-     std::size_t bytes_transferred           // Number of bytes transferred
-                                             // so far.
-   ); 
 
-``
-A return value of true indicates that the read operation is complete. False indicates that further calls to the stream's read\_some function are required.]]
 
-]
+[endsect]
 
-[heading Return Value]
-      
-The number of bytes transferred.
+[section:local__connect_pair local::connect_pair]
 
-[heading Exceptions]
-    
+Create a pair of connected sockets. 
 
-[variablelist
-  
-[[boost::system::system_error][Thrown on failure.]]
+  template<
+      typename ``[link boost_asio.reference.Protocol Protocol]``,
+      typename ``[link boost_asio.reference.SocketService1 SocketService1]``,
+      typename ``[link boost_asio.reference.SocketService2 SocketService2]``>
+  void ``[link boost_asio.reference.local__connect_pair.overload1 connect_pair]``(
+      basic_socket< Protocol, SocketService1 > & socket1,
+      basic_socket< Protocol, SocketService2 > & socket2);
 
-]
+  template<
+      typename ``[link boost_asio.reference.Protocol Protocol]``,
+      typename ``[link boost_asio.reference.SocketService1 SocketService1]``,
+      typename ``[link boost_asio.reference.SocketService2 SocketService2]``>
+  boost::system::error_code ``[link boost_asio.reference.local__connect_pair.overload2 connect_pair]``(
+      basic_socket< Protocol, SocketService1 > & socket1,
+      basic_socket< Protocol, SocketService2 > & socket2,
+      boost::system::error_code & ec);
 
-[heading Example]
-  
-To read into a single data buffer use the 
-[link boost_asio.reference.buffer buffer]  function as follows: 
 
-   boost::asio::read(s, boost::asio::buffer(data, size),
-       boost::asio::transfer_at_least(32)); 
+[section:overload1 local::connect_pair (1 of 2 overloads)]
 
+Create a pair of connected sockets. 
 
-See the 
-[link boost_asio.reference.buffer buffer]  documentation for information on reading into multiple buffers in one go, and how to use it with arrays, boost::array or std::vector. 
+  template<
+      typename ``[link boost_asio.reference.Protocol Protocol]``,
+      typename ``[link boost_asio.reference.SocketService1 SocketService1]``,
+      typename ``[link boost_asio.reference.SocketService2 SocketService2]``>
+  void connect_pair(
+      basic_socket< Protocol, SocketService1 > & socket1,
+      basic_socket< Protocol, SocketService2 > & socket2);
 
 
 
@@ -31820,120 +33033,200 @@
 
 
 
-[section:overload3 read (3 of 6 overloads)]
+[section:overload2 local::connect_pair (2 of 2 overloads)]
 
-Attempt to read a certain amount of data from a stream before returning. 
+Create a pair of connected sockets. 
 
   template<
-      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
-      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``,
-      typename CompletionCondition>
-  std::size_t read(
-      SyncReadStream & s,
-      const MutableBufferSequence & buffers,
-      CompletionCondition completion_condition,
+      typename ``[link boost_asio.reference.Protocol Protocol]``,
+      typename ``[link boost_asio.reference.SocketService1 SocketService1]``,
+      typename ``[link boost_asio.reference.SocketService2 SocketService2]``>
+  boost::system::error_code connect_pair(
+      basic_socket< Protocol, SocketService1 > & socket1,
+      basic_socket< Protocol, SocketService2 > & socket2,
       boost::system::error_code & ec);
 
 
-This function is used to read a certain number of bytes of data from a stream. The call will block until one of the following conditions is true:
 
+[endsect]
 
-* The supplied buffers are full. That is, the bytes transferred is equal to the sum of the buffer sizes.
 
-* The completion_condition function object returns true.
+[endsect]
 
-This operation is implemented in terms of one or more calls to the stream's read\_some function.
+[section:local__datagram_protocol local::datagram_protocol]
 
+Encapsulates the flags needed for datagram-oriented UNIX sockets. 
 
-[heading Parameters]
-    
+  class datagram_protocol
 
-[variablelist
-  
-[[s][The stream from which the data is to be read. The type must support the SyncReadStream concept.]]
 
-[[buffers][One or more buffers into which the data will be read. The sum of the buffer sizes indicates the maximum number of bytes to read from the stream.]]
+[heading Types]
+[table
+  [[Name][Description]]
 
-[[completion_condition][The function object to be called to determine whether the read operation is complete. The signature of the function object must be: 
-``
-   bool completion_condition(
-     const boost::system::error_code& error, // Result of latest read_some
-                                             // operation.
+  [
 
-     std::size_t bytes_transferred           // Number of bytes transferred
-                                             // so far.
-   ); 
+    [[link boost_asio.reference.local__datagram_protocol.endpoint [*endpoint]]]
+    [The type of a UNIX domain endpoint. ]
+  
+  ]
 
-``
-A return value of true indicates that the read operation is complete. False indicates that further calls to the stream's read\_some function are required.]]
+  [
 
-[[ec][Set to indicate what error occurred, if any.]]
+    [[link boost_asio.reference.local__datagram_protocol.socket [*socket]]]
+    [The UNIX domain socket type. ]
+  
+  ]
 
 ]
 
-[heading Return Value]
-      
-The number of bytes read. If an error occurs, returns the total number of bytes successfully transferred prior to the error. 
+[heading Member Functions]
+[table
+  [[Name][Description]]
 
+  [
+    [[link boost_asio.reference.local__datagram_protocol.family [*family]]]
+    [Obtain an identifier for the protocol family. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.local__datagram_protocol.protocol [*protocol]]]
+    [Obtain an identifier for the protocol. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.local__datagram_protocol.type [*type]]]
+    [Obtain an identifier for the type of the protocol. ]
+  ]
+  
+]
 
+The 
+[link boost_asio.reference.local__datagram_protocol local::datagram_protocol] class contains flags necessary for datagram-oriented UNIX domain sockets.
 
-[endsect]
 
+[heading Thread Safety]
+  
+[*Distinct] [*objects:]  Safe.
 
+[*Shared] [*objects:]  Safe.
 
-[section:overload4 read (4 of 6 overloads)]
 
-Attempt to read a certain amount of data from a stream before returning. 
 
-  template<
-      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
-      typename Allocator>
-  std::size_t read(
-      SyncReadStream & s,
-      basic_streambuf< Allocator > & b);
+[section:endpoint local::datagram_protocol::endpoint]
 
+The type of a UNIX domain endpoint. 
 
-This function is used to read a certain number of bytes of data from a stream. The call will block until one of the following conditions is true:
+  typedef basic_endpoint< datagram_protocol > endpoint;
 
 
-* An error occurred.
+[heading Types]
+[table
+  [[Name][Description]]
 
-This operation is implemented in terms of one or more calls to the stream's read\_some function.
+  [
 
+    [[link boost_asio.reference.local__basic_endpoint.data_type [*data_type]]]
+    [The type of the endpoint structure. This type is dependent on the underlying implementation of the socket layer. ]
+  
+  ]
 
-[heading Parameters]
-    
+  [
 
-[variablelist
+    [[link boost_asio.reference.local__basic_endpoint.protocol_type [*protocol_type]]]
+    [The protocol type associated with the endpoint. ]
   
-[[s][The stream from which the data is to be read. The type must support the SyncReadStream concept.]]
-
-[[b][The basic\_streambuf object into which the data will be read.]]
+  ]
 
 ]
 
-[heading Return Value]
-      
-The number of bytes transferred.
+[heading Member Functions]
+[table
+  [[Name][Description]]
 
-[heading Exceptions]
-    
+  [
+    [[link boost_asio.reference.local__basic_endpoint.basic_endpoint [*basic_endpoint]]]
+    [Default constructor. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.local__basic_endpoint.capacity [*capacity]]]
+    [Get the capacity of the endpoint in the native type. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.local__basic_endpoint.data [*data]]]
+    [Get the underlying endpoint in the native type. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.local__basic_endpoint.operator_eq_ [*operator=]]]
+    [Assign from another endpoint. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.local__basic_endpoint.path [*path]]]
+    [Get the path associated with the endpoint. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.local__basic_endpoint.protocol [*protocol]]]
+    [The protocol associated with the endpoint. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.local__basic_endpoint.resize [*resize]]]
+    [Set the underlying size of the endpoint in the native type. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.local__basic_endpoint.size [*size]]]
+    [Get the underlying size of the endpoint in the native type. ]
+  ]
+  
+]
 
-[variablelist
+[heading Friends]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.local__basic_endpoint.operator_not__eq_ [*operator!=]]]
+    [Compare two endpoints for inequality. ]
+  ]
   
-[[boost::system::system_error][Thrown on failure.]]
+  [
+    [[link boost_asio.reference.local__basic_endpoint.operator_lt_ [*operator<]]]
+    [Compare endpoints for ordering. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.local__basic_endpoint.operator_eq__eq_ [*operator==]]]
+    [Compare two endpoints for equality. ]
+  ]
+  
+]
+
+[heading Related Functions]
+[table
+  [[Name][Description]]
 
+  [
+    [[link boost_asio.reference.local__basic_endpoint.operator_lt__lt_ [*operator<<]]]
+    [Output an endpoint as a string. ]
+  ]
+  
 ]
 
-[heading Remarks]
-      
-This overload is equivalent to calling: 
+The 
+[link boost_asio.reference.local__basic_endpoint local::basic_endpoint] class template describes an endpoint that may be associated with a particular UNIX socket.
 
-   boost::asio::read(
-       s, b,
-       boost::asio::transfer_all()); 
 
+[heading Thread Safety]
+  
+[*Distinct] [*objects:]  Safe.
 
+[*Shared] [*objects:]  Unsafe.
 
 
 
@@ -31942,297 +33235,6732 @@
 
 
 
-[section:overload5 read (5 of 6 overloads)]
+[section:family local::datagram_protocol::family]
 
-Attempt to read a certain amount of data from a stream before returning. 
+Obtain an identifier for the protocol family. 
 
-  template<
-      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
-      typename Allocator,
-      typename CompletionCondition>
-  std::size_t read(
-      SyncReadStream & s,
-      basic_streambuf< Allocator > & b,
-      CompletionCondition completion_condition);
+  int family() const;
 
 
-This function is used to read a certain number of bytes of data from a stream. The call will block until one of the following conditions is true:
 
+[endsect]
 
-* The completion_condition function object returns true.
 
-This operation is implemented in terms of one or more calls to the stream's read\_some function.
 
+[section:protocol local::datagram_protocol::protocol]
 
-[heading Parameters]
-    
+Obtain an identifier for the protocol. 
 
-[variablelist
-  
-[[s][The stream from which the data is to be read. The type must support the SyncReadStream concept.]]
+  int protocol() const;
 
-[[b][The basic\_streambuf object into which the data will be read.]]
 
-[[completion_condition][The function object to be called to determine whether the read operation is complete. The signature of the function object must be: 
-``
-   bool completion_condition(
-     const boost::system::error_code& error, // Result of latest read_some
-                                             // operation.
 
-     std::size_t bytes_transferred           // Number of bytes transferred
-                                             // so far.
-   ); 
+[endsect]
 
-``
-A return value of true indicates that the read operation is complete. False indicates that further calls to the stream's read\_some function are required.]]
+
+
+[section:socket local::datagram_protocol::socket]
+
+The UNIX domain socket type. 
+
+  typedef basic_datagram_socket< datagram_protocol > socket;
+
+
+[heading Types]
+[table
+  [[Name][Description]]
+
+  [
+
+    [[link boost_asio.reference.basic_datagram_socket.broadcast [*broadcast]]]
+    [Socket option to permit sending of broadcast messages. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_datagram_socket.bytes_readable [*bytes_readable]]]
+    [IO control command to get the amount of data that can be read without blocking. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_datagram_socket.debug [*debug]]]
+    [Socket option to enable socket-level debugging. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_datagram_socket.do_not_route [*do_not_route]]]
+    [Socket option to prevent routing, use local interfaces only. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_datagram_socket.enable_connection_aborted [*enable_connection_aborted]]]
+    [Socket option to report aborted connections on accept. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_datagram_socket.endpoint_type [*endpoint_type]]]
+    [The endpoint type. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_datagram_socket.implementation_type [*implementation_type]]]
+    [The underlying implementation type of I/O object. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_datagram_socket.keep_alive [*keep_alive]]]
+    [Socket option to send keep-alives. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_datagram_socket.linger [*linger]]]
+    [Socket option to specify whether the socket lingers on close if unsent data is present. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_datagram_socket.lowest_layer_type [*lowest_layer_type]]]
+    [A basic_socket is always the lowest layer. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_datagram_socket.message_flags [*message_flags]]]
+    [Bitmask type for flags that can be passed to send and receive operations. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_datagram_socket.native_type [*native_type]]]
+    [The native representation of a socket. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_datagram_socket.non_blocking_io [*non_blocking_io]]]
+    [IO control command to set the blocking mode of the socket. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_datagram_socket.protocol_type [*protocol_type]]]
+    [The protocol type. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_datagram_socket.receive_buffer_size [*receive_buffer_size]]]
+    [Socket option for the receive buffer size of a socket. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_datagram_socket.receive_low_watermark [*receive_low_watermark]]]
+    [Socket option for the receive low watermark. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_datagram_socket.reuse_address [*reuse_address]]]
+    [Socket option to allow the socket to be bound to an address that is already in use. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_datagram_socket.send_buffer_size [*send_buffer_size]]]
+    [Socket option for the send buffer size of a socket. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_datagram_socket.send_low_watermark [*send_low_watermark]]]
+    [Socket option for the send low watermark. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_datagram_socket.service_type [*service_type]]]
+    [The type of the service that will be used to provide I/O operations. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_datagram_socket.shutdown_type [*shutdown_type]]]
+    [Different ways a socket may be shutdown. ]
+  
+  ]
 
 ]
 
-[heading Return Value]
-      
-The number of bytes transferred.
+[heading Member Functions]
+[table
+  [[Name][Description]]
 
-[heading Exceptions]
-    
+  [
+    [[link boost_asio.reference.basic_datagram_socket.assign [*assign]]]
+    [Assign an existing native socket to the socket. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_datagram_socket.async_connect [*async_connect]]]
+    [Start an asynchronous connect. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_datagram_socket.async_receive [*async_receive]]]
+    [Start an asynchronous receive on a connected socket. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_datagram_socket.async_receive_from [*async_receive_from]]]
+    [Start an asynchronous receive. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_datagram_socket.async_send [*async_send]]]
+    [Start an asynchronous send on a connected socket. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_datagram_socket.async_send_to [*async_send_to]]]
+    [Start an asynchronous send. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_datagram_socket.at_mark [*at_mark]]]
+    [Determine whether the socket is at the out-of-band data mark. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_datagram_socket.available [*available]]]
+    [Determine the number of bytes available for reading. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_datagram_socket.basic_datagram_socket [*basic_datagram_socket]]]
+    [Construct a basic_datagram_socket without opening it. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_datagram_socket.bind [*bind]]]
+    [Bind the socket to the given local endpoint. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_datagram_socket.cancel [*cancel]]]
+    [Cancel all asynchronous operations associated with the socket. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_datagram_socket.close [*close]]]
+    [Close the socket. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_datagram_socket.connect [*connect]]]
+    [Connect the socket to the specified endpoint. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_datagram_socket.get_io_service [*get_io_service]]]
+    [Get the io_service associated with the object. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_datagram_socket.get_option [*get_option]]]
+    [Get an option from the socket. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_datagram_socket.io_control [*io_control]]]
+    [Perform an IO control command on the socket. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_datagram_socket.io_service [*io_service]]]
+    [(Deprecated: use get_io_service().) Get the io_service associated with the object. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_datagram_socket.is_open [*is_open]]]
+    [Determine whether the socket is open. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_datagram_socket.local_endpoint [*local_endpoint]]]
+    [Get the local endpoint of the socket. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_datagram_socket.lowest_layer [*lowest_layer]]]
+    [Get a reference to the lowest layer. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_datagram_socket.native [*native]]]
+    [Get the native socket representation. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_datagram_socket.open [*open]]]
+    [Open the socket using the specified protocol. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_datagram_socket.receive [*receive]]]
+    [Receive some data on a connected socket. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_datagram_socket.receive_from [*receive_from]]]
+    [Receive a datagram with the endpoint of the sender. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_datagram_socket.remote_endpoint [*remote_endpoint]]]
+    [Get the remote endpoint of the socket. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_datagram_socket.send [*send]]]
+    [Send some data on a connected socket. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_datagram_socket.send_to [*send_to]]]
+    [Send a datagram to the specified endpoint. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_datagram_socket.set_option [*set_option]]]
+    [Set an option on the socket. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_datagram_socket.shutdown [*shutdown]]]
+    [Disable sends or receives on the socket. ]
+  ]
+  
+]
 
-[variablelist
+[heading Data Members]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.basic_datagram_socket.max_connections [*max_connections]]]
+    [The maximum length of the queue of pending incoming connections. ]
+  ]
+
+  [
+    [[link boost_asio.reference.basic_datagram_socket.message_do_not_route [*message_do_not_route]]]
+    [Specify that the data should not be subject to routing. ]
+  ]
+
+  [
+    [[link boost_asio.reference.basic_datagram_socket.message_out_of_band [*message_out_of_band]]]
+    [Process out-of-band data. ]
+  ]
+
+  [
+    [[link boost_asio.reference.basic_datagram_socket.message_peek [*message_peek]]]
+    [Peek at incoming data without removing it from the input queue. ]
+  ]
+
+]
+
+[heading Protected Data Members]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.basic_datagram_socket.implementation [*implementation]]]
+    [The underlying implementation of the I/O object. ]
+  ]
+
+  [
+    [[link boost_asio.reference.basic_datagram_socket.service [*service]]]
+    [The service associated with the I/O object. ]
+  ]
+
+]
+
+The basic_datagram_socket class template provides asynchronous and blocking datagram-oriented socket functionality.
+
+
+[heading Thread Safety]
   
-[[boost::system::system_error][Thrown on failure. ]]
+[*Distinct] [*objects:]  Safe.
+
+[*Shared] [*objects:]  Unsafe. 
+
+
+
+
+[endsect]
+
+
+
+[section:type local::datagram_protocol::type]
+
+Obtain an identifier for the type of the protocol. 
+
+  int type() const;
+
+
+
+[endsect]
+
+
+
+[endsect]
+
+[section:local__stream_protocol local::stream_protocol]
+
+Encapsulates the flags needed for stream-oriented UNIX sockets. 
+
+  class stream_protocol
+
+
+[heading Types]
+[table
+  [[Name][Description]]
+
+  [
+
+    [[link boost_asio.reference.local__stream_protocol.acceptor [*acceptor]]]
+    [The UNIX domain acceptor type. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.local__stream_protocol.endpoint [*endpoint]]]
+    [The type of a UNIX domain endpoint. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.local__stream_protocol.iostream [*iostream]]]
+    [The UNIX domain iostream type. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.local__stream_protocol.socket [*socket]]]
+    [The UNIX domain socket type. ]
+  
+  ]
+
+]
 
+[heading Member Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.local__stream_protocol.family [*family]]]
+    [Obtain an identifier for the protocol family. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.local__stream_protocol.protocol [*protocol]]]
+    [Obtain an identifier for the protocol. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.local__stream_protocol.type [*type]]]
+    [Obtain an identifier for the type of the protocol. ]
+  ]
+  
 ]
 
+The 
+[link boost_asio.reference.local__stream_protocol local::stream_protocol] class contains flags necessary for stream-oriented UNIX domain sockets.
+
+
+[heading Thread Safety]
+  
+[*Distinct] [*objects:]  Safe.
+
+[*Shared] [*objects:]  Safe.
+
+
+
+[section:acceptor local::stream_protocol::acceptor]
+
+The UNIX domain acceptor type. 
+
+  typedef basic_socket_acceptor< stream_protocol > acceptor;
+
+
+[heading Types]
+[table
+  [[Name][Description]]
+
+  [
+
+    [[link boost_asio.reference.basic_socket_acceptor.broadcast [*broadcast]]]
+    [Socket option to permit sending of broadcast messages. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_socket_acceptor.bytes_readable [*bytes_readable]]]
+    [IO control command to get the amount of data that can be read without blocking. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_socket_acceptor.debug [*debug]]]
+    [Socket option to enable socket-level debugging. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_socket_acceptor.do_not_route [*do_not_route]]]
+    [Socket option to prevent routing, use local interfaces only. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_socket_acceptor.enable_connection_aborted [*enable_connection_aborted]]]
+    [Socket option to report aborted connections on accept. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_socket_acceptor.endpoint_type [*endpoint_type]]]
+    [The endpoint type. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_socket_acceptor.implementation_type [*implementation_type]]]
+    [The underlying implementation type of I/O object. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_socket_acceptor.keep_alive [*keep_alive]]]
+    [Socket option to send keep-alives. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_socket_acceptor.linger [*linger]]]
+    [Socket option to specify whether the socket lingers on close if unsent data is present. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_socket_acceptor.message_flags [*message_flags]]]
+    [Bitmask type for flags that can be passed to send and receive operations. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_socket_acceptor.native_type [*native_type]]]
+    [The native representation of an acceptor. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_socket_acceptor.non_blocking_io [*non_blocking_io]]]
+    [IO control command to set the blocking mode of the socket. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_socket_acceptor.protocol_type [*protocol_type]]]
+    [The protocol type. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_socket_acceptor.receive_buffer_size [*receive_buffer_size]]]
+    [Socket option for the receive buffer size of a socket. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_socket_acceptor.receive_low_watermark [*receive_low_watermark]]]
+    [Socket option for the receive low watermark. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_socket_acceptor.reuse_address [*reuse_address]]]
+    [Socket option to allow the socket to be bound to an address that is already in use. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_socket_acceptor.send_buffer_size [*send_buffer_size]]]
+    [Socket option for the send buffer size of a socket. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_socket_acceptor.send_low_watermark [*send_low_watermark]]]
+    [Socket option for the send low watermark. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_socket_acceptor.service_type [*service_type]]]
+    [The type of the service that will be used to provide I/O operations. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_socket_acceptor.shutdown_type [*shutdown_type]]]
+    [Different ways a socket may be shutdown. ]
+  
+  ]
+
+]
+
+[heading Member Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.basic_socket_acceptor.accept [*accept]]]
+    [Accept a new connection. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_socket_acceptor.assign [*assign]]]
+    [Assigns an existing native acceptor to the acceptor. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_socket_acceptor.async_accept [*async_accept]]]
+    [Start an asynchronous accept. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_socket_acceptor.basic_socket_acceptor [*basic_socket_acceptor]]]
+    [Construct an acceptor without opening it. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_socket_acceptor.bind [*bind]]]
+    [Bind the acceptor to the given local endpoint. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_socket_acceptor.cancel [*cancel]]]
+    [Cancel all asynchronous operations associated with the acceptor. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_socket_acceptor.close [*close]]]
+    [Close the acceptor. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_socket_acceptor.get_io_service [*get_io_service]]]
+    [Get the io_service associated with the object. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_socket_acceptor.get_option [*get_option]]]
+    [Get an option from the acceptor. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_socket_acceptor.io_service [*io_service]]]
+    [(Deprecated: use get_io_service().) Get the io_service associated with the object. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_socket_acceptor.is_open [*is_open]]]
+    [Determine whether the acceptor is open. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_socket_acceptor.listen [*listen]]]
+    [Place the acceptor into the state where it will listen for new connections. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_socket_acceptor.local_endpoint [*local_endpoint]]]
+    [Get the local endpoint of the acceptor. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_socket_acceptor.native [*native]]]
+    [Get the native acceptor representation. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_socket_acceptor.open [*open]]]
+    [Open the acceptor using the specified protocol. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_socket_acceptor.set_option [*set_option]]]
+    [Set an option on the acceptor. ]
+  ]
+  
+]
+
+[heading Data Members]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.basic_socket_acceptor.max_connections [*max_connections]]]
+    [The maximum length of the queue of pending incoming connections. ]
+  ]
+
+  [
+    [[link boost_asio.reference.basic_socket_acceptor.message_do_not_route [*message_do_not_route]]]
+    [Specify that the data should not be subject to routing. ]
+  ]
+
+  [
+    [[link boost_asio.reference.basic_socket_acceptor.message_out_of_band [*message_out_of_band]]]
+    [Process out-of-band data. ]
+  ]
+
+  [
+    [[link boost_asio.reference.basic_socket_acceptor.message_peek [*message_peek]]]
+    [Peek at incoming data without removing it from the input queue. ]
+  ]
+
+]
+
+[heading Protected Data Members]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.basic_socket_acceptor.implementation [*implementation]]]
+    [The underlying implementation of the I/O object. ]
+  ]
+
+  [
+    [[link boost_asio.reference.basic_socket_acceptor.service [*service]]]
+    [The service associated with the I/O object. ]
+  ]
+
+]
+
+The basic_socket_acceptor class template is used for accepting new socket connections.
+
+
+[heading Thread Safety]
+  
+[*Distinct] [*objects:]  Safe.
+
+[*Shared] [*objects:]  Unsafe.
+
+[heading Example]
+  
+Opening a socket acceptor with the SO\_REUSEADDR option enabled: 
+
+   boost::asio::ip::tcp::acceptor acceptor(io_service);
+   boost::asio::ip::tcp::endpoint endpoint(boost::asio::ip::tcp::v4(), port);
+   acceptor.open(endpoint.protocol());
+   acceptor.set_option(boost::asio::ip::tcp::acceptor::reuse_address(true));
+   acceptor.bind(endpoint);
+   acceptor.listen();
+
+
+
+
+
+
+
+[endsect]
+
+
+
+[section:endpoint local::stream_protocol::endpoint]
+
+The type of a UNIX domain endpoint. 
+
+  typedef basic_endpoint< stream_protocol > endpoint;
+
+
+[heading Types]
+[table
+  [[Name][Description]]
+
+  [
+
+    [[link boost_asio.reference.local__basic_endpoint.data_type [*data_type]]]
+    [The type of the endpoint structure. This type is dependent on the underlying implementation of the socket layer. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.local__basic_endpoint.protocol_type [*protocol_type]]]
+    [The protocol type associated with the endpoint. ]
+  
+  ]
+
+]
+
+[heading Member Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.local__basic_endpoint.basic_endpoint [*basic_endpoint]]]
+    [Default constructor. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.local__basic_endpoint.capacity [*capacity]]]
+    [Get the capacity of the endpoint in the native type. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.local__basic_endpoint.data [*data]]]
+    [Get the underlying endpoint in the native type. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.local__basic_endpoint.operator_eq_ [*operator=]]]
+    [Assign from another endpoint. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.local__basic_endpoint.path [*path]]]
+    [Get the path associated with the endpoint. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.local__basic_endpoint.protocol [*protocol]]]
+    [The protocol associated with the endpoint. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.local__basic_endpoint.resize [*resize]]]
+    [Set the underlying size of the endpoint in the native type. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.local__basic_endpoint.size [*size]]]
+    [Get the underlying size of the endpoint in the native type. ]
+  ]
+  
+]
+
+[heading Friends]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.local__basic_endpoint.operator_not__eq_ [*operator!=]]]
+    [Compare two endpoints for inequality. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.local__basic_endpoint.operator_lt_ [*operator<]]]
+    [Compare endpoints for ordering. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.local__basic_endpoint.operator_eq__eq_ [*operator==]]]
+    [Compare two endpoints for equality. ]
+  ]
+  
+]
+
+[heading Related Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.local__basic_endpoint.operator_lt__lt_ [*operator<<]]]
+    [Output an endpoint as a string. ]
+  ]
+  
+]
+
+The 
+[link boost_asio.reference.local__basic_endpoint local::basic_endpoint] class template describes an endpoint that may be associated with a particular UNIX socket.
+
+
+[heading Thread Safety]
+  
+[*Distinct] [*objects:]  Safe.
+
+[*Shared] [*objects:]  Unsafe.
+
+
+
+
+[endsect]
+
+
+
+[section:family local::stream_protocol::family]
+
+Obtain an identifier for the protocol family. 
+
+  int family() const;
+
+
+
+[endsect]
+
+
+
+[section:iostream local::stream_protocol::iostream]
+
+The UNIX domain iostream type. 
+
+  typedef basic_socket_iostream< stream_protocol > iostream;
+
+
+[heading Member Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.basic_socket_iostream.basic_socket_iostream [*basic_socket_iostream]]]
+    [Construct a basic_socket_iostream without establishing a connection. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_socket_iostream.close [*close]]]
+    [Close the connection. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_socket_iostream.connect [*connect]]]
+    [Establish a connection to an endpoint corresponding to a resolver query. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_socket_iostream.rdbuf [*rdbuf]]]
+    [Return a pointer to the underlying streambuf. ]
+  ]
+  
+]
+
+
+
+[endsect]
+
+
+
+[section:protocol local::stream_protocol::protocol]
+
+Obtain an identifier for the protocol. 
+
+  int protocol() const;
+
+
+
+[endsect]
+
+
+
+[section:socket local::stream_protocol::socket]
+
+The UNIX domain socket type. 
+
+  typedef basic_stream_socket< stream_protocol > socket;
+
+
+[heading Types]
+[table
+  [[Name][Description]]
+
+  [
+
+    [[link boost_asio.reference.basic_stream_socket.broadcast [*broadcast]]]
+    [Socket option to permit sending of broadcast messages. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_stream_socket.bytes_readable [*bytes_readable]]]
+    [IO control command to get the amount of data that can be read without blocking. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_stream_socket.debug [*debug]]]
+    [Socket option to enable socket-level debugging. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_stream_socket.do_not_route [*do_not_route]]]
+    [Socket option to prevent routing, use local interfaces only. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_stream_socket.enable_connection_aborted [*enable_connection_aborted]]]
+    [Socket option to report aborted connections on accept. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_stream_socket.endpoint_type [*endpoint_type]]]
+    [The endpoint type. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_stream_socket.implementation_type [*implementation_type]]]
+    [The underlying implementation type of I/O object. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_stream_socket.keep_alive [*keep_alive]]]
+    [Socket option to send keep-alives. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_stream_socket.linger [*linger]]]
+    [Socket option to specify whether the socket lingers on close if unsent data is present. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_stream_socket.lowest_layer_type [*lowest_layer_type]]]
+    [A basic_socket is always the lowest layer. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_stream_socket.message_flags [*message_flags]]]
+    [Bitmask type for flags that can be passed to send and receive operations. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_stream_socket.native_type [*native_type]]]
+    [The native representation of a socket. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_stream_socket.non_blocking_io [*non_blocking_io]]]
+    [IO control command to set the blocking mode of the socket. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_stream_socket.protocol_type [*protocol_type]]]
+    [The protocol type. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_stream_socket.receive_buffer_size [*receive_buffer_size]]]
+    [Socket option for the receive buffer size of a socket. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_stream_socket.receive_low_watermark [*receive_low_watermark]]]
+    [Socket option for the receive low watermark. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_stream_socket.reuse_address [*reuse_address]]]
+    [Socket option to allow the socket to be bound to an address that is already in use. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_stream_socket.send_buffer_size [*send_buffer_size]]]
+    [Socket option for the send buffer size of a socket. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_stream_socket.send_low_watermark [*send_low_watermark]]]
+    [Socket option for the send low watermark. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_stream_socket.service_type [*service_type]]]
+    [The type of the service that will be used to provide I/O operations. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.basic_stream_socket.shutdown_type [*shutdown_type]]]
+    [Different ways a socket may be shutdown. ]
+  
+  ]
+
+]
+
+[heading Member Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.basic_stream_socket.assign [*assign]]]
+    [Assign an existing native socket to the socket. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_stream_socket.async_connect [*async_connect]]]
+    [Start an asynchronous connect. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_stream_socket.async_read_some [*async_read_some]]]
+    [Start an asynchronous read. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_stream_socket.async_receive [*async_receive]]]
+    [Start an asynchronous receive. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_stream_socket.async_send [*async_send]]]
+    [Start an asynchronous send. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_stream_socket.async_write_some [*async_write_some]]]
+    [Start an asynchronous write. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_stream_socket.at_mark [*at_mark]]]
+    [Determine whether the socket is at the out-of-band data mark. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_stream_socket.available [*available]]]
+    [Determine the number of bytes available for reading. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_stream_socket.basic_stream_socket [*basic_stream_socket]]]
+    [Construct a basic_stream_socket without opening it. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_stream_socket.bind [*bind]]]
+    [Bind the socket to the given local endpoint. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_stream_socket.cancel [*cancel]]]
+    [Cancel all asynchronous operations associated with the socket. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_stream_socket.close [*close]]]
+    [Close the socket. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_stream_socket.connect [*connect]]]
+    [Connect the socket to the specified endpoint. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_stream_socket.get_io_service [*get_io_service]]]
+    [Get the io_service associated with the object. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_stream_socket.get_option [*get_option]]]
+    [Get an option from the socket. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_stream_socket.io_control [*io_control]]]
+    [Perform an IO control command on the socket. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_stream_socket.io_service [*io_service]]]
+    [(Deprecated: use get_io_service().) Get the io_service associated with the object. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_stream_socket.is_open [*is_open]]]
+    [Determine whether the socket is open. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_stream_socket.local_endpoint [*local_endpoint]]]
+    [Get the local endpoint of the socket. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_stream_socket.lowest_layer [*lowest_layer]]]
+    [Get a reference to the lowest layer. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_stream_socket.native [*native]]]
+    [Get the native socket representation. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_stream_socket.open [*open]]]
+    [Open the socket using the specified protocol. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_stream_socket.read_some [*read_some]]]
+    [Read some data from the socket. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_stream_socket.receive [*receive]]]
+    [Receive some data on the socket. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_stream_socket.remote_endpoint [*remote_endpoint]]]
+    [Get the remote endpoint of the socket. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_stream_socket.send [*send]]]
+    [Send some data on the socket. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_stream_socket.set_option [*set_option]]]
+    [Set an option on the socket. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_stream_socket.shutdown [*shutdown]]]
+    [Disable sends or receives on the socket. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_stream_socket.write_some [*write_some]]]
+    [Write some data to the socket. ]
+  ]
+  
+]
+
+[heading Data Members]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.basic_stream_socket.max_connections [*max_connections]]]
+    [The maximum length of the queue of pending incoming connections. ]
+  ]
+
+  [
+    [[link boost_asio.reference.basic_stream_socket.message_do_not_route [*message_do_not_route]]]
+    [Specify that the data should not be subject to routing. ]
+  ]
+
+  [
+    [[link boost_asio.reference.basic_stream_socket.message_out_of_band [*message_out_of_band]]]
+    [Process out-of-band data. ]
+  ]
+
+  [
+    [[link boost_asio.reference.basic_stream_socket.message_peek [*message_peek]]]
+    [Peek at incoming data without removing it from the input queue. ]
+  ]
+
+]
+
+[heading Protected Data Members]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.basic_stream_socket.implementation [*implementation]]]
+    [The underlying implementation of the I/O object. ]
+  ]
+
+  [
+    [[link boost_asio.reference.basic_stream_socket.service [*service]]]
+    [The service associated with the I/O object. ]
+  ]
+
+]
+
+The basic_stream_socket class template provides asynchronous and blocking stream-oriented socket functionality.
+
+
+[heading Thread Safety]
+  
+[*Distinct] [*objects:]  Safe.
+
+[*Shared] [*objects:]  Unsafe.
+
+
+
+
+[endsect]
+
+
+
+[section:type local::stream_protocol::type]
+
+Obtain an identifier for the type of the protocol. 
+
+  int type() const;
+
+
+
+[endsect]
+
+
+
+[endsect]
+
+[section:mutable_buffer mutable_buffer]
+
+Holds a buffer that can be modified. 
+
+  class mutable_buffer
+
+
+[heading Member Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.mutable_buffer.mutable_buffer [*mutable_buffer]]]
+    [Construct an empty buffer. ]
+  ]
+  
+]
+
+[heading Related Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.mutable_buffer.buffer_cast [*buffer_cast]]]
+    [Cast a non-modifiable buffer to a specified pointer to POD type. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.mutable_buffer.buffer_size [*buffer_size]]]
+    [Get the number of bytes in a non-modifiable buffer. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.mutable_buffer.operator_plus_ [*operator+]]]
+    [Create a new modifiable buffer that is offset from the start of another. ]
+  ]
+  
+]
+
+The mutable_buffer class provides a safe representation of a buffer that can be modified. It does not own the underlying data, and so is cheap to copy or assign. 
+
+
+[section:buffer_cast mutable_buffer::buffer_cast]
+
+Cast a non-modifiable buffer to a specified pointer to POD type. 
+
+  template<
+      typename ``[link boost_asio.reference.PointerToPodType PointerToPodType]``>
+  PointerToPodType buffer_cast(
+      const mutable_buffer & b);
+
+
+
+[endsect]
+
+
+
+[section:buffer_size mutable_buffer::buffer_size]
+
+Get the number of bytes in a non-modifiable buffer. 
+
+  std::size_t buffer_size(
+      const mutable_buffer & b);
+
+
+
+[endsect]
+
+
+[section:mutable_buffer mutable_buffer::mutable_buffer]
+
+Construct an empty buffer. 
+
+  ``[link boost_asio.reference.mutable_buffer.mutable_buffer.overload1 mutable_buffer]``();
+
+  ``[link boost_asio.reference.mutable_buffer.mutable_buffer.overload2 mutable_buffer]``(
+      void * data,
+      std::size_t size);
+
+
+[section:overload1 mutable_buffer::mutable_buffer (1 of 2 overloads)]
+
+Construct an empty buffer. 
+
+  mutable_buffer();
+
+
+
+[endsect]
+
+
+
+[section:overload2 mutable_buffer::mutable_buffer (2 of 2 overloads)]
+
+Construct a buffer to represent a given memory range. 
+
+  mutable_buffer(
+      void * data,
+      std::size_t size);
+
+
+
+[endsect]
+
+
+[endsect]
+
+[section:operator_plus_ mutable_buffer::operator+]
+
+Create a new modifiable buffer that is offset from the start of another. 
+
+  mutable_buffer ``[link boost_asio.reference.mutable_buffer.operator_plus_.overload1 operator+]``(
+      const mutable_buffer & b,
+      std::size_t start);
+
+  mutable_buffer ``[link boost_asio.reference.mutable_buffer.operator_plus_.overload2 operator+]``(
+      std::size_t start,
+      const mutable_buffer & b);
+
+
+[section:overload1 mutable_buffer::operator+ (1 of 2 overloads)]
+
+Create a new modifiable buffer that is offset from the start of another. 
+
+  mutable_buffer operator+(
+      const mutable_buffer & b,
+      std::size_t start);
+
+
+
+[endsect]
+
+
+
+[section:overload2 mutable_buffer::operator+ (2 of 2 overloads)]
+
+Create a new modifiable buffer that is offset from the start of another. 
+
+  mutable_buffer operator+(
+      std::size_t start,
+      const mutable_buffer & b);
+
+
+
+[endsect]
+
+
+[endsect]
+
+
+[endsect]
+
+[section:mutable_buffers_1 mutable_buffers_1]
+
+Adapts a single modifiable buffer so that it meets the requirements of the MutableBufferSequence concept. 
+
+  class mutable_buffers_1 :
+    public mutable_buffer
+
+
+[heading Types]
+[table
+  [[Name][Description]]
+
+  [
+
+    [[link boost_asio.reference.mutable_buffers_1.const_iterator [*const_iterator]]]
+    [A random-access iterator type that may be used to read elements. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.mutable_buffers_1.value_type [*value_type]]]
+    [The type for each element in the list of buffers. ]
+  
+  ]
+
+]
+
+[heading Member Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.mutable_buffers_1.begin [*begin]]]
+    [Get a random-access iterator to the first element. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.mutable_buffers_1.end [*end]]]
+    [Get a random-access iterator for one past the last element. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.mutable_buffers_1.mutable_buffers_1 [*mutable_buffers_1]]]
+    [Construct to represent a single modifiable buffer. ]
+  ]
+  
+]
+
+[heading Related Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.mutable_buffers_1.buffer_cast [*buffer_cast]]]
+    [Cast a non-modifiable buffer to a specified pointer to POD type. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.mutable_buffers_1.buffer_size [*buffer_size]]]
+    [Get the number of bytes in a non-modifiable buffer. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.mutable_buffers_1.operator_plus_ [*operator+]]]
+    [Create a new modifiable buffer that is offset from the start of another. ]
+  ]
+  
+]
+
+
+[section:begin mutable_buffers_1::begin]
+
+Get a random-access iterator to the first element. 
+
+  const_iterator begin() const;
+
+
+
+[endsect]
+
+
+
+[section:buffer_cast mutable_buffers_1::buffer_cast]
+
+
+['Inherited from mutable_buffer.]
+
+Cast a non-modifiable buffer to a specified pointer to POD type. 
+
+  template<
+      typename ``[link boost_asio.reference.PointerToPodType PointerToPodType]``>
+  PointerToPodType buffer_cast(
+      const mutable_buffer & b);
+
+
+
+[endsect]
+
+
+
+[section:buffer_size mutable_buffers_1::buffer_size]
+
+
+['Inherited from mutable_buffer.]
+
+Get the number of bytes in a non-modifiable buffer. 
+
+  std::size_t buffer_size(
+      const mutable_buffer & b);
+
+
+
+[endsect]
+
+
+
+[section:const_iterator mutable_buffers_1::const_iterator]
+
+A random-access iterator type that may be used to read elements. 
+
+  typedef const mutable_buffer * const_iterator;
+
+
+
+
+[endsect]
+
+
+
+[section:end mutable_buffers_1::end]
+
+Get a random-access iterator for one past the last element. 
+
+  const_iterator end() const;
+
+
+
+[endsect]
+
+
+
+[section:mutable_buffers_1 mutable_buffers_1::mutable_buffers_1]
+
+Construct to represent a single modifiable buffer. 
+
+  mutable_buffers_1(
+      const mutable_buffer & b);
+
+
+
+[endsect]
+
+
+[section:operator_plus_ mutable_buffers_1::operator+]
+
+Create a new modifiable buffer that is offset from the start of another. 
+
+  mutable_buffer ``[link boost_asio.reference.mutable_buffers_1.operator_plus_.overload1 operator+]``(
+      const mutable_buffer & b,
+      std::size_t start);
+
+  mutable_buffer ``[link boost_asio.reference.mutable_buffers_1.operator_plus_.overload2 operator+]``(
+      std::size_t start,
+      const mutable_buffer & b);
+
+
+[section:overload1 mutable_buffers_1::operator+ (1 of 2 overloads)]
+
+
+['Inherited from mutable_buffer.]
+
+Create a new modifiable buffer that is offset from the start of another. 
+
+  mutable_buffer operator+(
+      const mutable_buffer & b,
+      std::size_t start);
+
+
+
+[endsect]
+
+
+
+[section:overload2 mutable_buffers_1::operator+ (2 of 2 overloads)]
+
+
+['Inherited from mutable_buffer.]
+
+Create a new modifiable buffer that is offset from the start of another. 
+
+  mutable_buffer operator+(
+      std::size_t start,
+      const mutable_buffer & b);
+
+
+
+[endsect]
+
+
+[endsect]
+
+
+[section:value_type mutable_buffers_1::value_type]
+
+The type for each element in the list of buffers. 
+
+  typedef mutable_buffer value_type;
+
+
+[heading Member Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.mutable_buffer.mutable_buffer [*mutable_buffer]]]
+    [Construct an empty buffer. ]
+  ]
+  
+]
+
+[heading Related Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.mutable_buffer.buffer_cast [*buffer_cast]]]
+    [Cast a non-modifiable buffer to a specified pointer to POD type. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.mutable_buffer.buffer_size [*buffer_size]]]
+    [Get the number of bytes in a non-modifiable buffer. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.mutable_buffer.operator_plus_ [*operator+]]]
+    [Create a new modifiable buffer that is offset from the start of another. ]
+  ]
+  
+]
+
+The mutable_buffer class provides a safe representation of a buffer that can be modified. It does not own the underlying data, and so is cheap to copy or assign. 
+
+
+
+[endsect]
+
+
+
+[endsect]
+
+[section:null_buffers null_buffers]
+
+An implementation of both the ConstBufferSequence and MutableBufferSequence concepts to represent a null buffer sequence. 
+
+  class null_buffers
+
+
+[heading Types]
+[table
+  [[Name][Description]]
+
+  [
+
+    [[link boost_asio.reference.null_buffers.const_iterator [*const_iterator]]]
+    [A random-access iterator type that may be used to read elements. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.null_buffers.value_type [*value_type]]]
+    [The type for each element in the list of buffers. ]
+  
+  ]
+
+]
+
+[heading Member Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.null_buffers.begin [*begin]]]
+    [Get a random-access iterator to the first element. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.null_buffers.end [*end]]]
+    [Get a random-access iterator for one past the last element. ]
+  ]
+  
+]
+
+
+[section:begin null_buffers::begin]
+
+Get a random-access iterator to the first element. 
+
+  const_iterator begin() const;
+
+
+
+[endsect]
+
+
+
+[section:const_iterator null_buffers::const_iterator]
+
+A random-access iterator type that may be used to read elements. 
+
+  typedef const mutable_buffer * const_iterator;
+
+
+
+
+[endsect]
+
+
+
+[section:end null_buffers::end]
+
+Get a random-access iterator for one past the last element. 
+
+  const_iterator end() const;
+
+
+
+[endsect]
+
+
+
+[section:value_type null_buffers::value_type]
+
+The type for each element in the list of buffers. 
+
+  typedef mutable_buffer value_type;
+
+
+[heading Member Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.mutable_buffer.mutable_buffer [*mutable_buffer]]]
+    [Construct an empty buffer. ]
+  ]
+  
+]
+
+[heading Related Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.mutable_buffer.buffer_cast [*buffer_cast]]]
+    [Cast a non-modifiable buffer to a specified pointer to POD type. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.mutable_buffer.buffer_size [*buffer_size]]]
+    [Get the number of bytes in a non-modifiable buffer. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.mutable_buffer.operator_plus_ [*operator+]]]
+    [Create a new modifiable buffer that is offset from the start of another. ]
+  ]
+  
+]
+
+The mutable_buffer class provides a safe representation of a buffer that can be modified. It does not own the underlying data, and so is cheap to copy or assign. 
+
+
+
+[endsect]
+
+
+
+[endsect]
+
+
+[section:placeholders__bytes_transferred placeholders::bytes_transferred]
+
+An argument placeholder, for use with boost::bind(), that corresponds to the bytes_transferred argument of a handler for asynchronous functions such as boost::asio::basic_stream_socket::async_write_some or boost::asio::async_write. 
+
+  unspecified bytes_transferred;
+
+
+
+[endsect]
+
+
+
+[section:placeholders__error placeholders::error]
+
+An argument placeholder, for use with boost::bind(), that corresponds to the error argument of a handler for any of the asynchronous functions. 
+
+  unspecified error;
+
+
+
+[endsect]
+
+
+
+[section:placeholders__iterator placeholders::iterator]
+
+An argument placeholder, for use with boost::bind(), that corresponds to the iterator argument of a handler for asynchronous functions such as boost::asio::basic_resolver::resolve. 
+
+  unspecified iterator;
+
+
+
+[endsect]
+
+
+[section:posix__basic_descriptor posix::basic_descriptor]
+
+Provides POSIX descriptor functionality. 
+
+  template<
+      typename ``[link boost_asio.reference.DescriptorService DescriptorService]``>
+  class basic_descriptor :
+    public basic_io_object< DescriptorService >,
+    public posix::descriptor_base
+
+
+[heading Types]
+[table
+  [[Name][Description]]
+
+  [
+
+    [[link boost_asio.reference.posix__basic_descriptor.bytes_readable [*bytes_readable]]]
+    [IO control command to get the amount of data that can be read without blocking. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.posix__basic_descriptor.implementation_type [*implementation_type]]]
+    [The underlying implementation type of I/O object. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.posix__basic_descriptor.lowest_layer_type [*lowest_layer_type]]]
+    [A basic_descriptor is always the lowest layer. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.posix__basic_descriptor.native_type [*native_type]]]
+    [The native representation of a descriptor. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.posix__basic_descriptor.non_blocking_io [*non_blocking_io]]]
+    [IO control command to set the blocking mode of the descriptor. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.posix__basic_descriptor.service_type [*service_type]]]
+    [The type of the service that will be used to provide I/O operations. ]
+  
+  ]
+
+]
+
+[heading Member Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.posix__basic_descriptor.assign [*assign]]]
+    [Assign an existing native descriptor to the descriptor. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_descriptor.basic_descriptor [*basic_descriptor]]]
+    [Construct a basic_descriptor without opening it. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_descriptor.cancel [*cancel]]]
+    [Cancel all asynchronous operations associated with the descriptor. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_descriptor.close [*close]]]
+    [Close the descriptor. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_descriptor.get_io_service [*get_io_service]]]
+    [Get the io_service associated with the object. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_descriptor.io_control [*io_control]]]
+    [Perform an IO control command on the descriptor. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_descriptor.io_service [*io_service]]]
+    [(Deprecated: use get_io_service().) Get the io_service associated with the object. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_descriptor.is_open [*is_open]]]
+    [Determine whether the descriptor is open. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_descriptor.lowest_layer [*lowest_layer]]]
+    [Get a reference to the lowest layer. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_descriptor.native [*native]]]
+    [Get the native descriptor representation. ]
+  ]
+  
+]
+
+[heading Protected Member Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.posix__basic_descriptor._basic_descriptor [*~basic_descriptor]]]
+    [Protected destructor to prevent deletion through this type. ]
+  ]
+  
+]
+
+[heading Protected Data Members]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.posix__basic_descriptor.implementation [*implementation]]]
+    [The underlying implementation of the I/O object. ]
+  ]
+
+  [
+    [[link boost_asio.reference.posix__basic_descriptor.service [*service]]]
+    [The service associated with the I/O object. ]
+  ]
+
+]
+
+The posix::basic_descriptor class template provides the ability to wrap a POSIX descriptor.
+
+
+[heading Thread Safety]
+  
+[*Distinct] [*objects:]  Safe.
+
+[*Shared] [*objects:]  Unsafe. 
+
+
+[section:assign posix::basic_descriptor::assign]
+
+Assign an existing native descriptor to the descriptor. 
+
+  void ``[link boost_asio.reference.posix__basic_descriptor.assign.overload1 assign]``(
+      const native_type & native_descriptor);
+
+  boost::system::error_code ``[link boost_asio.reference.posix__basic_descriptor.assign.overload2 assign]``(
+      const native_type & native_descriptor,
+      boost::system::error_code & ec);
+
+
+[section:overload1 posix::basic_descriptor::assign (1 of 2 overloads)]
+
+Assign an existing native descriptor to the descriptor. 
+
+  void assign(
+      const native_type & native_descriptor);
+
+
+
+[endsect]
+
+
+
+[section:overload2 posix::basic_descriptor::assign (2 of 2 overloads)]
+
+Assign an existing native descriptor to the descriptor. 
+
+  boost::system::error_code assign(
+      const native_type & native_descriptor,
+      boost::system::error_code & ec);
+
+
+
+[endsect]
+
+
+[endsect]
+
+[section:basic_descriptor posix::basic_descriptor::basic_descriptor]
+
+Construct a basic_descriptor without opening it. 
+
+  ``[link boost_asio.reference.posix__basic_descriptor.basic_descriptor.overload1 basic_descriptor]``(
+      boost::asio::io_service & io_service);
+
+  ``[link boost_asio.reference.posix__basic_descriptor.basic_descriptor.overload2 basic_descriptor]``(
+      boost::asio::io_service & io_service,
+      const native_type & native_descriptor);
+
+
+[section:overload1 posix::basic_descriptor::basic_descriptor (1 of 2 overloads)]
+
+Construct a basic_descriptor without opening it. 
+
+  basic_descriptor(
+      boost::asio::io_service & io_service);
+
+
+This constructor creates a descriptor without opening it.
+
+
+[heading Parameters]
+    
+
+[variablelist
+  
+[[io_service][The io\_service object that the descriptor will use to dispatch handlers for any asynchronous operations performed on the descriptor. ]]
+
+]
+
+
+
+[endsect]
+
+
+
+[section:overload2 posix::basic_descriptor::basic_descriptor (2 of 2 overloads)]
+
+Construct a basic_descriptor on an existing native descriptor. 
+
+  basic_descriptor(
+      boost::asio::io_service & io_service,
+      const native_type & native_descriptor);
+
+
+This constructor creates a descriptor object to hold an existing native descriptor.
+
+
+[heading Parameters]
+    
+
+[variablelist
+  
+[[io_service][The io\_service object that the descriptor will use to dispatch handlers for any asynchronous operations performed on the descriptor.]]
+
+[[native_descriptor][A native descriptor.]]
+
+]
+
+[heading Exceptions]
+    
+
+[variablelist
+  
+[[boost::system::system_error][Thrown on failure. ]]
+
+]
+
+
+
+[endsect]
+
+
+[endsect]
+
+
+[section:bytes_readable posix::basic_descriptor::bytes_readable]
+
+
+['Inherited from posix::descriptor_base.]
+
+IO control command to get the amount of data that can be read without blocking. 
+
+  typedef implementation_defined bytes_readable;
+
+
+
+Implements the FIONREAD IO control command.
+
+
+[heading Example]
+  
+
+
+   boost::asio::posix::stream_descriptor descriptor(io_service); 
+   ...
+   boost::asio::descriptor_base::bytes_readable command(true);
+   descriptor.io_control(command);
+   std::size_t bytes_readable = command.get();
+
+
+
+
+
+
+[endsect]
+
+
+[section:cancel posix::basic_descriptor::cancel]
+
+Cancel all asynchronous operations associated with the descriptor. 
+
+  void ``[link boost_asio.reference.posix__basic_descriptor.cancel.overload1 cancel]``();
+
+  boost::system::error_code ``[link boost_asio.reference.posix__basic_descriptor.cancel.overload2 cancel]``(
+      boost::system::error_code & ec);
+
+
+[section:overload1 posix::basic_descriptor::cancel (1 of 2 overloads)]
+
+Cancel all asynchronous operations associated with the descriptor. 
+
+  void cancel();
+
+
+This function causes all outstanding asynchronous read or write operations to finish immediately, and the handlers for cancelled operations will be passed the boost::asio::error::operation\_aborted error.
+
+
+[heading Exceptions]
+    
+
+[variablelist
+  
+[[boost::system::system_error][Thrown on failure. ]]
+
+]
+
+
+
+[endsect]
+
+
+
+[section:overload2 posix::basic_descriptor::cancel (2 of 2 overloads)]
+
+Cancel all asynchronous operations associated with the descriptor. 
+
+  boost::system::error_code cancel(
+      boost::system::error_code & ec);
+
+
+This function causes all outstanding asynchronous read or write operations to finish immediately, and the handlers for cancelled operations will be passed the boost::asio::error::operation\_aborted error.
+
+
+[heading Parameters]
+    
+
+[variablelist
+  
+[[ec][Set to indicate what error occurred, if any. ]]
+
+]
+
+
+
+[endsect]
+
+
+[endsect]
+
+[section:close posix::basic_descriptor::close]
+
+Close the descriptor. 
+
+  void ``[link boost_asio.reference.posix__basic_descriptor.close.overload1 close]``();
+
+  boost::system::error_code ``[link boost_asio.reference.posix__basic_descriptor.close.overload2 close]``(
+      boost::system::error_code & ec);
+
+
+[section:overload1 posix::basic_descriptor::close (1 of 2 overloads)]
+
+Close the descriptor. 
+
+  void close();
+
+
+This function is used to close the descriptor. Any asynchronous read or write operations will be cancelled immediately, and will complete with the boost::asio::error::operation\_aborted error.
+
+
+[heading Exceptions]
+    
+
+[variablelist
+  
+[[boost::system::system_error][Thrown on failure. ]]
+
+]
+
+
+
+[endsect]
+
+
+
+[section:overload2 posix::basic_descriptor::close (2 of 2 overloads)]
+
+Close the descriptor. 
+
+  boost::system::error_code close(
+      boost::system::error_code & ec);
+
+
+This function is used to close the descriptor. Any asynchronous read or write operations will be cancelled immediately, and will complete with the boost::asio::error::operation\_aborted error.
+
+
+[heading Parameters]
+    
+
+[variablelist
+  
+[[ec][Set to indicate what error occurred, if any. ]]
+
+]
+
+
+
+[endsect]
+
+
+[endsect]
+
+
+[section:get_io_service posix::basic_descriptor::get_io_service]
+
+
+['Inherited from basic_io_object.]
+
+Get the io_service associated with the object. 
+
+  boost::asio::io_service & get_io_service();
+
+
+This function may be used to obtain the io_service object that the I/O object uses to dispatch handlers for asynchronous operations.
+
+
+[heading Return Value]
+      
+A reference to the io_service object that the I/O object will use to dispatch handlers. Ownership is not transferred to the caller. 
+
+
+
+[endsect]
+
+
+
+[section:implementation posix::basic_descriptor::implementation]
+
+
+['Inherited from basic_io_object.]
+
+The underlying implementation of the I/O object. 
+
+  implementation_type implementation;
+
+
+
+[endsect]
+
+
+
+[section:implementation_type posix::basic_descriptor::implementation_type]
+
+
+['Inherited from basic_io_object.]
+
+The underlying implementation type of I/O object. 
+
+  typedef service_type::implementation_type implementation_type;
+
+
+
+
+[endsect]
+
+
+[section:io_control posix::basic_descriptor::io_control]
+
+Perform an IO control command on the descriptor. 
+
+  template<
+      typename ``[link boost_asio.reference.IoControlCommand IoControlCommand]``>
+  void ``[link boost_asio.reference.posix__basic_descriptor.io_control.overload1 io_control]``(
+      IoControlCommand & command);
+
+  template<
+      typename ``[link boost_asio.reference.IoControlCommand IoControlCommand]``>
+  boost::system::error_code ``[link boost_asio.reference.posix__basic_descriptor.io_control.overload2 io_control]``(
+      IoControlCommand & command,
+      boost::system::error_code & ec);
+
+
+[section:overload1 posix::basic_descriptor::io_control (1 of 2 overloads)]
+
+Perform an IO control command on the descriptor. 
+
+  template<
+      typename ``[link boost_asio.reference.IoControlCommand IoControlCommand]``>
+  void io_control(
+      IoControlCommand & command);
+
+
+This function is used to execute an IO control command on the descriptor.
+
+
+[heading Parameters]
+    
+
+[variablelist
+  
+[[command][The IO control command to be performed on the descriptor.]]
+
+]
+
+[heading Exceptions]
+    
+
+[variablelist
+  
+[[boost::system::system_error][Thrown on failure.]]
+
+]
+
+[heading Example]
+  
+Getting the number of bytes ready to read: 
+
+   boost::asio::posix::stream_descriptor descriptor(io_service);
+   ...
+   boost::asio::posix::stream_descriptor::bytes_readable command;
+   descriptor.io_control(command);
+   std::size_t bytes_readable = command.get();
+
+
+
+
+
+
+[endsect]
+
+
+
+[section:overload2 posix::basic_descriptor::io_control (2 of 2 overloads)]
+
+Perform an IO control command on the descriptor. 
+
+  template<
+      typename ``[link boost_asio.reference.IoControlCommand IoControlCommand]``>
+  boost::system::error_code io_control(
+      IoControlCommand & command,
+      boost::system::error_code & ec);
+
+
+This function is used to execute an IO control command on the descriptor.
+
+
+[heading Parameters]
+    
+
+[variablelist
+  
+[[command][The IO control command to be performed on the descriptor.]]
+
+[[ec][Set to indicate what error occurred, if any.]]
+
+]
+
+[heading Example]
+  
+Getting the number of bytes ready to read: 
+
+   boost::asio::posix::stream_descriptor descriptor(io_service);
+   ...
+   boost::asio::posix::stream_descriptor::bytes_readable command;
+   boost::system::error_code ec;
+   descriptor.io_control(command, ec);
+   if (ec)
+   {
+     // An error occurred.
+   }
+   std::size_t bytes_readable = command.get();
+
+
+
+
+
+
+[endsect]
+
+
+[endsect]
+
+
+[section:io_service posix::basic_descriptor::io_service]
+
+
+['Inherited from basic_io_object.]
+
+(Deprecated: use get_io_service().) Get the io_service associated with the object. 
+
+  boost::asio::io_service & io_service();
+
+
+This function may be used to obtain the io_service object that the I/O object uses to dispatch handlers for asynchronous operations.
+
+
+[heading Return Value]
+      
+A reference to the io_service object that the I/O object will use to dispatch handlers. Ownership is not transferred to the caller. 
+
+
+
+[endsect]
+
+
+
+[section:is_open posix::basic_descriptor::is_open]
+
+Determine whether the descriptor is open. 
+
+  bool is_open() const;
+
+
+
+[endsect]
+
+
+
+[section:lowest_layer posix::basic_descriptor::lowest_layer]
+
+Get a reference to the lowest layer. 
+
+  lowest_layer_type & lowest_layer();
+
+
+This function returns a reference to the lowest layer in a stack of layers. Since a basic_descriptor cannot contain any further layers, it simply returns a reference to itself.
+
+
+[heading Return Value]
+      
+A reference to the lowest layer in the stack of layers. Ownership is not transferred to the caller. 
+
+
+
+[endsect]
+
+
+
+[section:lowest_layer_type posix::basic_descriptor::lowest_layer_type]
+
+A basic_descriptor is always the lowest layer. 
+
+  typedef basic_descriptor< DescriptorService > lowest_layer_type;
+
+
+[heading Types]
+[table
+  [[Name][Description]]
+
+  [
+
+    [[link boost_asio.reference.posix__basic_descriptor.bytes_readable [*bytes_readable]]]
+    [IO control command to get the amount of data that can be read without blocking. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.posix__basic_descriptor.implementation_type [*implementation_type]]]
+    [The underlying implementation type of I/O object. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.posix__basic_descriptor.lowest_layer_type [*lowest_layer_type]]]
+    [A basic_descriptor is always the lowest layer. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.posix__basic_descriptor.native_type [*native_type]]]
+    [The native representation of a descriptor. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.posix__basic_descriptor.non_blocking_io [*non_blocking_io]]]
+    [IO control command to set the blocking mode of the descriptor. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.posix__basic_descriptor.service_type [*service_type]]]
+    [The type of the service that will be used to provide I/O operations. ]
+  
+  ]
+
+]
+
+[heading Member Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.posix__basic_descriptor.assign [*assign]]]
+    [Assign an existing native descriptor to the descriptor. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_descriptor.basic_descriptor [*basic_descriptor]]]
+    [Construct a basic_descriptor without opening it. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_descriptor.cancel [*cancel]]]
+    [Cancel all asynchronous operations associated with the descriptor. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_descriptor.close [*close]]]
+    [Close the descriptor. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_descriptor.get_io_service [*get_io_service]]]
+    [Get the io_service associated with the object. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_descriptor.io_control [*io_control]]]
+    [Perform an IO control command on the descriptor. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_descriptor.io_service [*io_service]]]
+    [(Deprecated: use get_io_service().) Get the io_service associated with the object. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_descriptor.is_open [*is_open]]]
+    [Determine whether the descriptor is open. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_descriptor.lowest_layer [*lowest_layer]]]
+    [Get a reference to the lowest layer. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_descriptor.native [*native]]]
+    [Get the native descriptor representation. ]
+  ]
+  
+]
+
+[heading Protected Member Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.posix__basic_descriptor._basic_descriptor [*~basic_descriptor]]]
+    [Protected destructor to prevent deletion through this type. ]
+  ]
+  
+]
+
+[heading Protected Data Members]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.posix__basic_descriptor.implementation [*implementation]]]
+    [The underlying implementation of the I/O object. ]
+  ]
+
+  [
+    [[link boost_asio.reference.posix__basic_descriptor.service [*service]]]
+    [The service associated with the I/O object. ]
+  ]
+
+]
+
+The posix::basic_descriptor class template provides the ability to wrap a POSIX descriptor.
+
+
+[heading Thread Safety]
+  
+[*Distinct] [*objects:]  Safe.
+
+[*Shared] [*objects:]  Unsafe. 
+
+
+
+
+[endsect]
+
+
+
+[section:native posix::basic_descriptor::native]
+
+Get the native descriptor representation. 
+
+  native_type native();
+
+
+This function may be used to obtain the underlying representation of the descriptor. This is intended to allow access to native descriptor functionality that is not otherwise provided. 
+
+
+[endsect]
+
+
+
+[section:native_type posix::basic_descriptor::native_type]
+
+The native representation of a descriptor. 
+
+  typedef DescriptorService::native_type native_type;
+
+
+
+
+[endsect]
+
+
+
+[section:non_blocking_io posix::basic_descriptor::non_blocking_io]
+
+
+['Inherited from posix::descriptor_base.]
+
+IO control command to set the blocking mode of the descriptor. 
+
+  typedef implementation_defined non_blocking_io;
+
+
+
+Implements the FIONBIO IO control command.
+
+
+[heading Example]
+  
+
+
+   boost::asio::posix::stream_descriptor descriptor(io_service); 
+   ...
+   boost::asio::descriptor_base::non_blocking_io command(true);
+   descriptor.io_control(command);
+
+
+
+
+
+
+[endsect]
+
+
+
+[section:service posix::basic_descriptor::service]
+
+
+['Inherited from basic_io_object.]
+
+The service associated with the I/O object. 
+
+  service_type & service;
+
+
+
+[endsect]
+
+
+
+[section:service_type posix::basic_descriptor::service_type]
+
+
+['Inherited from basic_io_object.]
+
+The type of the service that will be used to provide I/O operations. 
+
+  typedef DescriptorService service_type;
+
+
+
+
+[endsect]
+
+
+
+[section:_basic_descriptor posix::basic_descriptor::~basic_descriptor]
+
+Protected destructor to prevent deletion through this type. 
+
+  ~basic_descriptor();
+
+
+
+[endsect]
+
+
+
+[endsect]
+
+[section:posix__basic_stream_descriptor posix::basic_stream_descriptor]
+
+Provides stream-oriented descriptor functionality. 
+
+  template<
+      typename ``[link boost_asio.reference.StreamDescriptorService StreamDescriptorService]`` = stream_descriptor_service>
+  class basic_stream_descriptor :
+    public posix::basic_descriptor< StreamDescriptorService >
+
+
+[heading Types]
+[table
+  [[Name][Description]]
+
+  [
+
+    [[link boost_asio.reference.posix__basic_stream_descriptor.bytes_readable [*bytes_readable]]]
+    [IO control command to get the amount of data that can be read without blocking. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.posix__basic_stream_descriptor.implementation_type [*implementation_type]]]
+    [The underlying implementation type of I/O object. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.posix__basic_stream_descriptor.lowest_layer_type [*lowest_layer_type]]]
+    [A basic_descriptor is always the lowest layer. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.posix__basic_stream_descriptor.native_type [*native_type]]]
+    [The native representation of a descriptor. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.posix__basic_stream_descriptor.non_blocking_io [*non_blocking_io]]]
+    [IO control command to set the blocking mode of the descriptor. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.posix__basic_stream_descriptor.service_type [*service_type]]]
+    [The type of the service that will be used to provide I/O operations. ]
+  
+  ]
+
+]
+
+[heading Member Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.posix__basic_stream_descriptor.assign [*assign]]]
+    [Assign an existing native descriptor to the descriptor. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_stream_descriptor.async_read_some [*async_read_some]]]
+    [Start an asynchronous read. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_stream_descriptor.async_write_some [*async_write_some]]]
+    [Start an asynchronous write. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_stream_descriptor.basic_stream_descriptor [*basic_stream_descriptor]]]
+    [Construct a basic_stream_descriptor without opening it. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_stream_descriptor.cancel [*cancel]]]
+    [Cancel all asynchronous operations associated with the descriptor. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_stream_descriptor.close [*close]]]
+    [Close the descriptor. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_stream_descriptor.get_io_service [*get_io_service]]]
+    [Get the io_service associated with the object. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_stream_descriptor.io_control [*io_control]]]
+    [Perform an IO control command on the descriptor. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_stream_descriptor.io_service [*io_service]]]
+    [(Deprecated: use get_io_service().) Get the io_service associated with the object. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_stream_descriptor.is_open [*is_open]]]
+    [Determine whether the descriptor is open. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_stream_descriptor.lowest_layer [*lowest_layer]]]
+    [Get a reference to the lowest layer. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_stream_descriptor.native [*native]]]
+    [Get the native descriptor representation. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_stream_descriptor.read_some [*read_some]]]
+    [Read some data from the descriptor. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_stream_descriptor.write_some [*write_some]]]
+    [Write some data to the descriptor. ]
+  ]
+  
+]
+
+[heading Protected Data Members]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.posix__basic_stream_descriptor.implementation [*implementation]]]
+    [The underlying implementation of the I/O object. ]
+  ]
+
+  [
+    [[link boost_asio.reference.posix__basic_stream_descriptor.service [*service]]]
+    [The service associated with the I/O object. ]
+  ]
+
+]
+
+The posix::basic_stream_descriptor class template provides asynchronous and blocking stream-oriented descriptor functionality.
+
+
+[heading Thread Safety]
+  
+[*Distinct] [*objects:]  Safe.
+
+[*Shared] [*objects:]  Unsafe.
+
+
+[section:assign posix::basic_stream_descriptor::assign]
+
+Assign an existing native descriptor to the descriptor. 
+
+  void ``[link boost_asio.reference.posix__basic_stream_descriptor.assign.overload1 assign]``(
+      const native_type & native_descriptor);
+
+  boost::system::error_code ``[link boost_asio.reference.posix__basic_stream_descriptor.assign.overload2 assign]``(
+      const native_type & native_descriptor,
+      boost::system::error_code & ec);
+
+
+[section:overload1 posix::basic_stream_descriptor::assign (1 of 2 overloads)]
+
+
+['Inherited from posix::basic_descriptor.]
+
+Assign an existing native descriptor to the descriptor. 
+
+  void assign(
+      const native_type & native_descriptor);
+
+
+
+[endsect]
+
+
+
+[section:overload2 posix::basic_stream_descriptor::assign (2 of 2 overloads)]
+
+
+['Inherited from posix::basic_descriptor.]
+
+Assign an existing native descriptor to the descriptor. 
+
+  boost::system::error_code assign(
+      const native_type & native_descriptor,
+      boost::system::error_code & ec);
+
+
+
+[endsect]
+
+
+[endsect]
+
+
+[section:async_read_some posix::basic_stream_descriptor::async_read_some]
+
+Start an asynchronous read. 
+
+  template<
+      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``,
+      typename ``[link boost_asio.reference.ReadHandler ReadHandler]``>
+  void async_read_some(
+      const MutableBufferSequence & buffers,
+      ReadHandler handler);
+
+
+This function is used to asynchronously read data from the stream descriptor. The function call always returns immediately.
+
+
+[heading Parameters]
+    
+
+[variablelist
+  
+[[buffers][One or more buffers into which the data will be read. Although the buffers object may be copied as necessary, ownership of the underlying memory blocks is retained by the caller, which must guarantee that they remain valid until the handler is called.]]
+
+[[handler][The handler to be called when the read operation completes. Copies will be made of the handler as required. The function signature of the handler must be: 
+``
+   void handler(
+     const boost::system::error_code& error, // Result of operation.
+     std::size_t bytes_transferred           // Number of bytes read.
+   ); 
+
+``
+Regardless of whether the asynchronous operation completes immediately or not, the handler will not be invoked from within this function. Invocation of the handler will be performed in a manner equivalent to using boost::asio::io\_service::post().]]
+
+]
+
+[heading Remarks]
+      
+The read operation may not read all of the requested number of bytes. Consider using the 
+[link boost_asio.reference.async_read async_read]  function if you need to ensure that the requested amount of data is read before the asynchronous operation completes.
+
+[heading Example]
+  
+To read into a single data buffer use the 
+[link boost_asio.reference.buffer buffer]  function as follows: 
+
+   descriptor.async_read_some(boost::asio::buffer(data, size), handler);
+
+
+See the 
+[link boost_asio.reference.buffer buffer]  documentation for information on reading into multiple buffers in one go, and how to use it with arrays, boost::array or std::vector. 
+
+
+
+[endsect]
+
+
+
+[section:async_write_some posix::basic_stream_descriptor::async_write_some]
+
+Start an asynchronous write. 
+
+  template<
+      typename ``[link boost_asio.reference.ConstBufferSequence ConstBufferSequence]``,
+      typename ``[link boost_asio.reference.WriteHandler WriteHandler]``>
+  void async_write_some(
+      const ConstBufferSequence & buffers,
+      WriteHandler handler);
+
+
+This function is used to asynchronously write data to the stream descriptor. The function call always returns immediately.
+
+
+[heading Parameters]
+    
+
+[variablelist
+  
+[[buffers][One or more data buffers to be written to the descriptor. Although the buffers object may be copied as necessary, ownership of the underlying memory blocks is retained by the caller, which must guarantee that they remain valid until the handler is called.]]
+
+[[handler][The handler to be called when the write operation completes. Copies will be made of the handler as required. The function signature of the handler must be: 
+``
+   void handler(
+     const boost::system::error_code& error, // Result of operation.
+     std::size_t bytes_transferred           // Number of bytes written.
+   ); 
+
+``
+Regardless of whether the asynchronous operation completes immediately or not, the handler will not be invoked from within this function. Invocation of the handler will be performed in a manner equivalent to using boost::asio::io\_service::post().]]
+
+]
+
+[heading Remarks]
+      
+The write operation may not transmit all of the data to the peer. Consider using the 
+[link boost_asio.reference.async_write async_write]  function if you need to ensure that all data is written before the asynchronous operation completes.
+
+[heading Example]
+  
+To write a single data buffer use the 
+[link boost_asio.reference.buffer buffer]  function as follows: 
+
+   descriptor.async_write_some(boost::asio::buffer(data, size), handler);
+
+
+See the 
+[link boost_asio.reference.buffer buffer]  documentation for information on writing multiple buffers in one go, and how to use it with arrays, boost::array or std::vector. 
+
+
+
+[endsect]
+
+
+[section:basic_stream_descriptor posix::basic_stream_descriptor::basic_stream_descriptor]
+
+Construct a basic_stream_descriptor without opening it. 
+
+  ``[link boost_asio.reference.posix__basic_stream_descriptor.basic_stream_descriptor.overload1 basic_stream_descriptor]``(
+      boost::asio::io_service & io_service);
+
+  ``[link boost_asio.reference.posix__basic_stream_descriptor.basic_stream_descriptor.overload2 basic_stream_descriptor]``(
+      boost::asio::io_service & io_service,
+      const native_type & native_descriptor);
+
+
+[section:overload1 posix::basic_stream_descriptor::basic_stream_descriptor (1 of 2 overloads)]
+
+Construct a basic_stream_descriptor without opening it. 
+
+  basic_stream_descriptor(
+      boost::asio::io_service & io_service);
+
+
+This constructor creates a stream descriptor without opening it. The descriptor needs to be opened and then connected or accepted before data can be sent or received on it.
+
+
+[heading Parameters]
+    
+
+[variablelist
+  
+[[io_service][The io\_service object that the stream descriptor will use to dispatch handlers for any asynchronous operations performed on the descriptor. ]]
+
+]
+
+
+
+[endsect]
+
+
+
+[section:overload2 posix::basic_stream_descriptor::basic_stream_descriptor (2 of 2 overloads)]
+
+Construct a basic_stream_descriptor on an existing native descriptor. 
+
+  basic_stream_descriptor(
+      boost::asio::io_service & io_service,
+      const native_type & native_descriptor);
+
+
+This constructor creates a stream descriptor object to hold an existing native descriptor.
+
+
+[heading Parameters]
+    
+
+[variablelist
+  
+[[io_service][The io\_service object that the stream descriptor will use to dispatch handlers for any asynchronous operations performed on the descriptor.]]
+
+[[native_descriptor][The new underlying descriptor implementation.]]
+
+]
+
+[heading Exceptions]
+    
+
+[variablelist
+  
+[[boost::system::system_error][Thrown on failure. ]]
+
+]
+
+
+
+[endsect]
+
+
+[endsect]
+
+
+[section:bytes_readable posix::basic_stream_descriptor::bytes_readable]
+
+
+['Inherited from posix::descriptor_base.]
+
+IO control command to get the amount of data that can be read without blocking. 
+
+  typedef implementation_defined bytes_readable;
+
+
+
+Implements the FIONREAD IO control command.
+
+
+[heading Example]
+  
+
+
+   boost::asio::posix::stream_descriptor descriptor(io_service); 
+   ...
+   boost::asio::descriptor_base::bytes_readable command(true);
+   descriptor.io_control(command);
+   std::size_t bytes_readable = command.get();
+
+
+
+
+
+
+[endsect]
+
+
+[section:cancel posix::basic_stream_descriptor::cancel]
+
+Cancel all asynchronous operations associated with the descriptor. 
+
+  void ``[link boost_asio.reference.posix__basic_stream_descriptor.cancel.overload1 cancel]``();
+
+  boost::system::error_code ``[link boost_asio.reference.posix__basic_stream_descriptor.cancel.overload2 cancel]``(
+      boost::system::error_code & ec);
+
+
+[section:overload1 posix::basic_stream_descriptor::cancel (1 of 2 overloads)]
+
+
+['Inherited from posix::basic_descriptor.]
+
+Cancel all asynchronous operations associated with the descriptor. 
+
+  void cancel();
+
+
+This function causes all outstanding asynchronous read or write operations to finish immediately, and the handlers for cancelled operations will be passed the boost::asio::error::operation\_aborted error.
+
+
+[heading Exceptions]
+    
+
+[variablelist
+  
+[[boost::system::system_error][Thrown on failure. ]]
+
+]
+
+
+
+[endsect]
+
+
+
+[section:overload2 posix::basic_stream_descriptor::cancel (2 of 2 overloads)]
+
+
+['Inherited from posix::basic_descriptor.]
+
+Cancel all asynchronous operations associated with the descriptor. 
+
+  boost::system::error_code cancel(
+      boost::system::error_code & ec);
+
+
+This function causes all outstanding asynchronous read or write operations to finish immediately, and the handlers for cancelled operations will be passed the boost::asio::error::operation\_aborted error.
+
+
+[heading Parameters]
+    
+
+[variablelist
+  
+[[ec][Set to indicate what error occurred, if any. ]]
+
+]
+
+
+
+[endsect]
+
+
+[endsect]
+
+[section:close posix::basic_stream_descriptor::close]
+
+Close the descriptor. 
+
+  void ``[link boost_asio.reference.posix__basic_stream_descriptor.close.overload1 close]``();
+
+  boost::system::error_code ``[link boost_asio.reference.posix__basic_stream_descriptor.close.overload2 close]``(
+      boost::system::error_code & ec);
+
+
+[section:overload1 posix::basic_stream_descriptor::close (1 of 2 overloads)]
+
+
+['Inherited from posix::basic_descriptor.]
+
+Close the descriptor. 
+
+  void close();
+
+
+This function is used to close the descriptor. Any asynchronous read or write operations will be cancelled immediately, and will complete with the boost::asio::error::operation\_aborted error.
+
+
+[heading Exceptions]
+    
+
+[variablelist
+  
+[[boost::system::system_error][Thrown on failure. ]]
+
+]
+
+
+
+[endsect]
+
+
+
+[section:overload2 posix::basic_stream_descriptor::close (2 of 2 overloads)]
+
+
+['Inherited from posix::basic_descriptor.]
+
+Close the descriptor. 
+
+  boost::system::error_code close(
+      boost::system::error_code & ec);
+
+
+This function is used to close the descriptor. Any asynchronous read or write operations will be cancelled immediately, and will complete with the boost::asio::error::operation\_aborted error.
+
+
+[heading Parameters]
+    
+
+[variablelist
+  
+[[ec][Set to indicate what error occurred, if any. ]]
+
+]
+
+
+
+[endsect]
+
+
+[endsect]
+
+
+[section:get_io_service posix::basic_stream_descriptor::get_io_service]
+
+
+['Inherited from basic_io_object.]
+
+Get the io_service associated with the object. 
+
+  boost::asio::io_service & get_io_service();
+
+
+This function may be used to obtain the io_service object that the I/O object uses to dispatch handlers for asynchronous operations.
+
+
+[heading Return Value]
+      
+A reference to the io_service object that the I/O object will use to dispatch handlers. Ownership is not transferred to the caller. 
+
+
+
+[endsect]
+
+
+
+[section:implementation posix::basic_stream_descriptor::implementation]
+
+
+['Inherited from basic_io_object.]
+
+The underlying implementation of the I/O object. 
+
+  implementation_type implementation;
+
+
+
+[endsect]
+
+
+
+[section:implementation_type posix::basic_stream_descriptor::implementation_type]
+
+
+['Inherited from basic_io_object.]
+
+The underlying implementation type of I/O object. 
+
+  typedef service_type::implementation_type implementation_type;
+
+
+
+
+[endsect]
+
+
+[section:io_control posix::basic_stream_descriptor::io_control]
+
+Perform an IO control command on the descriptor. 
+
+  void ``[link boost_asio.reference.posix__basic_stream_descriptor.io_control.overload1 io_control]``(
+      IoControlCommand & command);
+
+  boost::system::error_code ``[link boost_asio.reference.posix__basic_stream_descriptor.io_control.overload2 io_control]``(
+      IoControlCommand & command,
+      boost::system::error_code & ec);
+
+
+[section:overload1 posix::basic_stream_descriptor::io_control (1 of 2 overloads)]
+
+
+['Inherited from posix::basic_descriptor.]
+
+Perform an IO control command on the descriptor. 
+
+  void io_control(
+      IoControlCommand & command);
+
+
+This function is used to execute an IO control command on the descriptor.
+
+
+[heading Parameters]
+    
+
+[variablelist
+  
+[[command][The IO control command to be performed on the descriptor.]]
+
+]
+
+[heading Exceptions]
+    
+
+[variablelist
+  
+[[boost::system::system_error][Thrown on failure.]]
+
+]
+
+[heading Example]
+  
+Getting the number of bytes ready to read: 
+
+   boost::asio::posix::stream_descriptor descriptor(io_service);
+   ...
+   boost::asio::posix::stream_descriptor::bytes_readable command;
+   descriptor.io_control(command);
+   std::size_t bytes_readable = command.get();
+
+
+
+
+
+
+[endsect]
+
+
+
+[section:overload2 posix::basic_stream_descriptor::io_control (2 of 2 overloads)]
+
+
+['Inherited from posix::basic_descriptor.]
+
+Perform an IO control command on the descriptor. 
+
+  boost::system::error_code io_control(
+      IoControlCommand & command,
+      boost::system::error_code & ec);
+
+
+This function is used to execute an IO control command on the descriptor.
+
+
+[heading Parameters]
+    
+
+[variablelist
+  
+[[command][The IO control command to be performed on the descriptor.]]
+
+[[ec][Set to indicate what error occurred, if any.]]
+
+]
+
+[heading Example]
+  
+Getting the number of bytes ready to read: 
+
+   boost::asio::posix::stream_descriptor descriptor(io_service);
+   ...
+   boost::asio::posix::stream_descriptor::bytes_readable command;
+   boost::system::error_code ec;
+   descriptor.io_control(command, ec);
+   if (ec)
+   {
+     // An error occurred.
+   }
+   std::size_t bytes_readable = command.get();
+
+
+
+
+
+
+[endsect]
+
+
+[endsect]
+
+
+[section:io_service posix::basic_stream_descriptor::io_service]
+
+
+['Inherited from basic_io_object.]
+
+(Deprecated: use get_io_service().) Get the io_service associated with the object. 
+
+  boost::asio::io_service & io_service();
+
+
+This function may be used to obtain the io_service object that the I/O object uses to dispatch handlers for asynchronous operations.
+
+
+[heading Return Value]
+      
+A reference to the io_service object that the I/O object will use to dispatch handlers. Ownership is not transferred to the caller. 
+
+
+
+[endsect]
+
+
+
+[section:is_open posix::basic_stream_descriptor::is_open]
+
+
+['Inherited from posix::basic_descriptor.]
+
+Determine whether the descriptor is open. 
+
+  bool is_open() const;
+
+
+
+[endsect]
+
+
+
+[section:lowest_layer posix::basic_stream_descriptor::lowest_layer]
+
+
+['Inherited from posix::basic_descriptor.]
+
+Get a reference to the lowest layer. 
+
+  lowest_layer_type & lowest_layer();
+
+
+This function returns a reference to the lowest layer in a stack of layers. Since a basic_descriptor cannot contain any further layers, it simply returns a reference to itself.
+
+
+[heading Return Value]
+      
+A reference to the lowest layer in the stack of layers. Ownership is not transferred to the caller. 
+
+
+
+[endsect]
+
+
+
+[section:lowest_layer_type posix::basic_stream_descriptor::lowest_layer_type]
+
+
+['Inherited from posix::basic_descriptor.]
+
+A basic_descriptor is always the lowest layer. 
+
+  typedef basic_descriptor< StreamDescriptorService > lowest_layer_type;
+
+
+[heading Types]
+[table
+  [[Name][Description]]
+
+  [
+
+    [[link boost_asio.reference.posix__basic_descriptor.bytes_readable [*bytes_readable]]]
+    [IO control command to get the amount of data that can be read without blocking. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.posix__basic_descriptor.implementation_type [*implementation_type]]]
+    [The underlying implementation type of I/O object. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.posix__basic_descriptor.lowest_layer_type [*lowest_layer_type]]]
+    [A basic_descriptor is always the lowest layer. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.posix__basic_descriptor.native_type [*native_type]]]
+    [The native representation of a descriptor. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.posix__basic_descriptor.non_blocking_io [*non_blocking_io]]]
+    [IO control command to set the blocking mode of the descriptor. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.posix__basic_descriptor.service_type [*service_type]]]
+    [The type of the service that will be used to provide I/O operations. ]
+  
+  ]
+
+]
+
+[heading Member Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.posix__basic_descriptor.assign [*assign]]]
+    [Assign an existing native descriptor to the descriptor. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_descriptor.basic_descriptor [*basic_descriptor]]]
+    [Construct a basic_descriptor without opening it. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_descriptor.cancel [*cancel]]]
+    [Cancel all asynchronous operations associated with the descriptor. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_descriptor.close [*close]]]
+    [Close the descriptor. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_descriptor.get_io_service [*get_io_service]]]
+    [Get the io_service associated with the object. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_descriptor.io_control [*io_control]]]
+    [Perform an IO control command on the descriptor. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_descriptor.io_service [*io_service]]]
+    [(Deprecated: use get_io_service().) Get the io_service associated with the object. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_descriptor.is_open [*is_open]]]
+    [Determine whether the descriptor is open. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_descriptor.lowest_layer [*lowest_layer]]]
+    [Get a reference to the lowest layer. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_descriptor.native [*native]]]
+    [Get the native descriptor representation. ]
+  ]
+  
+]
+
+[heading Protected Member Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.posix__basic_descriptor._basic_descriptor [*~basic_descriptor]]]
+    [Protected destructor to prevent deletion through this type. ]
+  ]
+  
+]
+
+[heading Protected Data Members]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.posix__basic_descriptor.implementation [*implementation]]]
+    [The underlying implementation of the I/O object. ]
+  ]
+
+  [
+    [[link boost_asio.reference.posix__basic_descriptor.service [*service]]]
+    [The service associated with the I/O object. ]
+  ]
+
+]
+
+The posix::basic_descriptor class template provides the ability to wrap a POSIX descriptor.
+
+
+[heading Thread Safety]
+  
+[*Distinct] [*objects:]  Safe.
+
+[*Shared] [*objects:]  Unsafe. 
+
+
+
+
+[endsect]
+
+
+
+[section:native posix::basic_stream_descriptor::native]
+
+
+['Inherited from posix::basic_descriptor.]
+
+Get the native descriptor representation. 
+
+  native_type native();
+
+
+This function may be used to obtain the underlying representation of the descriptor. This is intended to allow access to native descriptor functionality that is not otherwise provided. 
+
+
+[endsect]
+
+
+
+[section:native_type posix::basic_stream_descriptor::native_type]
+
+The native representation of a descriptor. 
+
+  typedef StreamDescriptorService::native_type native_type;
+
+
+
+
+[endsect]
+
+
+
+[section:non_blocking_io posix::basic_stream_descriptor::non_blocking_io]
+
+
+['Inherited from posix::descriptor_base.]
+
+IO control command to set the blocking mode of the descriptor. 
+
+  typedef implementation_defined non_blocking_io;
+
+
+
+Implements the FIONBIO IO control command.
+
+
+[heading Example]
+  
+
+
+   boost::asio::posix::stream_descriptor descriptor(io_service); 
+   ...
+   boost::asio::descriptor_base::non_blocking_io command(true);
+   descriptor.io_control(command);
+
+
+
+
+
+
+[endsect]
+
+
+[section:read_some posix::basic_stream_descriptor::read_some]
+
+Read some data from the descriptor. 
+
+  template<
+      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``>
+  std::size_t ``[link boost_asio.reference.posix__basic_stream_descriptor.read_some.overload1 read_some]``(
+      const MutableBufferSequence & buffers);
+
+  template<
+      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``>
+  std::size_t ``[link boost_asio.reference.posix__basic_stream_descriptor.read_some.overload2 read_some]``(
+      const MutableBufferSequence & buffers,
+      boost::system::error_code & ec);
+
+
+[section:overload1 posix::basic_stream_descriptor::read_some (1 of 2 overloads)]
+
+Read some data from the descriptor. 
+
+  template<
+      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``>
+  std::size_t read_some(
+      const MutableBufferSequence & buffers);
+
+
+This function is used to read data from the stream descriptor. The function call will block until one or more bytes of data has been read successfully, or until an error occurs.
+
+
+[heading Parameters]
+    
+
+[variablelist
+  
+[[buffers][One or more buffers into which the data will be read.]]
+
+]
+
+[heading Return Value]
+      
+The number of bytes read.
+
+[heading Exceptions]
+    
+
+[variablelist
+  
+[[boost::system::system_error][Thrown on failure. An error code of boost::asio::error::eof indicates that the connection was closed by the peer.]]
+
+]
+
+[heading Remarks]
+      
+The read\_some operation may not read all of the requested number of bytes. Consider using the 
+[link boost_asio.reference.read read]  function if you need to ensure that the requested amount of data is read before the blocking operation completes.
+
+[heading Example]
+  
+To read into a single data buffer use the 
+[link boost_asio.reference.buffer buffer]  function as follows: 
+
+   descriptor.read_some(boost::asio::buffer(data, size));
+
+
+See the 
+[link boost_asio.reference.buffer buffer]  documentation for information on reading into multiple buffers in one go, and how to use it with arrays, boost::array or std::vector. 
+
+
+
+[endsect]
+
+
+
+[section:overload2 posix::basic_stream_descriptor::read_some (2 of 2 overloads)]
+
+Read some data from the descriptor. 
+
+  template<
+      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``>
+  std::size_t read_some(
+      const MutableBufferSequence & buffers,
+      boost::system::error_code & ec);
+
+
+This function is used to read data from the stream descriptor. The function call will block until one or more bytes of data has been read successfully, or until an error occurs.
+
+
+[heading Parameters]
+    
+
+[variablelist
+  
+[[buffers][One or more buffers into which the data will be read.]]
+
+[[ec][Set to indicate what error occurred, if any.]]
+
+]
+
+[heading Return Value]
+      
+The number of bytes read. Returns 0 if an error occurred.
+
+[heading Remarks]
+      
+The read\_some operation may not read all of the requested number of bytes. Consider using the 
+[link boost_asio.reference.read read]  function if you need to ensure that the requested amount of data is read before the blocking operation completes. 
+
+
+
+[endsect]
+
+
+[endsect]
+
+
+[section:service posix::basic_stream_descriptor::service]
+
+
+['Inherited from basic_io_object.]
+
+The service associated with the I/O object. 
+
+  service_type & service;
+
+
+
+[endsect]
+
+
+
+[section:service_type posix::basic_stream_descriptor::service_type]
+
+
+['Inherited from basic_io_object.]
+
+The type of the service that will be used to provide I/O operations. 
+
+  typedef StreamDescriptorService service_type;
+
+
+
+
+[endsect]
+
+
+[section:write_some posix::basic_stream_descriptor::write_some]
+
+Write some data to the descriptor. 
+
+  template<
+      typename ``[link boost_asio.reference.ConstBufferSequence ConstBufferSequence]``>
+  std::size_t ``[link boost_asio.reference.posix__basic_stream_descriptor.write_some.overload1 write_some]``(
+      const ConstBufferSequence & buffers);
+
+  template<
+      typename ``[link boost_asio.reference.ConstBufferSequence ConstBufferSequence]``>
+  std::size_t ``[link boost_asio.reference.posix__basic_stream_descriptor.write_some.overload2 write_some]``(
+      const ConstBufferSequence & buffers,
+      boost::system::error_code & ec);
+
+
+[section:overload1 posix::basic_stream_descriptor::write_some (1 of 2 overloads)]
+
+Write some data to the descriptor. 
+
+  template<
+      typename ``[link boost_asio.reference.ConstBufferSequence ConstBufferSequence]``>
+  std::size_t write_some(
+      const ConstBufferSequence & buffers);
+
+
+This function is used to write data to the stream descriptor. The function call will block until one or more bytes of the data has been written successfully, or until an error occurs.
+
+
+[heading Parameters]
+    
+
+[variablelist
+  
+[[buffers][One or more data buffers to be written to the descriptor.]]
+
+]
+
+[heading Return Value]
+      
+The number of bytes written.
+
+[heading Exceptions]
+    
+
+[variablelist
+  
+[[boost::system::system_error][Thrown on failure. An error code of boost::asio::error::eof indicates that the connection was closed by the peer.]]
+
+]
+
+[heading Remarks]
+      
+The write\_some operation may not transmit all of the data to the peer. Consider using the 
+[link boost_asio.reference.write write]  function if you need to ensure that all data is written before the blocking operation completes.
+
+[heading Example]
+  
+To write a single data buffer use the 
+[link boost_asio.reference.buffer buffer]  function as follows: 
+
+   descriptor.write_some(boost::asio::buffer(data, size));
+
+
+See the 
+[link boost_asio.reference.buffer buffer]  documentation for information on writing multiple buffers in one go, and how to use it with arrays, boost::array or std::vector. 
+
+
+
+[endsect]
+
+
+
+[section:overload2 posix::basic_stream_descriptor::write_some (2 of 2 overloads)]
+
+Write some data to the descriptor. 
+
+  template<
+      typename ``[link boost_asio.reference.ConstBufferSequence ConstBufferSequence]``>
+  std::size_t write_some(
+      const ConstBufferSequence & buffers,
+      boost::system::error_code & ec);
+
+
+This function is used to write data to the stream descriptor. The function call will block until one or more bytes of the data has been written successfully, or until an error occurs.
+
+
+[heading Parameters]
+    
+
+[variablelist
+  
+[[buffers][One or more data buffers to be written to the descriptor.]]
+
+[[ec][Set to indicate what error occurred, if any.]]
+
+]
+
+[heading Return Value]
+      
+The number of bytes written. Returns 0 if an error occurred.
+
+[heading Remarks]
+      
+The write\_some operation may not transmit all of the data to the peer. Consider using the 
+[link boost_asio.reference.write write]  function if you need to ensure that all data is written before the blocking operation completes. 
+
+
+
+[endsect]
+
+
+[endsect]
+
+
+[endsect]
+
+[section:posix__descriptor_base posix::descriptor_base]
+
+The descriptor_base class is used as a base for the basic_stream_descriptor class template so that we have a common place to define the associated IO control commands. 
+
+  class descriptor_base
+
+
+[heading Types]
+[table
+  [[Name][Description]]
+
+  [
+
+    [[link boost_asio.reference.posix__descriptor_base.bytes_readable [*bytes_readable]]]
+    [IO control command to get the amount of data that can be read without blocking. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.posix__descriptor_base.non_blocking_io [*non_blocking_io]]]
+    [IO control command to set the blocking mode of the descriptor. ]
+  
+  ]
+
+]
+
+[heading Protected Member Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.posix__descriptor_base._descriptor_base [*~descriptor_base]]]
+    [Protected destructor to prevent deletion through this type. ]
+  ]
+  
+]
+
+
+[section:bytes_readable posix::descriptor_base::bytes_readable]
+
+IO control command to get the amount of data that can be read without blocking. 
+
+  typedef implementation_defined bytes_readable;
+
+
+
+Implements the FIONREAD IO control command.
+
+
+[heading Example]
+  
+
+
+   boost::asio::posix::stream_descriptor descriptor(io_service); 
+   ...
+   boost::asio::descriptor_base::bytes_readable command(true);
+   descriptor.io_control(command);
+   std::size_t bytes_readable = command.get();
+
+
+
+
+
+
+[endsect]
+
+
+
+[section:non_blocking_io posix::descriptor_base::non_blocking_io]
+
+IO control command to set the blocking mode of the descriptor. 
+
+  typedef implementation_defined non_blocking_io;
+
+
+
+Implements the FIONBIO IO control command.
+
+
+[heading Example]
+  
+
+
+   boost::asio::posix::stream_descriptor descriptor(io_service); 
+   ...
+   boost::asio::descriptor_base::non_blocking_io command(true);
+   descriptor.io_control(command);
+
+
+
+
+
+
+[endsect]
+
+
+
+[section:_descriptor_base posix::descriptor_base::~descriptor_base]
+
+Protected destructor to prevent deletion through this type. 
+
+  ~descriptor_base();
+
+
+
+[endsect]
+
+
+
+[endsect]
+
+
+[section:posix__stream_descriptor posix::stream_descriptor]
+
+Typedef for the typical usage of a stream-oriented descriptor. 
+
+  typedef basic_stream_descriptor stream_descriptor;
+
+
+[heading Types]
+[table
+  [[Name][Description]]
+
+  [
+
+    [[link boost_asio.reference.posix__basic_stream_descriptor.bytes_readable [*bytes_readable]]]
+    [IO control command to get the amount of data that can be read without blocking. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.posix__basic_stream_descriptor.implementation_type [*implementation_type]]]
+    [The underlying implementation type of I/O object. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.posix__basic_stream_descriptor.lowest_layer_type [*lowest_layer_type]]]
+    [A basic_descriptor is always the lowest layer. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.posix__basic_stream_descriptor.native_type [*native_type]]]
+    [The native representation of a descriptor. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.posix__basic_stream_descriptor.non_blocking_io [*non_blocking_io]]]
+    [IO control command to set the blocking mode of the descriptor. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.posix__basic_stream_descriptor.service_type [*service_type]]]
+    [The type of the service that will be used to provide I/O operations. ]
+  
+  ]
+
+]
+
+[heading Member Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.posix__basic_stream_descriptor.assign [*assign]]]
+    [Assign an existing native descriptor to the descriptor. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_stream_descriptor.async_read_some [*async_read_some]]]
+    [Start an asynchronous read. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_stream_descriptor.async_write_some [*async_write_some]]]
+    [Start an asynchronous write. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_stream_descriptor.basic_stream_descriptor [*basic_stream_descriptor]]]
+    [Construct a basic_stream_descriptor without opening it. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_stream_descriptor.cancel [*cancel]]]
+    [Cancel all asynchronous operations associated with the descriptor. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_stream_descriptor.close [*close]]]
+    [Close the descriptor. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_stream_descriptor.get_io_service [*get_io_service]]]
+    [Get the io_service associated with the object. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_stream_descriptor.io_control [*io_control]]]
+    [Perform an IO control command on the descriptor. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_stream_descriptor.io_service [*io_service]]]
+    [(Deprecated: use get_io_service().) Get the io_service associated with the object. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_stream_descriptor.is_open [*is_open]]]
+    [Determine whether the descriptor is open. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_stream_descriptor.lowest_layer [*lowest_layer]]]
+    [Get a reference to the lowest layer. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_stream_descriptor.native [*native]]]
+    [Get the native descriptor representation. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_stream_descriptor.read_some [*read_some]]]
+    [Read some data from the descriptor. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__basic_stream_descriptor.write_some [*write_some]]]
+    [Write some data to the descriptor. ]
+  ]
+  
+]
+
+[heading Protected Data Members]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.posix__basic_stream_descriptor.implementation [*implementation]]]
+    [The underlying implementation of the I/O object. ]
+  ]
+
+  [
+    [[link boost_asio.reference.posix__basic_stream_descriptor.service [*service]]]
+    [The service associated with the I/O object. ]
+  ]
+
+]
+
+The posix::basic_stream_descriptor class template provides asynchronous and blocking stream-oriented descriptor functionality.
+
+
+[heading Thread Safety]
+  
+[*Distinct] [*objects:]  Safe.
+
+[*Shared] [*objects:]  Unsafe.
+
+
+
+
+[endsect]
+
+
+[section:posix__stream_descriptor_service posix::stream_descriptor_service]
+
+Default service implementation for a stream descriptor. 
+
+  class stream_descriptor_service :
+    public io_service::service
+
+
+[heading Types]
+[table
+  [[Name][Description]]
+
+  [
+
+    [[link boost_asio.reference.posix__stream_descriptor_service.implementation_type [*implementation_type]]]
+    [The type of a stream descriptor implementation. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.posix__stream_descriptor_service.native_type [*native_type]]]
+    [The native descriptor type. ]
+  
+  ]
+
+]
+
+[heading Member Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.posix__stream_descriptor_service.assign [*assign]]]
+    [Assign an existing native descriptor to a stream descriptor. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__stream_descriptor_service.async_read_some [*async_read_some]]]
+    [Start an asynchronous read. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__stream_descriptor_service.async_write_some [*async_write_some]]]
+    [Start an asynchronous write. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__stream_descriptor_service.cancel [*cancel]]]
+    [Cancel all asynchronous operations associated with the descriptor. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__stream_descriptor_service.close [*close]]]
+    [Close a stream descriptor implementation. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__stream_descriptor_service.construct [*construct]]]
+    [Construct a new stream descriptor implementation. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__stream_descriptor_service.destroy [*destroy]]]
+    [Destroy a stream descriptor implementation. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__stream_descriptor_service.get_io_service [*get_io_service]]]
+    [Get the io_service object that owns the service. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__stream_descriptor_service.io_control [*io_control]]]
+    [Perform an IO control command on the descriptor. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__stream_descriptor_service.io_service [*io_service]]]
+    [(Deprecated: use get_io_service().) Get the io_service object that owns the service. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__stream_descriptor_service.is_open [*is_open]]]
+    [Determine whether the descriptor is open. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__stream_descriptor_service.native [*native]]]
+    [Get the native descriptor implementation. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__stream_descriptor_service.read_some [*read_some]]]
+    [Read some data from the stream. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__stream_descriptor_service.shutdown_service [*shutdown_service]]]
+    [Destroy all user-defined descriptorr objects owned by the service. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__stream_descriptor_service.stream_descriptor_service [*stream_descriptor_service]]]
+    [Construct a new stream descriptor service for the specified io_service. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.posix__stream_descriptor_service.write_some [*write_some]]]
+    [Write the given data to the stream. ]
+  ]
+  
+]
+
+[heading Data Members]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.posix__stream_descriptor_service.id [*id]]]
+    [The unique service identifier. ]
+  ]
+
+]
+
+
+[section:assign posix::stream_descriptor_service::assign]
+
+Assign an existing native descriptor to a stream descriptor. 
+
+  boost::system::error_code assign(
+      implementation_type & impl,
+      const native_type & native_descriptor,
+      boost::system::error_code & ec);
+
+
+
+[endsect]
+
+
+
+[section:async_read_some posix::stream_descriptor_service::async_read_some]
+
+Start an asynchronous read. 
+
+  template<
+      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``,
+      typename ``[link boost_asio.reference.ReadHandler ReadHandler]``>
+  void async_read_some(
+      implementation_type & impl,
+      const MutableBufferSequence & buffers,
+      ReadHandler descriptorr);
+
+
+
+[endsect]
+
+
+
+[section:async_write_some posix::stream_descriptor_service::async_write_some]
+
+Start an asynchronous write. 
+
+  template<
+      typename ``[link boost_asio.reference.ConstBufferSequence ConstBufferSequence]``,
+      typename ``[link boost_asio.reference.WriteHandler WriteHandler]``>
+  void async_write_some(
+      implementation_type & impl,
+      const ConstBufferSequence & buffers,
+      WriteHandler descriptorr);
+
+
+
+[endsect]
+
+
+
+[section:cancel posix::stream_descriptor_service::cancel]
+
+Cancel all asynchronous operations associated with the descriptor. 
+
+  boost::system::error_code cancel(
+      implementation_type & impl,
+      boost::system::error_code & ec);
+
+
+
+[endsect]
+
+
+
+[section:close posix::stream_descriptor_service::close]
+
+Close a stream descriptor implementation. 
+
+  boost::system::error_code close(
+      implementation_type & impl,
+      boost::system::error_code & ec);
+
+
+
+[endsect]
+
+
+
+[section:construct posix::stream_descriptor_service::construct]
+
+Construct a new stream descriptor implementation. 
+
+  void construct(
+      implementation_type & impl);
+
+
+
+[endsect]
+
+
+
+[section:destroy posix::stream_descriptor_service::destroy]
+
+Destroy a stream descriptor implementation. 
+
+  void destroy(
+      implementation_type & impl);
+
+
+
+[endsect]
+
+
+
+[section:get_io_service posix::stream_descriptor_service::get_io_service]
+
+
+['Inherited from io_service.]
+
+Get the io_service object that owns the service. 
+
+  boost::asio::io_service & get_io_service();
+
+
+
+[endsect]
+
+
+
+[section:id posix::stream_descriptor_service::id]
+
+The unique service identifier. 
+
+  static boost::asio::io_service::id id;
+
+
+
+[endsect]
+
+
+
+[section:implementation_type posix::stream_descriptor_service::implementation_type]
+
+The type of a stream descriptor implementation. 
+
+  typedef implementation_defined implementation_type;
+
+
+
+
+[endsect]
+
+
+
+[section:io_control posix::stream_descriptor_service::io_control]
+
+Perform an IO control command on the descriptor. 
+
+  template<
+      typename ``[link boost_asio.reference.IoControlCommand IoControlCommand]``>
+  boost::system::error_code io_control(
+      implementation_type & impl,
+      IoControlCommand & command,
+      boost::system::error_code & ec);
+
+
+
+[endsect]
+
+
+
+[section:io_service posix::stream_descriptor_service::io_service]
+
+
+['Inherited from io_service.]
+
+(Deprecated: use get_io_service().) Get the io_service object that owns the service. 
+
+  boost::asio::io_service & io_service();
+
+
+
+[endsect]
+
+
+
+[section:is_open posix::stream_descriptor_service::is_open]
+
+Determine whether the descriptor is open. 
+
+  bool is_open(
+      const implementation_type & impl) const;
+
+
+
+[endsect]
+
+
+
+[section:native posix::stream_descriptor_service::native]
+
+Get the native descriptor implementation. 
+
+  native_type native(
+      implementation_type & impl);
+
+
+
+[endsect]
+
+
+
+[section:native_type posix::stream_descriptor_service::native_type]
+
+The native descriptor type. 
+
+  typedef implementation_defined native_type;
+
+
+
+
+[endsect]
+
+
+
+[section:read_some posix::stream_descriptor_service::read_some]
+
+Read some data from the stream. 
+
+  template<
+      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``>
+  std::size_t read_some(
+      implementation_type & impl,
+      const MutableBufferSequence & buffers,
+      boost::system::error_code & ec);
+
+
+
+[endsect]
+
+
+
+[section:shutdown_service posix::stream_descriptor_service::shutdown_service]
+
+Destroy all user-defined descriptorr objects owned by the service. 
+
+  void shutdown_service();
+
+
+
+[endsect]
+
+
+
+[section:stream_descriptor_service posix::stream_descriptor_service::stream_descriptor_service]
+
+Construct a new stream descriptor service for the specified io_service. 
+
+  stream_descriptor_service(
+      boost::asio::io_service & io_service);
+
+
+
+[endsect]
+
+
+
+[section:write_some posix::stream_descriptor_service::write_some]
+
+Write the given data to the stream. 
+
+  template<
+      typename ``[link boost_asio.reference.ConstBufferSequence ConstBufferSequence]``>
+  std::size_t write_some(
+      implementation_type & impl,
+      const ConstBufferSequence & buffers,
+      boost::system::error_code & ec);
+
+
+
+[endsect]
+
+
+
+[endsect]
+
+[section:read read]
+
+Attempt to read a certain amount of data from a stream before returning. 
+
+  template<
+      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
+      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``>
+  std::size_t ``[link boost_asio.reference.read.overload1 read]``(
+      SyncReadStream & s,
+      const MutableBufferSequence & buffers);
+
+  template<
+      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
+      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``,
+      typename CompletionCondition>
+  std::size_t ``[link boost_asio.reference.read.overload2 read]``(
+      SyncReadStream & s,
+      const MutableBufferSequence & buffers,
+      CompletionCondition completion_condition);
+
+  template<
+      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
+      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``,
+      typename CompletionCondition>
+  std::size_t ``[link boost_asio.reference.read.overload3 read]``(
+      SyncReadStream & s,
+      const MutableBufferSequence & buffers,
+      CompletionCondition completion_condition,
+      boost::system::error_code & ec);
+
+  template<
+      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
+      typename Allocator>
+  std::size_t ``[link boost_asio.reference.read.overload4 read]``(
+      SyncReadStream & s,
+      basic_streambuf< Allocator > & b);
+
+  template<
+      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
+      typename Allocator,
+      typename CompletionCondition>
+  std::size_t ``[link boost_asio.reference.read.overload5 read]``(
+      SyncReadStream & s,
+      basic_streambuf< Allocator > & b,
+      CompletionCondition completion_condition);
+
+  template<
+      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
+      typename Allocator,
+      typename CompletionCondition>
+  std::size_t ``[link boost_asio.reference.read.overload6 read]``(
+      SyncReadStream & s,
+      basic_streambuf< Allocator > & b,
+      CompletionCondition completion_condition,
+      boost::system::error_code & ec);
+
+
+[section:overload1 read (1 of 6 overloads)]
+
+Attempt to read a certain amount of data from a stream before returning. 
+
+  template<
+      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
+      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``>
+  std::size_t read(
+      SyncReadStream & s,
+      const MutableBufferSequence & buffers);
+
+
+This function is used to read a certain number of bytes of data from a stream. The call will block until one of the following conditions is true:
+
+
+* The supplied buffers are full. That is, the bytes transferred is equal to the sum of the buffer sizes.
+
+* An error occurred.
+
+This operation is implemented in terms of one or more calls to the stream's read\_some function.
+
+
+[heading Parameters]
+    
+
+[variablelist
+  
+[[s][The stream from which the data is to be read. The type must support the SyncReadStream concept.]]
+
+[[buffers][One or more buffers into which the data will be read. The sum of the buffer sizes indicates the maximum number of bytes to read from the stream.]]
+
+]
+
+[heading Return Value]
+      
+The number of bytes transferred.
+
+[heading Exceptions]
+    
+
+[variablelist
+  
+[[boost::system::system_error][Thrown on failure.]]
+
+]
+
+[heading Example]
+  
+To read into a single data buffer use the 
+[link boost_asio.reference.buffer buffer]  function as follows: 
+
+   boost::asio::read(s, boost::asio::buffer(data, size)); 
+
+
+See the 
+[link boost_asio.reference.buffer buffer]  documentation for information on reading into multiple buffers in one go, and how to use it with arrays, boost::array or std::vector.
+
+[heading Remarks]
+      
+This overload is equivalent to calling: 
+
+   boost::asio::read(
+       s, buffers,
+       boost::asio::transfer_all()); 
+
+
+
+
+
+
+[endsect]
+
+
+
+[section:overload2 read (2 of 6 overloads)]
+
+Attempt to read a certain amount of data from a stream before returning. 
+
+  template<
+      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
+      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``,
+      typename CompletionCondition>
+  std::size_t read(
+      SyncReadStream & s,
+      const MutableBufferSequence & buffers,
+      CompletionCondition completion_condition);
+
+
+This function is used to read a certain number of bytes of data from a stream. The call will block until one of the following conditions is true:
+
+
+* The supplied buffers are full. That is, the bytes transferred is equal to the sum of the buffer sizes.
+
+* The completion_condition function object returns true.
+
+This operation is implemented in terms of one or more calls to the stream's read\_some function.
+
+
+[heading Parameters]
+    
+
+[variablelist
+  
+[[s][The stream from which the data is to be read. The type must support the SyncReadStream concept.]]
+
+[[buffers][One or more buffers into which the data will be read. The sum of the buffer sizes indicates the maximum number of bytes to read from the stream.]]
+
+[[completion_condition][The function object to be called to determine whether the read operation is complete. The signature of the function object must be: 
+``
+   bool completion_condition(
+     const boost::system::error_code& error, // Result of latest read_some
+                                             // operation.
+
+     std::size_t bytes_transferred           // Number of bytes transferred
+                                             // so far.
+   ); 
+
+``
+A return value of true indicates that the read operation is complete. False indicates that further calls to the stream's read\_some function are required.]]
+
+]
+
+[heading Return Value]
+      
+The number of bytes transferred.
+
+[heading Exceptions]
+    
+
+[variablelist
+  
+[[boost::system::system_error][Thrown on failure.]]
+
+]
+
+[heading Example]
+  
+To read into a single data buffer use the 
+[link boost_asio.reference.buffer buffer]  function as follows: 
+
+   boost::asio::read(s, boost::asio::buffer(data, size),
+       boost::asio::transfer_at_least(32)); 
+
+
+See the 
+[link boost_asio.reference.buffer buffer]  documentation for information on reading into multiple buffers in one go, and how to use it with arrays, boost::array or std::vector. 
+
+
+
+[endsect]
+
+
+
+[section:overload3 read (3 of 6 overloads)]
+
+Attempt to read a certain amount of data from a stream before returning. 
+
+  template<
+      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
+      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``,
+      typename CompletionCondition>
+  std::size_t read(
+      SyncReadStream & s,
+      const MutableBufferSequence & buffers,
+      CompletionCondition completion_condition,
+      boost::system::error_code & ec);
+
+
+This function is used to read a certain number of bytes of data from a stream. The call will block until one of the following conditions is true:
+
+
+* The supplied buffers are full. That is, the bytes transferred is equal to the sum of the buffer sizes.
+
+* The completion_condition function object returns true.
+
+This operation is implemented in terms of one or more calls to the stream's read\_some function.
+
+
+[heading Parameters]
+    
+
+[variablelist
+  
+[[s][The stream from which the data is to be read. The type must support the SyncReadStream concept.]]
+
+[[buffers][One or more buffers into which the data will be read. The sum of the buffer sizes indicates the maximum number of bytes to read from the stream.]]
+
+[[completion_condition][The function object to be called to determine whether the read operation is complete. The signature of the function object must be: 
+``
+   bool completion_condition(
+     const boost::system::error_code& error, // Result of latest read_some
+                                             // operation.
+
+     std::size_t bytes_transferred           // Number of bytes transferred
+                                             // so far.
+   ); 
+
+``
+A return value of true indicates that the read operation is complete. False indicates that further calls to the stream's read\_some function are required.]]
+
+[[ec][Set to indicate what error occurred, if any.]]
+
+]
+
+[heading Return Value]
+      
+The number of bytes read. If an error occurs, returns the total number of bytes successfully transferred prior to the error. 
+
+
+
+[endsect]
+
+
+
+[section:overload4 read (4 of 6 overloads)]
+
+Attempt to read a certain amount of data from a stream before returning. 
+
+  template<
+      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
+      typename Allocator>
+  std::size_t read(
+      SyncReadStream & s,
+      basic_streambuf< Allocator > & b);
+
+
+This function is used to read a certain number of bytes of data from a stream. The call will block until one of the following conditions is true:
+
+
+* An error occurred.
+
+This operation is implemented in terms of one or more calls to the stream's read\_some function.
+
+
+[heading Parameters]
+    
+
+[variablelist
+  
+[[s][The stream from which the data is to be read. The type must support the SyncReadStream concept.]]
+
+[[b][The basic\_streambuf object into which the data will be read.]]
+
+]
+
+[heading Return Value]
+      
+The number of bytes transferred.
+
+[heading Exceptions]
+    
+
+[variablelist
+  
+[[boost::system::system_error][Thrown on failure.]]
+
+]
+
+[heading Remarks]
+      
+This overload is equivalent to calling: 
+
+   boost::asio::read(
+       s, b,
+       boost::asio::transfer_all()); 
+
+
+
+
+
+
+[endsect]
+
+
+
+[section:overload5 read (5 of 6 overloads)]
+
+Attempt to read a certain amount of data from a stream before returning. 
+
+  template<
+      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
+      typename Allocator,
+      typename CompletionCondition>
+  std::size_t read(
+      SyncReadStream & s,
+      basic_streambuf< Allocator > & b,
+      CompletionCondition completion_condition);
+
+
+This function is used to read a certain number of bytes of data from a stream. The call will block until one of the following conditions is true:
+
+
+* The completion_condition function object returns true.
+
+This operation is implemented in terms of one or more calls to the stream's read\_some function.
+
+
+[heading Parameters]
+    
+
+[variablelist
+  
+[[s][The stream from which the data is to be read. The type must support the SyncReadStream concept.]]
+
+[[b][The basic\_streambuf object into which the data will be read.]]
+
+[[completion_condition][The function object to be called to determine whether the read operation is complete. The signature of the function object must be: 
+``
+   bool completion_condition(
+     const boost::system::error_code& error, // Result of latest read_some
+                                             // operation.
+
+     std::size_t bytes_transferred           // Number of bytes transferred
+                                             // so far.
+   ); 
+
+``
+A return value of true indicates that the read operation is complete. False indicates that further calls to the stream's read\_some function are required.]]
+
+]
+
+[heading Return Value]
+      
+The number of bytes transferred.
+
+[heading Exceptions]
+    
+
+[variablelist
+  
+[[boost::system::system_error][Thrown on failure. ]]
+
+]
+
+
+
+[endsect]
+
+
+
+[section:overload6 read (6 of 6 overloads)]
+
+Attempt to read a certain amount of data from a stream before returning. 
+
+  template<
+      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
+      typename Allocator,
+      typename CompletionCondition>
+  std::size_t read(
+      SyncReadStream & s,
+      basic_streambuf< Allocator > & b,
+      CompletionCondition completion_condition,
+      boost::system::error_code & ec);
+
+
+This function is used to read a certain number of bytes of data from a stream. The call will block until one of the following conditions is true:
+
+
+* The completion_condition function object returns true.
+
+This operation is implemented in terms of one or more calls to the stream's read\_some function.
+
+
+[heading Parameters]
+    
+
+[variablelist
+  
+[[s][The stream from which the data is to be read. The type must support the SyncReadStream concept.]]
+
+[[b][The basic\_streambuf object into which the data will be read.]]
+
+[[completion_condition][The function object to be called to determine whether the read operation is complete. The signature of the function object must be: 
+``
+   bool completion_condition(
+     const boost::system::error_code& error, // Result of latest read_some
+                                             // operation.
+
+     std::size_t bytes_transferred           // Number of bytes transferred
+                                             // so far.
+   ); 
+
+``
+A return value of true indicates that the read operation is complete. False indicates that further calls to the stream's read\_some function are required.]]
+
+[[ec][Set to indicate what error occurred, if any.]]
+
+]
+
+[heading Return Value]
+      
+The number of bytes read. If an error occurs, returns the total number of bytes successfully transferred prior to the error. 
+
+
+
+[endsect]
+
+
+[endsect]
+
+[section:read_until read_until]
+
+Read data into a streambuf until a delimiter is encountered. 
+
+  template<
+      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
+      typename Allocator>
+  std::size_t ``[link boost_asio.reference.read_until.overload1 read_until]``(
+      SyncReadStream & s,
+      boost::asio::basic_streambuf< Allocator > & b,
+      char delim);
+
+  template<
+      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
+      typename Allocator>
+  std::size_t ``[link boost_asio.reference.read_until.overload2 read_until]``(
+      SyncReadStream & s,
+      boost::asio::basic_streambuf< Allocator > & b,
+      char delim,
+      boost::system::error_code & ec);
+
+  template<
+      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
+      typename Allocator>
+  std::size_t ``[link boost_asio.reference.read_until.overload3 read_until]``(
+      SyncReadStream & s,
+      boost::asio::basic_streambuf< Allocator > & b,
+      const std::string & delim);
+
+  template<
+      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
+      typename Allocator>
+  std::size_t ``[link boost_asio.reference.read_until.overload4 read_until]``(
+      SyncReadStream & s,
+      boost::asio::basic_streambuf< Allocator > & b,
+      const std::string & delim,
+      boost::system::error_code & ec);
+
+  template<
+      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
+      typename Allocator>
+  std::size_t ``[link boost_asio.reference.read_until.overload5 read_until]``(
+      SyncReadStream & s,
+      boost::asio::basic_streambuf< Allocator > & b,
+      const boost::regex & expr);
+
+  template<
+      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
+      typename Allocator>
+  std::size_t ``[link boost_asio.reference.read_until.overload6 read_until]``(
+      SyncReadStream & s,
+      boost::asio::basic_streambuf< Allocator > & b,
+      const boost::regex & expr,
+      boost::system::error_code & ec);
+
+
+[section:overload1 read_until (1 of 6 overloads)]
+
+Read data into a streambuf until a delimiter is encountered. 
+
+  template<
+      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
+      typename Allocator>
+  std::size_t read_until(
+      SyncReadStream & s,
+      boost::asio::basic_streambuf< Allocator > & b,
+      char delim);
+
+
+This function is used to read data into the specified streambuf until the streambuf's get area contains the specified delimiter. The call will block until one of the following conditions is true:
+
+
+* The get area of the streambuf contains the specified delimiter.
+
+* An error occurred.
+
+This operation is implemented in terms of zero or more calls to the stream's read\_some function. If the streambuf's get area already contains the delimiter, the function returns immediately.
+
+
+[heading Parameters]
+    
+
+[variablelist
+  
+[[s][The stream from which the data is to be read. The type must support the SyncReadStream concept.]]
+
+[[b][A streambuf object into which the data will be read.]]
+
+[[delim][The delimiter character.]]
+
+]
+
+[heading Return Value]
+      
+The number of bytes in the streambuf's get area up to and including the delimiter.
+
+[heading Exceptions]
+    
+
+[variablelist
+  
+[[boost::system::system_error][Thrown on failure.]]
+
+]
+
+[heading Example]
+  
+To read data into a streambuf until a newline is encountered: 
+
+   boost::asio::streambuf b;
+   boost::asio::read_until(s, b, '\n');
+   std::istream is(&b);
+   std::string line;
+   std::getline(is, line); 
+
+
+
+
+
+
+[endsect]
+
+
+
+[section:overload2 read_until (2 of 6 overloads)]
+
+Read data into a streambuf until a delimiter is encountered. 
+
+  template<
+      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
+      typename Allocator>
+  std::size_t read_until(
+      SyncReadStream & s,
+      boost::asio::basic_streambuf< Allocator > & b,
+      char delim,
+      boost::system::error_code & ec);
+
+
+This function is used to read data into the specified streambuf until the streambuf's get area contains the specified delimiter. The call will block until one of the following conditions is true:
+
+
+* The get area of the streambuf contains the specified delimiter.
+
+* An error occurred.
+
+This operation is implemented in terms of zero or more calls to the stream's read\_some function. If the streambuf's get area already contains the delimiter, the function returns immediately.
+
+
+[heading Parameters]
+    
+
+[variablelist
+  
+[[s][The stream from which the data is to be read. The type must support the SyncReadStream concept.]]
+
+[[b][A streambuf object into which the data will be read.]]
+
+[[delim][The delimiter character.]]
+
+[[ec][Set to indicate what error occurred, if any.]]
+
+]
+
+[heading Return Value]
+      
+The number of bytes in the streambuf's get area up to and including the delimiter. Returns 0 if an error occurred. 
+
+
+
+[endsect]
+
+
+
+[section:overload3 read_until (3 of 6 overloads)]
+
+Read data into a streambuf until a delimiter is encountered. 
+
+  template<
+      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
+      typename Allocator>
+  std::size_t read_until(
+      SyncReadStream & s,
+      boost::asio::basic_streambuf< Allocator > & b,
+      const std::string & delim);
+
+
+This function is used to read data into the specified streambuf until the streambuf's get area contains the specified delimiter. The call will block until one of the following conditions is true:
+
+
+* The get area of the streambuf contains the specified delimiter.
+
+* An error occurred.
+
+This operation is implemented in terms of zero or more calls to the stream's read\_some function. If the streambuf's get area already contains the delimiter, the function returns immediately.
+
+
+[heading Parameters]
+    
+
+[variablelist
+  
+[[s][The stream from which the data is to be read. The type must support the SyncReadStream concept.]]
+
+[[b][A streambuf object into which the data will be read.]]
+
+[[delim][The delimiter string.]]
+
+]
+
+[heading Return Value]
+      
+The number of bytes in the streambuf's get area up to and including the delimiter.
+
+[heading Exceptions]
+    
+
+[variablelist
+  
+[[boost::system::system_error][Thrown on failure.]]
+
+]
+
+[heading Example]
+  
+To read data into a streambuf until a newline is encountered: 
+
+   boost::asio::streambuf b;
+   boost::asio::read_until(s, b, "\r\n");
+   std::istream is(&b);
+   std::string line;
+   std::getline(is, line); 
+
+
+
+
+
+
+[endsect]
+
+
+
+[section:overload4 read_until (4 of 6 overloads)]
+
+Read data into a streambuf until a delimiter is encountered. 
+
+  template<
+      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
+      typename Allocator>
+  std::size_t read_until(
+      SyncReadStream & s,
+      boost::asio::basic_streambuf< Allocator > & b,
+      const std::string & delim,
+      boost::system::error_code & ec);
+
+
+This function is used to read data into the specified streambuf until the streambuf's get area contains the specified delimiter. The call will block until one of the following conditions is true:
+
+
+* The get area of the streambuf contains the specified delimiter.
+
+* An error occurred.
+
+This operation is implemented in terms of zero or more calls to the stream's read\_some function. If the streambuf's get area already contains the delimiter, the function returns immediately.
+
+
+[heading Parameters]
+    
+
+[variablelist
+  
+[[s][The stream from which the data is to be read. The type must support the SyncReadStream concept.]]
+
+[[b][A streambuf object into which the data will be read.]]
+
+[[delim][The delimiter string.]]
+
+[[ec][Set to indicate what error occurred, if any.]]
+
+]
+
+[heading Return Value]
+      
+The number of bytes in the streambuf's get area up to and including the delimiter. Returns 0 if an error occurred. 
+
+
+
+[endsect]
+
+
+
+[section:overload5 read_until (5 of 6 overloads)]
+
+Read data into a streambuf until a regular expression is located. 
+
+  template<
+      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
+      typename Allocator>
+  std::size_t read_until(
+      SyncReadStream & s,
+      boost::asio::basic_streambuf< Allocator > & b,
+      const boost::regex & expr);
+
+
+This function is used to read data into the specified streambuf until the streambuf's get area contains some data that matches a regular expression. The call will block until one of the following conditions is true:
+
+
+* A substring of the streambuf's get area matches the regular expression.
+
+* An error occurred.
+
+This operation is implemented in terms of zero or more calls to the stream's read\_some function. If the streambuf's get area already contains data that matches the regular expression, the function returns immediately.
+
+
+[heading Parameters]
+    
+
+[variablelist
+  
+[[s][The stream from which the data is to be read. The type must support the SyncReadStream concept.]]
+
+[[b][A streambuf object into which the data will be read.]]
+
+[[expr][The regular expression.]]
+
+]
+
+[heading Return Value]
+      
+The number of bytes in the streambuf's get area up to and including the substring that matches the regular expression.
+
+[heading Exceptions]
+    
+
+[variablelist
+  
+[[boost::system::system_error][Thrown on failure.]]
+
+]
+
+[heading Example]
+  
+To read data into a streambuf until a CR-LF sequence is encountered: 
+
+   boost::asio::streambuf b;
+   boost::asio::read_until(s, b, boost::regex("\r\n"));
+   std::istream is(&b);
+   std::string line;
+   std::getline(is, line); 
+
+
+
+
+
+
+[endsect]
+
+
+
+[section:overload6 read_until (6 of 6 overloads)]
+
+Read data into a streambuf until a regular expression is located. 
+
+  template<
+      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
+      typename Allocator>
+  std::size_t read_until(
+      SyncReadStream & s,
+      boost::asio::basic_streambuf< Allocator > & b,
+      const boost::regex & expr,
+      boost::system::error_code & ec);
+
+
+This function is used to read data into the specified streambuf until the streambuf's get area contains some data that matches a regular expression. The call will block until one of the following conditions is true:
+
+
+* A substring of the streambuf's get area matches the regular expression.
+
+* An error occurred.
+
+This operation is implemented in terms of zero or more calls to the stream's read\_some function. If the streambuf's get area already contains data that matches the regular expression, the function returns immediately.
+
+
+[heading Parameters]
+    
+
+[variablelist
+  
+[[s][The stream from which the data is to be read. The type must support the SyncReadStream concept.]]
+
+[[b][A streambuf object into which the data will be read.]]
+
+[[expr][The regular expression.]]
+
+[[ec][Set to indicate what error occurred, if any.]]
+
+]
+
+[heading Return Value]
+      
+The number of bytes in the streambuf's get area up to and including the substring that matches the regular expression. Returns 0 if an error occurred. 
+
+
+
+[endsect]
+
+
+[endsect]
+
+[section:service_already_exists service_already_exists]
+
+Exception thrown when trying to add a duplicate service to an io_service. 
+
+  class service_already_exists
+
+
+[heading Member Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.service_already_exists.service_already_exists [*service_already_exists]]]
+    []
+  ]
+  
+]
+
+
+[section:service_already_exists service_already_exists::service_already_exists]
+
+
+
+  service_already_exists();
+
+
+
+[endsect]
+
+
+
+[endsect]
+
+[section:socket_acceptor_service socket_acceptor_service]
+
+Default service implementation for a socket acceptor. 
+
+  template<
+      typename ``[link boost_asio.reference.Protocol Protocol]``>
+  class socket_acceptor_service :
+    public io_service::service
+
+
+[heading Types]
+[table
+  [[Name][Description]]
+
+  [
+
+    [[link boost_asio.reference.socket_acceptor_service.endpoint_type [*endpoint_type]]]
+    [The endpoint type. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.socket_acceptor_service.implementation_type [*implementation_type]]]
+    [The native type of the socket acceptor. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.socket_acceptor_service.native_type [*native_type]]]
+    [The native acceptor type. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.socket_acceptor_service.protocol_type [*protocol_type]]]
+    [The protocol type. ]
+  
+  ]
+
+]
+
+[heading Member Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.socket_acceptor_service.accept [*accept]]]
+    [Accept a new connection. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.socket_acceptor_service.assign [*assign]]]
+    [Assign an existing native acceptor to a socket acceptor. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.socket_acceptor_service.async_accept [*async_accept]]]
+    [Start an asynchronous accept. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.socket_acceptor_service.bind [*bind]]]
+    [Bind the socket acceptor to the specified local endpoint. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.socket_acceptor_service.cancel [*cancel]]]
+    [Cancel all asynchronous operations associated with the acceptor. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.socket_acceptor_service.close [*close]]]
+    [Close a socket acceptor implementation. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.socket_acceptor_service.construct [*construct]]]
+    [Construct a new socket acceptor implementation. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.socket_acceptor_service.destroy [*destroy]]]
+    [Destroy a socket acceptor implementation. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.socket_acceptor_service.get_io_service [*get_io_service]]]
+    [Get the io_service object that owns the service. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.socket_acceptor_service.get_option [*get_option]]]
+    [Get a socket option. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.socket_acceptor_service.io_control [*io_control]]]
+    [Perform an IO control command on the socket. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.socket_acceptor_service.io_service [*io_service]]]
+    [(Deprecated: use get_io_service().) Get the io_service object that owns the service. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.socket_acceptor_service.is_open [*is_open]]]
+    [Determine whether the acceptor is open. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.socket_acceptor_service.listen [*listen]]]
+    [Place the socket acceptor into the state where it will listen for new connections. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.socket_acceptor_service.local_endpoint [*local_endpoint]]]
+    [Get the local endpoint. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.socket_acceptor_service.native [*native]]]
+    [Get the native acceptor implementation. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.socket_acceptor_service.open [*open]]]
+    [Open a new socket acceptor implementation. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.socket_acceptor_service.set_option [*set_option]]]
+    [Set a socket option. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.socket_acceptor_service.shutdown_service [*shutdown_service]]]
+    [Destroy all user-defined handler objects owned by the service. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.socket_acceptor_service.socket_acceptor_service [*socket_acceptor_service]]]
+    [Construct a new socket acceptor service for the specified io_service. ]
+  ]
+  
+]
+
+[heading Data Members]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.socket_acceptor_service.id [*id]]]
+    [The unique service identifier. ]
+  ]
+
+]
+
+
+[section:accept socket_acceptor_service::accept]
+
+Accept a new connection. 
+
+  template<
+      typename ``[link boost_asio.reference.SocketService SocketService]``>
+  boost::system::error_code accept(
+      implementation_type & impl,
+      basic_socket< protocol_type, SocketService > & peer,
+      endpoint_type * peer_endpoint,
+      boost::system::error_code & ec);
+
+
+
+[endsect]
+
+
+
+[section:assign socket_acceptor_service::assign]
+
+Assign an existing native acceptor to a socket acceptor. 
+
+  boost::system::error_code assign(
+      implementation_type & impl,
+      const protocol_type & protocol,
+      const native_type & native_acceptor,
+      boost::system::error_code & ec);
+
+
+
+[endsect]
+
+
+
+[section:async_accept socket_acceptor_service::async_accept]
+
+Start an asynchronous accept. 
+
+  template<
+      typename ``[link boost_asio.reference.SocketService SocketService]``,
+      typename ``[link boost_asio.reference.AcceptHandler AcceptHandler]``>
+  void async_accept(
+      implementation_type & impl,
+      basic_socket< protocol_type, SocketService > & peer,
+      endpoint_type * peer_endpoint,
+      AcceptHandler handler);
+
+
+
+[endsect]
+
+
+
+[section:bind socket_acceptor_service::bind]
+
+Bind the socket acceptor to the specified local endpoint. 
+
+  boost::system::error_code bind(
+      implementation_type & impl,
+      const endpoint_type & endpoint,
+      boost::system::error_code & ec);
+
+
+
+[endsect]
+
+
+
+[section:cancel socket_acceptor_service::cancel]
+
+Cancel all asynchronous operations associated with the acceptor. 
+
+  boost::system::error_code cancel(
+      implementation_type & impl,
+      boost::system::error_code & ec);
+
+
+
+[endsect]
+
+
+
+[section:close socket_acceptor_service::close]
+
+Close a socket acceptor implementation. 
+
+  boost::system::error_code close(
+      implementation_type & impl,
+      boost::system::error_code & ec);
+
+
+
+[endsect]
+
+
+
+[section:construct socket_acceptor_service::construct]
+
+Construct a new socket acceptor implementation. 
+
+  void construct(
+      implementation_type & impl);
+
+
+
+[endsect]
+
+
+
+[section:destroy socket_acceptor_service::destroy]
+
+Destroy a socket acceptor implementation. 
+
+  void destroy(
+      implementation_type & impl);
+
+
+
+[endsect]
+
+
+
+[section:endpoint_type socket_acceptor_service::endpoint_type]
+
+The endpoint type. 
+
+  typedef protocol_type::endpoint endpoint_type;
+
+
+
+
+[endsect]
+
+
+
+[section:get_io_service socket_acceptor_service::get_io_service]
+
+
+['Inherited from io_service.]
+
+Get the io_service object that owns the service. 
+
+  boost::asio::io_service & get_io_service();
+
+
+
+[endsect]
+
+
+
+[section:get_option socket_acceptor_service::get_option]
+
+Get a socket option. 
+
+  template<
+      typename ``[link boost_asio.reference.GettableSocketOption GettableSocketOption]``>
+  boost::system::error_code get_option(
+      const implementation_type & impl,
+      GettableSocketOption & option,
+      boost::system::error_code & ec) const;
+
+
+
+[endsect]
+
+
+
+[section:id socket_acceptor_service::id]
+
+The unique service identifier. 
+
+  static boost::asio::io_service::id id;
+
+
+
+[endsect]
+
+
+
+[section:implementation_type socket_acceptor_service::implementation_type]
+
+The native type of the socket acceptor. 
+
+  typedef implementation_defined implementation_type;
+
+
+
+
+[endsect]
+
+
+
+[section:io_control socket_acceptor_service::io_control]
+
+Perform an IO control command on the socket. 
+
+  template<
+      typename ``[link boost_asio.reference.IoControlCommand IoControlCommand]``>
+  boost::system::error_code io_control(
+      implementation_type & impl,
+      IoControlCommand & command,
+      boost::system::error_code & ec);
+
+
+
+[endsect]
+
+
+
+[section:io_service socket_acceptor_service::io_service]
+
+
+['Inherited from io_service.]
+
+(Deprecated: use get_io_service().) Get the io_service object that owns the service. 
+
+  boost::asio::io_service & io_service();
+
+
+
+[endsect]
+
+
+
+[section:is_open socket_acceptor_service::is_open]
+
+Determine whether the acceptor is open. 
+
+  bool is_open(
+      const implementation_type & impl) const;
+
+
+
+[endsect]
+
+
+
+[section:listen socket_acceptor_service::listen]
+
+Place the socket acceptor into the state where it will listen for new connections. 
+
+  boost::system::error_code listen(
+      implementation_type & impl,
+      int backlog,
+      boost::system::error_code & ec);
+
+
+
+[endsect]
+
+
+
+[section:local_endpoint socket_acceptor_service::local_endpoint]
+
+Get the local endpoint. 
+
+  endpoint_type local_endpoint(
+      const implementation_type & impl,
+      boost::system::error_code & ec) const;
+
+
+
+[endsect]
+
+
+
+[section:native socket_acceptor_service::native]
+
+Get the native acceptor implementation. 
+
+  native_type native(
+      implementation_type & impl);
+
+
+
+[endsect]
+
+
+
+[section:native_type socket_acceptor_service::native_type]
+
+The native acceptor type. 
+
+  typedef implementation_defined native_type;
+
+
+
+
+[endsect]
+
+
+
+[section:open socket_acceptor_service::open]
+
+Open a new socket acceptor implementation. 
+
+  boost::system::error_code open(
+      implementation_type & impl,
+      const protocol_type & protocol,
+      boost::system::error_code & ec);
+
+
+
+[endsect]
+
+
+
+[section:protocol_type socket_acceptor_service::protocol_type]
+
+The protocol type. 
+
+  typedef Protocol protocol_type;
+
+
+
+
+[endsect]
+
+
+
+[section:set_option socket_acceptor_service::set_option]
+
+Set a socket option. 
+
+  template<
+      typename ``[link boost_asio.reference.SettableSocketOption SettableSocketOption]``>
+  boost::system::error_code set_option(
+      implementation_type & impl,
+      const SettableSocketOption & option,
+      boost::system::error_code & ec);
+
+
+
+[endsect]
+
+
+
+[section:shutdown_service socket_acceptor_service::shutdown_service]
+
+Destroy all user-defined handler objects owned by the service. 
+
+  void shutdown_service();
+
+
+
+[endsect]
+
+
+
+[section:socket_acceptor_service socket_acceptor_service::socket_acceptor_service]
+
+Construct a new socket acceptor service for the specified io_service. 
+
+  socket_acceptor_service(
+      boost::asio::io_service & io_service);
+
+
+
+[endsect]
+
+
+
+[endsect]
+
+[section:socket_base socket_base]
+
+The socket_base class is used as a base for the basic_stream_socket and basic_datagram_socket class templates so that we have a common place to define the shutdown_type and enum. 
+
+  class socket_base
+
+
+[heading Types]
+[table
+  [[Name][Description]]
+
+  [
+
+    [[link boost_asio.reference.socket_base.broadcast [*broadcast]]]
+    [Socket option to permit sending of broadcast messages. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.socket_base.bytes_readable [*bytes_readable]]]
+    [IO control command to get the amount of data that can be read without blocking. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.socket_base.debug [*debug]]]
+    [Socket option to enable socket-level debugging. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.socket_base.do_not_route [*do_not_route]]]
+    [Socket option to prevent routing, use local interfaces only. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.socket_base.enable_connection_aborted [*enable_connection_aborted]]]
+    [Socket option to report aborted connections on accept. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.socket_base.keep_alive [*keep_alive]]]
+    [Socket option to send keep-alives. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.socket_base.linger [*linger]]]
+    [Socket option to specify whether the socket lingers on close if unsent data is present. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.socket_base.message_flags [*message_flags]]]
+    [Bitmask type for flags that can be passed to send and receive operations. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.socket_base.non_blocking_io [*non_blocking_io]]]
+    [IO control command to set the blocking mode of the socket. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.socket_base.receive_buffer_size [*receive_buffer_size]]]
+    [Socket option for the receive buffer size of a socket. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.socket_base.receive_low_watermark [*receive_low_watermark]]]
+    [Socket option for the receive low watermark. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.socket_base.reuse_address [*reuse_address]]]
+    [Socket option to allow the socket to be bound to an address that is already in use. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.socket_base.send_buffer_size [*send_buffer_size]]]
+    [Socket option for the send buffer size of a socket. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.socket_base.send_low_watermark [*send_low_watermark]]]
+    [Socket option for the send low watermark. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.socket_base.shutdown_type [*shutdown_type]]]
+    [Different ways a socket may be shutdown. ]
+  
+  ]
+
+]
+
+[heading Protected Member Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.socket_base._socket_base [*~socket_base]]]
+    [Protected destructor to prevent deletion through this type. ]
+  ]
+  
+]
+
+[heading Data Members]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.socket_base.max_connections [*max_connections]]]
+    [The maximum length of the queue of pending incoming connections. ]
+  ]
+
+  [
+    [[link boost_asio.reference.socket_base.message_do_not_route [*message_do_not_route]]]
+    [Specify that the data should not be subject to routing. ]
+  ]
+
+  [
+    [[link boost_asio.reference.socket_base.message_out_of_band [*message_out_of_band]]]
+    [Process out-of-band data. ]
+  ]
+
+  [
+    [[link boost_asio.reference.socket_base.message_peek [*message_peek]]]
+    [Peek at incoming data without removing it from the input queue. ]
+  ]
+
+]
+
+
+[section:broadcast socket_base::broadcast]
+
+Socket option to permit sending of broadcast messages. 
+
+  typedef implementation_defined broadcast;
+
+
+
+Implements the SOL\_SOCKET/SO\_BROADCAST socket option.
+
+
+[heading Examples]
+  
+Setting the option: 
+
+   boost::asio::ip::udp::socket socket(io_service); 
+   ...
+   boost::asio::socket_base::broadcast option(true);
+   socket.set_option(option);
+
+
+
+
+Getting the current option value: 
+
+   boost::asio::ip::udp::socket socket(io_service); 
+   ...
+   boost::asio::socket_base::broadcast option;
+   socket.get_option(option);
+   bool is_set = option.value();
+
+
+
+
+
+
+[endsect]
+
+
+
+[section:bytes_readable socket_base::bytes_readable]
+
+IO control command to get the amount of data that can be read without blocking. 
+
+  typedef implementation_defined bytes_readable;
+
+
+
+Implements the FIONREAD IO control command.
+
+
+[heading Example]
+  
+
+
+   boost::asio::ip::tcp::socket socket(io_service); 
+   ...
+   boost::asio::socket_base::bytes_readable command(true);
+   socket.io_control(command);
+   std::size_t bytes_readable = command.get();
+
+
+
+
+
+
+[endsect]
+
+
+
+[section:debug socket_base::debug]
+
+Socket option to enable socket-level debugging. 
+
+  typedef implementation_defined debug;
+
+
+
+Implements the SOL\_SOCKET/SO\_DEBUG socket option.
+
+
+[heading Examples]
+  
+Setting the option: 
+
+   boost::asio::ip::tcp::socket socket(io_service); 
+   ...
+   boost::asio::socket_base::debug option(true);
+   socket.set_option(option);
+
+
+
+
+Getting the current option value: 
+
+   boost::asio::ip::tcp::socket socket(io_service); 
+   ...
+   boost::asio::socket_base::debug option;
+   socket.get_option(option);
+   bool is_set = option.value();
+
+
+
+
+
+
+[endsect]
+
+
+
+[section:do_not_route socket_base::do_not_route]
+
+Socket option to prevent routing, use local interfaces only. 
+
+  typedef implementation_defined do_not_route;
+
+
+
+Implements the SOL\_SOCKET/SO\_DONTROUTE socket option.
+
+
+[heading Examples]
+  
+Setting the option: 
+
+   boost::asio::ip::udp::socket socket(io_service); 
+   ...
+   boost::asio::socket_base::do_not_route option(true);
+   socket.set_option(option);
+
+
+
+
+Getting the current option value: 
+
+   boost::asio::ip::udp::socket socket(io_service); 
+   ...
+   boost::asio::socket_base::do_not_route option;
+   socket.get_option(option);
+   bool is_set = option.value();
+
+
+
+
+
+
+[endsect]
+
+
+
+[section:enable_connection_aborted socket_base::enable_connection_aborted]
+
+Socket option to report aborted connections on accept. 
+
+  typedef implementation_defined enable_connection_aborted;
+
+
+
+Implements a custom socket option that determines whether or not an accept operation is permitted to fail with boost::asio::error::connection\_aborted. By default the option is false.
+
+
+[heading Examples]
+  
+Setting the option: 
+
+   boost::asio::ip::tcp::acceptor acceptor(io_service); 
+   ...
+   boost::asio::socket_base::enable_connection_aborted option(true);
+   acceptor.set_option(option);
+
+
+
+
+Getting the current option value: 
+
+   boost::asio::ip::tcp::acceptor acceptor(io_service); 
+   ...
+   boost::asio::socket_base::enable_connection_aborted option;
+   acceptor.get_option(option);
+   bool is_set = option.value();
+
+
+
+
+
+
+[endsect]
+
+
+
+[section:keep_alive socket_base::keep_alive]
+
+Socket option to send keep-alives. 
+
+  typedef implementation_defined keep_alive;
+
+
+
+Implements the SOL\_SOCKET/SO\_KEEPALIVE socket option.
+
+
+[heading Examples]
+  
+Setting the option: 
+
+   boost::asio::ip::tcp::socket socket(io_service); 
+   ...
+   boost::asio::socket_base::keep_alive option(true);
+   socket.set_option(option);
+
+
+
+
+Getting the current option value: 
+
+   boost::asio::ip::tcp::socket socket(io_service); 
+   ...
+   boost::asio::socket_base::keep_alive option;
+   socket.get_option(option);
+   bool is_set = option.value();
+
 
 
-[endsect]
 
 
 
-[section:overload6 read (6 of 6 overloads)]
+[endsect]
 
-Attempt to read a certain amount of data from a stream before returning. 
 
-  template<
-      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
-      typename Allocator,
-      typename CompletionCondition>
-  std::size_t read(
-      SyncReadStream & s,
-      basic_streambuf< Allocator > & b,
-      CompletionCondition completion_condition,
-      boost::system::error_code & ec);
 
+[section:linger socket_base::linger]
 
-This function is used to read a certain number of bytes of data from a stream. The call will block until one of the following conditions is true:
+Socket option to specify whether the socket lingers on close if unsent data is present. 
 
+  typedef implementation_defined linger;
 
-* The completion_condition function object returns true.
 
-This operation is implemented in terms of one or more calls to the stream's read\_some function.
 
+Implements the SOL\_SOCKET/SO\_LINGER socket option.
 
-[heading Parameters]
-    
 
-[variablelist
+[heading Examples]
   
-[[s][The stream from which the data is to be read. The type must support the SyncReadStream concept.]]
+Setting the option: 
 
-[[b][The basic\_streambuf object into which the data will be read.]]
+   boost::asio::ip::tcp::socket socket(io_service); 
+   ...
+   boost::asio::socket_base::linger option(true, 30);
+   socket.set_option(option);
 
-[[completion_condition][The function object to be called to determine whether the read operation is complete. The signature of the function object must be: 
-``
-   bool completion_condition(
-     const boost::system::error_code& error, // Result of latest read_some
-                                             // operation.
 
-     std::size_t bytes_transferred           // Number of bytes transferred
-                                             // so far.
-   ); 
 
-``
-A return value of true indicates that the read operation is complete. False indicates that further calls to the stream's read\_some function are required.]]
 
-[[ec][Set to indicate what error occurred, if any.]]
+Getting the current option value: 
 
-]
+   boost::asio::ip::tcp::socket socket(io_service); 
+   ...
+   boost::asio::socket_base::linger option;
+   socket.get_option(option);
+   bool is_set = option.enabled();
+   unsigned short timeout = option.timeout();
 
-[heading Return Value]
-      
-The number of bytes read. If an error occurs, returns the total number of bytes successfully transferred prior to the error. 
 
 
 
-[endsect]
 
 
 [endsect]
 
-[section:read_until read_until]
 
-Read data into a streambuf until a delimiter is encountered. 
 
-  template<
-      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
-      typename Allocator>
-  std::size_t ``[link boost_asio.reference.read_until.overload1 read_until]``(
-      SyncReadStream & s,
-      boost::asio::basic_streambuf< Allocator > & b,
-      char delim);
+[section:max_connections socket_base::max_connections]
 
-  template<
-      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
-      typename Allocator>
-  std::size_t ``[link boost_asio.reference.read_until.overload2 read_until]``(
-      SyncReadStream & s,
-      boost::asio::basic_streambuf< Allocator > & b,
-      char delim,
-      boost::system::error_code & ec);
+The maximum length of the queue of pending incoming connections. 
 
-  template<
-      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
-      typename Allocator>
-  std::size_t ``[link boost_asio.reference.read_until.overload3 read_until]``(
-      SyncReadStream & s,
-      boost::asio::basic_streambuf< Allocator > & b,
-      const std::string & delim);
+  static const int max_connections = implementation_defined;
 
-  template<
-      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
-      typename Allocator>
-  std::size_t ``[link boost_asio.reference.read_until.overload4 read_until]``(
-      SyncReadStream & s,
-      boost::asio::basic_streambuf< Allocator > & b,
-      const std::string & delim,
-      boost::system::error_code & ec);
 
-  template<
-      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
-      typename Allocator>
-  std::size_t ``[link boost_asio.reference.read_until.overload5 read_until]``(
-      SyncReadStream & s,
-      boost::asio::basic_streambuf< Allocator > & b,
-      const boost::regex & expr);
 
-  template<
-      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
-      typename Allocator>
-  std::size_t ``[link boost_asio.reference.read_until.overload6 read_until]``(
-      SyncReadStream & s,
-      boost::asio::basic_streambuf< Allocator > & b,
-      const boost::regex & expr,
-      boost::system::error_code & ec);
+[endsect]
 
 
-[section:overload1 read_until (1 of 6 overloads)]
 
-Read data into a streambuf until a delimiter is encountered. 
+[section:message_do_not_route socket_base::message_do_not_route]
 
-  template<
-      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
-      typename Allocator>
-  std::size_t read_until(
-      SyncReadStream & s,
-      boost::asio::basic_streambuf< Allocator > & b,
-      char delim);
+Specify that the data should not be subject to routing. 
 
+  static const int message_do_not_route = implementation_defined;
 
-This function is used to read data into the specified streambuf until the streambuf's get area contains the specified delimiter. The call will block until one of the following conditions is true:
 
 
-* The get area of the streambuf contains the specified delimiter.
+[endsect]
 
-* An error occurred.
 
-This operation is implemented in terms of zero or more calls to the stream's read\_some function. If the streambuf's get area already contains the delimiter, the function returns immediately.
 
+[section:message_flags socket_base::message_flags]
+
+Bitmask type for flags that can be passed to send and receive operations. 
 
-[heading Parameters]
-    
+  typedef int message_flags;
 
-[variablelist
-  
-[[s][The stream from which the data is to be read. The type must support the SyncReadStream concept.]]
 
-[[b][A streambuf object into which the data will be read.]]
 
-[[delim][The delimiter character.]]
 
-]
+[endsect]
 
-[heading Return Value]
-      
-The number of bytes in the streambuf's get area up to and including the delimiter.
 
-[heading Exceptions]
-    
 
-[variablelist
-  
-[[boost::system::system_error][Thrown on failure.]]
+[section:message_out_of_band socket_base::message_out_of_band]
 
-]
+Process out-of-band data. 
 
-[heading Example]
-  
-To read data into a streambuf until a newline is encountered: 
+  static const int message_out_of_band = implementation_defined;
 
-   boost::asio::streambuf b;
-   boost::asio::read_until(s, b, '\n');
-   std::istream is(&b);
-   std::string line;
-   std::getline(is, line); 
 
 
+[endsect]
 
 
 
+[section:message_peek socket_base::message_peek]
 
-[endsect]
+Peek at incoming data without removing it from the input queue. 
 
+  static const int message_peek = implementation_defined;
 
 
-[section:overload2 read_until (2 of 6 overloads)]
 
-Read data into a streambuf until a delimiter is encountered. 
+[endsect]
 
-  template<
-      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
-      typename Allocator>
-  std::size_t read_until(
-      SyncReadStream & s,
-      boost::asio::basic_streambuf< Allocator > & b,
-      char delim,
-      boost::system::error_code & ec);
 
 
-This function is used to read data into the specified streambuf until the streambuf's get area contains the specified delimiter. The call will block until one of the following conditions is true:
+[section:non_blocking_io socket_base::non_blocking_io]
 
+IO control command to set the blocking mode of the socket. 
 
-* The get area of the streambuf contains the specified delimiter.
+  typedef implementation_defined non_blocking_io;
 
-* An error occurred.
 
-This operation is implemented in terms of zero or more calls to the stream's read\_some function. If the streambuf's get area already contains the delimiter, the function returns immediately.
 
+Implements the FIONBIO IO control command.
 
-[heading Parameters]
-    
 
-[variablelist
+[heading Example]
   
-[[s][The stream from which the data is to be read. The type must support the SyncReadStream concept.]]
 
-[[b][A streambuf object into which the data will be read.]]
 
-[[delim][The delimiter character.]]
+   boost::asio::ip::tcp::socket socket(io_service); 
+   ...
+   boost::asio::socket_base::non_blocking_io command(true);
+   socket.io_control(command);
 
-[[ec][Set to indicate what error occurred, if any.]]
 
-]
 
-[heading Return Value]
-      
-The number of bytes in the streambuf's get area up to and including the delimiter. Returns 0 if an error occurred. 
 
 
 
@@ -32240,265 +39968,243 @@
 
 
 
-[section:overload3 read_until (3 of 6 overloads)]
+[section:receive_buffer_size socket_base::receive_buffer_size]
 
-Read data into a streambuf until a delimiter is encountered. 
+Socket option for the receive buffer size of a socket. 
 
-  template<
-      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
-      typename Allocator>
-  std::size_t read_until(
-      SyncReadStream & s,
-      boost::asio::basic_streambuf< Allocator > & b,
-      const std::string & delim);
+  typedef implementation_defined receive_buffer_size;
 
 
-This function is used to read data into the specified streambuf until the streambuf's get area contains the specified delimiter. The call will block until one of the following conditions is true:
 
+Implements the SOL\_SOCKET/SO\_RCVBUF socket option.
 
-* The get area of the streambuf contains the specified delimiter.
 
-* An error occurred.
+[heading Examples]
+  
+Setting the option: 
 
-This operation is implemented in terms of zero or more calls to the stream's read\_some function. If the streambuf's get area already contains the delimiter, the function returns immediately.
+   boost::asio::ip::tcp::socket socket(io_service); 
+   ...
+   boost::asio::socket_base::receive_buffer_size option(8192);
+   socket.set_option(option);
 
 
-[heading Parameters]
-    
 
-[variablelist
-  
-[[s][The stream from which the data is to be read. The type must support the SyncReadStream concept.]]
 
-[[b][A streambuf object into which the data will be read.]]
+Getting the current option value: 
 
-[[delim][The delimiter string.]]
+   boost::asio::ip::tcp::socket socket(io_service); 
+   ...
+   boost::asio::socket_base::receive_buffer_size option;
+   socket.get_option(option);
+   int size = option.value();
 
-]
 
-[heading Return Value]
-      
-The number of bytes in the streambuf's get area up to and including the delimiter.
 
-[heading Exceptions]
-    
 
-[variablelist
-  
-[[boost::system::system_error][Thrown on failure.]]
 
-]
 
-[heading Example]
-  
-To read data into a streambuf until a newline is encountered: 
+[endsect]
 
-   boost::asio::streambuf b;
-   boost::asio::read_until(s, b, "\r\n");
-   std::istream is(&b);
-   std::string line;
-   std::getline(is, line); 
 
 
+[section:receive_low_watermark socket_base::receive_low_watermark]
 
+Socket option for the receive low watermark. 
 
+  typedef implementation_defined receive_low_watermark;
 
 
-[endsect]
 
+Implements the SOL\_SOCKET/SO\_RCVLOWAT socket option.
 
 
-[section:overload4 read_until (4 of 6 overloads)]
+[heading Examples]
+  
+Setting the option: 
 
-Read data into a streambuf until a delimiter is encountered. 
+   boost::asio::ip::tcp::socket socket(io_service); 
+   ...
+   boost::asio::socket_base::receive_low_watermark option(1024);
+   socket.set_option(option);
 
-  template<
-      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
-      typename Allocator>
-  std::size_t read_until(
-      SyncReadStream & s,
-      boost::asio::basic_streambuf< Allocator > & b,
-      const std::string & delim,
-      boost::system::error_code & ec);
 
 
-This function is used to read data into the specified streambuf until the streambuf's get area contains the specified delimiter. The call will block until one of the following conditions is true:
 
+Getting the current option value: 
 
-* The get area of the streambuf contains the specified delimiter.
+   boost::asio::ip::tcp::socket socket(io_service); 
+   ...
+   boost::asio::socket_base::receive_low_watermark option;
+   socket.get_option(option);
+   int size = option.value();
 
-* An error occurred.
 
-This operation is implemented in terms of zero or more calls to the stream's read\_some function. If the streambuf's get area already contains the delimiter, the function returns immediately.
 
 
-[heading Parameters]
-    
 
-[variablelist
-  
-[[s][The stream from which the data is to be read. The type must support the SyncReadStream concept.]]
 
-[[b][A streambuf object into which the data will be read.]]
+[endsect]
 
-[[delim][The delimiter string.]]
 
-[[ec][Set to indicate what error occurred, if any.]]
 
-]
+[section:reuse_address socket_base::reuse_address]
 
-[heading Return Value]
-      
-The number of bytes in the streambuf's get area up to and including the delimiter. Returns 0 if an error occurred. 
+Socket option to allow the socket to be bound to an address that is already in use. 
 
+  typedef implementation_defined reuse_address;
 
 
-[endsect]
 
+Implements the SOL\_SOCKET/SO\_REUSEADDR socket option.
 
 
-[section:overload5 read_until (5 of 6 overloads)]
+[heading Examples]
+  
+Setting the option: 
 
-Read data into a streambuf until a regular expression is located. 
+   boost::asio::ip::tcp::acceptor acceptor(io_service); 
+   ...
+   boost::asio::socket_base::reuse_address option(true);
+   acceptor.set_option(option);
 
-  template<
-      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
-      typename Allocator>
-  std::size_t read_until(
-      SyncReadStream & s,
-      boost::asio::basic_streambuf< Allocator > & b,
-      const boost::regex & expr);
 
 
-This function is used to read data into the specified streambuf until the streambuf's get area contains some data that matches a regular expression. The call will block until one of the following conditions is true:
 
+Getting the current option value: 
 
-* A substring of the streambuf's get area matches the regular expression.
+   boost::asio::ip::tcp::acceptor acceptor(io_service); 
+   ...
+   boost::asio::socket_base::reuse_address option;
+   acceptor.get_option(option);
+   bool is_set = option.value();
 
-* An error occurred.
 
-This operation is implemented in terms of zero or more calls to the stream's read\_some function. If the streambuf's get area already contains data that matches the regular expression, the function returns immediately.
 
 
-[heading Parameters]
-    
 
-[variablelist
-  
-[[s][The stream from which the data is to be read. The type must support the SyncReadStream concept.]]
 
-[[b][A streambuf object into which the data will be read.]]
+[endsect]
 
-[[expr][The regular expression.]]
 
-]
 
-[heading Return Value]
-      
-The number of bytes in the streambuf's get area up to and including the substring that matches the regular expression.
+[section:send_buffer_size socket_base::send_buffer_size]
 
-[heading Exceptions]
-    
+Socket option for the send buffer size of a socket. 
 
-[variablelist
-  
-[[boost::system::system_error][Thrown on failure.]]
+  typedef implementation_defined send_buffer_size;
 
-]
 
-[heading Example]
+
+Implements the SOL\_SOCKET/SO\_SNDBUF socket option.
+
+
+[heading Examples]
   
-To read data into a streambuf until a CR-LF sequence is encountered: 
+Setting the option: 
 
-   boost::asio::streambuf b;
-   boost::asio::read_until(s, b, boost::regex("\r\n"));
-   std::istream is(&b);
-   std::string line;
-   std::getline(is, line); 
+   boost::asio::ip::tcp::socket socket(io_service); 
+   ...
+   boost::asio::socket_base::send_buffer_size option(8192);
+   socket.set_option(option);
 
 
 
 
+Getting the current option value: 
 
+   boost::asio::ip::tcp::socket socket(io_service); 
+   ...
+   boost::asio::socket_base::send_buffer_size option;
+   socket.get_option(option);
+   int size = option.value();
 
-[endsect]
 
 
 
-[section:overload6 read_until (6 of 6 overloads)]
 
-Read data into a streambuf until a regular expression is located. 
 
-  template<
-      typename ``[link boost_asio.reference.SyncReadStream SyncReadStream]``,
-      typename Allocator>
-  std::size_t read_until(
-      SyncReadStream & s,
-      boost::asio::basic_streambuf< Allocator > & b,
-      const boost::regex & expr,
-      boost::system::error_code & ec);
+[endsect]
 
 
-This function is used to read data into the specified streambuf until the streambuf's get area contains some data that matches a regular expression. The call will block until one of the following conditions is true:
 
+[section:send_low_watermark socket_base::send_low_watermark]
 
-* A substring of the streambuf's get area matches the regular expression.
+Socket option for the send low watermark. 
 
-* An error occurred.
+  typedef implementation_defined send_low_watermark;
 
-This operation is implemented in terms of zero or more calls to the stream's read\_some function. If the streambuf's get area already contains data that matches the regular expression, the function returns immediately.
 
 
-[heading Parameters]
-    
+Implements the SOL\_SOCKET/SO\_SNDLOWAT socket option.
 
-[variablelist
+
+[heading Examples]
   
-[[s][The stream from which the data is to be read. The type must support the SyncReadStream concept.]]
+Setting the option: 
 
-[[b][A streambuf object into which the data will be read.]]
+   boost::asio::ip::tcp::socket socket(io_service); 
+   ...
+   boost::asio::socket_base::send_low_watermark option(1024);
+   socket.set_option(option);
 
-[[expr][The regular expression.]]
 
-[[ec][Set to indicate what error occurred, if any.]]
 
-]
 
-[heading Return Value]
-      
-The number of bytes in the streambuf's get area up to and including the substring that matches the regular expression. Returns 0 if an error occurred. 
+Getting the current option value: 
+
+   boost::asio::ip::tcp::socket socket(io_service); 
+   ...
+   boost::asio::socket_base::send_low_watermark option;
+   socket.get_option(option);
+   int size = option.value();
+
 
 
 
-[endsect]
 
 
 [endsect]
 
-[section:service_already_exists service_already_exists]
 
-Exception thrown when trying to add a duplicate service to an io_service. 
 
-  class service_already_exists
+[section:shutdown_type socket_base::shutdown_type]
 
+Different ways a socket may be shutdown. 
 
-[heading Member Functions]
-[table
-  [[Name][Description]]
+  enum shutdown_type
+
+[heading Values]
+[variablelist
 
   [
-    [[link boost_asio.reference.service_already_exists.service_already_exists [*service_already_exists]]]
-    []
+    [shutdown_receive]
+    [Shutdown the receive side of the socket. ]
   ]
-  
+
+  [
+    [shutdown_send]
+    [Shutdown the send side of the socket. ]
+  ]
+
+  [
+    [shutdown_both]
+    [Shutdown both send and receive on the socket. ]
+  ]
+
 ]
 
 
-[section:service_already_exists service_already_exists::service_already_exists]
 
+[endsect]
 
 
-  service_already_exists();
+
+[section:_socket_base socket_base::~socket_base]
+
+Protected destructor to prevent deletion through this type. 
+
+  ~socket_base();
 
 
 
@@ -32508,14 +40214,14 @@
 
 [endsect]
 
-[section:socket_acceptor_service socket_acceptor_service]
+[section:ssl__basic_context ssl::basic_context]
 
-Default service implementation for a socket acceptor. 
+SSL context. 
 
   template<
-      typename ``[link boost_asio.reference.Protocol Protocol]``>
-  class socket_acceptor_service :
-    public io_service::service
+      typename ``[link boost_asio.reference.Service Service]``>
+  class basic_context :
+    public ssl::context_base
 
 
 [heading Types]
@@ -32524,29 +40230,50 @@
 
   [
 
-    [[link boost_asio.reference.socket_acceptor_service.endpoint_type [*endpoint_type]]]
-    [The endpoint type. ]
+    [[link boost_asio.reference.ssl__basic_context.file_format [*file_format]]]
+    [File format types. ]
   
   ]
 
   [
 
-    [[link boost_asio.reference.socket_acceptor_service.implementation_type [*implementation_type]]]
-    [The native type of the socket acceptor. ]
+    [[link boost_asio.reference.ssl__basic_context.impl_type [*impl_type]]]
+    [The native implementation type of the locking dispatcher. ]
   
   ]
 
   [
 
-    [[link boost_asio.reference.socket_acceptor_service.native_type [*native_type]]]
-    [The native acceptor type. ]
+    [[link boost_asio.reference.ssl__basic_context.method [*method]]]
+    [Different methods supported by a context. ]
   
   ]
 
   [
 
-    [[link boost_asio.reference.socket_acceptor_service.protocol_type [*protocol_type]]]
-    [The protocol type. ]
+    [[link boost_asio.reference.ssl__basic_context.options [*options]]]
+    [Bitmask type for SSL options. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.ssl__basic_context.password_purpose [*password_purpose]]]
+    [Purpose of PEM password. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.ssl__basic_context.service_type [*service_type]]]
+    [The type of the service that will be used to provide context operations. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.ssl__basic_context.verify_mode [*verify_mode]]]
+    [Bitmask type for peer verification. ]
   
   ]
 
@@ -32557,165 +40284,163 @@
   [[Name][Description]]
 
   [
-    [[link boost_asio.reference.socket_acceptor_service.accept [*accept]]]
-    [Accept a new connection. ]
+    [[link boost_asio.reference.ssl__basic_context.add_verify_path [*add_verify_path]]]
+    [Add a directory containing certificate authority files to be used for performing verification. ]
   ]
   
   [
-    [[link boost_asio.reference.socket_acceptor_service.assign [*assign]]]
-    [Assign an existing native acceptor to a socket acceptor. ]
+    [[link boost_asio.reference.ssl__basic_context.basic_context [*basic_context]]]
+    [Constructor. ]
   ]
   
   [
-    [[link boost_asio.reference.socket_acceptor_service.async_accept [*async_accept]]]
-    [Start an asynchronous accept. ]
+    [[link boost_asio.reference.ssl__basic_context.impl [*impl]]]
+    [Get the underlying implementation in the native type. ]
   ]
   
   [
-    [[link boost_asio.reference.socket_acceptor_service.bind [*bind]]]
-    [Bind the socket acceptor to the specified local endpoint. ]
+    [[link boost_asio.reference.ssl__basic_context.load_verify_file [*load_verify_file]]]
+    [Load a certification authority file for performing verification. ]
   ]
   
   [
-    [[link boost_asio.reference.socket_acceptor_service.cancel [*cancel]]]
-    [Cancel all asynchronous operations associated with the acceptor. ]
+    [[link boost_asio.reference.ssl__basic_context.set_options [*set_options]]]
+    [Set options on the context. ]
   ]
   
   [
-    [[link boost_asio.reference.socket_acceptor_service.close [*close]]]
-    [Close a socket acceptor implementation. ]
+    [[link boost_asio.reference.ssl__basic_context.set_password_callback [*set_password_callback]]]
+    [Set the password callback. ]
   ]
   
   [
-    [[link boost_asio.reference.socket_acceptor_service.construct [*construct]]]
-    [Construct a new socket acceptor implementation. ]
+    [[link boost_asio.reference.ssl__basic_context.set_verify_mode [*set_verify_mode]]]
+    [Set the peer verification mode. ]
   ]
   
   [
-    [[link boost_asio.reference.socket_acceptor_service.destroy [*destroy]]]
-    [Destroy a socket acceptor implementation. ]
+    [[link boost_asio.reference.ssl__basic_context.use_certificate_chain_file [*use_certificate_chain_file]]]
+    [Use a certificate chain from a file. ]
   ]
   
   [
-    [[link boost_asio.reference.socket_acceptor_service.get_io_service [*get_io_service]]]
-    [Get the io_service object that owns the service. ]
+    [[link boost_asio.reference.ssl__basic_context.use_certificate_file [*use_certificate_file]]]
+    [Use a certificate from a file. ]
   ]
   
   [
-    [[link boost_asio.reference.socket_acceptor_service.get_option [*get_option]]]
-    [Get a socket option. ]
+    [[link boost_asio.reference.ssl__basic_context.use_private_key_file [*use_private_key_file]]]
+    [Use a private key from a file. ]
   ]
   
   [
-    [[link boost_asio.reference.socket_acceptor_service.io_control [*io_control]]]
-    [Perform an IO control command on the socket. ]
+    [[link boost_asio.reference.ssl__basic_context.use_rsa_private_key_file [*use_rsa_private_key_file]]]
+    [Use an RSA private key from a file. ]
   ]
   
   [
-    [[link boost_asio.reference.socket_acceptor_service.io_service [*io_service]]]
-    [(Deprecated: use get_io_service().) Get the io_service object that owns the service. ]
+    [[link boost_asio.reference.ssl__basic_context.use_tmp_dh_file [*use_tmp_dh_file]]]
+    [Use the specified file to obtain the temporary Diffie-Hellman parameters. ]
   ]
   
   [
-    [[link boost_asio.reference.socket_acceptor_service.is_open [*is_open]]]
-    [Determine whether the acceptor is open. ]
+    [[link boost_asio.reference.ssl__basic_context._basic_context [*~basic_context]]]
+    [Destructor. ]
   ]
   
+]
+
+[heading Data Members]
+[table
+  [[Name][Description]]
+
   [
-    [[link boost_asio.reference.socket_acceptor_service.listen [*listen]]]
-    [Place the socket acceptor into the state where it will listen for new connections. ]
+    [[link boost_asio.reference.ssl__basic_context.default_workarounds [*default_workarounds]]]
+    [Implement various bug workarounds. ]
   ]
-  
+
   [
-    [[link boost_asio.reference.socket_acceptor_service.local_endpoint [*local_endpoint]]]
-    [Get the local endpoint. ]
+    [[link boost_asio.reference.ssl__basic_context.no_sslv2 [*no_sslv2]]]
+    [Disable SSL v2. ]
   ]
-  
+
   [
-    [[link boost_asio.reference.socket_acceptor_service.native [*native]]]
-    [Get the native acceptor implementation. ]
+    [[link boost_asio.reference.ssl__basic_context.no_sslv3 [*no_sslv3]]]
+    [Disable SSL v3. ]
   ]
-  
+
   [
-    [[link boost_asio.reference.socket_acceptor_service.open [*open]]]
-    [Open a new socket acceptor implementation. ]
+    [[link boost_asio.reference.ssl__basic_context.no_tlsv1 [*no_tlsv1]]]
+    [Disable TLS v1. ]
   ]
-  
+
   [
-    [[link boost_asio.reference.socket_acceptor_service.set_option [*set_option]]]
-    [Set a socket option. ]
+    [[link boost_asio.reference.ssl__basic_context.single_dh_use [*single_dh_use]]]
+    [Always create a new key when using tmp_dh parameters. ]
   ]
-  
+
   [
-    [[link boost_asio.reference.socket_acceptor_service.shutdown_service [*shutdown_service]]]
-    [Destroy all user-defined handler objects owned by the service. ]
+    [[link boost_asio.reference.ssl__basic_context.verify_client_once [*verify_client_once]]]
+    [Do not request client certificate on renegotiation. Ignored unless verify_peer is set. ]
   ]
-  
+
   [
-    [[link boost_asio.reference.socket_acceptor_service.socket_acceptor_service [*socket_acceptor_service]]]
-    [Construct a new socket acceptor service for the specified io_service. ]
+    [[link boost_asio.reference.ssl__basic_context.verify_fail_if_no_peer_cert [*verify_fail_if_no_peer_cert]]]
+    [Fail verification if the peer has no certificate. Ignored unless verify_peer is set. ]
   ]
-  
-]
 
-[heading Data Members]
-[table
-  [[Name][Description]]
+  [
+    [[link boost_asio.reference.ssl__basic_context.verify_none [*verify_none]]]
+    [No verification. ]
+  ]
 
   [
-    [[link boost_asio.reference.socket_acceptor_service.id [*id]]]
-    [The unique service identifier. ]
+    [[link boost_asio.reference.ssl__basic_context.verify_peer [*verify_peer]]]
+    [Verify the peer. ]
   ]
 
 ]
 
+[section:add_verify_path ssl::basic_context::add_verify_path]
 
-[section:accept socket_acceptor_service::accept]
+Add a directory containing certificate authority files to be used for performing verification. 
 
-Accept a new connection. 
+  void ``[link boost_asio.reference.ssl__basic_context.add_verify_path.overload1 add_verify_path]``(
+      const std::string & path);
 
-  template<
-      typename ``[link boost_asio.reference.SocketService SocketService]``>
-  boost::system::error_code accept(
-      implementation_type & impl,
-      basic_socket< protocol_type, SocketService > & peer,
-      endpoint_type * peer_endpoint,
+  boost::system::error_code ``[link boost_asio.reference.ssl__basic_context.add_verify_path.overload2 add_verify_path]``(
+      const std::string & path,
       boost::system::error_code & ec);
 
 
+[section:overload1 ssl::basic_context::add_verify_path (1 of 2 overloads)]
 
-[endsect]
-
-
-
-[section:assign socket_acceptor_service::assign]
+Add a directory containing certificate authority files to be used for performing verification. 
 
-Assign an existing native acceptor to a socket acceptor. 
+  void add_verify_path(
+      const std::string & path);
 
-  boost::system::error_code assign(
-      implementation_type & impl,
-      const protocol_type & protocol,
-      const native_type & native_acceptor,
-      boost::system::error_code & ec);
 
+This function is used to specify the name of a directory containing certification authority certificates. Each file in the directory must contain a single certificate. The files must be named using the subject name's hash and an extension of ".0".
 
 
-[endsect]
+[heading Parameters]
+    
 
+[variablelist
+  
+[[path][The name of a directory containing the certificates.]]
 
+]
 
-[section:async_accept socket_acceptor_service::async_accept]
+[heading Exceptions]
+    
 
-Start an asynchronous accept. 
+[variablelist
+  
+[[boost::system::system_error][Thrown on failure. ]]
 
-  template<
-      typename ``[link boost_asio.reference.SocketService SocketService]``,
-      typename ``[link boost_asio.reference.AcceptHandler AcceptHandler]``>
-  void async_accept(
-      implementation_type & impl,
-      basic_socket< protocol_type, SocketService > & peer,
-      endpoint_type * peer_endpoint,
-      AcceptHandler handler);
+]
 
 
 
@@ -32723,81 +40448,89 @@
 
 
 
-[section:bind socket_acceptor_service::bind]
+[section:overload2 ssl::basic_context::add_verify_path (2 of 2 overloads)]
 
-Bind the socket acceptor to the specified local endpoint. 
+Add a directory containing certificate authority files to be used for performing verification. 
 
-  boost::system::error_code bind(
-      implementation_type & impl,
-      const endpoint_type & endpoint,
+  boost::system::error_code add_verify_path(
+      const std::string & path,
       boost::system::error_code & ec);
 
 
-
-[endsect]
+This function is used to specify the name of a directory containing certification authority certificates. Each file in the directory must contain a single certificate. The files must be named using the subject name's hash and an extension of ".0".
 
 
+[heading Parameters]
+    
 
-[section:cancel socket_acceptor_service::cancel]
+[variablelist
+  
+[[path][The name of a directory containing the certificates.]]
 
-Cancel all asynchronous operations associated with the acceptor. 
+[[ec][Set to indicate what error occurred, if any. ]]
 
-  boost::system::error_code cancel(
-      implementation_type & impl,
-      boost::system::error_code & ec);
+]
 
 
 
 [endsect]
 
 
+[endsect]
 
-[section:close socket_acceptor_service::close]
 
-Close a socket acceptor implementation. 
+[section:basic_context ssl::basic_context::basic_context]
 
-  boost::system::error_code close(
-      implementation_type & impl,
-      boost::system::error_code & ec);
+Constructor. 
 
+  basic_context(
+      boost::asio::io_service & io_service,
+      method m);
 
 
-[endsect]
 
+[endsect]
 
 
-[section:construct socket_acceptor_service::construct]
 
-Construct a new socket acceptor implementation. 
+[section:default_workarounds ssl::basic_context::default_workarounds]
 
-  void construct(
-      implementation_type & impl);
 
+['Inherited from ssl::context_base.]
 
+Implement various bug workarounds. 
 
-[endsect]
+  static const int default_workarounds = implementation_defined;
 
 
 
-[section:destroy socket_acceptor_service::destroy]
+[endsect]
 
-Destroy a socket acceptor implementation. 
 
-  void destroy(
-      implementation_type & impl);
 
+[section:file_format ssl::basic_context::file_format]
 
 
-[endsect]
+['Inherited from ssl::context_base.]
 
+File format types. 
 
+  enum file_format
 
-[section:endpoint_type socket_acceptor_service::endpoint_type]
+[heading Values]
+[variablelist
 
-The endpoint type. 
+  [
+    [asn1]
+    [ASN.1 file. ]
+  ]
 
-  typedef protocol_type::endpoint endpoint_type;
+  [
+    [pem]
+    [PEM file. ]
+  ]
 
+]
 
 
 
@@ -32805,73 +40538,72 @@
 
 
 
-[section:get_io_service socket_acceptor_service::get_io_service]
-
+[section:impl ssl::basic_context::impl]
 
-['Inherited from io_service.]
+Get the underlying implementation in the native type. 
 
-Get the io_service object that owns the service. 
+  impl_type impl();
 
-  boost::asio::io_service & get_io_service();
 
+This function may be used to obtain the underlying implementation of the context. This is intended to allow access to context functionality that is not otherwise provided. 
 
 
 [endsect]
 
 
 
-[section:get_option socket_acceptor_service::get_option]
-
-Get a socket option. 
-
-  template<
-      typename ``[link boost_asio.reference.GettableSocketOption GettableSocketOption]``>
-  boost::system::error_code get_option(
-      const implementation_type & impl,
-      GettableSocketOption & option,
-      boost::system::error_code & ec) const;
-
+[section:impl_type ssl::basic_context::impl_type]
 
+The native implementation type of the locking dispatcher. 
 
-[endsect]
+  typedef service_type::impl_type impl_type;
 
 
 
-[section:id socket_acceptor_service::id]
 
-The unique service identifier. 
+[endsect]
 
-  static boost::asio::io_service::id id;
 
+[section:load_verify_file ssl::basic_context::load_verify_file]
 
+Load a certification authority file for performing verification. 
 
-[endsect]
+  void ``[link boost_asio.reference.ssl__basic_context.load_verify_file.overload1 load_verify_file]``(
+      const std::string & filename);
 
+  boost::system::error_code ``[link boost_asio.reference.ssl__basic_context.load_verify_file.overload2 load_verify_file]``(
+      const std::string & filename,
+      boost::system::error_code & ec);
 
 
-[section:implementation_type socket_acceptor_service::implementation_type]
+[section:overload1 ssl::basic_context::load_verify_file (1 of 2 overloads)]
 
-The native type of the socket acceptor. 
+Load a certification authority file for performing verification. 
 
-  typedef implementation_defined implementation_type;
+  void load_verify_file(
+      const std::string & filename);
 
 
+This function is used to load one or more trusted certification authorities from a file.
 
 
-[endsect]
+[heading Parameters]
+    
 
+[variablelist
+  
+[[filename][The name of a file containing certification authority certificates in PEM format.]]
 
+]
 
-[section:io_control socket_acceptor_service::io_control]
+[heading Exceptions]
+    
 
-Perform an IO control command on the socket. 
+[variablelist
+  
+[[boost::system::system_error][Thrown on failure. ]]
 
-  template<
-      typename ``[link boost_asio.reference.IoControlCommand IoControlCommand]``>
-  boost::system::error_code io_control(
-      implementation_type & impl,
-      IoControlCommand & command,
-      boost::system::error_code & ec);
+]
 
 
 
@@ -32879,69 +40611,110 @@
 
 
 
-[section:io_service socket_acceptor_service::io_service]
-
+[section:overload2 ssl::basic_context::load_verify_file (2 of 2 overloads)]
 
-['Inherited from io_service.]
+Load a certification authority file for performing verification. 
 
-(Deprecated: use get_io_service().) Get the io_service object that owns the service. 
+  boost::system::error_code load_verify_file(
+      const std::string & filename,
+      boost::system::error_code & ec);
 
-  boost::asio::io_service & io_service();
 
+This function is used to load the certificates for one or more trusted certification authorities from a file.
 
 
-[endsect]
+[heading Parameters]
+    
 
+[variablelist
+  
+[[filename][The name of a file containing certification authority certificates in PEM format.]]
 
+[[ec][Set to indicate what error occurred, if any. ]]
 
-[section:is_open socket_acceptor_service::is_open]
+]
 
-Determine whether the acceptor is open. 
 
-  bool is_open(
-      const implementation_type & impl) const;
 
+[endsect]
 
 
 [endsect]
 
 
+[section:method ssl::basic_context::method]
 
-[section:listen socket_acceptor_service::listen]
-
-Place the socket acceptor into the state where it will listen for new connections. 
 
-  boost::system::error_code listen(
-      implementation_type & impl,
-      int backlog,
-      boost::system::error_code & ec);
+['Inherited from ssl::context_base.]
 
+Different methods supported by a context. 
 
+  enum method
 
-[endsect]
+[heading Values]
+[variablelist
 
+  [
+    [sslv2]
+    [Generic SSL version 2. ]
+  ]
 
+  [
+    [sslv2_client]
+    [SSL version 2 client. ]
+  ]
 
-[section:local_endpoint socket_acceptor_service::local_endpoint]
+  [
+    [sslv2_server]
+    [SSL version 2 server. ]
+  ]
 
-Get the local endpoint. 
+  [
+    [sslv3]
+    [Generic SSL version 3. ]
+  ]
 
-  endpoint_type local_endpoint(
-      const implementation_type & impl,
-      boost::system::error_code & ec) const;
+  [
+    [sslv3_client]
+    [SSL version 3 client. ]
+  ]
 
+  [
+    [sslv3_server]
+    [SSL version 3 server. ]
+  ]
 
+  [
+    [tlsv1]
+    [Generic TLS version 1. ]
+  ]
 
-[endsect]
+  [
+    [tlsv1_client]
+    [TLS version 1 client. ]
+  ]
 
+  [
+    [tlsv1_server]
+    [TLS version 1 server. ]
+  ]
 
+  [
+    [sslv23]
+    [Generic SSL/TLS. ]
+  ]
 
-[section:native socket_acceptor_service::native]
+  [
+    [sslv23_client]
+    [SSL/TLS client. ]
+  ]
 
-Get the native acceptor implementation. 
+  [
+    [sslv23_server]
+    [SSL/TLS server. ]
+  ]
 
-  native_type native(
-      implementation_type & impl);
+]
 
 
 
@@ -32949,12 +40722,14 @@
 
 
 
-[section:native_type socket_acceptor_service::native_type]
+[section:no_sslv2 ssl::basic_context::no_sslv2]
 
-The native acceptor type. 
 
-  typedef implementation_defined native_type;
+['Inherited from ssl::context_base.]
+
+Disable SSL v2. 
 
+  static const int no_sslv2 = implementation_defined;
 
 
 
@@ -32962,14 +40737,14 @@
 
 
 
-[section:open socket_acceptor_service::open]
+[section:no_sslv3 ssl::basic_context::no_sslv3]
 
-Open a new socket acceptor implementation. 
 
-  boost::system::error_code open(
-      implementation_type & impl,
-      const protocol_type & protocol,
-      boost::system::error_code & ec);
+['Inherited from ssl::context_base.]
+
+Disable SSL v3. 
+
+  static const int no_sslv3 = implementation_defined;
 
 
 
@@ -32977,12 +40752,14 @@
 
 
 
-[section:protocol_type socket_acceptor_service::protocol_type]
+[section:no_tlsv1 ssl::basic_context::no_tlsv1]
 
-The protocol type. 
 
-  typedef Protocol protocol_type;
+['Inherited from ssl::context_base.]
+
+Disable TLS v1. 
 
+  static const int no_tlsv1 = implementation_defined;
 
 
 
@@ -32990,41 +40767,45 @@
 
 
 
-[section:set_option socket_acceptor_service::set_option]
+[section:options ssl::basic_context::options]
 
-Set a socket option. 
 
-  template<
-      typename ``[link boost_asio.reference.SettableSocketOption SettableSocketOption]``>
-  boost::system::error_code set_option(
-      implementation_type & impl,
-      const SettableSocketOption & option,
-      boost::system::error_code & ec);
+['Inherited from ssl::context_base.]
 
+Bitmask type for SSL options. 
 
+  typedef int options;
 
-[endsect]
 
 
 
-[section:shutdown_service socket_acceptor_service::shutdown_service]
+[endsect]
 
-Destroy all user-defined handler objects owned by the service. 
 
-  void shutdown_service();
 
+[section:password_purpose ssl::basic_context::password_purpose]
 
 
-[endsect]
+['Inherited from ssl::context_base.]
 
+Purpose of PEM password. 
 
+  enum password_purpose
 
-[section:socket_acceptor_service socket_acceptor_service::socket_acceptor_service]
+[heading Values]
+[variablelist
 
-Construct a new socket acceptor service for the specified io_service. 
+  [
+    [for_reading]
+    [The password is needed for reading/decryption. ]
+  ]
 
-  socket_acceptor_service(
-      boost::asio::io_service & io_service);
+  [
+    [for_writing]
+    [The password is needed for writing/encryption. ]
+  ]
+
+]
 
 
 
@@ -33032,186 +40813,149 @@
 
 
 
-[endsect]
+[section:service_type ssl::basic_context::service_type]
 
-[section:socket_base socket_base]
+The type of the service that will be used to provide context operations. 
 
-The socket_base class is used as a base for the basic_stream_socket and basic_datagram_socket class templates so that we have a common place to define the shutdown_type and enum. 
+  typedef Service service_type;
 
-  class socket_base
 
 
-[heading Types]
-[table
-  [[Name][Description]]
 
-  [
+[endsect]
 
-    [[link boost_asio.reference.socket_base.broadcast [*broadcast]]]
-    [Socket option to permit sending of broadcast messages. ]
-  
-  ]
 
-  [
+[section:set_options ssl::basic_context::set_options]
 
-    [[link boost_asio.reference.socket_base.bytes_readable [*bytes_readable]]]
-    [IO control command to get the amount of data that can be read without blocking. ]
-  
-  ]
+Set options on the context. 
 
-  [
+  void ``[link boost_asio.reference.ssl__basic_context.set_options.overload1 set_options]``(
+      options o);
 
-    [[link boost_asio.reference.socket_base.debug [*debug]]]
-    [Socket option to enable socket-level debugging. ]
-  
-  ]
+  boost::system::error_code ``[link boost_asio.reference.ssl__basic_context.set_options.overload2 set_options]``(
+      options o,
+      boost::system::error_code & ec);
 
-  [
 
-    [[link boost_asio.reference.socket_base.do_not_route [*do_not_route]]]
-    [Socket option to prevent routing, use local interfaces only. ]
-  
-  ]
+[section:overload1 ssl::basic_context::set_options (1 of 2 overloads)]
 
-  [
+Set options on the context. 
 
-    [[link boost_asio.reference.socket_base.enable_connection_aborted [*enable_connection_aborted]]]
-    [Socket option to report aborted connections on accept. ]
-  
-  ]
+  void set_options(
+      options o);
 
-  [
 
-    [[link boost_asio.reference.socket_base.keep_alive [*keep_alive]]]
-    [Socket option to send keep-alives. ]
-  
-  ]
+This function may be used to configure the SSL options used by the context.
 
-  [
 
-    [[link boost_asio.reference.socket_base.linger [*linger]]]
-    [Socket option to specify whether the socket lingers on close if unsent data is present. ]
+[heading Parameters]
+    
+
+[variablelist
   
-  ]
+[[o][A bitmask of options. The available option values are defined in the context\_base class. The options are bitwise-ored with any existing value for the options.]]
 
-  [
+]
 
-    [[link boost_asio.reference.socket_base.message_flags [*message_flags]]]
-    [Bitmask type for flags that can be passed to send and receive operations. ]
+[heading Exceptions]
+    
+
+[variablelist
   
-  ]
+[[boost::system::system_error][Thrown on failure. ]]
 
-  [
+]
 
-    [[link boost_asio.reference.socket_base.non_blocking_io [*non_blocking_io]]]
-    [IO control command to set the blocking mode of the socket. ]
-  
-  ]
 
-  [
 
-    [[link boost_asio.reference.socket_base.receive_buffer_size [*receive_buffer_size]]]
-    [Socket option for the receive buffer size of a socket. ]
-  
-  ]
+[endsect]
 
-  [
 
-    [[link boost_asio.reference.socket_base.receive_low_watermark [*receive_low_watermark]]]
-    [Socket option for the receive low watermark. ]
-  
-  ]
 
-  [
+[section:overload2 ssl::basic_context::set_options (2 of 2 overloads)]
 
-    [[link boost_asio.reference.socket_base.reuse_address [*reuse_address]]]
-    [Socket option to allow the socket to be bound to an address that is already in use. ]
-  
-  ]
+Set options on the context. 
 
-  [
+  boost::system::error_code set_options(
+      options o,
+      boost::system::error_code & ec);
 
-    [[link boost_asio.reference.socket_base.send_buffer_size [*send_buffer_size]]]
-    [Socket option for the send buffer size of a socket. ]
-  
-  ]
 
-  [
+This function may be used to configure the SSL options used by the context.
 
-    [[link boost_asio.reference.socket_base.send_low_watermark [*send_low_watermark]]]
-    [Socket option for the send low watermark. ]
-  
-  ]
 
-  [
+[heading Parameters]
+    
 
-    [[link boost_asio.reference.socket_base.shutdown_type [*shutdown_type]]]
-    [Different ways a socket may be shutdown. ]
+[variablelist
   
-  ]
+[[o][A bitmask of options. The available option values are defined in the context\_base class. The options are bitwise-ored with any existing value for the options.]]
 
-]
+[[ec][Set to indicate what error occurred, if any. ]]
 
-[heading Data Members]
-[table
-  [[Name][Description]]
+]
 
-  [
-    [[link boost_asio.reference.socket_base.max_connections [*max_connections]]]
-    [The maximum length of the queue of pending incoming connections. ]
-  ]
 
-  [
-    [[link boost_asio.reference.socket_base.message_do_not_route [*message_do_not_route]]]
-    [Specify that the data should not be subject to routing. ]
-  ]
 
-  [
-    [[link boost_asio.reference.socket_base.message_out_of_band [*message_out_of_band]]]
-    [Process out-of-band data. ]
-  ]
+[endsect]
 
-  [
-    [[link boost_asio.reference.socket_base.message_peek [*message_peek]]]
-    [Peek at incoming data without removing it from the input queue. ]
-  ]
 
-]
+[endsect]
 
+[section:set_password_callback ssl::basic_context::set_password_callback]
 
-[section:broadcast socket_base::broadcast]
+Set the password callback. 
 
-Socket option to permit sending of broadcast messages. 
+  template<
+      typename PasswordCallback>
+  void ``[link boost_asio.reference.ssl__basic_context.set_password_callback.overload1 set_password_callback]``(
+      PasswordCallback callback);
 
-  typedef implementation_defined broadcast;
+  template<
+      typename PasswordCallback>
+  boost::system::error_code ``[link boost_asio.reference.ssl__basic_context.set_password_callback.overload2 set_password_callback]``(
+      PasswordCallback callback,
+      boost::system::error_code & ec);
 
 
+[section:overload1 ssl::basic_context::set_password_callback (1 of 2 overloads)]
 
-Implements the SOL\_SOCKET/SO\_BROADCAST socket option.
+Set the password callback. 
 
+  template<
+      typename PasswordCallback>
+  void set_password_callback(
+      PasswordCallback callback);
 
-[heading Examples]
-  
-Setting the option: 
 
-   boost::asio::ip::udp::socket socket(io_service); 
-   ...
-   boost::asio::socket_base::broadcast option(true);
-   socket.set_option(option);
+This function is used to specify a callback function to obtain password information about an encrypted key in PEM format.
 
 
+[heading Parameters]
+    
 
+[variablelist
+  
+[[callback][The function object to be used for obtaining the password. The function signature of the handler must be: 
+``
+   std::string password_callback(
+     std::size_t max_length,  // The maximum size for a password.
+     password_purpose purpose // Whether password is for reading or writing.
+   ); 
 
-Getting the current option value: 
+``
+The return value of the callback is a string containing the password.]]
 
-   boost::asio::ip::udp::socket socket(io_service); 
-   ...
-   boost::asio::socket_base::broadcast option;
-   socket.get_option(option);
-   bool is_set = option.value();
+]
 
+[heading Exceptions]
+    
 
+[variablelist
+  
+[[boost::system::system_error][Thrown on failure. ]]
 
+]
 
 
 
@@ -33219,69 +40963,86 @@
 
 
 
-[section:bytes_readable socket_base::bytes_readable]
+[section:overload2 ssl::basic_context::set_password_callback (2 of 2 overloads)]
 
-IO control command to get the amount of data that can be read without blocking. 
+Set the password callback. 
 
-  typedef implementation_defined bytes_readable;
+  template<
+      typename PasswordCallback>
+  boost::system::error_code set_password_callback(
+      PasswordCallback callback,
+      boost::system::error_code & ec);
 
 
+This function is used to specify a callback function to obtain password information about an encrypted key in PEM format.
 
-Implements the FIONREAD IO control command.
 
+[heading Parameters]
+    
 
-[heading Example]
+[variablelist
   
+[[callback][The function object to be used for obtaining the password. The function signature of the handler must be: 
+``
+   std::string password_callback(
+     std::size_t max_length,  // The maximum size for a password.
+     password_purpose purpose // Whether password is for reading or writing.
+   ); 
 
+``
+The return value of the callback is a string containing the password.]]
 
-   boost::asio::ip::tcp::socket socket(io_service); 
-   ...
-   boost::asio::socket_base::bytes_readable command(true);
-   socket.io_control(command);
-   std::size_t bytes_readable = command.get();
-
-
+[[ec][Set to indicate what error occurred, if any. ]]
 
+]
 
 
 
 [endsect]
 
 
+[endsect]
 
-[section:debug socket_base::debug]
+[section:set_verify_mode ssl::basic_context::set_verify_mode]
 
-Socket option to enable socket-level debugging. 
+Set the peer verification mode. 
 
-  typedef implementation_defined debug;
+  void ``[link boost_asio.reference.ssl__basic_context.set_verify_mode.overload1 set_verify_mode]``(
+      verify_mode v);
 
+  boost::system::error_code ``[link boost_asio.reference.ssl__basic_context.set_verify_mode.overload2 set_verify_mode]``(
+      verify_mode v,
+      boost::system::error_code & ec);
 
 
-Implements the SOL\_SOCKET/SO\_DEBUG socket option.
+[section:overload1 ssl::basic_context::set_verify_mode (1 of 2 overloads)]
 
+Set the peer verification mode. 
 
-[heading Examples]
-  
-Setting the option: 
+  void set_verify_mode(
+      verify_mode v);
 
-   boost::asio::ip::tcp::socket socket(io_service); 
-   ...
-   boost::asio::socket_base::debug option(true);
-   socket.set_option(option);
 
+This function may be used to configure the peer verification mode used by the context.
 
 
+[heading Parameters]
+    
 
-Getting the current option value: 
+[variablelist
+  
+[[v][A bitmask of peer verification modes. The available verify\_mode values are defined in the context\_base class.]]
 
-   boost::asio::ip::tcp::socket socket(io_service); 
-   ...
-   boost::asio::socket_base::debug option;
-   socket.get_option(option);
-   bool is_set = option.value();
+]
 
+[heading Exceptions]
+    
 
+[variablelist
+  
+[[boost::system::system_error][Thrown on failure. ]]
 
+]
 
 
 
@@ -33289,79 +41050,91 @@
 
 
 
-[section:do_not_route socket_base::do_not_route]
+[section:overload2 ssl::basic_context::set_verify_mode (2 of 2 overloads)]
 
-Socket option to prevent routing, use local interfaces only. 
+Set the peer verification mode. 
 
-  typedef implementation_defined do_not_route;
+  boost::system::error_code set_verify_mode(
+      verify_mode v,
+      boost::system::error_code & ec);
 
 
+This function may be used to configure the peer verification mode used by the context.
 
-Implements the SOL\_SOCKET/SO\_DONTROUTE socket option.
 
+[heading Parameters]
+    
 
-[heading Examples]
+[variablelist
   
-Setting the option: 
+[[v][A bitmask of peer verification modes. The available verify\_mode values are defined in the context\_base class.]]
 
-   boost::asio::ip::udp::socket socket(io_service); 
-   ...
-   boost::asio::socket_base::do_not_route option(true);
-   socket.set_option(option);
+[[ec][Set to indicate what error occurred, if any. ]]
 
+]
 
 
 
-Getting the current option value: 
+[endsect]
 
-   boost::asio::ip::udp::socket socket(io_service); 
-   ...
-   boost::asio::socket_base::do_not_route option;
-   socket.get_option(option);
-   bool is_set = option.value();
 
+[endsect]
 
 
+[section:single_dh_use ssl::basic_context::single_dh_use]
 
 
+['Inherited from ssl::context_base.]
 
-[endsect]
+Always create a new key when using tmp_dh parameters. 
 
+  static const int single_dh_use = implementation_defined;
 
 
-[section:enable_connection_aborted socket_base::enable_connection_aborted]
 
-Socket option to report aborted connections on accept. 
+[endsect]
 
-  typedef implementation_defined enable_connection_aborted;
 
+[section:use_certificate_chain_file ssl::basic_context::use_certificate_chain_file]
 
+Use a certificate chain from a file. 
 
-Implements a custom socket option that determines whether or not an accept operation is permitted to fail with boost::asio::error::connection\_aborted. By default the option is false.
+  void ``[link boost_asio.reference.ssl__basic_context.use_certificate_chain_file.overload1 use_certificate_chain_file]``(
+      const std::string & filename);
 
+  boost::system::error_code ``[link boost_asio.reference.ssl__basic_context.use_certificate_chain_file.overload2 use_certificate_chain_file]``(
+      const std::string & filename,
+      boost::system::error_code & ec);
 
-[heading Examples]
-  
-Setting the option: 
 
-   boost::asio::ip::tcp::acceptor acceptor(io_service); 
-   ...
-   boost::asio::socket_base::enable_connection_aborted option(true);
-   acceptor.set_option(option);
+[section:overload1 ssl::basic_context::use_certificate_chain_file (1 of 2 overloads)]
+
+Use a certificate chain from a file. 
+
+  void use_certificate_chain_file(
+      const std::string & filename);
 
 
+This function is used to load a certificate chain into the context from a file.
 
 
-Getting the current option value: 
+[heading Parameters]
+    
 
-   boost::asio::ip::tcp::acceptor acceptor(io_service); 
-   ...
-   boost::asio::socket_base::enable_connection_aborted option;
-   acceptor.get_option(option);
-   bool is_set = option.value();
+[variablelist
+  
+[[filename][The name of the file containing the certificate. The file must use the PEM format.]]
+
+]
 
+[heading Exceptions]
+    
 
+[variablelist
+  
+[[boost::system::system_error][Thrown on failure. ]]
 
+]
 
 
 
@@ -33369,117 +41142,166 @@
 
 
 
-[section:keep_alive socket_base::keep_alive]
+[section:overload2 ssl::basic_context::use_certificate_chain_file (2 of 2 overloads)]
 
-Socket option to send keep-alives. 
+Use a certificate chain from a file. 
 
-  typedef implementation_defined keep_alive;
+  boost::system::error_code use_certificate_chain_file(
+      const std::string & filename,
+      boost::system::error_code & ec);
 
 
+This function is used to load a certificate chain into the context from a file.
 
-Implements the SOL\_SOCKET/SO\_KEEPALIVE socket option.
 
+[heading Parameters]
+    
 
-[heading Examples]
+[variablelist
   
-Setting the option: 
+[[filename][The name of the file containing the certificate. The file must use the PEM format.]]
 
-   boost::asio::ip::tcp::socket socket(io_service); 
-   ...
-   boost::asio::socket_base::keep_alive option(true);
-   socket.set_option(option);
+[[ec][Set to indicate what error occurred, if any. ]]
 
+]
 
 
 
-Getting the current option value: 
+[endsect]
 
-   boost::asio::ip::tcp::socket socket(io_service); 
-   ...
-   boost::asio::socket_base::keep_alive option;
-   socket.get_option(option);
-   bool is_set = option.value();
 
+[endsect]
 
+[section:use_certificate_file ssl::basic_context::use_certificate_file]
 
+Use a certificate from a file. 
 
+  void ``[link boost_asio.reference.ssl__basic_context.use_certificate_file.overload1 use_certificate_file]``(
+      const std::string & filename,
+      file_format format);
 
+  boost::system::error_code ``[link boost_asio.reference.ssl__basic_context.use_certificate_file.overload2 use_certificate_file]``(
+      const std::string & filename,
+      file_format format,
+      boost::system::error_code & ec);
 
-[endsect]
 
+[section:overload1 ssl::basic_context::use_certificate_file (1 of 2 overloads)]
 
+Use a certificate from a file. 
 
-[section:linger socket_base::linger]
+  void use_certificate_file(
+      const std::string & filename,
+      file_format format);
 
-Socket option to specify whether the socket lingers on close if unsent data is present. 
 
-  typedef implementation_defined linger;
+This function is used to load a certificate into the context from a file.
 
 
+[heading Parameters]
+    
 
-Implements the SOL\_SOCKET/SO\_LINGER socket option.
+[variablelist
+  
+[[filename][The name of the file containing the certificate.]]
 
+[[format][The file format (ASN.1 or PEM).]]
 
-[heading Examples]
+]
+
+[heading Exceptions]
+    
+
+[variablelist
   
-Setting the option: 
+[[boost::system::system_error][Thrown on failure. ]]
 
-   boost::asio::ip::tcp::socket socket(io_service); 
-   ...
-   boost::asio::socket_base::linger option(true, 30);
-   socket.set_option(option);
+]
 
 
 
+[endsect]
 
-Getting the current option value: 
 
-   boost::asio::ip::tcp::socket socket(io_service); 
-   ...
-   boost::asio::socket_base::linger option;
-   socket.get_option(option);
-   bool is_set = option.enabled();
-   unsigned short timeout = option.timeout();
 
+[section:overload2 ssl::basic_context::use_certificate_file (2 of 2 overloads)]
+
+Use a certificate from a file. 
+
+  boost::system::error_code use_certificate_file(
+      const std::string & filename,
+      file_format format,
+      boost::system::error_code & ec);
 
 
+This function is used to load a certificate into the context from a file.
 
 
+[heading Parameters]
+    
 
-[endsect]
+[variablelist
+  
+[[filename][The name of the file containing the certificate.]]
 
+[[format][The file format (ASN.1 or PEM).]]
 
+[[ec][Set to indicate what error occurred, if any. ]]
 
-[section:max_connections socket_base::max_connections]
+]
 
-The maximum length of the queue of pending incoming connections. 
 
-  static const int max_connections = implementation_defined;
 
+[endsect]
 
 
 [endsect]
 
+[section:use_private_key_file ssl::basic_context::use_private_key_file]
 
+Use a private key from a file. 
 
-[section:message_do_not_route socket_base::message_do_not_route]
+  void ``[link boost_asio.reference.ssl__basic_context.use_private_key_file.overload1 use_private_key_file]``(
+      const std::string & filename,
+      file_format format);
 
-Specify that the data should not be subject to routing. 
+  boost::system::error_code ``[link boost_asio.reference.ssl__basic_context.use_private_key_file.overload2 use_private_key_file]``(
+      const std::string & filename,
+      file_format format,
+      boost::system::error_code & ec);
 
-  static const int message_do_not_route = implementation_defined;
 
+[section:overload1 ssl::basic_context::use_private_key_file (1 of 2 overloads)]
 
+Use a private key from a file. 
 
-[endsect]
+  void use_private_key_file(
+      const std::string & filename,
+      file_format format);
 
 
+This function is used to load a private key into the context from a file.
 
-[section:message_flags socket_base::message_flags]
 
-Bitmask type for flags that can be passed to send and receive operations. 
+[heading Parameters]
+    
 
-  typedef int message_flags;
+[variablelist
+  
+[[filename][The name of the file containing the private key.]]
+
+[[format][The file format (ASN.1 or PEM).]]
+
+]
+
+[heading Exceptions]
+    
+
+[variablelist
+  
+[[boost::system::system_error][Thrown on failure. ]]
 
+]
 
 
 
@@ -33487,132 +41309,164 @@
 
 
 
-[section:message_out_of_band socket_base::message_out_of_band]
+[section:overload2 ssl::basic_context::use_private_key_file (2 of 2 overloads)]
 
-Process out-of-band data. 
+Use a private key from a file. 
 
-  static const int message_out_of_band = implementation_defined;
+  boost::system::error_code use_private_key_file(
+      const std::string & filename,
+      file_format format,
+      boost::system::error_code & ec);
 
 
+This function is used to load a private key into the context from a file.
 
-[endsect]
 
+[heading Parameters]
+    
 
+[variablelist
+  
+[[filename][The name of the file containing the private key.]]
 
-[section:message_peek socket_base::message_peek]
+[[format][The file format (ASN.1 or PEM).]]
 
-Peek at incoming data without removing it from the input queue. 
+[[ec][Set to indicate what error occurred, if any. ]]
 
-  static const int message_peek = implementation_defined;
+]
 
 
 
 [endsect]
 
 
+[endsect]
 
-[section:non_blocking_io socket_base::non_blocking_io]
-
-IO control command to set the blocking mode of the socket. 
+[section:use_rsa_private_key_file ssl::basic_context::use_rsa_private_key_file]
 
-  typedef implementation_defined non_blocking_io;
+Use an RSA private key from a file. 
 
+  void ``[link boost_asio.reference.ssl__basic_context.use_rsa_private_key_file.overload1 use_rsa_private_key_file]``(
+      const std::string & filename,
+      file_format format);
 
+  boost::system::error_code ``[link boost_asio.reference.ssl__basic_context.use_rsa_private_key_file.overload2 use_rsa_private_key_file]``(
+      const std::string & filename,
+      file_format format,
+      boost::system::error_code & ec);
 
-Implements the FIONBIO IO control command.
 
+[section:overload1 ssl::basic_context::use_rsa_private_key_file (1 of 2 overloads)]
 
-[heading Example]
-  
+Use an RSA private key from a file. 
 
+  void use_rsa_private_key_file(
+      const std::string & filename,
+      file_format format);
 
-   boost::asio::ip::tcp::socket socket(io_service); 
-   ...
-   boost::asio::socket_base::non_blocking_io command(true);
-   socket.io_control(command);
 
+This function is used to load an RSA private key into the context from a file.
 
 
+[heading Parameters]
+    
 
+[variablelist
+  
+[[filename][The name of the file containing the RSA private key.]]
 
+[[format][The file format (ASN.1 or PEM).]]
 
-[endsect]
+]
 
+[heading Exceptions]
+    
 
+[variablelist
+  
+[[boost::system::system_error][Thrown on failure. ]]
 
-[section:receive_buffer_size socket_base::receive_buffer_size]
+]
 
-Socket option for the receive buffer size of a socket. 
 
-  typedef implementation_defined receive_buffer_size;
 
+[endsect]
 
 
-Implements the SOL\_SOCKET/SO\_RCVBUF socket option.
 
+[section:overload2 ssl::basic_context::use_rsa_private_key_file (2 of 2 overloads)]
 
-[heading Examples]
-  
-Setting the option: 
+Use an RSA private key from a file. 
 
-   boost::asio::ip::tcp::socket socket(io_service); 
-   ...
-   boost::asio::socket_base::receive_buffer_size option(8192);
-   socket.set_option(option);
+  boost::system::error_code use_rsa_private_key_file(
+      const std::string & filename,
+      file_format format,
+      boost::system::error_code & ec);
 
 
+This function is used to load an RSA private key into the context from a file.
 
 
-Getting the current option value: 
+[heading Parameters]
+    
 
-   boost::asio::ip::tcp::socket socket(io_service); 
-   ...
-   boost::asio::socket_base::receive_buffer_size option;
-   socket.get_option(option);
-   int size = option.value();
+[variablelist
+  
+[[filename][The name of the file containing the RSA private key.]]
 
+[[format][The file format (ASN.1 or PEM).]]
 
+[[ec][Set to indicate what error occurred, if any. ]]
 
+]
 
 
 
 [endsect]
 
 
+[endsect]
 
-[section:receive_low_watermark socket_base::receive_low_watermark]
+[section:use_tmp_dh_file ssl::basic_context::use_tmp_dh_file]
 
-Socket option for the receive low watermark. 
+Use the specified file to obtain the temporary Diffie-Hellman parameters. 
 
-  typedef implementation_defined receive_low_watermark;
+  void ``[link boost_asio.reference.ssl__basic_context.use_tmp_dh_file.overload1 use_tmp_dh_file]``(
+      const std::string & filename);
 
+  boost::system::error_code ``[link boost_asio.reference.ssl__basic_context.use_tmp_dh_file.overload2 use_tmp_dh_file]``(
+      const std::string & filename,
+      boost::system::error_code & ec);
 
 
-Implements the SOL\_SOCKET/SO\_RCVLOWAT socket option.
+[section:overload1 ssl::basic_context::use_tmp_dh_file (1 of 2 overloads)]
 
+Use the specified file to obtain the temporary Diffie-Hellman parameters. 
 
-[heading Examples]
-  
-Setting the option: 
+  void use_tmp_dh_file(
+      const std::string & filename);
 
-   boost::asio::ip::tcp::socket socket(io_service); 
-   ...
-   boost::asio::socket_base::receive_low_watermark option(1024);
-   socket.set_option(option);
 
+This function is used to load Diffie-Hellman parameters into the context from a file.
 
 
+[heading Parameters]
+    
 
-Getting the current option value: 
+[variablelist
+  
+[[filename][The name of the file containing the Diffie-Hellman parameters. The file must use the PEM format.]]
 
-   boost::asio::ip::tcp::socket socket(io_service); 
-   ...
-   boost::asio::socket_base::receive_low_watermark option;
-   socket.get_option(option);
-   int size = option.value();
+]
 
+[heading Exceptions]
+    
 
+[variablelist
+  
+[[boost::system::system_error][Thrown on failure. ]]
 
+]
 
 
 
@@ -33620,151 +41474,118 @@
 
 
 
-[section:reuse_address socket_base::reuse_address]
+[section:overload2 ssl::basic_context::use_tmp_dh_file (2 of 2 overloads)]
 
-Socket option to allow the socket to be bound to an address that is already in use. 
+Use the specified file to obtain the temporary Diffie-Hellman parameters. 
 
-  typedef implementation_defined reuse_address;
+  boost::system::error_code use_tmp_dh_file(
+      const std::string & filename,
+      boost::system::error_code & ec);
 
 
+This function is used to load Diffie-Hellman parameters into the context from a file.
 
-Implements the SOL\_SOCKET/SO\_REUSEADDR socket option.
 
+[heading Parameters]
+    
 
-[heading Examples]
+[variablelist
   
-Setting the option: 
-
-   boost::asio::ip::tcp::acceptor acceptor(io_service); 
-   ...
-   boost::asio::socket_base::reuse_address option(true);
-   acceptor.set_option(option);
-
-
-
-
-Getting the current option value: 
+[[filename][The name of the file containing the Diffie-Hellman parameters. The file must use the PEM format.]]
 
-   boost::asio::ip::tcp::acceptor acceptor(io_service); 
-   ...
-   boost::asio::socket_base::reuse_address option;
-   acceptor.get_option(option);
-   bool is_set = option.value();
+[[ec][Set to indicate what error occurred, if any. ]]
 
+]
 
 
 
+[endsect]
 
 
 [endsect]
 
 
+[section:verify_client_once ssl::basic_context::verify_client_once]
 
-[section:send_buffer_size socket_base::send_buffer_size]
 
-Socket option for the send buffer size of a socket. 
+['Inherited from ssl::context_base.]
 
-  typedef implementation_defined send_buffer_size;
+Do not request client certificate on renegotiation. Ignored unless verify_peer is set. 
 
+  static const int verify_client_once = implementation_defined;
 
 
-Implements the SOL\_SOCKET/SO\_SNDBUF socket option.
 
+[endsect]
 
-[heading Examples]
-  
-Setting the option: 
 
-   boost::asio::ip::tcp::socket socket(io_service); 
-   ...
-   boost::asio::socket_base::send_buffer_size option(8192);
-   socket.set_option(option);
 
+[section:verify_fail_if_no_peer_cert ssl::basic_context::verify_fail_if_no_peer_cert]
 
 
+['Inherited from ssl::context_base.]
 
-Getting the current option value: 
+Fail verification if the peer has no certificate. Ignored unless verify_peer is set. 
 
-   boost::asio::ip::tcp::socket socket(io_service); 
-   ...
-   boost::asio::socket_base::send_buffer_size option;
-   socket.get_option(option);
-   int size = option.value();
+  static const int verify_fail_if_no_peer_cert = implementation_defined;
 
 
 
+[endsect]
 
 
 
-[endsect]
+[section:verify_mode ssl::basic_context::verify_mode]
 
 
+['Inherited from ssl::context_base.]
 
-[section:send_low_watermark socket_base::send_low_watermark]
+Bitmask type for peer verification. 
 
-Socket option for the send low watermark. 
+  typedef int verify_mode;
 
-  typedef implementation_defined send_low_watermark;
 
 
 
-Implements the SOL\_SOCKET/SO\_SNDLOWAT socket option.
+[endsect]
 
 
-[heading Examples]
-  
-Setting the option: 
 
-   boost::asio::ip::tcp::socket socket(io_service); 
-   ...
-   boost::asio::socket_base::send_low_watermark option(1024);
-   socket.set_option(option);
+[section:verify_none ssl::basic_context::verify_none]
 
 
+['Inherited from ssl::context_base.]
 
+No verification. 
 
-Getting the current option value: 
+  static const int verify_none = implementation_defined;
 
-   boost::asio::ip::tcp::socket socket(io_service); 
-   ...
-   boost::asio::socket_base::send_low_watermark option;
-   socket.get_option(option);
-   int size = option.value();
 
 
+[endsect]
 
 
 
+[section:verify_peer ssl::basic_context::verify_peer]
 
-[endsect]
 
+['Inherited from ssl::context_base.]
 
+Verify the peer. 
 
-[section:shutdown_type socket_base::shutdown_type]
+  static const int verify_peer = implementation_defined;
 
-Different ways a socket may be shutdown. 
 
-  enum shutdown_type
 
-[heading Values]
-[variablelist
+[endsect]
 
-  [
-    [shutdown_receive]
-    [Shutdown the receive side of the socket. ]
-  ]
 
-  [
-    [shutdown_send]
-    [Shutdown the send side of the socket. ]
-  ]
 
-  [
-    [shutdown_both]
-    [Shutdown both send and receive on the socket. ]
-  ]
+[section:_basic_context ssl::basic_context::~basic_context]
 
-]
+Destructor. 
+
+  ~basic_context();
 
 
 
@@ -33774,14 +41595,12 @@
 
 [endsect]
 
-[section:ssl__basic_context ssl::basic_context]
 
-SSL context. 
+[section:ssl__context ssl::context]
 
-  template<
-      typename ``[link boost_asio.reference.Service Service]``>
-  class basic_context :
-    public ssl::context_base
+Typedef for the typical usage of context. 
+
+  typedef basic_context< context_service > context;
 
 
 [heading Types]
@@ -33961,73 +41780,152 @@
 
 ]
 
-[section:add_verify_path ssl::basic_context::add_verify_path]
 
-Add a directory containing certificate authority files to be used for performing verification. 
 
-  void ``[link boost_asio.reference.ssl__basic_context.add_verify_path.overload1 add_verify_path]``(
-      const std::string & path);
+[endsect]
 
-  boost::system::error_code ``[link boost_asio.reference.ssl__basic_context.add_verify_path.overload2 add_verify_path]``(
-      const std::string & path,
-      boost::system::error_code & ec);
 
+[section:ssl__context_base ssl::context_base]
 
-[section:overload1 ssl::basic_context::add_verify_path (1 of 2 overloads)]
+The context_base class is used as a base for the basic_context class template so that we have a common place to define various enums. 
 
-Add a directory containing certificate authority files to be used for performing verification. 
+  class context_base
 
-  void add_verify_path(
-      const std::string & path);
 
+[heading Types]
+[table
+  [[Name][Description]]
+
+  [
 
-This function is used to specify the name of a directory containing certification authority certificates. Each file in the directory must contain a single certificate. The files must be named using the subject name's hash and an extension of ".0".
+    [[link boost_asio.reference.ssl__context_base.file_format [*file_format]]]
+    [File format types. ]
+  
+  ]
 
+  [
 
-[heading Parameters]
-    
+    [[link boost_asio.reference.ssl__context_base.method [*method]]]
+    [Different methods supported by a context. ]
+  
+  ]
 
-[variablelist
+  [
+
+    [[link boost_asio.reference.ssl__context_base.options [*options]]]
+    [Bitmask type for SSL options. ]
   
-[[path][The name of a directory containing the certificates.]]
+  ]
+
+  [
+
+    [[link boost_asio.reference.ssl__context_base.password_purpose [*password_purpose]]]
+    [Purpose of PEM password. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.ssl__context_base.verify_mode [*verify_mode]]]
+    [Bitmask type for peer verification. ]
+  
+  ]
 
 ]
 
-[heading Exceptions]
-    
+[heading Protected Member Functions]
+[table
+  [[Name][Description]]
 
-[variablelist
+  [
+    [[link boost_asio.reference.ssl__context_base._context_base [*~context_base]]]
+    [Protected destructor to prevent deletion through this type. ]
+  ]
   
-[[boost::system::system_error][Thrown on failure. ]]
+]
+
+[heading Data Members]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.ssl__context_base.default_workarounds [*default_workarounds]]]
+    [Implement various bug workarounds. ]
+  ]
+
+  [
+    [[link boost_asio.reference.ssl__context_base.no_sslv2 [*no_sslv2]]]
+    [Disable SSL v2. ]
+  ]
+
+  [
+    [[link boost_asio.reference.ssl__context_base.no_sslv3 [*no_sslv3]]]
+    [Disable SSL v3. ]
+  ]
+
+  [
+    [[link boost_asio.reference.ssl__context_base.no_tlsv1 [*no_tlsv1]]]
+    [Disable TLS v1. ]
+  ]
+
+  [
+    [[link boost_asio.reference.ssl__context_base.single_dh_use [*single_dh_use]]]
+    [Always create a new key when using tmp_dh parameters. ]
+  ]
+
+  [
+    [[link boost_asio.reference.ssl__context_base.verify_client_once [*verify_client_once]]]
+    [Do not request client certificate on renegotiation. Ignored unless verify_peer is set. ]
+  ]
+
+  [
+    [[link boost_asio.reference.ssl__context_base.verify_fail_if_no_peer_cert [*verify_fail_if_no_peer_cert]]]
+    [Fail verification if the peer has no certificate. Ignored unless verify_peer is set. ]
+  ]
+
+  [
+    [[link boost_asio.reference.ssl__context_base.verify_none [*verify_none]]]
+    [No verification. ]
+  ]
+
+  [
+    [[link boost_asio.reference.ssl__context_base.verify_peer [*verify_peer]]]
+    [Verify the peer. ]
+  ]
 
 ]
 
 
+[section:default_workarounds ssl::context_base::default_workarounds]
 
-[endsect]
+Implement various bug workarounds. 
 
+  static const int default_workarounds = implementation_defined;
 
 
-[section:overload2 ssl::basic_context::add_verify_path (2 of 2 overloads)]
 
-Add a directory containing certificate authority files to be used for performing verification. 
+[endsect]
 
-  boost::system::error_code add_verify_path(
-      const std::string & path,
-      boost::system::error_code & ec);
 
 
-This function is used to specify the name of a directory containing certification authority certificates. Each file in the directory must contain a single certificate. The files must be named using the subject name's hash and an extension of ".0".
+[section:file_format ssl::context_base::file_format]
 
+File format types. 
 
-[heading Parameters]
-    
+  enum file_format
 
+[heading Values]
 [variablelist
-  
-[[path][The name of a directory containing the certificates.]]
 
-[[ec][Set to indicate what error occurred, if any. ]]
+  [
+    [asn1]
+    [ASN.1 file. ]
+  ]
+
+  [
+    [pem]
+    [PEM file. ]
+  ]
 
 ]
 
@@ -34036,16 +41934,89 @@
 [endsect]
 
 
+
+[section:method ssl::context_base::method]
+
+Different methods supported by a context. 
+
+  enum method
+
+[heading Values]
+[variablelist
+
+  [
+    [sslv2]
+    [Generic SSL version 2. ]
+  ]
+
+  [
+    [sslv2_client]
+    [SSL version 2 client. ]
+  ]
+
+  [
+    [sslv2_server]
+    [SSL version 2 server. ]
+  ]
+
+  [
+    [sslv3]
+    [Generic SSL version 3. ]
+  ]
+
+  [
+    [sslv3_client]
+    [SSL version 3 client. ]
+  ]
+
+  [
+    [sslv3_server]
+    [SSL version 3 server. ]
+  ]
+
+  [
+    [tlsv1]
+    [Generic TLS version 1. ]
+  ]
+
+  [
+    [tlsv1_client]
+    [TLS version 1 client. ]
+  ]
+
+  [
+    [tlsv1_server]
+    [TLS version 1 server. ]
+  ]
+
+  [
+    [sslv23]
+    [Generic SSL/TLS. ]
+  ]
+
+  [
+    [sslv23_client]
+    [SSL/TLS client. ]
+  ]
+
+  [
+    [sslv23_server]
+    [SSL/TLS server. ]
+  ]
+
+]
+
+
+
 [endsect]
 
 
-[section:basic_context ssl::basic_context::basic_context]
 
-Constructor. 
+[section:no_sslv2 ssl::context_base::no_sslv2]
 
-  basic_context(
-      boost::asio::io_service & io_service,
-      method m);
+Disable SSL v2. 
+
+  static const int no_sslv2 = implementation_defined;
 
 
 
@@ -34053,14 +42024,23 @@
 
 
 
-[section:default_workarounds ssl::basic_context::default_workarounds]
+[section:no_sslv3 ssl::context_base::no_sslv3]
 
+Disable SSL v3. 
 
-['Inherited from ssl::context_base.]
+  static const int no_sslv3 = implementation_defined;
 
-Implement various bug workarounds. 
 
-  static const int default_workarounds = implementation_defined;
+
+[endsect]
+
+
+
+[section:no_tlsv1 ssl::context_base::no_tlsv1]
+
+Disable TLS v1. 
+
+  static const int no_tlsv1 = implementation_defined;
 
 
 
@@ -34068,26 +42048,36 @@
 
 
 
-[section:file_format ssl::basic_context::file_format]
+[section:options ssl::context_base::options]
 
+Bitmask type for SSL options. 
 
-['Inherited from ssl::context_base.]
+  typedef int options;
 
-File format types. 
 
-  enum file_format
+
+
+[endsect]
+
+
+
+[section:password_purpose ssl::context_base::password_purpose]
+
+Purpose of PEM password. 
+
+  enum password_purpose
 
 [heading Values]
 [variablelist
 
   [
-    [asn1]
-    [ASN.1 file. ]
+    [for_reading]
+    [The password is needed for reading/decryption. ]
   ]
 
   [
-    [pem]
-    [PEM file. ]
+    [for_writing]
+    [The password is needed for writing/encryption. ]
   ]
 
 ]
@@ -34098,72 +42088,60 @@
 
 
 
-[section:impl ssl::basic_context::impl]
-
-Get the underlying implementation in the native type. 
+[section:single_dh_use ssl::context_base::single_dh_use]
 
-  impl_type impl();
+Always create a new key when using tmp_dh parameters. 
 
+  static const int single_dh_use = implementation_defined;
 
-This function may be used to obtain the underlying implementation of the context. This is intended to allow access to context functionality that is not otherwise provided. 
 
 
 [endsect]
 
 
 
-[section:impl_type ssl::basic_context::impl_type]
-
-The native implementation type of the locking dispatcher. 
+[section:verify_client_once ssl::context_base::verify_client_once]
 
-  typedef service_type::impl_type impl_type;
+Do not request client certificate on renegotiation. Ignored unless verify_peer is set. 
 
+  static const int verify_client_once = implementation_defined;
 
 
 
 [endsect]
 
 
-[section:load_verify_file ssl::basic_context::load_verify_file]
 
-Load a certification authority file for performing verification. 
+[section:verify_fail_if_no_peer_cert ssl::context_base::verify_fail_if_no_peer_cert]
 
-  void ``[link boost_asio.reference.ssl__basic_context.load_verify_file.overload1 load_verify_file]``(
-      const std::string & filename);
+Fail verification if the peer has no certificate. Ignored unless verify_peer is set. 
 
-  boost::system::error_code ``[link boost_asio.reference.ssl__basic_context.load_verify_file.overload2 load_verify_file]``(
-      const std::string & filename,
-      boost::system::error_code & ec);
+  static const int verify_fail_if_no_peer_cert = implementation_defined;
 
 
-[section:overload1 ssl::basic_context::load_verify_file (1 of 2 overloads)]
 
-Load a certification authority file for performing verification. 
+[endsect]
 
-  void load_verify_file(
-      const std::string & filename);
 
 
-This function is used to load one or more trusted certification authorities from a file.
+[section:verify_mode ssl::context_base::verify_mode]
 
+Bitmask type for peer verification. 
 
-[heading Parameters]
-    
+  typedef int verify_mode;
 
-[variablelist
-  
-[[filename][The name of a file containing certification authority certificates in PEM format.]]
 
-]
 
-[heading Exceptions]
-    
 
-[variablelist
-  
-[[boost::system::system_error][Thrown on failure. ]]
+[endsect]
 
-]
+
+
+[section:verify_none ssl::context_base::verify_none]
+
+No verification. 
+
+  static const int verify_none = implementation_defined;
 
 
 
@@ -34171,140 +42149,191 @@
 
 
 
-[section:overload2 ssl::basic_context::load_verify_file (2 of 2 overloads)]
+[section:verify_peer ssl::context_base::verify_peer]
 
-Load a certification authority file for performing verification. 
+Verify the peer. 
+
+  static const int verify_peer = implementation_defined;
 
-  boost::system::error_code load_verify_file(
-      const std::string & filename,
-      boost::system::error_code & ec);
 
 
-This function is used to load the certificates for one or more trusted certification authorities from a file.
+[endsect]
 
 
-[heading Parameters]
-    
 
-[variablelist
-  
-[[filename][The name of a file containing certification authority certificates in PEM format.]]
+[section:_context_base ssl::context_base::~context_base]
 
-[[ec][Set to indicate what error occurred, if any. ]]
+Protected destructor to prevent deletion through this type. 
 
-]
+  ~context_base();
 
 
 
 [endsect]
 
 
+
 [endsect]
 
+[section:ssl__context_service ssl::context_service]
 
-[section:method ssl::basic_context::method]
+Default service implementation for a context. 
 
+  class context_service :
+    public io_service::service
 
-['Inherited from ssl::context_base.]
 
-Different methods supported by a context. 
+[heading Types]
+[table
+  [[Name][Description]]
 
-  enum method
+  [
 
-[heading Values]
-[variablelist
+    [[link boost_asio.reference.ssl__context_service.impl_type [*impl_type]]]
+    [The type of the context. ]
+  
+  ]
+
+]
+
+[heading Member Functions]
+[table
+  [[Name][Description]]
 
   [
-    [sslv2]
-    [Generic SSL version 2. ]
+    [[link boost_asio.reference.ssl__context_service.add_verify_path [*add_verify_path]]]
+    [Add a directory containing certification authority files to be used for performing verification. ]
   ]
-
+  
   [
-    [sslv2_client]
-    [SSL version 2 client. ]
+    [[link boost_asio.reference.ssl__context_service.context_service [*context_service]]]
+    [Constructor. ]
   ]
-
+  
   [
-    [sslv2_server]
-    [SSL version 2 server. ]
+    [[link boost_asio.reference.ssl__context_service.create [*create]]]
+    [Create a new context implementation. ]
   ]
-
+  
   [
-    [sslv3]
-    [Generic SSL version 3. ]
+    [[link boost_asio.reference.ssl__context_service.destroy [*destroy]]]
+    [Destroy a context implementation. ]
   ]
-
+  
   [
-    [sslv3_client]
-    [SSL version 3 client. ]
+    [[link boost_asio.reference.ssl__context_service.get_io_service [*get_io_service]]]
+    [Get the io_service object that owns the service. ]
   ]
-
+  
   [
-    [sslv3_server]
-    [SSL version 3 server. ]
+    [[link boost_asio.reference.ssl__context_service.io_service [*io_service]]]
+    [(Deprecated: use get_io_service().) Get the io_service object that owns the service. ]
   ]
-
+  
   [
-    [tlsv1]
-    [Generic TLS version 1. ]
+    [[link boost_asio.reference.ssl__context_service.load_verify_file [*load_verify_file]]]
+    [Load a certification authority file for performing verification. ]
   ]
-
+  
   [
-    [tlsv1_client]
-    [TLS version 1 client. ]
+    [[link boost_asio.reference.ssl__context_service.null [*null]]]
+    [Return a null context implementation. ]
   ]
-
+  
   [
-    [tlsv1_server]
-    [TLS version 1 server. ]
+    [[link boost_asio.reference.ssl__context_service.set_options [*set_options]]]
+    [Set options on the context. ]
   ]
-
+  
   [
-    [sslv23]
-    [Generic SSL/TLS. ]
+    [[link boost_asio.reference.ssl__context_service.set_password_callback [*set_password_callback]]]
+    [Set the password callback. ]
   ]
-
+  
   [
-    [sslv23_client]
-    [SSL/TLS client. ]
+    [[link boost_asio.reference.ssl__context_service.set_verify_mode [*set_verify_mode]]]
+    [Set peer verification mode. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.ssl__context_service.shutdown_service [*shutdown_service]]]
+    [Destroy all user-defined handler objects owned by the service. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.ssl__context_service.use_certificate_chain_file [*use_certificate_chain_file]]]
+    [Use a certificate chain from a file. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.ssl__context_service.use_certificate_file [*use_certificate_file]]]
+    [Use a certificate from a file. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.ssl__context_service.use_private_key_file [*use_private_key_file]]]
+    [Use a private key from a file. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.ssl__context_service.use_rsa_private_key_file [*use_rsa_private_key_file]]]
+    [Use an RSA private key from a file. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.ssl__context_service.use_tmp_dh_file [*use_tmp_dh_file]]]
+    [Use the specified file to obtain the temporary Diffie-Hellman parameters. ]
   ]
+  
+]
+
+[heading Data Members]
+[table
+  [[Name][Description]]
 
   [
-    [sslv23_server]
-    [SSL/TLS server. ]
+    [[link boost_asio.reference.ssl__context_service.id [*id]]]
+    [The unique service identifier. ]
   ]
 
 ]
 
 
+[section:add_verify_path ssl::context_service::add_verify_path]
 
-[endsect]
+Add a directory containing certification authority files to be used for performing verification. 
 
+  boost::system::error_code add_verify_path(
+      impl_type & impl,
+      const std::string & path,
+      boost::system::error_code & ec);
 
 
-[section:no_sslv2 ssl::basic_context::no_sslv2]
 
+[endsect]
 
-['Inherited from ssl::context_base.]
 
-Disable SSL v2. 
 
-  static const int no_sslv2 = implementation_defined;
+[section:context_service ssl::context_service::context_service]
 
+Constructor. 
 
+  context_service(
+      boost::asio::io_service & io_service);
 
-[endsect]
 
 
+[endsect]
 
-[section:no_sslv3 ssl::basic_context::no_sslv3]
 
 
-['Inherited from ssl::context_base.]
+[section:create ssl::context_service::create]
 
-Disable SSL v3. 
+Create a new context implementation. 
 
-  static const int no_sslv3 = implementation_defined;
+  void create(
+      impl_type & impl,
+      context_base::method m);
 
 
 
@@ -34312,60 +42341,52 @@
 
 
 
-[section:no_tlsv1 ssl::basic_context::no_tlsv1]
+[section:destroy ssl::context_service::destroy]
 
+Destroy a context implementation. 
 
-['Inherited from ssl::context_base.]
+  void destroy(
+      impl_type & impl);
 
-Disable TLS v1. 
 
-  static const int no_tlsv1 = implementation_defined;
 
+[endsect]
 
 
-[endsect]
 
+[section:get_io_service ssl::context_service::get_io_service]
 
 
-[section:options ssl::basic_context::options]
+['Inherited from io_service.]
 
+Get the io_service object that owns the service. 
 
-['Inherited from ssl::context_base.]
+  boost::asio::io_service & get_io_service();
 
-Bitmask type for SSL options. 
 
-  typedef int options;
 
+[endsect]
 
 
 
-[endsect]
+[section:id ssl::context_service::id]
 
+The unique service identifier. 
 
+  static boost::asio::io_service::id id;
 
-[section:password_purpose ssl::basic_context::password_purpose]
 
 
-['Inherited from ssl::context_base.]
+[endsect]
 
-Purpose of PEM password. 
 
-  enum password_purpose
 
-[heading Values]
-[variablelist
+[section:impl_type ssl::context_service::impl_type]
 
-  [
-    [for_reading]
-    [The password is needed for reading/decryption. ]
-  ]
+The type of the context. 
 
-  [
-    [for_writing]
-    [The password is needed for writing/encryption. ]
-  ]
+  typedef implementation_defined impl_type;
 
-]
 
 
 
@@ -34373,58 +42394,56 @@
 
 
 
-[section:service_type ssl::basic_context::service_type]
+[section:io_service ssl::context_service::io_service]
 
-The type of the service that will be used to provide context operations. 
 
-  typedef Service service_type;
+['Inherited from io_service.]
+
+(Deprecated: use get_io_service().) Get the io_service object that owns the service. 
 
+  boost::asio::io_service & io_service();
 
 
 
 [endsect]
 
 
-[section:set_options ssl::basic_context::set_options]
 
-Set options on the context. 
+[section:load_verify_file ssl::context_service::load_verify_file]
 
-  void ``[link boost_asio.reference.ssl__basic_context.set_options.overload1 set_options]``(
-      options o);
+Load a certification authority file for performing verification. 
 
-  boost::system::error_code ``[link boost_asio.reference.ssl__basic_context.set_options.overload2 set_options]``(
-      options o,
+  boost::system::error_code load_verify_file(
+      impl_type & impl,
+      const std::string & filename,
       boost::system::error_code & ec);
 
 
-[section:overload1 ssl::basic_context::set_options (1 of 2 overloads)]
 
-Set options on the context. 
+[endsect]
 
-  void set_options(
-      options o);
 
 
-This function may be used to configure the SSL options used by the context.
+[section:null ssl::context_service::null]
 
+Return a null context implementation. 
 
-[heading Parameters]
-    
+  impl_type null() const;
 
-[variablelist
-  
-[[o][A bitmask of options. The available option values are defined in the context\_base class. The options are bitwise-ored with any existing value for the options.]]
 
-]
 
-[heading Exceptions]
-    
+[endsect]
 
-[variablelist
-  
-[[boost::system::system_error][Thrown on failure. ]]
 
-]
+
+[section:set_options ssl::context_service::set_options]
+
+Set options on the context. 
+
+  boost::system::error_code set_options(
+      impl_type & impl,
+      context_base::options o,
+      boost::system::error_code & ec);
 
 
 
@@ -34432,90 +42451,90 @@
 
 
 
-[section:overload2 ssl::basic_context::set_options (2 of 2 overloads)]
+[section:set_password_callback ssl::context_service::set_password_callback]
 
-Set options on the context. 
+Set the password callback. 
 
-  boost::system::error_code set_options(
-      options o,
+  template<
+      typename PasswordCallback>
+  boost::system::error_code set_password_callback(
+      impl_type & impl,
+      PasswordCallback callback,
       boost::system::error_code & ec);
 
 
-This function may be used to configure the SSL options used by the context.
 
+[endsect]
 
-[heading Parameters]
-    
 
-[variablelist
-  
-[[o][A bitmask of options. The available option values are defined in the context\_base class. The options are bitwise-ored with any existing value for the options.]]
 
-[[ec][Set to indicate what error occurred, if any. ]]
+[section:set_verify_mode ssl::context_service::set_verify_mode]
 
-]
+Set peer verification mode. 
+
+  boost::system::error_code set_verify_mode(
+      impl_type & impl,
+      context_base::verify_mode v,
+      boost::system::error_code & ec);
 
 
 
 [endsect]
 
 
+
+[section:shutdown_service ssl::context_service::shutdown_service]
+
+Destroy all user-defined handler objects owned by the service. 
+
+  void shutdown_service();
+
+
+
 [endsect]
 
-[section:set_password_callback ssl::basic_context::set_password_callback]
 
-Set the password callback. 
 
-  template<
-      typename PasswordCallback>
-  void ``[link boost_asio.reference.ssl__basic_context.set_password_callback.overload1 set_password_callback]``(
-      PasswordCallback callback);
+[section:use_certificate_chain_file ssl::context_service::use_certificate_chain_file]
 
-  template<
-      typename PasswordCallback>
-  boost::system::error_code ``[link boost_asio.reference.ssl__basic_context.set_password_callback.overload2 set_password_callback]``(
-      PasswordCallback callback,
+Use a certificate chain from a file. 
+
+  boost::system::error_code use_certificate_chain_file(
+      impl_type & impl,
+      const std::string & filename,
       boost::system::error_code & ec);
 
 
-[section:overload1 ssl::basic_context::set_password_callback (1 of 2 overloads)]
 
-Set the password callback. 
+[endsect]
 
-  template<
-      typename PasswordCallback>
-  void set_password_callback(
-      PasswordCallback callback);
 
 
-This function is used to specify a callback function to obtain password information about an encrypted key in PEM format.
+[section:use_certificate_file ssl::context_service::use_certificate_file]
 
+Use a certificate from a file. 
 
-[heading Parameters]
-    
+  boost::system::error_code use_certificate_file(
+      impl_type & impl,
+      const std::string & filename,
+      context_base::file_format format,
+      boost::system::error_code & ec);
 
-[variablelist
-  
-[[callback][The function object to be used for obtaining the password. The function signature of the handler must be: 
-``
-   std::string password_callback(
-     std::size_t max_length,  // The maximum size for a password.
-     password_purpose purpose // Whether password is for reading or writing.
-   ); 
 
-``
-The return value of the callback is a string containing the password.]]
 
-]
+[endsect]
 
-[heading Exceptions]
-    
 
-[variablelist
-  
-[[boost::system::system_error][Thrown on failure. ]]
 
-]
+[section:use_private_key_file ssl::context_service::use_private_key_file]
+
+Use a private key from a file. 
+
+  boost::system::error_code use_private_key_file(
+      impl_type & impl,
+      const std::string & filename,
+      context_base::file_format format,
+      boost::system::error_code & ec);
 
 
 
@@ -34523,103 +42542,216 @@
 
 
 
-[section:overload2 ssl::basic_context::set_password_callback (2 of 2 overloads)]
+[section:use_rsa_private_key_file ssl::context_service::use_rsa_private_key_file]
 
-Set the password callback. 
+Use an RSA private key from a file. 
 
-  template<
-      typename PasswordCallback>
-  boost::system::error_code set_password_callback(
-      PasswordCallback callback,
+  boost::system::error_code use_rsa_private_key_file(
+      impl_type & impl,
+      const std::string & filename,
+      context_base::file_format format,
       boost::system::error_code & ec);
 
 
-This function is used to specify a callback function to obtain password information about an encrypted key in PEM format.
 
+[endsect]
 
-[heading Parameters]
-    
 
-[variablelist
-  
-[[callback][The function object to be used for obtaining the password. The function signature of the handler must be: 
-``
-   std::string password_callback(
-     std::size_t max_length,  // The maximum size for a password.
-     password_purpose purpose // Whether password is for reading or writing.
-   ); 
 
-``
-The return value of the callback is a string containing the password.]]
+[section:use_tmp_dh_file ssl::context_service::use_tmp_dh_file]
 
-[[ec][Set to indicate what error occurred, if any. ]]
+Use the specified file to obtain the temporary Diffie-Hellman parameters. 
 
-]
+  boost::system::error_code use_tmp_dh_file(
+      impl_type & impl,
+      const std::string & filename,
+      boost::system::error_code & ec);
 
 
 
 [endsect]
 
 
+
 [endsect]
 
-[section:set_verify_mode ssl::basic_context::set_verify_mode]
+[section:ssl__stream ssl::stream]
 
-Set the peer verification mode. 
+Provides stream-oriented functionality using SSL. 
 
-  void ``[link boost_asio.reference.ssl__basic_context.set_verify_mode.overload1 set_verify_mode]``(
-      verify_mode v);
+  template<
+      typename Stream,
+      typename ``[link boost_asio.reference.Service Service]`` = stream_service>
+  class stream :
+    public ssl::stream_base
 
-  boost::system::error_code ``[link boost_asio.reference.ssl__basic_context.set_verify_mode.overload2 set_verify_mode]``(
-      verify_mode v,
-      boost::system::error_code & ec);
 
+[heading Types]
+[table
+  [[Name][Description]]
 
-[section:overload1 ssl::basic_context::set_verify_mode (1 of 2 overloads)]
+  [
 
-Set the peer verification mode. 
+    [[link boost_asio.reference.ssl__stream.handshake_type [*handshake_type]]]
+    [Different handshake types. ]
+  
+  ]
 
-  void set_verify_mode(
-      verify_mode v);
+  [
 
+    [[link boost_asio.reference.ssl__stream.impl_type [*impl_type]]]
+    [The native implementation type of the stream. ]
+  
+  ]
 
-This function may be used to configure the peer verification mode used by the context.
+  [
+
+    [[link boost_asio.reference.ssl__stream.lowest_layer_type [*lowest_layer_type]]]
+    [The type of the lowest layer. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.ssl__stream.next_layer_type [*next_layer_type]]]
+    [The type of the next layer. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.ssl__stream.service_type [*service_type]]]
+    [The type of the service that will be used to provide stream operations. ]
+  
+  ]
+
+]
+
+[heading Member Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.ssl__stream.async_handshake [*async_handshake]]]
+    [Start an asynchronous SSL handshake. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.ssl__stream.async_read_some [*async_read_some]]]
+    [Start an asynchronous read. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.ssl__stream.async_shutdown [*async_shutdown]]]
+    [Asynchronously shut down SSL on the stream. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.ssl__stream.async_write_some [*async_write_some]]]
+    [Start an asynchronous write. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.ssl__stream.get_io_service [*get_io_service]]]
+    [Get the io_service associated with the object. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.ssl__stream.handshake [*handshake]]]
+    [Perform SSL handshaking. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.ssl__stream.impl [*impl]]]
+    [Get the underlying implementation in the native type. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.ssl__stream.in_avail [*in_avail]]]
+    [Determine the amount of data that may be read without blocking. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.ssl__stream.io_service [*io_service]]]
+    [(Deprecated: use get_io_service().) Get the io_service associated with the object. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.ssl__stream.lowest_layer [*lowest_layer]]]
+    [Get a reference to the lowest layer. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.ssl__stream.next_layer [*next_layer]]]
+    [Get a reference to the next layer. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.ssl__stream.peek [*peek]]]
+    [Peek at the incoming data on the stream. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.ssl__stream.read_some [*read_some]]]
+    [Read some data from the stream. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.ssl__stream.shutdown [*shutdown]]]
+    [Shut down SSL on the stream. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.ssl__stream.stream [*stream]]]
+    [Construct a stream. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.ssl__stream.write_some [*write_some]]]
+    [Write some data to the stream. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.ssl__stream._stream [*~stream]]]
+    [Destructor. ]
+  ]
+  
+]
 
+The stream class template provides asynchronous and blocking stream-oriented functionality using SSL.
 
-[heading Parameters]
-    
 
-[variablelist
+[heading Thread Safety]
   
-[[v][A bitmask of peer verification modes. The available verify\_mode values are defined in the context\_base class.]]
-
-]
+[*Distinct] [*objects:]  Safe.
 
-[heading Exceptions]
-    
+[*Shared] [*objects:]  Unsafe.
 
-[variablelist
+[heading Example]
   
-[[boost::system::system_error][Thrown on failure. ]]
+To use the SSL stream template with an ip::tcp::socket, you would write: 
 
-]
+   boost::asio::io_service io_service;
+   boost::asio::ssl::context context(io_service, boost::asio::ssl::context::sslv23);
+   boost::asio::ssl::stream<boost::asio::ip::tcp::socket> sock(io_service, context);
 
 
 
-[endsect]
 
 
 
-[section:overload2 ssl::basic_context::set_verify_mode (2 of 2 overloads)]
+[section:async_handshake ssl::stream::async_handshake]
 
-Set the peer verification mode. 
+Start an asynchronous SSL handshake. 
 
-  boost::system::error_code set_verify_mode(
-      verify_mode v,
-      boost::system::error_code & ec);
+  template<
+      typename HandshakeHandler>
+  void async_handshake(
+      handshake_type type,
+      HandshakeHandler handler);
 
 
-This function may be used to configure the peer verification mode used by the context.
+This function is used to asynchronously perform an SSL handshake on the stream. This function call always returns immediately.
 
 
 [heading Parameters]
@@ -34627,55 +42759,38 @@
 
 [variablelist
   
-[[v][A bitmask of peer verification modes. The available verify\_mode values are defined in the context\_base class.]]
-
-[[ec][Set to indicate what error occurred, if any. ]]
-
-]
-
-
-
-[endsect]
-
-
-[endsect]
-
-
-[section:single_dh_use ssl::basic_context::single_dh_use]
-
+[[type][The type of handshaking to be performed, i.e. as a client or as a server.]]
 
-['Inherited from ssl::context_base.]
+[[handler][The handler to be called when the handshake operation completes. Copies will be made of the handler as required. The equivalent function signature of the handler must be: 
+``
+   void handler(
+     const boost::system::error_code& error // Result of operation.
+   ); 
 
-Always create a new key when using tmp_dh parameters. 
+``
+]]
 
-  static const int single_dh_use = implementation_defined;
+]
 
 
 
 [endsect]
 
 
-[section:use_certificate_chain_file ssl::basic_context::use_certificate_chain_file]
-
-Use a certificate chain from a file. 
-
-  void ``[link boost_asio.reference.ssl__basic_context.use_certificate_chain_file.overload1 use_certificate_chain_file]``(
-      const std::string & filename);
-
-  boost::system::error_code ``[link boost_asio.reference.ssl__basic_context.use_certificate_chain_file.overload2 use_certificate_chain_file]``(
-      const std::string & filename,
-      boost::system::error_code & ec);
-
 
-[section:overload1 ssl::basic_context::use_certificate_chain_file (1 of 2 overloads)]
+[section:async_read_some ssl::stream::async_read_some]
 
-Use a certificate chain from a file. 
+Start an asynchronous read. 
 
-  void use_certificate_chain_file(
-      const std::string & filename);
+  template<
+      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``,
+      typename ``[link boost_asio.reference.ReadHandler ReadHandler]``>
+  void async_read_some(
+      const MutableBufferSequence & buffers,
+      ReadHandler handler);
 
 
-This function is used to load a certificate chain into the context from a file.
+This function is used to asynchronously read one or more bytes of data from the stream. The function call always returns immediately.
 
 
 [heading Parameters]
@@ -34683,35 +42798,42 @@
 
 [variablelist
   
-[[filename][The name of the file containing the certificate. The file must use the PEM format.]]
-
-]
+[[buffers][The buffers into which the data will be read. Although the buffers object may be copied as necessary, ownership of the underlying buffers is retained by the caller, which must guarantee that they remain valid until the handler is called.]]
 
-[heading Exceptions]
-    
+[[handler][The handler to be called when the read operation completes. Copies will be made of the handler as required. The equivalent function signature of the handler must be: 
+``
+   void handler(
+     const boost::system::error_code& error, // Result of operation.
+     std::size_t bytes_transferred           // Number of bytes read.
+   ); 
 
-[variablelist
-  
-[[boost::system::system_error][Thrown on failure. ]]
+``
+]]
 
 ]
 
+[heading Remarks]
+      
+The async\_read\_some operation may not read all of the requested number of bytes. Consider using the 
+[link boost_asio.reference.async_read async_read]  function if you need to ensure that the requested amount of data is read before the asynchronous operation completes. 
+
 
 
 [endsect]
 
 
 
-[section:overload2 ssl::basic_context::use_certificate_chain_file (2 of 2 overloads)]
+[section:async_shutdown ssl::stream::async_shutdown]
 
-Use a certificate chain from a file. 
+Asynchronously shut down SSL on the stream. 
 
-  boost::system::error_code use_certificate_chain_file(
-      const std::string & filename,
-      boost::system::error_code & ec);
+  template<
+      typename ShutdownHandler>
+  void async_shutdown(
+      ShutdownHandler handler);
 
 
-This function is used to load a certificate chain into the context from a file.
+This function is used to asynchronously shut down SSL on the stream. This function call always returns immediately.
 
 
 [heading Parameters]
@@ -34719,9 +42841,14 @@
 
 [variablelist
   
-[[filename][The name of the file containing the certificate. The file must use the PEM format.]]
+[[handler][The handler to be called when the handshake operation completes. Copies will be made of the handler as required. The equivalent function signature of the handler must be: 
+``
+   void handler(
+     const boost::system::error_code& error // Result of operation.
+   ); 
 
-[[ec][Set to indicate what error occurred, if any. ]]
+``
+]]
 
 ]
 
@@ -34730,32 +42857,20 @@
 [endsect]
 
 
-[endsect]
-
-[section:use_certificate_file ssl::basic_context::use_certificate_file]
-
-Use a certificate from a file. 
-
-  void ``[link boost_asio.reference.ssl__basic_context.use_certificate_file.overload1 use_certificate_file]``(
-      const std::string & filename,
-      file_format format);
-
-  boost::system::error_code ``[link boost_asio.reference.ssl__basic_context.use_certificate_file.overload2 use_certificate_file]``(
-      const std::string & filename,
-      file_format format,
-      boost::system::error_code & ec);
-
 
-[section:overload1 ssl::basic_context::use_certificate_file (1 of 2 overloads)]
+[section:async_write_some ssl::stream::async_write_some]
 
-Use a certificate from a file. 
+Start an asynchronous write. 
 
-  void use_certificate_file(
-      const std::string & filename,
-      file_format format);
+  template<
+      typename ``[link boost_asio.reference.ConstBufferSequence ConstBufferSequence]``,
+      typename ``[link boost_asio.reference.WriteHandler WriteHandler]``>
+  void async_write_some(
+      const ConstBufferSequence & buffers,
+      WriteHandler handler);
 
 
-This function is used to load a certificate into the context from a file.
+This function is used to asynchronously write one or more bytes of data to the stream. The function call always returns immediately.
 
 
 [heading Parameters]
@@ -34763,84 +42878,71 @@
 
 [variablelist
   
-[[filename][The name of the file containing the certificate.]]
-
-[[format][The file format (ASN.1 or PEM).]]
-
-]
+[[buffers][The data to be written to the stream. Although the buffers object may be copied as necessary, ownership of the underlying buffers is retained by the caller, which must guarantee that they remain valid until the handler is called.]]
 
-[heading Exceptions]
-    
+[[handler][The handler to be called when the write operation completes. Copies will be made of the handler as required. The equivalent function signature of the handler must be: 
+``
+   void handler(
+     const boost::system::error_code& error, // Result of operation.
+     std::size_t bytes_transferred           // Number of bytes written.
+   ); 
 
-[variablelist
-  
-[[boost::system::system_error][Thrown on failure. ]]
+``
+]]
 
 ]
 
+[heading Remarks]
+      
+The async\_write\_some operation may not transmit all of the data to the peer. Consider using the 
+[link boost_asio.reference.async_write async_write]  function if you need to ensure that all data is written before the blocking operation completes. 
 
 
-[endsect]
-
-
-
-[section:overload2 ssl::basic_context::use_certificate_file (2 of 2 overloads)]
 
-Use a certificate from a file. 
+[endsect]
 
-  boost::system::error_code use_certificate_file(
-      const std::string & filename,
-      file_format format,
-      boost::system::error_code & ec);
 
 
-This function is used to load a certificate into the context from a file.
+[section:get_io_service ssl::stream::get_io_service]
 
+Get the io_service associated with the object. 
 
-[heading Parameters]
-    
+  boost::asio::io_service & get_io_service();
 
-[variablelist
-  
-[[filename][The name of the file containing the certificate.]]
 
-[[format][The file format (ASN.1 or PEM).]]
+This function may be used to obtain the io_service object that the stream uses to dispatch handlers for asynchronous operations.
 
-[[ec][Set to indicate what error occurred, if any. ]]
 
-]
+[heading Return Value]
+      
+A reference to the io_service object that stream will use to dispatch handlers. Ownership is not transferred to the caller. 
 
 
 
 [endsect]
 
 
-[endsect]
-
-[section:use_private_key_file ssl::basic_context::use_private_key_file]
+[section:handshake ssl::stream::handshake]
 
-Use a private key from a file. 
+Perform SSL handshaking. 
 
-  void ``[link boost_asio.reference.ssl__basic_context.use_private_key_file.overload1 use_private_key_file]``(
-      const std::string & filename,
-      file_format format);
+  void ``[link boost_asio.reference.ssl__stream.handshake.overload1 handshake]``(
+      handshake_type type);
 
-  boost::system::error_code ``[link boost_asio.reference.ssl__basic_context.use_private_key_file.overload2 use_private_key_file]``(
-      const std::string & filename,
-      file_format format,
+  boost::system::error_code ``[link boost_asio.reference.ssl__stream.handshake.overload2 handshake]``(
+      handshake_type type,
       boost::system::error_code & ec);
 
 
-[section:overload1 ssl::basic_context::use_private_key_file (1 of 2 overloads)]
+[section:overload1 ssl::stream::handshake (1 of 2 overloads)]
 
-Use a private key from a file. 
+Perform SSL handshaking. 
 
-  void use_private_key_file(
-      const std::string & filename,
-      file_format format);
+  void handshake(
+      handshake_type type);
 
 
-This function is used to load a private key into the context from a file.
+This function is used to perform SSL handshaking on the stream. The function call will block until handshaking is complete or an error occurs.
 
 
 [heading Parameters]
@@ -34848,9 +42950,7 @@
 
 [variablelist
   
-[[filename][The name of the file containing the private key.]]
-
-[[format][The file format (ASN.1 or PEM).]]
+[[type][The type of handshaking to be performed, i.e. as a client or as a server.]]
 
 ]
 
@@ -34869,17 +42969,16 @@
 
 
 
-[section:overload2 ssl::basic_context::use_private_key_file (2 of 2 overloads)]
+[section:overload2 ssl::stream::handshake (2 of 2 overloads)]
 
-Use a private key from a file. 
+Perform SSL handshaking. 
 
-  boost::system::error_code use_private_key_file(
-      const std::string & filename,
-      file_format format,
+  boost::system::error_code handshake(
+      handshake_type type,
       boost::system::error_code & ec);
 
 
-This function is used to load a private key into the context from a file.
+This function is used to perform SSL handshaking on the stream. The function call will block until handshaking is complete or an error occurs.
 
 
 [heading Parameters]
@@ -34887,9 +42986,7 @@
 
 [variablelist
   
-[[filename][The name of the file containing the private key.]]
-
-[[format][The file format (ASN.1 or PEM).]]
+[[type][The type of handshaking to be performed, i.e. as a client or as a server.]]
 
 [[ec][Set to indicate what error occurred, if any. ]]
 
@@ -34902,49 +42999,25 @@
 
 [endsect]
 
-[section:use_rsa_private_key_file ssl::basic_context::use_rsa_private_key_file]
-
-Use an RSA private key from a file. 
-
-  void ``[link boost_asio.reference.ssl__basic_context.use_rsa_private_key_file.overload1 use_rsa_private_key_file]``(
-      const std::string & filename,
-      file_format format);
-
-  boost::system::error_code ``[link boost_asio.reference.ssl__basic_context.use_rsa_private_key_file.overload2 use_rsa_private_key_file]``(
-      const std::string & filename,
-      file_format format,
-      boost::system::error_code & ec);
-
-
-[section:overload1 ssl::basic_context::use_rsa_private_key_file (1 of 2 overloads)]
-
-Use an RSA private key from a file. 
-
-  void use_rsa_private_key_file(
-      const std::string & filename,
-      file_format format);
-
 
-This function is used to load an RSA private key into the context from a file.
+[section:handshake_type ssl::stream::handshake_type]
 
+Different handshake types. 
 
-[heading Parameters]
-    
+  enum handshake_type
 
+[heading Values]
 [variablelist
-  
-[[filename][The name of the file containing the RSA private key.]]
-
-[[format][The file format (ASN.1 or PEM).]]
-
-]
 
-[heading Exceptions]
-    
+  [
+    [client]
+    [Perform handshaking as a client. ]
+  ]
 
-[variablelist
-  
-[[boost::system::system_error][Thrown on failure. ]]
+  [
+    [server]
+    [Perform handshaking as a server. ]
+  ]
 
 ]
 
@@ -34954,70 +43027,55 @@
 
 
 
-[section:overload2 ssl::basic_context::use_rsa_private_key_file (2 of 2 overloads)]
+[section:impl ssl::stream::impl]
 
-Use an RSA private key from a file. 
+Get the underlying implementation in the native type. 
 
-  boost::system::error_code use_rsa_private_key_file(
-      const std::string & filename,
-      file_format format,
-      boost::system::error_code & ec);
+  impl_type impl();
 
 
-This function is used to load an RSA private key into the context from a file.
+This function may be used to obtain the underlying implementation of the context. This is intended to allow access to stream functionality that is not otherwise provided. 
 
 
-[heading Parameters]
-    
+[endsect]
 
-[variablelist
-  
-[[filename][The name of the file containing the RSA private key.]]
 
-[[format][The file format (ASN.1 or PEM).]]
 
-[[ec][Set to indicate what error occurred, if any. ]]
+[section:impl_type ssl::stream::impl_type]
 
-]
+The native implementation type of the stream. 
 
+  typedef service_type::impl_type impl_type;
 
 
-[endsect]
 
 
 [endsect]
 
-[section:use_tmp_dh_file ssl::basic_context::use_tmp_dh_file]
-
-Use the specified file to obtain the temporary Diffie-Hellman parameters. 
 
-  void ``[link boost_asio.reference.ssl__basic_context.use_tmp_dh_file.overload1 use_tmp_dh_file]``(
-      const std::string & filename);
+[section:in_avail ssl::stream::in_avail]
 
-  boost::system::error_code ``[link boost_asio.reference.ssl__basic_context.use_tmp_dh_file.overload2 use_tmp_dh_file]``(
-      const std::string & filename,
-      boost::system::error_code & ec);
+Determine the amount of data that may be read without blocking. 
 
+  std::size_t ``[link boost_asio.reference.ssl__stream.in_avail.overload1 in_avail]``();
 
-[section:overload1 ssl::basic_context::use_tmp_dh_file (1 of 2 overloads)]
+  std::size_t ``[link boost_asio.reference.ssl__stream.in_avail.overload2 in_avail]``(
+      boost::system::error_code & ec);
 
-Use the specified file to obtain the temporary Diffie-Hellman parameters. 
 
-  void use_tmp_dh_file(
-      const std::string & filename);
+[section:overload1 ssl::stream::in_avail (1 of 2 overloads)]
 
+Determine the amount of data that may be read without blocking. 
 
-This function is used to load Diffie-Hellman parameters into the context from a file.
+  std::size_t in_avail();
 
 
-[heading Parameters]
-    
+This function is used to determine the amount of data, in bytes, that may be read from the stream without blocking.
 
-[variablelist
-  
-[[filename][The name of the file containing the Diffie-Hellman parameters. The file must use the PEM format.]]
 
-]
+[heading Return Value]
+      
+The number of bytes of data that can be read without blocking.
 
 [heading Exceptions]
     
@@ -35034,16 +43092,15 @@
 
 
 
-[section:overload2 ssl::basic_context::use_tmp_dh_file (2 of 2 overloads)]
+[section:overload2 ssl::stream::in_avail (2 of 2 overloads)]
 
-Use the specified file to obtain the temporary Diffie-Hellman parameters. 
+Determine the amount of data that may be read without blocking. 
 
-  boost::system::error_code use_tmp_dh_file(
-      const std::string & filename,
+  std::size_t in_avail(
       boost::system::error_code & ec);
 
 
-This function is used to load Diffie-Hellman parameters into the context from a file.
+This function is used to determine the amount of data, in bytes, that may be read from the stream without blocking.
 
 
 [heading Parameters]
@@ -35051,43 +43108,35 @@
 
 [variablelist
   
-[[filename][The name of the file containing the Diffie-Hellman parameters. The file must use the PEM format.]]
-
-[[ec][Set to indicate what error occurred, if any. ]]
+[[ec][Set to indicate what error occurred, if any.]]
 
 ]
 
+[heading Return Value]
+      
+The number of bytes of data that can be read without blocking. 
 
 
-[endsect]
-
 
 [endsect]
 
 
-[section:verify_client_once ssl::basic_context::verify_client_once]
-
-
-['Inherited from ssl::context_base.]
-
-Do not request client certificate on renegotiation. Ignored unless verify_peer is set. 
-
-  static const int verify_client_once = implementation_defined;
-
-
-
 [endsect]
 
 
+[section:io_service ssl::stream::io_service]
 
-[section:verify_fail_if_no_peer_cert ssl::basic_context::verify_fail_if_no_peer_cert]
+(Deprecated: use get_io_service().) Get the io_service associated with the object. 
 
+  boost::asio::io_service & io_service();
 
-['Inherited from ssl::context_base.]
 
-Fail verification if the peer has no certificate. Ignored unless verify_peer is set. 
+This function may be used to obtain the io_service object that the stream uses to dispatch handlers for asynchronous operations.
 
-  static const int verify_fail_if_no_peer_cert = implementation_defined;
+
+[heading Return Value]
+      
+A reference to the io_service object that stream will use to dispatch handlers. Ownership is not transferred to the caller. 
 
 
 
@@ -35095,30 +43144,32 @@
 
 
 
-[section:verify_mode ssl::basic_context::verify_mode]
+[section:lowest_layer ssl::stream::lowest_layer]
 
+Get a reference to the lowest layer. 
 
-['Inherited from ssl::context_base.]
+  lowest_layer_type & lowest_layer();
 
-Bitmask type for peer verification. 
 
-  typedef int verify_mode;
+This function returns a reference to the lowest layer in a stack of stream layers.
 
 
+[heading Return Value]
+      
+A reference to the lowest layer in the stack of stream layers. Ownership is not transferred to the caller. 
+
 
 
 [endsect]
 
 
 
-[section:verify_none ssl::basic_context::verify_none]
-
+[section:lowest_layer_type ssl::stream::lowest_layer_type]
 
-['Inherited from ssl::context_base.]
+The type of the lowest layer. 
 
-No verification. 
+  typedef next_layer_type::lowest_layer_type lowest_layer_type;
 
-  static const int verify_none = implementation_defined;
 
 
 
@@ -35126,432 +43177,299 @@
 
 
 
-[section:verify_peer ssl::basic_context::verify_peer]
+[section:next_layer ssl::stream::next_layer]
 
+Get a reference to the next layer. 
 
-['Inherited from ssl::context_base.]
+  next_layer_type & next_layer();
 
-Verify the peer. 
 
-  static const int verify_peer = implementation_defined;
+This function returns a reference to the next layer in a stack of stream layers.
 
 
+[heading Return Value]
+      
+A reference to the next layer in the stack of stream layers. Ownership is not transferred to the caller. 
 
-[endsect]
 
 
+[endsect]
 
-[section:_basic_context ssl::basic_context::~basic_context]
 
-Destructor. 
 
-  ~basic_context();
+[section:next_layer_type ssl::stream::next_layer_type]
 
+The type of the next layer. 
 
+  typedef boost::remove_reference< Stream >::type next_layer_type;
 
-[endsect]
 
 
 
 [endsect]
 
 
-[section:ssl__context ssl::context]
-
-Typedef for the typical usage of context. 
-
-  typedef basic_context< context_service > context;
+[section:peek ssl::stream::peek]
 
+Peek at the incoming data on the stream. 
 
-[heading Types]
-[table
-  [[Name][Description]]
+  template<
+      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``>
+  std::size_t ``[link boost_asio.reference.ssl__stream.peek.overload1 peek]``(
+      const MutableBufferSequence & buffers);
 
-  [
+  template<
+      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``>
+  std::size_t ``[link boost_asio.reference.ssl__stream.peek.overload2 peek]``(
+      const MutableBufferSequence & buffers,
+      boost::system::error_code & ec);
 
-    [[link boost_asio.reference.ssl__basic_context.file_format [*file_format]]]
-    [File format types. ]
-  
-  ]
 
-  [
+[section:overload1 ssl::stream::peek (1 of 2 overloads)]
 
-    [[link boost_asio.reference.ssl__basic_context.impl_type [*impl_type]]]
-    [The native implementation type of the locking dispatcher. ]
-  
-  ]
+Peek at the incoming data on the stream. 
 
-  [
+  template<
+      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``>
+  std::size_t peek(
+      const MutableBufferSequence & buffers);
 
-    [[link boost_asio.reference.ssl__basic_context.method [*method]]]
-    [Different methods supported by a context. ]
-  
-  ]
 
-  [
+This function is used to peek at the incoming data on the stream, without removing it from the input queue. The function call will block until data has been read successfully or an error occurs.
 
-    [[link boost_asio.reference.ssl__basic_context.options [*options]]]
-    [Bitmask type for SSL options. ]
-  
-  ]
 
-  [
+[heading Parameters]
+    
 
-    [[link boost_asio.reference.ssl__basic_context.password_purpose [*password_purpose]]]
-    [Purpose of PEM password. ]
+[variablelist
   
-  ]
+[[buffers][The buffers into which the data will be read.]]
 
-  [
+]
 
-    [[link boost_asio.reference.ssl__basic_context.service_type [*service_type]]]
-    [The type of the service that will be used to provide context operations. ]
-  
-  ]
+[heading Return Value]
+      
+The number of bytes read.
 
-  [
+[heading Exceptions]
+    
 
-    [[link boost_asio.reference.ssl__basic_context.verify_mode [*verify_mode]]]
-    [Bitmask type for peer verification. ]
+[variablelist
   
-  ]
+[[boost::system::system_error][Thrown on failure. ]]
 
 ]
 
-[heading Member Functions]
-[table
-  [[Name][Description]]
 
-  [
-    [[link boost_asio.reference.ssl__basic_context.add_verify_path [*add_verify_path]]]
-    [Add a directory containing certificate authority files to be used for performing verification. ]
-  ]
-  
-  [
-    [[link boost_asio.reference.ssl__basic_context.basic_context [*basic_context]]]
-    [Constructor. ]
-  ]
-  
-  [
-    [[link boost_asio.reference.ssl__basic_context.impl [*impl]]]
-    [Get the underlying implementation in the native type. ]
-  ]
-  
-  [
-    [[link boost_asio.reference.ssl__basic_context.load_verify_file [*load_verify_file]]]
-    [Load a certification authority file for performing verification. ]
-  ]
-  
-  [
-    [[link boost_asio.reference.ssl__basic_context.set_options [*set_options]]]
-    [Set options on the context. ]
-  ]
-  
-  [
-    [[link boost_asio.reference.ssl__basic_context.set_password_callback [*set_password_callback]]]
-    [Set the password callback. ]
-  ]
-  
-  [
-    [[link boost_asio.reference.ssl__basic_context.set_verify_mode [*set_verify_mode]]]
-    [Set the peer verification mode. ]
-  ]
-  
-  [
-    [[link boost_asio.reference.ssl__basic_context.use_certificate_chain_file [*use_certificate_chain_file]]]
-    [Use a certificate chain from a file. ]
-  ]
-  
-  [
-    [[link boost_asio.reference.ssl__basic_context.use_certificate_file [*use_certificate_file]]]
-    [Use a certificate from a file. ]
-  ]
-  
-  [
-    [[link boost_asio.reference.ssl__basic_context.use_private_key_file [*use_private_key_file]]]
-    [Use a private key from a file. ]
-  ]
-  
-  [
-    [[link boost_asio.reference.ssl__basic_context.use_rsa_private_key_file [*use_rsa_private_key_file]]]
-    [Use an RSA private key from a file. ]
-  ]
-  
-  [
-    [[link boost_asio.reference.ssl__basic_context.use_tmp_dh_file [*use_tmp_dh_file]]]
-    [Use the specified file to obtain the temporary Diffie-Hellman parameters. ]
-  ]
-  
-  [
-    [[link boost_asio.reference.ssl__basic_context._basic_context [*~basic_context]]]
-    [Destructor. ]
-  ]
-  
-]
 
-[heading Data Members]
-[table
-  [[Name][Description]]
+[endsect]
 
-  [
-    [[link boost_asio.reference.ssl__basic_context.default_workarounds [*default_workarounds]]]
-    [Implement various bug workarounds. ]
-  ]
 
-  [
-    [[link boost_asio.reference.ssl__basic_context.no_sslv2 [*no_sslv2]]]
-    [Disable SSL v2. ]
-  ]
 
-  [
-    [[link boost_asio.reference.ssl__basic_context.no_sslv3 [*no_sslv3]]]
-    [Disable SSL v3. ]
-  ]
+[section:overload2 ssl::stream::peek (2 of 2 overloads)]
 
-  [
-    [[link boost_asio.reference.ssl__basic_context.no_tlsv1 [*no_tlsv1]]]
-    [Disable TLS v1. ]
-  ]
+Peek at the incoming data on the stream. 
 
-  [
-    [[link boost_asio.reference.ssl__basic_context.single_dh_use [*single_dh_use]]]
-    [Always create a new key when using tmp_dh parameters. ]
-  ]
+  template<
+      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``>
+  std::size_t peek(
+      const MutableBufferSequence & buffers,
+      boost::system::error_code & ec);
 
-  [
-    [[link boost_asio.reference.ssl__basic_context.verify_client_once [*verify_client_once]]]
-    [Do not request client certificate on renegotiation. Ignored unless verify_peer is set. ]
-  ]
 
-  [
-    [[link boost_asio.reference.ssl__basic_context.verify_fail_if_no_peer_cert [*verify_fail_if_no_peer_cert]]]
-    [Fail verification if the peer has no certificate. Ignored unless verify_peer is set. ]
-  ]
+This function is used to peek at the incoming data on the stream, withoutxi removing it from the input queue. The function call will block until data has been read successfully or an error occurs.
 
-  [
-    [[link boost_asio.reference.ssl__basic_context.verify_none [*verify_none]]]
-    [No verification. ]
-  ]
 
-  [
-    [[link boost_asio.reference.ssl__basic_context.verify_peer [*verify_peer]]]
-    [Verify the peer. ]
-  ]
+[heading Parameters]
+    
+
+[variablelist
+  
+[[buffers][The buffers into which the data will be read.]]
+
+[[ec][Set to indicate what error occurred, if any.]]
 
 ]
 
+[heading Return Value]
+      
+The number of bytes read. Returns 0 if an error occurred. 
+
 
 
 [endsect]
 
 
-[section:ssl__context_base ssl::context_base]
+[endsect]
 
-The context_base class is used as a base for the basic_context class template so that we have a common place to define various enums. 
+[section:read_some ssl::stream::read_some]
 
-  class context_base
+Read some data from the stream. 
 
+  template<
+      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``>
+  std::size_t ``[link boost_asio.reference.ssl__stream.read_some.overload1 read_some]``(
+      const MutableBufferSequence & buffers);
 
-[heading Types]
-[table
-  [[Name][Description]]
+  template<
+      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``>
+  std::size_t ``[link boost_asio.reference.ssl__stream.read_some.overload2 read_some]``(
+      const MutableBufferSequence & buffers,
+      boost::system::error_code & ec);
 
-  [
 
-    [[link boost_asio.reference.ssl__context_base.file_format [*file_format]]]
-    [File format types. ]
-  
-  ]
+[section:overload1 ssl::stream::read_some (1 of 2 overloads)]
 
-  [
+Read some data from the stream. 
 
-    [[link boost_asio.reference.ssl__context_base.method [*method]]]
-    [Different methods supported by a context. ]
-  
-  ]
+  template<
+      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``>
+  std::size_t read_some(
+      const MutableBufferSequence & buffers);
 
-  [
 
-    [[link boost_asio.reference.ssl__context_base.options [*options]]]
-    [Bitmask type for SSL options. ]
-  
-  ]
+This function is used to read data from the stream. The function call will block until one or more bytes of data has been read successfully, or until an error occurs.
 
-  [
 
-    [[link boost_asio.reference.ssl__context_base.password_purpose [*password_purpose]]]
-    [Purpose of PEM password. ]
+[heading Parameters]
+    
+
+[variablelist
   
-  ]
+[[buffers][The buffers into which the data will be read.]]
 
-  [
+]
 
-    [[link boost_asio.reference.ssl__context_base.verify_mode [*verify_mode]]]
-    [Bitmask type for peer verification. ]
+[heading Return Value]
+      
+The number of bytes read.
+
+[heading Exceptions]
+    
+
+[variablelist
   
-  ]
+[[boost::system::system_error][Thrown on failure.]]
 
 ]
 
-[heading Data Members]
-[table
-  [[Name][Description]]
+[heading Remarks]
+      
+The read\_some operation may not read all of the requested number of bytes. Consider using the 
+[link boost_asio.reference.read read]  function if you need to ensure that the requested amount of data is read before the blocking operation completes. 
 
-  [
-    [[link boost_asio.reference.ssl__context_base.default_workarounds [*default_workarounds]]]
-    [Implement various bug workarounds. ]
-  ]
 
-  [
-    [[link boost_asio.reference.ssl__context_base.no_sslv2 [*no_sslv2]]]
-    [Disable SSL v2. ]
-  ]
 
-  [
-    [[link boost_asio.reference.ssl__context_base.no_sslv3 [*no_sslv3]]]
-    [Disable SSL v3. ]
-  ]
+[endsect]
 
-  [
-    [[link boost_asio.reference.ssl__context_base.no_tlsv1 [*no_tlsv1]]]
-    [Disable TLS v1. ]
-  ]
 
-  [
-    [[link boost_asio.reference.ssl__context_base.single_dh_use [*single_dh_use]]]
-    [Always create a new key when using tmp_dh parameters. ]
-  ]
 
-  [
-    [[link boost_asio.reference.ssl__context_base.verify_client_once [*verify_client_once]]]
-    [Do not request client certificate on renegotiation. Ignored unless verify_peer is set. ]
-  ]
+[section:overload2 ssl::stream::read_some (2 of 2 overloads)]
 
-  [
-    [[link boost_asio.reference.ssl__context_base.verify_fail_if_no_peer_cert [*verify_fail_if_no_peer_cert]]]
-    [Fail verification if the peer has no certificate. Ignored unless verify_peer is set. ]
-  ]
+Read some data from the stream. 
 
-  [
-    [[link boost_asio.reference.ssl__context_base.verify_none [*verify_none]]]
-    [No verification. ]
-  ]
+  template<
+      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``>
+  std::size_t read_some(
+      const MutableBufferSequence & buffers,
+      boost::system::error_code & ec);
 
-  [
-    [[link boost_asio.reference.ssl__context_base.verify_peer [*verify_peer]]]
-    [Verify the peer. ]
-  ]
+
+This function is used to read data from the stream. The function call will block until one or more bytes of data has been read successfully, or until an error occurs.
+
+
+[heading Parameters]
+    
+
+[variablelist
+  
+[[buffers][The buffers into which the data will be read.]]
+
+[[ec][Set to indicate what error occurred, if any.]]
 
 ]
 
+[heading Return Value]
+      
+The number of bytes read. Returns 0 if an error occurred.
 
-[section:default_workarounds ssl::context_base::default_workarounds]
+[heading Remarks]
+      
+The read\_some operation may not read all of the requested number of bytes. Consider using the 
+[link boost_asio.reference.read read]  function if you need to ensure that the requested amount of data is read before the blocking operation completes. 
 
-Implement various bug workarounds. 
 
-  static const int default_workarounds = implementation_defined;
 
+[endsect]
 
 
 [endsect]
 
 
+[section:service_type ssl::stream::service_type]
 
-[section:file_format ssl::context_base::file_format]
+The type of the service that will be used to provide stream operations. 
 
-File format types. 
+  typedef Service service_type;
 
-  enum file_format
 
-[heading Values]
-[variablelist
 
-  [
-    [asn1]
-    [ASN.1 file. ]
-  ]
 
-  [
-    [pem]
-    [PEM file. ]
-  ]
+[endsect]
 
-]
 
+[section:shutdown ssl::stream::shutdown]
 
+Shut down SSL on the stream. 
 
-[endsect]
+  void ``[link boost_asio.reference.ssl__stream.shutdown.overload1 shutdown]``();
 
+  boost::system::error_code ``[link boost_asio.reference.ssl__stream.shutdown.overload2 shutdown]``(
+      boost::system::error_code & ec);
 
 
-[section:method ssl::context_base::method]
+[section:overload1 ssl::stream::shutdown (1 of 2 overloads)]
 
-Different methods supported by a context. 
+Shut down SSL on the stream. 
 
-  enum method
+  void shutdown();
+
+
+This function is used to shut down SSL on the stream. The function call will block until SSL has been shut down or an error occurs.
+
+
+[heading Exceptions]
+    
 
-[heading Values]
 [variablelist
+  
+[[boost::system::system_error][Thrown on failure. ]]
 
-  [
-    [sslv2]
-    [Generic SSL version 2. ]
-  ]
+]
 
-  [
-    [sslv2_client]
-    [SSL version 2 client. ]
-  ]
 
-  [
-    [sslv2_server]
-    [SSL version 2 server. ]
-  ]
 
-  [
-    [sslv3]
-    [Generic SSL version 3. ]
-  ]
+[endsect]
 
-  [
-    [sslv3_client]
-    [SSL version 3 client. ]
-  ]
 
-  [
-    [sslv3_server]
-    [SSL version 3 server. ]
-  ]
 
-  [
-    [tlsv1]
-    [Generic TLS version 1. ]
-  ]
+[section:overload2 ssl::stream::shutdown (2 of 2 overloads)]
 
-  [
-    [tlsv1_client]
-    [TLS version 1 client. ]
-  ]
+Shut down SSL on the stream. 
 
-  [
-    [tlsv1_server]
-    [TLS version 1 server. ]
-  ]
+  boost::system::error_code shutdown(
+      boost::system::error_code & ec);
 
-  [
-    [sslv23]
-    [Generic SSL/TLS. ]
-  ]
 
-  [
-    [sslv23_client]
-    [SSL/TLS client. ]
-  ]
+This function is used to shut down SSL on the stream. The function call will block until SSL has been shut down or an error occurs.
 
-  [
-    [sslv23_server]
-    [SSL/TLS server. ]
-  ]
+
+[heading Parameters]
+    
+
+[variablelist
+  
+[[ec][Set to indicate what error occurred, if any. ]]
 
 ]
 
@@ -35560,100 +43478,149 @@
 [endsect]
 
 
+[endsect]
 
-[section:no_sslv2 ssl::context_base::no_sslv2]
 
-Disable SSL v2. 
+[section:stream ssl::stream::stream]
 
-  static const int no_sslv2 = implementation_defined;
+Construct a stream. 
 
+  template<
+      typename Arg,
+      typename Context_Service>
+  stream(
+      Arg & arg,
+      basic_context< Context_Service > & context);
 
 
-[endsect]
+This constructor creates a stream and initialises the underlying stream object.
 
 
+[heading Parameters]
+    
 
-[section:no_sslv3 ssl::context_base::no_sslv3]
+[variablelist
+  
+[[arg][The argument to be passed to initialise the underlying stream.]]
 
-Disable SSL v3. 
+[[context][The SSL context to be used for the stream. ]]
 
-  static const int no_sslv3 = implementation_defined;
+]
 
 
 
 [endsect]
 
 
+[section:write_some ssl::stream::write_some]
 
-[section:no_tlsv1 ssl::context_base::no_tlsv1]
+Write some data to the stream. 
 
-Disable TLS v1. 
+  template<
+      typename ``[link boost_asio.reference.ConstBufferSequence ConstBufferSequence]``>
+  std::size_t ``[link boost_asio.reference.ssl__stream.write_some.overload1 write_some]``(
+      const ConstBufferSequence & buffers);
+
+  template<
+      typename ``[link boost_asio.reference.ConstBufferSequence ConstBufferSequence]``>
+  std::size_t ``[link boost_asio.reference.ssl__stream.write_some.overload2 write_some]``(
+      const ConstBufferSequence & buffers,
+      boost::system::error_code & ec);
 
-  static const int no_tlsv1 = implementation_defined;
 
+[section:overload1 ssl::stream::write_some (1 of 2 overloads)]
 
+Write some data to the stream. 
 
-[endsect]
+  template<
+      typename ``[link boost_asio.reference.ConstBufferSequence ConstBufferSequence]``>
+  std::size_t write_some(
+      const ConstBufferSequence & buffers);
 
 
+This function is used to write data on the stream. The function call will block until one or more bytes of data has been written successfully, or until an error occurs.
 
-[section:options ssl::context_base::options]
 
-Bitmask type for SSL options. 
+[heading Parameters]
+    
 
-  typedef int options;
+[variablelist
+  
+[[buffers][The data to be written.]]
 
+]
 
+[heading Return Value]
+      
+The number of bytes written.
 
+[heading Exceptions]
+    
 
-[endsect]
+[variablelist
+  
+[[boost::system::system_error][Thrown on failure.]]
 
+]
 
+[heading Remarks]
+      
+The write\_some operation may not transmit all of the data to the peer. Consider using the 
+[link boost_asio.reference.write write]  function if you need to ensure that all data is written before the blocking operation completes. 
 
-[section:password_purpose ssl::context_base::password_purpose]
 
-Purpose of PEM password. 
 
-  enum password_purpose
+[endsect]
 
-[heading Values]
-[variablelist
 
-  [
-    [for_reading]
-    [The password is needed for reading/decryption. ]
-  ]
 
-  [
-    [for_writing]
-    [The password is needed for writing/encryption. ]
-  ]
+[section:overload2 ssl::stream::write_some (2 of 2 overloads)]
 
-]
+Write some data to the stream. 
 
+  template<
+      typename ``[link boost_asio.reference.ConstBufferSequence ConstBufferSequence]``>
+  std::size_t write_some(
+      const ConstBufferSequence & buffers,
+      boost::system::error_code & ec);
 
 
-[endsect]
+This function is used to write data on the stream. The function call will block until one or more bytes of data has been written successfully, or until an error occurs.
 
 
+[heading Parameters]
+    
 
-[section:single_dh_use ssl::context_base::single_dh_use]
+[variablelist
+  
+[[buffers][The data to be written to the stream.]]
 
-Always create a new key when using tmp_dh parameters. 
+[[ec][Set to indicate what error occurred, if any.]]
 
-  static const int single_dh_use = implementation_defined;
+]
+
+[heading Return Value]
+      
+The number of bytes written. Returns 0 if an error occurred.
+
+[heading Remarks]
+      
+The write\_some operation may not transmit all of the data to the peer. Consider using the 
+[link boost_asio.reference.write write]  function if you need to ensure that all data is written before the blocking operation completes. 
 
 
 
 [endsect]
 
 
+[endsect]
 
-[section:verify_client_once ssl::context_base::verify_client_once]
 
-Do not request client certificate on renegotiation. Ignored unless verify_peer is set. 
+[section:_stream ssl::stream::~stream]
+
+Destructor. 
 
-  static const int verify_client_once = implementation_defined;
+  ~stream();
 
 
 
@@ -35661,36 +43628,60 @@
 
 
 
-[section:verify_fail_if_no_peer_cert ssl::context_base::verify_fail_if_no_peer_cert]
-
-Fail verification if the peer has no certificate. Ignored unless verify_peer is set. 
+[endsect]
 
-  static const int verify_fail_if_no_peer_cert = implementation_defined;
+[section:ssl__stream_base ssl::stream_base]
 
+The stream_base class is used as a base for the boost::asio::ssl::stream class template so that we have a common place to define various enums. 
 
+  class stream_base
 
-[endsect]
 
+[heading Types]
+[table
+  [[Name][Description]]
 
+  [
 
-[section:verify_mode ssl::context_base::verify_mode]
+    [[link boost_asio.reference.ssl__stream_base.handshake_type [*handshake_type]]]
+    [Different handshake types. ]
+  
+  ]
 
-Bitmask type for peer verification. 
+]
 
-  typedef int verify_mode;
+[heading Protected Member Functions]
+[table
+  [[Name][Description]]
 
+  [
+    [[link boost_asio.reference.ssl__stream_base._stream_base [*~stream_base]]]
+    [Protected destructor to prevent deletion through this type. ]
+  ]
+  
+]
 
 
+[section:handshake_type ssl::stream_base::handshake_type]
 
-[endsect]
+Different handshake types. 
 
+  enum handshake_type
 
+[heading Values]
+[variablelist
 
-[section:verify_none ssl::context_base::verify_none]
+  [
+    [client]
+    [Perform handshaking as a client. ]
+  ]
 
-No verification. 
+  [
+    [server]
+    [Perform handshaking as a server. ]
+  ]
 
-  static const int verify_none = implementation_defined;
+]
 
 
 
@@ -35698,11 +43689,11 @@
 
 
 
-[section:verify_peer ssl::context_base::verify_peer]
+[section:_stream_base ssl::stream_base::~stream_base]
 
-Verify the peer. 
+Protected destructor to prevent deletion through this type. 
 
-  static const int verify_peer = implementation_defined;
+  ~stream_base();
 
 
 
@@ -35712,11 +43703,11 @@
 
 [endsect]
 
-[section:ssl__context_service ssl::context_service]
+[section:ssl__stream_service ssl::stream_service]
 
-Default service implementation for a context. 
+Default service implementation for an SSL stream. 
 
-  class context_service :
+  class stream_service :
     public io_service::service
 
 
@@ -35726,8 +43717,8 @@
 
   [
 
-    [[link boost_asio.reference.ssl__context_service.impl_type [*impl_type]]]
-    [The type of the context. ]
+    [[link boost_asio.reference.ssl__stream_service.impl_type [*impl_type]]]
+    [The type of a stream implementation. ]
   
   ]
 
@@ -35738,88 +43729,88 @@
   [[Name][Description]]
 
   [
-    [[link boost_asio.reference.ssl__context_service.add_verify_path [*add_verify_path]]]
-    [Add a directory containing certification authority files to be used for performing verification. ]
+    [[link boost_asio.reference.ssl__stream_service.async_handshake [*async_handshake]]]
+    [Start an asynchronous SSL handshake. ]
   ]
   
   [
-    [[link boost_asio.reference.ssl__context_service.context_service [*context_service]]]
-    [Constructor. ]
+    [[link boost_asio.reference.ssl__stream_service.async_read_some [*async_read_some]]]
+    [Start an asynchronous read. ]
   ]
   
   [
-    [[link boost_asio.reference.ssl__context_service.create [*create]]]
-    [Create a new context implementation. ]
+    [[link boost_asio.reference.ssl__stream_service.async_shutdown [*async_shutdown]]]
+    [Asynchronously shut down SSL on the stream. ]
   ]
   
   [
-    [[link boost_asio.reference.ssl__context_service.destroy [*destroy]]]
-    [Destroy a context implementation. ]
+    [[link boost_asio.reference.ssl__stream_service.async_write_some [*async_write_some]]]
+    [Start an asynchronous write. ]
   ]
   
   [
-    [[link boost_asio.reference.ssl__context_service.get_io_service [*get_io_service]]]
-    [Get the io_service object that owns the service. ]
+    [[link boost_asio.reference.ssl__stream_service.create [*create]]]
+    [Create a new stream implementation. ]
   ]
   
   [
-    [[link boost_asio.reference.ssl__context_service.io_service [*io_service]]]
-    [(Deprecated: use get_io_service().) Get the io_service object that owns the service. ]
+    [[link boost_asio.reference.ssl__stream_service.destroy [*destroy]]]
+    [Destroy a stream implementation. ]
   ]
   
   [
-    [[link boost_asio.reference.ssl__context_service.load_verify_file [*load_verify_file]]]
-    [Load a certification authority file for performing verification. ]
+    [[link boost_asio.reference.ssl__stream_service.get_io_service [*get_io_service]]]
+    [Get the io_service object that owns the service. ]
   ]
   
   [
-    [[link boost_asio.reference.ssl__context_service.null [*null]]]
-    [Return a null context implementation. ]
+    [[link boost_asio.reference.ssl__stream_service.handshake [*handshake]]]
+    [Perform SSL handshaking. ]
   ]
   
   [
-    [[link boost_asio.reference.ssl__context_service.set_options [*set_options]]]
-    [Set options on the context. ]
+    [[link boost_asio.reference.ssl__stream_service.in_avail [*in_avail]]]
+    [Determine the amount of data that may be read without blocking. ]
   ]
   
   [
-    [[link boost_asio.reference.ssl__context_service.set_password_callback [*set_password_callback]]]
-    [Set the password callback. ]
+    [[link boost_asio.reference.ssl__stream_service.io_service [*io_service]]]
+    [(Deprecated: use get_io_service().) Get the io_service object that owns the service. ]
   ]
   
   [
-    [[link boost_asio.reference.ssl__context_service.set_verify_mode [*set_verify_mode]]]
-    [Set peer verification mode. ]
+    [[link boost_asio.reference.ssl__stream_service.null [*null]]]
+    [Return a null stream implementation. ]
   ]
   
   [
-    [[link boost_asio.reference.ssl__context_service.shutdown_service [*shutdown_service]]]
-    [Destroy all user-defined handler objects owned by the service. ]
+    [[link boost_asio.reference.ssl__stream_service.peek [*peek]]]
+    [Peek at the incoming data on the stream. ]
   ]
   
   [
-    [[link boost_asio.reference.ssl__context_service.use_certificate_chain_file [*use_certificate_chain_file]]]
-    [Use a certificate chain from a file. ]
+    [[link boost_asio.reference.ssl__stream_service.read_some [*read_some]]]
+    [Read some data from the stream. ]
   ]
   
   [
-    [[link boost_asio.reference.ssl__context_service.use_certificate_file [*use_certificate_file]]]
-    [Use a certificate from a file. ]
+    [[link boost_asio.reference.ssl__stream_service.shutdown [*shutdown]]]
+    [Shut down SSL on the stream. ]
   ]
   
   [
-    [[link boost_asio.reference.ssl__context_service.use_private_key_file [*use_private_key_file]]]
-    [Use a private key from a file. ]
+    [[link boost_asio.reference.ssl__stream_service.shutdown_service [*shutdown_service]]]
+    [Destroy all user-defined handler objects owned by the service. ]
   ]
   
   [
-    [[link boost_asio.reference.ssl__context_service.use_rsa_private_key_file [*use_rsa_private_key_file]]]
-    [Use an RSA private key from a file. ]
+    [[link boost_asio.reference.ssl__stream_service.stream_service [*stream_service]]]
+    [Construct a new stream service for the specified io_service. ]
   ]
   
   [
-    [[link boost_asio.reference.ssl__context_service.use_tmp_dh_file [*use_tmp_dh_file]]]
-    [Use the specified file to obtain the temporary Diffie-Hellman parameters. ]
+    [[link boost_asio.reference.ssl__stream_service.write_some [*write_some]]]
+    [Write some data to the stream. ]
   ]
   
 ]
@@ -35829,21 +43820,25 @@
   [[Name][Description]]
 
   [
-    [[link boost_asio.reference.ssl__context_service.id [*id]]]
+    [[link boost_asio.reference.ssl__stream_service.id [*id]]]
     [The unique service identifier. ]
   ]
 
 ]
 
 
-[section:add_verify_path ssl::context_service::add_verify_path]
+[section:async_handshake ssl::stream_service::async_handshake]
 
-Add a directory containing certification authority files to be used for performing verification. 
+Start an asynchronous SSL handshake. 
 
-  boost::system::error_code add_verify_path(
+  template<
+      typename Stream,
+      typename HandshakeHandler>
+  void async_handshake(
       impl_type & impl,
-      const std::string & path,
-      boost::system::error_code & ec);
+      Stream & next_layer,
+      stream_base::handshake_type type,
+      HandshakeHandler handler);
 
 
 
@@ -35851,12 +43846,19 @@
 
 
 
-[section:context_service ssl::context_service::context_service]
+[section:async_read_some ssl::stream_service::async_read_some]
 
-Constructor. 
+Start an asynchronous read. 
 
-  context_service(
-      boost::asio::io_service & io_service);
+  template<
+      typename Stream,
+      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``,
+      typename ``[link boost_asio.reference.ReadHandler ReadHandler]``>
+  void async_read_some(
+      impl_type & impl,
+      Stream & next_layer,
+      const MutableBufferSequence & buffers,
+      ReadHandler handler);
 
 
 
@@ -35864,13 +43866,55 @@
 
 
 
-[section:create ssl::context_service::create]
+[section:async_shutdown ssl::stream_service::async_shutdown]
+
+Asynchronously shut down SSL on the stream. 
+
+  template<
+      typename Stream,
+      typename ShutdownHandler>
+  void async_shutdown(
+      impl_type & impl,
+      Stream & next_layer,
+      ShutdownHandler handler);
+
+
+
+[endsect]
+
+
+
+[section:async_write_some ssl::stream_service::async_write_some]
+
+Start an asynchronous write. 
+
+  template<
+      typename Stream,
+      typename ``[link boost_asio.reference.ConstBufferSequence ConstBufferSequence]``,
+      typename ``[link boost_asio.reference.WriteHandler WriteHandler]``>
+  void async_write_some(
+      impl_type & impl,
+      Stream & next_layer,
+      const ConstBufferSequence & buffers,
+      WriteHandler handler);
 
-Create a new context implementation. 
 
+
+[endsect]
+
+
+
+[section:create ssl::stream_service::create]
+
+Create a new stream implementation. 
+
+  template<
+      typename Stream,
+      typename Context_Service>
   void create(
       impl_type & impl,
-      context_base::method m);
+      Stream & next_layer,
+      basic_context< Context_Service > & context);
 
 
 
@@ -35878,12 +43922,15 @@
 
 
 
-[section:destroy ssl::context_service::destroy]
+[section:destroy ssl::stream_service::destroy]
 
-Destroy a context implementation. 
+Destroy a stream implementation. 
 
+  template<
+      typename Stream>
   void destroy(
-      impl_type & impl);
+      impl_type & impl,
+      Stream & next_layer);
 
 
 
@@ -35891,7 +43938,7 @@
 
 
 
-[section:get_io_service ssl::context_service::get_io_service]
+[section:get_io_service ssl::stream_service::get_io_service]
 
 
 ['Inherited from io_service.]
@@ -35906,11 +43953,17 @@
 
 
 
-[section:id ssl::context_service::id]
+[section:handshake ssl::stream_service::handshake]
 
-The unique service identifier. 
+Perform SSL handshaking. 
 
-  static boost::asio::io_service::id id;
+  template<
+      typename Stream>
+  boost::system::error_code handshake(
+      impl_type & impl,
+      Stream & next_layer,
+      stream_base::handshake_type type,
+      boost::system::error_code & ec);
 
 
 
@@ -35918,12 +43971,11 @@
 
 
 
-[section:impl_type ssl::context_service::impl_type]
-
-The type of the context. 
+[section:id ssl::stream_service::id]
 
-  typedef implementation_defined impl_type;
+The unique service identifier. 
 
+  static boost::asio::io_service::id id;
 
 
 
@@ -35931,14 +43983,12 @@
 
 
 
-[section:io_service ssl::context_service::io_service]
-
+[section:impl_type ssl::stream_service::impl_type]
 
-['Inherited from io_service.]
+The type of a stream implementation. 
 
-(Deprecated: use get_io_service().) Get the io_service object that owns the service. 
+  typedef implementation_defined impl_type;
 
-  boost::asio::io_service & io_service();
 
 
 
@@ -35946,13 +43996,15 @@
 
 
 
-[section:load_verify_file ssl::context_service::load_verify_file]
+[section:in_avail ssl::stream_service::in_avail]
 
-Load a certification authority file for performing verification. 
+Determine the amount of data that may be read without blocking. 
 
-  boost::system::error_code load_verify_file(
+  template<
+      typename Stream>
+  std::size_t in_avail(
       impl_type & impl,
-      const std::string & filename,
+      Stream & next_layer,
       boost::system::error_code & ec);
 
 
@@ -35961,11 +44013,14 @@
 
 
 
-[section:null ssl::context_service::null]
+[section:io_service ssl::stream_service::io_service]
 
-Return a null context implementation. 
 
-  impl_type null() const;
+['Inherited from io_service.]
+
+(Deprecated: use get_io_service().) Get the io_service object that owns the service. 
+
+  boost::asio::io_service & io_service();
 
 
 
@@ -35973,14 +44028,11 @@
 
 
 
-[section:set_options ssl::context_service::set_options]
+[section:null ssl::stream_service::null]
 
-Set options on the context. 
+Return a null stream implementation. 
 
-  boost::system::error_code set_options(
-      impl_type & impl,
-      context_base::options o,
-      boost::system::error_code & ec);
+  impl_type null() const;
 
 
 
@@ -35988,15 +44040,17 @@
 
 
 
-[section:set_password_callback ssl::context_service::set_password_callback]
+[section:peek ssl::stream_service::peek]
 
-Set the password callback. 
+Peek at the incoming data on the stream. 
 
   template<
-      typename PasswordCallback>
-  boost::system::error_code set_password_callback(
+      typename Stream,
+      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``>
+  std::size_t peek(
       impl_type & impl,
-      PasswordCallback callback,
+      Stream & next_layer,
+      const MutableBufferSequence & buffers,
       boost::system::error_code & ec);
 
 
@@ -36005,13 +44059,17 @@
 
 
 
-[section:set_verify_mode ssl::context_service::set_verify_mode]
+[section:read_some ssl::stream_service::read_some]
 
-Set peer verification mode. 
+Read some data from the stream. 
 
-  boost::system::error_code set_verify_mode(
+  template<
+      typename Stream,
+      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``>
+  std::size_t read_some(
       impl_type & impl,
-      context_base::verify_mode v,
+      Stream & next_layer,
+      const MutableBufferSequence & buffers,
       boost::system::error_code & ec);
 
 
@@ -36020,11 +44078,16 @@
 
 
 
-[section:shutdown_service ssl::context_service::shutdown_service]
+[section:shutdown ssl::stream_service::shutdown]
 
-Destroy all user-defined handler objects owned by the service. 
+Shut down SSL on the stream. 
 
-  void shutdown_service();
+  template<
+      typename Stream>
+  boost::system::error_code shutdown(
+      impl_type & impl,
+      Stream & next_layer,
+      boost::system::error_code & ec);
 
 
 
@@ -36032,14 +44095,11 @@
 
 
 
-[section:use_certificate_chain_file ssl::context_service::use_certificate_chain_file]
+[section:shutdown_service ssl::stream_service::shutdown_service]
 
-Use a certificate chain from a file. 
+Destroy all user-defined handler objects owned by the service. 
 
-  boost::system::error_code use_certificate_chain_file(
-      impl_type & impl,
-      const std::string & filename,
-      boost::system::error_code & ec);
+  void shutdown_service();
 
 
 
@@ -36047,15 +44107,12 @@
 
 
 
-[section:use_certificate_file ssl::context_service::use_certificate_file]
+[section:stream_service ssl::stream_service::stream_service]
 
-Use a certificate from a file. 
+Construct a new stream service for the specified io_service. 
 
-  boost::system::error_code use_certificate_file(
-      impl_type & impl,
-      const std::string & filename,
-      context_base::file_format format,
-      boost::system::error_code & ec);
+  stream_service(
+      boost::asio::io_service & io_service);
 
 
 
@@ -36063,14 +44120,17 @@
 
 
 
-[section:use_private_key_file ssl::context_service::use_private_key_file]
+[section:write_some ssl::stream_service::write_some]
 
-Use a private key from a file. 
+Write some data to the stream. 
 
-  boost::system::error_code use_private_key_file(
+  template<
+      typename Stream,
+      typename ``[link boost_asio.reference.ConstBufferSequence ConstBufferSequence]``>
+  std::size_t write_some(
       impl_type & impl,
-      const std::string & filename,
-      context_base::file_format format,
+      Stream & next_layer,
+      const ConstBufferSequence & buffers,
       boost::system::error_code & ec);
 
 
@@ -36079,48 +44139,80 @@
 
 
 
-[section:use_rsa_private_key_file ssl::context_service::use_rsa_private_key_file]
-
-Use an RSA private key from a file. 
+[endsect]
 
-  boost::system::error_code use_rsa_private_key_file(
-      impl_type & impl,
-      const std::string & filename,
-      context_base::file_format format,
-      boost::system::error_code & ec);
 
+[section:strand strand]
 
+Typedef for backwards compatibility. 
 
-[endsect]
+  typedef boost::asio::io_service::strand strand;
 
 
+[heading Member Functions]
+[table
+  [[Name][Description]]
 
-[section:use_tmp_dh_file ssl::context_service::use_tmp_dh_file]
+  [
+    [[link boost_asio.reference.io_service__strand.dispatch [*dispatch]]]
+    [Request the strand to invoke the given handler. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.io_service__strand.get_io_service [*get_io_service]]]
+    [Get the io_service associated with the strand. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.io_service__strand.io_service [*io_service]]]
+    [(Deprecated: use get_io_service().) Get the io_service associated with the strand. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.io_service__strand.post [*post]]]
+    [Request the strand to invoke the given handler and return immediately. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.io_service__strand.strand [*strand]]]
+    [Constructor. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.io_service__strand.wrap [*wrap]]]
+    [Create a new handler that automatically dispatches the wrapped handler on the strand. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.io_service__strand._strand [*~strand]]]
+    [Destructor. ]
+  ]
+  
+]
 
-Use the specified file to obtain the temporary Diffie-Hellman parameters. 
+The io_service::strand class provides the ability to post and dispatch handlers with the guarantee that none of those handlers will execute concurrently.
 
-  boost::system::error_code use_tmp_dh_file(
-      impl_type & impl,
-      const std::string & filename,
-      boost::system::error_code & ec);
 
+[heading Thread Safety]
+  
+[*Distinct] [*objects:]  Safe.
 
+[*Shared] [*objects:]  Safe.
 
-[endsect]
 
 
 
 [endsect]
 
-[section:ssl__stream ssl::stream]
 
-Provides stream-oriented functionality using SSL. 
+[section:stream_socket_service stream_socket_service]
+
+Default service implementation for a stream socket. 
 
   template<
-      typename Stream,
-      typename ``[link boost_asio.reference.Service Service]`` = stream_service>
-  class stream :
-    public ssl::stream_base
+      typename ``[link boost_asio.reference.Protocol Protocol]``>
+  class stream_socket_service :
+    public io_service::service
 
 
 [heading Types]
@@ -36129,36 +44221,29 @@
 
   [
 
-    [[link boost_asio.reference.ssl__stream.handshake_type [*handshake_type]]]
-    [Different handshake types. ]
-  
-  ]
-
-  [
-
-    [[link boost_asio.reference.ssl__stream.impl_type [*impl_type]]]
-    [The native implementation type of the stream. ]
+    [[link boost_asio.reference.stream_socket_service.endpoint_type [*endpoint_type]]]
+    [The endpoint type. ]
   
   ]
 
   [
 
-    [[link boost_asio.reference.ssl__stream.lowest_layer_type [*lowest_layer_type]]]
-    [The type of the lowest layer. ]
+    [[link boost_asio.reference.stream_socket_service.implementation_type [*implementation_type]]]
+    [The type of a stream socket implementation. ]
   
   ]
 
   [
 
-    [[link boost_asio.reference.ssl__stream.next_layer_type [*next_layer_type]]]
-    [The type of the next layer. ]
+    [[link boost_asio.reference.stream_socket_service.native_type [*native_type]]]
+    [The native socket type. ]
   
   ]
 
   [
 
-    [[link boost_asio.reference.ssl__stream.service_type [*service_type]]]
-    [The type of the service that will be used to provide stream operations. ]
+    [[link boost_asio.reference.stream_socket_service.protocol_type [*protocol_type]]]
+    [The protocol type. ]
   
   ]
 
@@ -36169,145 +44254,180 @@
   [[Name][Description]]
 
   [
-    [[link boost_asio.reference.ssl__stream.async_handshake [*async_handshake]]]
-    [Start an asynchronous SSL handshake. ]
+    [[link boost_asio.reference.stream_socket_service.assign [*assign]]]
+    [Assign an existing native socket to a stream socket. ]
   ]
   
   [
-    [[link boost_asio.reference.ssl__stream.async_read_some [*async_read_some]]]
-    [Start an asynchronous read. ]
+    [[link boost_asio.reference.stream_socket_service.async_connect [*async_connect]]]
+    [Start an asynchronous connect. ]
   ]
   
   [
-    [[link boost_asio.reference.ssl__stream.async_shutdown [*async_shutdown]]]
-    [Asynchronously shut down SSL on the stream. ]
+    [[link boost_asio.reference.stream_socket_service.async_receive [*async_receive]]]
+    [Start an asynchronous receive. ]
   ]
   
   [
-    [[link boost_asio.reference.ssl__stream.async_write_some [*async_write_some]]]
-    [Start an asynchronous write. ]
+    [[link boost_asio.reference.stream_socket_service.async_send [*async_send]]]
+    [Start an asynchronous send. ]
   ]
   
   [
-    [[link boost_asio.reference.ssl__stream.get_io_service [*get_io_service]]]
-    [Get the io_service associated with the object. ]
+    [[link boost_asio.reference.stream_socket_service.at_mark [*at_mark]]]
+    [Determine whether the socket is at the out-of-band data mark. ]
   ]
   
   [
-    [[link boost_asio.reference.ssl__stream.handshake [*handshake]]]
-    [Perform SSL handshaking. ]
+    [[link boost_asio.reference.stream_socket_service.available [*available]]]
+    [Determine the number of bytes available for reading. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.stream_socket_service.bind [*bind]]]
+    [Bind the stream socket to the specified local endpoint. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.stream_socket_service.cancel [*cancel]]]
+    [Cancel all asynchronous operations associated with the socket. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.stream_socket_service.close [*close]]]
+    [Close a stream socket implementation. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.stream_socket_service.connect [*connect]]]
+    [Connect the stream socket to the specified endpoint. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.stream_socket_service.construct [*construct]]]
+    [Construct a new stream socket implementation. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.stream_socket_service.destroy [*destroy]]]
+    [Destroy a stream socket implementation. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.stream_socket_service.get_io_service [*get_io_service]]]
+    [Get the io_service object that owns the service. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.stream_socket_service.get_option [*get_option]]]
+    [Get a socket option. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.stream_socket_service.io_control [*io_control]]]
+    [Perform an IO control command on the socket. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.stream_socket_service.io_service [*io_service]]]
+    [(Deprecated: use get_io_service().) Get the io_service object that owns the service. ]
   ]
   
   [
-    [[link boost_asio.reference.ssl__stream.impl [*impl]]]
-    [Get the underlying implementation in the native type. ]
+    [[link boost_asio.reference.stream_socket_service.is_open [*is_open]]]
+    [Determine whether the socket is open. ]
   ]
   
   [
-    [[link boost_asio.reference.ssl__stream.in_avail [*in_avail]]]
-    [Determine the amount of data that may be read without blocking. ]
+    [[link boost_asio.reference.stream_socket_service.local_endpoint [*local_endpoint]]]
+    [Get the local endpoint. ]
   ]
   
   [
-    [[link boost_asio.reference.ssl__stream.io_service [*io_service]]]
-    [(Deprecated: use get_io_service().) Get the io_service associated with the object. ]
+    [[link boost_asio.reference.stream_socket_service.native [*native]]]
+    [Get the native socket implementation. ]
   ]
   
   [
-    [[link boost_asio.reference.ssl__stream.lowest_layer [*lowest_layer]]]
-    [Get a reference to the lowest layer. ]
+    [[link boost_asio.reference.stream_socket_service.open [*open]]]
+    [Open a stream socket. ]
   ]
   
   [
-    [[link boost_asio.reference.ssl__stream.next_layer [*next_layer]]]
-    [Get a reference to the next layer. ]
+    [[link boost_asio.reference.stream_socket_service.receive [*receive]]]
+    [Receive some data from the peer. ]
   ]
   
   [
-    [[link boost_asio.reference.ssl__stream.peek [*peek]]]
-    [Peek at the incoming data on the stream. ]
+    [[link boost_asio.reference.stream_socket_service.remote_endpoint [*remote_endpoint]]]
+    [Get the remote endpoint. ]
   ]
   
   [
-    [[link boost_asio.reference.ssl__stream.read_some [*read_some]]]
-    [Read some data from the stream. ]
+    [[link boost_asio.reference.stream_socket_service.send [*send]]]
+    [Send the given data to the peer. ]
   ]
   
   [
-    [[link boost_asio.reference.ssl__stream.shutdown [*shutdown]]]
-    [Shut down SSL on the stream. ]
+    [[link boost_asio.reference.stream_socket_service.set_option [*set_option]]]
+    [Set a socket option. ]
   ]
   
   [
-    [[link boost_asio.reference.ssl__stream.stream [*stream]]]
-    [Construct a stream. ]
+    [[link boost_asio.reference.stream_socket_service.shutdown [*shutdown]]]
+    [Disable sends or receives on the socket. ]
   ]
   
   [
-    [[link boost_asio.reference.ssl__stream.write_some [*write_some]]]
-    [Write some data to the stream. ]
+    [[link boost_asio.reference.stream_socket_service.shutdown_service [*shutdown_service]]]
+    [Destroy all user-defined handler objects owned by the service. ]
   ]
   
   [
-    [[link boost_asio.reference.ssl__stream._stream [*~stream]]]
-    [Destructor. ]
+    [[link boost_asio.reference.stream_socket_service.stream_socket_service [*stream_socket_service]]]
+    [Construct a new stream socket service for the specified io_service. ]
   ]
   
 ]
 
-The stream class template provides asynchronous and blocking stream-oriented functionality using SSL.
-
-
-[heading Thread Safety]
-  
-[*Distinct] [*objects:]  Safe.
-
-[*Shared] [*objects:]  Unsafe.
-
-[heading Example]
-  
-To use the SSL stream template with an ip::tcp::socket, you would write: 
-
-   boost::asio::io_service io_service;
-   boost::asio::ssl::context context(io_service, boost::asio::ssl::context::sslv23);
-   boost::asio::ssl::stream<boost::asio::ip::tcp::socket> sock(io_service, context);
-
-
+[heading Data Members]
+[table
+  [[Name][Description]]
 
+  [
+    [[link boost_asio.reference.stream_socket_service.id [*id]]]
+    [The unique service identifier. ]
+  ]
 
+]
 
 
-[section:async_handshake ssl::stream::async_handshake]
+[section:assign stream_socket_service::assign]
 
-Start an asynchronous SSL handshake. 
+Assign an existing native socket to a stream socket. 
 
-  template<
-      typename HandshakeHandler>
-  void async_handshake(
-      handshake_type type,
-      HandshakeHandler handler);
+  boost::system::error_code assign(
+      implementation_type & impl,
+      const protocol_type & protocol,
+      const native_type & native_socket,
+      boost::system::error_code & ec);
 
 
-This function is used to asynchronously perform an SSL handshake on the stream. This function call always returns immediately.
 
+[endsect]
 
-[heading Parameters]
-    
 
-[variablelist
-  
-[[type][The type of handshaking to be performed, i.e. as a client or as a server.]]
 
-[[handler][The handler to be called when the handshake operation completes. Copies will be made of the handler as required. The equivalent function signature of the handler must be: 
-``
-   void handler(
-     const boost::system::error_code& error // Result of operation.
-   ); 
+[section:async_connect stream_socket_service::async_connect]
 
-``
-]]
+Start an asynchronous connect. 
 
-]
+  template<
+      typename ``[link boost_asio.reference.ConnectHandler ConnectHandler]``>
+  void async_connect(
+      implementation_type & impl,
+      const endpoint_type & peer_endpoint,
+      ConnectHandler handler);
 
 
 
@@ -36315,124 +44435,51 @@
 
 
 
-[section:async_read_some ssl::stream::async_read_some]
+[section:async_receive stream_socket_service::async_receive]
 
-Start an asynchronous read. 
+Start an asynchronous receive. 
 
   template<
       typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``,
       typename ``[link boost_asio.reference.ReadHandler ReadHandler]``>
-  void async_read_some(
+  void async_receive(
+      implementation_type & impl,
       const MutableBufferSequence & buffers,
+      socket_base::message_flags flags,
       ReadHandler handler);
 
 
-This function is used to asynchronously read one or more bytes of data from the stream. The function call always returns immediately.
-
-
-[heading Parameters]
-    
-
-[variablelist
-  
-[[buffers][The buffers into which the data will be read. Although the buffers object may be copied as necessary, ownership of the underlying buffers is retained by the caller, which must guarantee that they remain valid until the handler is called.]]
-
-[[handler][The handler to be called when the read operation completes. Copies will be made of the handler as required. The equivalent function signature of the handler must be: 
-``
-   void handler(
-     const boost::system::error_code& error, // Result of operation.
-     std::size_t bytes_transferred           // Number of bytes read.
-   ); 
-
-``
-]]
-
-]
-
-[heading Remarks]
-      
-The async\_read\_some operation may not read all of the requested number of bytes. Consider using the 
-[link boost_asio.reference.async_read async_read]  function if you need to ensure that the requested amount of data is read before the asynchronous operation completes. 
-
-
-
-[endsect]
-
-
-
-[section:async_shutdown ssl::stream::async_shutdown]
-
-Asynchronously shut down SSL on the stream. 
-
-  template<
-      typename ShutdownHandler>
-  void async_shutdown(
-      ShutdownHandler handler);
-
-
-This function is used to asynchronously shut down SSL on the stream. This function call always returns immediately.
-
-
-[heading Parameters]
-    
-
-[variablelist
-  
-[[handler][The handler to be called when the handshake operation completes. Copies will be made of the handler as required. The equivalent function signature of the handler must be: 
-``
-   void handler(
-     const boost::system::error_code& error // Result of operation.
-   ); 
-
-``
-]]
-
-]
-
-
 
 [endsect]
 
 
 
-[section:async_write_some ssl::stream::async_write_some]
+[section:async_send stream_socket_service::async_send]
 
-Start an asynchronous write. 
+Start an asynchronous send. 
 
   template<
       typename ``[link boost_asio.reference.ConstBufferSequence ConstBufferSequence]``,
       typename ``[link boost_asio.reference.WriteHandler WriteHandler]``>
-  void async_write_some(
+  void async_send(
+      implementation_type & impl,
       const ConstBufferSequence & buffers,
+      socket_base::message_flags flags,
       WriteHandler handler);
 
 
-This function is used to asynchronously write one or more bytes of data to the stream. The function call always returns immediately.
-
 
-[heading Parameters]
-    
+[endsect]
 
-[variablelist
-  
-[[buffers][The data to be written to the stream. Although the buffers object may be copied as necessary, ownership of the underlying buffers is retained by the caller, which must guarantee that they remain valid until the handler is called.]]
 
-[[handler][The handler to be called when the write operation completes. Copies will be made of the handler as required. The equivalent function signature of the handler must be: 
-``
-   void handler(
-     const boost::system::error_code& error, // Result of operation.
-     std::size_t bytes_transferred           // Number of bytes written.
-   ); 
 
-``
-]]
+[section:at_mark stream_socket_service::at_mark]
 
-]
+Determine whether the socket is at the out-of-band data mark. 
 
-[heading Remarks]
-      
-The async\_write\_some operation may not transmit all of the data to the peer. Consider using the 
-[link boost_asio.reference.async_write async_write]  function if you need to ensure that all data is written before the blocking operation completes. 
+  bool at_mark(
+      const implementation_type & impl,
+      boost::system::error_code & ec) const;
 
 
 
@@ -36440,65 +44487,42 @@
 
 
 
-[section:get_io_service ssl::stream::get_io_service]
-
-Get the io_service associated with the object. 
-
-  boost::asio::io_service & get_io_service();
-
-
-This function may be used to obtain the io_service object that the stream uses to dispatch handlers for asynchronous operations.
+[section:available stream_socket_service::available]
 
+Determine the number of bytes available for reading. 
 
-[heading Return Value]
-      
-A reference to the io_service object that stream will use to dispatch handlers. Ownership is not transferred to the caller. 
+  std::size_t available(
+      const implementation_type & impl,
+      boost::system::error_code & ec) const;
 
 
 
 [endsect]
 
 
-[section:handshake ssl::stream::handshake]
 
-Perform SSL handshaking. 
+[section:bind stream_socket_service::bind]
 
-  void ``[link boost_asio.reference.ssl__stream.handshake.overload1 handshake]``(
-      handshake_type type);
+Bind the stream socket to the specified local endpoint. 
 
-  boost::system::error_code ``[link boost_asio.reference.ssl__stream.handshake.overload2 handshake]``(
-      handshake_type type,
+  boost::system::error_code bind(
+      implementation_type & impl,
+      const endpoint_type & endpoint,
       boost::system::error_code & ec);
 
 
-[section:overload1 ssl::stream::handshake (1 of 2 overloads)]
-
-Perform SSL handshaking. 
-
-  void handshake(
-      handshake_type type);
-
-
-This function is used to perform SSL handshaking on the stream. The function call will block until handshaking is complete or an error occurs.
-
 
-[heading Parameters]
-    
+[endsect]
 
-[variablelist
-  
-[[type][The type of handshaking to be performed, i.e. as a client or as a server.]]
 
-]
 
-[heading Exceptions]
-    
+[section:cancel stream_socket_service::cancel]
 
-[variablelist
-  
-[[boost::system::system_error][Thrown on failure. ]]
+Cancel all asynchronous operations associated with the socket. 
 
-]
+  boost::system::error_code cancel(
+      implementation_type & impl,
+      boost::system::error_code & ec);
 
 
 
@@ -36506,57 +44530,41 @@
 
 
 
-[section:overload2 ssl::stream::handshake (2 of 2 overloads)]
+[section:close stream_socket_service::close]
 
-Perform SSL handshaking. 
+Close a stream socket implementation. 
 
-  boost::system::error_code handshake(
-      handshake_type type,
+  boost::system::error_code close(
+      implementation_type & impl,
       boost::system::error_code & ec);
 
 
-This function is used to perform SSL handshaking on the stream. The function call will block until handshaking is complete or an error occurs.
-
 
-[heading Parameters]
-    
+[endsect]
 
-[variablelist
-  
-[[type][The type of handshaking to be performed, i.e. as a client or as a server.]]
 
-[[ec][Set to indicate what error occurred, if any. ]]
 
-]
+[section:connect stream_socket_service::connect]
 
+Connect the stream socket to the specified endpoint. 
 
+  boost::system::error_code connect(
+      implementation_type & impl,
+      const endpoint_type & peer_endpoint,
+      boost::system::error_code & ec);
 
-[endsect]
 
 
 [endsect]
 
 
-[section:handshake_type ssl::stream::handshake_type]
-
-Different handshake types. 
-
-  enum handshake_type
-
-[heading Values]
-[variablelist
 
-  [
-    [client]
-    [Perform handshaking as a client. ]
-  ]
+[section:construct stream_socket_service::construct]
 
-  [
-    [server]
-    [Perform handshaking as a server. ]
-  ]
+Construct a new stream socket implementation. 
 
-]
+  void construct(
+      implementation_type & impl);
 
 
 
@@ -36564,25 +44572,24 @@
 
 
 
-[section:impl ssl::stream::impl]
-
-Get the underlying implementation in the native type. 
+[section:destroy stream_socket_service::destroy]
 
-  impl_type impl();
+Destroy a stream socket implementation. 
 
+  void destroy(
+      implementation_type & impl);
 
-This function may be used to obtain the underlying implementation of the context. This is intended to allow access to stream functionality that is not otherwise provided. 
 
 
 [endsect]
 
 
 
-[section:impl_type ssl::stream::impl_type]
+[section:endpoint_type stream_socket_service::endpoint_type]
 
-The native implementation type of the stream. 
+The endpoint type. 
 
-  typedef service_type::impl_type impl_type;
+  typedef Protocol::endpoint endpoint_type;
 
 
 
@@ -36590,38 +44597,32 @@
 [endsect]
 
 
-[section:in_avail ssl::stream::in_avail]
-
-Determine the amount of data that may be read without blocking. 
 
-  std::size_t ``[link boost_asio.reference.ssl__stream.in_avail.overload1 in_avail]``();
+[section:get_io_service stream_socket_service::get_io_service]
 
-  std::size_t ``[link boost_asio.reference.ssl__stream.in_avail.overload2 in_avail]``(
-      boost::system::error_code & ec);
 
+['Inherited from io_service.]
 
-[section:overload1 ssl::stream::in_avail (1 of 2 overloads)]
+Get the io_service object that owns the service. 
 
-Determine the amount of data that may be read without blocking. 
+  boost::asio::io_service & get_io_service();
 
-  std::size_t in_avail();
 
 
-This function is used to determine the amount of data, in bytes, that may be read from the stream without blocking.
+[endsect]
 
 
-[heading Return Value]
-      
-The number of bytes of data that can be read without blocking.
 
-[heading Exceptions]
-    
+[section:get_option stream_socket_service::get_option]
 
-[variablelist
-  
-[[boost::system::system_error][Thrown on failure. ]]
+Get a socket option. 
 
-]
+  template<
+      typename ``[link boost_asio.reference.GettableSocketOption GettableSocketOption]``>
+  boost::system::error_code get_option(
+      const implementation_type & impl,
+      GettableSocketOption & option,
+      boost::system::error_code & ec) const;
 
 
 
@@ -36629,51 +44630,41 @@
 
 
 
-[section:overload2 ssl::stream::in_avail (2 of 2 overloads)]
+[section:id stream_socket_service::id]
 
-Determine the amount of data that may be read without blocking. 
+The unique service identifier. 
 
-  std::size_t in_avail(
-      boost::system::error_code & ec);
+  static boost::asio::io_service::id id;
 
 
-This function is used to determine the amount of data, in bytes, that may be read from the stream without blocking.
 
+[endsect]
 
-[heading Parameters]
-    
 
-[variablelist
-  
-[[ec][Set to indicate what error occurred, if any.]]
 
-]
+[section:implementation_type stream_socket_service::implementation_type]
 
-[heading Return Value]
-      
-The number of bytes of data that can be read without blocking. 
+The type of a stream socket implementation. 
 
+  typedef implementation_defined implementation_type;
 
 
-[endsect]
 
 
 [endsect]
 
 
-[section:io_service ssl::stream::io_service]
-
-(Deprecated: use get_io_service().) Get the io_service associated with the object. 
-
-  boost::asio::io_service & io_service();
-
 
-This function may be used to obtain the io_service object that the stream uses to dispatch handlers for asynchronous operations.
+[section:io_control stream_socket_service::io_control]
 
+Perform an IO control command on the socket. 
 
-[heading Return Value]
-      
-A reference to the io_service object that stream will use to dispatch handlers. Ownership is not transferred to the caller. 
+  template<
+      typename ``[link boost_asio.reference.IoControlCommand IoControlCommand]``>
+  boost::system::error_code io_control(
+      implementation_type & impl,
+      IoControlCommand & command,
+      boost::system::error_code & ec);
 
 
 
@@ -36681,19 +44672,14 @@
 
 
 
-[section:lowest_layer ssl::stream::lowest_layer]
-
-Get a reference to the lowest layer. 
-
-  lowest_layer_type & lowest_layer();
+[section:io_service stream_socket_service::io_service]
 
 
-This function returns a reference to the lowest layer in a stack of stream layers.
+['Inherited from io_service.]
 
+(Deprecated: use get_io_service().) Get the io_service object that owns the service. 
 
-[heading Return Value]
-      
-A reference to the lowest layer in the stack of stream layers. Ownership is not transferred to the caller. 
+  boost::asio::io_service & io_service();
 
 
 
@@ -36701,12 +44687,12 @@
 
 
 
-[section:lowest_layer_type ssl::stream::lowest_layer_type]
-
-The type of the lowest layer. 
+[section:is_open stream_socket_service::is_open]
 
-  typedef next_layer_type::lowest_layer_type lowest_layer_type;
+Determine whether the socket is open. 
 
+  bool is_open(
+      const implementation_type & impl) const;
 
 
 
@@ -36714,19 +44700,13 @@
 
 
 
-[section:next_layer ssl::stream::next_layer]
-
-Get a reference to the next layer. 
-
-  next_layer_type & next_layer();
-
-
-This function returns a reference to the next layer in a stack of stream layers.
+[section:local_endpoint stream_socket_service::local_endpoint]
 
+Get the local endpoint. 
 
-[heading Return Value]
-      
-A reference to the next layer in the stack of stream layers. Ownership is not transferred to the caller. 
+  endpoint_type local_endpoint(
+      const implementation_type & impl,
+      boost::system::error_code & ec) const;
 
 
 
@@ -36734,68 +44714,25 @@
 
 
 
-[section:next_layer_type ssl::stream::next_layer_type]
-
-The type of the next layer. 
+[section:native stream_socket_service::native]
 
-  typedef boost::remove_reference< Stream >::type next_layer_type;
+Get the native socket implementation. 
 
+  native_type native(
+      implementation_type & impl);
 
 
 
 [endsect]
 
 
-[section:peek ssl::stream::peek]
-
-Peek at the incoming data on the stream. 
-
-  template<
-      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``>
-  std::size_t ``[link boost_asio.reference.ssl__stream.peek.overload1 peek]``(
-      const MutableBufferSequence & buffers);
-
-  template<
-      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``>
-  std::size_t ``[link boost_asio.reference.ssl__stream.peek.overload2 peek]``(
-      const MutableBufferSequence & buffers,
-      boost::system::error_code & ec);
-
-
-[section:overload1 ssl::stream::peek (1 of 2 overloads)]
-
-Peek at the incoming data on the stream. 
-
-  template<
-      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``>
-  std::size_t peek(
-      const MutableBufferSequence & buffers);
-
-
-This function is used to peek at the incoming data on the stream, without removing it from the input queue. The function call will block until data has been read successfully or an error occurs.
-
-
-[heading Parameters]
-    
-
-[variablelist
-  
-[[buffers][The buffers into which the data will be read.]]
-
-]
 
-[heading Return Value]
-      
-The number of bytes read.
+[section:native_type stream_socket_service::native_type]
 
-[heading Exceptions]
-    
+The native socket type. 
 
-[variablelist
-  
-[[boost::system::system_error][Thrown on failure. ]]
+  typedef implementation_defined native_type;
 
-]
 
 
 
@@ -36803,97 +44740,77 @@
 
 
 
-[section:overload2 ssl::stream::peek (2 of 2 overloads)]
+[section:open stream_socket_service::open]
 
-Peek at the incoming data on the stream. 
+Open a stream socket. 
 
-  template<
-      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``>
-  std::size_t peek(
-      const MutableBufferSequence & buffers,
+  boost::system::error_code open(
+      implementation_type & impl,
+      const protocol_type & protocol,
       boost::system::error_code & ec);
 
 
-This function is used to peek at the incoming data on the stream, withoutxi removing it from the input queue. The function call will block until data has been read successfully or an error occurs.
-
 
-[heading Parameters]
-    
+[endsect]
 
-[variablelist
-  
-[[buffers][The buffers into which the data will be read.]]
 
-[[ec][Set to indicate what error occurred, if any.]]
 
-]
+[section:protocol_type stream_socket_service::protocol_type]
 
-[heading Return Value]
-      
-The number of bytes read. Returns 0 if an error occurred. 
+The protocol type. 
 
+  typedef Protocol protocol_type;
 
 
-[endsect]
 
 
 [endsect]
 
-[section:read_some ssl::stream::read_some]
 
-Read some data from the stream. 
 
-  template<
-      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``>
-  std::size_t ``[link boost_asio.reference.ssl__stream.read_some.overload1 read_some]``(
-      const MutableBufferSequence & buffers);
+[section:receive stream_socket_service::receive]
+
+Receive some data from the peer. 
 
   template<
       typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``>
-  std::size_t ``[link boost_asio.reference.ssl__stream.read_some.overload2 read_some]``(
+  std::size_t receive(
+      implementation_type & impl,
       const MutableBufferSequence & buffers,
+      socket_base::message_flags flags,
       boost::system::error_code & ec);
 
 
-[section:overload1 ssl::stream::read_some (1 of 2 overloads)]
 
-Read some data from the stream. 
+[endsect]
 
-  template<
-      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``>
-  std::size_t read_some(
-      const MutableBufferSequence & buffers);
 
 
-This function is used to read data from the stream. The function call will block until one or more bytes of data has been read successfully, or until an error occurs.
+[section:remote_endpoint stream_socket_service::remote_endpoint]
 
+Get the remote endpoint. 
 
-[heading Parameters]
-    
+  endpoint_type remote_endpoint(
+      const implementation_type & impl,
+      boost::system::error_code & ec) const;
 
-[variablelist
-  
-[[buffers][The buffers into which the data will be read.]]
 
-]
 
-[heading Return Value]
-      
-The number of bytes read.
+[endsect]
 
-[heading Exceptions]
-    
 
-[variablelist
-  
-[[boost::system::system_error][Thrown on failure.]]
 
-]
+[section:send stream_socket_service::send]
 
-[heading Remarks]
-      
-The read\_some operation may not read all of the requested number of bytes. Consider using the 
-[link boost_asio.reference.read read]  function if you need to ensure that the requested amount of data is read before the blocking operation completes. 
+Send the given data to the peer. 
+
+  template<
+      typename ``[link boost_asio.reference.ConstBufferSequence ConstBufferSequence]``>
+  std::size_t send(
+      implementation_type & impl,
+      const ConstBufferSequence & buffers,
+      socket_base::message_flags flags,
+      boost::system::error_code & ec);
 
 
 
@@ -36901,87 +44818,153 @@
 
 
 
-[section:overload2 ssl::stream::read_some (2 of 2 overloads)]
+[section:set_option stream_socket_service::set_option]
 
-Read some data from the stream. 
+Set a socket option. 
 
   template<
-      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``>
-  std::size_t read_some(
-      const MutableBufferSequence & buffers,
+      typename ``[link boost_asio.reference.SettableSocketOption SettableSocketOption]``>
+  boost::system::error_code set_option(
+      implementation_type & impl,
+      const SettableSocketOption & option,
       boost::system::error_code & ec);
 
 
-This function is used to read data from the stream. The function call will block until one or more bytes of data has been read successfully, or until an error occurs.
-
 
-[heading Parameters]
-    
+[endsect]
 
-[variablelist
-  
-[[buffers][The buffers into which the data will be read.]]
 
-[[ec][Set to indicate what error occurred, if any.]]
 
-]
+[section:shutdown stream_socket_service::shutdown]
 
-[heading Return Value]
-      
-The number of bytes read. Returns 0 if an error occurred.
+Disable sends or receives on the socket. 
 
-[heading Remarks]
-      
-The read\_some operation may not read all of the requested number of bytes. Consider using the 
-[link boost_asio.reference.read read]  function if you need to ensure that the requested amount of data is read before the blocking operation completes. 
+  boost::system::error_code shutdown(
+      implementation_type & impl,
+      socket_base::shutdown_type what,
+      boost::system::error_code & ec);
 
 
 
 [endsect]
 
 
+
+[section:shutdown_service stream_socket_service::shutdown_service]
+
+Destroy all user-defined handler objects owned by the service. 
+
+  void shutdown_service();
+
+
+
 [endsect]
 
 
-[section:service_type ssl::stream::service_type]
 
-The type of the service that will be used to provide stream operations. 
+[section:stream_socket_service stream_socket_service::stream_socket_service]
 
-  typedef Service service_type;
+Construct a new stream socket service for the specified io_service. 
 
+  stream_socket_service(
+      boost::asio::io_service & io_service);
 
 
 
 [endsect]
 
 
-[section:shutdown ssl::stream::shutdown]
 
-Shut down SSL on the stream. 
+[endsect]
 
-  void ``[link boost_asio.reference.ssl__stream.shutdown.overload1 shutdown]``();
 
-  boost::system::error_code ``[link boost_asio.reference.ssl__stream.shutdown.overload2 shutdown]``(
-      boost::system::error_code & ec);
+[section:streambuf streambuf]
 
+Typedef for the typical usage of basic_streambuf. 
 
-[section:overload1 ssl::stream::shutdown (1 of 2 overloads)]
+  typedef basic_streambuf streambuf;
 
-Shut down SSL on the stream. 
 
-  void shutdown();
+[heading Types]
+[table
+  [[Name][Description]]
 
+  [
 
-This function is used to shut down SSL on the stream. The function call will block until SSL has been shut down or an error occurs.
+    [[link boost_asio.reference.basic_streambuf.const_buffers_type [*const_buffers_type]]]
+    [The type used to represent the get area as a list of buffers. ]
+  
+  ]
 
+  [
 
-[heading Exceptions]
-    
+    [[link boost_asio.reference.basic_streambuf.mutable_buffers_type [*mutable_buffers_type]]]
+    [The type used to represent the put area as a list of buffers. ]
+  
+  ]
 
-[variablelist
+]
+
+[heading Member Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.basic_streambuf.basic_streambuf [*basic_streambuf]]]
+    [Construct a buffer with a specified maximum size. ]
+  ]
   
-[[boost::system::system_error][Thrown on failure. ]]
+  [
+    [[link boost_asio.reference.basic_streambuf.commit [*commit]]]
+    [Move the start of the put area by the specified number of characters. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_streambuf.consume [*consume]]]
+    [Move the start of the get area by the specified number of characters. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_streambuf.data [*data]]]
+    [Get a list of buffers that represents the get area. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_streambuf.max_size [*max_size]]]
+    [Return the maximum size of the buffer. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_streambuf.prepare [*prepare]]]
+    [Get a list of buffers that represents the put area, with the given size. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_streambuf.size [*size]]]
+    [Return the size of the get area in characters. ]
+  ]
+  
+]
+
+[heading Protected Member Functions]
+[table
+  [[Name][Description]]
 
+  [
+    [[link boost_asio.reference.basic_streambuf.overflow [*overflow]]]
+    []
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_streambuf.reserve [*reserve]]]
+    []
+  ]
+  
+  [
+    [[link boost_asio.reference.basic_streambuf.underflow [*underflow]]]
+    []
+  ]
+  
 ]
 
 
@@ -36989,121 +44972,126 @@
 [endsect]
 
 
+[section:time_traits_lt__ptime__gt_ time_traits< boost::posix_time::ptime >]
 
-[section:overload2 ssl::stream::shutdown (2 of 2 overloads)]
+Time traits specialised for posix_time. 
 
-Shut down SSL on the stream. 
+  template<>
+  struct time_traits< boost::posix_time::ptime >
 
-  boost::system::error_code shutdown(
-      boost::system::error_code & ec);
 
+[heading Types]
+[table
+  [[Name][Description]]
 
-This function is used to shut down SSL on the stream. The function call will block until SSL has been shut down or an error occurs.
+  [
 
+    [[link boost_asio.reference.time_traits_lt__ptime__gt_.duration_type [*duration_type]]]
+    [The duration type. ]
+  
+  ]
 
-[heading Parameters]
-    
+  [
 
-[variablelist
+    [[link boost_asio.reference.time_traits_lt__ptime__gt_.time_type [*time_type]]]
+    [The time type. ]
   
-[[ec][Set to indicate what error occurred, if any. ]]
+  ]
 
 ]
 
+[heading Member Functions]
+[table
+  [[Name][Description]]
 
-
-[endsect]
+  [
+    [[link boost_asio.reference.time_traits_lt__ptime__gt_.add [*add]]]
+    [Add a duration to a time. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.time_traits_lt__ptime__gt_.less_than [*less_than]]]
+    [Test whether one time is less than another. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.time_traits_lt__ptime__gt_.now [*now]]]
+    [Get the current time. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.time_traits_lt__ptime__gt_.subtract [*subtract]]]
+    [Subtract one time from another. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.time_traits_lt__ptime__gt_.to_posix_duration [*to_posix_duration]]]
+    [Convert to POSIX duration type. ]
+  ]
+  
+]
 
 
-[endsect]
+[section:add time_traits< boost::posix_time::ptime >::add]
 
+Add a duration to a time. 
 
-[section:stream ssl::stream::stream]
+  static time_type add(
+      const time_type & t,
+      const duration_type & d);
 
-Construct a stream. 
 
-  template<
-      typename Arg,
-      typename Context_Service>
-  stream(
-      Arg & arg,
-      basic_context< Context_Service > & context);
 
+[endsect]
 
-This constructor creates a stream and initialises the underlying stream object.
 
 
-[heading Parameters]
-    
+[section:duration_type time_traits< boost::posix_time::ptime >::duration_type]
 
-[variablelist
-  
-[[arg][The argument to be passed to initialise the underlying stream.]]
+The duration type. 
 
-[[context][The SSL context to be used for the stream. ]]
+  typedef boost::posix_time::time_duration duration_type;
 
-]
 
 
 
 [endsect]
 
 
-[section:write_some ssl::stream::write_some]
 
-Write some data to the stream. 
+[section:less_than time_traits< boost::posix_time::ptime >::less_than]
 
-  template<
-      typename ``[link boost_asio.reference.ConstBufferSequence ConstBufferSequence]``>
-  std::size_t ``[link boost_asio.reference.ssl__stream.write_some.overload1 write_some]``(
-      const ConstBufferSequence & buffers);
+Test whether one time is less than another. 
 
-  template<
-      typename ``[link boost_asio.reference.ConstBufferSequence ConstBufferSequence]``>
-  std::size_t ``[link boost_asio.reference.ssl__stream.write_some.overload2 write_some]``(
-      const ConstBufferSequence & buffers,
-      boost::system::error_code & ec);
+  static bool less_than(
+      const time_type & t1,
+      const time_type & t2);
 
 
-[section:overload1 ssl::stream::write_some (1 of 2 overloads)]
 
-Write some data to the stream. 
+[endsect]
 
-  template<
-      typename ``[link boost_asio.reference.ConstBufferSequence ConstBufferSequence]``>
-  std::size_t write_some(
-      const ConstBufferSequence & buffers);
 
 
-This function is used to write data on the stream. The function call will block until one or more bytes of data has been written successfully, or until an error occurs.
+[section:now time_traits< boost::posix_time::ptime >::now]
 
+Get the current time. 
 
-[heading Parameters]
-    
+  static time_type now();
 
-[variablelist
-  
-[[buffers][The data to be written.]]
 
-]
 
-[heading Return Value]
-      
-The number of bytes written.
+[endsect]
 
-[heading Exceptions]
-    
 
-[variablelist
-  
-[[boost::system::system_error][Thrown on failure.]]
 
-]
+[section:subtract time_traits< boost::posix_time::ptime >::subtract]
 
-[heading Remarks]
-      
-The write\_some operation may not transmit all of the data to the peer. Consider using the 
-[link boost_asio.reference.write write]  function if you need to ensure that all data is written before the blocking operation completes. 
+Subtract one time from another. 
+
+  static duration_type subtract(
+      const time_type & t1,
+      const time_type & t2);
 
 
 
@@ -37111,103 +45099,103 @@
 
 
 
-[section:overload2 ssl::stream::write_some (2 of 2 overloads)]
+[section:time_type time_traits< boost::posix_time::ptime >::time_type]
 
-Write some data to the stream. 
+The time type. 
 
-  template<
-      typename ``[link boost_asio.reference.ConstBufferSequence ConstBufferSequence]``>
-  std::size_t write_some(
-      const ConstBufferSequence & buffers,
-      boost::system::error_code & ec);
+  typedef boost::posix_time::ptime time_type;
 
 
-This function is used to write data on the stream. The function call will block until one or more bytes of data has been written successfully, or until an error occurs.
 
 
-[heading Parameters]
-    
+[endsect]
 
-[variablelist
-  
-[[buffers][The data to be written to the stream.]]
 
-[[ec][Set to indicate what error occurred, if any.]]
 
-]
+[section:to_posix_duration time_traits< boost::posix_time::ptime >::to_posix_duration]
 
-[heading Return Value]
-      
-The number of bytes written. Returns 0 if an error occurred.
+Convert to POSIX duration type. 
 
-[heading Remarks]
-      
-The write\_some operation may not transmit all of the data to the peer. Consider using the 
-[link boost_asio.reference.write write]  function if you need to ensure that all data is written before the blocking operation completes. 
+  static boost::posix_time::time_duration to_posix_duration(
+      const duration_type & d);
 
 
 
 [endsect]
 
 
+
 [endsect]
 
 
-[section:_stream ssl::stream::~stream]
+[section:transfer_all transfer_all]
 
-Destructor. 
+Return a completion condition function object that indicates that a read or write operation should continue until all of the data has been transferred, or until an error occurs. 
 
-  ~stream();
+  unspecified transfer_all();
 
 
+This function is used to create an object, of unspecified type, that meets CompletionCondition requirements.
 
-[endsect]
+
+[heading Example]
+  
+Reading until a buffer is full: 
+
+   boost::array<char, 128> buf;
+   boost::system::error_code ec;
+   std::size_t n = boost::asio::read(
+       sock, boost::asio::buffer(buf),
+       boost::asio::transfer_all(), ec);
+   if (ec)
+   {
+     // An error occurred.
+   }
+   else
+   {
+     // n == 128
+   }
 
 
 
-[endsect]
 
-[section:ssl__stream_base ssl::stream_base]
 
-The stream_base class is used as a base for the boost::asio::ssl::stream class template so that we have a common place to define various enums. 
 
-  class stream_base
+[endsect]
 
 
-[heading Types]
-[table
-  [[Name][Description]]
 
-  [
+[section:transfer_at_least transfer_at_least]
 
-    [[link boost_asio.reference.ssl__stream_base.handshake_type [*handshake_type]]]
-    [Different handshake types. ]
-  
-  ]
+Return a completion condition function object that indicates that a read or write operation should continue until a minimum number of bytes has been transferred, or until an error occurs. 
 
-]
+  unspecified transfer_at_least(
+      std::size_t minimum);
 
 
-[section:handshake_type ssl::stream_base::handshake_type]
+This function is used to create an object, of unspecified type, that meets CompletionCondition requirements.
 
-Different handshake types. 
 
-  enum handshake_type
+[heading Example]
+  
+Reading until a buffer is full or contains at least 64 bytes: 
 
-[heading Values]
-[variablelist
+   boost::array<char, 128> buf;
+   boost::system::error_code ec;
+   std::size_t n = boost::asio::read(
+       sock, boost::asio::buffer(buf),
+       boost::asio::transfer_at_least(64), ec);
+   if (ec)
+   {
+     // An error occurred.
+   }
+   else
+   {
+     // n >= 64 && n <= 128
+   }
 
-  [
-    [client]
-    [Perform handshaking as a client. ]
-  ]
 
-  [
-    [server]
-    [Perform handshaking as a server. ]
-  ]
 
-]
 
 
 
@@ -37215,164 +45203,187 @@
 
 
 
-[endsect]
+[section:use_service use_service]
 
-[section:ssl__stream_service ssl::stream_service]
 
-Default service implementation for an SSL stream. 
 
-  class stream_service :
-    public io_service::service
+  template<
+      typename ``[link boost_asio.reference.Service Service]``>
+  Service & use_service(
+      io_service & ios);
 
 
-[heading Types]
-[table
-  [[Name][Description]]
+This function is used to locate a service object that corresponds to the given service type. If there is no existing implementation of the service, then the io_service will create a new instance of the service.
 
-  [
 
-    [[link boost_asio.reference.ssl__stream_service.impl_type [*impl_type]]]
-    [The type of a stream implementation. ]
+[heading Parameters]
+    
+
+[variablelist
   
-  ]
+[[ios][The io\_service object that owns the service.]]
 
 ]
 
-[heading Member Functions]
+[heading Return Value]
+      
+The service interface implementing the specified service type. Ownership of the service interface is not transferred to the caller. 
+
+
+
+[endsect]
+
+
+[section:windows__basic_handle windows::basic_handle]
+
+Provides Windows handle functionality. 
+
+  template<
+      typename ``[link boost_asio.reference.HandleService HandleService]``>
+  class basic_handle :
+    public basic_io_object< HandleService >
+
+
+[heading Types]
 [table
   [[Name][Description]]
 
   [
-    [[link boost_asio.reference.ssl__stream_service.async_handshake [*async_handshake]]]
-    [Start an asynchronous SSL handshake. ]
-  ]
-  
-  [
-    [[link boost_asio.reference.ssl__stream_service.async_read_some [*async_read_some]]]
-    [Start an asynchronous read. ]
-  ]
-  
-  [
-    [[link boost_asio.reference.ssl__stream_service.async_shutdown [*async_shutdown]]]
-    [Asynchronously shut down SSL on the stream. ]
-  ]
-  
-  [
-    [[link boost_asio.reference.ssl__stream_service.async_write_some [*async_write_some]]]
-    [Start an asynchronous write. ]
-  ]
+
+    [[link boost_asio.reference.windows__basic_handle.implementation_type [*implementation_type]]]
+    [The underlying implementation type of I/O object. ]
   
-  [
-    [[link boost_asio.reference.ssl__stream_service.create [*create]]]
-    [Create a new stream implementation. ]
   ]
-  
+
   [
-    [[link boost_asio.reference.ssl__stream_service.destroy [*destroy]]]
-    [Destroy a stream implementation. ]
-  ]
+
+    [[link boost_asio.reference.windows__basic_handle.lowest_layer_type [*lowest_layer_type]]]
+    [A basic_handle is always the lowest layer. ]
   
+  ]
+
   [
-    [[link boost_asio.reference.ssl__stream_service.get_io_service [*get_io_service]]]
-    [Get the io_service object that owns the service. ]
+
+    [[link boost_asio.reference.windows__basic_handle.native_type [*native_type]]]
+    [The native representation of a handle. ]
+  
   ]
+
+  [
+
+    [[link boost_asio.reference.windows__basic_handle.service_type [*service_type]]]
+    [The type of the service that will be used to provide I/O operations. ]
   
+  ]
+
+]
+
+[heading Member Functions]
+[table
+  [[Name][Description]]
+
   [
-    [[link boost_asio.reference.ssl__stream_service.handshake [*handshake]]]
-    [Perform SSL handshaking. ]
+    [[link boost_asio.reference.windows__basic_handle.assign [*assign]]]
+    [Assign an existing native handle to the handle. ]
   ]
   
   [
-    [[link boost_asio.reference.ssl__stream_service.in_avail [*in_avail]]]
-    [Determine the amount of data that may be read without blocking. ]
+    [[link boost_asio.reference.windows__basic_handle.basic_handle [*basic_handle]]]
+    [Construct a basic_handle without opening it. ]
   ]
   
   [
-    [[link boost_asio.reference.ssl__stream_service.io_service [*io_service]]]
-    [(Deprecated: use get_io_service().) Get the io_service object that owns the service. ]
+    [[link boost_asio.reference.windows__basic_handle.cancel [*cancel]]]
+    [Cancel all asynchronous operations associated with the handle. ]
   ]
   
   [
-    [[link boost_asio.reference.ssl__stream_service.null [*null]]]
-    [Return a null stream implementation. ]
+    [[link boost_asio.reference.windows__basic_handle.close [*close]]]
+    [Close the handle. ]
   ]
   
   [
-    [[link boost_asio.reference.ssl__stream_service.peek [*peek]]]
-    [Peek at the incoming data on the stream. ]
+    [[link boost_asio.reference.windows__basic_handle.get_io_service [*get_io_service]]]
+    [Get the io_service associated with the object. ]
   ]
   
   [
-    [[link boost_asio.reference.ssl__stream_service.read_some [*read_some]]]
-    [Read some data from the stream. ]
+    [[link boost_asio.reference.windows__basic_handle.io_service [*io_service]]]
+    [(Deprecated: use get_io_service().) Get the io_service associated with the object. ]
   ]
   
   [
-    [[link boost_asio.reference.ssl__stream_service.shutdown [*shutdown]]]
-    [Shut down SSL on the stream. ]
+    [[link boost_asio.reference.windows__basic_handle.is_open [*is_open]]]
+    [Determine whether the handle is open. ]
   ]
   
   [
-    [[link boost_asio.reference.ssl__stream_service.shutdown_service [*shutdown_service]]]
-    [Destroy all user-defined handler objects owned by the service. ]
+    [[link boost_asio.reference.windows__basic_handle.lowest_layer [*lowest_layer]]]
+    [Get a reference to the lowest layer. ]
   ]
   
   [
-    [[link boost_asio.reference.ssl__stream_service.stream_service [*stream_service]]]
-    [Construct a new stream service for the specified io_service. ]
+    [[link boost_asio.reference.windows__basic_handle.native [*native]]]
+    [Get the native handle representation. ]
   ]
   
+]
+
+[heading Protected Member Functions]
+[table
+  [[Name][Description]]
+
   [
-    [[link boost_asio.reference.ssl__stream_service.write_some [*write_some]]]
-    [Write some data to the stream. ]
+    [[link boost_asio.reference.windows__basic_handle._basic_handle [*~basic_handle]]]
+    [Protected destructor to prevent deletion through this type. ]
   ]
   
 ]
 
-[heading Data Members]
+[heading Protected Data Members]
 [table
   [[Name][Description]]
 
   [
-    [[link boost_asio.reference.ssl__stream_service.id [*id]]]
-    [The unique service identifier. ]
+    [[link boost_asio.reference.windows__basic_handle.implementation [*implementation]]]
+    [The underlying implementation of the I/O object. ]
+  ]
+
+  [
+    [[link boost_asio.reference.windows__basic_handle.service [*service]]]
+    [The service associated with the I/O object. ]
   ]
 
 ]
 
+The windows::basic_handle class template provides the ability to wrap a Windows handle.
 
-[section:async_handshake ssl::stream_service::async_handshake]
 
-Start an asynchronous SSL handshake. 
+[heading Thread Safety]
+  
+[*Distinct] [*objects:]  Safe.
 
-  template<
-      typename Stream,
-      typename HandshakeHandler>
-  void async_handshake(
-      impl_type & impl,
-      Stream & next_layer,
-      stream_base::handshake_type type,
-      HandshakeHandler handler);
+[*Shared] [*objects:]  Unsafe. 
 
 
+[section:assign windows::basic_handle::assign]
 
-[endsect]
+Assign an existing native handle to the handle. 
 
+  void ``[link boost_asio.reference.windows__basic_handle.assign.overload1 assign]``(
+      const native_type & native_handle);
 
+  boost::system::error_code ``[link boost_asio.reference.windows__basic_handle.assign.overload2 assign]``(
+      const native_type & native_handle,
+      boost::system::error_code & ec);
 
-[section:async_read_some ssl::stream_service::async_read_some]
 
-Start an asynchronous read. 
+[section:overload1 windows::basic_handle::assign (1 of 2 overloads)]
 
-  template<
-      typename Stream,
-      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``,
-      typename ``[link boost_asio.reference.ReadHandler ReadHandler]``>
-  void async_read_some(
-      impl_type & impl,
-      Stream & next_layer,
-      const MutableBufferSequence & buffers,
-      ReadHandler handler);
+Assign an existing native handle to the handle. 
+
+  void assign(
+      const native_type & native_handle);
 
 
 
@@ -37380,55 +45391,52 @@
 
 
 
-[section:async_shutdown ssl::stream_service::async_shutdown]
+[section:overload2 windows::basic_handle::assign (2 of 2 overloads)]
 
-Asynchronously shut down SSL on the stream. 
+Assign an existing native handle to the handle. 
 
-  template<
-      typename Stream,
-      typename ShutdownHandler>
-  void async_shutdown(
-      impl_type & impl,
-      Stream & next_layer,
-      ShutdownHandler handler);
+  boost::system::error_code assign(
+      const native_type & native_handle,
+      boost::system::error_code & ec);
 
 
 
 [endsect]
 
 
+[endsect]
 
-[section:async_write_some ssl::stream_service::async_write_some]
+[section:basic_handle windows::basic_handle::basic_handle]
 
-Start an asynchronous write. 
+Construct a basic_handle without opening it. 
 
-  template<
-      typename Stream,
-      typename ``[link boost_asio.reference.ConstBufferSequence ConstBufferSequence]``,
-      typename ``[link boost_asio.reference.WriteHandler WriteHandler]``>
-  void async_write_some(
-      impl_type & impl,
-      Stream & next_layer,
-      const ConstBufferSequence & buffers,
-      WriteHandler handler);
+  ``[link boost_asio.reference.windows__basic_handle.basic_handle.overload1 basic_handle]``(
+      boost::asio::io_service & io_service);
 
+  ``[link boost_asio.reference.windows__basic_handle.basic_handle.overload2 basic_handle]``(
+      boost::asio::io_service & io_service,
+      const native_type & native_handle);
 
 
-[endsect]
+[section:overload1 windows::basic_handle::basic_handle (1 of 2 overloads)]
 
+Construct a basic_handle without opening it. 
 
+  basic_handle(
+      boost::asio::io_service & io_service);
 
-[section:create ssl::stream_service::create]
 
-Create a new stream implementation. 
+This constructor creates a handle without opening it.
 
-  template<
-      typename Stream,
-      typename Context_Service>
-  void create(
-      impl_type & impl,
-      Stream & next_layer,
-      basic_context< Context_Service > & context);
+
+[heading Parameters]
+    
+
+[variablelist
+  
+[[io_service][The io\_service object that the handle will use to dispatch handlers for any asynchronous operations performed on the handle. ]]
+
+]
 
 
 
@@ -37436,60 +45444,73 @@
 
 
 
-[section:destroy ssl::stream_service::destroy]
+[section:overload2 windows::basic_handle::basic_handle (2 of 2 overloads)]
 
-Destroy a stream implementation. 
+Construct a basic_handle on an existing native handle. 
 
-  template<
-      typename Stream>
-  void destroy(
-      impl_type & impl,
-      Stream & next_layer);
+  basic_handle(
+      boost::asio::io_service & io_service,
+      const native_type & native_handle);
 
 
+This constructor creates a handle object to hold an existing native handle.
 
-[endsect]
 
+[heading Parameters]
+    
 
+[variablelist
+  
+[[io_service][The io\_service object that the handle will use to dispatch handlers for any asynchronous operations performed on the handle.]]
 
-[section:get_io_service ssl::stream_service::get_io_service]
+[[native_handle][A native handle.]]
 
+]
 
-['Inherited from io_service.]
+[heading Exceptions]
+    
 
-Get the io_service object that owns the service. 
+[variablelist
+  
+[[boost::system::system_error][Thrown on failure. ]]
 
-  boost::asio::io_service & get_io_service();
+]
 
 
 
 [endsect]
 
 
+[endsect]
 
-[section:handshake ssl::stream_service::handshake]
+[section:cancel windows::basic_handle::cancel]
 
-Perform SSL handshaking. 
+Cancel all asynchronous operations associated with the handle. 
 
-  template<
-      typename Stream>
-  boost::system::error_code handshake(
-      impl_type & impl,
-      Stream & next_layer,
-      stream_base::handshake_type type,
+  void ``[link boost_asio.reference.windows__basic_handle.cancel.overload1 cancel]``();
+
+  boost::system::error_code ``[link boost_asio.reference.windows__basic_handle.cancel.overload2 cancel]``(
       boost::system::error_code & ec);
 
 
+[section:overload1 windows::basic_handle::cancel (1 of 2 overloads)]
 
-[endsect]
+Cancel all asynchronous operations associated with the handle. 
 
+  void cancel();
 
 
-[section:id ssl::stream_service::id]
+This function causes all outstanding asynchronous read or write operations to finish immediately, and the handlers for cancelled operations will be passed the boost::asio::error::operation\_aborted error.
 
-The unique service identifier. 
 
-  static boost::asio::io_service::id id;
+[heading Exceptions]
+    
+
+[variablelist
+  
+[[boost::system::system_error][Thrown on failure. ]]
+
+]
 
 
 
@@ -37497,44 +45518,61 @@
 
 
 
-[section:impl_type ssl::stream_service::impl_type]
+[section:overload2 windows::basic_handle::cancel (2 of 2 overloads)]
 
-The type of a stream implementation. 
+Cancel all asynchronous operations associated with the handle. 
 
-  typedef implementation_defined impl_type;
+  boost::system::error_code cancel(
+      boost::system::error_code & ec);
+
+
+This function causes all outstanding asynchronous read or write operations to finish immediately, and the handlers for cancelled operations will be passed the boost::asio::error::operation\_aborted error.
+
+
+[heading Parameters]
+    
 
+[variablelist
+  
+[[ec][Set to indicate what error occurred, if any. ]]
+
+]
 
 
 
 [endsect]
 
 
+[endsect]
 
-[section:in_avail ssl::stream_service::in_avail]
+[section:close windows::basic_handle::close]
 
-Determine the amount of data that may be read without blocking. 
+Close the handle. 
 
-  template<
-      typename Stream>
-  std::size_t in_avail(
-      impl_type & impl,
-      Stream & next_layer,
+  void ``[link boost_asio.reference.windows__basic_handle.close.overload1 close]``();
+
+  boost::system::error_code ``[link boost_asio.reference.windows__basic_handle.close.overload2 close]``(
       boost::system::error_code & ec);
 
 
+[section:overload1 windows::basic_handle::close (1 of 2 overloads)]
 
-[endsect]
+Close the handle. 
 
+  void close();
 
 
-[section:io_service ssl::stream_service::io_service]
+This function is used to close the handle. Any asynchronous read or write operations will be cancelled immediately, and will complete with the boost::asio::error::operation\_aborted error.
 
 
-['Inherited from io_service.]
+[heading Exceptions]
+    
 
-(Deprecated: use get_io_service().) Get the io_service object that owns the service. 
+[variablelist
+  
+[[boost::system::system_error][Thrown on failure. ]]
 
-  boost::asio::io_service & io_service();
+]
 
 
 
@@ -37542,49 +45580,50 @@
 
 
 
-[section:null ssl::stream_service::null]
+[section:overload2 windows::basic_handle::close (2 of 2 overloads)]
 
-Return a null stream implementation. 
+Close the handle. 
 
-  impl_type null() const;
+  boost::system::error_code close(
+      boost::system::error_code & ec);
 
 
+This function is used to close the handle. Any asynchronous read or write operations will be cancelled immediately, and will complete with the boost::asio::error::operation\_aborted error.
 
-[endsect]
 
+[heading Parameters]
+    
 
+[variablelist
+  
+[[ec][Set to indicate what error occurred, if any. ]]
 
-[section:peek ssl::stream_service::peek]
+]
 
-Peek at the incoming data on the stream. 
 
-  template<
-      typename Stream,
-      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``>
-  std::size_t peek(
-      impl_type & impl,
-      Stream & next_layer,
-      const MutableBufferSequence & buffers,
-      boost::system::error_code & ec);
 
+[endsect]
 
 
 [endsect]
 
 
+[section:get_io_service windows::basic_handle::get_io_service]
 
-[section:read_some ssl::stream_service::read_some]
 
-Read some data from the stream. 
+['Inherited from basic_io_object.]
+
+Get the io_service associated with the object. 
+
+  boost::asio::io_service & get_io_service();
 
-  template<
-      typename Stream,
-      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``>
-  std::size_t read_some(
-      impl_type & impl,
-      Stream & next_layer,
-      const MutableBufferSequence & buffers,
-      boost::system::error_code & ec);
+
+This function may be used to obtain the io_service object that the I/O object uses to dispatch handlers for asynchronous operations.
+
+
+[heading Return Value]
+      
+A reference to the io_service object that the I/O object will use to dispatch handlers. Ownership is not transferred to the caller. 
 
 
 
@@ -37592,16 +45631,14 @@
 
 
 
-[section:shutdown ssl::stream_service::shutdown]
+[section:implementation windows::basic_handle::implementation]
 
-Shut down SSL on the stream. 
 
-  template<
-      typename Stream>
-  boost::system::error_code shutdown(
-      impl_type & impl,
-      Stream & next_layer,
-      boost::system::error_code & ec);
+['Inherited from basic_io_object.]
+
+The underlying implementation of the I/O object. 
+
+  implementation_type implementation;
 
 
 
@@ -37609,43 +45646,38 @@
 
 
 
-[section:shutdown_service ssl::stream_service::shutdown_service]
+[section:implementation_type windows::basic_handle::implementation_type]
 
-Destroy all user-defined handler objects owned by the service. 
 
-  void shutdown_service();
+['Inherited from basic_io_object.]
 
+The underlying implementation type of I/O object. 
 
+  typedef service_type::implementation_type implementation_type;
 
-[endsect]
 
 
 
-[section:stream_service ssl::stream_service::stream_service]
+[endsect]
 
-Construct a new stream service for the specified io_service. 
 
-  stream_service(
-      boost::asio::io_service & io_service);
 
+[section:io_service windows::basic_handle::io_service]
 
 
-[endsect]
+['Inherited from basic_io_object.]
 
+(Deprecated: use get_io_service().) Get the io_service associated with the object. 
 
+  boost::asio::io_service & io_service();
 
-[section:write_some ssl::stream_service::write_some]
 
-Write some data to the stream. 
+This function may be used to obtain the io_service object that the I/O object uses to dispatch handlers for asynchronous operations.
 
-  template<
-      typename Stream,
-      typename ``[link boost_asio.reference.ConstBufferSequence ConstBufferSequence]``>
-  std::size_t write_some(
-      impl_type & impl,
-      Stream & next_layer,
-      const ConstBufferSequence & buffers,
-      boost::system::error_code & ec);
+
+[heading Return Value]
+      
+A reference to the io_service object that the I/O object will use to dispatch handlers. Ownership is not transferred to the caller. 
 
 
 
@@ -37653,80 +45685,43 @@
 
 
 
-[endsect]
+[section:is_open windows::basic_handle::is_open]
 
+Determine whether the handle is open. 
 
-[section:strand strand]
+  bool is_open() const;
 
-Typedef for backwards compatibility. 
 
-  typedef boost::asio::io_service::strand strand;
 
+[endsect]
 
-[heading Member Functions]
-[table
-  [[Name][Description]]
 
-  [
-    [[link boost_asio.reference.io_service__strand.dispatch [*dispatch]]]
-    [Request the strand to invoke the given handler. ]
-  ]
-  
-  [
-    [[link boost_asio.reference.io_service__strand.get_io_service [*get_io_service]]]
-    [Get the io_service associated with the strand. ]
-  ]
-  
-  [
-    [[link boost_asio.reference.io_service__strand.io_service [*io_service]]]
-    [(Deprecated: use get_io_service().) Get the io_service associated with the strand. ]
-  ]
-  
-  [
-    [[link boost_asio.reference.io_service__strand.post [*post]]]
-    [Request the strand to invoke the given handler and return immediately. ]
-  ]
-  
-  [
-    [[link boost_asio.reference.io_service__strand.strand [*strand]]]
-    [Constructor. ]
-  ]
-  
-  [
-    [[link boost_asio.reference.io_service__strand.wrap [*wrap]]]
-    [Create a new handler that automatically dispatches the wrapped handler on the strand. ]
-  ]
-  
-  [
-    [[link boost_asio.reference.io_service__strand._strand [*~strand]]]
-    [Destructor. ]
-  ]
-  
-]
 
-The io_service::strand class provides the ability to post and dispatch handlers with the guarantee that none of those handlers will execute concurrently.
+[section:lowest_layer windows::basic_handle::lowest_layer]
+
+Get a reference to the lowest layer. 
 
+  lowest_layer_type & lowest_layer();
 
-[heading Thread Safety]
-  
-[*Distinct] [*objects:]  Safe.
 
-[*Shared] [*objects:]  Safe.
+This function returns a reference to the lowest layer in a stack of layers. Since a basic_handle cannot contain any further layers, it simply returns a reference to itself.
 
 
+[heading Return Value]
+      
+A reference to the lowest layer in the stack of layers. Ownership is not transferred to the caller. 
+
 
 
 [endsect]
 
 
-[section:stream_socket_service stream_socket_service]
 
-Default service implementation for a stream socket. 
+[section:lowest_layer_type windows::basic_handle::lowest_layer_type]
 
-  template<
-      typename ``[link boost_asio.reference.Protocol Protocol]``>
-  class stream_socket_service :
-    public io_service::service
+A basic_handle is always the lowest layer. 
+
+  typedef basic_handle< HandleService > lowest_layer_type;
 
 
 [heading Types]
@@ -37735,29 +45730,29 @@
 
   [
 
-    [[link boost_asio.reference.stream_socket_service.endpoint_type [*endpoint_type]]]
-    [The endpoint type. ]
+    [[link boost_asio.reference.windows__basic_handle.implementation_type [*implementation_type]]]
+    [The underlying implementation type of I/O object. ]
   
   ]
 
   [
 
-    [[link boost_asio.reference.stream_socket_service.implementation_type [*implementation_type]]]
-    [The type of a stream socket implementation. ]
+    [[link boost_asio.reference.windows__basic_handle.lowest_layer_type [*lowest_layer_type]]]
+    [A basic_handle is always the lowest layer. ]
   
   ]
 
   [
 
-    [[link boost_asio.reference.stream_socket_service.native_type [*native_type]]]
-    [The native socket type. ]
+    [[link boost_asio.reference.windows__basic_handle.native_type [*native_type]]]
+    [The native representation of a handle. ]
   
   ]
 
   [
 
-    [[link boost_asio.reference.stream_socket_service.protocol_type [*protocol_type]]]
-    [The protocol type. ]
+    [[link boost_asio.reference.windows__basic_handle.service_type [*service_type]]]
+    [The type of the service that will be used to provide I/O operations. ]
   
   ]
 
@@ -37768,232 +45763,497 @@
   [[Name][Description]]
 
   [
-    [[link boost_asio.reference.stream_socket_service.assign [*assign]]]
-    [Assign an existing native socket to a stream socket. ]
+    [[link boost_asio.reference.windows__basic_handle.assign [*assign]]]
+    [Assign an existing native handle to the handle. ]
   ]
   
   [
-    [[link boost_asio.reference.stream_socket_service.async_connect [*async_connect]]]
-    [Start an asynchronous connect. ]
+    [[link boost_asio.reference.windows__basic_handle.basic_handle [*basic_handle]]]
+    [Construct a basic_handle without opening it. ]
   ]
   
   [
-    [[link boost_asio.reference.stream_socket_service.async_receive [*async_receive]]]
-    [Start an asynchronous receive. ]
+    [[link boost_asio.reference.windows__basic_handle.cancel [*cancel]]]
+    [Cancel all asynchronous operations associated with the handle. ]
   ]
   
   [
-    [[link boost_asio.reference.stream_socket_service.async_send [*async_send]]]
-    [Start an asynchronous send. ]
+    [[link boost_asio.reference.windows__basic_handle.close [*close]]]
+    [Close the handle. ]
   ]
   
   [
-    [[link boost_asio.reference.stream_socket_service.at_mark [*at_mark]]]
-    [Determine whether the socket is at the out-of-band data mark. ]
+    [[link boost_asio.reference.windows__basic_handle.get_io_service [*get_io_service]]]
+    [Get the io_service associated with the object. ]
   ]
   
   [
-    [[link boost_asio.reference.stream_socket_service.available [*available]]]
-    [Determine the number of bytes available for reading. ]
+    [[link boost_asio.reference.windows__basic_handle.io_service [*io_service]]]
+    [(Deprecated: use get_io_service().) Get the io_service associated with the object. ]
   ]
   
   [
-    [[link boost_asio.reference.stream_socket_service.bind [*bind]]]
-    [Bind the stream socket to the specified local endpoint. ]
+    [[link boost_asio.reference.windows__basic_handle.is_open [*is_open]]]
+    [Determine whether the handle is open. ]
   ]
   
   [
-    [[link boost_asio.reference.stream_socket_service.cancel [*cancel]]]
-    [Cancel all asynchronous operations associated with the socket. ]
+    [[link boost_asio.reference.windows__basic_handle.lowest_layer [*lowest_layer]]]
+    [Get a reference to the lowest layer. ]
   ]
   
   [
-    [[link boost_asio.reference.stream_socket_service.close [*close]]]
-    [Close a stream socket implementation. ]
+    [[link boost_asio.reference.windows__basic_handle.native [*native]]]
+    [Get the native handle representation. ]
   ]
   
+]
+
+[heading Protected Member Functions]
+[table
+  [[Name][Description]]
+
   [
-    [[link boost_asio.reference.stream_socket_service.connect [*connect]]]
-    [Connect the stream socket to the specified endpoint. ]
+    [[link boost_asio.reference.windows__basic_handle._basic_handle [*~basic_handle]]]
+    [Protected destructor to prevent deletion through this type. ]
   ]
   
+]
+
+[heading Protected Data Members]
+[table
+  [[Name][Description]]
+
   [
-    [[link boost_asio.reference.stream_socket_service.construct [*construct]]]
-    [Construct a new stream socket implementation. ]
+    [[link boost_asio.reference.windows__basic_handle.implementation [*implementation]]]
+    [The underlying implementation of the I/O object. ]
   ]
-  
+
   [
-    [[link boost_asio.reference.stream_socket_service.destroy [*destroy]]]
-    [Destroy a stream socket implementation. ]
+    [[link boost_asio.reference.windows__basic_handle.service [*service]]]
+    [The service associated with the I/O object. ]
   ]
+
+]
+
+The windows::basic_handle class template provides the ability to wrap a Windows handle.
+
+
+[heading Thread Safety]
   
+[*Distinct] [*objects:]  Safe.
+
+[*Shared] [*objects:]  Unsafe. 
+
+
+
+
+[endsect]
+
+
+
+[section:native windows::basic_handle::native]
+
+Get the native handle representation. 
+
+  native_type native();
+
+
+This function may be used to obtain the underlying representation of the handle. This is intended to allow access to native handle functionality that is not otherwise provided. 
+
+
+[endsect]
+
+
+
+[section:native_type windows::basic_handle::native_type]
+
+The native representation of a handle. 
+
+  typedef HandleService::native_type native_type;
+
+
+
+
+[endsect]
+
+
+
+[section:service windows::basic_handle::service]
+
+
+['Inherited from basic_io_object.]
+
+The service associated with the I/O object. 
+
+  service_type & service;
+
+
+
+[endsect]
+
+
+
+[section:service_type windows::basic_handle::service_type]
+
+
+['Inherited from basic_io_object.]
+
+The type of the service that will be used to provide I/O operations. 
+
+  typedef HandleService service_type;
+
+
+
+
+[endsect]
+
+
+
+[section:_basic_handle windows::basic_handle::~basic_handle]
+
+Protected destructor to prevent deletion through this type. 
+
+  ~basic_handle();
+
+
+
+[endsect]
+
+
+
+[endsect]
+
+[section:windows__basic_stream_handle windows::basic_stream_handle]
+
+Provides stream-oriented handle functionality. 
+
+  template<
+      typename ``[link boost_asio.reference.StreamHandleService StreamHandleService]`` = stream_handle_service>
+  class basic_stream_handle :
+    public windows::basic_handle< StreamHandleService >
+
+
+[heading Types]
+[table
+  [[Name][Description]]
+
   [
-    [[link boost_asio.reference.stream_socket_service.get_io_service [*get_io_service]]]
-    [Get the io_service object that owns the service. ]
+
+    [[link boost_asio.reference.windows__basic_stream_handle.implementation_type [*implementation_type]]]
+    [The underlying implementation type of I/O object. ]
+  
   ]
+
+  [
+
+    [[link boost_asio.reference.windows__basic_stream_handle.lowest_layer_type [*lowest_layer_type]]]
+    [A basic_handle is always the lowest layer. ]
   
+  ]
+
   [
-    [[link boost_asio.reference.stream_socket_service.get_option [*get_option]]]
-    [Get a socket option. ]
+
+    [[link boost_asio.reference.windows__basic_stream_handle.native_type [*native_type]]]
+    [The native representation of a handle. ]
+  
   ]
+
+  [
+
+    [[link boost_asio.reference.windows__basic_stream_handle.service_type [*service_type]]]
+    [The type of the service that will be used to provide I/O operations. ]
   
+  ]
+
+]
+
+[heading Member Functions]
+[table
+  [[Name][Description]]
+
   [
-    [[link boost_asio.reference.stream_socket_service.io_control [*io_control]]]
-    [Perform an IO control command on the socket. ]
+    [[link boost_asio.reference.windows__basic_stream_handle.assign [*assign]]]
+    [Assign an existing native handle to the handle. ]
   ]
   
   [
-    [[link boost_asio.reference.stream_socket_service.io_service [*io_service]]]
-    [(Deprecated: use get_io_service().) Get the io_service object that owns the service. ]
+    [[link boost_asio.reference.windows__basic_stream_handle.async_read_some [*async_read_some]]]
+    [Start an asynchronous read. ]
   ]
   
   [
-    [[link boost_asio.reference.stream_socket_service.is_open [*is_open]]]
-    [Determine whether the socket is open. ]
+    [[link boost_asio.reference.windows__basic_stream_handle.async_write_some [*async_write_some]]]
+    [Start an asynchronous write. ]
   ]
   
   [
-    [[link boost_asio.reference.stream_socket_service.local_endpoint [*local_endpoint]]]
-    [Get the local endpoint. ]
+    [[link boost_asio.reference.windows__basic_stream_handle.basic_stream_handle [*basic_stream_handle]]]
+    [Construct a basic_stream_handle without opening it. ]
   ]
   
   [
-    [[link boost_asio.reference.stream_socket_service.native [*native]]]
-    [Get the native socket implementation. ]
+    [[link boost_asio.reference.windows__basic_stream_handle.cancel [*cancel]]]
+    [Cancel all asynchronous operations associated with the handle. ]
   ]
   
   [
-    [[link boost_asio.reference.stream_socket_service.open [*open]]]
-    [Open a stream socket. ]
+    [[link boost_asio.reference.windows__basic_stream_handle.close [*close]]]
+    [Close the handle. ]
   ]
   
   [
-    [[link boost_asio.reference.stream_socket_service.receive [*receive]]]
-    [Receive some data from the peer. ]
+    [[link boost_asio.reference.windows__basic_stream_handle.get_io_service [*get_io_service]]]
+    [Get the io_service associated with the object. ]
   ]
   
   [
-    [[link boost_asio.reference.stream_socket_service.remote_endpoint [*remote_endpoint]]]
-    [Get the remote endpoint. ]
+    [[link boost_asio.reference.windows__basic_stream_handle.io_service [*io_service]]]
+    [(Deprecated: use get_io_service().) Get the io_service associated with the object. ]
   ]
   
   [
-    [[link boost_asio.reference.stream_socket_service.send [*send]]]
-    [Send the given data to the peer. ]
+    [[link boost_asio.reference.windows__basic_stream_handle.is_open [*is_open]]]
+    [Determine whether the handle is open. ]
   ]
   
   [
-    [[link boost_asio.reference.stream_socket_service.set_option [*set_option]]]
-    [Set a socket option. ]
+    [[link boost_asio.reference.windows__basic_stream_handle.lowest_layer [*lowest_layer]]]
+    [Get a reference to the lowest layer. ]
   ]
   
   [
-    [[link boost_asio.reference.stream_socket_service.shutdown [*shutdown]]]
-    [Disable sends or receives on the socket. ]
+    [[link boost_asio.reference.windows__basic_stream_handle.native [*native]]]
+    [Get the native handle representation. ]
   ]
   
   [
-    [[link boost_asio.reference.stream_socket_service.shutdown_service [*shutdown_service]]]
-    [Destroy all user-defined handler objects owned by the service. ]
+    [[link boost_asio.reference.windows__basic_stream_handle.read_some [*read_some]]]
+    [Read some data from the handle. ]
   ]
   
   [
-    [[link boost_asio.reference.stream_socket_service.stream_socket_service [*stream_socket_service]]]
-    [Construct a new stream socket service for the specified io_service. ]
+    [[link boost_asio.reference.windows__basic_stream_handle.write_some [*write_some]]]
+    [Write some data to the handle. ]
   ]
   
 ]
 
-[heading Data Members]
+[heading Protected Data Members]
 [table
   [[Name][Description]]
 
   [
-    [[link boost_asio.reference.stream_socket_service.id [*id]]]
-    [The unique service identifier. ]
+    [[link boost_asio.reference.windows__basic_stream_handle.implementation [*implementation]]]
+    [The underlying implementation of the I/O object. ]
+  ]
+
+  [
+    [[link boost_asio.reference.windows__basic_stream_handle.service [*service]]]
+    [The service associated with the I/O object. ]
   ]
 
 ]
 
+The windows::basic_stream_handle class template provides asynchronous and blocking stream-oriented handle functionality.
 
-[section:assign stream_socket_service::assign]
 
-Assign an existing native socket to a stream socket. 
+[heading Thread Safety]
+  
+[*Distinct] [*objects:]  Safe.
 
-  boost::system::error_code assign(
-      implementation_type & impl,
-      const protocol_type & protocol,
-      const native_type & native_socket,
+[*Shared] [*objects:]  Unsafe.
+
+
+[section:assign windows::basic_stream_handle::assign]
+
+Assign an existing native handle to the handle. 
+
+  void ``[link boost_asio.reference.windows__basic_stream_handle.assign.overload1 assign]``(
+      const native_type & native_handle);
+
+  boost::system::error_code ``[link boost_asio.reference.windows__basic_stream_handle.assign.overload2 assign]``(
+      const native_type & native_handle,
       boost::system::error_code & ec);
 
 
+[section:overload1 windows::basic_stream_handle::assign (1 of 2 overloads)]
+
+
+['Inherited from windows::basic_handle.]
+
+Assign an existing native handle to the handle. 
+
+  void assign(
+      const native_type & native_handle);
+
+
 
 [endsect]
 
 
 
-[section:async_connect stream_socket_service::async_connect]
+[section:overload2 windows::basic_stream_handle::assign (2 of 2 overloads)]
 
-Start an asynchronous connect. 
 
-  template<
-      typename ``[link boost_asio.reference.ConnectHandler ConnectHandler]``>
-  void async_connect(
-      implementation_type & impl,
-      const endpoint_type & peer_endpoint,
-      ConnectHandler handler);
+['Inherited from windows::basic_handle.]
+
+Assign an existing native handle to the handle. 
+
+  boost::system::error_code assign(
+      const native_type & native_handle,
+      boost::system::error_code & ec);
 
 
 
 [endsect]
 
 
+[endsect]
+
 
-[section:async_receive stream_socket_service::async_receive]
+[section:async_read_some windows::basic_stream_handle::async_read_some]
 
-Start an asynchronous receive. 
+Start an asynchronous read. 
 
   template<
       typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``,
       typename ``[link boost_asio.reference.ReadHandler ReadHandler]``>
-  void async_receive(
-      implementation_type & impl,
+  void async_read_some(
       const MutableBufferSequence & buffers,
-      socket_base::message_flags flags,
       ReadHandler handler);
 
 
+This function is used to asynchronously read data from the stream handle. The function call always returns immediately.
+
+
+[heading Parameters]
+    
+
+[variablelist
+  
+[[buffers][One or more buffers into which the data will be read. Although the buffers object may be copied as necessary, ownership of the underlying memory blocks is retained by the caller, which must guarantee that they remain valid until the handler is called.]]
+
+[[handler][The handler to be called when the read operation completes. Copies will be made of the handler as required. The function signature of the handler must be: 
+``
+   void handler(
+     const boost::system::error_code& error, // Result of operation.
+     std::size_t bytes_transferred           // Number of bytes read.
+   ); 
+
+``
+Regardless of whether the asynchronous operation completes immediately or not, the handler will not be invoked from within this function. Invocation of the handler will be performed in a manner equivalent to using boost::asio::io\_service::post().]]
+
+]
+
+[heading Remarks]
+      
+The read operation may not read all of the requested number of bytes. Consider using the 
+[link boost_asio.reference.async_read async_read]  function if you need to ensure that the requested amount of data is read before the asynchronous operation completes.
+
+[heading Example]
+  
+To read into a single data buffer use the 
+[link boost_asio.reference.buffer buffer]  function as follows: 
+
+   handle.async_read_some(boost::asio::buffer(data, size), handler);
+
+
+See the 
+[link boost_asio.reference.buffer buffer]  documentation for information on reading into multiple buffers in one go, and how to use it with arrays, boost::array or std::vector. 
+
+
 
 [endsect]
 
 
 
-[section:async_send stream_socket_service::async_send]
+[section:async_write_some windows::basic_stream_handle::async_write_some]
 
-Start an asynchronous send. 
+Start an asynchronous write. 
 
   template<
       typename ``[link boost_asio.reference.ConstBufferSequence ConstBufferSequence]``,
       typename ``[link boost_asio.reference.WriteHandler WriteHandler]``>
-  void async_send(
-      implementation_type & impl,
+  void async_write_some(
       const ConstBufferSequence & buffers,
-      socket_base::message_flags flags,
       WriteHandler handler);
 
 
+This function is used to asynchronously write data to the stream handle. The function call always returns immediately.
+
+
+[heading Parameters]
+    
+
+[variablelist
+  
+[[buffers][One or more data buffers to be written to the handle. Although the buffers object may be copied as necessary, ownership of the underlying memory blocks is retained by the caller, which must guarantee that they remain valid until the handler is called.]]
+
+[[handler][The handler to be called when the write operation completes. Copies will be made of the handler as required. The function signature of the handler must be: 
+``
+   void handler(
+     const boost::system::error_code& error, // Result of operation.
+     std::size_t bytes_transferred           // Number of bytes written.
+   ); 
+
+``
+Regardless of whether the asynchronous operation completes immediately or not, the handler will not be invoked from within this function. Invocation of the handler will be performed in a manner equivalent to using boost::asio::io\_service::post().]]
+
+]
+
+[heading Remarks]
+      
+The write operation may not transmit all of the data to the peer. Consider using the 
+[link boost_asio.reference.async_write async_write]  function if you need to ensure that all data is written before the asynchronous operation completes.
+
+[heading Example]
+  
+To write a single data buffer use the 
+[link boost_asio.reference.buffer buffer]  function as follows: 
+
+   handle.async_write_some(boost::asio::buffer(data, size), handler);
+
+
+See the 
+[link boost_asio.reference.buffer buffer]  documentation for information on writing multiple buffers in one go, and how to use it with arrays, boost::array or std::vector. 
+
+
 
 [endsect]
 
 
+[section:basic_stream_handle windows::basic_stream_handle::basic_stream_handle]
 
-[section:at_mark stream_socket_service::at_mark]
+Construct a basic_stream_handle without opening it. 
 
-Determine whether the socket is at the out-of-band data mark. 
+  ``[link boost_asio.reference.windows__basic_stream_handle.basic_stream_handle.overload1 basic_stream_handle]``(
+      boost::asio::io_service & io_service);
+
+  ``[link boost_asio.reference.windows__basic_stream_handle.basic_stream_handle.overload2 basic_stream_handle]``(
+      boost::asio::io_service & io_service,
+      const native_type & native_handle);
 
-  bool at_mark(
-      const implementation_type & impl,
-      boost::system::error_code & ec) const;
+
+[section:overload1 windows::basic_stream_handle::basic_stream_handle (1 of 2 overloads)]
+
+Construct a basic_stream_handle without opening it. 
+
+  basic_stream_handle(
+      boost::asio::io_service & io_service);
+
+
+This constructor creates a stream handle without opening it. The handle needs to be opened and then connected or accepted before data can be sent or received on it.
+
+
+[heading Parameters]
+    
+
+[variablelist
+  
+[[io_service][The io\_service object that the stream handle will use to dispatch handlers for any asynchronous operations performed on the handle. ]]
+
+]
 
 
 
@@ -38001,97 +46261,198 @@
 
 
 
-[section:available stream_socket_service::available]
+[section:overload2 windows::basic_stream_handle::basic_stream_handle (2 of 2 overloads)]
 
-Determine the number of bytes available for reading. 
+Construct a basic_stream_handle on an existing native handle. 
 
-  std::size_t available(
-      const implementation_type & impl,
-      boost::system::error_code & ec) const;
+  basic_stream_handle(
+      boost::asio::io_service & io_service,
+      const native_type & native_handle);
+
+
+This constructor creates a stream handle object to hold an existing native handle.
+
+
+[heading Parameters]
+    
+
+[variablelist
+  
+[[io_service][The io\_service object that the stream handle will use to dispatch handlers for any asynchronous operations performed on the handle.]]
+
+[[native_handle][The new underlying handle implementation.]]
+
+]
+
+[heading Exceptions]
+    
+
+[variablelist
+  
+[[boost::system::system_error][Thrown on failure. ]]
+
+]
 
 
 
 [endsect]
 
 
+[endsect]
 
-[section:bind stream_socket_service::bind]
+[section:cancel windows::basic_stream_handle::cancel]
 
-Bind the stream socket to the specified local endpoint. 
+Cancel all asynchronous operations associated with the handle. 
 
-  boost::system::error_code bind(
-      implementation_type & impl,
-      const endpoint_type & endpoint,
+  void ``[link boost_asio.reference.windows__basic_stream_handle.cancel.overload1 cancel]``();
+
+  boost::system::error_code ``[link boost_asio.reference.windows__basic_stream_handle.cancel.overload2 cancel]``(
       boost::system::error_code & ec);
 
 
+[section:overload1 windows::basic_stream_handle::cancel (1 of 2 overloads)]
+
+
+['Inherited from windows::basic_handle.]
+
+Cancel all asynchronous operations associated with the handle. 
+
+  void cancel();
+
+
+This function causes all outstanding asynchronous read or write operations to finish immediately, and the handlers for cancelled operations will be passed the boost::asio::error::operation\_aborted error.
+
+
+[heading Exceptions]
+    
+
+[variablelist
+  
+[[boost::system::system_error][Thrown on failure. ]]
+
+]
+
+
 
 [endsect]
 
 
 
-[section:cancel stream_socket_service::cancel]
+[section:overload2 windows::basic_stream_handle::cancel (2 of 2 overloads)]
 
-Cancel all asynchronous operations associated with the socket. 
+
+['Inherited from windows::basic_handle.]
+
+Cancel all asynchronous operations associated with the handle. 
 
   boost::system::error_code cancel(
-      implementation_type & impl,
       boost::system::error_code & ec);
 
 
+This function causes all outstanding asynchronous read or write operations to finish immediately, and the handlers for cancelled operations will be passed the boost::asio::error::operation\_aborted error.
+
+
+[heading Parameters]
+    
+
+[variablelist
+  
+[[ec][Set to indicate what error occurred, if any. ]]
+
+]
+
+
 
 [endsect]
 
 
+[endsect]
 
-[section:close stream_socket_service::close]
+[section:close windows::basic_stream_handle::close]
 
-Close a stream socket implementation. 
+Close the handle. 
 
-  boost::system::error_code close(
-      implementation_type & impl,
+  void ``[link boost_asio.reference.windows__basic_stream_handle.close.overload1 close]``();
+
+  boost::system::error_code ``[link boost_asio.reference.windows__basic_stream_handle.close.overload2 close]``(
       boost::system::error_code & ec);
 
 
+[section:overload1 windows::basic_stream_handle::close (1 of 2 overloads)]
+
+
+['Inherited from windows::basic_handle.]
+
+Close the handle. 
+
+  void close();
+
+
+This function is used to close the handle. Any asynchronous read or write operations will be cancelled immediately, and will complete with the boost::asio::error::operation\_aborted error.
+
+
+[heading Exceptions]
+    
+
+[variablelist
+  
+[[boost::system::system_error][Thrown on failure. ]]
+
+]
+
+
 
 [endsect]
 
 
 
-[section:connect stream_socket_service::connect]
+[section:overload2 windows::basic_stream_handle::close (2 of 2 overloads)]
 
-Connect the stream socket to the specified endpoint. 
 
-  boost::system::error_code connect(
-      implementation_type & impl,
-      const endpoint_type & peer_endpoint,
+['Inherited from windows::basic_handle.]
+
+Close the handle. 
+
+  boost::system::error_code close(
       boost::system::error_code & ec);
 
 
+This function is used to close the handle. Any asynchronous read or write operations will be cancelled immediately, and will complete with the boost::asio::error::operation\_aborted error.
 
-[endsect]
 
+[heading Parameters]
+    
 
+[variablelist
+  
+[[ec][Set to indicate what error occurred, if any. ]]
 
-[section:construct stream_socket_service::construct]
+]
 
-Construct a new stream socket implementation. 
 
-  void construct(
-      implementation_type & impl);
 
+[endsect]
 
 
 [endsect]
 
 
+[section:get_io_service windows::basic_stream_handle::get_io_service]
 
-[section:destroy stream_socket_service::destroy]
 
-Destroy a stream socket implementation. 
+['Inherited from basic_io_object.]
 
-  void destroy(
-      implementation_type & impl);
+Get the io_service associated with the object. 
+
+  boost::asio::io_service & get_io_service();
+
+
+This function may be used to obtain the io_service object that the I/O object uses to dispatch handlers for asynchronous operations.
+
+
+[heading Return Value]
+      
+A reference to the io_service object that the I/O object will use to dispatch handlers. Ownership is not transferred to the caller. 
 
 
 
@@ -38099,12 +46460,14 @@
 
 
 
-[section:endpoint_type stream_socket_service::endpoint_type]
+[section:implementation windows::basic_stream_handle::implementation]
 
-The endpoint type. 
 
-  typedef Protocol::endpoint endpoint_type;
+['Inherited from basic_io_object.]
 
+The underlying implementation of the I/O object. 
+
+  implementation_type implementation;
 
 
 
@@ -38112,14 +46475,15 @@
 
 
 
-[section:get_io_service stream_socket_service::get_io_service]
+[section:implementation_type windows::basic_stream_handle::implementation_type]
 
 
-['Inherited from io_service.]
+['Inherited from basic_io_object.]
 
-Get the io_service object that owns the service. 
+The underlying implementation type of I/O object. 
+
+  typedef service_type::implementation_type implementation_type;
 
-  boost::asio::io_service & get_io_service();
 
 
 
@@ -38127,16 +46491,22 @@
 
 
 
-[section:get_option stream_socket_service::get_option]
+[section:io_service windows::basic_stream_handle::io_service]
 
-Get a socket option. 
 
-  template<
-      typename ``[link boost_asio.reference.GettableSocketOption GettableSocketOption]``>
-  boost::system::error_code get_option(
-      const implementation_type & impl,
-      GettableSocketOption & option,
-      boost::system::error_code & ec) const;
+['Inherited from basic_io_object.]
+
+(Deprecated: use get_io_service().) Get the io_service associated with the object. 
+
+  boost::asio::io_service & io_service();
+
+
+This function may be used to obtain the io_service object that the I/O object uses to dispatch handlers for asynchronous operations.
+
+
+[heading Return Value]
+      
+A reference to the io_service object that the I/O object will use to dispatch handlers. Ownership is not transferred to the caller. 
 
 
 
@@ -38144,11 +46514,14 @@
 
 
 
-[section:id stream_socket_service::id]
+[section:is_open windows::basic_stream_handle::is_open]
 
-The unique service identifier. 
 
-  static boost::asio::io_service::id id;
+['Inherited from windows::basic_handle.]
+
+Determine whether the handle is open. 
+
+  bool is_open() const;
 
 
 
@@ -38156,12 +46529,22 @@
 
 
 
-[section:implementation_type stream_socket_service::implementation_type]
+[section:lowest_layer windows::basic_stream_handle::lowest_layer]
 
-The type of a stream socket implementation. 
 
-  typedef implementation_defined implementation_type;
+['Inherited from windows::basic_handle.]
+
+Get a reference to the lowest layer. 
+
+  lowest_layer_type & lowest_layer();
+
+
+This function returns a reference to the lowest layer in a stack of layers. Since a basic_handle cannot contain any further layers, it simply returns a reference to itself.
+
 
+[heading Return Value]
+      
+A reference to the lowest layer in the stack of layers. Ownership is not transferred to the caller. 
 
 
 
@@ -38169,16 +46552,137 @@
 
 
 
-[section:io_control stream_socket_service::io_control]
+[section:lowest_layer_type windows::basic_stream_handle::lowest_layer_type]
 
-Perform an IO control command on the socket. 
 
-  template<
-      typename ``[link boost_asio.reference.IoControlCommand IoControlCommand]``>
-  boost::system::error_code io_control(
-      implementation_type & impl,
-      IoControlCommand & command,
-      boost::system::error_code & ec);
+['Inherited from windows::basic_handle.]
+
+A basic_handle is always the lowest layer. 
+
+  typedef basic_handle< StreamHandleService > lowest_layer_type;
+
+
+[heading Types]
+[table
+  [[Name][Description]]
+
+  [
+
+    [[link boost_asio.reference.windows__basic_handle.implementation_type [*implementation_type]]]
+    [The underlying implementation type of I/O object. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.windows__basic_handle.lowest_layer_type [*lowest_layer_type]]]
+    [A basic_handle is always the lowest layer. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.windows__basic_handle.native_type [*native_type]]]
+    [The native representation of a handle. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.windows__basic_handle.service_type [*service_type]]]
+    [The type of the service that will be used to provide I/O operations. ]
+  
+  ]
+
+]
+
+[heading Member Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.windows__basic_handle.assign [*assign]]]
+    [Assign an existing native handle to the handle. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.windows__basic_handle.basic_handle [*basic_handle]]]
+    [Construct a basic_handle without opening it. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.windows__basic_handle.cancel [*cancel]]]
+    [Cancel all asynchronous operations associated with the handle. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.windows__basic_handle.close [*close]]]
+    [Close the handle. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.windows__basic_handle.get_io_service [*get_io_service]]]
+    [Get the io_service associated with the object. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.windows__basic_handle.io_service [*io_service]]]
+    [(Deprecated: use get_io_service().) Get the io_service associated with the object. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.windows__basic_handle.is_open [*is_open]]]
+    [Determine whether the handle is open. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.windows__basic_handle.lowest_layer [*lowest_layer]]]
+    [Get a reference to the lowest layer. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.windows__basic_handle.native [*native]]]
+    [Get the native handle representation. ]
+  ]
+  
+]
+
+[heading Protected Member Functions]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.windows__basic_handle._basic_handle [*~basic_handle]]]
+    [Protected destructor to prevent deletion through this type. ]
+  ]
+  
+]
+
+[heading Protected Data Members]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.windows__basic_handle.implementation [*implementation]]]
+    [The underlying implementation of the I/O object. ]
+  ]
+
+  [
+    [[link boost_asio.reference.windows__basic_handle.service [*service]]]
+    [The service associated with the I/O object. ]
+  ]
+
+]
+
+The windows::basic_handle class template provides the ability to wrap a Windows handle.
+
+
+[heading Thread Safety]
+  
+[*Distinct] [*objects:]  Safe.
+
+[*Shared] [*objects:]  Unsafe. 
+
 
 
 
@@ -38186,54 +46690,101 @@
 
 
 
-[section:io_service stream_socket_service::io_service]
+[section:native windows::basic_stream_handle::native]
 
 
-['Inherited from io_service.]
+['Inherited from windows::basic_handle.]
 
-(Deprecated: use get_io_service().) Get the io_service object that owns the service. 
+Get the native handle representation. 
+
+  native_type native();
 
-  boost::asio::io_service & io_service();
 
+This function may be used to obtain the underlying representation of the handle. This is intended to allow access to native handle functionality that is not otherwise provided. 
 
 
 [endsect]
 
 
 
-[section:is_open stream_socket_service::is_open]
+[section:native_type windows::basic_stream_handle::native_type]
 
-Determine whether the socket is open. 
+The native representation of a handle. 
 
-  bool is_open(
-      const implementation_type & impl) const;
+  typedef StreamHandleService::native_type native_type;
+
+
+
+
+[endsect]
+
+
+[section:read_some windows::basic_stream_handle::read_some]
+
+Read some data from the handle. 
 
+  template<
+      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``>
+  std::size_t ``[link boost_asio.reference.windows__basic_stream_handle.read_some.overload1 read_some]``(
+      const MutableBufferSequence & buffers);
+
+  template<
+      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``>
+  std::size_t ``[link boost_asio.reference.windows__basic_stream_handle.read_some.overload2 read_some]``(
+      const MutableBufferSequence & buffers,
+      boost::system::error_code & ec);
+
+
+[section:overload1 windows::basic_stream_handle::read_some (1 of 2 overloads)]
+
+Read some data from the handle. 
+
+  template<
+      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``>
+  std::size_t read_some(
+      const MutableBufferSequence & buffers);
 
 
-[endsect]
+This function is used to read data from the stream handle. The function call will block until one or more bytes of data has been read successfully, or until an error occurs.
 
 
+[heading Parameters]
+    
 
-[section:local_endpoint stream_socket_service::local_endpoint]
+[variablelist
+  
+[[buffers][One or more buffers into which the data will be read.]]
 
-Get the local endpoint. 
+]
 
-  endpoint_type local_endpoint(
-      const implementation_type & impl,
-      boost::system::error_code & ec) const;
+[heading Return Value]
+      
+The number of bytes read.
 
+[heading Exceptions]
+    
 
+[variablelist
+  
+[[boost::system::system_error][Thrown on failure. An error code of boost::asio::error::eof indicates that the connection was closed by the peer.]]
 
-[endsect]
+]
 
+[heading Remarks]
+      
+The read\_some operation may not read all of the requested number of bytes. Consider using the 
+[link boost_asio.reference.read read]  function if you need to ensure that the requested amount of data is read before the blocking operation completes.
 
+[heading Example]
+  
+To read into a single data buffer use the 
+[link boost_asio.reference.buffer buffer]  function as follows: 
 
-[section:native stream_socket_service::native]
+   handle.read_some(boost::asio::buffer(data, size));
 
-Get the native socket implementation. 
 
-  native_type native(
-      implementation_type & impl);
+See the 
+[link boost_asio.reference.buffer buffer]  documentation for information on reading into multiple buffers in one go, and how to use it with arrays, boost::array or std::vector. 
 
 
 
@@ -38241,122 +46792,144 @@
 
 
 
-[section:native_type stream_socket_service::native_type]
+[section:overload2 windows::basic_stream_handle::read_some (2 of 2 overloads)]
 
-The native socket type. 
+Read some data from the handle. 
 
-  typedef implementation_defined native_type;
+  template<
+      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``>
+  std::size_t read_some(
+      const MutableBufferSequence & buffers,
+      boost::system::error_code & ec);
 
 
+This function is used to read data from the stream handle. The function call will block until one or more bytes of data has been read successfully, or until an error occurs.
 
 
-[endsect]
+[heading Parameters]
+    
 
+[variablelist
+  
+[[buffers][One or more buffers into which the data will be read.]]
 
+[[ec][Set to indicate what error occurred, if any.]]
 
-[section:open stream_socket_service::open]
+]
 
-Open a stream socket. 
+[heading Return Value]
+      
+The number of bytes read. Returns 0 if an error occurred.
 
-  boost::system::error_code open(
-      implementation_type & impl,
-      const protocol_type & protocol,
-      boost::system::error_code & ec);
+[heading Remarks]
+      
+The read\_some operation may not read all of the requested number of bytes. Consider using the 
+[link boost_asio.reference.read read]  function if you need to ensure that the requested amount of data is read before the blocking operation completes. 
 
 
 
 [endsect]
 
 
-
-[section:protocol_type stream_socket_service::protocol_type]
-
-The protocol type. 
-
-  typedef Protocol protocol_type;
+[endsect]
 
 
+[section:service windows::basic_stream_handle::service]
 
 
-[endsect]
+['Inherited from basic_io_object.]
 
+The service associated with the I/O object. 
 
+  service_type & service;
 
-[section:receive stream_socket_service::receive]
 
-Receive some data from the peer. 
 
-  template<
-      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``>
-  std::size_t receive(
-      implementation_type & impl,
-      const MutableBufferSequence & buffers,
-      socket_base::message_flags flags,
-      boost::system::error_code & ec);
+[endsect]
 
 
 
-[endsect]
+[section:service_type windows::basic_stream_handle::service_type]
 
 
+['Inherited from basic_io_object.]
 
-[section:remote_endpoint stream_socket_service::remote_endpoint]
+The type of the service that will be used to provide I/O operations. 
 
-Get the remote endpoint. 
+  typedef StreamHandleService service_type;
 
-  endpoint_type remote_endpoint(
-      const implementation_type & impl,
-      boost::system::error_code & ec) const;
 
 
 
 [endsect]
 
 
+[section:write_some windows::basic_stream_handle::write_some]
 
-[section:send stream_socket_service::send]
+Write some data to the handle. 
 
-Send the given data to the peer. 
+  template<
+      typename ``[link boost_asio.reference.ConstBufferSequence ConstBufferSequence]``>
+  std::size_t ``[link boost_asio.reference.windows__basic_stream_handle.write_some.overload1 write_some]``(
+      const ConstBufferSequence & buffers);
 
   template<
       typename ``[link boost_asio.reference.ConstBufferSequence ConstBufferSequence]``>
-  std::size_t send(
-      implementation_type & impl,
+  std::size_t ``[link boost_asio.reference.windows__basic_stream_handle.write_some.overload2 write_some]``(
       const ConstBufferSequence & buffers,
-      socket_base::message_flags flags,
       boost::system::error_code & ec);
 
 
+[section:overload1 windows::basic_stream_handle::write_some (1 of 2 overloads)]
 
-[endsect]
+Write some data to the handle. 
 
+  template<
+      typename ``[link boost_asio.reference.ConstBufferSequence ConstBufferSequence]``>
+  std::size_t write_some(
+      const ConstBufferSequence & buffers);
 
 
-[section:set_option stream_socket_service::set_option]
+This function is used to write data to the stream handle. The function call will block until one or more bytes of the data has been written successfully, or until an error occurs.
 
-Set a socket option. 
 
-  template<
-      typename ``[link boost_asio.reference.SettableSocketOption SettableSocketOption]``>
-  boost::system::error_code set_option(
-      implementation_type & impl,
-      const SettableSocketOption & option,
-      boost::system::error_code & ec);
+[heading Parameters]
+    
 
+[variablelist
+  
+[[buffers][One or more data buffers to be written to the handle.]]
 
+]
 
-[endsect]
+[heading Return Value]
+      
+The number of bytes written.
 
+[heading Exceptions]
+    
 
+[variablelist
+  
+[[boost::system::system_error][Thrown on failure. An error code of boost::asio::error::eof indicates that the connection was closed by the peer.]]
 
-[section:shutdown stream_socket_service::shutdown]
+]
 
-Disable sends or receives on the socket. 
+[heading Remarks]
+      
+The write\_some operation may not transmit all of the data to the peer. Consider using the 
+[link boost_asio.reference.write write]  function if you need to ensure that all data is written before the blocking operation completes.
+
+[heading Example]
+  
+To write a single data buffer use the 
+[link boost_asio.reference.buffer buffer]  function as follows: 
+
+   handle.write_some(boost::asio::buffer(data, size));
 
-  boost::system::error_code shutdown(
-      implementation_type & impl,
-      socket_base::shutdown_type what,
-      boost::system::error_code & ec);
+
+See the 
+[link boost_asio.reference.buffer buffer]  documentation for information on writing multiple buffers in one go, and how to use it with arrays, boost::array or std::vector. 
 
 
 
@@ -38364,39 +46937,56 @@
 
 
 
-[section:shutdown_service stream_socket_service::shutdown_service]
+[section:overload2 windows::basic_stream_handle::write_some (2 of 2 overloads)]
 
-Destroy all user-defined handler objects owned by the service. 
+Write some data to the handle. 
 
-  void shutdown_service();
+  template<
+      typename ``[link boost_asio.reference.ConstBufferSequence ConstBufferSequence]``>
+  std::size_t write_some(
+      const ConstBufferSequence & buffers,
+      boost::system::error_code & ec);
 
 
+This function is used to write data to the stream handle. The function call will block until one or more bytes of the data has been written successfully, or until an error occurs.
 
-[endsect]
 
+[heading Parameters]
+    
+
+[variablelist
+  
+[[buffers][One or more data buffers to be written to the handle.]]
 
+[[ec][Set to indicate what error occurred, if any.]]
 
-[section:stream_socket_service stream_socket_service::stream_socket_service]
+]
 
-Construct a new stream socket service for the specified io_service. 
+[heading Return Value]
+      
+The number of bytes written. Returns 0 if an error occurred.
 
-  stream_socket_service(
-      boost::asio::io_service & io_service);
+[heading Remarks]
+      
+The write\_some operation may not transmit all of the data to the peer. Consider using the 
+[link boost_asio.reference.write write]  function if you need to ensure that all data is written before the blocking operation completes. 
 
 
 
 [endsect]
 
 
+[endsect]
+
 
 [endsect]
 
 
-[section:streambuf streambuf]
+[section:windows__stream_handle windows::stream_handle]
 
-Typedef for the typical usage of basic_streambuf. 
+Typedef for the typical usage of a stream-oriented handle. 
 
-  typedef basic_streambuf streambuf;
+  typedef basic_stream_handle stream_handle;
 
 
 [heading Types]
@@ -38405,15 +46995,29 @@
 
   [
 
-    [[link boost_asio.reference.basic_streambuf.const_buffers_type [*const_buffers_type]]]
-    [The type used to represent the get area as a list of buffers. ]
+    [[link boost_asio.reference.windows__basic_stream_handle.implementation_type [*implementation_type]]]
+    [The underlying implementation type of I/O object. ]
   
   ]
 
   [
 
-    [[link boost_asio.reference.basic_streambuf.mutable_buffers_type [*mutable_buffers_type]]]
-    [The type used to represent the put area as a list of buffers. ]
+    [[link boost_asio.reference.windows__basic_stream_handle.lowest_layer_type [*lowest_layer_type]]]
+    [A basic_handle is always the lowest layer. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.windows__basic_stream_handle.native_type [*native_type]]]
+    [The native representation of a handle. ]
+  
+  ]
+
+  [
+
+    [[link boost_asio.reference.windows__basic_stream_handle.service_type [*service_type]]]
+    [The type of the service that will be used to provide I/O operations. ]
   
   ]
 
@@ -38424,53 +47028,109 @@
   [[Name][Description]]
 
   [
-    [[link boost_asio.reference.basic_streambuf.basic_streambuf [*basic_streambuf]]]
-    [Construct a buffer with a specified maximum size. ]
+    [[link boost_asio.reference.windows__basic_stream_handle.assign [*assign]]]
+    [Assign an existing native handle to the handle. ]
   ]
   
   [
-    [[link boost_asio.reference.basic_streambuf.commit [*commit]]]
-    [Move the start of the put area by the specified number of characters. ]
+    [[link boost_asio.reference.windows__basic_stream_handle.async_read_some [*async_read_some]]]
+    [Start an asynchronous read. ]
   ]
   
   [
-    [[link boost_asio.reference.basic_streambuf.consume [*consume]]]
-    [Move the start of the get area by the specified number of characters. ]
+    [[link boost_asio.reference.windows__basic_stream_handle.async_write_some [*async_write_some]]]
+    [Start an asynchronous write. ]
   ]
   
   [
-    [[link boost_asio.reference.basic_streambuf.data [*data]]]
-    [Get a list of buffers that represents the get area. ]
+    [[link boost_asio.reference.windows__basic_stream_handle.basic_stream_handle [*basic_stream_handle]]]
+    [Construct a basic_stream_handle without opening it. ]
   ]
   
   [
-    [[link boost_asio.reference.basic_streambuf.max_size [*max_size]]]
-    [Return the maximum size of the buffer. ]
+    [[link boost_asio.reference.windows__basic_stream_handle.cancel [*cancel]]]
+    [Cancel all asynchronous operations associated with the handle. ]
   ]
   
   [
-    [[link boost_asio.reference.basic_streambuf.prepare [*prepare]]]
-    [Get a list of buffers that represents the put area, with the given size. ]
+    [[link boost_asio.reference.windows__basic_stream_handle.close [*close]]]
+    [Close the handle. ]
   ]
   
   [
-    [[link boost_asio.reference.basic_streambuf.size [*size]]]
-    [Return the size of the get area in characters. ]
+    [[link boost_asio.reference.windows__basic_stream_handle.get_io_service [*get_io_service]]]
+    [Get the io_service associated with the object. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.windows__basic_stream_handle.io_service [*io_service]]]
+    [(Deprecated: use get_io_service().) Get the io_service associated with the object. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.windows__basic_stream_handle.is_open [*is_open]]]
+    [Determine whether the handle is open. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.windows__basic_stream_handle.lowest_layer [*lowest_layer]]]
+    [Get a reference to the lowest layer. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.windows__basic_stream_handle.native [*native]]]
+    [Get the native handle representation. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.windows__basic_stream_handle.read_some [*read_some]]]
+    [Read some data from the handle. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.windows__basic_stream_handle.write_some [*write_some]]]
+    [Write some data to the handle. ]
   ]
   
 ]
 
+[heading Protected Data Members]
+[table
+  [[Name][Description]]
+
+  [
+    [[link boost_asio.reference.windows__basic_stream_handle.implementation [*implementation]]]
+    [The underlying implementation of the I/O object. ]
+  ]
+
+  [
+    [[link boost_asio.reference.windows__basic_stream_handle.service [*service]]]
+    [The service associated with the I/O object. ]
+  ]
+
+]
+
+The windows::basic_stream_handle class template provides asynchronous and blocking stream-oriented handle functionality.
+
+
+[heading Thread Safety]
+  
+[*Distinct] [*objects:]  Safe.
+
+[*Shared] [*objects:]  Unsafe.
+
+
 
 
 [endsect]
 
 
-[section:time_traits_lt__ptime__gt_ time_traits< boost::posix_time::ptime >]
+[section:windows__stream_handle_service windows::stream_handle_service]
 
-Time traits specialised for posix_time. 
+Default service implementation for a stream handle. 
 
-  template<>
-  struct time_traits< boost::posix_time::ptime >
+  class stream_handle_service :
+    public io_service::service
 
 
 [heading Types]
@@ -38479,15 +47139,15 @@
 
   [
 
-    [[link boost_asio.reference.time_traits_lt__ptime__gt_.duration_type [*duration_type]]]
-    [The duration type. ]
+    [[link boost_asio.reference.windows__stream_handle_service.implementation_type [*implementation_type]]]
+    [The type of a stream handle implementation. ]
   
   ]
 
   [
 
-    [[link boost_asio.reference.time_traits_lt__ptime__gt_.time_type [*time_type]]]
-    [The time type. ]
+    [[link boost_asio.reference.windows__stream_handle_service.native_type [*native_type]]]
+    [The native handle type. ]
   
   ]
 
@@ -38498,53 +47158,120 @@
   [[Name][Description]]
 
   [
-    [[link boost_asio.reference.time_traits_lt__ptime__gt_.add [*add]]]
-    [Add a duration to a time. ]
+    [[link boost_asio.reference.windows__stream_handle_service.assign [*assign]]]
+    [Assign an existing native handle to a stream handle. ]
   ]
   
   [
-    [[link boost_asio.reference.time_traits_lt__ptime__gt_.less_than [*less_than]]]
-    [Test whether one time is less than another. ]
+    [[link boost_asio.reference.windows__stream_handle_service.async_read_some [*async_read_some]]]
+    [Start an asynchronous read. ]
   ]
   
   [
-    [[link boost_asio.reference.time_traits_lt__ptime__gt_.now [*now]]]
-    [Get the current time. ]
+    [[link boost_asio.reference.windows__stream_handle_service.async_write_some [*async_write_some]]]
+    [Start an asynchronous write. ]
   ]
   
   [
-    [[link boost_asio.reference.time_traits_lt__ptime__gt_.subtract [*subtract]]]
-    [Subtract one time from another. ]
+    [[link boost_asio.reference.windows__stream_handle_service.cancel [*cancel]]]
+    [Cancel all asynchronous operations associated with the handle. ]
   ]
   
   [
-    [[link boost_asio.reference.time_traits_lt__ptime__gt_.to_posix_duration [*to_posix_duration]]]
-    [Convert to POSIX duration type. ]
+    [[link boost_asio.reference.windows__stream_handle_service.close [*close]]]
+    [Close a stream handle implementation. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.windows__stream_handle_service.construct [*construct]]]
+    [Construct a new stream handle implementation. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.windows__stream_handle_service.destroy [*destroy]]]
+    [Destroy a stream handle implementation. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.windows__stream_handle_service.get_io_service [*get_io_service]]]
+    [Get the io_service object that owns the service. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.windows__stream_handle_service.io_service [*io_service]]]
+    [(Deprecated: use get_io_service().) Get the io_service object that owns the service. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.windows__stream_handle_service.is_open [*is_open]]]
+    [Determine whether the handle is open. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.windows__stream_handle_service.native [*native]]]
+    [Get the native handle implementation. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.windows__stream_handle_service.read_some [*read_some]]]
+    [Read some data from the stream. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.windows__stream_handle_service.shutdown_service [*shutdown_service]]]
+    [Destroy all user-defined handler objects owned by the service. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.windows__stream_handle_service.stream_handle_service [*stream_handle_service]]]
+    [Construct a new stream handle service for the specified io_service. ]
+  ]
+  
+  [
+    [[link boost_asio.reference.windows__stream_handle_service.write_some [*write_some]]]
+    [Write the given data to the stream. ]
   ]
   
 ]
 
+[heading Data Members]
+[table
+  [[Name][Description]]
 
-[section:add time_traits< boost::posix_time::ptime >::add]
+  [
+    [[link boost_asio.reference.windows__stream_handle_service.id [*id]]]
+    [The unique service identifier. ]
+  ]
 
-Add a duration to a time. 
+]
 
-  static time_type add(
-      const time_type & t,
-      const duration_type & d);
 
+[section:assign windows::stream_handle_service::assign]
 
+Assign an existing native handle to a stream handle. 
 
-[endsect]
+  boost::system::error_code assign(
+      implementation_type & impl,
+      const native_type & native_handle,
+      boost::system::error_code & ec);
 
 
 
-[section:duration_type time_traits< boost::posix_time::ptime >::duration_type]
+[endsect]
 
-The duration type. 
 
-  typedef boost::posix_time::time_duration duration_type;
 
+[section:async_read_some windows::stream_handle_service::async_read_some]
+
+Start an asynchronous read. 
+
+  template<
+      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``,
+      typename ``[link boost_asio.reference.ReadHandler ReadHandler]``>
+  void async_read_some(
+      implementation_type & impl,
+      const MutableBufferSequence & buffers,
+      ReadHandler handler);
 
 
 
@@ -38552,13 +47279,17 @@
 
 
 
-[section:less_than time_traits< boost::posix_time::ptime >::less_than]
+[section:async_write_some windows::stream_handle_service::async_write_some]
 
-Test whether one time is less than another. 
+Start an asynchronous write. 
 
-  static bool less_than(
-      const time_type & t1,
-      const time_type & t2);
+  template<
+      typename ``[link boost_asio.reference.ConstBufferSequence ConstBufferSequence]``,
+      typename ``[link boost_asio.reference.WriteHandler WriteHandler]``>
+  void async_write_some(
+      implementation_type & impl,
+      const ConstBufferSequence & buffers,
+      WriteHandler handler);
 
 
 
@@ -38566,11 +47297,13 @@
 
 
 
-[section:now time_traits< boost::posix_time::ptime >::now]
+[section:cancel windows::stream_handle_service::cancel]
 
-Get the current time. 
+Cancel all asynchronous operations associated with the handle. 
 
-  static time_type now();
+  boost::system::error_code cancel(
+      implementation_type & impl,
+      boost::system::error_code & ec);
 
 
 
@@ -38578,13 +47311,13 @@
 
 
 
-[section:subtract time_traits< boost::posix_time::ptime >::subtract]
+[section:close windows::stream_handle_service::close]
 
-Subtract one time from another. 
+Close a stream handle implementation. 
 
-  static duration_type subtract(
-      const time_type & t1,
-      const time_type & t2);
+  boost::system::error_code close(
+      implementation_type & impl,
+      boost::system::error_code & ec);
 
 
 
@@ -38592,12 +47325,25 @@
 
 
 
-[section:time_type time_traits< boost::posix_time::ptime >::time_type]
+[section:construct windows::stream_handle_service::construct]
 
-The time type. 
+Construct a new stream handle implementation. 
 
-  typedef boost::posix_time::ptime time_type;
+  void construct(
+      implementation_type & impl);
+
+
+
+[endsect]
+
+
+
+[section:destroy windows::stream_handle_service::destroy]
 
+Destroy a stream handle implementation. 
+
+  void destroy(
+      implementation_type & impl);
 
 
 
@@ -38605,12 +47351,14 @@
 
 
 
-[section:to_posix_duration time_traits< boost::posix_time::ptime >::to_posix_duration]
+[section:get_io_service windows::stream_handle_service::get_io_service]
 
-Convert to POSIX duration type. 
 
-  static boost::posix_time::time_duration to_posix_duration(
-      const duration_type & d);
+['Inherited from io_service.]
+
+Get the io_service object that owns the service. 
+
+  boost::asio::io_service & get_io_service();
 
 
 
@@ -38618,39 +47366,39 @@
 
 
 
+[section:id windows::stream_handle_service::id]
+
+The unique service identifier. 
+
+  static boost::asio::io_service::id id;
+
+
+
 [endsect]
 
 
-[section:transfer_all transfer_all]
 
-Return a completion condition function object that indicates that a read or write operation should continue until all of the data has been transferred, or until an error occurs. 
+[section:implementation_type windows::stream_handle_service::implementation_type]
 
-  unspecified transfer_all();
+The type of a stream handle implementation. 
 
+  typedef implementation_defined implementation_type;
 
-This function is used to create an object, of unspecified type, that meets CompletionCondition requirements.
 
 
-[heading Example]
-  
-Reading until a buffer is full: 
 
-   boost::array<char, 128> buf;
-   boost::system::error_code ec;
-   std::size_t n = boost::asio::read(
-       sock, boost::asio::buffer(buf),
-       boost::asio::transfer_all(), ec);
-   if (ec)
-   {
-     // An error occurred.
-   }
-   else
-   {
-     // n == 128
-   }
+[endsect]
+
+
+
+[section:io_service windows::stream_handle_service::io_service]
 
 
+['Inherited from io_service.]
+
+(Deprecated: use get_io_service().) Get the io_service object that owns the service. 
 
+  boost::asio::io_service & io_service();
 
 
 
@@ -38658,37 +47406,25 @@
 
 
 
-[section:transfer_at_least transfer_at_least]
+[section:is_open windows::stream_handle_service::is_open]
 
-Return a completion condition function object that indicates that a read or write operation should continue until a minimum number of bytes has been transferred, or until an error occurs. 
+Determine whether the handle is open. 
 
-  unspecified transfer_at_least(
-      std::size_t minimum);
+  bool is_open(
+      const implementation_type & impl) const;
 
 
-This function is used to create an object, of unspecified type, that meets CompletionCondition requirements.
 
+[endsect]
 
-[heading Example]
-  
-Reading until a buffer is full or contains at least 64 bytes: 
 
-   boost::array<char, 128> buf;
-   boost::system::error_code ec;
-   std::size_t n = boost::asio::read(
-       sock, boost::asio::buffer(buf),
-       boost::asio::transfer_at_least(64), ec);
-   if (ec)
-   {
-     // An error occurred.
-   }
-   else
-   {
-     // n >= 64 && n <= 128
-   }
 
+[section:native windows::stream_handle_service::native]
 
+Get the native handle implementation. 
 
+  native_type native(
+      implementation_type & impl);
 
 
 
@@ -38696,37 +47432,80 @@
 
 
 
-[section:use_service use_service]
+[section:native_type windows::stream_handle_service::native_type]
+
+The native handle type. 
+
+  typedef implementation_defined native_type;
+
+
 
 
+[endsect]
+
+
+
+[section:read_some windows::stream_handle_service::read_some]
+
+Read some data from the stream. 
 
   template<
-      typename ``[link boost_asio.reference.Service Service]``>
-  Service & use_service(
-      io_service & ios);
+      typename ``[link boost_asio.reference.MutableBufferSequence MutableBufferSequence]``>
+  std::size_t read_some(
+      implementation_type & impl,
+      const MutableBufferSequence & buffers,
+      boost::system::error_code & ec);
 
 
-This function is used to locate a service object that corresponds to the given service type. If there is no existing implementation of the service, then the io_service will create a new instance of the service.
 
+[endsect]
 
-[heading Parameters]
-    
 
-[variablelist
-  
-[[ios][The io\_service object that owns the service.]]
 
-]
+[section:shutdown_service windows::stream_handle_service::shutdown_service]
+
+Destroy all user-defined handler objects owned by the service. 
+
+  void shutdown_service();
+
+
+
+[endsect]
+
+
+
+[section:stream_handle_service windows::stream_handle_service::stream_handle_service]
+
+Construct a new stream handle service for the specified io_service. 
+
+  stream_handle_service(
+      boost::asio::io_service & io_service);
+
 
-[heading Return Value]
-      
-The service interface implementing the specified service type. Ownership of the service interface is not transferred to the caller. 
+
+[endsect]
+
+
+
+[section:write_some windows::stream_handle_service::write_some]
+
+Write the given data to the stream. 
+
+  template<
+      typename ``[link boost_asio.reference.ConstBufferSequence ConstBufferSequence]``>
+  std::size_t write_some(
+      implementation_type & impl,
+      const ConstBufferSequence & buffers,
+      boost::system::error_code & ec);
 
 
 
 [endsect]
 
 
+
+[endsect]
+
 [section:write write]
 
 Write all of the supplied data to a stream before returning.