libdatadog 18.1.0.1.0 → 21.0.0.1.0

data/vendor/{libdatadog-18.1.0 → libdatadog-21.0.0}/x86_64-linux/libdatadog-x86_64-unknown-linux-gnu/include/datadog/common.h

@@ -372,13 +372,6 @@ typedef enum ddog_VoidResult_Tag {
 typedef struct ddog_VoidResult {
   ddog_VoidResult_Tag tag;
   union {
-    struct {
-      /**
-       * Do not use the value of Ok. This value only exists to overcome
-       * Rust -> C code generation.
-       */
-      bool ok;
-    };
     struct {
       struct ddog_Error err;
     };
@@ -799,9 +792,9 @@ typedef struct ddog_prof_FunctionId_Result {
  * A value of 0 means "no string" or "empty string" (they are synonymous).
  */
 typedef struct OpaqueStringId {
-  uint32_t _0;
+  uint32_t offset;
 } OpaqueStringId;
-#define OpaqueStringId_ZERO (OpaqueStringId){ ._0 = 0 }
+#define OpaqueStringId_ZERO (OpaqueStringId){  }
 
 typedef struct OpaqueStringId OpaqueStringId;
 
@@ -1231,6 +1224,320 @@ typedef struct ddog_ContextKey {
   enum ddog_MetricType _1;
 } ddog_ContextKey;
 
+/**
+ * Represent error codes that `Error` struct can hold
+ */
+typedef enum ddog_TraceExporterErrorCode {
+  DDOG_TRACE_EXPORTER_ERROR_CODE_ADDRESS_IN_USE,
+  DDOG_TRACE_EXPORTER_ERROR_CODE_CONNECTION_ABORTED,
+  DDOG_TRACE_EXPORTER_ERROR_CODE_CONNECTION_REFUSED,
+  DDOG_TRACE_EXPORTER_ERROR_CODE_CONNECTION_RESET,
+  DDOG_TRACE_EXPORTER_ERROR_CODE_HTTP_BODY_FORMAT,
+  DDOG_TRACE_EXPORTER_ERROR_CODE_HTTP_BODY_TOO_LONG,
+  DDOG_TRACE_EXPORTER_ERROR_CODE_HTTP_CLIENT,
+  DDOG_TRACE_EXPORTER_ERROR_CODE_HTTP_EMPTY_BODY,
+  DDOG_TRACE_EXPORTER_ERROR_CODE_HTTP_PARSE,
+  DDOG_TRACE_EXPORTER_ERROR_CODE_HTTP_SERVER,
+  DDOG_TRACE_EXPORTER_ERROR_CODE_HTTP_UNKNOWN,
+  DDOG_TRACE_EXPORTER_ERROR_CODE_HTTP_WRONG_STATUS,
+  DDOG_TRACE_EXPORTER_ERROR_CODE_INVALID_ARGUMENT,
+  DDOG_TRACE_EXPORTER_ERROR_CODE_INVALID_DATA,
+  DDOG_TRACE_EXPORTER_ERROR_CODE_INVALID_INPUT,
+  DDOG_TRACE_EXPORTER_ERROR_CODE_INVALID_URL,
+  DDOG_TRACE_EXPORTER_ERROR_CODE_IO_ERROR,
+  DDOG_TRACE_EXPORTER_ERROR_CODE_NETWORK_UNKNOWN,
+  DDOG_TRACE_EXPORTER_ERROR_CODE_SERDE,
+  DDOG_TRACE_EXPORTER_ERROR_CODE_SHUTDOWN,
+  DDOG_TRACE_EXPORTER_ERROR_CODE_TIMED_OUT,
+  DDOG_TRACE_EXPORTER_ERROR_CODE_TELEMETRY,
+  DDOG_TRACE_EXPORTER_ERROR_CODE_INTERNAL,
+  DDOG_TRACE_EXPORTER_ERROR_CODE_PANIC,
+} ddog_TraceExporterErrorCode;
+
+/**
+ * Structure containing the agent response to a trace payload
+ * MUST be freed with `ddog_trace_exporter_response_free`
+ *
+ * If the agent payload version is enabled on the trace exporter, and
+ * the agent response indicates that the payload version hasn't changed,
+ * the body will be empty.
+ */
+typedef struct ddog_TraceExporterResponse ddog_TraceExporterResponse;
+
+typedef struct ddog_TraceExporter ddog_TraceExporter;
+
+/**
+ * The TraceExporterConfig object will hold the configuration properties for the TraceExporter.
+ * Once the configuration is passed to the TraceExporter constructor the config is no longer
+ * needed by the handle and it can be freed.
+ */
+typedef struct ddog_TraceExporterConfig ddog_TraceExporterConfig;
+
+/**
+ * Structure that contains error information that `TraceExporter` API can return.
+ */
+typedef struct ddog_TraceExporterError {
+  enum ddog_TraceExporterErrorCode code;
+  char *msg;
+} ddog_TraceExporterError;
+
+/**
+ * FFI compatible configuration for the TelemetryClient.
+ */
+typedef struct ddog_TelemetryClientConfig {
+  /**
+   * How often telemetry should be sent, in milliseconds.
+   */
+  uint64_t interval;
+  /**
+   * A V4 UUID that represents a tracer session. This ID should:
+   * - Be generated when the tracer starts
+   * - Be identical within the context of a host (i.e. multiple threads/processes that belong to
+   *   a single instrumented app should share the same runtime_id)
+   * - Be associated with traces to allow correlation between traces and telemetry data
+   */
+  ddog_CharSlice runtime_id;
+  /**
+   * Whether to enable debug mode for telemetry.
+   * When enabled, sets the DD-Telemetry-Debug-Enabled header to true.
+   * Defaults to false.
+   */
+  bool debug_enabled;
+} ddog_TelemetryClientConfig;
+
+typedef enum ddog_LibraryConfigSource {
+  DDOG_LIBRARY_CONFIG_SOURCE_LOCAL_STABLE_CONFIG = 0,
+  DDOG_LIBRARY_CONFIG_SOURCE_FLEET_STABLE_CONFIG = 1,
+} ddog_LibraryConfigSource;
+
+typedef struct ddog_Configurator ddog_Configurator;
+
+/**
+ * Ffi safe type representing a borrowed null-terminated C array
+ * Equivalent to a std::ffi::CStr
+ */
+typedef struct ddog_CStr {
+  /**
+   * Null terminated char array
+   */
+  char *ptr;
+  /**
+   * Length of the array, not counting the null-terminator
+   */
+  uintptr_t length;
+} ddog_CStr;
+
+typedef struct ddog_Slice_CharSlice {
+  /**
+   * Should be non-null and suitably aligned for the underlying type. It is
+   * allowed but not recommended for the pointer to be null when the len is
+   * zero.
+   */
+  const ddog_CharSlice *ptr;
+  /**
+   * The number of elements (not bytes) that `.ptr` points to. Must be less
+   * than or equal to [isize::MAX].
+   */
+  uintptr_t len;
+} ddog_Slice_CharSlice;
+
+typedef struct ddog_ProcessInfo {
+  struct ddog_Slice_CharSlice args;
+  struct ddog_Slice_CharSlice envp;
+  ddog_CharSlice language;
+} ddog_ProcessInfo;
+
+/**
+ * Ffi safe type representing an owned null-terminated C array
+ * Equivalent to a std::ffi::CString
+ */
+typedef struct ddog_CString {
+  /**
+   * Null terminated char array
+   */
+  char *ptr;
+  /**
+   * Length of the array, not counting the null-terminator
+   */
+  uintptr_t length;
+} ddog_CString;
+
+typedef struct ddog_LibraryConfig {
+  struct ddog_CString name;
+  struct ddog_CString value;
+  enum ddog_LibraryConfigSource source;
+  struct ddog_CString config_id;
+} ddog_LibraryConfig;
+
+/**
+ * Holds the raw parts of a Rust Vec; it should only be created from Rust,
+ * never from C.
+ */
+typedef struct ddog_Vec_LibraryConfig {
+  const struct ddog_LibraryConfig *ptr;
+  uintptr_t len;
+  uintptr_t capacity;
+} ddog_Vec_LibraryConfig;
+
+/**
+ * A result type that includes debug/log messages along with the data
+ */
+typedef struct ddog_OkResult {
+  struct ddog_Vec_LibraryConfig value;
+  struct ddog_CString logs;
+} ddog_OkResult;
+
+typedef enum ddog_LibraryConfigLoggedResult_Tag {
+  DDOG_LIBRARY_CONFIG_LOGGED_RESULT_OK,
+  DDOG_LIBRARY_CONFIG_LOGGED_RESULT_ERR,
+} ddog_LibraryConfigLoggedResult_Tag;
+
+typedef struct ddog_LibraryConfigLoggedResult {
+  ddog_LibraryConfigLoggedResult_Tag tag;
+  union {
+    struct {
+      struct ddog_OkResult ok;
+    };
+    struct {
+      struct ddog_Error err;
+    };
+  };
+} ddog_LibraryConfigLoggedResult;
+
+/**
+ * C-compatible representation of an anonymous file handle
+ */
+typedef struct ddog_TracerMemfdHandle {
+  /**
+   * File descriptor (relevant only on Linux)
+   */
+  int fd;
+} ddog_TracerMemfdHandle;
+
+/**
+ * A generic result type for when an operation may fail,
+ * or may return <T> in case of success.
+ */
+typedef enum ddog_Result_TracerMemfdHandle_Tag {
+  DDOG_RESULT_TRACER_MEMFD_HANDLE_OK_TRACER_MEMFD_HANDLE,
+  DDOG_RESULT_TRACER_MEMFD_HANDLE_ERR_TRACER_MEMFD_HANDLE,
+} ddog_Result_TracerMemfdHandle_Tag;
+
+typedef struct ddog_Result_TracerMemfdHandle {
+  ddog_Result_TracerMemfdHandle_Tag tag;
+  union {
+    struct {
+      struct ddog_TracerMemfdHandle ok;
+    };
+    struct {
+      struct ddog_Error err;
+    };
+  };
+} ddog_Result_TracerMemfdHandle;
+
+/**
+ * Log level for filtering log events.
+ */
+typedef enum ddog_LogEventLevel {
+  /**
+   * The "trace" level.
+   *
+   * Designates very low priority, often extremely verbose, information.
+   */
+  DDOG_LOG_EVENT_LEVEL_TRACE = 0,
+  /**
+   * The "debug" level.
+   *
+   * Designates lower priority information.
+   */
+  DDOG_LOG_EVENT_LEVEL_DEBUG = 1,
+  /**
+   * The "info" level.
+   *
+   * Designates useful information.
+   */
+  DDOG_LOG_EVENT_LEVEL_INFO = 2,
+  /**
+   * The "warn" level.
+   *
+   * Designates hazardous situations.
+   */
+  DDOG_LOG_EVENT_LEVEL_WARN = 3,
+  /**
+   * The "error" level.
+   *
+   * Designates very serious errors.
+   */
+  DDOG_LOG_EVENT_LEVEL_ERROR = 4,
+} ddog_LogEventLevel;
+
+/**
+ * Target for standard stream output.
+ */
+typedef enum ddog_StdTarget {
+  /**
+   * Write to standard output (stdout).
+   */
+  DDOG_STD_TARGET_OUT,
+  /**
+   * Write to standard error (stderr).
+   */
+  DDOG_STD_TARGET_ERR,
+} ddog_StdTarget;
+
+/**
+ * Configuration for standard stream output.
+ */
+typedef struct ddog_StdConfig {
+  /**
+   * Target stream (stdout or stderr)
+   */
+  enum ddog_StdTarget target;
+} ddog_StdConfig;
+
+/**
+ * Configuration for file output.
+ */
+typedef struct ddog_FileConfig {
+  /**
+   * Path to the log file
+   */
+  ddog_CharSlice path;
+  /**
+   * Maximum total number of files (current + rotated) to keep on disk.
+   * When this limit is exceeded, the oldest rotated files are deleted.
+   * Set to 0 to disable file cleanup.
+   */
+  uint64_t max_files;
+  /**
+   * Maximum size in bytes for each log file.
+   * Set to 0 to disable size-based rotation.
+   */
+  uint64_t max_size_bytes;
+} ddog_FileConfig;
+
+/**
+ * This is a minimal DDSketch implementation
+ *
+ * This implementation only supports a part of the standard (which is also only the parts dd
+ * backend supports :shrug:)
+ * - max length contiguous bin store, with lower bin collapse behavior.
+ * - Positive or zero values
+ *
+ * The default sketch has a 1% relative accuracy, and only accepts positive points
+ *
+ * See <https://github.com/DataDog/sketches-go> for the reference implementation
+ */
+typedef struct ddsketch_DDSketch ddsketch_DDSketch;
+
+/**
+ * Represents an object that should only be referred to by its handle.
+ * Do not access its member for any reason, only use the C API functions on this struct.
+ */
+typedef struct ddsketch_Handle_DDSketch {
+  struct ddsketch_DDSketch *inner;
+} ddsketch_Handle_DDSketch;
+
 typedef enum ddog_crasht_BuildIdType {
   DDOG_CRASHT_BUILD_ID_TYPE_GNU,
   DDOG_CRASHT_BUILD_ID_TYPE_GO,
@@ -1363,6 +1670,12 @@ typedef enum ddog_crasht_StacktraceCollection {
    */
   DDOG_CRASHT_STACKTRACE_COLLECTION_DISABLED,
   DDOG_CRASHT_STACKTRACE_COLLECTION_WITHOUT_SYMBOLS,
+  /**
+   * This option uses `backtrace::resolve_frame_unsynchronized()` to gather symbol information
+   * and also unwind inlined functions. Enabling this feature will not only provide symbolic
+   * details, but may also yield additional or less stack frames compared to other
+   * configurations.
+   */
   DDOG_CRASHT_STACKTRACE_COLLECTION_ENABLED_WITH_INPROCESS_SYMBOLS,
   DDOG_CRASHT_STACKTRACE_COLLECTION_ENABLED_WITH_SYMBOLS_IN_RECEIVER,
 } ddog_crasht_StacktraceCollection;
@@ -1424,6 +1737,9 @@ typedef struct ddog_crasht_Config {
   struct ddog_crasht_Slice_I32 signals;
   /**
    * Timeout in milliseconds before the signal handler starts tearing things down to return.
+   * If 0, uses the default timeout as specified in
+   * `datadog_crashtracker::shared::constants::DD_CRASHTRACK_DEFAULT_TIMEOUT`. Otherwise, uses
+   * the specified timeout value.
    * This is given as a uint32_t, but the actual timeout needs to fit inside of an i32 (max
    * 2^31-1). This is a limitation of the various interfaces used to guarantee the timeout.
    */
@@ -1525,6 +1841,23 @@ typedef struct ddog_crasht_Handle_CrashInfoBuilder {
   struct ddog_crasht_CrashInfoBuilder *inner;
 } ddog_crasht_Handle_CrashInfoBuilder;
 
+typedef enum  ddog_crasht_CrashInfoBuilder_NewResult_Tag {
+  DDOG_CRASHT_CRASH_INFO_BUILDER_NEW_RESULT_OK,
+  DDOG_CRASHT_CRASH_INFO_BUILDER_NEW_RESULT_ERR,
+}  ddog_crasht_CrashInfoBuilder_NewResult_Tag;
+
+typedef struct  ddog_crasht_CrashInfoBuilder_NewResult {
+   ddog_crasht_CrashInfoBuilder_NewResult_Tag tag;
+  union {
+    struct {
+      struct ddog_crasht_Handle_CrashInfoBuilder ok;
+    };
+    struct {
+      struct ddog_Error err;
+    };
+  };
+}  ddog_crasht_CrashInfoBuilder_NewResult;
+
 typedef enum ddog_crasht_CrashInfo_NewResult_Tag {
   DDOG_CRASHT_CRASH_INFO_NEW_RESULT_OK,
   DDOG_CRASHT_CRASH_INFO_NEW_RESULT_ERR,
@@ -1606,232 +1939,35 @@ typedef struct ddog_crasht_StackFrame_NewResult {
   };
 } ddog_crasht_StackFrame_NewResult;
 
-/**
- * Represent error codes that `Error` struct can hold
- */
-typedef enum ddog_TraceExporterErrorCode {
-  DDOG_TRACE_EXPORTER_ERROR_CODE_ADDRESS_IN_USE,
-  DDOG_TRACE_EXPORTER_ERROR_CODE_CONNECTION_ABORTED,
-  DDOG_TRACE_EXPORTER_ERROR_CODE_CONNECTION_REFUSED,
-  DDOG_TRACE_EXPORTER_ERROR_CODE_CONNECTION_RESET,
-  DDOG_TRACE_EXPORTER_ERROR_CODE_HTTP_BODY_FORMAT,
-  DDOG_TRACE_EXPORTER_ERROR_CODE_HTTP_BODY_TOO_LONG,
-  DDOG_TRACE_EXPORTER_ERROR_CODE_HTTP_CLIENT,
-  DDOG_TRACE_EXPORTER_ERROR_CODE_HTTP_EMPTY_BODY,
-  DDOG_TRACE_EXPORTER_ERROR_CODE_HTTP_PARSE,
-  DDOG_TRACE_EXPORTER_ERROR_CODE_HTTP_SERVER,
-  DDOG_TRACE_EXPORTER_ERROR_CODE_HTTP_UNKNOWN,
-  DDOG_TRACE_EXPORTER_ERROR_CODE_HTTP_WRONG_STATUS,
-  DDOG_TRACE_EXPORTER_ERROR_CODE_INVALID_ARGUMENT,
-  DDOG_TRACE_EXPORTER_ERROR_CODE_INVALID_DATA,
-  DDOG_TRACE_EXPORTER_ERROR_CODE_INVALID_INPUT,
-  DDOG_TRACE_EXPORTER_ERROR_CODE_INVALID_URL,
-  DDOG_TRACE_EXPORTER_ERROR_CODE_IO_ERROR,
-  DDOG_TRACE_EXPORTER_ERROR_CODE_NETWORK_UNKNOWN,
-  DDOG_TRACE_EXPORTER_ERROR_CODE_SERDE,
-  DDOG_TRACE_EXPORTER_ERROR_CODE_TIMED_OUT,
-} ddog_TraceExporterErrorCode;
-
-/**
- * Structure containing the agent response to a trace payload
- * MUST be freed with `ddog_trace_exporter_response_free`
- */
-typedef struct ddog_TraceExporterResponse ddog_TraceExporterResponse;
-
-/**
- * The TraceExporter ingest traces from the tracers serialized as messagepack and forward them to
- * the agent while applying some transformation.
- *
- * # Proxy
- * If the input format is set as `Proxy`, the exporter will forward traces to the agent without
- * deserializing them.
- *
- * # Features
- * When the input format is set to `V04` the TraceExporter will deserialize the traces and perform
- * some operation before sending them to the agent. The available operations are described below.
- *
- * ## V07 Serialization
- * The Trace exporter can serialize the traces to V07 before sending them to the agent.
- *
- * ## Stats computation
- * The Trace Exporter can compute stats on traces. In this case the trace exporter will start
- * another task to send stats when a time bucket expire. When this feature is enabled the
- * TraceExporter drops all spans that may not be sampled by the agent.
- */
-typedef struct ddog_TraceExporter ddog_TraceExporter;
-
-/**
- * The TraceExporterConfig object will hold the configuration properties for the TraceExporter.
- * Once the configuration is passed to the TraceExporter constructor the config is no longer
- * needed by the handle and it can be freed.
- */
-typedef struct ddog_TraceExporterConfig ddog_TraceExporterConfig;
-
-/**
- * Stucture that contains error information that `TraceExporter` API can return.
- */
-typedef struct ddog_TraceExporterError {
-  enum ddog_TraceExporterErrorCode code;
-  char *msg;
-} ddog_TraceExporterError;
-
-/**
- * FFI compatible configuration for the TelemetryClient.
- */
-typedef struct ddog_TelemetryClientConfig {
-  /**
-   * How often telemetry should be sent, in milliseconds.
-   */
-  uint64_t interval;
-  /**
-   * A V4 UUID that represents a tracer session. This ID should:
-   * - Be generated when the tracer starts
-   * - Be identical within the context of a host (i.e. multiple threads/processes that belong to
-   *   a single instrumented app should share the same runtime_id)
-   * - Be associated with traces to allow correlation between traces and telemetry data
-   */
-  ddog_CharSlice runtime_id;
-  /**
-   * Whether to enable debug mode for telemetry.
-   * When enabled, sets the DD-Telemetry-Debug-Enabled header to true.
-   * Defaults to false.
-   */
-  bool debug_enabled;
-} ddog_TelemetryClientConfig;
-
-typedef enum ddog_LibraryConfigSource {
-  DDOG_LIBRARY_CONFIG_SOURCE_LOCAL_STABLE_CONFIG = 0,
-  DDOG_LIBRARY_CONFIG_SOURCE_FLEET_STABLE_CONFIG = 1,
-} ddog_LibraryConfigSource;
-
-typedef struct ddog_Configurator ddog_Configurator;
+typedef enum  ddog_crasht_StackTrace_NewResult_Tag {
+  DDOG_CRASHT_STACK_TRACE_NEW_RESULT_OK,
+  DDOG_CRASHT_STACK_TRACE_NEW_RESULT_ERR,
+}  ddog_crasht_StackTrace_NewResult_Tag;
 
-/**
- * Ffi safe type representing a borrowed null-terminated C array
- * Equivalent to a std::ffi::CStr
- */
-typedef struct ddog_CStr {
-  /**
-   * Null terminated char array
-   */
-  char *ptr;
-  /**
-   * Length of the array, not counting the null-terminator
-   */
-  uintptr_t length;
-} ddog_CStr;
-
-typedef struct ddog_Slice_CharSlice {
-  /**
-   * Should be non-null and suitably aligned for the underlying type. It is
-   * allowed but not recommended for the pointer to be null when the len is
-   * zero.
-   */
-  const ddog_CharSlice *ptr;
-  /**
-   * The number of elements (not bytes) that `.ptr` points to. Must be less
-   * than or equal to [isize::MAX].
-   */
-  uintptr_t len;
-} ddog_Slice_CharSlice;
-
-typedef struct ddog_ProcessInfo {
-  struct ddog_Slice_CharSlice args;
-  struct ddog_Slice_CharSlice envp;
-  ddog_CharSlice language;
-} ddog_ProcessInfo;
-
-/**
- * Ffi safe type representing an owned null-terminated C array
- * Equivalent to a std::ffi::CString
- */
-typedef struct ddog_CString {
-  /**
-   * Null terminated char array
-   */
-  char *ptr;
-  /**
-   * Length of the array, not counting the null-terminator
-   */
-  uintptr_t length;
-} ddog_CString;
-
-typedef struct ddog_LibraryConfig {
-  struct ddog_CString name;
-  struct ddog_CString value;
-  enum ddog_LibraryConfigSource source;
-  struct ddog_CString config_id;
-} ddog_LibraryConfig;
-
-/**
- * Holds the raw parts of a Rust Vec; it should only be created from Rust,
- * never from C.
- */
-typedef struct ddog_Vec_LibraryConfig {
-  const struct ddog_LibraryConfig *ptr;
-  uintptr_t len;
-  uintptr_t capacity;
-} ddog_Vec_LibraryConfig;
-
-/**
- * A generic result type for when an operation may fail,
- * or may return <T> in case of success.
- */
-typedef enum ddog_Result_VecLibraryConfig_Tag {
-  DDOG_RESULT_VEC_LIBRARY_CONFIG_OK_VEC_LIBRARY_CONFIG,
-  DDOG_RESULT_VEC_LIBRARY_CONFIG_ERR_VEC_LIBRARY_CONFIG,
-} ddog_Result_VecLibraryConfig_Tag;
-
-typedef struct ddog_Result_VecLibraryConfig {
-  ddog_Result_VecLibraryConfig_Tag tag;
-  union {
-    struct {
-      struct ddog_Vec_LibraryConfig ok;
-    };
-    struct {
-      struct ddog_Error err;
-    };
-  };
-} ddog_Result_VecLibraryConfig;
-
-/**
- * C-compatible representation of an anonymous file handle
- */
-typedef struct ddog_TracerMemfdHandle {
-  /**
-   * File descriptor (relevant only on Linux)
-   */
-  int fd;
-} ddog_TracerMemfdHandle;
-
-/**
- * A generic result type for when an operation may fail,
- * or may return <T> in case of success.
- */
-typedef enum ddog_Result_TracerMemfdHandle_Tag {
-  DDOG_RESULT_TRACER_MEMFD_HANDLE_OK_TRACER_MEMFD_HANDLE,
-  DDOG_RESULT_TRACER_MEMFD_HANDLE_ERR_TRACER_MEMFD_HANDLE,
-} ddog_Result_TracerMemfdHandle_Tag;
-
-typedef struct ddog_Result_TracerMemfdHandle {
-  ddog_Result_TracerMemfdHandle_Tag tag;
+typedef struct  ddog_crasht_StackTrace_NewResult {
+   ddog_crasht_StackTrace_NewResult_Tag tag;
   union {
     struct {
-      struct ddog_TracerMemfdHandle ok;
+      struct ddog_crasht_Handle_StackTrace ok;
     };
     struct {
       struct ddog_Error err;
     };
   };
-} ddog_Result_TracerMemfdHandle;
+}  ddog_crasht_StackTrace_NewResult;
 
 #ifdef __cplusplus
 extern "C" {
 #endif // __cplusplus
 
 /**
+ * Drops the error. It should not be used after this, though the
+ * implementation tries to limit the damage in the case of use-after-free and
+ * double-free scenarios.
+ *
  * # Safety
- * Only pass null or a valid reference to a `ddog_Error`.
+ *
+ * Only pass null or a pointer to a valid, mutable `ddog_Error`.
  */
 void ddog_Error_drop(struct ddog_Error *error);
 
@@ -1937,16 +2073,23 @@ struct ddog_Option_U32 ddog_Option_U32_some(uint32_t v);
 struct ddog_Option_U32 ddog_Option_U32_none(void);
 
 /**
+ * Drops a `ddog_StringWrapper`. It should not be used after this, though the
+ * implementation tries to limit the damage in the case of use-after-free and
+ * double-free scenarios.
+ *
  * # Safety
- * Only pass null or a valid reference to a `ddog_StringWrapper`.
+ *
+ * Only pass null or a pointer to a valid, mutable `ddog_StringWrapper`.
  */
 void ddog_StringWrapper_drop(struct ddog_StringWrapper *s);
 
 /**
- * Returns a CharSlice of the message that is valid until the StringWrapper
- * is dropped.
+ * Returns a CharSlice of the message.
+ *
  * # Safety
+ *
  * Only pass null or a valid reference to a `ddog_StringWrapper`.
+ * The string should not be mutated nor dropped while the CharSlice is alive.
  */
 ddog_CharSlice ddog_StringWrapper_message(const struct ddog_StringWrapper *s);