libdatadog 25.0.0.1.0-aarch64-linux → 27.0.0.1.0-aarch64-linux

data/vendor/{libdatadog-25.0.0/aarch64-linux-musl/libdatadog-aarch64-alpine-linux-musl → libdatadog-27.0.0/aarch64-linux/libdatadog-aarch64-unknown-linux-gnu}/include/datadog/profiling.h

@@ -10,6 +10,7 @@
 #include <stdbool.h>
 #include <stddef.h>
 #include <stdint.h>
+// Forward declarations for types used in common.h to avoid circular dependencies
 #include "common.h"
 struct TokioCancellationToken;
 
@@ -61,16 +62,20 @@ DDOG_CHECK_RETURN struct ddog_prof_Exporter_Slice_File ddog_prof_Exporter_Slice_
  * Creates an endpoint that uses the agent.
  * # Arguments
  * * `base_url` - Contains a URL with scheme, host, and port e.g. "https://agent:8126/".
+ * * `timeout_ms` - Timeout in milliseconds. Use 0 for default timeout (3000ms).
  */
-struct ddog_prof_Endpoint ddog_prof_Endpoint_agent(ddog_CharSlice base_url);
+struct ddog_prof_Endpoint ddog_prof_Endpoint_agent(ddog_CharSlice base_url, uint64_t timeout_ms);
 
 /**
  * Creates an endpoint that uses the Datadog intake directly aka agentless.
  * # Arguments
  * * `site` - Contains a host and port e.g. "datadoghq.com".
  * * `api_key` - Contains the Datadog API key.
+ * * `timeout_ms` - Timeout in milliseconds. Use 0 for default timeout (3000ms).
  */
-struct ddog_prof_Endpoint ddog_prof_Endpoint_agentless(ddog_CharSlice site, ddog_CharSlice api_key);
+struct ddog_prof_Endpoint ddog_prof_Endpoint_agentless(ddog_CharSlice site,
+                                                       ddog_CharSlice api_key,
+                                                       uint64_t timeout_ms);
 
 /**
  * Creates an endpoint that writes to a file.
@@ -105,16 +110,6 @@ struct ddog_prof_ProfileExporter_Result ddog_prof_Exporter_new(ddog_CharSlice pr
                                                                const struct ddog_Vec_Tag *tags,
                                                                struct ddog_prof_Endpoint endpoint);
 
-/**
- * Sets the value for the exporter's timeout.
- * # Arguments
- * * `exporter` - ProfileExporter instance.
- * * `timeout_ms` - timeout in milliseconds.
- */
-DDOG_CHECK_RETURN
-struct ddog_VoidResult ddog_prof_Exporter_set_timeout(struct ddog_prof_ProfileExporter *exporter,
-                                                      uint64_t timeout_ms);
-
 /**
  * # Safety
  * The `exporter` may be null, but if non-null the pointer must point to a
@@ -124,58 +119,30 @@ struct ddog_VoidResult ddog_prof_Exporter_set_timeout(struct ddog_prof_ProfileEx
 void ddog_prof_Exporter_drop(struct ddog_prof_ProfileExporter *exporter);
 
 /**
- * If successful, builds a `ddog_prof_Exporter_Request` object based on the
- * profile data supplied. If unsuccessful, it returns an error message.
- *
- * For details on the `optional_internal_metadata_json`, please reference the Datadog-internal
- * "RFC: Attaching internal metadata to pprof profiles".
- * If you use this parameter, please update the RFC with your use-case, so we can keep track of how
- * this is getting used.
- *
- * For details on the `optional_info_json`, please reference the Datadog-internal
- * "RFC: Pprof System Info Support".
- *
- * # Safety
- * The `exporter`, `optional_additional_stats`, and `optional_endpoint_stats` args should be
- * valid objects created by this module.
- * NULL is allowed for `optional_additional_tags`, `optional_endpoints_stats`,
- * `optional_internal_metadata_json` and `optional_info_json`.
- * Consumes the `SerializedProfile`
- */
-DDOG_CHECK_RETURN
-struct ddog_prof_Request_Result ddog_prof_Exporter_Request_build(struct ddog_prof_ProfileExporter *exporter,
-                                                                 struct ddog_prof_EncodedProfile *profile,
-                                                                 struct ddog_prof_Exporter_Slice_File files_to_compress_and_export,
-                                                                 struct ddog_prof_Exporter_Slice_File files_to_export_unmodified,
-                                                                 const struct ddog_Vec_Tag *optional_additional_tags,
-                                                                 const ddog_CharSlice *optional_process_tags,
-                                                                 const ddog_CharSlice *optional_internal_metadata_json,
-                                                                 const ddog_CharSlice *optional_info_json);
-
-/**
- * # Safety
- * Each pointer of `request` may be null, but if non-null the inner-most
- * pointer must point to a valid `ddog_prof_Exporter_Request` object made by
- * the Rust Global allocator.
- */
-void ddog_prof_Exporter_Request_drop(struct ddog_prof_Request *request);
-
-/**
- * Sends the request, returning the HttpStatus.
+ * Builds a request and sends it, returning the HttpStatus.
  *
  * # Arguments
- * * `exporter` - Borrows the exporter for sending the request.
- * * `request` - Takes ownership of the request, replacing it with a null pointer. This is why it
- *   takes a double-pointer, rather than a single one.
- * * `cancel` - Borrows the cancel, if any.
+ * * `exporter` - Borrows the exporter.
+ * * `profile` - Takes ownership of the profile.
+ * * `files_to_compress_and_export` - Files to compress and attach to the profile.
+ * * `optional_additional_tags` - Additional tags to include with this profile.
+ * * `optional_process_tags` - Process-level tags as a comma-separated string.
+ * * `optional_internal_metadata_json` - Internal metadata as a JSON string.
+ * * `optional_info_json` - System info as a JSON string.
+ * * `cancel` - Optional cancellation token.
  *
  * # Safety
- * All non-null arguments MUST have been created by created by apis in this module.
+ * All non-null arguments MUST have been created by APIs in this module.
  */
 DDOG_CHECK_RETURN
