zeroc-ice 3.8.2 → 3.8.3

data/dist/ice/cpp/include/generated/Ice/RemoteLogger.h

@@ -1,6 +1,6 @@
 // Copyright (c) ZeroC, Inc.
 
-// slice2cpp version 3.8.2
+// slice2cpp version 3.8.3
 // <auto-generated>Generated from Slice file 'RemoteLogger.ice'.</auto-generated>
 // clang-format off
 
@@ -19,7 +19,7 @@
 #   if ICE_INT_VERSION % 100 >= 50
 #       error Beta header file detected
 #   endif
-#   if ICE_INT_VERSION % 100 < 2
+#   if ICE_INT_VERSION % 100 < 3
 #       error Ice patch level mismatch!
 #   endif
 #endif
@@ -126,11 +126,24 @@ namespace Ice
         /// Attaches a remote logger to the local logger.
         /// @param prefix The prefix of the associated local Logger.
         /// @param logMessages Old log messages generated before "now".
-        /// @param response The response callback.
-        /// @param exception The exception callback.
-        /// @param sent The sent callback.
+        /// @param response The response callback. The Ice runtime calls this function from an Ice thread pool
+        /// thread. If you set Ice::InitializationData::executor, the executor determines the thread that executes this
+        /// function.
+        /// @param exception The exception callback. The Ice runtime calls this function from an Ice thread pool
+        /// thread. If you set Ice::InitializationData::executor, the executor determines the thread that executes this
+        /// function.
+        /// @param sent The sent callback. The Ice runtime calls this function when the request is accepted by the
+        /// transport. When the request is accepted synchronously, the Ice runtime calls this function from the current
+        /// thread and passes `true` as argument. When the request is accepted asynchronously, the Ice runtime calls
+        /// this function from an Ice thread pool thread and passes `false` as argument. If you set
+        /// Ice::InitializationData::executor, the executor determines the thread that executes this function in the
+        /// asynchronous case.
         /// @param context The request context.
         /// @return A function that can be called to cancel the invocation locally.
+        /// @remark When this proxy is a oneway or datagram proxy, the Ice runtime does not call the response
+        /// callback: a successful invocation completes with the sent callback. When this proxy is a batch
+        /// proxy, this function only adds the request to the batch: the Ice runtime calls none of the
+        /// callbacks, and the request is sent later, by a flush.
         // NOLINTNEXTLINE(modernize-use-nodiscard)
         std::function<void()> initAsync(std::string_view prefix, const LogMessageSeq& logMessages, std::function<void()> response, std::function<void(std::exception_ptr)> exception = nullptr, std::function<void(bool)> sent = nullptr, const Ice::Context& context = Ice::noExplicitContext) const;
 
@@ -152,12 +165,25 @@ namespace Ice
 
         /// Logs a LogMessage.
         /// @param message The message to log.
-        /// @param response The response callback.
-        /// @param exception The exception callback.
-        /// @param sent The sent callback.
+        /// @param response The response callback. The Ice runtime calls this function from an Ice thread pool
+        /// thread. If you set Ice::InitializationData::executor, the executor determines the thread that executes this
+        /// function.
+        /// @param exception The exception callback. The Ice runtime calls this function from an Ice thread pool
+        /// thread. If you set Ice::InitializationData::executor, the executor determines the thread that executes this
+        /// function.
+        /// @param sent The sent callback. The Ice runtime calls this function when the request is accepted by the
+        /// transport. When the request is accepted synchronously, the Ice runtime calls this function from the current
+        /// thread and passes `true` as argument. When the request is accepted asynchronously, the Ice runtime calls
+        /// this function from an Ice thread pool thread and passes `false` as argument. If you set
+        /// Ice::InitializationData::executor, the executor determines the thread that executes this function in the
+        /// asynchronous case.
         /// @param context The request context.
         /// @return A function that can be called to cancel the invocation locally.
         /// @remarks ::Ice::RemoteLoggerPrx::log may be called by ::Ice::LoggerAdminPrx before ::Ice::RemoteLoggerPrx::init.
