.gitignore: add some missing files
[babeltrace.git] / src / lib / trace-ir / clock-class.c
index bb50730609b5036985b94cc0644bb87e78ec51ba..fea35c8d62dda6b35cd818009d8d913bf176d6b3 100644 (file)
 #include "utils.h"
 #include "compat/compiler.h"
 #include <babeltrace2/types.h>
-#include "compat/string.h"
 #include <inttypes.h>
 #include <stdbool.h>
 #include "lib/object.h"
 #include "common/assert.h"
 #include "lib/func-status.h"
 #include "lib/value.h"
+#include "lib/graph/component.h"
+#include "lib/graph/graph.h"
 
 #define BT_ASSERT_PRE_DEV_CLOCK_CLASS_HOT(_cc)                         \
        BT_ASSERT_PRE_DEV_HOT("clock-class", (_cc), "Clock class",      \
                ": %!+K", (_cc))
 
+/* Constants for the UNIX epoch origin */
+static const char *const CC_ORIGIN_UNIX_EPOCH_NS = "babeltrace.org,2020";
+static const char *const CC_ORIGIN_UNIX_EPOCH_NAME = "unix-epoch";
+static const char *const CC_ORIGIN_UNIX_EPOCH_UID = "";
+
 static
-void destroy_clock_class(struct bt_object *obj)
+void free_clock_class_origin_data(struct bt_clock_class *clock_class)
 {
-       struct bt_clock_class *clock_class = (void *) obj;
+       /*
+        * If the origin was set using set_origin_unix_epoch(), then the
+        * pointers are equal to the `CC_ORIGIN_UNIX_EPOCH_*` constants,
+        * therefore the strings aren't dynamically allocated.
+        */
+       if (clock_class->origin.ns != CC_ORIGIN_UNIX_EPOCH_NS) {
+               g_free(clock_class->origin.ns);
+       }
 
-       BT_LIB_LOGD("Destroying clock class: %!+K", clock_class);
-       BT_OBJECT_PUT_REF_AND_RESET(clock_class->user_attributes);
+       clock_class->origin.ns = NULL;
 
-       if (clock_class->name.str) {
-               g_string_free(clock_class->name.str, TRUE);
-               clock_class->name.str = NULL;
-               clock_class->name.value = NULL;
+       if (clock_class->origin.name != CC_ORIGIN_UNIX_EPOCH_NAME) {
+               g_free(clock_class->origin.name);
        }
 
-       if (clock_class->description.str) {
-               g_string_free(clock_class->description.str, TRUE);
-               clock_class->description.str = NULL;
-               clock_class->description.value = NULL;
+       clock_class->origin.name = NULL;
+
+       if (clock_class->origin.uid != CC_ORIGIN_UNIX_EPOCH_UID) {
+               g_free(clock_class->origin.uid);
        }
 
+       clock_class->origin.uid = NULL;
+}
+
+static
+void destroy_clock_class(struct bt_object *obj)
+{
+       struct bt_clock_class *clock_class = (void *) obj;
+
+       BT_LIB_LOGD("Destroying clock class: %!+K", clock_class);
+       BT_OBJECT_PUT_REF_AND_RESET(clock_class->user_attributes);
+
+       g_free(clock_class->ns);
+       g_free(clock_class->name);
+       g_free(clock_class->uid);
+       g_free(clock_class->description);
+       free_clock_class_origin_data(clock_class);
        bt_object_pool_finalize(&clock_class->cs_pool);
        g_free(clock_class);
 }
 
 static
 void free_clock_snapshot(struct bt_clock_snapshot *clock_snapshot,
-               struct bt_clock_class *clock_class)
+               struct bt_clock_class *clock_class __attribute__((unused)))
 {
        bt_clock_snapshot_destroy(clock_snapshot);
 }
@@ -67,6 +93,27 @@ void set_base_offset(struct bt_clock_class *clock_class)
                clock_class->frequency, &clock_class->base_offset.value_ns);
 }
 
