couchbase 3.0.0-universal-darwin-19 → 3.0.1-universal-darwin-19

data/ext/third_party/asio/asio/src/doc/overview/async_op2.dot

@@ -1,78 +0,0 @@
-digraph g
-{
-  graph
-    [
-      nodesep="0.2"
-    ];
-
-  edge
-    [
-      fontname="Helvetica",
-      fontsize=10,
-      labelfontname="Helvetica",
-      labelfontsize=10
-    ];
-
-  node
-    [
-      fontname="Helvetica",
-      fontsize=10,
-      shape=box
-    ];
-
-  edge
-    [
-      arrowhead="open"
-    ]
-
-  // Program elements.
-  {
-    operating_system [ label="Operating System", shape=ellipse ];
-    io_context [ label="io_context" ];
-    io_object [ label="I/O Object\ne.g. socket" ];
-    your_program [ label="Your Program" ];
-    your_completion_handler [ label="Your Completion Handler" ];
-  }
-
-  // Owning relationships.
-  {
-    edge [ arrowtail="diamond" ];
-    your_program:e -> your_completion_handler:n;
-    your_program:w -> io_object:nw;
-    your_program:se -> io_context:ne;
-  }
-
-  // Non-owning relationships;
-  {
-    io_object:sw -> io_context:w;
-  }
-
-  // Visible actions.
-  {
-    edge [ style="dashed", color="#808080" ];
-
-    // Forward actions.
-    {
-      your_program:s -> io_context:n [ label="5" ];
-    }
-
-    // Reverse actions.
-    {
-      edge [ arrowhead="none", arrowtail="open" ];
-      io_context:s -> operating_system:n [ label="4" ];
-      your_completion_handler:s -> io_context:e [ label="6" ];
-    }
-  }
-
-  // Invisible actions.
-  {
-    edge [ style="invis" ];
-
-    // Forward actions.
-    {
-      your_program:sw -> io_object:n [ label="1" ];
-      io_object:s -> io_context:nw [ label="2" ];
-      //io_context:s -> operating_system:n [ label="3" ];
-    }
-  }
-}

data/ext/third_party/asio/asio/src/doc/overview/basics.qbk

@@ -1,106 +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:basics Basic Asio Anatomy]
-
-Asio may be used to perform both synchronous and asynchronous operations on I/O
-objects such as sockets. Before using Asio it may be useful to get a conceptual
-picture of the various parts of Asio, your program, and how they work together.
-
-As an introductory example, let's consider what happens when you perform a
-connect operation on a socket. We shall start by examining synchronous
-operations.
-
-[$sync_op.png]
-
-[*Your program] will have at least one [*io_context] object. The [*io_context]
-represents [*your program]'s link to the [*operating system]'s I/O services.
-
-  asio::io_context io_context;
-
-To perform I/O operations [*your program] will need an [*I/O object] such as a
-TCP socket:
-
-  asio::ip::tcp::socket socket(io_context);
-
-When a synchronous connect operation is performed, the following sequence of
-events occurs:
-
-1. [*Your program] initiates the connect operation by calling the [*I/O
-object]:
-
-  socket.connect(server_endpoint);
-
-2. The [*I/O object] forwards the request to the [*io_context].
-
-3. The [*io_context] calls on the [*operating system] to perform the connect
-operation.
-
-4. The [*operating system] returns the result of the operation to the
-[*io_context].
-
-5. The [*io_context] translates any error resulting from the operation into an
-object of type `asio::error_code`. An `error_code` may be compared with
-specific values, or tested as a boolean (where a `false` result means that no
-error occurred). The result is then forwarded back up to the [*I/O object].
-
-6. The [*I/O object] throws an exception of type `asio::system_error` if the
-operation failed. If the code to initiate the operation had instead been
-written as:
-
-  asio::error_code ec;
-  socket.connect(server_endpoint, ec);
-
-then the `error_code` variable `ec` would be set to the result of the
-operation, and no exception would be thrown.
-
-When an asynchronous operation is used, a different sequence of events occurs.
-
-[$async_op1.png]
-
-1. [*Your program] initiates the connect operation by calling the [*I/O
-object]:
-
-  socket.async_connect(server_endpoint, your_completion_handler);
-
-where `your_completion_handler` is a function or function object with the
-signature:
-
-  void your_completion_handler(const asio::error_code& ec);
-
-The exact signature required depends on the asynchronous operation being
-performed. The reference documentation indicates the appropriate form for each
-operation.
-
-2. The [*I/O object] forwards the request to the [*io_context].
-
-3. The [*io_context] signals to the [*operating system] that it should start an
-asynchronous connect.
-
-Time passes. (In the synchronous case this wait would have been contained
-entirely within the duration of the connect operation.)
-
-[$async_op2.png]
-
-4. The [*operating system] indicates that the connect operation has completed
-by placing the result on a queue, ready to be picked up by the [*io_context].
-
-5. [*Your program] must make a call to `io_context::run()` (or to one of the
-similar [*io_context] member functions) in order for the result to be
-retrieved. A call to `io_context::run()` blocks while there are unfinished
-asynchronous operations, so you would typically call it as soon as you have
-started your first asynchronous operation.
-
-6. While inside the call to `io_context::run()`, the [*io_context] dequeues the
-result of the operation, translates it into an `error_code`, and then passes it
-to [*your completion handler].
-
-This is a simplified picture of how Asio operates. You will want to delve
-further into the documentation if your needs are more advanced, such as
-extending Asio to perform other types of asynchronous operations.
-
-[endsect]

