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

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

@@ -1,79 +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:ReadHandler Read handler requirements]
-
-A read handler must meet the requirements for a [link
-asio.reference.Handler handler]. A value `h` of a read 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 type `const size_t`.
-
-[heading Examples]
-
-A free function as a read handler:
-
-  void read_handler(
-      const asio::error_code& ec,
-      std::size_t bytes_transferred)
-  {
-    ...
-  }
-
-A read handler function object:
-
-  struct read_handler
-  {
-    ...
-    void operator()(
-        const asio::error_code& ec,
-        std::size_t bytes_transferred)
-    {
-      ...
-    }
-    ...
-  };
-
-A lambda as a read handler:
-
-  socket.async_read(...
-      [](const asio::error_code& ec,
-        std::size_t bytes_transferred)
-      {
-        ...
-      });
-
-A non-static class member function adapted to a read handler using
-`std::bind()`:
-
-  void my_class::read_handler(
-      const asio::error_code& ec,
-      std::size_t bytes_transferred)
-  {
-    ...
-  }
-  ...
-  socket.async_read(...,
-      std::bind(&my_class::read_handler,
-        this, std::placeholders::_1,
-        std::placeholders::_2));
-
-A non-static class member function adapted to a read handler using
-`boost::bind()`:
-
-  void my_class::read_handler(
-      const asio::error_code& ec,
-      std::size_t bytes_transferred)
-  {
-    ...
-  }
-  ...
-  socket.async_read(...,
-      boost::bind(&my_class::read_handler,
-        this, asio::placeholders::error,
-        asio::placeholders::bytes_transferred));
-
-[endsect]

data/ext/third_party/asio/asio/src/doc/requirements/ResolveHandler.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:ResolveHandler Resolve handler requirements]
-
-A resolve handler must meet the requirements for a [link asio.reference.Handler
-handler]. A value `h` of a resolve handler class should work correctly in the
-expression `h(ec, r)`, where `ec` is an lvalue of type `const error_code` and
-`r` is an lvalue of type `const ip::basic_resolver_results<InternetProtocol>`.
-`InternetProtocol` is the template parameter of the [link
-asio.reference.ip__basic_resolver `ip::basic_resolver<>`] which is used to
-initiate the asynchronous operation.
-
-[heading Examples]
-
-A free function as a resolve handler:
-
-  void resolve_handler(
-      const asio::error_code& ec,
-      asio::ip::tcp::resolver::results_type results)
-  {
-    ...
-  }
-
-A resolve handler function object:
-
-  struct resolve_handler
-  {
-    ...
-    void operator()(
-        const asio::error_code& ec,
-        asio::ip::tcp::resolver::results_type results)
-    {
-      ...
-    }
-    ...
-  };
-
-A lambda as a resolve handler:
-
-  resolver.async_resolve(...,
-      [](const asio::error_code& ec,
-        asio::ip::tcp::resolver::results_type results)
-      {
-        ...
-      });
-
-A non-static class member function adapted to a resolve handler using
-`std::bind()`:
-
-  void my_class::resolve_handler(
-      const asio::error_code& ec,
-      asio::ip::tcp::resolver::results_type results)
-  {
-    ...
-  }
-  ...
-  resolver.async_resolve(...,
-      std::bind(&my_class::resolve_handler,
-        this, std::placeholders::_1,
-        std::placeholders::_2));
-
-A non-static class member function adapted to a resolve handler using
-`boost::bind()`:
-
-  void my_class::resolve_handler(
-      const asio::error_code& ec,
-      asio::ip::tcp::resolver::results_type results)
-  {
-    ...
-  }
-  ...
-  resolver.async_resolve(...,
-      boost::bind(&my_class::resolve_handler,
-        this, asio::placeholders::error,
-        asio::placeholders::results));
-
-[endsect]

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