+static void
+set_origin_unix_epoch(struct bt_clock_class *clock_class)
+{
+       free_clock_class_origin_data(clock_class);
+
+       /*
+        * For the Unix epoch origin, don't use g_strdup() to avoid
+        * allocations.
+        */
+       clock_class->origin.ns = (gchar *) CC_ORIGIN_UNIX_EPOCH_NS;
+       clock_class->origin.name = (gchar *) CC_ORIGIN_UNIX_EPOCH_NAME;
+       clock_class->origin.uid = (gchar *) CC_ORIGIN_UNIX_EPOCH_UID;
+}
+
+static void
+set_origin_unknown(struct bt_clock_class *clock_class)
+{
+       free_clock_class_origin_data(clock_class);
+}
+
+BT_EXPORT
 struct bt_clock_class *bt_clock_class_create(bt_self_component *self_comp)
 {
        int ret;
@@ -84,6 +131,9 @@ struct bt_clock_class *bt_clock_class_create(bt_self_component *self_comp)
 
        bt_object_init_shared(&clock_class->base, destroy_clock_class);
 
+       clock_class->mip_version =
+               bt_component_borrow_graph((void *) self_comp)->mip_version;
+
        clock_class->user_attributes = bt_value_map_create();
        if (!clock_class->user_attributes) {
                BT_LIB_LOGE_APPEND_CAUSE(
@@ -91,20 +141,14 @@ struct bt_clock_class *bt_clock_class_create(bt_self_component *self_comp)
                goto error;
        }
 
-       clock_class->name.str = g_string_new(NULL);
-       if (!clock_class->name.str) {
-               BT_LIB_LOGE_APPEND_CAUSE("Failed to allocate a GString.");
-               goto error;
-       }
+       clock_class->frequency = UINT64_C(1000000000);
 
-       clock_class->description.str = g_string_new(NULL);
-       if (!clock_class->description.str) {
-               BT_LIB_LOGE_APPEND_CAUSE("Failed to allocate a GString.");
-               goto error;
+       if (clock_class->mip_version == 0) {
+               clock_class->precision.base.avail =
+                       BT_PROPERTY_AVAILABILITY_AVAILABLE;
        }
 
-       clock_class->frequency = UINT64_C(1000000000);
-       clock_class->origin_is_unix_epoch = BT_TRUE;
+       set_origin_unix_epoch(clock_class);
        set_base_offset(clock_class);
        ret = bt_object_pool_initialize(&clock_class->cs_pool,
                (bt_object_pool_new_object_func) bt_clock_snapshot_new,
@@ -128,12 +172,38 @@ end:
        return clock_class;
 }
 
+BT_EXPORT
+const char *bt_clock_class_get_namespace(
+               const struct bt_clock_class *clock_class)
+{
+       BT_ASSERT_PRE_DEV_CLK_CLS_NON_NULL(clock_class);
+       BT_ASSERT_PRE_CC_MIP_VERSION_GE(clock_class, 1);
+       return clock_class->ns;
+}
+
+BT_EXPORT
+enum bt_clock_class_set_namespace_status bt_clock_class_set_namespace(
+               struct bt_clock_class *clock_class, const char *ns)
+{
+       BT_ASSERT_PRE_NO_ERROR();
+       BT_ASSERT_PRE_CLK_CLS_NON_NULL(clock_class);
+       BT_ASSERT_PRE_NAME_NON_NULL(ns);
+       BT_ASSERT_PRE_DEV_CLOCK_CLASS_HOT(clock_class);
+       BT_ASSERT_PRE_CC_MIP_VERSION_GE(clock_class, 1);
+       g_free(clock_class->ns);
+       clock_class->ns = g_strdup(ns);
+       BT_LIB_LOGD("Set clock class's namespace: %!+K", clock_class);
+       return BT_FUNC_STATUS_OK;
+}
+
+BT_EXPORT
 const char *bt_clock_class_get_name(const struct bt_clock_class *clock_class)
 {
        BT_ASSERT_PRE_DEV_CLK_CLS_NON_NULL(clock_class);
-       return clock_class->name.value;
+       return clock_class->name;
 }
 
+BT_EXPORT
 enum bt_clock_class_set_name_status bt_clock_class_set_name(
                struct bt_clock_class *clock_class, const char *name)
 {
@@ -141,19 +211,45 @@ enum bt_clock_class_set_name_status bt_clock_class_set_name(
        BT_ASSERT_PRE_CLK_CLS_NON_NULL(clock_class);
        BT_ASSERT_PRE_NAME_NON_NULL(name);
        BT_ASSERT_PRE_DEV_CLOCK_CLASS_HOT(clock_class);
-       g_string_assign(clock_class->name.str, name);
-       clock_class->name.value = clock_class->name.str->str;
+       g_free(clock_class->name);
+       clock_class->name = g_strdup(name);
        BT_LIB_LOGD("Set clock class's name: %!+K", clock_class);
        return BT_FUNC_STATUS_OK;
 }
 
+BT_EXPORT
+const char *bt_clock_class_get_uid(const struct bt_clock_class *clock_class)
+{
+       BT_ASSERT_PRE_NO_ERROR();
+       BT_ASSERT_PRE_DEV_CLK_CLS_NON_NULL(clock_class);
+       BT_ASSERT_PRE_CC_MIP_VERSION_GE(clock_class, 1);
+       return clock_class->uid;
+}
+
+BT_EXPORT
+enum bt_clock_class_set_uid_status bt_clock_class_set_uid(
+               struct bt_clock_class *clock_class, const char *uid)
+{
+       BT_ASSERT_PRE_NO_ERROR();
+       BT_ASSERT_PRE_CLK_CLS_NON_NULL(clock_class);
+       BT_ASSERT_PRE_NAME_NON_NULL(uid);
+       BT_ASSERT_PRE_DEV_CLOCK_CLASS_HOT(clock_class);
+       BT_ASSERT_PRE_CC_MIP_VERSION_GE(clock_class, 1);
+       g_free(clock_class->uid);
+       clock_class->uid = g_strdup(uid);
+       BT_LIB_LOGD("Set clock class's UID: %!+K", clock_class);
+       return BT_FUNC_STATUS_OK;
+}
+
+BT_EXPORT
 const char *bt_clock_class_get_description(
                const struct bt_clock_class *clock_class)
 {
        BT_ASSERT_PRE_DEV_CLK_CLS_NON_NULL(clock_class);
-       return clock_class->description.value;
+       return clock_class->description;
 }
 
+BT_EXPORT
 enum bt_clock_class_set_description_status bt_clock_class_set_description(
                struct bt_clock_class *clock_class, const char *descr)
 {
@@ -161,19 +257,21 @@ enum bt_clock_class_set_description_status bt_clock_class_set_description(
        BT_ASSERT_PRE_CLK_CLS_NON_NULL(clock_class);
        BT_ASSERT_PRE_DESCR_NON_NULL(descr);
        BT_ASSERT_PRE_DEV_CLOCK_CLASS_HOT(clock_class);
-       g_string_assign(clock_class->description.str, descr);
-       clock_class->description.value = clock_class->description.str->str;
+       g_free(clock_class->description);
+       clock_class->description = g_strdup(descr);
        BT_LIB_LOGD("Set clock class's description: %!+K",
                clock_class);
        return BT_FUNC_STATUS_OK;
 }
 
+BT_EXPORT
 uint64_t bt_clock_class_get_frequency(const struct bt_clock_class *clock_class)
 {
        BT_ASSERT_PRE_DEV_CLK_CLS_NON_NULL(clock_class);
        return clock_class->frequency;
 }
 
+BT_EXPORT
 void bt_clock_class_set_frequency(struct bt_clock_class *clock_class,
                uint64_t frequency)
 {
@@ -192,12 +290,30 @@ void bt_clock_class_set_frequency(struct bt_clock_class *clock_class,
        BT_LIB_LOGD("Set clock class's frequency: %!+K", clock_class);
 }
 
+BT_EXPORT
 uint64_t bt_clock_class_get_precision(const struct bt_clock_class *clock_class)
 {
        BT_ASSERT_PRE_DEV_CLK_CLS_NON_NULL(clock_class);
-       return clock_class->precision;
+       BT_ASSERT_PRE_CC_MIP_VERSION_EQ(clock_class, 0);
+       BT_ASSERT_DBG(clock_class->precision.base.avail ==
+               BT_PROPERTY_AVAILABILITY_AVAILABLE);
+       return clock_class->precision.value;
+}
+
+BT_EXPORT
+bt_property_availability bt_clock_class_get_opt_precision(
+               const struct bt_clock_class *clock_class, uint64_t *precision)
+{
+       BT_ASSERT_PRE_NO_ERROR();
+       BT_ASSERT_PRE_DEV_CLK_CLS_NON_NULL(clock_class);
+       BT_ASSERT_PRE_DEV_NON_NULL("precision-output", precision,
+               "Precision (output)");
+
+       *precision = clock_class->precision.value;
+       return clock_class->precision.base.avail;
 }
 
+BT_EXPORT
 void bt_clock_class_set_precision(struct bt_clock_class *clock_class,
                uint64_t precision)
 {
@@ -206,10 +322,42 @@ void bt_clock_class_set_precision(struct bt_clock_class *clock_class,
        BT_ASSERT_PRE("valid-precision", precision != UINT64_C(-1),
                "Invalid precision: %![cc-]+K, new-precision=%" PRIu64,
                clock_class, precision);
-       clock_class->precision = precision;
+       clock_class->precision.value = precision;
+       clock_class->precision.base.avail = BT_PROPERTY_AVAILABILITY_AVAILABLE;
        BT_LIB_LOGD("Set clock class's precision: %!+K", clock_class);
 }
 
+BT_EXPORT
+void bt_clock_class_set_accuracy(bt_clock_class *clock_class,
+               uint64_t accuracy)
+{
+       BT_ASSERT_PRE_NO_ERROR();
+       BT_ASSERT_PRE_CLK_CLS_NON_NULL(clock_class);
+       BT_ASSERT_PRE_DEV_CLOCK_CLASS_HOT(clock_class);
+       BT_ASSERT_PRE_CC_MIP_VERSION_GE(clock_class, 1);
+       BT_ASSERT_PRE("valid-accuracy", accuracy != UINT64_C(-1),
+               "Invalid accuracy: %![cc-]+K, new-accuracy=%" PRIu64,
+               clock_class, accuracy);
+       clock_class->accuracy.value = accuracy;
+       clock_class->accuracy.base.avail = BT_PROPERTY_AVAILABILITY_AVAILABLE;
+       BT_LIB_LOGD("Set clock class's accuracy: %!+K", clock_class);
+}
+
+BT_EXPORT
+bt_property_availability bt_clock_class_get_accuracy(
+               const struct bt_clock_class *clock_class, uint64_t *accuracy)
+{
+       BT_ASSERT_PRE_NO_ERROR();
+       BT_ASSERT_PRE_DEV_CLK_CLS_NON_NULL(clock_class);
+       BT_ASSERT_PRE_CC_MIP_VERSION_GE(clock_class, 1);
+       BT_ASSERT_PRE_DEV_NON_NULL("accuracy-output", accuracy,
+               "Accuracy (output)");
+
+       *accuracy = clock_class->accuracy.value;
+       return clock_class->accuracy.base.avail;
+}
+
+BT_EXPORT
 void bt_clock_class_get_offset(const struct bt_clock_class *clock_class,
                int64_t *seconds, uint64_t *cycles)
 {
@@ -221,6 +369,7 @@ void bt_clock_class_get_offset(const struct bt_clock_class *clock_class,
        *cycles = clock_class->offset_cycles;
 }
 
+BT_EXPORT
 void bt_clock_class_set_offset(struct bt_clock_class *clock_class,
                int64_t seconds, uint64_t cycles)
 {
@@ -236,40 +385,136 @@ void bt_clock_class_set_offset(struct bt_clock_class *clock_class,
        BT_LIB_LOGD("Set clock class's offset: %!+K", clock_class);
 }
 
+BT_EXPORT
+const char *bt_clock_class_get_origin_namespace(
+               const bt_clock_class *clock_class)
+{
+       BT_ASSERT_PRE_NO_ERROR();
+       BT_ASSERT_PRE_DEV_CLK_CLS_NON_NULL(clock_class);
+       BT_ASSERT_PRE_CC_MIP_VERSION_GE(clock_class, 1);
+       return clock_class->origin.ns;
+}
+
+BT_EXPORT
+const char *bt_clock_class_get_origin_name(
+               const bt_clock_class *clock_class)
+{
+       BT_ASSERT_PRE_NO_ERROR();
+       BT_ASSERT_PRE_DEV_CLK_CLS_NON_NULL(clock_class);
+       BT_ASSERT_PRE_CC_MIP_VERSION_GE(clock_class, 1);
+       return clock_class->origin.name;
+}
+
+BT_EXPORT
+const char *bt_clock_class_get_origin_uid(
+               const bt_clock_class *clock_class)
+{
+       BT_ASSERT_PRE_NO_ERROR();
+       BT_ASSERT_PRE_DEV_CLK_CLS_NON_NULL(clock_class);
+       BT_ASSERT_PRE_CC_MIP_VERSION_GE(clock_class, 1);
+       return clock_class->origin.uid;
+}
+
+BT_EXPORT
 bt_bool bt_clock_class_origin_is_unix_epoch(const struct bt_clock_class *clock_class)
 {
+       BT_ASSERT_PRE_NO_ERROR();
+       BT_ASSERT_PRE_DEV_CLK_CLS_NON_NULL(clock_class);
+
+       /*
+        * We don't just compare the pointers to the constants, as the
+        * user could set the same values using
+        * bt_clock_class_set_origin().
+        */
+       return g_strcmp0(clock_class->origin.ns, CC_ORIGIN_UNIX_EPOCH_NS) == 0 &&
+               g_strcmp0(clock_class->origin.name, CC_ORIGIN_UNIX_EPOCH_NAME) == 0 &&
+               g_strcmp0(clock_class->origin.uid, CC_ORIGIN_UNIX_EPOCH_UID) == 0;
+}
+
+BT_EXPORT
+bt_bool bt_clock_class_origin_is_unknown(const struct bt_clock_class *clock_class)
+{
+       BT_ASSERT_PRE_NO_ERROR();
        BT_ASSERT_PRE_DEV_CLK_CLS_NON_NULL(clock_class);
-       return (bool) clock_class->origin_is_unix_epoch;
+       return !clock_class->origin.ns && !clock_class->origin.name &&
+               !clock_class->origin.uid;
 }
 
+BT_EXPORT
 void bt_clock_class_set_origin_is_unix_epoch(struct bt_clock_class *clock_class,
                bt_bool origin_is_unix_epoch)
 {
+       BT_ASSERT_PRE_NO_ERROR();
        BT_ASSERT_PRE_CLK_CLS_NON_NULL(clock_class);
        BT_ASSERT_PRE_DEV_CLOCK_CLASS_HOT(clock_class);
-       clock_class->origin_is_unix_epoch = (bool) origin_is_unix_epoch;
+
+       if (origin_is_unix_epoch) {
+               set_origin_unix_epoch(clock_class);
+       } else {
+               set_origin_unknown(clock_class);
+       }
+
        BT_LIB_LOGD("Set clock class's origin is Unix epoch property: %!+K",
                clock_class);
 }
 
+BT_EXPORT
+void bt_clock_class_set_origin_unknown(struct bt_clock_class *clock_class)
+{
+       BT_ASSERT_PRE_NO_ERROR();
+       BT_ASSERT_PRE_CLK_CLS_NON_NULL(clock_class);
+       BT_ASSERT_PRE_DEV_CLOCK_CLASS_HOT(clock_class);
+       set_origin_unknown(clock_class);
+}
+
+BT_EXPORT
+enum bt_clock_class_set_origin_status bt_clock_class_set_origin(
+               struct bt_clock_class *clock_class, const char *ns,
+               const char *name, const char *uid)
+{
+       BT_ASSERT_PRE_NO_ERROR();
+       BT_ASSERT_PRE_CLK_CLS_NON_NULL(clock_class);
+       BT_ASSERT_PRE_DEV_CLOCK_CLASS_HOT(clock_class);
+       BT_ASSERT_PRE_CC_MIP_VERSION_GE(clock_class, 1);
+       BT_ASSERT_PRE_NAME_NON_NULL(name);
+       BT_ASSERT_PRE_UID_NON_NULL(uid);
+       free_clock_class_origin_data(clock_class);
+       clock_class->origin.ns = g_strdup(ns);
+       clock_class->origin.name = g_strdup(name);
+       clock_class->origin.uid = g_strdup(uid);
+       return BT_FUNC_STATUS_OK;
+}
+
+BT_EXPORT
+void bt_clock_class_set_origin_unix_epoch(struct bt_clock_class *clock_class)
+{
+       BT_ASSERT_PRE_NO_ERROR();
+       BT_ASSERT_PRE_CLK_CLS_NON_NULL(clock_class);
+       BT_ASSERT_PRE_DEV_CLOCK_CLASS_HOT(clock_class);
+       set_origin_unix_epoch(clock_class);
+}
+
+BT_EXPORT
 bt_uuid bt_clock_class_get_uuid(const struct bt_clock_class *clock_class)
 {
        BT_ASSERT_PRE_DEV_CLK_CLS_NON_NULL(clock_class);
+       BT_ASSERT_PRE_CC_MIP_VERSION_EQ(clock_class, 0);
        return clock_class->uuid.value;
 }
 
+BT_EXPORT
 void bt_clock_class_set_uuid(struct bt_clock_class *clock_class,
                bt_uuid uuid)
 {
        BT_ASSERT_PRE_CLK_CLS_NON_NULL(clock_class);
        BT_ASSERT_PRE_UUID_NON_NULL(uuid);
        BT_ASSERT_PRE_DEV_CLOCK_CLASS_HOT(clock_class);
+       BT_ASSERT_PRE_CC_MIP_VERSION_EQ(clock_class, 0);
        bt_uuid_copy(clock_class->uuid.uuid, uuid);
        clock_class->uuid.value = clock_class->uuid.uuid;
        BT_LIB_LOGD("Set clock class's UUID: %!+K", clock_class);
 }
 
-BT_HIDDEN
 void _bt_clock_class_freeze(const struct bt_clock_class *clock_class)
 {
        BT_ASSERT(clock_class);
@@ -285,6 +530,7 @@ void _bt_clock_class_freeze(const struct bt_clock_class *clock_class)
        ((struct bt_clock_class *) clock_class)->frozen = 1;
 }
 
+BT_EXPORT
 enum bt_clock_class_cycles_to_ns_from_origin_status
 bt_clock_class_cycles_to_ns_from_origin(
                const struct bt_clock_class *clock_class,
@@ -309,6 +555,37 @@ bt_clock_class_cycles_to_ns_from_origin(
        return ret;
 }
 
+BT_EXPORT
+bt_bool bt_clock_class_has_same_identity(
+               const bt_clock_class *cc_a,
+               const bt_clock_class *cc_b)
+{
+       BT_ASSERT_PRE_DEV_CLK_CLS_NON_NULL(cc_a);
+       BT_ASSERT_PRE_DEV_CLK_CLS_NON_NULL(cc_b);
+       BT_ASSERT_PRE_CC_MIP_VERSION_GE(cc_a, 1);
+       BT_ASSERT_PRE_CC_MIP_VERSION_GE(cc_b, 1);
+
+       bt_bool is_same = BT_FALSE;
+
+       if (g_strcmp0(cc_a->ns, cc_b->ns) != 0) {
+               goto end;
+       }
+
+       if (!cc_a->name || !cc_b->name || strcmp(cc_a->name, cc_b->name) != 0) {
+               goto end;
+       }
+
+       if (!cc_a->uid || !cc_b->uid || strcmp(cc_a->uid, cc_b->uid) != 0) {
+               goto end;
+       }
+
+       is_same = BT_TRUE;
+
+end:
+       return is_same;
+}
+
+BT_EXPORT
 const struct bt_value *bt_clock_class_borrow_user_attributes_const(
                const struct bt_clock_class *clock_class)
 {
@@ -316,6 +593,7 @@ const struct bt_value *bt_clock_class_borrow_user_attributes_const(
        return clock_class->user_attributes;
 }
 
+BT_EXPORT
 struct bt_value *bt_clock_class_borrow_user_attributes(
                struct bt_clock_class *clock_class)
 {
@@ -323,6 +601,7 @@ struct bt_value *bt_clock_class_borrow_user_attributes(
                (void *) clock_class);
 }
 
+BT_EXPORT
 void bt_clock_class_set_user_attributes(
                struct bt_clock_class *clock_class,
                const struct bt_value *user_attributes)
@@ -336,11 +615,13 @@ void bt_clock_class_set_user_attributes(
        bt_object_get_ref_no_null_check(clock_class->user_attributes);
 }
 
+BT_EXPORT
 void bt_clock_class_get_ref(const struct bt_clock_class *clock_class)
 {
        bt_object_get_ref(clock_class);
 }
 
+BT_EXPORT
 void bt_clock_class_put_ref(const struct bt_clock_class *clock_class)
 {
        bt_object_put_ref(clock_class);
This page took 0.029702 seconds and 4 git commands to generate.