data/ext/third_party/asio/asio/src/doc/overview/bsd_sockets.qbk

@@ -1,270 +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:bsd_sockets The BSD Socket API and Asio]
-
-The Asio library includes a low-level socket interface based on the BSD socket
-API, which is widely implemented and supported by extensive literature. It is
-also used as the basis for networking APIs in other languages, like Java. This
-low-level interface is designed to support the development of efficient and
-scalable applications. For example, it permits programmers to exert finer
-control over the number of system calls, avoid redundant data copying, minimise
-the use of resources like threads, and so on.
-
-Unsafe and error prone aspects of the BSD socket API are not included. For
-example, the use of `int` to represent all sockets lacks type safety. The
-socket representation in Asio uses a distinct type for each protocol, e.g. for
-TCP one would use `ip::tcp::socket`, and for UDP one uses `ip::udp::socket`.
-
-The following table shows the mapping between the BSD socket API and Asio:
-
-[table
-  [
-    [BSD Socket API Elements]
-    [Equivalents in Asio]
-  ]
-  [
-    [socket descriptor - `int` (POSIX) or `SOCKET` (Windows)]
-    [ For TCP: [link asio.reference.ip__tcp.socket ip::tcp::socket],
-               [link asio.reference.ip__tcp.acceptor ip::tcp::acceptor]
-
-      For UDP: [link asio.reference.ip__udp.socket ip::udp::socket]
-
-               [link asio.reference.basic_socket basic_socket],
-               [link asio.reference.basic_stream_socket basic_stream_socket],
-               [link asio.reference.basic_datagram_socket basic_datagram_socket],
-               [link asio.reference.basic_raw_socket basic_raw_socket] ]
-  ]
-  [
-    [`in_addr`,
-     `in6_addr`]
-    [          [link asio.reference.ip__address ip::address],
-               [link asio.reference.ip__address ip::address_v4],
-               [link asio.reference.ip__address ip::address_v6] ]
-  ]
-  [
-    [`sockaddr_in`,
-     `sockaddr_in6`]
-    [ For TCP: [link asio.reference.ip__tcp.endpoint ip::tcp::endpoint]
-    
-      For UDP: [link asio.reference.ip__udp.endpoint ip::udp::endpoint]
-
-               [link asio.reference.ip__basic_endpoint ip::basic_endpoint] ]
-  ]
-  [
-    [`accept()`]
-    [ For TCP: [link asio.reference.basic_socket_acceptor.accept ip::tcp::acceptor::accept()]
-
-               [link asio.reference.basic_socket_acceptor.accept basic_socket_acceptor::accept()] ]
-  ]
-  [
-    [`bind()`]
-    [ For TCP: [link asio.reference.basic_socket.bind ip::tcp::acceptor::bind()],
-               [link asio.reference.basic_socket.bind ip::tcp::socket::bind()]
-
-      For UDP: [link asio.reference.basic_socket.bind ip::udp::socket::bind()]
-
-               [link asio.reference.basic_socket.bind basic_socket::bind()] ]
-  ]
-  [
-    [`close()`]
-    [ For TCP: [link asio.reference.basic_socket.close ip::tcp::acceptor::close()],
-               [link asio.reference.basic_socket.close ip::tcp::socket::close()]
-
-      For UDP: [link asio.reference.basic_socket.close ip::udp::socket::close()]
-
-               [link asio.reference.basic_socket.close basic_socket::close()] ]
-  ]
-  [
-    [`connect()`]
-    [ For TCP: [link asio.reference.basic_socket.connect ip::tcp::socket::connect()]
-
-      For UDP: [link asio.reference.basic_socket.connect ip::udp::socket::connect()]
-
-               [link asio.reference.basic_socket.connect basic_socket::connect()] ]
-  ]
-  [
-    [`getaddrinfo()`,
-     `gethostbyaddr()`,
-     `gethostbyname()`,
-     `getnameinfo()`,
-     `getservbyname()`,
-     `getservbyport()`]
-    [ For TCP: [link asio.reference.ip__basic_resolver.resolve ip::tcp::resolver::resolve()],
-               [link asio.reference.ip__basic_resolver.async_resolve ip::tcp::resolver::async_resolve()]
-
-      For UDP: [link asio.reference.ip__basic_resolver.resolve ip::udp::resolver::resolve()],
-               [link asio.reference.ip__basic_resolver.async_resolve ip::udp::resolver::async_resolve()]
-
-               [link asio.reference.ip__basic_resolver.resolve ip::basic_resolver::resolve()],
-               [link asio.reference.ip__basic_resolver.async_resolve ip::basic_resolver::async_resolve()] ]
-  ]
-  [
-    [`gethostname()`]
-    [          [link asio.reference.ip__host_name ip::host_name()] ]
-  ]
-  [
-    [`getpeername()`]
-    [ For TCP: [link asio.reference.basic_socket.remote_endpoint ip::tcp::socket::remote_endpoint()]
-
-      For UDP: [link asio.reference.basic_socket.remote_endpoint ip::udp::socket::remote_endpoint()]
-
-               [link asio.reference.basic_socket.remote_endpoint basic_socket::remote_endpoint()] ]
-  ]
-  [
-    [`getsockname()`]
-    [ For TCP: [link asio.reference.basic_socket.local_endpoint ip::tcp::acceptor::local_endpoint()],
-               [link asio.reference.basic_socket.local_endpoint ip::tcp::socket::local_endpoint()]
-
-      For UDP: [link asio.reference.basic_socket.local_endpoint ip::udp::socket::local_endpoint()]
-
-               [link asio.reference.basic_socket.local_endpoint basic_socket::local_endpoint()] ]
-  ]
-  [
-    [`getsockopt()`]
-    [ For TCP: [link asio.reference.basic_socket.get_option ip::tcp::acceptor::get_option()],
-               [link asio.reference.basic_socket.get_option ip::tcp::socket::get_option()]
-
-      For UDP: [link asio.reference.basic_socket.get_option ip::udp::socket::get_option()]
-
-               [link asio.reference.basic_socket.get_option basic_socket::get_option()] ]
-  ]
-  [
-    [`inet_addr()`,
-     `inet_aton()`,
-     `inet_pton()`]
-    [          [link asio.reference.ip__address.from_string ip::address::from_string()],
-               [link asio.reference.ip__address.from_string ip::address_v4::from_string()],
-               [link asio.reference.ip__address.from_string ip_address_v6::from_string()] ]
-  ]
-  [
-    [`inet_ntoa()`,
-     `inet_ntop()`]
-    [          [link asio.reference.ip__address.to_string ip::address::to_string()],
-               [link asio.reference.ip__address.to_string ip::address_v4::to_string()],
-               [link asio.reference.ip__address.to_string ip_address_v6::to_string()] ]
-  ]
-  [
-    [`ioctl()`]
-    [ For TCP: [link asio.reference.basic_socket.io_control ip::tcp::socket::io_control()]
-
-      For UDP: [link asio.reference.basic_socket.io_control ip::udp::socket::io_control()]
-
-               [link asio.reference.basic_socket.io_control basic_socket::io_control()] ]
-  ]
-  [
-    [`listen()`]
-    [ For TCP: [link asio.reference.basic_socket_acceptor.listen ip::tcp::acceptor::listen()]
-
-               [link asio.reference.basic_socket_acceptor.listen basic_socket_acceptor::listen()] ]
-  ]
-  [
-    [`poll()`,
-     `select()`,
-     `pselect()`]
-    [          [link asio.reference.io_context.run io_context::run()],
-               [link asio.reference.io_context.run_one io_context::run_one()],
-               [link asio.reference.io_context.poll io_context::poll()],
-               [link asio.reference.io_context.poll_one io_context::poll_one()]
-
-      Note: in conjunction with asynchronous operations. ]
-  ]
-  [
-    [`readv()`,
-     `recv()`,
-     `read()`]
-    [ For TCP: [link asio.reference.basic_stream_socket.read_some ip::tcp::socket::read_some()],
-               [link asio.reference.basic_stream_socket.async_read_some ip::tcp::socket::async_read_some()],
-               [link asio.reference.basic_stream_socket.receive ip::tcp::socket::receive()],
-               [link asio.reference.basic_stream_socket.async_receive ip::tcp::socket::async_receive()]
-
-      For UDP: [link asio.reference.basic_datagram_socket.receive ip::udp::socket::receive()],
-               [link asio.reference.basic_datagram_socket.async_receive ip::udp::socket::async_receive()]
-
-               [link asio.reference.basic_stream_socket.read_some basic_stream_socket::read_some()],
-               [link asio.reference.basic_stream_socket.async_read_some basic_stream_socket::async_read_some()],
-               [link asio.reference.basic_stream_socket.receive basic_stream_socket::receive()],
-               [link asio.reference.basic_stream_socket.async_receive basic_stream_socket::async_receive()],
-               [link asio.reference.basic_datagram_socket.receive basic_datagram_socket::receive()],
-               [link asio.reference.basic_datagram_socket.async_receive basic_datagram_socket::async_receive()] ]
-  ]
-  [
-    [`recvfrom()`]
-    [ For UDP: [link asio.reference.basic_datagram_socket.receive_from ip::udp::socket::receive_from()],
-               [link asio.reference.basic_datagram_socket.async_receive_from ip::udp::socket::async_receive_from()]
-
-               [link asio.reference.basic_datagram_socket.receive_from basic_datagram_socket::receive_from()],
-               [link asio.reference.basic_datagram_socket.async_receive_from basic_datagram_socket::async_receive_from()] ]
-  ]
-  [
-    [`send()`,
-     `write()`,
-     `writev()`]
-    [ For TCP: [link asio.reference.basic_stream_socket.write_some ip::tcp::socket::write_some()],
-               [link asio.reference.basic_stream_socket.async_write_some ip::tcp::socket::async_write_some()],
-               [link asio.reference.basic_stream_socket.send ip::tcp::socket::send()],
-               [link asio.reference.basic_stream_socket.async_send ip::tcp::socket::async_send()]
-
-      For UDP: [link asio.reference.basic_datagram_socket.send ip::udp::socket::send()],
-               [link asio.reference.basic_datagram_socket.async_send ip::udp::socket::async_send()]
-
-               [link asio.reference.basic_stream_socket.write_some basic_stream_socket::write_some()],
-               [link asio.reference.basic_stream_socket.async_write_some basic_stream_socket::async_write_some()],
-               [link asio.reference.basic_stream_socket.send basic_stream_socket::send()],
-               [link asio.reference.basic_stream_socket.async_send basic_stream_socket::async_send()],
-               [link asio.reference.basic_datagram_socket.send basic_datagram_socket::send()],
-               [link asio.reference.basic_datagram_socket.async_send basic_datagram_socket::async_send()] ]
-  ]
-  [
-    [`sendto()`]
-    [ For UDP: [link asio.reference.basic_datagram_socket.send_to ip::udp::socket::send_to()],
-               [link asio.reference.basic_datagram_socket.async_send_to ip::udp::socket::async_send_to()]
-
-               [link asio.reference.basic_datagram_socket.send_to basic_datagram_socket::send_to()],
-               [link asio.reference.basic_datagram_socket.async_send_to basic_datagram_socket::async_send_to()] ]
-  ]
-  [
-    [`setsockopt()`]
-    [ For TCP: [link asio.reference.basic_socket.set_option ip::tcp::acceptor::set_option()],
-               [link asio.reference.basic_socket.set_option ip::tcp::socket::set_option()]
-
-      For UDP: [link asio.reference.basic_socket.set_option ip::udp::socket::set_option()]
-
-               [link asio.reference.basic_socket.set_option basic_socket::set_option()] ]
-  ]
-  [
-    [`shutdown()`]
-    [ For TCP: [link asio.reference.basic_socket.shutdown ip::tcp::socket::shutdown()]
-
-      For UDP: [link asio.reference.basic_socket.shutdown ip::udp::socket::shutdown()]
-
-               [link asio.reference.basic_socket.shutdown basic_socket::shutdown()] ]
-  ]
-  [
-    [`sockatmark()`]
-    [ For TCP: [link asio.reference.basic_socket.at_mark ip::tcp::socket::at_mark()]
-
-               [link asio.reference.basic_socket.at_mark basic_socket::at_mark()] ]
-  ]
-  [
-    [`socket()`]
-    [ For TCP: [link asio.reference.basic_socket.open ip::tcp::acceptor::open()],
-               [link asio.reference.basic_socket.open ip::tcp::socket::open()]
-
-      For UDP: [link asio.reference.basic_socket.open ip::udp::socket::open()]
-
-               [link asio.reference.basic_socket.open basic_socket::open()] ]
-  ]
-  [
-    [`socketpair()`]
-    [          [link asio.reference.local__connect_pair local::connect_pair()]
-
-      Note: POSIX operating systems only. ]
-  ]
-]
-
-[endsect]