@@ -1,40 +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:Service Service requirements]
-
-A class is a ['service] if it is publicly and unambiguously derived from
-`execution_context::service`, or if it is publicly and unambiguously derived
-from another service. For a service `S`, `S::key_type` shall be valid and
-denote a type (C++Std [temp.deduct]), `is_base_of_v<typename S::key_type, S>`
-shall be `true`, and `S` shall satisfy the `Destructible` requirements (C++Std
-[destructible]).
-
-The first parameter of all service constructors shall be an lvalue reference to
-`execution_context`. This parameter denotes the `execution_context` object that
-represents a set of services, of which the service object will be a member.
-[inline_note These constructors may be called by the `make_service` function.]
-
-A service shall provide an explicit constructor with a single parameter of
-lvalue reference to `execution_context`. [inline_note This constructor may be
-called by the `use_service` function.]
-
-  class my_service : public execution_context::service
-  {
-  public:
-    typedef my_service key_type;
-    explicit my_service(execution_context& ctx);
-    my_service(execution_context& ctx, int some_value);
-  private:
-    virtual void shutdown() noexcept override;
-    ...
-  };
-
-A service's `shutdown` member function shall destroy all copies of user-defined
-function objects that are held by the service.
-
-[endsect]

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

@@ -1,33 +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:SettableSerialPortOption Settable serial port option requirements]
-
-In the table below, `X` denotes a serial port option class, `a` denotes a value
-of `X`, `ec` denotes a value of type `error_code`, and `s` denotes a value of
-implementation-defined type ['[^storage]] (where ['[^storage]] is the type
-`DCB` on Windows and `termios` on __POSIX__ platforms), and `u` denotes an
-identifier.
-
-[table SettableSerialPortOption requirements
-  [[expression] [type] [assertion/note[br]pre/post-conditions]]
-  [
-    [
-      `const X& u = a;`[br]
-      `u.store(s, ec);`
-    ]
-    [`error_code`]
-    [
-      Saves the value of the serial port option to the storage.[br]
-      [br]
-      If successful, sets `ec` such that `!ec` is true. If an error occurred,
-      sets `ec` such that `!!ec` is true. Returns `ec`.
-    ]
-  ]
-]
-
-[endsect]

data/ext/third_party/asio/asio/src/doc/requirements/SettableSocketOption.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:SettableSocketOption Settable socket option requirements]
-
-A type `X` meets the `SettableSocketOption` requirements if it satisfies the
-requirements listed below.
-
-In the table below, `a` denotes a (possibly const) value of type `X`, `p`
-denotes a (possibly const) value that meets the [link asio.reference.Protocol
-`Protocol`] requirements, and `u` denotes an identifier.
-
-[table SettableSocketOption requirements for extensible implementations
-  [[expression] [type] [assertion/note[br]pre/post-conditions]]
-  [
-    [`a.level(p)`]
-    [`int`]
-    [
-      Returns a value suitable for passing as the /level/ argument to __POSIX__
-      __setsockopt__ (or equivalent).
-    ]
-  ]
-  [
-    [`a.name(p)`]
-    [`int`]
-    [
-      Returns a value suitable for passing as the /option_name/ argument to
-      __POSIX__ __setsockopt__ (or equivalent).
-    ]
-  ]
-  [
-    [`a.data(p)`]
-    [`const void*`]
-    [
-      Returns a pointer suitable for passing as the /option_value/ argument to
-      __POSIX__ __setsockopt__ (or equivalent).
-    ]
-  ]
-  [
-    [`a.size(p)`]
-    [`size_t`]
-    [
-      Returns a value suitable for passing as the /option_len/ argument to
-      __POSIX__ __setsockopt__ (or equivalent), after appropriate integer
-      conversion has been performed.
-    ]
-  ]
-]
-
-[endsect]

data/ext/third_party/asio/asio/src/doc/requirements/ShutdownHandler.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:ShutdownHandler SSL shutdown handler requirements]
-
-A shutdown handler must meet the requirements for a [link
-asio.reference.Handler handler]. A value `h` of a shutdown 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 shutdown handler:
-
-  void shutdown_handler(
-      const asio::error_code& ec)
-  {
-    ...
-  }
-
-A shutdown handler function object:
-
-  struct shutdown_handler
-  {
-    ...
-    void operator()(
-        const asio::error_code& ec)
-    {
-      ...
-    }
-    ...
-  };
-
-A lambda as a shutdown handler:
-
-  ssl_stream.async_shutdown(...,
-      [](const asio::error_code& ec)
-      {
-        ...
-      });
-
-A non-static class member function adapted to a shutdown handler using
-`std::bind()`:
-
-  void my_class::shutdown_handler(
-      const asio::error_code& ec)
-  {
-    ...
-  }
-  ...
-  ssl_stream.async_shutdown(
-      std::bind(&my_class::shutdown_handler,
-        this, std::placeholders::_1));
-
-A non-static class member function adapted to a shutdown handler using
-`boost::bind()`:
-
-  void my_class::shutdown_handler(
-      const asio::error_code& ec)
-  {
-    ...
-  }
-  ...
-  ssl_stream.async_shutdown(
-      boost::bind(&my_class::shutdown_handler,
-        this, asio::placeholders::error));
-
-[endsect]

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

