2 * SPDX-License-Identifier: MIT
4 * Copyright 2015-2017 Philippe Proulx <pproulx@efficios.com>
5 * Copyright 2016 Jérémie Galarneau <jeremie.galarneau@efficios.com>
7 * Babeltrace CTF file system Reader Component
14 #include <babeltrace2/babeltrace.h>
16 #include "common/assert.h"
17 #include "common/common.h"
18 #include "common/uuid.h"
19 #include "cpp-common/bt2c/glib-up.hpp"
20 #include "cpp-common/bt2s/make-unique.hpp"
22 #include "plugins/common/param-validation/param-validation.h"
24 #include "../common/src/metadata/tsdl/ctf-meta-configure-ir-trace.hpp"
25 #include "../common/src/msg-iter/msg-iter.hpp"
26 #include "data-stream-file.hpp"
29 #include "metadata.hpp"
40 static bt_message_iterator_class_next_method_status
41 ctf_fs_iterator_next_one(struct ctf_fs_msg_iter_data
*msg_iter_data
, const bt_message
**out_msg
)
43 const auto msg_iter_status
=
44 ctf_msg_iter_get_next_message(msg_iter_data
->msg_iter
.get(), out_msg
);
45 bt_message_iterator_class_next_method_status status
;
47 switch (msg_iter_status
) {
48 case CTF_MSG_ITER_STATUS_OK
:
49 /* Cool, message has been written to *out_msg. */
50 status
= BT_MESSAGE_ITERATOR_CLASS_NEXT_METHOD_STATUS_OK
;
53 case CTF_MSG_ITER_STATUS_EOF
:
54 status
= BT_MESSAGE_ITERATOR_CLASS_NEXT_METHOD_STATUS_END
;
57 case CTF_MSG_ITER_STATUS_AGAIN
:
59 * Should not make it this far as this is
60 * medium-specific; there is nothing for the user to do
61 * and it should have been handled upstream.
65 case CTF_MSG_ITER_STATUS_ERROR
:
66 BT_CPPLOGE_APPEND_CAUSE_SPEC(msg_iter_data
->logger
,
67 "Failed to get next message from CTF message iterator.");
68 status
= BT_MESSAGE_ITERATOR_CLASS_NEXT_METHOD_STATUS_ERROR
;
71 case CTF_MSG_ITER_STATUS_MEMORY_ERROR
:
72 BT_CPPLOGE_APPEND_CAUSE_SPEC(msg_iter_data
->logger
,
73 "Failed to get next message from CTF message iterator.");
74 status
= BT_MESSAGE_ITERATOR_CLASS_NEXT_METHOD_STATUS_MEMORY_ERROR
;
84 bt_message_iterator_class_next_method_status
85 ctf_fs_iterator_next(bt_self_message_iterator
*iterator
, bt_message_array_const msgs
,
86 uint64_t capacity
, uint64_t *count
)
89 struct ctf_fs_msg_iter_data
*msg_iter_data
=
90 (struct ctf_fs_msg_iter_data
*) bt_self_message_iterator_get_data(iterator
);
92 if (G_UNLIKELY(msg_iter_data
->next_saved_error
)) {
94 * Last time we were called, we hit an error but had some
95 * messages to deliver, so we stashed the error here. Return
98 BT_CURRENT_THREAD_MOVE_ERROR_AND_RESET(msg_iter_data
->next_saved_error
);
99 return msg_iter_data
->next_saved_status
;
102 bt_message_iterator_class_next_method_status status
;
106 status
= ctf_fs_iterator_next_one(msg_iter_data
, &msgs
[i
]);
107 if (status
== BT_MESSAGE_ITERATOR_CLASS_NEXT_METHOD_STATUS_OK
) {
110 } while (i
< capacity
&& status
== BT_MESSAGE_ITERATOR_CLASS_NEXT_METHOD_STATUS_OK
);
114 * Even if ctf_fs_iterator_next_one() returned something
115 * else than BT_MESSAGE_ITERATOR_NEXT_METHOD_STATUS_OK, we
116 * accumulated message objects in the output
117 * message array, so we need to return
118 * BT_MESSAGE_ITERATOR_NEXT_METHOD_STATUS_OK so that they are
119 * transferred to downstream. This other status occurs
120 * again the next time muxer_msg_iter_do_next() is
121 * called, possibly without any accumulated
122 * message, in which case we'll return it.
126 * Save this error for the next _next call. Assume that
127 * this component always appends error causes when
128 * returning an error status code, which will cause the
129 * current thread error to be non-NULL.
131 msg_iter_data
->next_saved_error
= bt_current_thread_take_error();
132 BT_ASSERT(msg_iter_data
->next_saved_error
);
133 msg_iter_data
->next_saved_status
= status
;
137 status
= BT_MESSAGE_ITERATOR_CLASS_NEXT_METHOD_STATUS_OK
;
142 } catch (const std::bad_alloc
&) {
143 return BT_MESSAGE_ITERATOR_CLASS_NEXT_METHOD_STATUS_MEMORY_ERROR
;
144 } catch (const bt2::Error
&) {
145 return BT_MESSAGE_ITERATOR_CLASS_NEXT_METHOD_STATUS_ERROR
;
149 bt_message_iterator_class_seek_beginning_method_status
150 ctf_fs_iterator_seek_beginning(bt_self_message_iterator
*it
)
153 struct ctf_fs_msg_iter_data
*msg_iter_data
=
154 (struct ctf_fs_msg_iter_data
*) bt_self_message_iterator_get_data(it
);
156 BT_ASSERT(msg_iter_data
);
158 ctf_msg_iter_reset(msg_iter_data
->msg_iter
.get());
159 ctf_fs_ds_group_medops_data_reset(msg_iter_data
->msg_iter_medops_data
.get());
161 return BT_MESSAGE_ITERATOR_CLASS_SEEK_BEGINNING_METHOD_STATUS_OK
;
162 } catch (const std::bad_alloc
&) {
163 return BT_MESSAGE_ITERATOR_CLASS_SEEK_BEGINNING_METHOD_STATUS_MEMORY_ERROR
;
164 } catch (const bt2::Error
&) {
165 return BT_MESSAGE_ITERATOR_CLASS_SEEK_BEGINNING_METHOD_STATUS_ERROR
;
169 void ctf_fs_iterator_finalize(bt_self_message_iterator
*it
)
171 ctf_fs_msg_iter_data::UP
{
172 (static_cast<ctf_fs_msg_iter_data
*>(bt_self_message_iterator_get_data(it
)))};
175 static bt_message_iterator_class_initialize_method_status
176 ctf_msg_iter_medium_status_to_msg_iter_initialize_status(enum ctf_msg_iter_medium_status status
)
179 case CTF_MSG_ITER_MEDIUM_STATUS_EOF
:
180 case CTF_MSG_ITER_MEDIUM_STATUS_AGAIN
:
181 case CTF_MSG_ITER_MEDIUM_STATUS_ERROR
:
182 return BT_MESSAGE_ITERATOR_CLASS_INITIALIZE_METHOD_STATUS_ERROR
;
183 case CTF_MSG_ITER_MEDIUM_STATUS_MEMORY_ERROR
:
184 return BT_MESSAGE_ITERATOR_CLASS_INITIALIZE_METHOD_STATUS_MEMORY_ERROR
;
185 case CTF_MSG_ITER_MEDIUM_STATUS_OK
:
186 return BT_MESSAGE_ITERATOR_CLASS_INITIALIZE_METHOD_STATUS_OK
;
192 bt_message_iterator_class_initialize_method_status
193 ctf_fs_iterator_init(bt_self_message_iterator
*self_msg_iter
,
194 bt_self_message_iterator_configuration
*config
,
195 bt_self_component_port_output
*self_port
)
198 ctf_fs_port_data
*port_data
= (struct ctf_fs_port_data
*) bt_self_component_port_get_data(
199 bt_self_component_port_output_as_self_component_port(self_port
));
200 BT_ASSERT(port_data
);
202 auto msg_iter_data
= bt2s::make_unique
<ctf_fs_msg_iter_data
>(self_msg_iter
);
203 msg_iter_data
->ds_file_group
= port_data
->ds_file_group
;
205 ctf_msg_iter_medium_status medium_status
= ctf_fs_ds_group_medops_data_create(
206 msg_iter_data
->ds_file_group
, self_msg_iter
, msg_iter_data
->logger
,
207 msg_iter_data
->msg_iter_medops_data
);
208 BT_ASSERT(medium_status
== CTF_MSG_ITER_MEDIUM_STATUS_OK
||
209 medium_status
== CTF_MSG_ITER_MEDIUM_STATUS_ERROR
||
210 medium_status
== CTF_MSG_ITER_MEDIUM_STATUS_MEMORY_ERROR
);
211 if (medium_status
!= CTF_MSG_ITER_MEDIUM_STATUS_OK
) {
212 BT_CPPLOGE_APPEND_CAUSE_SPEC(msg_iter_data
->logger
,
213 "Failed to create ctf_fs_ds_group_medops");
214 return ctf_msg_iter_medium_status_to_msg_iter_initialize_status(medium_status
);
217 msg_iter_data
->msg_iter
= ctf_msg_iter_create(
218 msg_iter_data
->ds_file_group
->ctf_fs_trace
->metadata
->tc
,
219 bt_common_get_page_size(static_cast<int>(msg_iter_data
->logger
.level())) * 8,
220 ctf_fs_ds_group_medops
, msg_iter_data
->msg_iter_medops_data
.get(), self_msg_iter
,
221 msg_iter_data
->logger
);
222 if (!msg_iter_data
->msg_iter
) {
223 BT_CPPLOGE_APPEND_CAUSE_SPEC(msg_iter_data
->logger
,
224 "Cannot create a CTF message iterator.");
225 return BT_MESSAGE_ITERATOR_CLASS_INITIALIZE_METHOD_STATUS_MEMORY_ERROR
;
229 * This iterator can seek forward if its stream class has a default
232 if (msg_iter_data
->ds_file_group
->sc
->default_clock_class
) {
233 bt_self_message_iterator_configuration_set_can_seek_forward(config
, true);
236 bt_self_message_iterator_set_data(self_msg_iter
, msg_iter_data
.release());
238 return BT_MESSAGE_ITERATOR_CLASS_INITIALIZE_METHOD_STATUS_OK
;
239 } catch (const std::bad_alloc
&) {
240 return BT_MESSAGE_ITERATOR_CLASS_INITIALIZE_METHOD_STATUS_MEMORY_ERROR
;
241 } catch (const bt2::Error
&) {
242 return BT_MESSAGE_ITERATOR_CLASS_INITIALIZE_METHOD_STATUS_ERROR
;
246 void ctf_fs_finalize(bt_self_component_source
*component
)
248 ctf_fs_component::UP
{static_cast<ctf_fs_component
*>(
249 bt_self_component_get_data(bt_self_component_source_as_self_component(component
)))};
252 std::string
ctf_fs_make_port_name(ctf_fs_ds_file_group
*ds_file_group
)
254 std::stringstream name
;
257 * The unique port name is generated by concatenating unique identifiers
265 /* For the trace, use the uuid if present, else the path. */
266 if (ds_file_group
->ctf_fs_trace
->metadata
->tc
->is_uuid_set
) {
267 char uuid_str
[BT_UUID_STR_LEN
+ 1];
269 bt_uuid_to_str(ds_file_group
->ctf_fs_trace
->metadata
->tc
->uuid
, uuid_str
);
272 name
<< ds_file_group
->ctf_fs_trace
->path
;
276 * For the stream class, use the id if present. We can omit this field
277 * otherwise, as there will only be a single stream class.
279 if (ds_file_group
->sc
->id
!= UINT64_C(-1)) {
280 name
<< " | " << ds_file_group
->sc
->id
;
283 /* For the stream, use the id if present, else, use the path. */
284 if (ds_file_group
->stream_id
!= UINT64_C(-1)) {
285 name
<< " | " << ds_file_group
->stream_id
;
287 BT_ASSERT(ds_file_group
->ds_file_infos
.size() == 1);
288 const auto& ds_file_info
= *ds_file_group
->ds_file_infos
[0];
289 name
<< " | " << ds_file_info
.path
;
295 static int create_one_port_for_trace(struct ctf_fs_component
*ctf_fs
,
296 struct ctf_fs_ds_file_group
*ds_file_group
,
297 bt_self_component_source
*self_comp_src
)
299 const auto port_name
= ctf_fs_make_port_name(ds_file_group
);
300 auto port_data
= bt2s::make_unique
<ctf_fs_port_data
>();
302 BT_CPPLOGI_SPEC(ctf_fs
->logger
, "Creating one port named `{}`", port_name
);
304 port_data
->ctf_fs
= ctf_fs
;
305 port_data
->ds_file_group
= ds_file_group
;
307 int ret
= bt_self_component_source_add_output_port(self_comp_src
, port_name
.c_str(),
308 port_data
.get(), NULL
);
313 ctf_fs
->port_data
.emplace_back(std::move(port_data
));
317 static int create_ports_for_trace(struct ctf_fs_component
*ctf_fs
,
318 struct ctf_fs_trace
*ctf_fs_trace
,
319 bt_self_component_source
*self_comp_src
)
321 /* Create one output port for each stream file group */
322 for (const auto& ds_file_group
: ctf_fs_trace
->ds_file_groups
) {
323 int ret
= create_one_port_for_trace(ctf_fs
, ds_file_group
.get(), self_comp_src
);
325 BT_CPPLOGE_APPEND_CAUSE_SPEC(ctf_fs
->logger
, "Cannot create output port.");
333 static bool ds_index_entries_equal(const ctf_fs_ds_index_entry
& left
,
334 const ctf_fs_ds_index_entry
& right
)
336 if (left
.packetSize
!= right
.packetSize
) {
340 if (left
.timestamp_begin
!= right
.timestamp_begin
) {
344 if (left
.timestamp_end
!= right
.timestamp_end
) {
348 if (left
.packet_seq_num
!= right
.packet_seq_num
) {
356 * Insert `entry` into `index`, without duplication.
358 * The entry is inserted only if there isn't an identical entry already.
361 static void ds_index_insert_ds_index_entry_sorted(ctf_fs_ds_index
& index
,
362 const ctf_fs_ds_index_entry
& entry
)
364 /* Find the spot where to insert this index entry. */
365 auto otherEntry
= index
.entries
.begin();
366 for (; otherEntry
!= index
.entries
.end(); ++otherEntry
) {
367 if (entry
.timestamp_begin_ns
<= otherEntry
->timestamp_begin_ns
) {
373 * Insert the entry only if a duplicate doesn't already exist.
375 * There can be duplicate packets if reading multiple overlapping
376 * snapshots of the same trace. We then want the index to contain
377 * a reference to only one copy of that packet.
379 if (otherEntry
== index
.entries
.end() || !ds_index_entries_equal(entry
, *otherEntry
)) {
380 index
.entries
.emplace(otherEntry
, entry
);
384 static void merge_ctf_fs_ds_indexes(ctf_fs_ds_index
& dest
, const ctf_fs_ds_index
& src
)
386 for (const auto& entry
: src
.entries
) {
387 ds_index_insert_ds_index_entry_sorted(dest
, entry
);
391 static int add_ds_file_to_ds_file_group(struct ctf_fs_trace
*ctf_fs_trace
, const char *path
)
394 * Create a temporary ds_file to read some properties about the data
398 ctf_fs_ds_file_create(ctf_fs_trace
, bt2::Stream::Shared
{}, path
, ctf_fs_trace
->logger
);
403 /* Create a temporary iterator to read the ds_file. */
404 ctf_msg_iter_up msg_iter
= ctf_msg_iter_create(
405 ctf_fs_trace
->metadata
->tc
,
406 bt_common_get_page_size(static_cast<int>(ctf_fs_trace
->logger
.level())) * 8,
407 ctf_fs_ds_file_medops
, ds_file
.get(), nullptr, ctf_fs_trace
->logger
);
409 BT_CPPLOGE_STR_SPEC(ctf_fs_trace
->logger
, "Cannot create a CTF message iterator.");
413 ctf_msg_iter_set_dry_run(msg_iter
.get(), true);
415 ctf_msg_iter_packet_properties props
;
416 int ret
= ctf_msg_iter_get_packet_properties(msg_iter
.get(), &props
);
418 BT_CPPLOGE_APPEND_CAUSE_SPEC(
419 ctf_fs_trace
->logger
,
420 "Cannot get stream file's first packet's header and context fields (`{}`).", path
);
424 ctf_stream_class
*sc
=
425 ctf_trace_class_borrow_stream_class_by_id(ds_file
->metadata
->tc
, props
.stream_class_id
);
427 int64_t stream_instance_id
= props
.data_stream_id
;
428 int64_t begin_ns
= -1;
430 if (props
.snapshots
.beginning_clock
!= UINT64_C(-1)) {
431 BT_ASSERT(sc
->default_clock_class
);
432 ret
= bt_util_clock_cycles_to_ns_from_origin(
433 props
.snapshots
.beginning_clock
, sc
->default_clock_class
->frequency
,
434 sc
->default_clock_class
->offset_seconds
, sc
->default_clock_class
->offset_cycles
,
437 BT_CPPLOGE_APPEND_CAUSE_SPEC(
438 ctf_fs_trace
->logger
,
439 "Cannot convert clock cycles to nanoseconds from origin (`{}`).", path
);
444 ctf_fs_ds_file_info::UP ds_file_info
= ctf_fs_ds_file_info_create(path
, begin_ns
);
449 auto index
= ctf_fs_ds_file_build_index(ds_file
.get(), ds_file_info
.get(), msg_iter
.get());
451 BT_CPPLOGE_APPEND_CAUSE_SPEC(ctf_fs_trace
->logger
, "Failed to index CTF stream file \'{}\'",
452 ds_file
->file
->path
);
456 if (begin_ns
== -1) {
458 * No beginning timestamp to sort the stream files
459 * within a stream file group, so consider that this
460 * file must be the only one within its group.
462 stream_instance_id
= -1;
465 if (stream_instance_id
== -1) {
467 * No stream instance ID or no beginning timestamp:
468 * create a unique stream file group for this stream
469 * file because, even if there's a stream instance ID,
470 * there's no timestamp to order the file within its
473 ctf_fs_trace
->ds_file_groups
.emplace_back(bt2s::make_unique
<ctf_fs_ds_file_group
>(
474 ctf_fs_trace
, sc
, UINT64_C(-1), std::move(*index
)));
475 ctf_fs_trace
->ds_file_groups
.back()->insert_ds_file_info_sorted(std::move(ds_file_info
));
479 BT_ASSERT(stream_instance_id
!= -1);
480 BT_ASSERT(begin_ns
!= -1);
482 /* Find an existing stream file group with this ID */
483 ctf_fs_ds_file_group
*ds_file_group
= NULL
;
484 for (const auto& candidate
: ctf_fs_trace
->ds_file_groups
) {
485 if (candidate
->sc
== sc
&& candidate
->stream_id
== stream_instance_id
) {
486 ds_file_group
= candidate
.get();
491 if (!ds_file_group
) {
492 ctf_fs_trace
->ds_file_groups
.emplace_back(bt2s::make_unique
<ctf_fs_ds_file_group
>(
493 ctf_fs_trace
, sc
, static_cast<std::uint64_t>(stream_instance_id
), std::move(*index
)));
494 ds_file_group
= ctf_fs_trace
->ds_file_groups
.back().get();
496 merge_ctf_fs_ds_indexes(ds_file_group
->index
, *index
);
499 ds_file_group
->insert_ds_file_info_sorted(std::move(ds_file_info
));
504 static int create_ds_file_groups(struct ctf_fs_trace
*ctf_fs_trace
)
506 /* Check each file in the path directory, except specific ones */
507 GError
*error
= NULL
;
508 const bt2c::GDirUP dir
{g_dir_open(ctf_fs_trace
->path
.c_str(), 0, &error
)};
510 BT_CPPLOGE_APPEND_CAUSE_SPEC(ctf_fs_trace
->logger
,
511 "Cannot open directory `{}`: {} (code {})", ctf_fs_trace
->path
,
512 error
->message
, error
->code
);
519 while (const char *basename
= g_dir_read_name(dir
.get())) {
520 if (strcmp(basename
, CTF_FS_METADATA_FILENAME
) == 0) {
521 /* Ignore the metadata stream. */
522 BT_CPPLOGI_SPEC(ctf_fs_trace
->logger
,
523 "Ignoring metadata file `{}" G_DIR_SEPARATOR_S
"{}`",
524 ctf_fs_trace
->path
, basename
);
528 if (basename
[0] == '.') {
529 BT_CPPLOGI_SPEC(ctf_fs_trace
->logger
,
530 "Ignoring hidden file `{}" G_DIR_SEPARATOR_S
"{}`", ctf_fs_trace
->path
,
535 /* Create the file. */
536 ctf_fs_file file
{ctf_fs_trace
->logger
};
538 /* Create full path string. */
539 file
.path
= fmt::format("{}" G_DIR_SEPARATOR_S
"{}", ctf_fs_trace
->path
, basename
);
541 if (!g_file_test(file
.path
.c_str(), G_FILE_TEST_IS_REGULAR
)) {
542 BT_CPPLOGI_SPEC(ctf_fs_trace
->logger
, "Ignoring non-regular file `{}`", file
.path
);
546 int ret
= ctf_fs_file_open(&file
, "rb");
548 BT_CPPLOGE_APPEND_CAUSE_SPEC(ctf_fs_trace
->logger
, "Cannot open stream file `{}`",
553 if (file
.size
== 0) {
554 /* Skip empty stream. */
555 BT_CPPLOGI_SPEC(ctf_fs_trace
->logger
, "Ignoring empty file `{}`", file
.path
);
559 ret
= add_ds_file_to_ds_file_group(ctf_fs_trace
, file
.path
.c_str());
561 BT_CPPLOGE_APPEND_CAUSE_SPEC(ctf_fs_trace
->logger
,
562 "Cannot add stream file `{}` to stream file group",
571 static void set_trace_name(const bt2::Trace trace
, const char *name_suffix
)
576 * Check if we have a trace environment string value named `hostname`.
577 * If so, use it as the trace name's prefix.
579 const auto val
= trace
.environmentEntry("hostname");
580 if (val
&& val
->isString()) {
581 name
+= val
->asString().value();
584 name
+= G_DIR_SEPARATOR
;
595 static ctf_fs_trace::UP
ctf_fs_trace_create(const char *path
, const char *name
,
596 const ctf::src::ClkClsCfg
& clkClsCfg
,
597 bt_self_component
*selfComp
,
598 const bt2c::Logger
& parentLogger
)
600 ctf_fs_trace::UP ctf_fs_trace
= bt2s::make_unique
<struct ctf_fs_trace
>(parentLogger
);
601 ctf_fs_trace
->path
= path
;
602 ctf_fs_trace
->metadata
= bt2s::make_unique
<ctf_fs_metadata
>();
604 int ret
= ctf_fs_metadata_set_trace_class(selfComp
, ctf_fs_trace
.get(), clkClsCfg
);
609 if (ctf_fs_trace
->metadata
->trace_class
) {
610 bt_trace
*trace
= bt_trace_create(ctf_fs_trace
->metadata
->trace_class
->libObjPtr());
615 ctf_fs_trace
->trace
= bt2::Trace::Shared::createWithoutRef(trace
);
618 if (ctf_fs_trace
->trace
) {
619 ctf_trace_class_configure_ir_trace(ctf_fs_trace
->metadata
->tc
, *ctf_fs_trace
->trace
);
621 set_trace_name(*ctf_fs_trace
->trace
, name
);
624 ret
= create_ds_file_groups(ctf_fs_trace
.get());
632 static int path_is_ctf_trace(const char *path
)
634 return g_file_test(fmt::format("{}" G_DIR_SEPARATOR_S CTF_FS_METADATA_FILENAME
, path
).c_str(),
635 G_FILE_TEST_IS_REGULAR
);
638 /* Helper for ctf_fs_component_create_ctf_fs_trace, to handle a single path. */
640 static int ctf_fs_component_create_ctf_fs_trace_one_path(struct ctf_fs_component
*ctf_fs
,
641 const char *path_param
,
642 const char *trace_name
,
643 std::vector
<ctf_fs_trace::UP
>& traces
,
644 bt_self_component
*selfComp
)
646 bt2c::GStringUP norm_path
{bt_common_normalize_path(path_param
, NULL
)};
648 BT_CPPLOGE_APPEND_CAUSE_SPEC(ctf_fs
->logger
, "Failed to normalize path: `{}`.", path_param
);
652 int ret
= path_is_ctf_trace(norm_path
->str
);
654 BT_CPPLOGE_APPEND_CAUSE_SPEC(
655 ctf_fs
->logger
, "Failed to check if path is a CTF trace: path={}", norm_path
->str
);
657 } else if (ret
== 0) {
658 BT_CPPLOGE_APPEND_CAUSE_SPEC(
659 ctf_fs
->logger
, "Path is not a CTF trace (does not contain a metadata file): `{}`.",
664 // FIXME: Remove or ifdef for __MINGW32__
665 if (strcmp(norm_path
->str
, "/") == 0) {
666 BT_CPPLOGE_APPEND_CAUSE_SPEC(ctf_fs
->logger
, "Opening a trace in `/` is not supported.");
670 ctf_fs_trace::UP ctf_fs_trace
= ctf_fs_trace_create(
671 norm_path
->str
, trace_name
, ctf_fs
->clkClsCfg
, selfComp
, ctf_fs
->logger
);
673 BT_CPPLOGE_APPEND_CAUSE_SPEC(ctf_fs
->logger
, "Cannot create trace for `{}`.",
678 traces
.emplace_back(std::move(ctf_fs_trace
));
684 * Count the number of stream and event classes defined by this trace's metadata.
686 * This is used to determine which metadata is the "latest", out of multiple
687 * traces sharing the same UUID. It is assumed that amongst all these metadatas,
688 * a bigger metadata is a superset of a smaller metadata. Therefore, it is
689 * enough to just count the classes.
692 static unsigned int metadata_count_stream_and_event_classes(struct ctf_fs_trace
*trace
)
694 unsigned int num
= trace
->metadata
->tc
->stream_classes
->len
;
696 for (guint i
= 0; i
< trace
->metadata
->tc
->stream_classes
->len
; i
++) {
697 struct ctf_stream_class
*sc
=
698 (struct ctf_stream_class
*) trace
->metadata
->tc
->stream_classes
->pdata
[i
];
699 num
+= sc
->event_classes
->len
;
706 * Merge the src ds_file_group into dest. This consists of merging their
707 * ds_file_infos, making sure to keep the result sorted.
710 static void merge_ctf_fs_ds_file_groups(struct ctf_fs_ds_file_group
*dest
,
711 ctf_fs_ds_file_group::UP src
)
713 for (auto& ds_file_info
: src
->ds_file_infos
) {
714 dest
->insert_ds_file_info_sorted(std::move(ds_file_info
));
717 /* Merge both indexes. */
718 merge_ctf_fs_ds_indexes(dest
->index
, src
->index
);
721 /* Merge src_trace's data stream file groups into dest_trace's. */
723 static int merge_matching_ctf_fs_ds_file_groups(struct ctf_fs_trace
*dest_trace
,
724 ctf_fs_trace::UP src_trace
)
726 std::vector
<ctf_fs_ds_file_group::UP
>& dest
= dest_trace
->ds_file_groups
;
727 std::vector
<ctf_fs_ds_file_group::UP
>& src
= src_trace
->ds_file_groups
;
730 * Save the initial length of dest: we only want to check against the
731 * original elements in the inner loop.
733 size_t dest_len
= dest
.size();
735 for (auto& src_group
: src
) {
736 struct ctf_fs_ds_file_group
*dest_group
= NULL
;
738 /* A stream instance without ID can't match a stream in the other trace. */
739 if (src_group
->stream_id
!= -1) {
740 /* Let's search for a matching ds_file_group in the destination. */
741 for (size_t d_i
= 0; d_i
< dest_len
; ++d_i
) {
742 ctf_fs_ds_file_group
*candidate_dest
= dest
[d_i
].get();
744 /* Can't match a stream instance without ID. */
745 if (candidate_dest
->stream_id
== -1) {
750 * If the two groups have the same stream instance id
751 * and belong to the same stream class (stream instance
752 * ids are per-stream class), they represent the same
755 if (candidate_dest
->stream_id
!= src_group
->stream_id
||
756 candidate_dest
->sc
->id
!= src_group
->sc
->id
) {
760 dest_group
= candidate_dest
;
766 * Didn't find a friend in dest to merge our src_group into?
767 * Create a new empty one. This can happen if a stream was
768 * active in the source trace chunk but not in the destination
772 ctf_stream_class
*sc
= ctf_trace_class_borrow_stream_class_by_id(
773 dest_trace
->metadata
->tc
, src_group
->sc
->id
);
776 dest_trace
->ds_file_groups
.emplace_back(bt2s::make_unique
<ctf_fs_ds_file_group
>(
777 dest_trace
, sc
, src_group
->stream_id
, ctf_fs_ds_index
{}));
778 dest_group
= dest_trace
->ds_file_groups
.back().get();
781 BT_ASSERT(dest_group
);
782 merge_ctf_fs_ds_file_groups(dest_group
, std::move(src_group
));
789 * Collapse the given traces, which must all share the same UUID, in a single
792 * The trace with the most expansive metadata is chosen and all other traces
793 * are merged into that one. On return, the elements of `traces` are nullptr
794 * and the merged trace is placed in `out_trace`.
797 static int merge_ctf_fs_traces(std::vector
<ctf_fs_trace::UP
> traces
, ctf_fs_trace::UP
& out_trace
)
799 BT_ASSERT(traces
.size() >= 2);
801 unsigned int winner_count
= metadata_count_stream_and_event_classes(traces
[0].get());
802 ctf_fs_trace
*winner
= traces
[0].get();
805 /* Find the trace with the largest metadata. */
806 for (guint i
= 1; i
< traces
.size(); i
++) {
807 ctf_fs_trace
*candidate
= traces
[i
].get();
808 unsigned int candidate_count
;
810 /* A bit of sanity check. */
811 BT_ASSERT(bt_uuid_compare(winner
->metadata
->tc
->uuid
, candidate
->metadata
->tc
->uuid
) == 0);
813 candidate_count
= metadata_count_stream_and_event_classes(candidate
);
815 if (candidate_count
> winner_count
) {
816 winner_count
= candidate_count
;
822 /* Merge all the other traces in the winning trace. */
823 for (ctf_fs_trace::UP
& trace
: traces
) {
824 /* Don't merge the winner into itself. */
825 if (trace
.get() == winner
) {
829 /* Merge trace's data stream file groups into winner's. */
830 int ret
= merge_matching_ctf_fs_ds_file_groups(winner
, std::move(trace
));
837 * Move the winner out of the array, into `*out_trace`.
839 out_trace
= std::move(traces
[winner_i
]);
850 static int decode_clock_snapshot_after_event(struct ctf_fs_trace
*ctf_fs_trace
,
851 struct ctf_clock_class
*default_cc
,
852 const ctf_fs_ds_index_entry
& index_entry
,
853 enum target_event target_event
, uint64_t *cs
,
856 BT_ASSERT(ctf_fs_trace
);
857 BT_ASSERT(index_entry
.path
);
859 const auto ds_file
= ctf_fs_ds_file_create(ctf_fs_trace
, bt2::Stream::Shared
{},
860 index_entry
.path
, ctf_fs_trace
->logger
);
862 BT_CPPLOGE_APPEND_CAUSE_SPEC(ctf_fs_trace
->logger
, "Failed to create a ctf_fs_ds_file");
866 BT_ASSERT(ctf_fs_trace
->metadata
);
867 BT_ASSERT(ctf_fs_trace
->metadata
->tc
);
869 ctf_msg_iter_up msg_iter
= ctf_msg_iter_create(
870 ctf_fs_trace
->metadata
->tc
,
871 bt_common_get_page_size(static_cast<int>(ctf_fs_trace
->logger
.level())) * 8,
873 ctf_fs_ds_file_medops
, ds_file
.get(), NULL
, ctf_fs_trace
->logger
);
875 /* ctf_msg_iter_create() logs errors. */
880 * Turn on dry run mode to prevent the creation and usage of Babeltrace
881 * library objects (bt_field, bt_message_*, etc.).
883 ctf_msg_iter_set_dry_run(msg_iter
.get(), true);
885 /* Seek to the beginning of the target packet. */
886 enum ctf_msg_iter_status iter_status
=
887 ctf_msg_iter_seek(msg_iter
.get(), index_entry
.offset
.bytes());
889 /* ctf_msg_iter_seek() logs errors. */
893 switch (target_event
) {
896 * Start to decode the packet until we reach the end of
897 * the first event. To extract the first event's clock
900 iter_status
= ctf_msg_iter_curr_packet_first_event_clock_snapshot(msg_iter
.get(), cs
);
903 /* Decode the packet to extract the last event's clock snapshot. */
904 iter_status
= ctf_msg_iter_curr_packet_last_event_clock_snapshot(msg_iter
.get(), cs
);
913 /* Convert clock snapshot to timestamp. */
914 int ret
= bt_util_clock_cycles_to_ns_from_origin(
915 *cs
, default_cc
->frequency
, default_cc
->offset_seconds
, default_cc
->offset_cycles
, ts_ns
);
917 BT_CPPLOGE_APPEND_CAUSE_SPEC(ctf_fs_trace
->logger
,
918 "Failed to convert clock snapshot to timestamp");
925 static int decode_packet_first_event_timestamp(struct ctf_fs_trace
*ctf_fs_trace
,
926 struct ctf_clock_class
*default_cc
,
927 const ctf_fs_ds_index_entry
& index_entry
,
928 uint64_t *cs
, int64_t *ts_ns
)
930 return decode_clock_snapshot_after_event(ctf_fs_trace
, default_cc
, index_entry
, FIRST_EVENT
, cs
,
934 static int decode_packet_last_event_timestamp(struct ctf_fs_trace
*ctf_fs_trace
,
935 struct ctf_clock_class
*default_cc
,
936 const ctf_fs_ds_index_entry
& index_entry
,
937 uint64_t *cs
, int64_t *ts_ns
)
939 return decode_clock_snapshot_after_event(ctf_fs_trace
, default_cc
, index_entry
, LAST_EVENT
, cs
,
944 * Fix up packet index entries for lttng's "event-after-packet" bug.
945 * Some buggy lttng tracer versions may emit events with a timestamp that is
946 * larger (after) than the timestamp_end of the their packets.
948 * To fix up this erroneous data we do the following:
949 * 1. If it's not the stream file's last packet: set the packet index entry's
950 * end time to the next packet's beginning time.
951 * 2. If it's the stream file's last packet, set the packet index entry's end
952 * time to the packet's last event's time, if any, or to the packet's
953 * beginning time otherwise.
955 * Known buggy tracer versions:
956 * - before lttng-ust 2.11.0
957 * - before lttng-module 2.11.0
958 * - before lttng-module 2.10.10
959 * - before lttng-module 2.9.13
961 static int fix_index_lttng_event_after_packet_bug(struct ctf_fs_trace
*trace
)
963 for (const auto& ds_file_group
: trace
->ds_file_groups
) {
964 BT_ASSERT(ds_file_group
);
965 auto& index
= ds_file_group
->index
;
967 BT_ASSERT(!index
.entries
.empty());
970 * Iterate over all entries but the last one. The last one is
971 * fixed differently after.
973 for (size_t entry_i
= 0; entry_i
< index
.entries
.size() - 1; ++entry_i
) {
974 auto& curr_entry
= index
.entries
[entry_i
];
975 const auto& next_entry
= index
.entries
[entry_i
+ 1];
978 * 1. Set the current index entry `end` timestamp to
979 * the next index entry `begin` timestamp.
981 curr_entry
.timestamp_end
= next_entry
.timestamp_begin
;
982 curr_entry
.timestamp_end_ns
= next_entry
.timestamp_begin_ns
;
986 * 2. Fix the last entry by decoding the last event of the last
989 auto& last_entry
= index
.entries
.back();
991 BT_ASSERT(ds_file_group
->sc
->default_clock_class
);
992 ctf_clock_class
*default_cc
= ds_file_group
->sc
->default_clock_class
;
995 * Decode packet to read the timestamp of the last event of the
998 int ret
= decode_packet_last_event_timestamp(
999 trace
, default_cc
, last_entry
, &last_entry
.timestamp_end
, &last_entry
.timestamp_end_ns
);
1001 BT_CPPLOGE_APPEND_CAUSE_SPEC(
1003 "Failed to decode stream's last packet to get its last event's clock snapshot.");
1012 * Fix up packet index entries for barectf's "event-before-packet" bug.
1013 * Some buggy barectf tracer versions may emit events with a timestamp that is
1014 * less than the timestamp_begin of the their packets.
1016 * To fix up this erroneous data we do the following:
1017 * 1. Starting at the second index entry, set the timestamp_begin of the
1018 * current entry to the timestamp of the first event of the packet.
1019 * 2. Set the previous entry's timestamp_end to the timestamp_begin of the
1022 * Known buggy tracer versions:
1023 * - before barectf 2.3.1
1025 static int fix_index_barectf_event_before_packet_bug(struct ctf_fs_trace
*trace
)
1027 for (const auto& ds_file_group
: trace
->ds_file_groups
) {
1028 auto& index
= ds_file_group
->index
;
1030 BT_ASSERT(!index
.entries
.empty());
1032 BT_ASSERT(ds_file_group
->sc
->default_clock_class
);
1033 ctf_clock_class
*default_cc
= ds_file_group
->sc
->default_clock_class
;
1036 * 1. Iterate over the index, starting from the second entry
1039 for (size_t entry_i
= 1; entry_i
< index
.entries
.size(); ++entry_i
) {
1040 auto& prev_entry
= index
.entries
[entry_i
- 1];
1041 auto& curr_entry
= index
.entries
[entry_i
];
1043 * 2. Set the current entry `begin` timestamp to the
1044 * timestamp of the first event of the current packet.
1046 int ret
= decode_packet_first_event_timestamp(trace
, default_cc
, curr_entry
,
1047 &curr_entry
.timestamp_begin
,
1048 &curr_entry
.timestamp_begin_ns
);
1050 BT_CPPLOGE_APPEND_CAUSE_SPEC(trace
->logger
,
1051 "Failed to decode first event's clock snapshot");
1056 * 3. Set the previous entry `end` timestamp to the
1057 * timestamp of the first event of the current packet.
1059 prev_entry
.timestamp_end
= curr_entry
.timestamp_begin
;
1060 prev_entry
.timestamp_end_ns
= curr_entry
.timestamp_begin_ns
;
1068 * When using the lttng-crash feature it's likely that the last packets of each
1069 * stream have their timestamp_end set to zero. This is caused by the fact that
1070 * the tracer crashed and was not able to properly close the packets.
1072 * To fix up this erroneous data we do the following:
1073 * For each index entry, if the entry's timestamp_end is 0 and the
1074 * timestamp_begin is not 0:
1075 * - If it's the stream file's last packet: set the packet index entry's end
1076 * time to the packet's last event's time, if any, or to the packet's
1077 * beginning time otherwise.
1078 * - If it's not the stream file's last packet: set the packet index
1079 * entry's end time to the next packet's beginning time.
1081 * Affected versions:
1082 * - All current and future lttng-ust and lttng-modules versions.
1084 static int fix_index_lttng_crash_quirk(struct ctf_fs_trace
*trace
)
1086 for (const auto& ds_file_group
: trace
->ds_file_groups
) {
1087 struct ctf_clock_class
*default_cc
;
1089 BT_ASSERT(ds_file_group
);
1090 auto& index
= ds_file_group
->index
;
1092 BT_ASSERT(ds_file_group
->sc
->default_clock_class
);
1093 default_cc
= ds_file_group
->sc
->default_clock_class
;
1095 BT_ASSERT(!index
.entries
.empty());
1097 auto& last_entry
= index
.entries
.back();
1099 /* 1. Fix the last entry first. */
1100 if (last_entry
.timestamp_end
== 0 && last_entry
.timestamp_begin
!= 0) {
1102 * Decode packet to read the timestamp of the
1103 * last event of the stream file.
1105 int ret
= decode_packet_last_event_timestamp(trace
, default_cc
, last_entry
,
1106 &last_entry
.timestamp_end
,
1107 &last_entry
.timestamp_end_ns
);
1109 BT_CPPLOGE_APPEND_CAUSE_SPEC(trace
->logger
,
1110 "Failed to decode last event's clock snapshot");
1115 /* Iterate over all entries but the last one. */
1116 for (size_t entry_idx
= 0; entry_idx
< index
.entries
.size() - 1; ++entry_idx
) {
1117 auto& curr_entry
= index
.entries
[entry_idx
];
1118 const auto& next_entry
= index
.entries
[entry_idx
+ 1];
1120 if (curr_entry
.timestamp_end
== 0 && curr_entry
.timestamp_begin
!= 0) {
1122 * 2. Set the current index entry `end` timestamp to
1123 * the next index entry `begin` timestamp.
1125 curr_entry
.timestamp_end
= next_entry
.timestamp_begin
;
1126 curr_entry
.timestamp_end_ns
= next_entry
.timestamp_begin_ns
;
1135 * Extract the tracer information necessary to compare versions.
1136 * Returns 0 on success, and -1 if the extraction is not successful because the
1137 * necessary fields are absents in the trace metadata.
1139 static int extract_tracer_info(struct ctf_fs_trace
*trace
, struct tracer_info
*current_tracer_info
)
1141 /* Clear the current_tracer_info struct */
1142 memset(current_tracer_info
, 0, sizeof(*current_tracer_info
));
1145 * To compare 2 tracer versions, at least the tracer name and it's
1146 * major version are needed. If one of these is missing, consider it an
1147 * extraction failure.
1149 ctf_trace_class_env_entry
*entry
=
1150 ctf_trace_class_borrow_env_entry_by_name(trace
->metadata
->tc
, "tracer_name");
1151 if (!entry
|| entry
->type
!= CTF_TRACE_CLASS_ENV_ENTRY_TYPE_STR
) {
1155 /* Set tracer name. */
1156 current_tracer_info
->name
= entry
->value
.str
->str
;
1158 entry
= ctf_trace_class_borrow_env_entry_by_name(trace
->metadata
->tc
, "tracer_major");
1159 if (!entry
|| entry
->type
!= CTF_TRACE_CLASS_ENV_ENTRY_TYPE_INT
) {
1163 /* Set major version number. */
1164 current_tracer_info
->major
= entry
->value
.i
;
1166 entry
= ctf_trace_class_borrow_env_entry_by_name(trace
->metadata
->tc
, "tracer_minor");
1167 if (!entry
|| entry
->type
!= CTF_TRACE_CLASS_ENV_ENTRY_TYPE_INT
) {
1171 /* Set minor version number. */
1172 current_tracer_info
->minor
= entry
->value
.i
;
1174 entry
= ctf_trace_class_borrow_env_entry_by_name(trace
->metadata
->tc
, "tracer_patch");
1177 * If `tracer_patch` doesn't exist `tracer_patchlevel` might.
1178 * For example, `lttng-modules` uses entry name
1179 * `tracer_patchlevel`.
1181 entry
= ctf_trace_class_borrow_env_entry_by_name(trace
->metadata
->tc
, "tracer_patchlevel");
1184 if (!entry
|| entry
->type
!= CTF_TRACE_CLASS_ENV_ENTRY_TYPE_INT
) {
1188 /* Set patch version number. */
1189 current_tracer_info
->patch
= entry
->value
.i
;
1194 static bool is_tracer_affected_by_lttng_event_after_packet_bug(struct tracer_info
*curr_tracer_info
)
1196 bool is_affected
= false;
1198 if (strcmp(curr_tracer_info
->name
, "lttng-ust") == 0) {
1199 if (curr_tracer_info
->major
< 2) {
1201 } else if (curr_tracer_info
->major
== 2) {
1202 /* fixed in lttng-ust 2.11.0 */
1203 if (curr_tracer_info
->minor
< 11) {
1207 } else if (strcmp(curr_tracer_info
->name
, "lttng-modules") == 0) {
1208 if (curr_tracer_info
->major
< 2) {
1210 } else if (curr_tracer_info
->major
== 2) {
1211 /* fixed in lttng-modules 2.11.0 */
1212 if (curr_tracer_info
->minor
== 10) {
1213 /* fixed in lttng-modules 2.10.10 */
1214 if (curr_tracer_info
->patch
< 10) {
1217 } else if (curr_tracer_info
->minor
== 9) {
1218 /* fixed in lttng-modules 2.9.13 */
1219 if (curr_tracer_info
->patch
< 13) {
1222 } else if (curr_tracer_info
->minor
< 9) {
1232 is_tracer_affected_by_barectf_event_before_packet_bug(struct tracer_info
*curr_tracer_info
)
1234 bool is_affected
= false;
1236 if (strcmp(curr_tracer_info
->name
, "barectf") == 0) {
1237 if (curr_tracer_info
->major
< 2) {
1239 } else if (curr_tracer_info
->major
== 2) {
1240 if (curr_tracer_info
->minor
< 3) {
1242 } else if (curr_tracer_info
->minor
== 3) {
1243 /* fixed in barectf 2.3.1 */
1244 if (curr_tracer_info
->patch
< 1) {
1254 static bool is_tracer_affected_by_lttng_crash_quirk(struct tracer_info
*curr_tracer_info
)
1256 bool is_affected
= false;
1258 /* All LTTng tracer may be affected by this lttng crash quirk. */
1259 if (strcmp(curr_tracer_info
->name
, "lttng-ust") == 0) {
1261 } else if (strcmp(curr_tracer_info
->name
, "lttng-modules") == 0) {
1269 * Looks for trace produced by known buggy tracers and fix up the index
1272 static int fix_packet_index_tracer_bugs(ctf_fs_trace
*trace
)
1274 struct tracer_info current_tracer_info
;
1276 int ret
= extract_tracer_info(trace
, ¤t_tracer_info
);
1279 * A trace may not have all the necessary environment
1280 * entries to do the tracer version comparison.
1281 * At least, the tracer name and major version number
1282 * are needed. Failing to extract these entries is not
1285 BT_CPPLOGI_STR_SPEC(
1287 "Cannot extract tracer information necessary to compare with buggy versions.");
1291 /* Check if the trace may be affected by old tracer bugs. */
1292 if (is_tracer_affected_by_lttng_event_after_packet_bug(¤t_tracer_info
)) {
1293 BT_CPPLOGI_STR_SPEC(
1295 "Trace may be affected by LTTng tracer packet timestamp bug. Fixing up.");
1296 ret
= fix_index_lttng_event_after_packet_bug(trace
);
1298 BT_CPPLOGE_APPEND_CAUSE_SPEC(trace
->logger
,
1299 "Failed to fix LTTng event-after-packet bug.");
1302 trace
->metadata
->tc
->quirks
.lttng_event_after_packet
= true;
1305 if (is_tracer_affected_by_barectf_event_before_packet_bug(¤t_tracer_info
)) {
1306 BT_CPPLOGI_STR_SPEC(
1308 "Trace may be affected by barectf tracer packet timestamp bug. Fixing up.");
1309 ret
= fix_index_barectf_event_before_packet_bug(trace
);
1311 BT_CPPLOGE_APPEND_CAUSE_SPEC(trace
->logger
,
1312 "Failed to fix barectf event-before-packet bug.");
1315 trace
->metadata
->tc
->quirks
.barectf_event_before_packet
= true;
1318 if (is_tracer_affected_by_lttng_crash_quirk(¤t_tracer_info
)) {
1319 ret
= fix_index_lttng_crash_quirk(trace
);
1321 BT_CPPLOGE_APPEND_CAUSE_SPEC(trace
->logger
,
1322 "Failed to fix lttng-crash timestamp quirks.");
1325 trace
->metadata
->tc
->quirks
.lttng_crash
= true;
1331 static bool compare_ds_file_groups_by_first_path(const ctf_fs_ds_file_group::UP
& ds_file_group_a
,
1332 const ctf_fs_ds_file_group::UP
& ds_file_group_b
)
1334 BT_ASSERT(!ds_file_group_a
->ds_file_infos
.empty());
1335 BT_ASSERT(!ds_file_group_b
->ds_file_infos
.empty());
1337 const auto& first_ds_file_info_a
= *ds_file_group_a
->ds_file_infos
[0];
1338 const auto& first_ds_file_info_b
= *ds_file_group_b
->ds_file_infos
[0];
1340 return first_ds_file_info_a
.path
< first_ds_file_info_b
.path
;
1343 int ctf_fs_component_create_ctf_fs_trace(struct ctf_fs_component
*ctf_fs
,
1344 const bt2::ConstArrayValue pathsValue
,
1345 const char *traceName
, bt_self_component
*selfComp
)
1347 std::vector
<std::string
> paths
;
1349 BT_ASSERT(!pathsValue
.isEmpty());
1352 * Create a sorted array of the paths, to make the execution of this
1353 * component deterministic.
1355 for (const auto pathValue
: pathsValue
) {
1356 BT_ASSERT(pathValue
.isString());
1357 paths
.emplace_back(pathValue
.asString().value().str());
1360 std::sort(paths
.begin(), paths
.end());
1362 /* Create a separate ctf_fs_trace object for each path. */
1363 std::vector
<ctf_fs_trace::UP
> traces
;
1364 for (const auto& path
: paths
) {
1365 int ret
= ctf_fs_component_create_ctf_fs_trace_one_path(ctf_fs
, path
.c_str(), traceName
,
1372 if (traces
.size() > 1) {
1373 ctf_fs_trace
*first_trace
= traces
[0].get();
1374 const uint8_t *first_trace_uuid
= first_trace
->metadata
->tc
->uuid
;
1377 * We have more than one trace, they must all share the same
1378 * UUID, verify that.
1380 for (size_t i
= 0; i
< traces
.size(); i
++) {
1381 ctf_fs_trace
*this_trace
= traces
[i
].get();
1382 const uint8_t *this_trace_uuid
= this_trace
->metadata
->tc
->uuid
;
1384 if (!this_trace
->metadata
->tc
->is_uuid_set
) {
1385 BT_CPPLOGE_APPEND_CAUSE_SPEC(
1387 "Multiple traces given, but a trace does not have a UUID: path={}",
1392 if (bt_uuid_compare(first_trace_uuid
, this_trace_uuid
) != 0) {
1393 char first_trace_uuid_str
[BT_UUID_STR_LEN
+ 1];
1394 char this_trace_uuid_str
[BT_UUID_STR_LEN
+ 1];
1396 bt_uuid_to_str(first_trace_uuid
, first_trace_uuid_str
);
1397 bt_uuid_to_str(this_trace_uuid
, this_trace_uuid_str
);
1399 BT_CPPLOGE_APPEND_CAUSE_SPEC(ctf_fs
->logger
,
1400 "Multiple traces given, but UUIDs don't match: "
1401 "first-trace-uuid={}, first-trace-path={}, "
1402 "trace-uuid={}, trace-path={}",
1403 first_trace_uuid_str
, first_trace
->path
,
1404 this_trace_uuid_str
, this_trace
->path
);
1409 int ret
= merge_ctf_fs_traces(std::move(traces
), ctf_fs
->trace
);
1411 BT_CPPLOGE_APPEND_CAUSE_SPEC(ctf_fs
->logger
,
1412 "Failed to merge traces with the same UUID.");
1416 /* Just one trace, it may or may not have a UUID, both are fine. */
1417 ctf_fs
->trace
= std::move(traces
[0]);
1420 int ret
= fix_packet_index_tracer_bugs(ctf_fs
->trace
.get());
1422 BT_CPPLOGE_APPEND_CAUSE_SPEC(ctf_fs
->logger
, "Failed to fix packet index tracer bugs.");
1427 * Sort data stream file groups by first data stream file info
1428 * path to get a deterministic order. This order influences the
1429 * order of the output ports. It also influences the order of
1430 * the automatic stream IDs if the trace's packet headers do not
1431 * contain a `stream_instance_id` field, in which case the data
1432 * stream file to stream ID association is always the same,
1433 * whatever the build and the system.
1435 * Having a deterministic order here can help debugging and
1438 std::sort(ctf_fs
->trace
->ds_file_groups
.begin(), ctf_fs
->trace
->ds_file_groups
.end(),
1439 compare_ds_file_groups_by_first_path
);
1444 static const std::string
&
1445 get_stream_instance_unique_name(struct ctf_fs_ds_file_group
*ds_file_group
)
1448 * The first (earliest) stream file's path is used as the stream's unique
1451 BT_ASSERT(!ds_file_group
->ds_file_infos
.empty());
1452 return ds_file_group
->ds_file_infos
[0]->path
;
1455 /* Create the IR stream objects for ctf_fs_trace. */
1457 static int create_streams_for_trace(struct ctf_fs_trace
*ctf_fs_trace
)
1459 for (const auto& ds_file_group
: ctf_fs_trace
->ds_file_groups
) {
1460 const std::string
& name
= get_stream_instance_unique_name(ds_file_group
.get());
1462 BT_ASSERT(ds_file_group
->sc
->ir_sc
);
1463 BT_ASSERT(ctf_fs_trace
->trace
);
1465 const bt2::StreamClass sc
{ds_file_group
->sc
->ir_sc
};
1467 if (ds_file_group
->stream_id
== UINT64_C(-1)) {
1468 /* No stream ID: use 0 */
1469 ds_file_group
->stream
=
1470 sc
.instantiate(*ctf_fs_trace
->trace
, ctf_fs_trace
->next_stream_id
);
1471 ctf_fs_trace
->next_stream_id
++;
1473 /* Specific stream ID */
1474 ds_file_group
->stream
= sc
.instantiate(*ctf_fs_trace
->trace
, ds_file_group
->stream_id
);
1477 int ret
= bt_stream_set_name(ds_file_group
->stream
->libObjPtr(), name
.c_str());
1479 BT_CPPLOGE_APPEND_CAUSE_SPEC(ctf_fs_trace
->logger
,
1480 "Cannot set stream's name: "
1481 "addr={}, stream-name=\"{}\"",
1482 fmt::ptr(ds_file_group
->stream
->libObjPtr()), name
);
1490 static const bt_param_validation_value_descr inputs_elem_descr
=
1491 bt_param_validation_value_descr::makeString();
1493 static bt_param_validation_map_value_entry_descr fs_params_entries_descr
[] = {
1494 {"inputs", BT_PARAM_VALIDATION_MAP_VALUE_ENTRY_MANDATORY
,
1495 bt_param_validation_value_descr::makeArray(1, BT_PARAM_VALIDATION_INFINITE
,
1496 inputs_elem_descr
)},
1497 {"trace-name", BT_PARAM_VALIDATION_MAP_VALUE_ENTRY_OPTIONAL
,
1498 bt_param_validation_value_descr::makeString()},
1499 {"clock-class-offset-s", BT_PARAM_VALIDATION_MAP_VALUE_ENTRY_OPTIONAL
,
1500 bt_param_validation_value_descr::makeSignedInteger()},
1501 {"clock-class-offset-ns", BT_PARAM_VALIDATION_MAP_VALUE_ENTRY_OPTIONAL
,
1502 bt_param_validation_value_descr::makeSignedInteger()},
1503 {"force-clock-class-origin-unix-epoch", BT_PARAM_VALIDATION_MAP_VALUE_ENTRY_OPTIONAL
,
1504 bt_param_validation_value_descr::makeBool()},
1505 BT_PARAM_VALIDATION_MAP_VALUE_ENTRY_END
};
1507 ctf::src::fs::Parameters
read_src_fs_parameters(const bt2::ConstMapValue params
,
1508 const bt2c::Logger
& logger
)
1510 gchar
*error
= NULL
;
1511 bt_param_validation_status validate_value_status
=
1512 bt_param_validation_validate(params
.libObjPtr(), fs_params_entries_descr
, &error
);
1514 if (validate_value_status
!= BT_PARAM_VALIDATION_STATUS_OK
) {
1515 bt2c::GCharUP errorFreer
{error
};
1516 BT_CPPLOGE_APPEND_CAUSE_AND_THROW_SPEC(logger
, bt2c::Error
, "{}", error
);
1519 ctf::src::fs::Parameters parameters
{params
["inputs"]->asArray()};
1521 /* clock-class-offset-s parameter */
1522 if (const auto clockClassOffsetS
= params
["clock-class-offset-s"]) {
1523 parameters
.clkClsCfg
.offsetSec
= clockClassOffsetS
->asSignedInteger().value();
1526 /* clock-class-offset-ns parameter */
1527 if (const auto clockClassOffsetNs
= params
["clock-class-offset-ns"]) {
1528 parameters
.clkClsCfg
.offsetNanoSec
= clockClassOffsetNs
->asSignedInteger().value();
1531 /* force-clock-class-origin-unix-epoch parameter */
1532 if (const auto forceClockClassOriginUnixEpoch
= params
["force-clock-class-origin-unix-epoch"]) {
1533 parameters
.clkClsCfg
.forceOriginIsUnixEpoch
=
1534 forceClockClassOriginUnixEpoch
->asBool().value();
1537 /* trace-name parameter */
1538 if (const auto traceName
= params
["trace-name"]) {
1539 parameters
.traceName
= traceName
->asString().value().str();
1545 static ctf_fs_component::UP
ctf_fs_create(const bt2::ConstMapValue params
,
1546 bt_self_component_source
*self_comp_src
)
1548 bt_self_component
*self_comp
= bt_self_component_source_as_self_component(self_comp_src
);
1549 const bt2c::Logger logger
{bt2::SelfSourceComponent
{self_comp_src
}, "PLUGIN/SRC.CTF.FS/COMP"};
1550 const auto parameters
= read_src_fs_parameters(params
, logger
);
1551 auto ctf_fs
= bt2s::make_unique
<ctf_fs_component
>(parameters
.clkClsCfg
, logger
);
1553 if (ctf_fs_component_create_ctf_fs_trace(
1554 ctf_fs
.get(), parameters
.inputs
,
1555 parameters
.traceName
? parameters
.traceName
->c_str() : nullptr, self_comp
)) {
1559 if (create_streams_for_trace(ctf_fs
->trace
.get())) {
1563 if (create_ports_for_trace(ctf_fs
.get(), ctf_fs
->trace
.get(), self_comp_src
)) {
1570 bt_component_class_initialize_method_status
ctf_fs_init(bt_self_component_source
*self_comp_src
,
1571 bt_self_component_source_configuration
*,
1572 const bt_value
*params
, void *)
1575 bt_component_class_initialize_method_status ret
=
1576 BT_COMPONENT_CLASS_INITIALIZE_METHOD_STATUS_OK
;
1578 ctf_fs_component::UP ctf_fs
= ctf_fs_create(bt2::ConstMapValue
{params
}, self_comp_src
);
1580 ret
= BT_COMPONENT_CLASS_INITIALIZE_METHOD_STATUS_ERROR
;
1583 bt_self_component_set_data(bt_self_component_source_as_self_component(self_comp_src
),
1586 } catch (const std::bad_alloc
&) {
1587 return BT_COMPONENT_CLASS_INITIALIZE_METHOD_STATUS_MEMORY_ERROR
;
1588 } catch (const bt2::Error
&) {
1589 return BT_COMPONENT_CLASS_INITIALIZE_METHOD_STATUS_ERROR
;
1593 bt_component_class_query_method_status
ctf_fs_query(bt_self_component_class_source
*comp_class_src
,
1594 bt_private_query_executor
*priv_query_exec
,
1595 const char *object
, const bt_value
*params
,
1596 __attribute__((unused
)) void *method_data
,
1597 const bt_value
**result
)
1600 bt2c::Logger logger
{bt2::SelfComponentClass
{comp_class_src
},
1601 bt2::PrivateQueryExecutor
{priv_query_exec
},
1602 "PLUGIN/SRC.CTF.FS/QUERY"};
1603 bt2::ConstMapValue
paramsObj(params
);
1604 bt2::Value::Shared resultObj
;
1606 if (strcmp(object
, "metadata-info") == 0) {
1607 resultObj
= metadata_info_query(paramsObj
, logger
);
1608 } else if (strcmp(object
, "babeltrace.trace-infos") == 0) {
1609 resultObj
= trace_infos_query(paramsObj
, logger
);
1610 } else if (!strcmp(object
, "babeltrace.support-info")) {
1611 resultObj
= support_info_query(paramsObj
, logger
);
1613 BT_CPPLOGE_SPEC(logger
, "Unknown query object `{}`", object
);
1614 return BT_COMPONENT_CLASS_QUERY_METHOD_STATUS_UNKNOWN_OBJECT
;
1617 *result
= resultObj
.release().libObjPtr();
1619 return BT_COMPONENT_CLASS_QUERY_METHOD_STATUS_OK
;
1620 } catch (const std::bad_alloc
&) {
1621 return BT_COMPONENT_CLASS_QUERY_METHOD_STATUS_MEMORY_ERROR
;
1622 } catch (const bt2::Error
&) {
1623 return BT_COMPONENT_CLASS_QUERY_METHOD_STATUS_ERROR
;