libdatadog 25.0.0.1.0 → 26.0.0.1.0

data/vendor/libdatadog-26.0.0/x86_64-linux/libdatadog-x86_64-unknown-linux-gnu/include/datadog/data-pipeline.h

@@ -0,0 +1,183 @@
+// Copyright 2021-Present Datadog, Inc. https://www.datadoghq.com/
+// SPDX-License-Identifier: Apache-2.0
+
+
+#ifndef DDOG_DATA_PIPELINE_H
+#define DDOG_DATA_PIPELINE_H
+
+#include <stdarg.h>
+#include <stdbool.h>
+#include <stdint.h>
+#include <stdlib.h>
+#include "common.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif // __cplusplus
+
+/**
+ * Frees `error` and all its contents. After being called error will not point to a valid memory
+ * address so any further actions on it could lead to undefined behavior.
+ */
+void ddog_trace_exporter_error_free(struct ddog_TraceExporterError *error);
+
+/**
+ * Return a read-only pointer to the response body. This pointer is only valid as long as
+ * `response` is valid.
+ */
+const uint8_t *ddog_trace_exporter_response_get_body(const struct ddog_TraceExporterResponse *response,
+                                                     uintptr_t *out_len);
+
+/**
+ * Free `response` and all its contents. After being called response will not point to a valid
+ * memory address so any further actions on it could lead to undefined behavior.
+ */
+void ddog_trace_exporter_response_free(struct ddog_TraceExporterResponse *response);
+
+void ddog_trace_exporter_config_new(struct ddog_TraceExporterConfig **out_handle);
+
+/**
+ * Frees TraceExporterConfig handle internal resources.
+ */
+void ddog_trace_exporter_config_free(struct ddog_TraceExporterConfig *handle);
+
+/**
+ * Sets traces destination.
+ */
+struct ddog_TraceExporterError *ddog_trace_exporter_config_set_url(struct ddog_TraceExporterConfig *config,
+                                                                   ddog_CharSlice url);
+
+/**
+ * Sets tracer's version to be included in the headers request.
+ */
+struct ddog_TraceExporterError *ddog_trace_exporter_config_set_tracer_version(struct ddog_TraceExporterConfig *config,
+                                                                              ddog_CharSlice version);
+
+/**
+ * Sets tracer's language to be included in the headers request.
+ */
+struct ddog_TraceExporterError *ddog_trace_exporter_config_set_language(struct ddog_TraceExporterConfig *config,
+                                                                        ddog_CharSlice lang);
+
+/**
+ * Sets tracer's language version to be included in the headers request.
+ */
+struct ddog_TraceExporterError *ddog_trace_exporter_config_set_lang_version(struct ddog_TraceExporterConfig *config,
+                                                                            ddog_CharSlice version);
+
+/**
+ * Sets tracer's language interpreter to be included in the headers request.
+ */
+struct ddog_TraceExporterError *ddog_trace_exporter_config_set_lang_interpreter(struct ddog_TraceExporterConfig *config,
+                                                                                ddog_CharSlice interpreter);
+
+/**
+ * Sets hostname information to be included in the headers request.
+ */
+struct ddog_TraceExporterError *ddog_trace_exporter_config_set_hostname(struct ddog_TraceExporterConfig *config,
+                                                                        ddog_CharSlice hostname);
+
+/**
+ * Sets environment information to be included in the headers request.
+ */
+struct ddog_TraceExporterError *ddog_trace_exporter_config_set_env(struct ddog_TraceExporterConfig *config,
+                                                                   ddog_CharSlice env);
+
+struct ddog_TraceExporterError *ddog_trace_exporter_config_set_version(struct ddog_TraceExporterConfig *config,
+                                                                       ddog_CharSlice version);
+
+/**
+ * Sets service name to be included in the headers request.
+ */
+struct ddog_TraceExporterError *ddog_trace_exporter_config_set_service(struct ddog_TraceExporterConfig *config,
+                                                                       ddog_CharSlice service);
+
+/**
+ * Enables health metrics emission.
+ */
+struct ddog_TraceExporterError *ddog_trace_exporter_config_enable_health_metrics(struct ddog_TraceExporterConfig *config,
+                                                                                 bool is_enabled);
+
+/**
+ * Enables telemetry metrics.
+ */
+struct ddog_TraceExporterError *ddog_trace_exporter_config_enable_telemetry(struct ddog_TraceExporterConfig *config,
+                                                                            const struct ddog_TelemetryClientConfig *telemetry_cfg);
+
+/**
+ * Set client-side stats computation status.
+ */
+struct ddog_TraceExporterError *ddog_trace_exporter_config_set_compute_stats(struct ddog_TraceExporterConfig *config,
+                                                                             bool is_enabled);
+
+/**
+ * Sets `Datadog-Client-Computed-Stats` header to `true`.
+ * This indicates that the upstream system has already computed the stats,
+ * and no further stats computation should be performed.
+ *
+ * <div class="warning">
+ * This method must not be used when `compute_stats` is enabled, as it could
+ * result in duplicate stats computation.
+ * </div>
+ *
+ * A common use case is in Application Security Monitoring (ASM) scenarios:
+ * when APM is disabled but ASM is enabled, setting this header to `true`
+ * ensures that no stats are computed at any level (exporter or agent).
+ */
+struct ddog_TraceExporterError *ddog_trace_exporter_config_set_client_computed_stats(struct ddog_TraceExporterConfig *config,
+                                                                                     bool client_computed_stats);
+
+/**
+ * Sets the `X-Datadog-Test-Session-Token` header. Only used for testing with the test agent.
+ */
+struct ddog_TraceExporterError *ddog_trace_exporter_config_set_test_session_token(struct ddog_TraceExporterConfig *config,
+                                                                                  ddog_CharSlice token);
+
+/**
+ * Sets the timeout in ms for all agent's connections.
+ */
+struct ddog_TraceExporterError *ddog_trace_exporter_config_set_connection_timeout(struct ddog_TraceExporterConfig *config,
+                                                                                  uint64_t timeout_ms);
+
+/**
+ * Create a new TraceExporter instance.
+ *
+ * # Arguments
+ *
+ * * `out_handle` - The handle to write the TraceExporter instance in.
+ * * `config` - The configuration used to set up the TraceExporter handle.
+ */
+struct ddog_TraceExporterError *ddog_trace_exporter_new(struct ddog_TraceExporter **out_handle,
+                                                        const struct ddog_TraceExporterConfig *config);
+
+/**
+ * Free the TraceExporter instance.
+ *
+ * # Arguments
+ *
+ * * handle - The handle to the TraceExporter instance.
+ */
+void ddog_trace_exporter_free(struct ddog_TraceExporter *handle);
+
+/**
+ * Send traces to the Datadog Agent.
+ *
+ * # Arguments
+ *
+ * * `handle` - The handle to the TraceExporter instance.
+ * * `trace` - The traces to send to the Datadog Agent in the input format used to create the
+ *   TraceExporter. The memory for the trace must be valid for the life of the call to this
+ *   function.
+ * * `trace_count` - The number of traces to send to the Datadog Agent.
+ * * `response_out` - Optional handle to store a pointer to the agent response information.
+ */
+struct ddog_TraceExporterError *ddog_trace_exporter_send(const struct ddog_TraceExporter *handle,
+                                                         ddog_ByteSlice trace,
+                                                         uintptr_t trace_count,
+                                                         struct ddog_TraceExporterResponse **response_out);
+
+#ifdef __cplusplus
+}  // extern "C"
+#endif  // __cplusplus
+
+#endif  /* DDOG_DATA_PIPELINE_H */