+        /// @remark When this proxy is a oneway or datagram proxy, the Ice runtime does not call the response
+        /// callback: a successful invocation completes with the sent callback. When this proxy is a batch
+        /// proxy, this function only adds the request to the batch: the Ice runtime calls none of the
+        /// callbacks, and the request is sent later, by a flush.
         // NOLINTNEXTLINE(modernize-use-nodiscard)
         std::function<void()> logAsync(const LogMessage& message, std::function<void()> response, std::function<void(std::exception_ptr)> exception = nullptr, std::function<void(bool)> sent = nullptr, const Ice::Context& context = Ice::noExplicitContext) const;
 
@@ -237,7 +263,7 @@ namespace Ice
         /// @param messageMax The maximum number of log messages (of all types) to be provided to
         /// ::Ice::RemoteLoggerPrx::init. A negative value requests all messages available.
         /// @param context The request context.
-        /// @throws Ice::RemoteLoggerAlreadyAttachedException Thrown if this remote logger is already attached to this admin
+        /// @throws Ice::RemoteLoggerAlreadyAttachedException Thrown when this remote logger is already attached to this admin
         /// object.
         void attachRemoteLogger(const std::optional<RemoteLoggerPrx>& prx, const LogMessageTypeSeq& messageTypes, const StringSeq& traceCategories, std::int32_t messageMax, const Ice::Context& context = Ice::noExplicitContext) const;
 
@@ -265,9 +291,18 @@ namespace Ice
         /// (send all trace categories).
         /// @param messageMax The maximum number of log messages (of all types) to be provided to
         /// ::Ice::RemoteLoggerPrx::init. A negative value requests all messages available.
-        /// @param response The response callback.
-        /// @param exception The exception callback.
-        /// @param sent The sent callback.
+        /// @param response The response callback. The Ice runtime calls this function from an Ice thread pool
+        /// thread. If you set Ice::InitializationData::executor, the executor determines the thread that executes this
+        /// function.
+        /// @param exception The exception callback. The Ice runtime calls this function from an Ice thread pool
+        /// thread. If you set Ice::InitializationData::executor, the executor determines the thread that executes this
+        /// function.
+        /// @param sent The sent callback. The Ice runtime calls this function when the request is accepted by the
+        /// transport. When the request is accepted synchronously, the Ice runtime calls this function from the current
+        /// thread and passes `true` as argument. When the request is accepted asynchronously, the Ice runtime calls
+        /// this function from an Ice thread pool thread and passes `false` as argument. If you set
+        /// Ice::InitializationData::executor, the executor determines the thread that executes this function in the
+        /// asynchronous case.
         /// @param context The request context.
         /// @return A function that can be called to cancel the invocation locally.
         // NOLINTNEXTLINE(modernize-use-nodiscard)
@@ -291,10 +326,19 @@ namespace Ice
 
         /// Detaches a ::Ice::RemoteLoggerPrx object from the local logger.
         /// @param prx A proxy to the remote logger.
-        /// @param response The response callback. It accepts:
+        /// @param response The response callback. The Ice runtime calls this function from an Ice thread pool
+        /// thread. If you set Ice::InitializationData::executor, the executor determines the thread that executes this
+        /// function. It accepts:
         /// - `true` if the provided remote logger proxy was detached, and `false` otherwise.
-        /// @param exception The exception callback.
-        /// @param sent The sent callback.
+        /// @param exception The exception callback. The Ice runtime calls this function from an Ice thread pool
+        /// thread. If you set Ice::InitializationData::executor, the executor determines the thread that executes this
+        /// function.
+        /// @param sent The sent callback. The Ice runtime calls this function when the request is accepted by the
+        /// transport. When the request is accepted synchronously, the Ice runtime calls this function from the current
+        /// thread and passes `true` as argument. When the request is accepted asynchronously, the Ice runtime calls
+        /// this function from an Ice thread pool thread and passes `false` as argument. If you set
+        /// Ice::InitializationData::executor, the executor determines the thread that executes this function in the
+        /// asynchronous case.
         /// @param context The request context.
         /// @return A function that can be called to cancel the invocation locally.
         // NOLINTNEXTLINE(modernize-use-nodiscard)
@@ -306,43 +350,52 @@ namespace Ice
         /// Retrieves recently logged log messages.
         /// @param messageTypes The list of message types that the caller wishes to receive. An empty list means no
         /// filtering (send all message types).