@@ -1,79 +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:SignalHandler Signal handler requirements]
-
-A signal handler must meet the requirements for a [link
-asio.reference.Handler handler]. A value `h` of a signal handler class
-should work correctly in the expression `h(ec, n)`, where `ec` is an lvalue of
-type `const error_code` and `n` is an lvalue of type `const int`.
-
-[heading Examples]
-
-A free function as a signal handler:
-
-  void signal_handler(
-      const asio::error_code& ec,
-      int signal_number)
-  {
-    ...
-  }
-
-A signal handler function object:
-
-  struct signal_handler
-  {
-    ...
-    void operator()(
-        const asio::error_code& ec,
-        int signal_number)
-    {
-      ...
-    }
-    ...
-  };
-
-A lambda as a signal handler:
-
-  my_signal_set.async_wait(
-      [](const asio::error_code& ec,
-        int signal_number)
-      {
-        ...
-      });
-
-A non-static class member function adapted to a signal handler using
-`std::bind()`:
-
-  void my_class::signal_handler(
-      const asio::error_code& ec,
-      int signal_number)
-  {
-    ...
-  }
-  ...
-  my_signal_set.async_wait(
-      std::bind(&my_class::signal_handler,
-        this, std::placeholders::_1,
-        std::placeholders::_2));
-
-A non-static class member function adapted to a signal handler using
-`boost::bind()`:
-
-  void my_class::signal_handler(
-      const asio::error_code& ec,
-      int signal_number)
-  {
-    ...
-  }
-  ...
-  my_signal_set.async_wait(
-      boost::bind(&my_class::signal_handler,
-        this, asio::placeholders::error,
-        asio::placeholders::signal_number));
-
-[endsect]

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

@@ -1,49 +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:SyncRandomAccessReadDevice Buffer-oriented synchronous random-access
-read device requirements]
-
-In the table below, `a` denotes a synchronous random-access read device object,
-`o` denotes an offset of type `boost::uint64_t`, `mb` denotes an object
-satisfying [link asio.reference.MutableBufferSequence mutable buffer sequence]
-requirements, and `ec` denotes an object of type `error_code`.
-
-[table Buffer-oriented synchronous random-access read device requirements
-  [[operation] [type] [semantics, pre/post-conditions]]
-  [
-    [`a.read_some_at(o, mb);`]
-    [`size_t`]
-    [Equivalent to:
-     ``
-       error_code ec;
-       size_t s = a.read_some_at(o, mb, ec);
-       if (ec) throw system_error(ec);
-       return s;
-     ``]
-  ]
-  [
-    [`a.read_some_at(o, mb, ec);`]
-    [`size_t`]
-    [
-      Reads one or more bytes of data from the device `a` at offset `o`.[br]
-      [br]
-      The mutable buffer sequence `mb` specifies memory where the data should
-      be placed. The `read_some_at` operation shall always fill a buffer in the
-      sequence completely before proceeding to the next.[br]
-      [br]
-      If successful, returns the number of bytes read and sets `ec` such that
-      `!ec` is true. If an error occurred, returns `0` and sets `ec` such that
-      `!!ec` is true.[br]
-      [br]
-      If the total size of all buffers in the sequence `mb` is `0`, the
-      function shall return `0` immediately.
-    ]
-  ]
-]
-
-[endsect]

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

@@ -1,49 +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:SyncRandomAccessWriteDevice Buffer-oriented synchronous random-access
-write device requirements]
-
-In the table below, `a` denotes a synchronous random-access write device
-object, `o` denotes an offset of type `boost::uint64_t`, `cb` denotes an object
-satisfying [link asio.reference.ConstBufferSequence constant buffer sequence]
-requirements, and `ec` denotes an object of type `error_code`.
-
-[table Buffer-oriented synchronous random-access write device requirements
-  [[operation] [type] [semantics, pre/post-conditions]]
-  [
-    [`a.write_some_at(o, cb);`]
-    [`size_t`]
-    [Equivalent to:
-     ``
-       error_code ec;
-       size_t s = a.write_some(o, cb, ec);
-       if (ec) throw system_error(ec);
-       return s;
-     ``]
-  ]
-  [
-    [`a.write_some_at(o, cb, ec);`]
-    [`size_t`]
-    [
-      Writes one or more bytes of data to the device `a` at offset `o`.[br]
-      [br]
-      The constant buffer sequence `cb` specifies memory where the data to be
-      written is located. The `write_some_at` operation shall always write a
-      buffer in the sequence completely before proceeding to the next.[br]
-      [br]
-      If successful, returns the number of bytes written and sets `ec` such
-      that `!ec` is true. If an error occurred, returns `0` and sets `ec` such
-      that `!!ec` is true.[br]
-      [br]
-      If the total size of all buffers in the sequence `cb` is `0`, the
-      function shall return `0` immediately.
-    ]
-  ]
-]
-
-[endsect]

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