data/vendor/libdatadog-26.0.0/x86_64-linux/libdatadog-x86_64-unknown-linux-gnu/include/datadog/ddsketch.h

@@ -0,0 +1,89 @@
+// Copyright 2025-Present Datadog, Inc. https://www.datadoghq.com/
+// SPDX-License-Identifier: Apache-2.0
+
+
+#ifndef DDOG_DDSKETCH_H
+#define DDOG_DDSKETCH_H
+
+#pragma once
+
+#include <stdbool.h>
+#include <stddef.h>
+#include <stdint.h>
+#include "common.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif // __cplusplus
+
+/**
+ * Creates a new DDSketch instance with default configuration.
+ */
+struct ddsketch_Handle_DDSketch ddog_ddsketch_new(void);
+
+/**
+ * Drops a DDSketch instance.
+ *
+ * # Safety
+ *
+ * The sketch handle must have been created by this library and not already dropped.
+ */
+void ddog_ddsketch_drop(struct ddsketch_Handle_DDSketch *sketch);
+
+/**
+ * Adds a point to the DDSketch.
+ *
+ * # Safety
+ *
+ * The `sketch` parameter must be a valid pointer to a DDSketch handle.
+ */
+struct ddog_VoidResult ddog_ddsketch_add(struct ddsketch_Handle_DDSketch *sketch, double point);
+
+/**
+ * Adds a point with a specific count to the DDSketch.
+ *
+ * # Safety
+ *
+ * The `sketch` parameter must be a valid pointer to a DDSketch handle.
+ */
+struct ddog_VoidResult ddog_ddsketch_add_with_count(struct ddsketch_Handle_DDSketch *sketch,
+                                                    double point,
+                                                    double count);
+
+/**
+ * Returns the count of points in the DDSketch via the output parameter.
+ *
+ * # Safety
+ *
+ * The `sketch` parameter must be a valid pointer to a DDSketch handle.
+ * The `count_out` parameter must be a valid pointer to uninitialized f64 memory.
+ */
+struct ddog_VoidResult ddog_ddsketch_count(struct ddsketch_Handle_DDSketch *sketch,
+                                           double *count_out);
+
+/**
+ * Returns the protobuf-encoded bytes of the DDSketch.
+ * The sketch handle is consumed by this operation.
+ *
+ * # Safety
+ *
+ * The `sketch` parameter must be a valid pointer to a DDSketch handle.
+ * The returned vector must be freed with `ddog_Vec_U8_drop`.
+ */
+struct ddog_Vec_U8 ddog_ddsketch_encode(struct ddsketch_Handle_DDSketch *sketch);
+
+/**
+ * Frees the memory allocated for a Vec<u8> returned by ddsketch functions.
+ *
+ * # Safety
+ *
+ * The vec parameter must be a valid Vec<u8> returned by this library.
+ * After being called, the vec will not point to valid memory.
+ */
+void ddog_Vec_U8_drop(struct ddog_Vec_U8 _vec);
+
+#ifdef __cplusplus
+}  // extern "C"
+#endif  // __cplusplus
+
+#endif  /* DDOG_DDSKETCH_H */

