zeroc-ice 3.8.2 → 3.8.3

data/dist/ice/cpp/include/Ice/Service.h

@@ -41,7 +41,7 @@ namespace Ice
         ///
         /// Unix:
         ///
-        /// --daemon [--nochdir] [--noclose]
+        /// --daemon [--nochdir] [--noclose] [--pidfile FILE]
         ///
         /// If --service or --daemon are specified, the program runs as a service, otherwise the program runs as a
         /// regular foreground process. Any service-specific (and Ice-specific) options are stripped from @p argv (just
@@ -67,7 +67,7 @@ namespace Ice
         ///
         /// Unix:
         ///
-        /// --daemon [--nochdir] [--noclose]
+        /// --daemon [--nochdir] [--noclose] [--pidfile FILE]
         ///
         /// If --service or --daemon are specified, the program runs as a service, otherwise the program runs as a
         /// regular foreground process. Any service-specific (and Ice-specific) options are stripped from @p args (just
@@ -101,9 +101,6 @@ namespace Ice
         virtual void handleInterrupt(int sig);
 
 #ifdef _WIN32
-        /// @private
-        static void setModuleHandle(HMODULE);
-
         /// @private
         void serviceMain(int, const wchar_t* const[]);
 

data/dist/ice/cpp/include/Ice/SliceLoader.h

@@ -60,7 +60,7 @@ namespace Ice
         std::vector<SliceLoaderPtr> _loaders;
     };
 
-    /// A shared pointer to a CompositeSliceLoaderPtr.
+    /// A shared pointer to a CompositeSliceLoader.
     using CompositeSliceLoaderPtr = std::shared_ptr<CompositeSliceLoader>;
 }
 

data/dist/ice/cpp/include/Ice/SlicedData.h

@@ -30,7 +30,7 @@ namespace Ice
         /// The Slice compact type ID for this slice, or `-1` if the slice has no compact ID.
         const int compactId;
 
-        /// The encoded bytes for this slice, including the leading size integer.
+        /// The encoded bytes for this slice.
         const std::vector<std::byte> bytes;
 
         /// The class instances referenced by this slice.
@@ -93,11 +93,13 @@ namespace Ice
     {
     public:
         /// Constructs the placeholder instance.
-        /// @param unknownTypeId The Slice type ID of the unknown value.
+        /// @param unknownTypeId The Slice type ID of the unknown value, or the string form of the compact type ID
+        /// (for example, "1") when the most-derived slice was marshaled with a compact type ID.
         UnknownSlicedValue(std::string unknownTypeId) noexcept;
 
         /// Returns the Slice type ID associated with this instance.
-        /// @return The type ID supplied to the constructor.
+        /// @return The type ID supplied to the constructor. It's the string form of the compact type ID (for
+        /// example, "1") when the most-derived slice was marshaled with a compact type ID.
         [[nodiscard]] const char* ice_id() const noexcept final;
 
         /// Clones this object.

data/dist/ice/cpp/include/Ice/StreamHelpers.h

@@ -291,7 +291,7 @@ namespace Ice
         }
     };
 
-    /// Helper the array custom sequence mapping.
+    /// Helper for the array custom sequence mapping.
     template<typename T> struct StreamHelper<std::pair<const T*, const T*>, StreamHelperCategorySequence>
     {
         static void write(OutputStream* stream, std::pair<const T*, const T*> v) { stream->write(v.first, v.second); }

data/dist/ice/cpp/include/Ice/StreamableTraits.h

@@ -68,7 +68,7 @@ namespace Ice
         /// Fixed 8-byte encoding.
         F8 = 3,
 
-        /// "Size encoding" using either 1 or 5 bytes. Used by enums, class identifiers, etc.
+        /// "Size encoding" using either 1 or 5 bytes. Used by enums.
         Size = 4,
 
         /// Variable "size encoding" using either 1 or 5 bytes followed by data.
@@ -76,7 +76,7 @@ namespace Ice
         VSize = 5,
 
         /// Fixed "size encoding" using 4 bytes followed by data.
-        /// Used by variable-size structs, and containers whose sizes can't be computed prior to unmarshaling.
+        /// Used by variable-size structs, and containers whose sizes can't be computed prior to marshaling.
         FSize = 6,
 
         /// Class instance. No longer supported.

data/dist/ice/cpp/include/Ice/StringConverter.h

@@ -21,9 +21,8 @@ namespace Ice
         /// Obtains more bytes.
         /// @param howMany The number of bytes requested.
         /// @param firstUnused A pointer to the first unused byte.
-        /// @return A pointer to the beginning of the buffer.
-        /// @throws std::bad_alloc Thrown when too many bytes are requested.
-        /// @throws MarshalException Thrown when too many bytes are requested.
+        /// @return A pointer to the start of the newly reserved space (the first unused byte).
+        /// @throws std::bad_alloc Thrown when the buffer cannot be resized.
         virtual std::byte* getMoreBytes(size_t howMany, std::byte* firstUnused) = 0;
 
         virtual ~UTF8Buffer();

data/dist/ice/cpp/include/Ice/StringUtil.h

@@ -24,8 +24,8 @@ namespace Ice
         /// with ordinal values 127 and below are encoded as \\t, \\n (etc.) or \\unnnn.
         ASCII,
         /// Characters with ordinal values greater than 127 are encoded as a sequence of UTF-8 bytes using octal
-        /// escapes. Characters with ordinal values 127 and below are encoded as \\t, \\n (etc.) or an octal escape. Use
-        /// this mode to generate strings compatible with Ice 3.6 and earlier.
+        /// escapes. Non-printable ASCII characters with ordinal values 127 and below are encoded as \\t, \\n (etc.) or
+        /// an octal escape. Use this mode to generate strings compatible with Ice 3.6 and earlier.
         Compat
     };
 }
