couchbase 3.0.0.alpha.5-x86_64-linux → 3.5.0-x86_64-linux

data/ext/third_party/asio/asio/src/doc/requirements/Handler.qbk

@@ -1,64 +0,0 @@
-[/
- / Copyright (c) 2003-2020 Christopher M. Kohlhoff (chris at kohlhoff dot com)
- /
- / Distributed under the Boost Software License, Version 1.0. (See accompanying
- / file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
- /]
-
-[section:Handler Handlers]
-
-A handler must meet the requirements of `MoveConstructible` types (C++Std
-[moveconstructible]).
-
-In the table below, `X` denotes a handler class, `h` denotes a value of `X`,
-`p` denotes a pointer to a block of allocated memory of type `void*`, `s`
-denotes the size for a block of allocated memory, and `f` denotes a function
-object taking no arguments.
-
-[table Handler requirements
-  [[expression] [return type] [assertion/note[br]pre/post-conditions]]
-  [
-    [``
-      using asio::asio_handler_allocate;
-      asio_handler_allocate(s, &h);
-    ``]
-    [`void*`]
-    [
-      Returns a pointer to a block of memory of size `s`. The pointer must
-      satisfy the same alignment requirements as a pointer returned by
-      `::operator new()`. Throws `bad_alloc` on failure.[br][br] The
-      `asio_handler_allocate()` function is located using argument-dependent
-      lookup. The function `asio::asio_handler_allocate()` serves as a
-      default if no user-supplied function is available.
-    ]
-  ]
-  [
-    [``
-      using asio::asio_handler_deallocate;
-      asio_handler_deallocate(p, s, &h);
-    ``]
-    []
-    [
-      Frees a block of memory associated with a pointer `p`, of at least size
-      `s`, that was previously allocated using `asio_handler_allocate()`.[br][br] The
-      `asio_handler_deallocate()` function is located using argument-dependent
-      lookup. The function `asio::asio_handler_deallocate()` serves as a
-      default if no user-supplied function is available.
-    ]
-  ]
-  [
-    [``
-      using asio::asio_handler_invoke;
-      asio_handler_invoke(f, &h);
-    ``]
-    []
-    [
-      Causes the function object `f` to be executed as if by calling `f()`.[br][br]
-      The `asio_handler_invoke()` function is located using argument-dependent
-      lookup. The function `asio::asio_handler_invoke()` serves as a
-      default if no user-supplied function is available.
-    ]
-  ]
-]
-
-[endsect]

data/ext/third_party/asio/asio/src/doc/requirements/HandshakeHandler.qbk

@@ -1,72 +0,0 @@
-[/
- / Copyright (c) 2003-2020 Christopher M. Kohlhoff (chris at kohlhoff dot com)
- /
- / Distributed under the Boost Software License, Version 1.0. (See accompanying
- / file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
- /]
-
-[section:HandshakeHandler SSL handshake handler requirements]
-
-A handshake handler must meet the requirements for a [link
-asio.reference.Handler handler]. A value `h` of a handshake handler
-class should work correctly in the expression `h(ec)`, where `ec` is an lvalue
-of type `const error_code`.
-
-[heading Examples]
-
-A free function as a handshake handler:
-
-  void handshake_handler(
-      const asio::error_code& ec)
-  {
-    ...
-  }
-
-A handshake handler function object:
-
-  struct handshake_handler
-  {
-    ...
-    void operator()(
-        const asio::error_code& ec)
-    {
-      ...
-    }
-    ...
-  };
-
-A lambda as a handshake handler:
-
-  ssl_stream.async_handshake(...,
-      [](const asio::error_code& ec)
-      {
-        ...
-      });
-
-A non-static class member function adapted to a handshake handler using
-`std::bind()`:
-
-  void my_class::handshake_handler(
-      const asio::error_code& ec)
-  {
-    ...
-  }
-  ...
-  ssl_stream.async_handshake(...,
-      std::bind(&my_class::handshake_handler,
-        this, std::placeholders::_1));
-
-A non-static class member function adapted to a handshake handler using
-`boost::bind()`:
-
-  void my_class::handshake_handler(
-      const asio::error_code& ec)
-  {
-    ...
-  }
-  ...
-  ssl_stream.async_handshake(...,
-      boost::bind(&my_class::handshake_handler,
-        this, asio::placeholders::error));
-
-[endsect]

data/ext/third_party/asio/asio/src/doc/requirements/InternetProtocol.qbk

@@ -1,47 +0,0 @@
-[/
- / Copyright (c) 2003-2020 Christopher M. Kohlhoff (chris at kohlhoff dot com)
- /
- / Distributed under the Boost Software License, Version 1.0. (See accompanying
- / file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
- /]
-
-[section:InternetProtocol Internet protocol requirements]
-
-A type `X` meets the `InternetProtocol` requirements if it satisfies the
-requirements of [link asio.reference.AcceptableProtocol `AcceptableProtocol`],
-as well as the additional requirements listed below.
-
-In the table below, `a` denotes a (possibly const) value of type `X`, and `b`
-denotes a (possibly const) value of type `X`.
-
-[table InternetProtocol requirements
-  [[expression] [return type] [assertion/note[br]pre/post-conditions]]
-  [
-    [`X::resolver`]
-    [`ip::basic_resolver<X>`]
-    [The type of a resolver for the protocol.]
-  ]
-  [
-    [`X::v4()`]
-    [`X`]
-    [Returns an object representing the IP version 4 protocol.]
-  ]
-  [
-    [`X::v6()`]
-    [`X`]
-    [Returns an object representing the IP version 6 protocol.]
-  ]
-  [
-    [`a == b`]
-    [convertible to `bool`]
-    [Returns `true` if `a` and `b` represent the same IP protocol version,
-     otherwise `false`.]
-  ]
-  [
-    [`a != b`]
-    [convertible to `bool`]
-    [Returns `!(a == b)`.]
-  ]
-]
-
-[endsect]

data/ext/third_party/asio/asio/src/doc/requirements/IoControlCommand.qbk

@@ -1,34 +0,0 @@
-[/
- / Copyright (c) 2003-2020 Christopher M. Kohlhoff (chris at kohlhoff dot com)
- /
- / Distributed under the Boost Software License, Version 1.0. (See accompanying
- / file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
- /]
-
-[section:IoControlCommand I/O control command requirements]
-
-A type `X` meets the `IoControlCommand` requirements if it satisfies the
-requirements listed below.
-
-In the table below, `a` denotes a (possibly const) value of type `X`, and `b`
-denotes a value of type `X`.
-
-[table IoControlCommand requirements for extensible implementations
-  [[expression] [type] [assertion/note[br]pre/post-conditions]]
-  [
-    [`a.name()`]
-    [`int`]
-    [
-      Returns a value suitable for passing as the /request/ argument to
-      __POSIX__ __ioctl__ (or equivalent).
-    ]
-  ]
-  [
-    [`b.data()`]
-    [`void*`]
-    [
-    ]
-  ]
-]
-
-[endsect]

data/ext/third_party/asio/asio/src/doc/requirements/IoObjectService.qbk

@@ -1,62 +0,0 @@
-[/
- / Copyright (c) 2003-2020 Christopher M. Kohlhoff (chris at kohlhoff dot com)
- /
- / Distributed under the Boost Software License, Version 1.0. (See accompanying
- / file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
- /]
-
-[section:IoObjectService I/O object service requirements]
-
-An I/O object service must meet the requirements for a [link
-asio.reference.Service service], as well as the requirements listed
-below.
-
-In the table below, `X` denotes an I/O object service class, `a` and `ao` denote
-values of type `X`, `b` and `c` denote values of type `X::implementation_type`,
-and `u` denotes an identifier.
-
-[table IoObjectService requirements
-  [[expression] [return type] [assertion/note[br]pre/post-condition]]
-  [
-    [`X::implementation_type`]
-    []
-    []
-  ]
-  [
-    [`X::implementation_type u;`]
-    []
-    [note: `X::implementation_type` has a public default constructor and
-     destructor.]
-  ]
-  [
-    [``
-      a.construct(b);
-    ``]
-    []
-    []
-  ]
-  [
-    [``
-      a.destroy(b);
-    ``]
-    []
-    [note: `destroy()` will only be called on a value that has previously been
-     initialised with `construct()` or `move_construct()`.]
-  ]
-  [
-    [``
-      a.move_construct(b, c);
-    ``]
-    []
-    [note: only required for I/O objects that support movability.]
-  ]
-  [
-    [``
-      a.move_assign(b, ao, c);
-    ``]
-    []
-    [note: only required for I/O objects that support movability.]
-  ]
-]
-
-[endsect]

data/ext/third_party/asio/asio/src/doc/requirements/IteratorConnectHandler.qbk

@@ -1,81 +0,0 @@
-[/
- / Copyright (c) 2003-2020 Christopher M. Kohlhoff (chris at kohlhoff dot com)
- /
- / Distributed under the Boost Software License, Version 1.0. (See accompanying
- / file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
- /]
-
-[section:IteratorConnectHandler Iterator connect handler requirements]
-
-An iterator connect handler must meet the requirements for a [link
-asio.reference.Handler handler]. A value `h` of an iterator connect handler
-class should work correctly in the expression `h(ec, i)`, where `ec` is an
-lvalue of type `const error_code` and `i` is an lvalue of the type `Iterator`
-used in the corresponding `connect()` or async_connect()` function.
-
-[heading Examples]
-
-A free function as an iterator connect handler:
-
-  void connect_handler(
-      const asio::error_code& ec,
-      asio::ip::tcp::resolver::iterator iterator)
-  {
-    ...
-  }
-
-An iterator connect handler function object:
-
-  struct connect_handler
-  {
-    ...
-    template <typename Iterator>
-    void operator()(
-        const asio::error_code& ec,
-        Iterator iterator)
-    {
-      ...
-    }
-    ...
-  };
-
-A lambda as an iterator connect handler:
-
-  asio::async_connect(...,
-      [](const asio::error_code& ec,
-        asio::ip::tcp::resolver::iterator iterator)
-      {
-        ...
-      });
-
-A non-static class member function adapted to an iterator connect handler using
-`std::bind()`:
-
-  void my_class::connect_handler(
-      const asio::error_code& ec,
-      asio::ip::tcp::resolver::iterator iterator)
-  {
-    ...
-  }
-  ...
-  asio::async_connect(...,
-      std::bind(&my_class::connect_handler,
-        this, std::placeholders::_1,
-        std::placeholders::_2));
-
-A non-static class member function adapted to an iterator connect handler using
-`boost::bind()`:
-
-  void my_class::connect_handler(
-      const asio::error_code& ec,
-      asio::ip::tcp::resolver::iterator iterator)
-  {
-    ...
-  }
-  ...
-  asio::async_connect(...,
-      boost::bind(&my_class::connect_handler,
-        this, asio::placeholders::error,
-        asio::placeholders::iterator));
-
-[endsect]

data/ext/third_party/asio/asio/src/doc/requirements/LegacyCompletionHandler.qbk

@@ -1,65 +0,0 @@
-[/
- / Copyright (c) 2003-2020 Christopher M. Kohlhoff (chris at kohlhoff dot com)
- /
- / Distributed under the Boost Software License, Version 1.0. (See accompanying
- / file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
- /]
-
-[section:LegacyCompletionHandler Legacy completion handler requirements]
-
-A legacy completion handler must meet the requirements for a [link
-asio.reference.Handler handler]. A legacy completion handler must meet the
-requirements of `CopyConstructible` types (C++Std [copyconstructible]). A value
-`h` of a completion handler class should work correctly in the expression
-`h()`.
-
-[heading Examples]
-
-A free function as a completion handler:
-
-  void completion_handler()
-  {
-    ...
-  }
-
-A completion handler function object:
-
-  struct completion_handler
-  {
-    ...
-    void operator()()
-    {
-      ...
-    }
-    ...
-  };
-
-A lambda as a completion handler:
-
-  my_io_service.post(
-      []()
-      {
-        ...
-      });
-
-A non-static class member function adapted to a completion handler using
-`std::bind()`:
-
-  void my_class::completion_handler()
-  {
-    ...
-  }
-  ...
-  my_io_service.post(std::bind(&my_class::completion_handler, this));
-
-A non-static class member function adapted to a completion handler using
-`boost::bind()`:
-
-  void my_class::completion_handler()
-  {
-    ...
-  }
-  ...
-  my_io_service.post(boost::bind(&my_class::completion_handler, this));
-
-[endsect]

data/ext/third_party/asio/asio/src/doc/requirements/MoveAcceptHandler.qbk

@@ -1,61 +0,0 @@
-[/
- / Copyright (c) 2003-2020 Christopher M. Kohlhoff (chris at kohlhoff dot com)
- /
- / Distributed under the Boost Software License, Version 1.0. (See accompanying
- / file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
- /]
-
-[section:MoveAcceptHandler Move accept handler requirements]
-
-A move accept handler must meet the requirements for a [link
-asio.reference.Handler handler]. A value `h` of a move accept handler class
-should work correctly in the expression `h(ec, s)`, where `ec` is an lvalue of
-type `const error_code` and `s` is an lvalue of the nested type
-`Protocol::socket` for the type `Protocol` of the socket class template.
-
-[heading Examples]
-
-A free function as a move accept handler:
-
-  void accept_handler(
-      const asio::error_code& ec, asio::ip::tcp::socket s)
-  {
-    ...
-  }
-
-A move accept handler function object:
-
-  struct accept_handler
-  {
-    ...
-    void operator()(
-        const asio::error_code& ec, asio::ip::tcp::socket s)
-    {
-      ...
-    }
-    ...
-  };
-
-A lambda as a move accept handler:
-
-  acceptor.async_accept(...,
-      [](const asio::error_code& ec, asio::ip::tcp::socket s)
-      {
-        ...
-      });
-
-A non-static class member function adapted to a move accept handler using
-`std::bind()`:
-
-  void my_class::accept_handler(
-      const asio::error_code& ec, asio::ip::tcp::socket socket)
-  {
-    ...
-  }
-  ...
-  asio::async_accept(...,
-      std::bind(&my_class::accept_handler,
-        this, std::placeholders::_1,
-        std::placeholders::_2));
-
-[endsect]

data/ext/third_party/asio/asio/src/doc/requirements/MutableBufferSequence.qbk

@@ -1,54 +0,0 @@
-[/
- / Copyright (c) 2003-2020 Christopher M. Kohlhoff (chris at kohlhoff dot com)
- /
- / Distributed under the Boost Software License, Version 1.0. (See accompanying
- / file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
- /]
-
-[section:MutableBufferSequence Mutable buffer sequence requirements]
-
-A ['mutable buffer sequence] represents a set of memory regions that may be
-used to receive the output of an operation, such as the `receive` operation of
-a socket.
-
-A type `X` meets the `MutableBufferSequence` requirements if it satisfies the
-requirements of `Destructible` (C++Std [destructible]) and
-`CopyConstructible` (C++Std [copyconstructible]), as well as the additional
-requirements listed below.
-
-In the table below, `x` denotes a (possibly const) value of type `X`, and `u`
-denotes an identifier.
-
-[table MutableBufferSequence requirements
-  [[expression] [return type] [assertion/note[br]pre/post-condition]]
-  [
-    [`asio::buffer_sequence_begin(x)`[br]
-     `asio::buffer_sequence_end(x)`]
-    [An iterator type meeting the requirements for bidirectional iterators
-     (C++Std \[bidirectional.iterators\]) whose value type is convertible to
-     `mutable_buffer`.]
-    []
-  ]
-  [
-    [``
-      X u(x);
-    ``]
-    []
-    [post:[br]
-     ``
-       equal(
-         asio::buffer_sequence_begin(x),
-         asio::buffer_sequence_end(x),
-         asio::buffer_sequence_begin(u),
-         asio::buffer_sequence_end(u),
-         [](const mutable_buffer& b1,
-            const mutable_buffer& b2)
-          {
-            return b1.data() == b2.data()
-                && b1.size() == b2.size();
-          })
-     ``]
-  ]
-]
-
-[endsect]

data/ext/third_party/asio/asio/src/doc/requirements/ProtoAllocator.qbk

@@ -1,19 +0,0 @@
-[/
- / Copyright (c) 2003-2020 Christopher M. Kohlhoff (chris at kohlhoff dot com)
- /
- / Distributed under the Boost Software License, Version 1.0. (See accompanying
- / file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
- /]
-
-[section:ProtoAllocator Proto-allocator requirements]
-
-A type `A` meets the proto-allocator requirements if `A` is `CopyConstructible`
-(C++Std [copyconstructible]), `Destructible` (C++Std [destructible]), and
-`allocator_traits<A>::rebind_alloc<U>` meets the allocator requirements (C++Std
-[allocator.requirements]), where `U` is an object type. [inline_note For
-example, `std::allocator<void>` meets the proto-allocator requirements but not
-the allocator requirements.] No constructor, comparison operator, copy
-operation, move operation, or swap operation on these types shall exit via an
-exception.
-
-[endsect]

data/ext/third_party/asio/asio/src/doc/requirements/Protocol.qbk

@@ -1,56 +0,0 @@
-[/
- / Copyright (c) 2003-2020 Christopher M. Kohlhoff (chris at kohlhoff dot com)
- /
- / Distributed under the Boost Software License, Version 1.0. (See accompanying
- / file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
- /]
-
-[section:Protocol Protocol requirements]
-
-A type `X` meets the `Protocol` requirements if it satisfies the requirements
-of `Destructible` (C++Std [destructible]), `CopyConstructible` (C++Std
-[copyconstructible]), and `CopyAssignable` (C++Std [copyassignable]), as well
-as the additional requirements listed below.
-
-No copy or move operation of the type `X` shall exit via an exception.
-
-[table Protocol requirements
-  [[expression] [return type] [assertion/note[br]pre/post-conditions]]
-  [
-    [`X::endpoint`]
-    [type meeting [link asio.reference.Endpoint endpoint] requirements]
-    []
-  ]
-]
-
-In the table below, `a` denotes a (possibly const) value of type `X`.
-
-[table Protocol requirements for extensible implementations
-  [[expression] [return type] [assertion/note[br]pre/post-conditions]]
-  [
-    [`a.family()`]
-    [`int`]
-    [
-      Returns a value suitable for passing as the /domain/ argument to
-      __POSIX__ __socket__ (or equivalent).
-    ]
-  ]
-  [
-    [`a.type()`]
-    [`int`]
-    [
-      Returns a value suitable for passing as the /type/ argument to __POSIX__
-      __socket__ (or equivalent).
-    ]
-  ]
-  [
-    [`a.protocol()`]
-    [`int`]
-    [
-      Returns a value suitable for passing as the /protocol/ argument to
-      __POSIX__ __socket__ (or equivalent).
-    ]
-  ]
-]
-
-[endsect]

data/ext/third_party/asio/asio/src/doc/requirements/RangeConnectHandler.qbk

@@ -1,82 +0,0 @@
-[/
- / Copyright (c) 2003-2020 Christopher M. Kohlhoff (chris at kohlhoff dot com)
- /
- / Distributed under the Boost Software License, Version 1.0. (See accompanying
- / file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
- /]
-
-[section:RangeConnectHandler Range connect handler requirements]
-
-A range connect handler must meet the requirements for a [link
-asio.reference.Handler handler]. A value `h` of a range connect handler class
-should work correctly in the expression `h(ec, ep)`, where `ec` is an lvalue of
-type `const error_code` and `ep` is an lvalue of the type `Protocol::endpoint`
-for the `Protocol` type in the corresponding `connect()` or async_connect()`
-function.
-
-[heading Examples]
-
-A free function as a range connect handler:
-
-  void connect_handler(
-      const asio::error_code& ec,
-      const asio::ip::tcp::endpoint& endpoint)
-  {
-    ...
-  }
-
-A range connect handler function object:
-
-  struct connect_handler
-  {
-    ...
-    template <typename Range>
-    void operator()(
-        const asio::error_code& ec,
-        const asio::ip::tcp::endpoint& endpoint)
-    {
-      ...
-    }
-    ...
-  };
-
-A lambda as a range connect handler:
-
-  asio::async_connect(...,
-      [](const asio::error_code& ec,
-        const asio::ip::tcp::endpoint& endpoint)
-      {
-        ...
-      });
-
-A non-static class member function adapted to a range connect handler using
-`std::bind()`:
-
-  void my_class::connect_handler(
-      const asio::error_code& ec,
-      const asio::ip::tcp::endpoint& endpoint)
-  {
-    ...
-  }
-  ...
-  asio::async_connect(...,
-      std::bind(&my_class::connect_handler,
-        this, std::placeholders::_1,
-        std::placeholders::_2));
-
-A non-static class member function adapted to a range connect handler using
-`boost::bind()`:
-
-  void my_class::connect_handler(
-      const asio::error_code& ec,
-      const asio::ip::tcp::endpoint& endpoint)
-  {
-    ...
-  }
-  ...
-  asio::async_connect(...,
-      boost::bind(&my_class::connect_handler,
-        this, asio::placeholders::error,
-        asio::placeholders::endpoint));
-
-[endsect]