data/vendor/libdatadog-26.0.0/x86_64-linux/libdatadog-x86_64-unknown-linux-gnu/include/datadog/ffe.h

@@ -0,0 +1,175 @@
+// Copyright 2025-Present Datadog, Inc. https://www.datadoghq.com/
+// SPDX-License-Identifier: Apache-2.0
+
+
+#ifndef DDOG_FFE_H
+#define DDOG_FFE_H
+
+#pragma once
+
+#include <stdbool.h>
+#include <stddef.h>
+#include <stdint.h>
+#include "common.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif // __cplusplus
+
+/**
+ * Evaluates a feature flag.
+ *
+ * # Ownership
+ *
+ * The caller must call `ddog_ffe_assignment_drop` on the returned value to free resources.
+ *
+ * # Safety
+ *
+ * - `config` must be a valid `Configuration` handle
+ * - `flag_key` must be a valid C string
+ * - `context` must be a valid `EvaluationContext` handle
+ */
+DDOG_CHECK_RETURN
+ddog_ffe_Handle_ResolutionDetails ddog_ffe_get_assignment(ddog_ffe_Handle_Configuration config,
+                                                          const char *flag_key,
+                                                          enum ddog_ffe_ExpectedFlagType expected_type,
+                                                          ddog_ffe_Handle_EvaluationContext context);
+
+/**
+ * Get value produced by evaluation.
+ *
+ * # Ownership
+ *
+ * The returned `VariantValue` borrows from `assignment`. It must not be used after `assignment` is
+ * freed.
+ *
+ * # Safety
+ * `assignment` must be a valid handle.
+ */
+struct ddog_ffe_VariantValue ddog_ffe_assignment_get_value(ddog_ffe_Handle_ResolutionDetails assignment);
+
+/**
+ * Get variant key produced by evaluation. Returns `NULL` if evaluation did not produce any value.
+ *
+ * # Ownership
+ *
+ * The returned string borrows from `assignment`. It must not be used after `assignment` is
+ * freed.
+ *
+ * # Safety
+ * `assignment` must be a valid handle.
+ */
+struct ddog_ffe_BorrowedStr ddog_ffe_assignment_get_variant(ddog_ffe_Handle_ResolutionDetails assignment);
+
+/**
+ * Get allocation key produced by evaluation. Returns `NULL` if evaluation did not produce any
+ * value.
+ *
+ * # Ownership
+ *
+ * The returned string borrows from `assignment`. It must not be used after `assignment` is
+ * freed.
+ *
+ * # Safety
+ * `assignment` must be a valid handle.
+ */
+struct ddog_ffe_BorrowedStr ddog_ffe_assignment_get_allocation_key(ddog_ffe_Handle_ResolutionDetails assignment);
+
+/**
+ * # Safety
+ * `assignment` must be a valid handle.
+ */
+enum ddog_ffe_Reason ddog_ffe_assignment_get_reason(ddog_ffe_Handle_ResolutionDetails assignment);
+
+/**
+ * # Safety
+ * `assignment` must be a valid handle.
+ */
+enum ddog_ffe_ErrorCode ddog_ffe_assignment_get_error_code(ddog_ffe_Handle_ResolutionDetails assignment);
+
+/**
+ * # Safety
+ * `assignment` must be a valid handle.
+ */
+struct ddog_ffe_BorrowedStr ddog_ffe_assignment_get_error_message(ddog_ffe_Handle_ResolutionDetails assignment);
+
+/**
+ * # Safety
+ * `assignment` must be a valid handle.
+ */
+bool ddog_ffe_assignment_get_do_log(ddog_ffe_Handle_ResolutionDetails assignment);
+
+/**
+ * # Safety
+ * `assignment` must be a valid handle.
+ */
+struct ddog_ffe_ArrayMap_BorrowedStr ddog_ffe_assignnment_get_flag_metadata(ddog_ffe_Handle_ResolutionDetails assignment);
+
+/**
+ * # Safety
+ * `assignment` must be a valid handle.
+ */
+struct ddog_ffe_ArrayMap_BorrowedStr ddog_ffe_assignnment_get_extra_logging(ddog_ffe_Handle_ResolutionDetails assignment);
+
+/**
+ * Frees an Assignment handle.
+ *
+ * # Safety
+ * - `assignment` must be a valid Assignment handle
+ */
+void ddog_ffe_assignment_drop(ddog_ffe_Handle_ResolutionDetails *assignment);
+
+/**
+ * Creates a new Configuration from JSON bytes.
+ *
+ * # Ownership
+ *
+ * The caller must call `ddog_ffe_configuration_drop` to release resources allocated for
+ * configuration.
+ *
+ * # Safety
+ *
+ * - `json_bytes` must point to valid memory.
+ */
+DDOG_CHECK_RETURN
+struct ddog_ffe_Result_HandleConfiguration ddog_ffe_configuration_new(struct ddog_ffe_BorrowedStr json_bytes);
+
+/**
+ * Frees a Configuration.
+ *
+ * # Safety
+ *
+ * `config` must be a valid Configuration handle created by `ddog_ffe_configuration_new`.
+ */
+void ddog_ffe_configuration_drop(ddog_ffe_Handle_Configuration *config);
+
+/**
+ * Creates a new EvaluationContext with the given targeting key and attributes.
+ *
+ * # Ownership
+ *
+ * `ddog_ffe_evaluation_context_drop` must be called on the result value to free resources.
+ *
+ * # Safety
+ * - `targeting_key` must be a valid C string or NULL.
+ * - `attributes` must point to a valid array of valid `AttributePair` structs (can be null if
+ *   `attributes_count` is 0)
+ */
+DDOG_CHECK_RETURN
+ddog_ffe_Handle_EvaluationContext ddog_ffe_evaluation_context_new(const char *targeting_key,
+                                                                  const struct ddog_ffe_AttributePair *attributes,
+                                                                  uintptr_t attributes_count);
+
+/**
+ * Frees an EvaluationContext
+ *
+ * # Safety
+ * `context` must be a valid EvaluationContext handle created by `ddog_ffe_evaluation_context_new`
+ */
+void ddog_ffe_evaluation_context_drop(ddog_ffe_Handle_EvaluationContext *context);
+
+#ifdef __cplusplus
+}  // extern "C"
+#endif  // __cplusplus
+
+#endif  /* DDOG_FFE_H */

