libdatadog 0.7.0.1.0.rc1 → 0.8.0.1.0

data/vendor/libdatadog-0.8.0/x86_64-linux/libdatadog-x86_64-unknown-linux-gnu/include/datadog/common.h

@@ -0,0 +1,430 @@
+// Unless explicitly stated otherwise all files in this repository are licensed under the Apache License Version 2.0.
+// This product includes software developed at Datadog (https://www.datadoghq.com/). Copyright 2021-Present Datadog, Inc.
+
+
+#ifndef DDOG_COMMON_H
+#define DDOG_COMMON_H
+
+#include <stdbool.h>
+#include <stddef.h>
+#include <stdint.h>
+
+#if defined(_MSC_VER)
+#define DDOG_CHARSLICE_C(string) \
+/* NOTE: Compilation fails if you pass in a char* instead of a literal */ {.ptr = "" string, .len = sizeof(string) - 1}
+#else
+#define DDOG_CHARSLICE_C(string) \
+/* NOTE: Compilation fails if you pass in a char* instead of a literal */ ((ddog_CharSlice){ .ptr = "" string, .len = sizeof(string) - 1 })
+#endif
+
+#if defined(__cplusplus) && (__cplusplus >= 201703L)
+#  define DDOG_CHECK_RETURN [[nodiscard]]
+#elif defined(_Check_return_) /* SAL */
+#  define DDOG_CHECK_RETURN _Check_return_
+#elif (defined(__has_attribute) && __has_attribute(warn_unused_result)) || \
+      (defined(__GNUC__) && (__GNUC__ >= 4))
+#  define DDOG_CHECK_RETURN __attribute__((__warn_unused_result__))
+#else
+#  define DDOG_CHECK_RETURN
+#endif
+
+typedef struct ddog_Tag ddog_Tag;
+
+/**
+ * Holds the raw parts of a Rust Vec; it should only be created from Rust,
+ * never from C.
+ * The names ptr and len were chosen to minimize conversion from a previous
+ * Buffer type which this has replaced to become more general.
+ */
+typedef struct ddog_Vec_tag {
+  const struct ddog_Tag *ptr;
+  uintptr_t len;
+  uintptr_t capacity;
+} ddog_Vec_tag;
+
+/**
+ * Holds the raw parts of a Rust Vec; it should only be created from Rust,
+ * never from C.
+ * The names ptr and len were chosen to minimize conversion from a previous
+ * Buffer type which this has replaced to become more general.
+ */
+typedef struct ddog_Vec_u8 {
+  const uint8_t *ptr;
+  uintptr_t len;
+  uintptr_t capacity;
+} ddog_Vec_u8;
+
+typedef enum ddog_PushTagResult_Tag {
+  DDOG_PUSH_TAG_RESULT_OK,
+  DDOG_PUSH_TAG_RESULT_ERR,
+} ddog_PushTagResult_Tag;
+
+typedef struct ddog_PushTagResult {
+  ddog_PushTagResult_Tag tag;
+  union {
+    struct {
+      struct ddog_Vec_u8 err;
+    };
+  };
+} ddog_PushTagResult;
+
+/**
+ * Remember, the data inside of each member is potentially coming from FFI,
+ * so every operation on it is unsafe!
+ */
+typedef struct ddog_Slice_c_char {
+  const char *ptr;
+  uintptr_t len;
+} ddog_Slice_c_char;
+
+typedef struct ddog_Slice_c_char ddog_CharSlice;
+
+typedef struct ddog_ParseTagsResult {
+  struct ddog_Vec_tag tags;
+  struct ddog_Vec_u8 *error_message;
+} ddog_ParseTagsResult;
+
+typedef struct ddog_CancellationToken ddog_CancellationToken;
+
+typedef struct ddog_Profile ddog_Profile;
+
+typedef struct ddog_ProfileExporter ddog_ProfileExporter;
+
+/**
+ * This type only exists to workaround a bug in cbindgen; may be removed in the
+ * future.
+ */
+typedef struct ddog_Request ddog_Request;
+
+typedef enum ddog_NewProfileExporterResult_Tag {
+  DDOG_NEW_PROFILE_EXPORTER_RESULT_OK,
+  DDOG_NEW_PROFILE_EXPORTER_RESULT_ERR,
+} ddog_NewProfileExporterResult_Tag;
+
+typedef struct ddog_NewProfileExporterResult {
+  ddog_NewProfileExporterResult_Tag tag;
+  union {
+    struct {
+      struct ddog_ProfileExporter *ok;
+    };
+    struct {
+      struct ddog_Vec_u8 err;
+    };
+  };
+} ddog_NewProfileExporterResult;
+
+typedef enum ddog_Endpoint_Tag {
+  DDOG_ENDPOINT_AGENT,
+  DDOG_ENDPOINT_AGENTLESS,
+} ddog_Endpoint_Tag;
+
+typedef struct ddog_Endpoint_ddog_Agentless_Body {
+  ddog_CharSlice _0;
+  ddog_CharSlice _1;
+} ddog_Endpoint_ddog_Agentless_Body;
+
+typedef struct ddog_Endpoint {
+  ddog_Endpoint_Tag tag;
+  union {
+    struct {
+      ddog_CharSlice agent;
+    };
+    ddog_Endpoint_ddog_Agentless_Body AGENTLESS;
+  };
+} ddog_Endpoint;
+
+/**
+ * Represents time since the Unix Epoch in seconds plus nanoseconds.
+ */
+typedef struct ddog_Timespec {
+  int64_t seconds;
+  uint32_t nanoseconds;
+} ddog_Timespec;
+
+/**
+ * Remember, the data inside of each member is potentially coming from FFI,
+ * so every operation on it is unsafe!
+ */
+typedef struct ddog_Slice_u8 {
+  const uint8_t *ptr;
+  uintptr_t len;
+} ddog_Slice_u8;
+
+/**
+ * Use to represent bytes -- does not need to be valid UTF-8.
+ */
+typedef struct ddog_Slice_u8 ddog_ByteSlice;
+
+typedef struct ddog_File {
+  ddog_CharSlice name;
+  ddog_ByteSlice file;
+} ddog_File;
+
+/**
+ * Remember, the data inside of each member is potentially coming from FFI,
+ * so every operation on it is unsafe!
+ */
+typedef struct ddog_Slice_file {
+  const struct ddog_File *ptr;
+  uintptr_t len;
+} ddog_Slice_file;
+
+typedef struct ddog_HttpStatus {
+  uint16_t code;
+} ddog_HttpStatus;
+
+typedef enum ddog_SendResult_Tag {
+  DDOG_SEND_RESULT_HTTP_RESPONSE,
+  DDOG_SEND_RESULT_ERR,
+} ddog_SendResult_Tag;
+
+typedef struct ddog_SendResult {
+  ddog_SendResult_Tag tag;
+  union {
+    struct {
+      struct ddog_HttpStatus http_response;
+    };
+    struct {
+      struct ddog_Vec_u8 err;
+    };
+  };
+} ddog_SendResult;
+
+typedef struct ddog_ValueType {
+  ddog_CharSlice type_;
+  ddog_CharSlice unit;
+} ddog_ValueType;
+
+/**
+ * Remember, the data inside of each member is potentially coming from FFI,
+ * so every operation on it is unsafe!
+ */
+typedef struct ddog_Slice_value_type {
+  const struct ddog_ValueType *ptr;
+  uintptr_t len;
+} ddog_Slice_value_type;
+
+typedef struct ddog_Period {
+  struct ddog_ValueType type_;
+  int64_t value;
+} ddog_Period;
+
+typedef struct ddog_Mapping {
+  /**
+   * Address at which the binary (or DLL) is loaded into memory.
+   */
+  uint64_t memory_start;
+  /**
+   * The limit of the address range occupied by this mapping.
+   */
+  uint64_t memory_limit;
+  /**
+   * Offset in the binary that corresponds to the first mapped address.
+   */
+  uint64_t file_offset;
+  /**
+   * The object this entry is loaded from.  This can be a filename on
+   * disk for the main binary and shared libraries, or virtual
+   * abstractions like "[vdso]".
+   */
+  ddog_CharSlice filename;
+  /**
+   * A string that uniquely identifies a particular program version
+   * with high probability. E.g., for binaries generated by GNU tools,
+   * it could be the contents of the .note.gnu.build-id field.
+   */
+  ddog_CharSlice build_id;
+} ddog_Mapping;
+
+typedef struct ddog_Function {
+  /**
+   * Name of the function, in human-readable form if available.
+   */
+  ddog_CharSlice name;
+  /**
+   * Name of the function, as identified by the system.
+   * For instance, it can be a C++ mangled name.
+   */
+  ddog_CharSlice system_name;
+  /**
+   * Source file containing the function.
+   */
+  ddog_CharSlice filename;
+  /**
+   * Line number in source file.
+   */
+  int64_t start_line;
+} ddog_Function;
+
+typedef struct ddog_Line {
+  /**
+   * The corresponding profile.Function for this line.
+   */
+  struct ddog_Function function;
+  /**
+   * Line number in source code.
+   */
+  int64_t line;
+} ddog_Line;
+
+/**
+ * Remember, the data inside of each member is potentially coming from FFI,
+ * so every operation on it is unsafe!
+ */
+typedef struct ddog_Slice_line {
+  const struct ddog_Line *ptr;
+  uintptr_t len;
+} ddog_Slice_line;
+
+typedef struct ddog_Location {
+  /**
+   * todo: how to handle unknown mapping?
+   */
+  struct ddog_Mapping mapping;
+  /**
+   * The instruction address for this location, if available.  It
+   * should be within [Mapping.memory_start...Mapping.memory_limit]
+   * for the corresponding mapping. A non-leaf address may be in the
+   * middle of a call instruction. It is up to display tools to find
+   * the beginning of the instruction if necessary.
+   */
+  uint64_t address;
+  /**
+   * Multiple line indicates this location has inlined functions,
+   * where the last entry represents the caller into which the
+   * preceding entries were inlined.
+   *
+   * E.g., if memcpy() is inlined into printf:
+   *    line[0].function_name == "memcpy"
+   *    line[1].function_name == "printf"
+   */
+  struct ddog_Slice_line lines;
+  /**
+   * Provides an indication that multiple symbols map to this location's
+   * address, for example due to identical code folding by the linker. In that
+   * case the line information above represents one of the multiple
+   * symbols. This field must be recomputed when the symbolization state of the
+   * profile changes.
+   */
+  bool is_folded;
+} ddog_Location;
+
+/**
+ * Remember, the data inside of each member is potentially coming from FFI,
+ * so every operation on it is unsafe!
+ */
+typedef struct ddog_Slice_location {
+  const struct ddog_Location *ptr;
+  uintptr_t len;
+} ddog_Slice_location;
+
+/**
+ * Remember, the data inside of each member is potentially coming from FFI,
+ * so every operation on it is unsafe!
+ */
+typedef struct ddog_Slice_i64 {
+  const int64_t *ptr;
+  uintptr_t len;
+} ddog_Slice_i64;
+
+typedef struct ddog_Label {
+  ddog_CharSlice key;
+  /**
+   * At most one of the following must be present
+   */
+  ddog_CharSlice str;
+  int64_t num;
+  /**
+   * Should only be present when num is present.
+   * Specifies the units of num.
+   * Use arbitrary string (for example, "requests") as a custom count unit.
+   * If no unit is specified, consumer may apply heuristic to deduce the unit.
+   * Consumers may also  interpret units like "bytes" and "kilobytes" as memory
+   * units and units like "seconds" and "nanoseconds" as time units,
+   * and apply appropriate unit conversions to these.
+   */
+  ddog_CharSlice num_unit;
+} ddog_Label;
+
+/**
+ * Remember, the data inside of each member is potentially coming from FFI,
+ * so every operation on it is unsafe!
+ */
+typedef struct ddog_Slice_label {
+  const struct ddog_Label *ptr;
+  uintptr_t len;
+} ddog_Slice_label;
+
+typedef struct ddog_Sample {
+  /**
+   * The leaf is at locations[0].
+   */
+  struct ddog_Slice_location locations;
+  /**
+   * The type and unit of each value is defined by the corresponding
+   * entry in Profile.sample_type. All samples must have the same
+   * number of values, the same as the length of Profile.sample_type.
+   * When aggregating multiple samples into a single sample, the
+   * result has a list of values that is the element-wise sum of the
+   * lists of the originals.
+   */
+  struct ddog_Slice_i64 values;
+  /**
+   * label includes additional context for this sample. It can include
+   * things like a thread id, allocation size, etc
+   */
+  struct ddog_Slice_label labels;
+} ddog_Sample;
+
+typedef struct ddog_EncodedProfile {
+  struct ddog_Timespec start;
+  struct ddog_Timespec end;
+  struct ddog_Vec_u8 buffer;
+} ddog_EncodedProfile;
+
+typedef enum ddog_SerializeResult_Tag {
+  DDOG_SERIALIZE_RESULT_OK,
+  DDOG_SERIALIZE_RESULT_ERR,
+} ddog_SerializeResult_Tag;
+
+typedef struct ddog_SerializeResult {
+  ddog_SerializeResult_Tag tag;
+  union {
+    struct {
+      struct ddog_EncodedProfile ok;
+    };
+    struct {
+      struct ddog_Vec_u8 err;
+    };
+  };
+} ddog_SerializeResult;
+
+DDOG_CHECK_RETURN struct ddog_Vec_tag ddog_Vec_tag_new(void);
+
+void ddog_Vec_tag_drop(struct ddog_Vec_tag);
+
+void ddog_PushTagResult_drop(struct ddog_PushTagResult);
+
+/**
+ * Creates a new Tag from the provided `key` and `value` by doing a utf8
+ * lossy conversion, and pushes into the `vec`. The strings `key` and `value`
+ * are cloned to avoid FFI lifetime issues.
+ *
+ * # Safety
+ * The `vec` must be a valid reference.
+ * The CharSlices `key` and `value` must point to at least many bytes as their
+ * `.len` properties claim.
+ */
+DDOG_CHECK_RETURN
+struct ddog_PushTagResult ddog_Vec_tag_push(struct ddog_Vec_tag *vec,
+                                            ddog_CharSlice key,
+                                            ddog_CharSlice value);
+
+/**
+ * # Safety
+ * The `string`'s .ptr must point to a valid object at least as large as its
+ * .len property.
+ */
+DDOG_CHECK_RETURN struct ddog_ParseTagsResult ddog_Vec_tag_parse(ddog_CharSlice string);
+
+#endif /* DDOG_COMMON_H */

