passenger 6.0.19 → 6.0.20

data/src/cxx_supportlib/vendor-modified/boost/asio/any_completion_handler.hpp

@@ -2,7 +2,7 @@
 // any_completion_handler.hpp
 // ~~~~~~~~~~~~~~~~~~~~~~~~~~
 //
-// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
+// Copyright (c) 2003-2023 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)
@@ -23,9 +23,11 @@
 #include <memory>
 #include <utility>
 #include <boost/asio/any_completion_executor.hpp>
+#include <boost/asio/any_io_executor.hpp>
 #include <boost/asio/associated_allocator.hpp>
 #include <boost/asio/associated_cancellation_slot.hpp>
 #include <boost/asio/associated_executor.hpp>
+#include <boost/asio/associated_immediate_executor.hpp>
 #include <boost/asio/cancellation_state.hpp>
 #include <boost/asio/recycling_allocator.hpp>
 
@@ -126,6 +128,13 @@ public:
         (get_associated_executor)(handler_, candidate));
   }
 
+  any_completion_executor immediate_executor(
+      const any_io_executor& candidate) const BOOST_ASIO_NOEXCEPT
+  {
+    return any_completion_executor(std::nothrow,
+        (get_associated_immediate_executor)(handler_, candidate));
+  }
+
   void* allocate(std::size_t size, std::size_t align) const
   {
     typename std::allocator_traits<
@@ -306,6 +315,36 @@ private:
   type executor_fn_;
 };
 
+class any_completion_handler_immediate_executor_fn
+{
+public:
+  using type = any_completion_executor(*)(
+      any_completion_handler_impl_base*, const any_io_executor&);
+
+  constexpr any_completion_handler_immediate_executor_fn(type fn)
+    : immediate_executor_fn_(fn)
+  {
+  }
+
+  any_completion_executor immediate_executor(
+      any_completion_handler_impl_base* impl,
+      const any_io_executor& candidate) const
+  {
+    return immediate_executor_fn_(impl, candidate);
+  }
+
+  template <typename Handler>
+  static any_completion_executor impl(any_completion_handler_impl_base* impl,
+      const any_io_executor& candidate)
+  {
+    return static_cast<any_completion_handler_impl<Handler>*>(
+        impl)->immediate_executor(candidate);
+  }
+
+private:
+  type immediate_executor_fn_;
+};
+
 class any_completion_handler_allocate_fn
 {
 public:
@@ -368,6 +407,7 @@ template <typename... Signatures>
 class any_completion_handler_fn_table
   : private any_completion_handler_destroy_fn,
     private any_completion_handler_executor_fn,
+    private any_completion_handler_immediate_executor_fn,
     private any_completion_handler_allocate_fn,
     private any_completion_handler_deallocate_fn,
     private any_completion_handler_call_fns<Signatures...>
@@ -377,11 +417,13 @@ public:
   constexpr any_completion_handler_fn_table(
       any_completion_handler_destroy_fn::type destroy_fn,
       any_completion_handler_executor_fn::type executor_fn,
+      any_completion_handler_immediate_executor_fn::type immediate_executor_fn,
       any_completion_handler_allocate_fn::type allocate_fn,
       any_completion_handler_deallocate_fn::type deallocate_fn,
       CallFns... call_fns)
     : any_completion_handler_destroy_fn(destroy_fn),
       any_completion_handler_executor_fn(executor_fn),
+      any_completion_handler_immediate_executor_fn(immediate_executor_fn),
       any_completion_handler_allocate_fn(allocate_fn),
       any_completion_handler_deallocate_fn(deallocate_fn),
       any_completion_handler_call_fns<Signatures...>(call_fns...)
@@ -390,6 +432,7 @@ public:
 
   using any_completion_handler_destroy_fn::destroy;
   using any_completion_handler_executor_fn::executor;
+  using any_completion_handler_immediate_executor_fn::immediate_executor;
   using any_completion_handler_allocate_fn::allocate;
   using any_completion_handler_deallocate_fn::deallocate;
   using any_completion_handler_call_fns<Signatures...>::call;
@@ -402,6 +445,7 @@ struct any_completion_handler_fn_table_instance
     value = any_completion_handler_fn_table<Signatures...>(
         &any_completion_handler_destroy_fn::impl<Handler>,
         &any_completion_handler_executor_fn::impl<Handler>,
+        &any_completion_handler_immediate_executor_fn::impl<Handler>,
         &any_completion_handler_allocate_fn::impl<Handler>,
         &any_completion_handler_deallocate_fn::impl<Handler>,
         &any_completion_handler_call_fn<Signatures>::template impl<Handler>...);
@@ -416,6 +460,8 @@ any_completion_handler_fn_table_instance<Handler, Signatures...>::value;
 template <typename... Signatures>
 class any_completion_handler;
 
+/// An allocator type that forwards memory allocation operations through an
+/// instance of @c any_completion_handler.
 template <typename T, typename... Signatures>
 class any_completion_handler_allocator
 {
@@ -437,14 +483,18 @@ private:
   }
 
 public:
+  /// The type of objects that may be allocated by the allocator.
   typedef T value_type;
 
+  /// Rebinds an allocator to another value type.
   template <typename U>
   struct rebind
   {
+    /// Specifies the type of the rebound allocator.
     typedef any_completion_handler_allocator<U, Signatures...> other;
   };
 
+  /// Construct from another @c any_completion_handler_allocator.
   template <typename U>
   constexpr any_completion_handler_allocator(
       const any_completion_handler_allocator<U, Signatures...>& a)
@@ -454,18 +504,21 @@ public:
   {
   }
 
+  /// Equality operator.
   constexpr bool operator==(
       const any_completion_handler_allocator& other) const BOOST_ASIO_NOEXCEPT
   {
     return fn_table_ == other.fn_table_ && impl_ == other.impl_;
   }
 
+  /// Inequality operator.
   constexpr bool operator!=(
       const any_completion_handler_allocator& other) const BOOST_ASIO_NOEXCEPT
   {
     return fn_table_ != other.fn_table_ || impl_ != other.impl_;
   }
 
+  /// Allocate space for @c n objects of the allocator's value type.
   T* allocate(std::size_t n) const
   {
     return static_cast<T*>(
@@ -473,12 +526,16 @@ public:
           impl_, sizeof(T) * n, alignof(T)));
   }
 