-        /// @param traceCategories The categories of traces that caller wish to receive. This parameter is ignored if
-        /// @p messageTypes is not empty and does not include trace. An empty list means no filtering (send all trace
-        /// categories).
+        /// @param traceCategories The categories of traces that the caller wishes to receive. This parameter is
+        /// ignored if @p messageTypes is not empty and does not include trace. An empty list means no filtering (send
+        /// all trace categories).
         /// @param messageMax The maximum number of log messages (of all types) to be returned. A negative value
         /// requests all messages available.
         /// @param[out] prefix The prefix of the associated local logger.
         /// @param context The request context.
-        /// @return The Log messages.
+        /// @return The log messages.
         LogMessageSeq getLog(const LogMessageTypeSeq& messageTypes, const StringSeq& traceCategories, std::int32_t messageMax, std::string& prefix, const Ice::Context& context = Ice::noExplicitContext) const;
 
         /// Retrieves recently logged log messages.
         /// @param messageTypes The list of message types that the caller wishes to receive. An empty list means no
         /// filtering (send all message types).
-        /// @param traceCategories The categories of traces that caller wish to receive. This parameter is ignored if
-        /// @p messageTypes is not empty and does not include trace. An empty list means no filtering (send all trace
-        /// categories).
+        /// @param traceCategories The categories of traces that the caller wishes to receive. This parameter is
+        /// ignored if @p messageTypes is not empty and does not include trace. An empty list means no filtering (send
+        /// all trace categories).
         /// @param messageMax The maximum number of log messages (of all types) to be returned. A negative value
         /// requests all messages available.
         /// @param context The request context.
         /// @return A future that becomes available when the invocation completes. This future holds:
-        /// - `returnValue` The Log messages.
+        /// - `returnValue` The log messages.
         /// - `prefix` The prefix of the associated local logger.
         [[nodiscard]] std::future<std::tuple<LogMessageSeq, std::string>> getLogAsync(const LogMessageTypeSeq& messageTypes, const StringSeq& traceCategories, std::int32_t messageMax, const Ice::Context& context = Ice::noExplicitContext) const;
 
         /// Retrieves recently logged log messages.
         /// @param messageTypes The list of message types that the caller wishes to receive. An empty list means no
         /// filtering (send all message types).
-        /// @param traceCategories The categories of traces that caller wish to receive. This parameter is ignored if
-        /// @p messageTypes is not empty and does not include trace. An empty list means no filtering (send all trace
-        /// categories).
+        /// @param traceCategories The categories of traces that the caller wishes to receive. This parameter is
+        /// ignored if @p messageTypes is not empty and does not include trace. An empty list means no filtering (send
+        /// all trace categories).
         /// @param messageMax The maximum number of log messages (of all types) to be returned. A negative value
         /// requests all messages available.
-        /// @param response The response callback. It accepts:
-        /// - `returnValue` The Log messages.
+        /// @param response The response callback. The Ice runtime calls this function from an Ice thread pool
+        /// thread. If you set Ice::InitializationData::executor, the executor determines the thread that executes this
+        /// function. It accepts:
+        /// - `returnValue` The log messages.
         /// - `prefix` The prefix of the associated local logger.
-        /// @param exception The exception callback.
-        /// @param sent The sent callback.
+        /// @param exception The exception callback. The Ice runtime calls this function from an Ice thread pool
+        /// thread. If you set Ice::InitializationData::executor, the executor determines the thread that executes this
+        /// function.
+        /// @param sent The sent callback. The Ice runtime calls this function when the request is accepted by the
+        /// transport. When the request is accepted synchronously, the Ice runtime calls this function from the current
+        /// thread and passes `true` as argument. When the request is accepted asynchronously, the Ice runtime calls
+        /// this function from an Ice thread pool thread and passes `false` as argument. If you set
+        /// Ice::InitializationData::executor, the executor determines the thread that executes this function in the
+        /// asynchronous case.
         /// @param context The request context.
         /// @return A function that can be called to cancel the invocation locally.
         // NOLINTNEXTLINE(modernize-use-nodiscard)
@@ -515,7 +568,7 @@ namespace Ice
         /// @param messageMax The maximum number of log messages (of all types) to be provided to
         /// ::Ice::RemoteLoggerPrx::init. A negative value requests all messages available.
         /// @param current The Current object of the incoming request.
-        /// @throws Ice::RemoteLoggerAlreadyAttachedException Thrown if this remote logger is already attached to this admin
+        /// @throws Ice::RemoteLoggerAlreadyAttachedException Thrown when this remote logger is already attached to this admin
         /// object.
         virtual void attachRemoteLogger(std::optional<RemoteLoggerPrx> prx, LogMessageTypeSeq messageTypes, StringSeq traceCategories, std::int32_t messageMax, const Ice::Current& current) = 0;
 
@@ -534,14 +587,14 @@ namespace Ice
         /// Retrieves recently logged log messages.
         /// @param messageTypes The list of message types that the caller wishes to receive. An empty list means no
         /// filtering (send all message types).
-        /// @param traceCategories The categories of traces that caller wish to receive. This parameter is ignored if
-        /// @p messageTypes is not empty and does not include trace. An empty list means no filtering (send all trace
-        /// categories).
+        /// @param traceCategories The categories of traces that the caller wishes to receive. This parameter is
+        /// ignored if @p messageTypes is not empty and does not include trace. An empty list means no filtering (send
+        /// all trace categories).
         /// @param messageMax The maximum number of log messages (of all types) to be returned. A negative value
         /// requests all messages available.
         /// @param[out] prefix The prefix of the associated local logger.
         /// @param current The Current object of the incoming request.
-        /// @return The Log messages.
+        /// @return The log messages.
         virtual LogMessageSeq getLog(LogMessageTypeSeq messageTypes, StringSeq traceCategories, std::int32_t messageMax, std::string& prefix, const Ice::Current& current) = 0;
 
         /// @private
@@ -638,7 +691,7 @@ namespace Ice
         /// @param response The response callback.
         /// @param exception The exception callback.
         /// @param current The Current object of the incoming request.
-        /// @throws Ice::RemoteLoggerAlreadyAttachedException Thrown if this remote logger is already attached to this admin
+        /// @throws Ice::RemoteLoggerAlreadyAttachedException Thrown when this remote logger is already attached to this admin
         /// object.
         virtual void attachRemoteLoggerAsync(std::optional<RemoteLoggerPrx> prx, LogMessageTypeSeq messageTypes, StringSeq traceCategories, std::int32_t messageMax, std::function<void()> response, std::function<void(std::exception_ptr)> exception, const Ice::Current& current) = 0;
 
@@ -659,13 +712,13 @@ namespace Ice
         /// Retrieves recently logged log messages.
         /// @param messageTypes The list of message types that the caller wishes to receive. An empty list means no
         /// filtering (send all message types).
-        /// @param traceCategories The categories of traces that caller wish to receive. This parameter is ignored if
-        /// @p messageTypes is not empty and does not include trace. An empty list means no filtering (send all trace
-        /// categories).
+        /// @param traceCategories The categories of traces that the caller wishes to receive. This parameter is
+        /// ignored if @p messageTypes is not empty and does not include trace. An empty list means no filtering (send
+        /// all trace categories).
         /// @param messageMax The maximum number of log messages (of all types) to be returned. A negative value
         /// requests all messages available.
         /// @param response The response callback. It accepts:
-        /// - `returnValue` The Log messages.
+        /// - `returnValue` The log messages.
         /// - `prefix` The prefix of the associated local logger.
         /// @param exception The exception callback.
         /// @param current The Current object of the incoming request.

data/dist/ice/cpp/include/generated/Ice/ReplyStatus.h

@@ -1,6 +1,6 @@
 // Copyright (c) ZeroC, Inc.
 
-// slice2cpp version 3.8.2
+// slice2cpp version 3.8.3
 // <auto-generated>Generated from Slice file 'ReplyStatus.ice'.</auto-generated>
 // clang-format off
 
@@ -18,7 +18,7 @@
 #   if ICE_INT_VERSION % 100 >= 50
 #       error Beta header file detected
 #   endif
-#   if ICE_INT_VERSION % 100 < 2
+#   if ICE_INT_VERSION % 100 < 3
 #       error Ice patch level mismatch!
 #   endif
 #endif

data/dist/ice/cpp/include/generated/Ice/Router.h

@@ -1,6 +1,6 @@
 // Copyright (c) ZeroC, Inc.
 
-// slice2cpp version 3.8.2
+// slice2cpp version 3.8.3
 // <auto-generated>Generated from Slice file 'Router.ice'.</auto-generated>
 // clang-format off
 
@@ -18,7 +18,7 @@
 #   if ICE_INT_VERSION % 100 >= 50
 #       error Beta header file detected
 #   endif
-#   if ICE_INT_VERSION % 100 < 2
+#   if ICE_INT_VERSION % 100 < 3
 #       error Ice patch level mismatch!
 #   endif
 #endif
@@ -102,13 +102,22 @@ namespace Ice
 
         /// Gets the router's client proxy, i.e. the proxy to use for forwarding requests from the client to the
         /// router. If a null proxy is returned, the client will forward requests to the router's endpoints.
-        /// @param response The response callback. It accepts:
+        /// @param response The response callback. The Ice runtime calls this function from an Ice thread pool
+        /// thread. If you set Ice::InitializationData::executor, the executor determines the thread that executes this
+        /// function. It accepts:
         /// - `returnValue` The router's client proxy.
         /// - `hasRoutingTable` Indicates whether or not the router supports a routing table. If `true`, the Ice
         /// runtime will call ::Ice::RouterPrx::addProxies to populate the routing table. The Ice runtime assumes the router has
         /// a routing table when `hasRoutingTable` is not set.
-        /// @param exception The exception callback.
-        /// @param sent The sent callback.
+        /// @param exception The exception callback. The Ice runtime calls this function from an Ice thread pool
+        /// thread. If you set Ice::InitializationData::executor, the executor determines the thread that executes this
+        /// function.
+        /// @param sent The sent callback. The Ice runtime calls this function when the request is accepted by the
+        /// transport. When the request is accepted synchronously, the Ice runtime calls this function from the current
+        /// thread and passes `true` as argument. When the request is accepted asynchronously, the Ice runtime calls
+        /// this function from an Ice thread pool thread and passes `false` as argument. If you set
+        /// Ice::InitializationData::executor, the executor determines the thread that executes this function in the
+        /// asynchronous case.
         /// @param context The request context.
         /// @return A function that can be called to cancel the invocation locally.
         /// @remarks Introduced in Ice 3.7.
@@ -136,10 +145,19 @@ namespace Ice
         /// Gets the router's server proxy, i.e. the proxy to use for forwarding requests from the server to the
         /// router. The Ice runtime uses the endpoints of this proxy as the published endpoints of bi-dir object
         /// adapters.
-        /// @param response The response callback. It accepts:
+        /// @param response The response callback. The Ice runtime calls this function from an Ice thread pool
+        /// thread. If you set Ice::InitializationData::executor, the executor determines the thread that executes this
+        /// function. It accepts:
         /// - The router's server proxy.
-        /// @param exception The exception callback.
-        /// @param sent The sent callback.
+        /// @param exception The exception callback. The Ice runtime calls this function from an Ice thread pool
+        /// thread. If you set Ice::InitializationData::executor, the executor determines the thread that executes this
+        /// function.
+        /// @param sent The sent callback. The Ice runtime calls this function when the request is accepted by the
+        /// transport. When the request is accepted synchronously, the Ice runtime calls this function from the current
+        /// thread and passes `true` as argument. When the request is accepted asynchronously, the Ice runtime calls
+        /// this function from an Ice thread pool thread and passes `false` as argument. If you set
+        /// Ice::InitializationData::executor, the executor determines the thread that executes this function in the
+        /// asynchronous case.
         /// @param context The request context.
         /// @return A function that can be called to cancel the invocation locally.
         // NOLINTNEXTLINE(modernize-use-nodiscard)
@@ -163,10 +181,19 @@ namespace Ice
 
         /// Adds new proxy information to the router's routing table.
         /// @param proxies The proxies to add. Adding a null proxy is an error.
-        /// @param response The response callback. It accepts:
+        /// @param response The response callback. The Ice runtime calls this function from an Ice thread pool
+        /// thread. If you set Ice::InitializationData::executor, the executor determines the thread that executes this
+        /// function. It accepts:
         /// - Proxies discarded by the router. These proxies are all non-null.