data/vendor/libdatadog-0.8.0/x86_64-linux/libdatadog-x86_64-unknown-linux-gnu/include/datadog/profiling.h

@@ -0,0 +1,212 @@
+// Unless explicitly stated otherwise all files in this repository are licensed under the Apache License Version 2.0.
+// This product includes software developed at Datadog (https://www.datadoghq.com/). Copyright 2021-Present Datadog, Inc.
+
+
+#ifndef DDOG_PROFILING_H
+#define DDOG_PROFILING_H
+
+#include <stdbool.h>
+#include <stddef.h>
+#include <stdint.h>
+#include "datadog/common.h"
+
+void ddog_NewProfileExporterResult_drop(struct ddog_NewProfileExporterResult result);
+
+/**
+ * Creates an endpoint that uses the agent.
+ * # Arguments
+ * * `base_url` - Contains a URL with scheme, host, and port e.g. "https://agent:8126/".
+ */
+struct ddog_Endpoint ddog_Endpoint_agent(ddog_CharSlice base_url);
+
+/**
+ * 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.
+ */
+struct ddog_Endpoint ddog_Endpoint_agentless(ddog_CharSlice site, ddog_CharSlice api_key);
+
+DDOG_CHECK_RETURN
+struct ddog_NewProfileExporterResult ddog_ProfileExporter_new(ddog_CharSlice family,
+                                                              const struct ddog_Vec_tag *tags,
+                                                              struct ddog_Endpoint endpoint);
+
+void ddog_ProfileExporter_delete(struct ddog_ProfileExporter *exporter);
+
+/**
+ * Builds a Request object based on the profile data supplied.
+ *
+ * # Safety
+ * The `exporter` and the files inside of the `files` slice need to have been
+ * created by this module.
+ */
+struct ddog_Request *ddog_ProfileExporter_build(struct ddog_ProfileExporter *exporter,
+                                                struct ddog_Timespec start,
+                                                struct ddog_Timespec end,
+                                                struct ddog_Slice_file files,
+                                                const struct ddog_Vec_tag *additional_tags,
+                                                uint64_t timeout_ms);
+
+/**
+ * Sends the request, returning the HttpStatus.
+ *
+ * # Arguments
+ * * `exporter` - borrows the exporter for sending the request
+ * * `request` - takes ownership of the request
+ * * `cancel` - borrows the cancel, if any
+ *
+ * # Safety
+ * All non-null arguments MUST have been created by created by apis in this module.
+ */
+DDOG_CHECK_RETURN
+struct ddog_SendResult ddog_ProfileExporter_send(struct ddog_ProfileExporter *exporter,
+                                                 struct ddog_Request *request,
+                                                 struct ddog_CancellationToken *cancel);
+
+void ddog_Request_drop(struct ddog_Request *_request);
+
+/**
+ * Can be passed as an argument to send and then be used to asynchronously cancel it from a different thread.
+ */
+DDOG_CHECK_RETURN
+struct ddog_CancellationToken *ddog_CancellationToken_new(void);
+
+/**
+ * A cloned CancellationToken is connected to the CancellationToken it was created from.
+ * Either the cloned or the original token can be used to cancel or provided as arguments to send.
+ * The useful part is that they have independent lifetimes and can be dropped separately.
+ *
+ * Thus, it's possible to do something like:
+ * ```c
+ * cancel_t1 = ddog_CancellationToken_new();
+ * cancel_t2 = ddog_CancellationToken_clone(cancel_t1);
+ *
+ * // On thread t1:
+ *     ddog_ProfileExporter_send(..., cancel_t1);
+ *     ddog_CancellationToken_drop(cancel_t1);
+ *
+ * // On thread t2:
+ *     ddog_CancellationToken_cancel(cancel_t2);
+ *     ddog_CancellationToken_drop(cancel_t2);
+ * ```
+ *
+ * Without clone, both t1 and t2 would need to synchronize to make sure neither was using the cancel
+ * before it could be dropped. With clone, there is no need for such synchronization, both threads
+ * have their own cancel and should drop that cancel after they are done with it.
+ */
+DDOG_CHECK_RETURN
+struct ddog_CancellationToken *ddog_CancellationToken_clone(struct ddog_CancellationToken *cancel);
+
+/**
+ * Cancel send that is being called in another thread with the given token.
+ * Note that cancellation is a terminal state; cancelling a token more than once does nothing.
+ * Returns `true` if token was successfully cancelled.
+ */
+bool ddog_CancellationToken_cancel(struct ddog_CancellationToken *cancel);
+
+void ddog_CancellationToken_drop(struct ddog_CancellationToken *_cancel);
+
+void ddog_SendResult_drop(struct ddog_SendResult result);
+
+/**
+ * Create a new profile with the given sample types. Must call
+ * `ddog_Profile_free` when you are done with the profile.
+ *
+ * # Arguments
+ * * `sample_types`
+ * * `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.
+ *
+ * # Safety
+ * All slices must be have pointers that are suitably aligned for their type
+ * and must have the correct number of elements for the slice.
+ */
+DDOG_CHECK_RETURN
+struct ddog_Profile *ddog_Profile_new(struct ddog_Slice_value_type sample_types,
+                                      const struct ddog_Period *period,
+                                      const struct ddog_Timespec *start_time);
+
+/**
+ * # Safety
+ * The `profile` must point to an object created by another FFI routine in this
+ * module, such as `ddog_Profile_with_sample_types`.
+ */
+void ddog_Profile_free(struct ddog_Profile *_profile);
+
+/**
+ * # Safety
+ * The `profile` ptr must point to a valid Profile object created by this
+ * module. All pointers inside the `sample` need to be valid for the duration
+ * of this call.
+ * This call is _NOT_ thread-safe.
+ */
+uint64_t ddog_Profile_add(struct ddog_Profile *profile, struct ddog_Sample sample);
+
+/**
+ * Associate an endpoint to a given local root span id.
+ * During the serialization of the profile, an endpoint label will be added
+ * to all samples that contain a matching local root span id label.
+ *
+ * Note: calling this API causes the "trace endpoint" and "local root span id" strings
+ * to be interned, even if no matching sample is found.
+ *
+ * # Arguments
+ * * `profile` - a reference to the profile that will contain the samples.
+ * * `local_root_span_id` - the value of the local root span id label to look for.
+ * * `endpoint` - the value of the endpoint label to add for matching samples.
+ *
+ * # Safety
+ * The `profile` ptr must point to a valid Profile object created by this
+ * module.
+ * This call is _NOT_ thread-safe.
+ */
+void ddog_Profile_set_endpoint(struct ddog_Profile *profile,
+                               ddog_CharSlice local_root_span_id,
+                               ddog_CharSlice endpoint);
+
+/**
+ * Serialize the aggregated profile. Don't forget to clean up the result by
+ * calling ddog_SerializeResult_drop.
+ *
+ * # Arguments
+ * * `profile` - a reference to the profile being serialized.
+ * * `end_time` - optional end time of the profile. If None/null is passed, the current time will
+ *                be used.
+ * * `duration_nanos` - Optional duration of the profile. Passing None or a negative duration will
+ *                      mean the duration will based on the end time minus the start time, but
+ *                      under anomalous conditions this may fail as system clocks can be adjusted,
+ *                      or the programmer accidentally passed an earlier time. The duration of
+ *                      the serialized profile will be set to zero for these cases.
+ *
+ * # Safety
+ * The `profile` must point to a valid profile object.
+ * The `end_time` must be null or otherwise point to a valid TimeSpec object.
+ * The `duration_nanos` must be null or otherwise point to a valid i64.
+ */
+struct ddog_SerializeResult ddog_Profile_serialize(const struct ddog_Profile *profile,
+                                                   const struct ddog_Timespec *end_time,
+                                                   const int64_t *duration_nanos);
+
+void ddog_SerializeResult_drop(struct ddog_SerializeResult _result);
+
+DDOG_CHECK_RETURN struct ddog_Slice_u8 ddog_Vec_u8_as_slice(const struct ddog_Vec_u8 *vec);
+
+/**
+ * Resets all data in `profile` except the sample types and period. Returns
+ * true if it successfully reset the profile and false otherwise. The profile
+ * remains valid if false is returned.
+ *
+ * # Arguments
+ * * `profile` - A mutable reference to the profile to be reset.
+ * * `start_time` - The time of the profile (after reset). Pass None/null to use the current time.
+ *
+ * # Safety
+ * The `profile` must meet all the requirements of a mutable reference to the profile. Given this
+ * can be called across an FFI boundary, the compiler cannot enforce this.
+ * If `time` is not null, it must point to a valid Timespec object.
+ */
+bool ddog_Profile_reset(struct ddog_Profile *profile, const struct ddog_Timespec *start_time);
+
+#endif /* DDOG_PROFILING_H */

data/vendor/{libdatadog-0.7.0/x86_64-linux/libdatadog-x86_64-unknown-linux-gnu/lib/pkgconfig/ddprof_ffi_with_rpath.pc → libdatadog-0.8.0/x86_64-linux/libdatadog-x86_64-unknown-linux-gnu/lib/pkgconfig/datadog_profiling_with_rpath.pc}

@@ -8,10 +8,10 @@ exec_prefix=${prefix}
 libdir=${exec_prefix}/lib
 includedir=${prefix}/include
 
-Name: ddprof_ffi
+Name: datadog_profiling
 Description: Contains common code used to implement Datadog's Continuous Profilers. (Dynamic linking variant, sets rpath)
-Version: 0.7.0-rc.1
+Version: @DDog_VERSION@
 Requires:
-Libs: -L${libdir} -lddprof_ffi -Wl,-rpath,${libdir}
+Libs: -L${libdir} -ldatadog_profiling -Wl,-rpath,${libdir}
 Libs.private:
 Cflags: -I${includedir}