@@ -104,11 +104,6 @@ namespace IceInternal
     ICE_API std::string toUpper(std::string_view);
     ICE_API bool isAlpha(char);
     ICE_API bool isDigit(char);
-
-    //
-    // Remove all whitespace from a string
-    //
-    ICE_API std::string removeWhitespace(std::string_view);
 }
 
 #endif

data/dist/ice/cpp/include/Ice/UUID.h

@@ -10,6 +10,7 @@ namespace Ice
 {
     /// Generates a universally unique identifier (UUID).
     /// @return The UUID.
+    /// @throws std::system_error If the operating system's random number generator fails.
     ICE_API std::string generateUUID();
 }
 

data/dist/ice/cpp/include/Ice/Value.h

@@ -54,8 +54,8 @@ namespace Ice
         [[nodiscard]] ValuePtr ice_clone() const { return _iceCloneImpl(); }
 
         /// Gets the sliced data associated with this instance.
-        /// @return The sliced data if the value has a preserved-slice base class and has been sliced during
-        /// unmarshaling of the value, null otherwise.
+        /// @return The sliced data if this value was sliced during unmarshaling, null otherwise. Unknown slices are
+        /// preserved only when the sender uses the sliced format.
         [[nodiscard]] SlicedDataPtr ice_getSlicedData() const;
 
         /// Outputs a description of this instance to the stream. This description includes the type name and the name

data/dist/ice/cpp/include/generated/Ice/BuiltinSequences.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 'BuiltinSequences.ice'.</auto-generated>
 // clang-format off
 
@@ -24,7 +24,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/Context.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 'Context.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

data/dist/ice/cpp/include/generated/Ice/EndpointTypes.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 'EndpointTypes.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/Identity.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 'Identity.ice'.</auto-generated>
 // clang-format off
 
@@ -21,7 +21,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/Locator.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 'Locator.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
@@ -105,10 +105,19 @@ namespace Ice
         /// object. This dummy proxy may be an indirect proxy that requires further resolution using
         /// ::Ice::LocatorPrx::findAdapterById.
         /// @param id The identity.
-        /// @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:
         /// - A dummy proxy, or null if an object with the requested identity was not found.
-        /// @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)
@@ -134,10 +143,19 @@ namespace Ice
 
         /// Finds an object adapter by adapter ID and returns a dummy proxy with the object adapter's endpoint(s).
         /// @param id The adapter ID.
-        /// @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:
         /// - A dummy proxy with the adapter's endpoints, or null if an object adapter with @p id was not found.
-        /// @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)
@@ -158,10 +176,19 @@ namespace Ice
         [[nodiscard]] std::future<std::optional<LocatorRegistryPrx>> getRegistryAsync(const Ice::Context& context = Ice::noExplicitContext) const;
 
         /// Gets a proxy to the locator registry.
-        /// @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:
         /// - A proxy to the locator registry, or null if this locator has no associated registry.
-        /// @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)
@@ -247,10 +274,19 @@ namespace Ice
         [[nodiscard]] std::future<std::optional<LocatorPrx>> getLocatorAsync(const Ice::Context& context = Ice::noExplicitContext) const;
 
         /// Gets a proxy to the associated ::Ice::LocatorPrx. 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 locator 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/LocatorRegistry.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 'LocatorRegistry.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
@@ -105,9 +105,18 @@ namespace Ice
         /// @param proxy A dummy proxy created by the object adapter. @p proxy carries the object adapter's endpoints.
         /// The locator considers an object adapter to be active after it has registered its endpoints.
         /// When @p proxy is null, the endpoints are unregistered and the locator considers the object adapter inactive.
-        /// @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)
@@ -151,9 +160,18 @@ namespace Ice
         /// @param proxy A dummy proxy created by the object adapter. @p proxy carries the object adapter's endpoints.
         /// The locator considers an object adapter to be active after it has registered its endpoints. When @p proxy is
         /// null, the endpoints are unregistered and the locator considers the object adapter inactive.
-        /// @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)
@@ -180,9 +198,18 @@ namespace Ice
         /// Registers a proxy to the ::Ice::ProcessPrx object of a server application.
         /// @param id The server ID.
         /// @param proxy A proxy to the ::Ice::ProcessPrx object of the server. 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.
         // NOLINTNEXTLINE(modernize-use-nodiscard)