data/vendor/libdatadog-26.0.0/x86_64-linux/libdatadog-x86_64-unknown-linux-gnu/include/datadog/library-config.h

@@ -0,0 +1,113 @@
+// Copyright 2021-Present Datadog, Inc. https://www.datadoghq.com/
+// SPDX-License-Identifier: Apache-2.0
+
+
+#ifndef DDOG_LIBRARY_CONFIG_H
+#define DDOG_LIBRARY_CONFIG_H
+
+#pragma once
+
+#include "common.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif // __cplusplus
+
+struct ddog_Configurator *ddog_library_configurator_new(bool debug_logs, ddog_CharSlice language);
+
+void ddog_library_configurator_with_local_path(struct ddog_Configurator *c,
+                                               struct ddog_CStr local_path);
+
+void ddog_library_configurator_with_fleet_path(struct ddog_Configurator *c,
+                                               struct ddog_CStr local_path);
+
+void ddog_library_configurator_with_process_info(struct ddog_Configurator *c,
+                                                 struct ddog_ProcessInfo p);
+
+void ddog_library_configurator_with_detect_process_info(struct ddog_Configurator *c);
+
+void ddog_library_configurator_drop(struct ddog_Configurator*);
+
+struct ddog_LibraryConfigLoggedResult ddog_library_configurator_get(const struct ddog_Configurator *configurator);
+
+/**
+ * Returns a static null-terminated string, containing the name of the environment variable
+ * associated with the library configuration
+ */
+struct ddog_CStr ddog_library_config_source_to_string(enum ddog_LibraryConfigSource name);
+
+/**
+ * Returns a static null-terminated string with the path to the managed stable config yaml config
+ * file
+ */
+struct ddog_CStr ddog_library_config_fleet_stable_config_path(void);
+
+/**
+ * Returns a static null-terminated string with the path to the local stable config yaml config
+ * file
+ */
+struct ddog_CStr ddog_library_config_local_stable_config_path(void);
+
+void ddog_library_config_drop(struct ddog_LibraryConfigLoggedResult config_result);
+
+/**
+ * Allocates and returns a pointer to a new `TracerMetadata` object on the heap.
+ *
+ * # Safety
+ * This function returns a raw pointer. The caller is responsible for calling
+ * `ddog_tracer_metadata_free` to deallocate the memory.
+ *
+ * # Returns
+ * A non-null pointer to a newly allocated `TracerMetadata` instance.
+ */
+struct ddog_TracerMetadata *ddog_tracer_metadata_new(void);
+
+/**
+ * Frees a `TracerMetadata` instance previously allocated with `ddog_tracer_metadata_new`.
+ *
+ * # Safety
+ * - `ptr` must be a pointer previously returned by `ddog_tracer_metadata_new`.
+ * - Double-freeing or passing an invalid pointer results in undefined behavior.
+ * - Passing a null pointer is safe and does nothing.
+ */
+void ddog_tracer_metadata_free(struct ddog_TracerMetadata *ptr);
+
+/**
+ * Sets a field of the `TracerMetadata` object pointed to by `ptr`.
+ *
+ * # Arguments
+ * - `ptr`: Pointer to a `TracerMetadata` instance.
+ * - `kind`: The metadata field to set (as defined in `MetadataKind`).
+ * - `value`: A null-terminated C string representing the value to set.
+ *
+ * # Safety
+ * - Both `ptr` and `value` must be non-null.
+ * - `value` must point to a valid UTF-8 null-terminated string.
+ * - If the string is not valid UTF-8, the function does nothing.
+ */
+void ddog_tracer_metadata_set(struct ddog_TracerMetadata *ptr,
+                              enum ddog_MetadataKind kind,
+                              const char *value);
+
+/**
+ * Serializes the `TracerMetadata` into a platform-specific memory handle (e.g., memfd on Linux).
+ *
+ * # Safety
+ * - `ptr` must be a valid, non-null pointer to a `TracerMetadata`.
+ *
+ * # Returns
+ * - On Linux: a `TracerMemfdHandle` containing a raw file descriptor to a memory file.
+ * - On unsupported platforms: an error.
+ * - On failure: propagates any internal errors from the metadata storage process.
+ *
+ * # Platform Support
+ * This function currently only supports Linux via `memfd`. On other platforms,
+ * it will return an error.
+ */
+struct ddog_Result_TracerMemfdHandle ddog_tracer_metadata_store(struct ddog_TracerMetadata *ptr);
+
+#ifdef __cplusplus
+}  // extern "C"
+#endif  // __cplusplus
+
+#endif  /* DDOG_LIBRARY_CONFIG_H */