-        /// @param exception The exception callback.
-        /// @param sent The sent callback.
+        /// @param exception The exception callback. The Ice runtime calls this function from an Ice thread pool
+        /// thread. If you set Ice::InitializationData::executor, the executor determines the thread that executes this
+        /// function.
+        /// @param sent The sent callback. The Ice runtime calls this function when the request is accepted by the
+        /// transport. When the request is accepted synchronously, the Ice runtime calls this function from the current
+        /// thread and passes `true` as argument. When the request is accepted asynchronously, the Ice runtime calls
+        /// this function from an Ice thread pool thread and passes `false` as argument. If you set
+        /// Ice::InitializationData::executor, the executor determines the thread that executes this function in the
+        /// asynchronous case.
         /// @param context The request context.
         /// @return A function that can be called to cancel the invocation locally.
         // NOLINTNEXTLINE(modernize-use-nodiscard)
@@ -252,10 +279,19 @@ namespace Ice
         [[nodiscard]] std::future<std::optional<RouterPrx>> getRouterAsync(const Ice::Context& context = Ice::noExplicitContext) const;
 
         /// Gets a proxy to the associated ::Ice::RouterPrx. The proxy might point to several replicas.
-        /// @param response The response callback. It accepts:
+        /// @param response The response callback. The Ice runtime calls this function from an Ice thread pool
+        /// thread. If you set Ice::InitializationData::executor, the executor determines the thread that executes this
+        /// function. It accepts:
         /// - The router proxy. This proxy is never null.
-        /// @param exception The exception callback.
-        /// @param sent The sent callback.
+        /// @param exception The exception callback. The Ice runtime calls this function from an Ice thread pool
+        /// thread. If you set Ice::InitializationData::executor, the executor determines the thread that executes this
+        /// function.
+        /// @param sent The sent callback. The Ice runtime calls this function when the request is accepted by the
+        /// transport. When the request is accepted synchronously, the Ice runtime calls this function from the current
+        /// thread and passes `true` as argument. When the request is accepted asynchronously, the Ice runtime calls
+        /// this function from an Ice thread pool thread and passes `false` as argument. If you set
+        /// Ice::InitializationData::executor, the executor determines the thread that executes this function in the
+        /// asynchronous case.
         /// @param context The request context.
         /// @return A function that can be called to cancel the invocation locally.
         // NOLINTNEXTLINE(modernize-use-nodiscard)

data/dist/ice/cpp/include/generated/Ice/SliceChecksumDict.h

@@ -1,6 +1,6 @@
 // Copyright (c) ZeroC, Inc.
 
-// slice2cpp version 3.8.2
+// slice2cpp version 3.8.3
 // <auto-generated>Generated from Slice file 'SliceChecksumDict.ice'.</auto-generated>
 // clang-format off
 
@@ -17,7 +17,7 @@
 #   if ICE_INT_VERSION % 100 >= 50
 #       error Beta header file detected
 #   endif
-#   if ICE_INT_VERSION % 100 < 2
+#   if ICE_INT_VERSION % 100 < 3
 #       error Ice patch level mismatch!
 #   endif
 #endif

data/dist/ice/cpp/include/generated/Ice/Version.h

@@ -1,6 +1,6 @@
 // Copyright (c) ZeroC, Inc.
 
-// slice2cpp version 3.8.2
+// slice2cpp version 3.8.3
 // <auto-generated>Generated from Slice file 'Version.ice'.</auto-generated>
 // clang-format off
 
@@ -20,7 +20,7 @@
 #   if ICE_INT_VERSION % 100 >= 50
 #       error Beta header file detected
 #   endif
-#   if ICE_INT_VERSION % 100 < 2
+#   if ICE_INT_VERSION % 100 < 3
 #       error Ice patch level mismatch!
 #   endif
 #endif

data/dist/ice/cpp/include/generated/IceDiscovery/Lookup.h

@@ -1,6 +1,6 @@
 // Copyright (c) ZeroC, Inc.
 
-// slice2cpp version 3.8.2
+// slice2cpp version 3.8.3
 // <auto-generated>Generated from Slice file 'Lookup.ice'.</auto-generated>
 // clang-format off
 