@@ -1,41 +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:SyncReadStream Buffer-oriented synchronous read stream requirements]
-
-A type `X` meets the `SyncReadStream` requirements if it satisfies the
-requirements listed below.
-
-In the table below, `a` denotes a value of type `X`, `mb` denotes a (possibly
-const) value satisfying the [link asio.reference.MutableBufferSequence
-`MutableBufferSequence`] requirements, and `ec` denotes an object of type
-`error_code`.
-
-[table SyncReadStream requirements
-  [[operation] [type] [semantics, pre/post-conditions]]
-  [
-    [`a.read_some(mb)`[br]
-     `a.read_some(mb,ec)`]
-    [`size_t`]
-    [
-      Meets the requirements for a [link asio.reference.read_write_operations
-      read operation].[br]
-      [br]
-      If `buffer_size(mb) > 0`, reads one or more bytes of data from the stream
-      `a` into the buffer sequence `mb`. If successful, sets `ec` such that
-      `!ec` is `true`, and returns the number of bytes read. If an error
-      occurred, sets `ec` such that `!!ec` is `true`, and returns 0. If all
-      data has been read from the stream, and the stream performed an orderly
-      shutdown, sets `ec` to `stream_errc::eof` and returns 0.[br]
-      [br]
-      If `buffer_size(mb) == 0`, the operation shall not block. Sets `ec` such
-      that `!ec` is `true`, and returns 0.
-    ]
-  ]
-]
-
-[endsect]

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

@@ -1,39 +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:SyncWriteStream Buffer-oriented synchronous write stream requirements]
-
-A type `X` meets the `SyncWriteStream` requirements if it satisfies the
-requirements listed below.
-
-In the table below, `a` denotes a value of type `X`, `cb` denotes a (possibly
-const) value satisfying the [link asio.reference.ConstBufferSequence
-`ConstBufferSequence`] requirements, and `ec` denotes an object of type
-`error_code`.
-
-[table SyncWriteStream requirements
-  [[operation] [type] [semantics, pre/post-conditions]]
-  [
-    [`a.write_some(cb)`[br]
-     `a.write_some(cb,ec)`]
-    [`size_t`]
-    [
-      Meets the requirements for a [link asio.reference.read_write_operations
-      write operation].[br]
-      [br]
-      If `buffer_size(cb) > 0`, writes one or more bytes of data to the stream
-      `a` from the buffer sequence `cb`. If successful, sets `ec` such that
-      `!ec` is `true`, and returns the number of bytes written. If an error
-      occurred, sets `ec` such that `!!ec` is `true`, and returns 0.[br]
-      [br]
-      If `buffer_size(cb) == 0`, the operation shall not block. Sets `ec` such
-      that `!ec` is `true`, and returns 0.
-    ]
-  ]
-]
-
-[endsect]

data/ext/third_party/asio/asio/src/doc/requirements/TimeTraits.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:TimeTraits Time traits requirements]
-
-In the table below, `X` denotes a time traits class for time type `Time`, `t`,
-`t1`, and `t2` denote values of type `Time`, and `d` denotes a value of type
-`X::duration_type`.
-
-[table TimeTraits requirements
-  [[expression] [return type] [assertion/note[br]pre/post-condition]]
-  [
-    [`X::time_type`]
-    [`Time`]
-    [
-      Represents an absolute time. Must support default construction, and meet
-      the requirements for `CopyConstructible` and `Assignable`.
-    ]
-  ]
-  [
-    [`X::duration_type`]
-    []
-    [
-      Represents the difference between two absolute times. Must support
-      default construction, and meet the requirements for `CopyConstructible`
-      and `Assignable`. A duration can be positive, negative, or zero.
-    ]
-  ]
-  [
-    [`X::now();`]
-    [`time_type`]
-    [
-      Returns the current time.
-    ]
-  ]
-  [
-    [`X::add(t, d);`]
-    [`time_type`]
-    [
-      Returns a new absolute time resulting from adding the duration `d` to the
-      absolute time `t`.
-    ]
-  ]
-  [
-    [`X::subtract(t1, t2);`]
-    [`duration_type`]
-    [
-      Returns the duration resulting from subtracting `t2` from `t1`.
-    ]
-  ]
-  [
-    [`X::less_than(t1, t2);`]
-    [`bool`]
-    [
-      Returns whether `t1` is to be treated as less than `t2`.
-    ]
-  ]
-  [
-    [`X::to_posix_duration(d);`]
-    [`date_time::time_duration_type`]
-    [
-      Returns the `date_time::time_duration_type` value that most closely
-      represents the duration `d`.
-    ]
-  ]
-]
-
-[endsect]