libdatadog 0.7.0.1.0 → 2.0.0.1.0

data/vendor/libdatadog-2.0.0/x86_64-linux-musl/libdatadog-x86_64-alpine-linux-musl/include/datadog/profiling.h

@@ -0,0 +1,285 @@
+// 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
+
+#pragma once
+
+#include <stdbool.h>
+#include <stddef.h>
+#include <stdint.h>
+#include "common.h"
+
+/**
+ * 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);
+
+/**
+ * Creates a new exporter to be used to report profiling data.
+ * # Arguments
+ * * `profiling_library_name` - Profiling library name, usually dd-trace-something, e.g. "dd-trace-rb". See
+ *   https://datadoghq.atlassian.net/wiki/spaces/PROF/pages/1538884229/Client#Header-values (Datadog internal link)
+ *   for a list of common values.
+ * * `profliling_library_version` - Version used when publishing the profiling library to a package manager
+ * * `family` - Profile family, e.g. "ruby"
+ * * `tags` - Tags to include with every profile reported by this exporter. It's also possible to include
+ *   profile-specific tags, see `additional_tags` on `profile_exporter_build`.
+ * * `endpoint` - Configuration for reporting data
+ * # Safety
+ * All pointers must refer to valid objects of the correct types.
+ */
+DDOG_CHECK_RETURN
+struct ddog_prof_Exporter_NewResult ddog_prof_Exporter_new(ddog_CharSlice profiling_library_name,
+                                                           ddog_CharSlice profiling_library_version,
+                                                           ddog_CharSlice family,
+                                                           const struct ddog_Vec_Tag *tags,
+                                                           struct ddog_Endpoint endpoint);
+
+/**
+ * # Safety
+ * The `exporter` may be null, but if non-null the pointer must point to a
+ * valid `ddog_prof_Exporter_Request` object made by the Rust Global
+ * allocator that has not already been dropped.
+ */
+void ddog_prof_Exporter_drop(struct ddog_prof_Exporter *exporter);
+
+/**
+ * If successful, builds a `ddog_prof_Exporter_Request` object based on the
+ * profile data supplied. If unsuccessful, it returns an error message.
+ *
+ * # Safety
+ * The `exporter`, `additional_stats`, and `endpoint_stats` args should be
+ * valid objects created by this module, except NULL is allowed.
+ */
+DDOG_CHECK_RETURN
+struct ddog_prof_Exporter_Request_BuildResult ddog_prof_Exporter_Request_build(struct ddog_prof_Exporter *exporter,
+                                                                               struct ddog_Timespec start,
+                                                                               struct ddog_Timespec end,
+                                                                               struct ddog_prof_Exporter_Slice_File files,
+                                                                               const struct ddog_Vec_Tag *additional_tags,
+                                                                               const struct ddog_prof_ProfiledEndpointsStats *endpoints_stats,
+                                                                               uint64_t timeout_ms);
+
+/**
+ * # 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_Exporter_Request **request);
+
+/**
+ * Sends the request, 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.
+ *
+ * # Safety
+ * All non-null arguments MUST have been created by created by apis in this module.
+ */
+DDOG_CHECK_RETURN
+struct ddog_prof_Exporter_SendResult ddog_prof_Exporter_send(struct ddog_prof_Exporter *exporter,
+                                                             struct ddog_prof_Exporter_Request **request,
+                                                             const struct ddog_CancellationToken *cancel);
+
+/**
+ * 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_prof_Exporter_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.
+ *
+ * # Safety
+ * If the `token` is non-null, it must point to a valid object.
+ */
+DDOG_CHECK_RETURN
+struct ddog_CancellationToken *ddog_CancellationToken_clone(const struct ddog_CancellationToken *token);
+
+/**
+ * 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(const struct ddog_CancellationToken *cancel);
+
+/**
+ * # Safety
+ * The `token` can be null, but non-null values must be created by the Rust
+ * Global allocator and must have not been dropped already.
+ */
+void ddog_CancellationToken_drop(struct ddog_CancellationToken *token);
+
+/**
+ * Create a new profile with the given sample types. Must call
+ * `ddog_prof_Profile_drop` 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_prof_Profile *ddog_prof_Profile_new(struct ddog_prof_Slice_ValueType sample_types,
+                                                const struct ddog_prof_Period *period,
+                                                const struct ddog_Timespec *start_time);
+
+/**
+ * # Safety
+ * The `profile` can be null, but if non-null it must point to a valid object
+ * created by the Rust Global allocator.
+ */
+void ddog_prof_Profile_drop(struct ddog_prof_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.
+ *
+ * If successful, it returns the internal id of the sample (> 0) in the Ok
+ * variant. On error, it holds an error message in the error variant.
+ *
+ * # Safety
+ * The `profile` ptr must point to a valid Profile object created by this
+ * module.
+ * This call is _NOT_ thread-safe.
+ */
+DDOG_CHECK_RETURN
+struct ddog_prof_Profile_AddResult ddog_prof_Profile_add(struct ddog_prof_Profile *profile,
+                                                         struct ddog_prof_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`
+ * * `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_prof_Profile_set_endpoint(struct ddog_prof_Profile *profile,
+                                    uint64_t local_root_span_id,
+                                    ddog_CharSlice endpoint);
+
+/**
+ * Count the number of times an endpoint has been seen.
+ *
+ * # Arguments
+ * * `profile` - a reference to the profile that will contain the samples.
+ * * `endpoint` - the endpoint label for which the count will be incremented
+ *
+ * # Safety
+ * The `profile` ptr must point to a valid Profile object created by this
+ * module.
+ * This call is _NOT_ thread-safe.
+ */
+void ddog_prof_Profile_add_endpoint_count(struct ddog_prof_Profile *profile,
+                                          ddog_CharSlice endpoint,
+                                          int64_t value);
+
+/**
+ * # Safety
+ * Only pass a reference to a valid `ddog_prof_EncodedProfile`, or null. A
+ * valid reference also means that it hasn't already been dropped (do not
+ * call this twice on the same object).
+ */
+void ddog_prof_EncodedProfile_drop(struct ddog_prof_EncodedProfile *profile);
+
+/**
+ * Serialize the aggregated profile.
+ *
+ * Don't forget to clean up the ok with `ddog_prof_EncodedProfile_drop` or
+ * the error variant with `ddog_Error_drop` when you are done with them.
+ *
+ * # 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.
+ */
+DDOG_CHECK_RETURN
+struct ddog_prof_Profile_SerializeResult ddog_prof_Profile_serialize(const struct ddog_prof_Profile *profile,
+                                                                     const struct ddog_Timespec *end_time,
+                                                                     const int64_t *duration_nanos);
+
+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_prof_Profile_reset(struct ddog_prof_Profile *profile,
+                             const struct ddog_Timespec *start_time);
+
+#endif /* DDOG_PROFILING_H */

data/vendor/{libdatadog-0.7.0/x86_64-linux-musl/libdatadog-x86_64-alpine-linux-musl/lib/pkgconfig/ddprof_ffi_with_rpath.pc → libdatadog-2.0.0/x86_64-linux-musl/libdatadog-x86_64-alpine-linux-musl/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
+Version: 2.0.0
 Requires:
-Libs: -L${libdir} -lddprof_ffi -Wl,-rpath,${libdir}
+Libs: -L${libdir} -ldatadog_profiling -Wl,-rpath,${libdir}
 Libs.private:
 Cflags: -I${includedir}

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: libdatadog
 version: !ruby/object:Gem::Version
-  version: 0.7.0.1.0
+  version: 2.0.0.1.0
 platform: ruby
 authors:
 - Datadog, Inc.
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-07-08 00:00:00.000000000 Z
+date: 2023-02-03 00:00:00.000000000 Z
 dependencies: []
 description: libdatadog is a Rust-based utility library for Datadog's ddtrace gem.
 email:
@@ -19,30 +19,34 @@ extra_rdoc_files: []
 files:
 - lib/libdatadog.rb
 - lib/libdatadog/version.rb
-- vendor/libdatadog-0.7.0/aarch64-linux-musl/libdatadog-aarch64-alpine-linux-musl/LICENSE
-- vendor/libdatadog-0.7.0/aarch64-linux-musl/libdatadog-aarch64-alpine-linux-musl/LICENSE-3rdparty.yml
-- vendor/libdatadog-0.7.0/aarch64-linux-musl/libdatadog-aarch64-alpine-linux-musl/NOTICE
-- vendor/libdatadog-0.7.0/aarch64-linux-musl/libdatadog-aarch64-alpine-linux-musl/include/ddprof/ffi.h
-- vendor/libdatadog-0.7.0/aarch64-linux-musl/libdatadog-aarch64-alpine-linux-musl/lib/libddprof_ffi.so
-- vendor/libdatadog-0.7.0/aarch64-linux-musl/libdatadog-aarch64-alpine-linux-musl/lib/pkgconfig/ddprof_ffi_with_rpath.pc
-- vendor/libdatadog-0.7.0/aarch64-linux/libdatadog-aarch64-unknown-linux-gnu/LICENSE
-- vendor/libdatadog-0.7.0/aarch64-linux/libdatadog-aarch64-unknown-linux-gnu/LICENSE-3rdparty.yml
-- vendor/libdatadog-0.7.0/aarch64-linux/libdatadog-aarch64-unknown-linux-gnu/NOTICE
-- vendor/libdatadog-0.7.0/aarch64-linux/libdatadog-aarch64-unknown-linux-gnu/include/ddprof/ffi.h
-- vendor/libdatadog-0.7.0/aarch64-linux/libdatadog-aarch64-unknown-linux-gnu/lib/libddprof_ffi.so
-- vendor/libdatadog-0.7.0/aarch64-linux/libdatadog-aarch64-unknown-linux-gnu/lib/pkgconfig/ddprof_ffi_with_rpath.pc
-- vendor/libdatadog-0.7.0/x86_64-linux-musl/libdatadog-x86_64-alpine-linux-musl/LICENSE
-- vendor/libdatadog-0.7.0/x86_64-linux-musl/libdatadog-x86_64-alpine-linux-musl/LICENSE-3rdparty.yml
-- vendor/libdatadog-0.7.0/x86_64-linux-musl/libdatadog-x86_64-alpine-linux-musl/NOTICE
-- vendor/libdatadog-0.7.0/x86_64-linux-musl/libdatadog-x86_64-alpine-linux-musl/include/ddprof/ffi.h
-- vendor/libdatadog-0.7.0/x86_64-linux-musl/libdatadog-x86_64-alpine-linux-musl/lib/libddprof_ffi.so
-- vendor/libdatadog-0.7.0/x86_64-linux-musl/libdatadog-x86_64-alpine-linux-musl/lib/pkgconfig/ddprof_ffi_with_rpath.pc
-- vendor/libdatadog-0.7.0/x86_64-linux/libdatadog-x86_64-unknown-linux-gnu/LICENSE
-- vendor/libdatadog-0.7.0/x86_64-linux/libdatadog-x86_64-unknown-linux-gnu/LICENSE-3rdparty.yml
-- vendor/libdatadog-0.7.0/x86_64-linux/libdatadog-x86_64-unknown-linux-gnu/NOTICE
-- vendor/libdatadog-0.7.0/x86_64-linux/libdatadog-x86_64-unknown-linux-gnu/include/ddprof/ffi.h
-- vendor/libdatadog-0.7.0/x86_64-linux/libdatadog-x86_64-unknown-linux-gnu/lib/libddprof_ffi.so
-- vendor/libdatadog-0.7.0/x86_64-linux/libdatadog-x86_64-unknown-linux-gnu/lib/pkgconfig/ddprof_ffi_with_rpath.pc
+- vendor/libdatadog-2.0.0/aarch64-linux-musl/libdatadog-aarch64-alpine-linux-musl/LICENSE
+- vendor/libdatadog-2.0.0/aarch64-linux-musl/libdatadog-aarch64-alpine-linux-musl/LICENSE-3rdparty.yml
+- vendor/libdatadog-2.0.0/aarch64-linux-musl/libdatadog-aarch64-alpine-linux-musl/NOTICE
+- vendor/libdatadog-2.0.0/aarch64-linux-musl/libdatadog-aarch64-alpine-linux-musl/include/datadog/common.h
+- vendor/libdatadog-2.0.0/aarch64-linux-musl/libdatadog-aarch64-alpine-linux-musl/include/datadog/profiling.h
+- vendor/libdatadog-2.0.0/aarch64-linux-musl/libdatadog-aarch64-alpine-linux-musl/lib/libdatadog_profiling.so
+- vendor/libdatadog-2.0.0/aarch64-linux-musl/libdatadog-aarch64-alpine-linux-musl/lib/pkgconfig/datadog_profiling_with_rpath.pc
+- vendor/libdatadog-2.0.0/aarch64-linux/libdatadog-aarch64-unknown-linux-gnu/LICENSE
+- vendor/libdatadog-2.0.0/aarch64-linux/libdatadog-aarch64-unknown-linux-gnu/LICENSE-3rdparty.yml
+- vendor/libdatadog-2.0.0/aarch64-linux/libdatadog-aarch64-unknown-linux-gnu/NOTICE
+- vendor/libdatadog-2.0.0/aarch64-linux/libdatadog-aarch64-unknown-linux-gnu/include/datadog/common.h
+- vendor/libdatadog-2.0.0/aarch64-linux/libdatadog-aarch64-unknown-linux-gnu/include/datadog/profiling.h
+- vendor/libdatadog-2.0.0/aarch64-linux/libdatadog-aarch64-unknown-linux-gnu/lib/libdatadog_profiling.so
+- vendor/libdatadog-2.0.0/aarch64-linux/libdatadog-aarch64-unknown-linux-gnu/lib/pkgconfig/datadog_profiling_with_rpath.pc
+- vendor/libdatadog-2.0.0/x86_64-linux-musl/libdatadog-x86_64-alpine-linux-musl/LICENSE
+- vendor/libdatadog-2.0.0/x86_64-linux-musl/libdatadog-x86_64-alpine-linux-musl/LICENSE-3rdparty.yml
+- vendor/libdatadog-2.0.0/x86_64-linux-musl/libdatadog-x86_64-alpine-linux-musl/NOTICE
+- vendor/libdatadog-2.0.0/x86_64-linux-musl/libdatadog-x86_64-alpine-linux-musl/include/datadog/common.h
+- vendor/libdatadog-2.0.0/x86_64-linux-musl/libdatadog-x86_64-alpine-linux-musl/include/datadog/profiling.h
+- vendor/libdatadog-2.0.0/x86_64-linux-musl/libdatadog-x86_64-alpine-linux-musl/lib/libdatadog_profiling.so
+- vendor/libdatadog-2.0.0/x86_64-linux-musl/libdatadog-x86_64-alpine-linux-musl/lib/pkgconfig/datadog_profiling_with_rpath.pc
+- vendor/libdatadog-2.0.0/x86_64-linux/libdatadog-x86_64-unknown-linux-gnu/LICENSE
+- vendor/libdatadog-2.0.0/x86_64-linux/libdatadog-x86_64-unknown-linux-gnu/LICENSE-3rdparty.yml
+- vendor/libdatadog-2.0.0/x86_64-linux/libdatadog-x86_64-unknown-linux-gnu/NOTICE
+- vendor/libdatadog-2.0.0/x86_64-linux/libdatadog-x86_64-unknown-linux-gnu/include/datadog/common.h
+- vendor/libdatadog-2.0.0/x86_64-linux/libdatadog-x86_64-unknown-linux-gnu/include/datadog/profiling.h
+- vendor/libdatadog-2.0.0/x86_64-linux/libdatadog-x86_64-unknown-linux-gnu/lib/libdatadog_profiling.so
+- vendor/libdatadog-2.0.0/x86_64-linux/libdatadog-x86_64-unknown-linux-gnu/lib/pkgconfig/datadog_profiling_with_rpath.pc
 homepage: https://docs.datadoghq.com/tracing/
 licenses:
 - Apache-2.0
@@ -66,7 +70,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.7
+rubygems_version: 3.3.26
 signing_key: 
 specification_version: 4
 summary: Library of common code used by Datadog Continuous Profiler for Ruby