@@ -18,7 +18,7 @@
 #   if ICE_INT_VERSION % 100 >= 50
 #       error Beta header file detected
 #   endif
-#   if ICE_INT_VERSION % 100 < 2
+#   if ICE_INT_VERSION % 100 < 3
 #       error Ice patch level mismatch!
 #   endif
 #endif
@@ -94,11 +94,24 @@ namespace IceDiscovery
         /// Provides a reply to a ::IceDiscovery::LookupPrx::findObjectById request.
         /// @param id The identity of the object.
         /// @param prx The proxy of the object. This proxy is never null.
-        /// @param response The response callback.
-        /// @param exception The exception callback.
-        /// @param sent The sent callback.
+        /// @param response The response callback. The Ice runtime calls this function from an Ice thread pool
+        /// thread. If you set Ice::InitializationData::executor, the executor determines the thread that executes this
+        /// function.
+        /// @param exception The exception callback. The Ice runtime calls this function from an Ice thread pool
+        /// thread. If you set Ice::InitializationData::executor, the executor determines the thread that executes this
+        /// function.
+        /// @param sent The sent callback. The Ice runtime calls this function when the request is accepted by the
+        /// transport. When the request is accepted synchronously, the Ice runtime calls this function from the current
+        /// thread and passes `true` as argument. When the request is accepted asynchronously, the Ice runtime calls
+        /// this function from an Ice thread pool thread and passes `false` as argument. If you set
+        /// Ice::InitializationData::executor, the executor determines the thread that executes this function in the
+        /// asynchronous case.
         /// @param context The request context.
         /// @return A function that can be called to cancel the invocation locally.
+        /// @remark When this proxy is a oneway or datagram proxy, the Ice runtime does not call the response
+        /// callback: a successful invocation completes with the sent callback. When this proxy is a batch
+        /// proxy, this function only adds the request to the batch: the Ice runtime calls none of the
+        /// callbacks, and the request is sent later, by a flush.
         // NOLINTNEXTLINE(modernize-use-nodiscard)
         std::function<void()> foundObjectByIdAsync(const ::Ice::Identity& id, const std::optional<Ice::ObjectPrx>& prx, std::function<void()> response, std::function<void(std::exception_ptr)> exception = nullptr, std::function<void(bool)> sent = nullptr, const Ice::Context& context = Ice::noExplicitContext) const;
 
@@ -127,11 +140,24 @@ namespace IceDiscovery
         /// @param prx The adapter proxy (a dummy proxy created by the adapter). The proxy provides the adapter
         /// endpoints. This proxy is never null.
         /// @param isReplicaGroup Indicates whether the adapter is a member of a replica group.
-        /// @param response The response callback.
-        /// @param exception The exception callback.
-        /// @param sent The sent callback.
+        /// @param response The response callback. The Ice runtime calls this function from an Ice thread pool
+        /// thread. If you set Ice::InitializationData::executor, the executor determines the thread that executes this
+        /// function.
+        /// @param exception The exception callback. The Ice runtime calls this function from an Ice thread pool
+        /// thread. If you set Ice::InitializationData::executor, the executor determines the thread that executes this
+        /// function.
+        /// @param sent The sent callback. The Ice runtime calls this function when the request is accepted by the
+        /// transport. When the request is accepted synchronously, the Ice runtime calls this function from the current
+        /// thread and passes `true` as argument. When the request is accepted asynchronously, the Ice runtime calls
+        /// this function from an Ice thread pool thread and passes `false` as argument. If you set
+        /// Ice::InitializationData::executor, the executor determines the thread that executes this function in the
+        /// asynchronous case.
         /// @param context The request context.
         /// @return A function that can be called to cancel the invocation locally.
+        /// @remark When this proxy is a oneway or datagram proxy, the Ice runtime does not call the response
+        /// callback: a successful invocation completes with the sent callback. When this proxy is a batch
+        /// proxy, this function only adds the request to the batch: the Ice runtime calls none of the
+        /// callbacks, and the request is sent later, by a flush.
         // NOLINTNEXTLINE(modernize-use-nodiscard)
         std::function<void()> foundAdapterByIdAsync(std::string_view id, const std::optional<Ice::ObjectPrx>& prx, bool isReplicaGroup, std::function<void()> response, std::function<void(std::exception_ptr)> exception = nullptr, std::function<void(bool)> sent = nullptr, const Ice::Context& context = Ice::noExplicitContext) const;
 