-struct ddog_prof_Result_HttpStatus ddog_prof_Exporter_send(struct ddog_prof_ProfileExporter *exporter,
-                                                           struct ddog_prof_Request *request,
-                                                           struct ddog_CancellationToken *cancel);
+struct ddog_prof_Result_HttpStatus ddog_prof_Exporter_send_blocking(struct ddog_prof_ProfileExporter *exporter,
+                                                                    struct ddog_prof_EncodedProfile *profile,
+                                                                    struct ddog_prof_Exporter_Slice_File files_to_compress_and_export,
+                                                                    const struct ddog_Vec_Tag *optional_additional_tags,
+                                                                    const ddog_CharSlice *optional_process_tags,
+                                                                    const ddog_CharSlice *optional_internal_metadata_json,
+                                                                    const ddog_CharSlice *optional_info_json,
+                                                                    struct ddog_CancellationToken *cancel);
 
 /**
  * Can be passed as an argument to send and then be used to asynchronously cancel it from a
@@ -226,6 +193,112 @@ bool ddog_CancellationToken_cancel(struct ddog_CancellationToken *cancel);
  */
 void ddog_CancellationToken_drop(struct ddog_CancellationToken *token);
 
+/**
+ * Creates a new ExporterManager with a background worker thread.
+ *
+ * The ExporterManager provides asynchronous profle export capabilities through a
+ * background worker thread and bounded channel.
+ *
+ * # Arguments
+ * * `exporter` - Takes ownership of the ProfileExporter to use for sending profiles.
+ *
+ * # Safety
+ * The `exporter` must point to a valid ProfileExporter that has not been dropped.
+ */
+DDOG_CHECK_RETURN
+struct ddog_prof_Result_HandleExporterManager ddog_prof_ExporterManager_new(struct ddog_prof_ProfileExporter *exporter);
+
+/**
+ * Queues a profile to be sent asynchronously by the background worker thread.
+ *
+ * **Important**: This function resets the profile and queues the *previous* profile data.
+ * After calling this, the profile will be empty and ready for new samples.
+ *
+ * # Arguments
+ * * `manager` - Borrows the ExporterManager.
+ * * `profile` - Takes ownership of the profile to send.
+ * * `files_to_compress_and_export` - Files to compress and attach to the profile.
+ * * `optional_additional_tags` - Additional tags to include with this profile.
+ * * `optional_process_tags` - Process-level tags as a comma-separated string.
+ * * `optional_internal_metadata_json` - Internal metadata as a JSON string.
+ * * `optional_info_json` - System info as a JSON string.
+ *
+ * # Safety
+ * All non-null arguments MUST have been created by APIs in this module.
+ */
+DDOG_CHECK_RETURN
+struct ddog_VoidResult ddog_prof_ExporterManager_queue(struct ddog_prof_Handle_ExporterManager *manager,
+                                                       struct ddog_prof_EncodedProfile *profile,
+                                                       struct ddog_prof_Exporter_Slice_File files_to_compress_and_export,
+                                                       const struct ddog_Vec_Tag *optional_additional_tags,
+                                                       const ddog_CharSlice *optional_process_tags,
+                                                       const ddog_CharSlice *optional_internal_metadata_json,
+                                                       const ddog_CharSlice *optional_info_json);
+
+/**
+ * Aborts the manager, stopping the worker thread and returning inflight requests.
+ *
+ * **Note**: This consumes the manager - it cannot be used after calling abort.
+ *
+ * # Arguments
+ * * `manager` - Takes ownership of the ExporterManager.
+ *
+ * # Safety
+ * The `manager` must point to a valid ExporterManager that has not been dropped.
+ */
+DDOG_CHECK_RETURN
+struct ddog_VoidResult ddog_prof_ExporterManager_abort(struct ddog_prof_Handle_ExporterManager *manager);
+
+/**
+ * Suspends the manager before forking (prefork).
+ *
+ * **Note**: This consumes the manager - it cannot be used after calling prefork.
+ *
+ * # Arguments
+ * * `manager` - Takes ownership of the ExporterManager.
+ *
+ * # Safety
+ * The `manager` must point to a valid ExporterManager that has not been dropped.
+ */
+DDOG_CHECK_RETURN
+struct ddog_VoidResult ddog_prof_ExporterManager_prefork(struct ddog_prof_Handle_ExporterManager *manager);
+
+/**
+ * Creates a new manager in the child process after forking (postfork_child).
+ *
+ * Inflight requests from the parent are discarded in the child.
+ *
+ * # Arguments
+ * * `suspended` - Takes ownership of the suspended ExporterManager.
+ *
+ * # Safety
+ * The `suspended` must point to a valid suspended ExporterManager that has not been dropped.
+ */
+DDOG_CHECK_RETURN
+struct ddog_VoidResult ddog_prof_ExporterManager_postfork_child(struct ddog_prof_Handle_ExporterManager *suspended);
+
+/**
+ * Creates a new manager in the parent process after forking (postfork_parent).
+ *
+ * Inflight requests from before the fork are re-queued in the new manager.
+ *
+ * # Arguments
+ * * `suspended` - Takes ownership of the suspended ExporterManager.
+ *
+ * # Safety
+ * The `suspended` must point to a valid suspended ExporterManager that has not been dropped.
+ */
+DDOG_CHECK_RETURN
+struct ddog_VoidResult ddog_prof_ExporterManager_postfork_parent(struct ddog_prof_Handle_ExporterManager *suspended);
+
+/**
+ * # Safety
+ * The `manager` may be null, but if non-null the pointer must point to a
+ * valid `ExporterManager` object made by the Rust Global allocator that
+ * has not already been dropped.
+ */
+void ddog_prof_ExporterManager_drop(struct ddog_prof_Handle_ExporterManager *manager);
+
 /**
  * Frees any error associated with the status, and replaces it with an OK.
  *
@@ -240,7 +313,7 @@ void ddog_prof_Status_drop(struct ddog_prof_Status *status);
  * `ddog_prof_Profile_drop` when you are done with the profile.
  *
  * # Arguments
- * * `sample_types`
+ * * `sample_types` - A slice of SampleType enums
  * * `period` - Optional period of the profile. Passing None/null translates to zero values.
  * * `start_time` - Optional time the profile started at. Passing None/null will use the current
  *   time.
@@ -250,7 +323,7 @@ void ddog_prof_Status_drop(struct ddog_prof_Status *status);
  * and must have the correct number of elements for the slice.
  */
 DDOG_CHECK_RETURN