+  /// Deallocate space for @c n objects of the allocator's value type.
   void deallocate(T* p, std::size_t n) const
   {
     fn_table_->deallocate(impl_, p, sizeof(T) * n, alignof(T));
   }
 };
 
+/// A protoco-allocator type that may be rebound to obtain an allocator that
+/// forwards memory allocation operations through an instance of
+/// @c any_completion_handler.
 template <typename... Signatures>
 class any_completion_handler_allocator<void, Signatures...>
 {
@@ -500,14 +557,18 @@ private:
   }
 
 public:
+  /// @c void as no objects can be allocated through a proto-allocator.
   typedef void value_type;
 
+  /// Rebinds an allocator to another value type.
   template <typename U>
   struct rebind
   {
+    /// Specifies the type of the rebound allocator.
     typedef any_completion_handler_allocator<U, Signatures...> other;
   };
 
+  /// Construct from another @c any_completion_handler_allocator.
   template <typename U>
   constexpr any_completion_handler_allocator(
       const any_completion_handler_allocator<U, Signatures...>& a)
@@ -517,12 +578,14 @@ public:
   {
   }
 
+  /// Equality operator.
   constexpr bool operator==(
       const any_completion_handler_allocator& other) const BOOST_ASIO_NOEXCEPT
   {
     return fn_table_ == other.fn_table_ && impl_ == other.impl_;
   }
 
+  /// Inequality operator.
   constexpr bool operator!=(
       const any_completion_handler_allocator& other) const BOOST_ASIO_NOEXCEPT
   {
@@ -530,9 +593,27 @@ public:
   }
 };
 