data/vendor/libdatadog-26.0.0/x86_64-linux/libdatadog-x86_64-unknown-linux-gnu/include/datadog/log.h

@@ -0,0 +1,63 @@
+// Copyright 2025-Present Datadog, Inc. https://www.datadoghq.com/
+// SPDX-License-Identifier: Apache-2.0
+
+
+#ifndef DDOG_LOG_H
+#define DDOG_LOG_H
+
+#include <stdbool.h>
+#include <stddef.h>
+#include <stdint.h>
+#include <stdio.h>
+#include "common.h"
+
+/**
+ * Configures the logger to write to stdout or stderr with the specified configuration.
+ *
+ * # Arguments
+ * * `config` - Configuration for standard stream logging including target
+ *
+ * # Errors
+ * Returns an error if the logger cannot be configured.
+ */
+struct ddog_Error *ddog_logger_configure_std(struct ddog_StdConfig config);
+
+/**
+ * Disables logging by configuring a no-op logger.
+ *
+ * # Errors
+ * Returns an error if the logger cannot be configured.
+ */
+struct ddog_Error *ddog_logger_disable_std(void);
+
+/**
+ * Configures the logger to write to a file with the specified configuration.
+ *
+ * # Arguments
+ * * `config` - Configuration for file logging including path
+ *
+ * # Errors
+ * Returns an error if the logger cannot be configured.
+ */
+struct ddog_Error *ddog_logger_configure_file(struct ddog_FileConfig config);
+
+/**
+ * Disables file logging by configuring a no-op file writer.
+ *
+ * # Errors
+ * Returns an error if the logger cannot be configured.
+ */
+struct ddog_Error *ddog_logger_disable_file(void);
+
+/**
+ * Sets the global log level.
+ *
+ * # Arguments
+ * * `log_level` - The minimum level for events to be logged
+ *
+ * # Errors
+ * Returns an error if the log level cannot be set.
+ */
+struct ddog_Error *ddog_logger_set_log_level(enum ddog_LogEventLevel log_level);
+
+#endif  /* DDOG_LOG_H */