-struct ddog_prof_Profile_NewResult ddog_prof_Profile_new(struct ddog_prof_Slice_ValueType sample_types,
+struct ddog_prof_Profile_NewResult ddog_prof_Profile_new(struct ddog_prof_Slice_SampleType sample_types,
                                                          const struct ddog_prof_Period *period);
 
 /**
@@ -260,7 +333,7 @@ struct ddog_prof_Profile_NewResult ddog_prof_Profile_new(struct ddog_prof_Slice_
  * # Arguments
  * * `out` - a non-null pointer to an uninitialized Profile.
  * * `dict`: a valid reference to a ProfilesDictionary handle.
- * * `sample_types`
+ * * `sample_types` - A slice of SampleType enums
  * * `period` - Optional period of the profile. Passing None/null translates to zero values.
  *
  * # Safety
@@ -276,7 +349,7 @@ struct ddog_prof_Profile_NewResult ddog_prof_Profile_new(struct ddog_prof_Slice_
 DDOG_CHECK_RETURN
 struct ddog_prof_Status ddog_prof_Profile_with_dictionary(struct ddog_prof_Profile *out,
                                                           const ddog_prof_ProfilesDictionaryHandle *dict,
-                                                          struct ddog_prof_Slice_ValueType sample_types,
+                                                          struct ddog_prof_Slice_SampleType sample_types,
                                                           const struct ddog_prof_Period *period);
 
 /**
@@ -284,7 +357,7 @@ struct ddog_prof_Status ddog_prof_Profile_with_dictionary(struct ddog_prof_Profi
  * TODO: @ivoanjo Should this take a `*mut ManagedStringStorage` like Profile APIs do?
  */
 DDOG_CHECK_RETURN
-struct ddog_prof_Profile_NewResult ddog_prof_Profile_with_string_storage(struct ddog_prof_Slice_ValueType sample_types,
+struct ddog_prof_Profile_NewResult ddog_prof_Profile_with_string_storage(struct ddog_prof_Slice_SampleType sample_types,
                                                                          const struct ddog_prof_Period *period,
                                                                          struct ddog_prof_ManagedStringStorage string_storage);
 
@@ -856,6 +929,11 @@ struct ddog_prof_Status ddog_prof_ProfilesDictionary_insert_mapping(ddog_prof_Ma
 /**
  * Inserts a UTF-8 string into the dictionary string table.
  *
+ * Copies the string into the internal buffer--strings are arena allocated
+ * and not individually allocated. On success, the [`StringId2`] written to
+ * the `string_id` out parameter is valid as long as this dictionary is alive.
+ * It should only be passed back to the dictionary that created it.
+ *
  * # Safety
  *
  * - `string_id` must be non-null and valid for writes of `StringId`.

data/vendor/{libdatadog-25.0.0 → libdatadog-27.0.0}/aarch64-linux/libdatadog-aarch64-unknown-linux-gnu/lib/pkgconfig/datadog_profiling_with_rpath.pc

@@ -8,7 +8,7 @@ includedir=${prefix}/include
 
 Name: datadog_profiling
 Description: Contains common code used to implement Datadog's Continuous Profilers. (Dynamic linking variant, sets rpath)
-Version: 25.0.0
+Version: 27.0.0
 Requires:
 Libs: -L${libdir} -ldatadog_profiling -Wl,-rpath,${libdir}
 Libs.private: