libdatadog 11.0.0.1.0 → 13.1.0.1.0

data/vendor/{libdatadog-11.0.0 → libdatadog-13.1.0}/x86_64-linux/libdatadog-x86_64-unknown-linux-gnu/include/datadog/profiling.h

@@ -16,279 +16,6 @@
 extern "C" {
 #endif // __cplusplus
 
-/**
- * Cleans up after the crash-tracker:
- * Unregister the crash handler, restore the previous handler (if any), and
- * shut down the receiver.  Note that the use of this function is optional:
- * the receiver will automatically shutdown when the pipe is closed on program
- * exit.
- *
- * # Preconditions
- *     This function assumes that the crash-tracker has previously been
- *     initialized.
- * # Safety
- *     Crash-tracking functions are not reentrant.
- *     No other crash-handler functions should be called concurrently.
- * # Atomicity
- *     This function is not atomic. A crash during its execution may lead to
- *     unexpected crash-handling behaviour.
- */
-DDOG_CHECK_RETURN struct ddog_prof_CrashtrackerResult ddog_prof_Crashtracker_shutdown(void);
-
-/**
- * Reinitialize the crash-tracking infrastructure after a fork.
- * This should be one of the first things done after a fork, to minimize the
- * chance that a crash occurs between the fork, and this call.
- * In particular, reset the counters that track the profiler state machine,
- * and start a new receiver to collect data from this fork.
- * NOTE: An alternative design would be to have a 1:many sidecar listening on a
- * socket instead of 1:1 receiver listening on a pipe, but the only real
- * advantage would be to have fewer processes in `ps -a`.
- *
- * # Preconditions
- *     This function assumes that the crash-tracker has previously been
- *     initialized.
- * # Safety
- *     Crash-tracking functions are not reentrant.
- *     No other crash-handler functions should be called concurrently.
- * # Atomicity
- *     This function is not atomic. A crash during its execution may lead to
- *     unexpected crash-handling behaviour.
- */
-DDOG_CHECK_RETURN
-struct ddog_prof_CrashtrackerResult ddog_prof_Crashtracker_update_on_fork(struct ddog_prof_CrashtrackerConfiguration config,
-                                                                          struct ddog_prof_CrashtrackerReceiverConfig receiver_config,
-                                                                          struct ddog_prof_CrashtrackerMetadata metadata);
-
-/**
- * Receives data from a crash collector via a pipe on `stdin`, formats it into
- * `CrashInfo` json, and emits it to the endpoint/file defined in `config`.
- *
- * At a high-level, this exists because doing anything in a
- * signal handler is dangerous, so we fork a sidecar to do the stuff we aren't
- * allowed to do in the handler.
- *
- * See comments in [profiling/crashtracker/mod.rs] for a full architecture
- * description.
- * # Safety
- * No safety concerns
- */
-DDOG_CHECK_RETURN
-struct ddog_prof_CrashtrackerResult ddog_prof_Crashtracker_receiver_entry_point_stdin(void);
-
-/**
- * Receives data from a crash collector via a pipe on `stdin`, formats it into
- * `CrashInfo` json, and emits it to the endpoint/file defined in `config`.
- *
- * At a high-level, this exists because doing anything in a
- * signal handler is dangerous, so we fork a sidecar to do the stuff we aren't
- * allowed to do in the handler.
- *
- * See comments in [profiling/crashtracker/mod.rs] for a full architecture
- * description.
- * # Safety
- * No safety concerns
- */
-DDOG_CHECK_RETURN
-struct ddog_prof_CrashtrackerResult ddog_prof_Crashtracker_receiver_entry_point_unix_socket(ddog_CharSlice socket_path);
-
-/**
- * Initialize the crash-tracking infrastructure.
- *
- * # Preconditions
- *     None.
- * # Safety
- *     Crash-tracking functions are not reentrant.
- *     No other crash-handler functions should be called concurrently.
- * # Atomicity
- *     This function is not atomic. A crash during its execution may lead to
- *     unexpected crash-handling behaviour.
- */
-DDOG_CHECK_RETURN
-struct ddog_prof_CrashtrackerResult ddog_prof_Crashtracker_init_with_receiver(struct ddog_prof_CrashtrackerConfiguration config,
-                                                                              struct ddog_prof_CrashtrackerReceiverConfig receiver_config,
-                                                                              struct ddog_prof_CrashtrackerMetadata metadata);
-
-/**
- * Resets all counters to 0.
- * Expected to be used after a fork, to reset the counters on the child
- * ATOMICITY:
- *     This is NOT ATOMIC.
- *     Should only be used when no conflicting updates can occur,
- *     e.g. after a fork but before profiling ops start on the child.
- * # Safety
- * No safety concerns.
- */
-DDOG_CHECK_RETURN struct ddog_prof_CrashtrackerResult ddog_prof_Crashtracker_reset_counters(void);
-
-/**
- * Atomically increments the count associated with `op`.
- * Useful for tracking what operations were occuring when a crash occurred.
- *
- * # Safety
- * No safety concerns.
- */
-DDOG_CHECK_RETURN
-struct ddog_prof_CrashtrackerResult ddog_prof_Crashtracker_begin_profiling_op(enum ddog_prof_ProfilingOpTypes op);
-
-/**
- * Atomically decrements the count associated with `op`.
- * Useful for tracking what operations were occuring when a crash occurred.
- *
- * # Safety
- * No safety concerns.
- */
-DDOG_CHECK_RETURN
-struct ddog_prof_CrashtrackerResult ddog_prof_Crashtracker_end_profiling_op(enum ddog_prof_ProfilingOpTypes op);
-
-/**
- * Create a new crashinfo, and returns an opaque reference to it.
- * # Safety
- * No safety issues.
- */
-DDOG_CHECK_RETURN struct ddog_prof_CrashInfoNewResult ddog_crashinfo_new(void);
-
-/**
- * # Safety
- * The `crash_info` can be null, but if non-null it must point to a CrashInfo
- * made by this module, which has not previously been dropped.
- */
-void ddog_crashinfo_drop(struct ddog_prof_CrashInfo *crashinfo);
-
-/**
- * Best effort attempt to normalize all `ip` on the stacktrace.
- * `pid` must be the pid of the currently active process where the ips came from.
- *
- * # Safety
- * `crashinfo` must be a valid pointer to a `CrashInfo` object.
- */
-DDOG_CHECK_RETURN
-struct ddog_prof_CrashtrackerResult ddog_crashinfo_normalize_ips(struct ddog_prof_CrashInfo *crashinfo,
-                                                                 uint32_t pid);
-
-/**
- * Adds a "counter" variable, with the given value.  Useful for determining if
- * "interesting" operations were occurring when the crash did.
- *
- * # Safety
- * `crashinfo` must be a valid pointer to a `CrashInfo` object.
- * `name` should be a valid reference to a utf8 encoded String.
- * The string is copied into the crashinfo, so it does not need to outlive this
- * call.
- */
-DDOG_CHECK_RETURN
-struct ddog_prof_CrashtrackerResult ddog_crashinfo_add_counter(struct ddog_prof_CrashInfo *crashinfo,
-                                                               ddog_CharSlice name,
-                                                               int64_t val);
-
-/**
- * Adds the contents of "file" to the crashinfo
- *
- * # Safety
- * `crashinfo` must be a valid pointer to a `CrashInfo` object.
- * `name` should be a valid reference to a utf8 encoded String.
- * The string is copied into the crashinfo, so it does not need to outlive this
- * call.
- */
-DDOG_CHECK_RETURN
-struct ddog_prof_CrashtrackerResult ddog_crashinfo_add_file(struct ddog_prof_CrashInfo *crashinfo,
-                                                            ddog_CharSlice name);
-
-/**
- * Adds the tag with given "key" and "value" to the crashinfo
- *
- * # Safety
- * `crashinfo` must be a valid pointer to a `CrashInfo` object.
- * `key` should be a valid reference to a utf8 encoded String.
- * `value` should be a valid reference to a utf8 encoded String.
- * The string is copied into the crashinfo, so it does not need to outlive this
- * call.
- */
-DDOG_CHECK_RETURN
-struct ddog_prof_CrashtrackerResult ddog_crashinfo_add_tag(struct ddog_prof_CrashInfo *crashinfo,
-                                                           ddog_CharSlice key,
-                                                           ddog_CharSlice value);
-
-/**
- * Sets the crashinfo metadata
- *
- * # Safety
- * `crashinfo` must be a valid pointer to a `CrashInfo` object.
- * All references inside `metadata` must be valid.
- * Strings are copied into the crashinfo, and do not need to outlive this call.
- */
-DDOG_CHECK_RETURN
-struct ddog_prof_CrashtrackerResult ddog_crashinfo_set_metadata(struct ddog_prof_CrashInfo *crashinfo,
-                                                                struct ddog_prof_CrashtrackerMetadata metadata);
-
-/**
- * Sets the crashinfo siginfo
- *
- * # Safety
- * `crashinfo` must be a valid pointer to a `CrashInfo` object.
- * All references inside `metadata` must be valid.
- * Strings are copied into the crashinfo, and do not need to outlive this call.
- */
-DDOG_CHECK_RETURN
-struct ddog_prof_CrashtrackerResult ddog_crashinfo_set_siginfo(struct ddog_prof_CrashInfo *crashinfo,
-                                                               struct ddog_prof_SigInfo siginfo);
-
-/**
- * If `thread_id` is empty, sets `stacktrace` as the default stacktrace.
- * Otherwise, adds an additional stacktrace with id "thread_id".
- *
- * # Safety
- * `crashinfo` must be a valid pointer to a `CrashInfo` object.
- * All references inside `stacktraces` must be valid.
- * Strings are copied into the crashinfo, and do not need to outlive this call.
- */
-DDOG_CHECK_RETURN
-struct ddog_prof_CrashtrackerResult ddog_crashinfo_set_stacktrace(struct ddog_prof_CrashInfo *crashinfo,
-                                                                  ddog_CharSlice thread_id,
-                                                                  struct ddog_prof_Slice_StackFrame stacktrace);
-
-/**
- * Sets the timestamp to the given unix timestamp
- *
- * # Safety
- * `crashinfo` must be a valid pointer to a `CrashInfo` object.
- */
-DDOG_CHECK_RETURN
-struct ddog_prof_CrashtrackerResult ddog_crashinfo_set_timestamp(struct ddog_prof_CrashInfo *crashinfo,
-                                                                 int64_t secs,
-                                                                 uint32_t nsecs);
-
-/**
- * Sets the timestamp to the current time
- *
- * # Safety
- * `crashinfo` must be a valid pointer to a `CrashInfo` object.
- */
-DDOG_CHECK_RETURN
-struct ddog_prof_CrashtrackerResult ddog_crashinfo_set_timestamp_to_now(struct ddog_prof_CrashInfo *crashinfo);
-
-/**
- * Exports `crashinfo` to the backend at `endpoint`
- * Note that we support the "file://" endpoint for local file output.
- * # Safety
- * `crashinfo` must be a valid pointer to a `CrashInfo` object.
- */
-DDOG_CHECK_RETURN
-struct ddog_prof_CrashtrackerResult ddog_crashinfo_upload_to_endpoint(struct ddog_prof_CrashInfo *crashinfo,
-                                                                      struct ddog_prof_CrashtrackerConfiguration config);
-
-/**
- * Demangles the string "name".
- * If demangling fails, returns an empty string ""
- *
- * # Safety
- * `name` should be a valid reference to a utf8 encoded String.
- * The string is copied into the result, and does not need to outlive this call
- */
-DDOG_CHECK_RETURN
-struct ddog_prof_StringWrapperResult ddog_demangle(ddog_CharSlice name,
-                                                   enum ddog_prof_DemangleOptions options);
-
 DDOG_CHECK_RETURN struct ddog_prof_Exporter_Slice_File ddog_prof_Exporter_Slice_File_empty(void);
 
 /**
@@ -339,6 +66,15 @@ struct ddog_prof_Exporter_NewResult ddog_prof_Exporter_new(ddog_CharSlice profil
                                                            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_prof_MaybeError ddog_prof_Exporter_set_timeout(struct ddog_prof_Exporter *exporter,
+                                                    uint64_t timeout_ms);
+
 /**
  * # Safety
  * The `exporter` may be null, but if non-null the pointer must point to a
@@ -374,8 +110,7 @@ struct ddog_prof_Exporter_Request_BuildResult ddog_prof_Exporter_Request_build(s
                                                                                const struct ddog_Vec_Tag *optional_additional_tags,
                                                                                const struct ddog_prof_ProfiledEndpointsStats *optional_endpoints_stats,
                                                                                const ddog_CharSlice *optional_internal_metadata_json,
-                                                                               const ddog_CharSlice *optional_info_json,
-                                                                               uint64_t timeout_ms);
+                                                                               const ddog_CharSlice *optional_info_json);
 
 /**
  * # Safety