+/// Polymorphic wrapper for completion handlers.
+/**
+ * The @c any_completion_handler class template is a polymorphic wrapper for
+ * completion handlers that propagates the associated executor, associated
+ * allocator, and associated cancellation slot through a type-erasing interface.
+ *
+ * When using @c any_completion_handler, specify one or more completion
+ * signatures as template parameters. These will dictate the arguments that may
+ * be passed to the handler through the polymorphic interface.
+ *
+ * Typical uses for @c any_completion_handler include:
+ *
+ * @li Separate compilation of asynchronous operation implementations.
+ *
+ * @li Enabling interoperability between asynchronous operations and virtual
+ *     functions.
+ */
 template <typename... Signatures>
 class any_completion_handler
 {
+#if !defined(GENERATING_DOCUMENTATION)
 private:
   template <typename, typename...>
   friend class any_completion_handler_allocator;
@@ -540,27 +621,42 @@ private:
   template <typename, typename>
   friend struct associated_executor;
 
+  template <typename, typename>
+  friend struct associated_immediate_executor;
+
   const detail::any_completion_handler_fn_table<Signatures...>* fn_table_;
   detail::any_completion_handler_impl_base* impl_;
+#endif // !defined(GENERATING_DOCUMENTATION)
 
 public:
+  /// The associated allocator type.
   using allocator_type = any_completion_handler_allocator<void, Signatures...>;
+
+  /// The associated cancellation slot type.
   using cancellation_slot_type = cancellation_slot;
 
+  /// Construct an @c any_completion_handler in an empty state, without a target
+  /// object.
   constexpr any_completion_handler()
     : fn_table_(nullptr),
       impl_(nullptr)
   {
   }
 
+  /// Construct an @c any_completion_handler in an empty state, without a target
+  /// object.
   constexpr any_completion_handler(nullptr_t)
     : fn_table_(nullptr),
       impl_(nullptr)
   {
   }
 
+  /// Construct an @c any_completion_handler to contain the specified target.
   template <typename H, typename Handler = typename decay<H>::type>
-  any_completion_handler(H&& h)
+  any_completion_handler(H&& h,
+      typename constraint<
+        !is_same<typename decay<H>::type, any_completion_handler>::value
+      >::type = 0)
     : fn_table_(
         &detail::any_completion_handler_fn_table_instance<
           Handler, Signatures...>::value),
@@ -569,6 +665,10 @@ public:
   {
   }
 
+  /// Move-construct an @c any_completion_handler from another.
+  /**
+   * After the operation, the moved-from object @c other has no target.
+   */
   any_completion_handler(any_completion_handler&& other) BOOST_ASIO_NOEXCEPT
     : fn_table_(other.fn_table_),
       impl_(other.impl_)
@@ -577,51 +677,72 @@ public:
     other.impl_ = nullptr;
   }
 
+  /// Move-assign an @c any_completion_handler from another.
+  /**
+   * After the operation, the moved-from object @c other has no target.
+   */
   any_completion_handler& operator=(
       any_completion_handler&& other) BOOST_ASIO_NOEXCEPT
   {
-    any_completion_handler(other).swap(*this);
+    any_completion_handler(
+        BOOST_ASIO_MOVE_CAST(any_completion_handler)(other)).swap(*this);
     return *this;
   }
 
+  /// Assignment operator that sets the polymorphic wrapper to the empty state.
   any_completion_handler& operator=(nullptr_t) BOOST_ASIO_NOEXCEPT
   {
     any_completion_handler().swap(*this);
     return *this;
   }
 
+  /// Destructor.
   ~any_completion_handler()
   {
     if (impl_)
       fn_table_->destroy(impl_);
   }
 
+  /// Test if the polymorphic wrapper is empty.
   constexpr explicit operator bool() const BOOST_ASIO_NOEXCEPT
   {
     return impl_ != nullptr;
   }
 
+  /// Test if the polymorphic wrapper is non-empty.
   constexpr bool operator!() const BOOST_ASIO_NOEXCEPT
   {
     return impl_ == nullptr;
   }
 
+  /// Swap the content of an @c any_completion_handler with another.
   void swap(any_completion_handler& other) BOOST_ASIO_NOEXCEPT
   {
     std::swap(fn_table_, other.fn_table_);
     std::swap(impl_, other.impl_);
   }
 
+  /// Get the associated allocator.
   allocator_type get_allocator() const BOOST_ASIO_NOEXCEPT
   {
     return allocator_type(0, *this);
   }
 
+  /// Get the associated cancellation slot.
   cancellation_slot_type get_cancellation_slot() const BOOST_ASIO_NOEXCEPT
   {
     return impl_->get_cancellation_slot();
   }
 
+  /// Function call operator.
+  /**
+   * Invokes target completion handler with the supplied arguments.
+   *
+   * This function may only be called once, as the target handler is moved from.
+   * The polymorphic wrapper is left in an empty state.
+   *
+   * Throws @c std::bad_function_call if the polymorphic wrapper is empty.
+   */
   template <typename... Args>
   auto operator()(Args&&... args)
     -> decltype(fn_table_->call(impl_, BOOST_ASIO_MOVE_CAST(Args)(args)...))
@@ -635,24 +756,28 @@ public:
     boost::asio::detail::throw_exception(ex);
   }
 
+  /// Equality operator.
   friend constexpr bool operator==(
       const any_completion_handler& a, nullptr_t) BOOST_ASIO_NOEXCEPT
   {
     return a.impl_ == nullptr;
   }
 
+  /// Equality operator.
   friend constexpr bool operator==(
       nullptr_t, const any_completion_handler& b) BOOST_ASIO_NOEXCEPT
   {
     return nullptr == b.impl_;
   }
 