@@ -223,11 +249,24 @@ namespace IceDiscovery
         /// @param id The well-known object identity.
         /// @param reply The proxy of the ::IceDiscovery::LookupReplyPrx interface that should be used to send the reply if a
         /// matching object is found. The reply proxy is never null.
-        /// @param response The response callback.
-        /// @param exception The exception callback.
-        /// @param sent The sent callback.
+        /// @param response The response callback. The Ice runtime calls this function from an Ice thread pool
+        /// thread. If you set Ice::InitializationData::executor, the executor determines the thread that executes this
+        /// function.
+        /// @param exception The exception callback. The Ice runtime calls this function from an Ice thread pool
+        /// thread. If you set Ice::InitializationData::executor, the executor determines the thread that executes this
+        /// function.
+        /// @param sent The sent callback. The Ice runtime calls this function when the request is accepted by the
+        /// transport. When the request is accepted synchronously, the Ice runtime calls this function from the current
+        /// thread and passes `true` as argument. When the request is accepted asynchronously, the Ice runtime calls
+        /// this function from an Ice thread pool thread and passes `false` as argument. If you set
+        /// Ice::InitializationData::executor, the executor determines the thread that executes this function in the
+        /// asynchronous case.
         /// @param context The request context.
         /// @return A function that can be called to cancel the invocation locally.
+        /// @remark When this proxy is a oneway or datagram proxy, the Ice runtime does not call the response
+        /// callback: a successful invocation completes with the sent callback. When this proxy is a batch
+        /// proxy, this function only adds the request to the batch: the Ice runtime calls none of the
+        /// callbacks, and the request is sent later, by a flush.
         // NOLINTNEXTLINE(modernize-use-nodiscard)
         std::function<void()> findObjectByIdAsync(std::string_view domainId, const ::Ice::Identity& id, const std::optional<LookupReplyPrx>& reply, std::function<void()> response, std::function<void(std::exception_ptr)> exception = nullptr, std::function<void(bool)> sent = nullptr, const Ice::Context& context = Ice::noExplicitContext) const;
 
@@ -259,11 +298,24 @@ namespace IceDiscovery
         /// @param id The adapter ID.
         /// @param reply The proxy of the ::IceDiscovery::LookupReplyPrx interface that should be used to send the reply if a
         /// matching adapter is found. The reply proxy is never null.
-        /// @param response The response callback.
-        /// @param exception The exception callback.
-        /// @param sent The sent callback.
+        /// @param response The response callback. The Ice runtime calls this function from an Ice thread pool
+        /// thread. If you set Ice::InitializationData::executor, the executor determines the thread that executes this
+        /// function.
+        /// @param exception The exception callback. The Ice runtime calls this function from an Ice thread pool
+        /// thread. If you set Ice::InitializationData::executor, the executor determines the thread that executes this
+        /// function.
+        /// @param sent The sent callback. The Ice runtime calls this function when the request is accepted by the
+        /// transport. When the request is accepted synchronously, the Ice runtime calls this function from the current
+        /// thread and passes `true` as argument. When the request is accepted asynchronously, the Ice runtime calls
+        /// this function from an Ice thread pool thread and passes `false` as argument. If you set
+        /// Ice::InitializationData::executor, the executor determines the thread that executes this function in the
+        /// asynchronous case.
         /// @param context The request context.
         /// @return A function that can be called to cancel the invocation locally.
+        /// @remark When this proxy is a oneway or datagram proxy, the Ice runtime does not call the response
+        /// callback: a successful invocation completes with the sent callback. When this proxy is a batch
+        /// proxy, this function only adds the request to the batch: the Ice runtime calls none of the
+        /// callbacks, and the request is sent later, by a flush.
         // NOLINTNEXTLINE(modernize-use-nodiscard)
         std::function<void()> findAdapterByIdAsync(std::string_view domainId, std::string_view id, const std::optional<LookupReplyPrx>& reply, std::function<void()> response, std::function<void(std::exception_ptr)> exception = nullptr, std::function<void(bool)> sent = nullptr, const Ice::Context& context = Ice::noExplicitContext) const;