+bt_uuid bt_trace_get_uuid(const struct bt_trace *trace)
+{
+ BT_ASSERT_PRE_DEV_NON_NULL(trace, "Trace");
+ return trace->uuid.value;
+}
+
+void bt_trace_set_uuid(struct bt_trace *trace, bt_uuid uuid)
+{
+ BT_ASSERT_PRE_NON_NULL(trace, "Trace");
+ BT_ASSERT_PRE_NON_NULL(uuid, "UUID");
+ BT_ASSERT_PRE_DEV_TRACE_HOT(trace);
+ bt_uuid_copy(trace->uuid.uuid, uuid);
+ trace->uuid.value = trace->uuid.uuid;
+ BT_LIB_LOGD("Set trace's UUID: %!+t", trace);
+}
+
+static
+bool trace_has_environment_entry(const struct bt_trace *trace, const char *name)
+{
+ BT_ASSERT(trace);
+
+ return bt_attributes_borrow_field_value_by_name(
+ trace->environment, name);
+}
+
+static
+enum bt_trace_set_environment_entry_status set_environment_entry(
+ struct bt_trace *trace,
+ const char *name, struct bt_value *value)
+{
+ int ret;
+
+ BT_ASSERT(trace);
+ BT_ASSERT(name);
+ BT_ASSERT(value);
+ BT_ASSERT_PRE(!trace->frozen ||
+ !trace_has_environment_entry(trace, name),
+ "Trace is frozen: cannot replace environment entry: "
+ "%![trace-]+t, entry-name=\"%s\"", trace, name);
+ ret = bt_attributes_set_field_value(trace->environment, name,
+ value);
+ if (ret) {
+ ret = BT_FUNC_STATUS_MEMORY_ERROR;
+ BT_LIB_LOGE_APPEND_CAUSE(
+ "Cannot set trace's environment entry: "
+ "%![trace-]+t, entry-name=\"%s\"", trace, name);
+ } else {
+ bt_value_freeze(value);
+ BT_LIB_LOGD("Set trace's environment entry: "
+ "%![trace-]+t, entry-name=\"%s\"", trace, name);
+ }
+
+ return ret;
+}
+
+enum bt_trace_set_environment_entry_status
+bt_trace_set_environment_entry_string(
+ struct bt_trace *trace, const char *name, const char *value)
+{
+ int ret;
+ struct bt_value *value_obj;
+
+ BT_ASSERT_PRE_NO_ERROR();
+ BT_ASSERT_PRE_NON_NULL(trace, "Trace");
+ BT_ASSERT_PRE_NON_NULL(name, "Name");
+ BT_ASSERT_PRE_NON_NULL(value, "Value");
+
+ value_obj = bt_value_string_create_init(value);
+ if (!value_obj) {
+ BT_LIB_LOGE_APPEND_CAUSE(
+ "Cannot create a string value object.");
+ ret = -1;
+ goto end;
+ }
+
+ /* set_environment_entry() logs errors */
+ ret = set_environment_entry(trace, name, value_obj);
+
+end:
+ bt_object_put_ref(value_obj);
+ return ret;
+}
+
+enum bt_trace_set_environment_entry_status
+bt_trace_set_environment_entry_integer(
+ struct bt_trace *trace, const char *name, int64_t value)