+  /// Inequality operator.
   friend constexpr bool operator!=(
       const any_completion_handler& a, nullptr_t) BOOST_ASIO_NOEXCEPT
   {
     return a.impl_ != nullptr;
   }
 
+  /// Inequality operator.
   friend constexpr bool operator!=(
       nullptr_t, const any_completion_handler& b) BOOST_ASIO_NOEXCEPT
   {
@@ -673,6 +798,20 @@ struct associated_executor<any_completion_handler<Signatures...>, Candidate>
   }
 };
 
+template <typename... Signatures, typename Candidate>
+struct associated_immediate_executor<
+    any_completion_handler<Signatures...>, Candidate>
+{
+  using type = any_completion_executor;
+
+  static type get(const any_completion_handler<Signatures...>& handler,
+      const Candidate& candidate = Candidate()) BOOST_ASIO_NOEXCEPT
+  {
+    return handler.fn_table_->immediate_executor(handler.impl_,
+        any_io_executor(std::nothrow, candidate));
+  }
+};
+
 } // namespace asio
 } // namespace boost
 

data/src/cxx_supportlib/vendor-modified/boost/asio/any_io_executor.hpp

@@ -2,7 +2,7 @@
 // any_io_executor.hpp
 // ~~~~~~~~~~~~~~~~~~~
 //
-// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
+// Copyright (c) 2003-2023 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)

data/src/cxx_supportlib/vendor-modified/boost/asio/append.hpp

@@ -2,7 +2,7 @@
 // append.hpp
 // ~~~~~~~~~~
 //
-// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
+// Copyright (c) 2003-2023 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)

data/src/cxx_supportlib/vendor-modified/boost/asio/as_tuple.hpp

@@ -2,7 +2,7 @@
 // as_tuple.hpp
 // ~~~~~~~~~~~~
 //
-// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
+// Copyright (c) 2003-2023 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)

data/src/cxx_supportlib/vendor-modified/boost/asio/associated_allocator.hpp

@@ -2,7 +2,7 @@
 // associated_allocator.hpp
 // ~~~~~~~~~~~~~~~~~~~~~~~~
 //
-// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
+// Copyright (c) 2003-2023 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)

data/src/cxx_supportlib/vendor-modified/boost/asio/associated_cancellation_slot.hpp

@@ -2,7 +2,7 @@
 // associated_cancellation_slot.hpp
 // ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 //
-// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
+// Copyright (c) 2003-2023 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)
@@ -221,7 +221,7 @@ struct associated_cancellation_slot<reference_wrapper<T>, CancellationSlot>
   /// Forwards the request to get the cancellation slot to the associator
   /// specialisation for the unwrapped type @c T.
   static BOOST_ASIO_AUTO_RETURN_TYPE_PREFIX(type) get(reference_wrapper<T> t,
-      const CancellationSlot& s = CancellationSlot()) BOOST_ASIO_NOEXCEPT
+      const CancellationSlot& s) BOOST_ASIO_NOEXCEPT
     BOOST_ASIO_AUTO_RETURN_TYPE_SUFFIX((
       associated_cancellation_slot<T, CancellationSlot>::get(t.get(), s)))
   {

data/src/cxx_supportlib/vendor-modified/boost/asio/associated_executor.hpp

@@ -2,7 +2,7 @@
 // associated_executor.hpp
 // ~~~~~~~~~~~~~~~~~~~~~~~
 //
-// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
+// Copyright (c) 2003-2023 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)
@@ -173,15 +173,11 @@ get_associated_executor(const T& t, const Executor& ex,
  * ExecutionContext::executor_type>::get(t, ctx.get_executor())</tt>
  */
 template <typename T, typename ExecutionContext>
-BOOST_ASIO_NODISCARD inline BOOST_ASIO_AUTO_RETURN_TYPE_PREFIX2(
-    typename associated_executor<T,
-      typename ExecutionContext::executor_type>::type)
+BOOST_ASIO_NODISCARD inline typename associated_executor<T,
+    typename ExecutionContext::executor_type>::type
 get_associated_executor(const T& t, ExecutionContext& ctx,
     typename constraint<is_convertible<ExecutionContext&,
       execution_context&>::value>::type = 0) BOOST_ASIO_NOEXCEPT
-  BOOST_ASIO_AUTO_RETURN_TYPE_SUFFIX((
-    associated_executor<T,
-      typename ExecutionContext::executor_type>::get(t, ctx.get_executor())))
 {
   return associated_executor<T,
     typename ExecutionContext::executor_type>::get(t, ctx.get_executor());