4 * Babeltrace CTF IR - Stream
6 * Copyright 2013, 2014 Jérémie Galarneau <jeremie.galarneau@efficios.com>
8 * Author: Jérémie Galarneau <jeremie.galarneau@efficios.com>
10 * Permission is hereby granted, free of charge, to any person obtaining a copy
11 * of this software and associated documentation files (the "Software"), to deal
12 * in the Software without restriction, including without limitation the rights
13 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
14 * copies of the Software, and to permit persons to whom the Software is
15 * furnished to do so, subject to the following conditions:
17 * The above copyright notice and this permission notice shall be included in
18 * all copies or substantial portions of the Software.
20 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
21 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
22 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
23 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
24 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
25 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
29 #define BT_LOG_TAG "STREAM"
30 #include <babeltrace/lib-logging-internal.h>
32 #include <babeltrace/ctf-ir/clock-class.h>
33 #include <babeltrace/ctf-writer/clock.h>
34 #include <babeltrace/ctf-writer/clock-internal.h>
35 #include <babeltrace/ctf-writer/event.h>
36 #include <babeltrace/ctf-ir/event-internal.h>
37 #include <babeltrace/ctf-ir/field-types-internal.h>
38 #include <babeltrace/ctf-ir/fields-internal.h>
39 #include <babeltrace/ctf-ir/stream.h>
40 #include <babeltrace/ctf-ir/stream-internal.h>
41 #include <babeltrace/ctf-ir/stream-class-internal.h>
42 #include <babeltrace/ctf-ir/trace.h>
43 #include <babeltrace/ctf-ir/trace-internal.h>
44 #include <babeltrace/ctf-writer/writer-internal.h>
45 #include <babeltrace/graph/component-internal.h>
46 #include <babeltrace/ref.h>
47 #include <babeltrace/ctf-writer/functor-internal.h>
48 #include <babeltrace/compiler-internal.h>
49 #include <babeltrace/align-internal.h>
54 void bt_ctf_stream_destroy(struct bt_object
*obj
);
56 int try_set_structure_field_integer(struct bt_ctf_field
*, char *, uint64_t);
59 int set_integer_field_value(struct bt_ctf_field
* field
, uint64_t value
)
62 struct bt_ctf_field_type
*field_type
= NULL
;
65 BT_LOGW_STR("Invalid parameter: field is NULL.");
70 field_type
= bt_ctf_field_get_type(field
);
73 if (bt_ctf_field_type_get_type_id(field_type
) !=
74 BT_CTF_FIELD_TYPE_ID_INTEGER
) {
75 /* Not an integer and the value is unset, error. */
76 BT_LOGW("Invalid parameter: field's type is not an integer field type: "
77 "field-addr=%p, ft-addr=%p, ft-id=%s",
79 bt_ctf_field_type_id_string(field_type
->id
));
84 if (bt_ctf_field_type_integer_get_signed(field_type
)) {
85 ret
= bt_ctf_field_signed_integer_set_value(field
, (int64_t) value
);
87 /* Value is out of range, error. */
88 BT_LOGW("Cannot set signed integer field's value: "
89 "addr=%p, value=%" PRId64
,
90 field
, (int64_t) value
);
94 ret
= bt_ctf_field_unsigned_integer_set_value(field
, value
);
96 /* Value is out of range, error. */
97 BT_LOGW("Cannot set unsigned integer field's value: "
98 "addr=%p, value=%" PRIu64
,
109 int set_packet_header_magic(struct bt_ctf_stream
*stream
)
112 struct bt_ctf_field
*magic_field
= bt_ctf_field_structure_get_field(
113 stream
->packet_header
, "magic");
114 const uint32_t magic_value
= 0xc1fc1fc1;
119 /* No magic field found. Not an error, skip. */
120 BT_LOGV("No field named `magic` in packet header: skipping: "
121 "stream-addr=%p, stream-name=\"%s\"",
122 stream
, bt_ctf_stream_get_name(stream
));
126 ret
= bt_ctf_field_unsigned_integer_set_value(magic_field
,
127 (uint64_t) magic_value
);
130 BT_LOGW("Cannot set packet header field's `magic` integer field's value: "
131 "stream-addr=%p, stream-name=\"%s\", field-addr=%p, value=%" PRIu64
,
132 stream
, bt_ctf_stream_get_name(stream
),
133 magic_field
, (uint64_t) magic_value
);
135 BT_LOGV("Set packet header field's `magic` field's value: "
136 "stream-addr=%p, stream-name=\"%s\", field-addr=%p, value=%" PRIu64
,
137 stream
, bt_ctf_stream_get_name(stream
),
138 magic_field
, (uint64_t) magic_value
);
146 int set_packet_header_uuid(struct bt_ctf_stream
*stream
)
150 struct bt_ctf_trace
*trace
= NULL
;
151 struct bt_ctf_field
*uuid_field
= bt_ctf_field_structure_get_field(
152 stream
->packet_header
, "uuid");
157 /* No uuid field found. Not an error, skip. */
158 BT_LOGV("No field named `uuid` in packet header: skipping: "
159 "stream-addr=%p, stream-name=\"%s\"",
160 stream
, bt_ctf_stream_get_name(stream
));
164 trace
= (struct bt_ctf_trace
*) bt_object_get_parent(stream
);
165 for (i
= 0; i
< 16; i
++) {
166 struct bt_ctf_field
*uuid_element
=
167 bt_ctf_field_array_get_field(uuid_field
, i
);
169 ret
= bt_ctf_field_unsigned_integer_set_value(
170 uuid_element
, (uint64_t) trace
->uuid
[i
]);
171 bt_put(uuid_element
);
173 BT_LOGW("Cannot set integer field's value (for `uuid` packet header field): "
174 "stream-addr=%p, stream-name=\"%s\", field-addr=%p, "
175 "value=%" PRIu64
", index=%" PRId64
,
176 stream
, bt_ctf_stream_get_name(stream
),
177 uuid_element
, (uint64_t) trace
->uuid
[i
], i
);
182 BT_LOGV("Set packet header field's `uuid` field's value: "
183 "stream-addr=%p, stream-name=\"%s\", field-addr=%p",
184 stream
, bt_ctf_stream_get_name(stream
), uuid_field
);
192 int set_packet_header_stream_id(struct bt_ctf_stream
*stream
)
196 struct bt_ctf_field
*stream_id_field
= bt_ctf_field_structure_get_field(
197 stream
->packet_header
, "stream_id");
199 if (!stream_id_field
) {
200 /* No stream_id field found. Not an error, skip. */
201 BT_LOGV("No field named `stream_id` in packet header: skipping: "
202 "stream-addr=%p, stream-name=\"%s\"",
203 stream
, bt_ctf_stream_get_name(stream
));
207 stream_id
= stream
->stream_class
->id
;
208 ret
= bt_ctf_field_unsigned_integer_set_value(stream_id_field
,
209 (uint64_t) stream_id
);
211 BT_LOGW("Cannot set packet header field's `stream_id` integer field's value: "
212 "stream-addr=%p, stream-name=\"%s\", field-addr=%p, value=%" PRIu64
,
213 stream
, bt_ctf_stream_get_name(stream
),
214 stream_id_field
, (uint64_t) stream_id
);
216 BT_LOGV("Set packet header field's `stream_id` field's value: "
217 "stream-addr=%p, stream-name=\"%s\", field-addr=%p, value=%" PRIu64
,
218 stream
, bt_ctf_stream_get_name(stream
),
219 stream_id_field
, (uint64_t) stream_id
);
223 bt_put(stream_id_field
);
228 int auto_populate_packet_header(struct bt_ctf_stream
*stream
)
232 if (!stream
->packet_header
) {
236 ret
= set_packet_header_magic(stream
);
238 BT_LOGW("Cannot set packet header's magic number field: "
239 "stream-addr=%p, stream-name=\"%s\"",
240 stream
, bt_ctf_stream_get_name(stream
));
244 ret
= set_packet_header_uuid(stream
);
246 BT_LOGW("Cannot set packet header's UUID field: "
247 "stream-addr=%p, stream-name=\"%s\"",
248 stream
, bt_ctf_stream_get_name(stream
));
252 ret
= set_packet_header_stream_id(stream
);
254 BT_LOGW("Cannot set packet header's stream class ID field: "
255 "stream-addr=%p, stream-name=\"%s\"",
256 stream
, bt_ctf_stream_get_name(stream
));
260 BT_LOGV("Automatically populated stream's packet header's known fields: "
261 "stream-addr=%p, stream-name=\"%s\"",
262 stream
, bt_ctf_stream_get_name(stream
));
269 int set_packet_context_packet_size(struct bt_ctf_stream
*stream
)
272 struct bt_ctf_field
*field
= bt_ctf_field_structure_get_field(
273 stream
->packet_context
, "packet_size");
278 /* No packet size field found. Not an error, skip. */
279 BT_LOGV("No field named `packet_size` in packet context: skipping: "
280 "stream-addr=%p, stream-name=\"%s\"",
281 stream
, bt_ctf_stream_get_name(stream
));
285 ret
= bt_ctf_field_unsigned_integer_set_value(field
,
286 stream
->pos
.packet_size
);
288 BT_LOGW("Cannot set packet context field's `packet_size` integer field's value: "
289 "stream-addr=%p, stream-name=\"%s\", field-addr=%p, value=%" PRIu64
,
290 stream
, bt_ctf_stream_get_name(stream
),
291 field
, stream
->pos
.packet_size
);
293 BT_LOGV("Set packet context field's `packet_size` field's value: "
294 "stream-addr=%p, stream-name=\"%s\", field-addr=%p, value=%" PRIu64
,
295 stream
, bt_ctf_stream_get_name(stream
),
296 field
, stream
->pos
.packet_size
);
305 int set_packet_context_content_size(struct bt_ctf_stream
*stream
)
308 struct bt_ctf_field
*field
= bt_ctf_field_structure_get_field(
309 stream
->packet_context
, "content_size");
314 /* No content size field found. Not an error, skip. */
315 BT_LOGV("No field named `content_size` in packet context: skipping: "
316 "stream-addr=%p, stream-name=\"%s\"",
317 stream
, bt_ctf_stream_get_name(stream
));
321 ret
= bt_ctf_field_unsigned_integer_set_value(field
,
324 BT_LOGW("Cannot set packet context field's `content_size` integer field's value: "
325 "stream-addr=%p, stream-name=\"%s\", field-addr=%p, value=%" PRId64
,
326 stream
, bt_ctf_stream_get_name(stream
),
327 field
, stream
->pos
.offset
);
329 BT_LOGV("Set packet context field's `content_size` field's value: "
330 "stream-addr=%p, stream-name=\"%s\", field-addr=%p, value=%" PRId64
,
331 stream
, bt_ctf_stream_get_name(stream
),
332 field
, stream
->pos
.offset
);
341 int set_packet_context_events_discarded(struct bt_ctf_stream
*stream
)
344 struct bt_ctf_field
*field
= bt_ctf_field_structure_get_field(
345 stream
->packet_context
, "events_discarded");
350 /* No discarded events count field found. Not an error, skip. */
351 BT_LOGV("No field named `events_discarded` in packet context: skipping: "
352 "stream-addr=%p, stream-name=\"%s\"",
353 stream
, bt_ctf_stream_get_name(stream
));
358 * If the field is set by the user, make sure that the value is
359 * greater than or equal to the stream's current count of
360 * discarded events. We do not allow wrapping here. If it's
361 * valid, update the stream's current count.
363 if (bt_ctf_field_is_set(field
)) {
366 ret
= bt_ctf_field_unsigned_integer_get_value(field
,
369 BT_LOGW("Cannot get packet context `events_discarded` field's unsigned value: "
370 "stream-addr=%p, stream-name=\"%s\", field-addr=%p",
371 stream
, bt_ctf_stream_get_name(stream
), field
);
375 if (user_val
< stream
->discarded_events
) {
376 BT_LOGW("Invalid packet context `events_discarded` field's unsigned value: "
377 "value is lesser than the stream's current discarded events count: "
378 "stream-addr=%p, stream-name=\"%s\", field-addr=%p, "
379 "value=%" PRIu64
", "
380 "stream-discarded-events-count=%" PRIu64
,
381 stream
, bt_ctf_stream_get_name(stream
), field
,
382 user_val
, stream
->discarded_events
);
386 stream
->discarded_events
= user_val
;
388 ret
= bt_ctf_field_unsigned_integer_set_value(field
,
389 stream
->discarded_events
);
391 BT_LOGW("Cannot set packet context field's `events_discarded` integer field's value: "
392 "stream-addr=%p, stream-name=\"%s\", field-addr=%p, value=%" PRIu64
,
393 stream
, bt_ctf_stream_get_name(stream
),
394 field
, stream
->discarded_events
);
396 BT_LOGV("Set packet context field's `events_discarded` field's value: "
397 "stream-addr=%p, stream-name=\"%s\", field-addr=%p, value=%" PRIu64
,
398 stream
, bt_ctf_stream_get_name(stream
),
399 field
, stream
->discarded_events
);
409 int get_event_header_timestamp(struct bt_ctf_stream
*stream
,
410 struct bt_ctf_field
*event_header
, uint64_t *timestamp
)
413 struct bt_ctf_field
*timestamp_field
= NULL
;
414 struct bt_ctf_clock_class
*ts_field_mapped_clock_class
= NULL
;
419 BT_LOGV_STR("Event header does not exist.");
423 timestamp_field
= bt_ctf_field_structure_get_field(event_header
,
425 if (!timestamp_field
) {
426 BT_LOGV("Cannot get event header's `timestamp` field: "
427 "event-header-field-addr=%p", event_header
);
431 if (!bt_ctf_field_type_is_integer(timestamp_field
->type
)) {
432 BT_LOGV("Event header's `timestamp` field's type is not an integer field type: "
433 "event-header-field-addr=%p", event_header
);
437 ts_field_mapped_clock_class
=
438 bt_ctf_field_type_integer_get_mapped_clock_class(
439 timestamp_field
->type
);
440 if (!ts_field_mapped_clock_class
) {
441 BT_LOGV("Event header's `timestamp` field's type is not mapped to a clock class: "
442 "event-header-field-addr=%p", event_header
);
446 if (ts_field_mapped_clock_class
!=
447 stream
->stream_class
->clock
->clock_class
) {
448 BT_LOGV("Event header's `timestamp` field's type is not mapped to the stream's clock's class: "
449 "event-header-field-addr=%p", event_header
);
453 ret
= bt_ctf_field_unsigned_integer_get_value(timestamp_field
,
456 BT_LOGW("Cannot get unsigned integer field's value: "
457 "event-header-field-addr=%p, "
458 "timestamp-field-addr=%p",
459 event_header
, timestamp_field
);
464 bt_put(timestamp_field
);
465 bt_put(ts_field_mapped_clock_class
);
470 int set_packet_context_timestamp_field(struct bt_ctf_stream
*stream
,
471 const char *field_name
, struct bt_ctf_event
*event
)
474 struct bt_ctf_field
*field
= bt_ctf_field_structure_get_field(
475 stream
->packet_context
, field_name
);
476 struct bt_ctf_clock_class
*field_mapped_clock_class
= NULL
;
482 /* No beginning timestamp field found. Not an error, skip. */
483 BT_LOGV("No field named `%s` in packet context: skipping: "
484 "stream-addr=%p, stream-name=\"%s\"", field_name
,
485 stream
, bt_ctf_stream_get_name(stream
));
489 if (!stream
->stream_class
->clock
) {
490 BT_LOGV("Stream has no clock: skipping: "
491 "stream-addr=%p, stream-name=\"%s\"",
492 stream
, bt_ctf_stream_get_name(stream
));
496 field_mapped_clock_class
=
497 bt_ctf_field_type_integer_get_mapped_clock_class(field
->type
);
498 if (!field_mapped_clock_class
) {
499 BT_LOGV("Packet context's `%s` field's type is not mapped to a clock class: skipping: "
500 "stream-addr=%p, stream-name=\"%s\", "
501 "field-addr=%p, ft-addr=%p", field_name
,
502 stream
, bt_ctf_stream_get_name(stream
),
507 if (field_mapped_clock_class
!=
508 stream
->stream_class
->clock
->clock_class
) {
509 BT_LOGV("Packet context's `%s` field's type is not mapped to the stream's clock's class: skipping: "
510 "stream-addr=%p, stream-name=\"%s\", "
511 "field-addr=%p, ft-addr=%p, "
512 "ft-mapped-clock-class-addr=%p, "
513 "ft-mapped-clock-class-name=\"%s\", "
514 "stream-clock-class-addr=%p, "
515 "stream-clock-class-name=\"%s\"",
517 stream
, bt_ctf_stream_get_name(stream
),
519 field_mapped_clock_class
,
520 bt_ctf_clock_class_get_name(field_mapped_clock_class
),
521 stream
->stream_class
->clock
->clock_class
,
522 bt_ctf_clock_class_get_name(
523 stream
->stream_class
->clock
->clock_class
));
527 if (get_event_header_timestamp(stream
, event
->event_header
, &ts
)) {
528 BT_LOGW("Cannot get event's timestamp: "
529 "event-header-field-addr=%p",
530 event
->event_header
);
535 ret
= bt_ctf_field_unsigned_integer_set_value(field
, ts
);
537 BT_LOGW("Cannot set packet context field's `%s` integer field's value: "
538 "stream-addr=%p, stream-name=\"%s\", field-addr=%p, value=%" PRIu64
,
539 field_name
, stream
, bt_ctf_stream_get_name(stream
),
540 field
, stream
->discarded_events
);
542 BT_LOGV("Set packet context field's `%s` field's value: "
543 "stream-addr=%p, stream-name=\"%s\", field-addr=%p, value=%" PRIu64
,
544 field_name
, stream
, bt_ctf_stream_get_name(stream
),
545 field
, stream
->discarded_events
);
550 bt_put(field_mapped_clock_class
);
555 int set_packet_context_timestamp_begin(struct bt_ctf_stream
*stream
)
559 if (stream
->events
->len
== 0) {
560 BT_LOGV("Current packet contains no events: skipping: "
561 "stream-addr=%p, stream-name=\"%s\"",
562 stream
, bt_ctf_stream_get_name(stream
));
566 ret
= set_packet_context_timestamp_field(stream
, "timestamp_begin",
567 g_ptr_array_index(stream
->events
, 0));
574 int set_packet_context_timestamp_end(struct bt_ctf_stream
*stream
)
578 if (stream
->events
->len
== 0) {
579 BT_LOGV("Current packet contains no events: skipping: "
580 "stream-addr=%p, stream-name=\"%s\"",
581 stream
, bt_ctf_stream_get_name(stream
));
585 ret
= set_packet_context_timestamp_field(stream
, "timestamp_end",
586 g_ptr_array_index(stream
->events
, stream
->events
->len
- 1));
593 int auto_populate_packet_context(struct bt_ctf_stream
*stream
)
597 if (!stream
->packet_context
) {
601 ret
= set_packet_context_packet_size(stream
);
603 BT_LOGW("Cannot set packet context's packet size field: "
604 "stream-addr=%p, stream-name=\"%s\"",
605 stream
, bt_ctf_stream_get_name(stream
));
609 ret
= set_packet_context_content_size(stream
);
611 BT_LOGW("Cannot set packet context's content size field: "
612 "stream-addr=%p, stream-name=\"%s\"",
613 stream
, bt_ctf_stream_get_name(stream
));
617 ret
= set_packet_context_timestamp_begin(stream
);
619 BT_LOGW("Cannot set packet context's beginning timestamp field: "
620 "stream-addr=%p, stream-name=\"%s\"",
621 stream
, bt_ctf_stream_get_name(stream
));
625 ret
= set_packet_context_timestamp_end(stream
);
627 BT_LOGW("Cannot set packet context's end timestamp field: "
628 "stream-addr=%p, stream-name=\"%s\"",
629 stream
, bt_ctf_stream_get_name(stream
));
633 ret
= set_packet_context_events_discarded(stream
);
635 BT_LOGW("Cannot set packet context's discarded events count field: "
636 "stream-addr=%p, stream-name=\"%s\"",
637 stream
, bt_ctf_stream_get_name(stream
));
641 BT_LOGV("Automatically populated stream's packet context's known fields: "
642 "stream-addr=%p, stream-name=\"%s\"",
643 stream
, bt_ctf_stream_get_name(stream
));
650 void release_event(struct bt_ctf_event
*event
)
652 if (bt_object_get_ref_count(event
)) {
654 * The event is being orphaned, but it must guarantee the
655 * existence of its event class for the duration of its
658 bt_get(event
->event_class
);
659 BT_PUT(event
->base
.parent
);
661 bt_object_release(event
);
666 int create_stream_file(struct bt_ctf_writer
*writer
,
667 struct bt_ctf_stream
*stream
)
670 GString
*filename
= g_string_new(NULL
);
671 int64_t stream_class_id
;
672 char *file_path
= NULL
;
674 BT_LOGD("Creating stream file: writer-addr=%p, stream-addr=%p, "
675 "stream-name=\"%s\", stream-class-addr=%p, stream-class-name=\"%s\"",
676 writer
, stream
, bt_ctf_stream_get_name(stream
),
677 stream
->stream_class
, stream
->stream_class
->name
->str
);
679 if (stream
->name
&& stream
->name
->len
> 0) {
680 /* Use stream name's base name as prefix */
681 gchar
*basename
= g_path_get_basename(stream
->name
->str
);
685 if (strcmp(basename
, G_DIR_SEPARATOR_S
) == 0) {
686 g_string_assign(filename
, "stream");
688 g_string_assign(filename
, basename
);
695 if (stream
->stream_class
->name
&&
696 stream
->stream_class
->name
->len
> 0) {
697 /* Use stream class name's base name as prefix */
699 g_path_get_basename(stream
->stream_class
->name
->str
);
703 if (strcmp(basename
, G_DIR_SEPARATOR_S
) == 0) {
704 g_string_assign(filename
, "stream");
706 g_string_assign(filename
, basename
);
713 /* Default to using `stream-` as prefix */
714 g_string_assign(filename
, "stream");
717 stream_class_id
= bt_ctf_stream_class_get_id(stream
->stream_class
);
718 assert(stream_class_id
>= 0);
719 assert(stream
->id
>= 0);
720 g_string_append_printf(filename
, "-%" PRId64
"-%" PRId64
,
721 stream_class_id
, stream
->id
);
723 file_path
= g_build_filename(writer
->path
->str
, filename
->str
, NULL
);
724 if (file_path
== NULL
) {
730 O_RDWR
| O_CREAT
| O_TRUNC
,
731 S_IRUSR
| S_IWUSR
| S_IRGRP
| S_IWGRP
);
734 BT_LOGW("Failed to open stream file for writing: %s: "
736 "ret=%d, errno=%d", strerror(errno
),
737 filename
->str
, fd
, errno
);
741 BT_LOGD("Created stream file for writing: "
742 "stream-addr=%p, stream-name=\"%s\", "
743 "filename=\"%s\", fd=%d", stream
, bt_ctf_stream_get_name(stream
),
747 g_string_free(filename
, TRUE
);
752 void set_stream_fd(struct bt_ctf_stream
*stream
, int fd
)
754 (void) bt_ctf_stream_pos_init(&stream
->pos
, fd
, O_RDWR
);
759 void component_destroy_listener(struct bt_component
*component
, void *data
)
761 struct bt_ctf_stream
*stream
= data
;
763 BT_LOGD("Component is being destroyed, stream is notified: "
764 "comp-addr=%p, stream-addr=%p", component
, stream
);
765 g_hash_table_remove(stream
->comp_cur_port
, component
);
769 struct bt_ctf_stream
*bt_ctf_stream_create_with_id_no_check(
770 struct bt_ctf_stream_class
*stream_class
,
771 const char *name
, uint64_t id
)
774 struct bt_ctf_stream
*stream
= NULL
;
775 struct bt_ctf_trace
*trace
= NULL
;
776 struct bt_ctf_writer
*writer
= NULL
;
779 BT_LOGW_STR("Invalid parameter: stream class is NULL.");
783 BT_LOGD("Creating stream object: stream-class-addr=%p, "
784 "stream-class-name=\"%s\", stream-name=\"%s\", "
785 "stream-id=%" PRIu64
,
786 stream_class
, bt_ctf_stream_class_get_name(stream_class
),
788 trace
= bt_ctf_stream_class_borrow_trace(stream_class
);
790 BT_LOGW("Invalid parameter: cannot create stream from a stream class which is not part of trace: "
791 "stream-class-addr=%p, stream-class-name=\"%s\", "
792 "stream-name=\"%s\"",
793 stream_class
, bt_ctf_stream_class_get_name(stream_class
),
798 if (bt_ctf_trace_is_static(trace
)) {
800 * A static trace has the property that all its stream
801 * classes, clock classes, and streams are definitive:
802 * no more can be added, and each object is also frozen.
804 BT_LOGW("Invalid parameter: cannot create stream from a stream class which is part of a static trace: "
805 "stream-class-addr=%p, stream-class-name=\"%s\", "
806 "stream-name=\"%s\", trace-addr=%p",
807 stream_class
, bt_ctf_stream_class_get_name(stream_class
),
814 * Validate that the given ID is unique amongst all the
815 * existing trace's streams created from the same stream
820 for (i
= 0; i
< trace
->streams
->len
; i
++) {
821 struct bt_ctf_stream
*trace_stream
=
822 g_ptr_array_index(trace
->streams
, i
);
824 if (trace_stream
->stream_class
!= stream_class
) {
828 if (trace_stream
->id
== id
) {
829 BT_LOGW_STR("Invalid parameter: another stream in the same trace already has this ID.");
835 stream
= g_new0(struct bt_ctf_stream
, 1);
837 BT_LOGE_STR("Failed to allocate one stream.");
841 bt_object_init(stream
, bt_ctf_stream_destroy
);
843 * Acquire reference to parent since stream will become publicly
844 * reachable; it needs its parent to remain valid.
846 bt_object_set_parent(stream
, trace
);
847 stream
->stream_class
= stream_class
;
849 stream
->id
= (int64_t) id
;
851 stream
->destroy_listeners
= g_array_new(FALSE
, TRUE
,
852 sizeof(struct bt_ctf_stream_destroy_listener
));
853 if (!stream
->destroy_listeners
) {
854 BT_LOGE_STR("Failed to allocate a GArray.");
859 stream
->name
= g_string_new(name
);
861 BT_LOGE_STR("Failed to allocate a GString.");
866 BT_LOGD("Set stream's trace parent: trace-addr=%p", trace
);
868 if (trace
->is_created_by_writer
) {
870 writer
= (struct bt_ctf_writer
*) bt_object_get_parent(trace
);
871 stream
->id
= (int64_t) stream_class
->next_stream_id
++;
873 BT_LOGD("Stream object belongs to a writer's trace: "
874 "writer-addr=%p", writer
);
877 if (stream_class
->packet_context_type
) {
878 BT_LOGD("Creating stream's packet context field: "
879 "ft-addr=%p", stream_class
->packet_context_type
);
880 stream
->packet_context
= bt_ctf_field_create(
881 stream_class
->packet_context_type
);
882 if (!stream
->packet_context
) {
883 BT_LOGW_STR("Cannot create stream's packet context field.");
887 /* Initialize events_discarded */
888 ret
= try_set_structure_field_integer(
889 stream
->packet_context
, "events_discarded", 0);
891 BT_LOGW("Cannot set `events_discarded` field in packet context: "
892 "ret=%d, packet-context-field-addr=%p",
893 ret
, stream
->packet_context
);
898 stream
->events
= g_ptr_array_new_with_free_func(
899 (GDestroyNotify
) release_event
);
900 if (!stream
->events
) {
901 BT_LOGE_STR("Failed to allocate a GPtrArray.");
905 if (trace
->packet_header_type
) {
906 BT_LOGD("Creating stream's packet header field: "
907 "ft-addr=%p", trace
->packet_header_type
);
908 stream
->packet_header
=
909 bt_ctf_field_create(trace
->packet_header_type
);
910 if (!stream
->packet_header
) {
911 BT_LOGW_STR("Cannot create stream's packet header field.");
917 * Attempt to populate the default trace packet header fields
918 * (magic, uuid and stream_id). This will _not_ fail shall the
919 * fields not be found or be of an incompatible type; they will
920 * simply not be populated automatically. The user will have to
921 * make sure to set the trace packet header fields himself
924 ret
= auto_populate_packet_header(stream
);
926 BT_LOGW_STR("Cannot automatically populate the stream's packet header.");
930 /* Create file associated with this stream */
931 fd
= create_stream_file(writer
, stream
);
933 BT_LOGW_STR("Cannot create stream file.");
937 set_stream_fd(stream
, fd
);
939 /* Freeze the writer */
940 BT_LOGD_STR("Freezing stream's CTF writer.");
941 bt_ctf_writer_freeze(writer
);
943 /* Non-writer stream indicated by a negative FD */
944 set_stream_fd(stream
, -1);
945 stream
->comp_cur_port
= g_hash_table_new(g_direct_hash
,
947 if (!stream
->comp_cur_port
) {
948 BT_LOGE_STR("Failed to allocate a GHashTable.");
953 /* Add this stream to the trace's streams */
954 g_ptr_array_add(trace
->streams
, stream
);
955 BT_LOGD("Created stream object: addr=%p", stream
);
966 struct bt_ctf_stream
*bt_ctf_stream_create_with_id(
967 struct bt_ctf_stream_class
*stream_class
,
968 const char *name
, uint64_t id_param
)
970 struct bt_ctf_trace
*trace
;
971 struct bt_ctf_stream
*stream
= NULL
;
972 int64_t id
= (int64_t) id_param
;
975 BT_LOGW_STR("Invalid parameter: stream class is NULL.");
980 BT_LOGW("Invalid parameter: invalid stream's ID: "
981 "name=\"%s\", id=%" PRIu64
,
986 trace
= bt_ctf_stream_class_borrow_trace(stream_class
);
988 BT_LOGW("Invalid parameter: cannot create stream from a stream class which is not part of trace: "
989 "stream-class-addr=%p, stream-class-name=\"%s\", "
990 "stream-name=\"%s\", stream-id=%" PRIu64
,
991 stream_class
, bt_ctf_stream_class_get_name(stream_class
),
996 if (trace
->is_created_by_writer
) {
997 BT_LOGW("Invalid parameter: cannot create a CTF writer stream with this function; use bt_ctf_stream_create(): "
998 "stream-class-addr=%p, stream-class-name=\"%s\", "
999 "stream-name=\"%s\", stream-id=%" PRIu64
,
1000 stream_class
, bt_ctf_stream_class_get_name(stream_class
),
1005 stream
= bt_ctf_stream_create_with_id_no_check(stream_class
,
1012 struct bt_ctf_stream
*bt_ctf_stream_create(
1013 struct bt_ctf_stream_class
*stream_class
,
1016 return bt_ctf_stream_create_with_id_no_check(stream_class
,
1020 struct bt_ctf_stream_class
*bt_ctf_stream_get_class(
1021 struct bt_ctf_stream
*stream
)
1023 struct bt_ctf_stream_class
*stream_class
= NULL
;
1026 BT_LOGW_STR("Invalid parameter: stream is NULL.");
1030 stream_class
= stream
->stream_class
;
1031 bt_get(stream_class
);
1033 return stream_class
;
1036 int bt_ctf_stream_get_discarded_events_count(
1037 struct bt_ctf_stream
*stream
, uint64_t *count
)
1042 BT_LOGW_STR("Invalid parameter: stream is NULL.");
1048 BT_LOGW_STR("Invalid parameter: count is NULL.");
1053 if (stream
->pos
.fd
< 0) {
1054 BT_LOGW("Invalid parameter: stream is not a CTF writer stream: "
1055 "stream-addr=%p, stream-name=\"%s\"",
1056 stream
, bt_ctf_stream_get_name(stream
));
1061 *count
= (uint64_t) stream
->discarded_events
;
1068 int set_packet_context_events_discarded_field(struct bt_ctf_stream
*stream
,
1072 struct bt_ctf_field
*events_discarded_field
= NULL
;
1074 if (!stream
->packet_context
) {
1078 events_discarded_field
= bt_ctf_field_structure_get_field(
1079 stream
->packet_context
, "events_discarded");
1080 if (!events_discarded_field
) {
1084 ret
= bt_ctf_field_unsigned_integer_set_value(
1085 events_discarded_field
, count
);
1087 BT_LOGW("Cannot set packet context's `events_discarded` field: "
1088 "field-addr=%p, value=%" PRIu64
,
1089 events_discarded_field
, count
);
1094 bt_put(events_discarded_field
);
1098 void bt_ctf_stream_append_discarded_events(struct bt_ctf_stream
*stream
,
1099 uint64_t event_count
)
1103 struct bt_ctf_field
*events_discarded_field
= NULL
;
1106 BT_LOGW_STR("Invalid parameter: stream is NULL.");
1110 BT_LOGV("Appending discarded events to stream: "
1111 "stream-addr=%p, stream-name=\"%s\", append-count=%" PRIu64
,
1112 stream
, bt_ctf_stream_get_name(stream
), event_count
);
1114 if (!stream
->packet_context
) {
1115 BT_LOGW_STR("Invalid parameter: stream has no packet context field.");
1119 if (stream
->pos
.fd
< 0) {
1120 BT_LOGW_STR("Invalid parameter: stream is not a CTF writer stream.");
1124 events_discarded_field
= bt_ctf_field_structure_get_field(
1125 stream
->packet_context
, "events_discarded");
1126 if (!events_discarded_field
) {
1127 BT_LOGW_STR("No field named `events_discarded` in stream's packet context.");
1131 new_count
= stream
->discarded_events
+ event_count
;
1132 if (new_count
< stream
->discarded_events
) {
1133 BT_LOGW("New discarded events count is less than the stream's current discarded events count: "
1134 "cur-count=%" PRIu64
", new-count=%" PRIu64
,
1135 stream
->discarded_events
, new_count
);
1139 ret
= set_packet_context_events_discarded_field(stream
, new_count
);
1141 /* set_packet_context_events_discarded_field() logs errors */
1145 stream
->discarded_events
= new_count
;
1146 BT_LOGV("Appended discarded events to stream: "
1147 "stream-addr=%p, stream-name=\"%s\", append-count=%" PRIu64
,
1148 stream
, bt_ctf_stream_get_name(stream
), event_count
);
1151 bt_put(events_discarded_field
);
1154 static int auto_populate_event_header(struct bt_ctf_stream
*stream
,
1155 struct bt_ctf_event
*event
)
1158 struct bt_ctf_field
*id_field
= NULL
, *timestamp_field
= NULL
;
1159 struct bt_ctf_clock_class
*mapped_clock_class
= NULL
;
1160 uint64_t event_class_id
;
1164 if (!event
->event_header
) {
1168 if (event
->frozen
) {
1169 BT_LOGW_STR("Cannot populate event header field: event is frozen.");
1174 BT_LOGV("Automatically populating event's header field: "
1175 "stream-addr=%p, stream-name=\"%s\", event-addr=%p",
1176 stream
, bt_ctf_stream_get_name(stream
), event
);
1178 id_field
= bt_ctf_field_structure_get_field(event
->event_header
, "id");
1179 event_class_id
= (uint64_t) bt_ctf_event_class_get_id(event
->event_class
);
1180 assert(event_class_id
>= 0);
1181 if (id_field
&& bt_ctf_field_type_is_integer(id_field
->type
)) {
1182 ret
= set_integer_field_value(id_field
, event_class_id
);
1184 BT_LOGW("Cannot set event header's `id` field's value: "
1185 "addr=%p, value=%" PRIu64
, id_field
,
1192 * The conditions to automatically set the timestamp are:
1194 * 1. The event header field "timestamp" exists and is an
1196 * 2. This stream's class has a registered clock (set with
1197 * bt_ctf_stream_class_set_clock()).
1198 * 3. The event header field "timestamp" has its type mapped to
1199 * a clock class which is also the clock class of this
1200 * stream's class's registered clock.
1202 timestamp_field
= bt_ctf_field_structure_get_field(event
->event_header
,
1204 if (timestamp_field
&& stream
->stream_class
->clock
&&
1205 bt_ctf_field_type_is_integer(timestamp_field
->type
)) {
1206 struct bt_ctf_clock_class
*stream_class_clock_class
=
1207 stream
->stream_class
->clock
->clock_class
;
1209 mapped_clock_class
=
1210 bt_ctf_field_type_integer_get_mapped_clock_class(
1211 timestamp_field
->type
);
1212 if (mapped_clock_class
== stream_class_clock_class
) {
1215 ret
= bt_ctf_clock_get_value(
1216 stream
->stream_class
->clock
,
1219 ret
= set_integer_field_value(timestamp_field
,
1222 BT_LOGW("Cannot set event header's `timestamp` field's value: "
1223 "addr=%p, value=%" PRIu64
,
1224 timestamp_field
, timestamp
);
1230 BT_LOGV("Automatically populated event's header field: "
1231 "stream-addr=%p, stream-name=\"%s\", event-addr=%p",
1232 stream
, bt_ctf_stream_get_name(stream
), event
);
1236 bt_put(timestamp_field
);
1237 bt_put(mapped_clock_class
);
1241 int bt_ctf_stream_append_event(struct bt_ctf_stream
*stream
,
1242 struct bt_ctf_event
*event
)
1247 BT_LOGW_STR("Invalid parameter: stream is NULL.");
1253 BT_LOGW_STR("Invalid parameter: event is NULL.");
1258 if (stream
->pos
.fd
< 0) {
1259 BT_LOGW_STR("Invalid parameter: stream is not a CTF writer stream.");
1264 BT_LOGV("Appending event to stream: "
1265 "stream-addr=%p, stream-name=\"%s\", event-addr=%p, "
1266 "event-class-name=\"%s\", event-class-id=%" PRId64
,
1267 stream
, bt_ctf_stream_get_name(stream
), event
,
1268 bt_ctf_event_class_get_name(bt_ctf_event_borrow_event_class(event
)),
1269 bt_ctf_event_class_get_id(bt_ctf_event_borrow_event_class(event
)));
1272 * The event is not supposed to have a parent stream at this
1273 * point. The only other way an event can have a parent stream
1274 * is if it was assigned when setting a packet to the event,
1275 * in which case the packet's stream is not a writer stream,
1276 * and thus the user is trying to append an event which belongs
1277 * to another stream.
1279 if (event
->base
.parent
) {
1284 bt_object_set_parent(event
, stream
);
1285 BT_LOGV_STR("Automatically populating the header of the event to append.");
1286 ret
= auto_populate_event_header(stream
, event
);
1288 /* auto_populate_event_header() reports errors */
1292 /* Make sure the various scopes of the event are set */
1293 BT_LOGV_STR("Validating event to append.");
1294 ret
= bt_ctf_event_validate(event
);
1299 /* Save the new event and freeze it */
1300 BT_LOGV_STR("Freezing the event to append.");
1301 bt_ctf_event_freeze(event
);
1302 g_ptr_array_add(stream
->events
, event
);
1305 * Event had to hold a reference to its event class as long as it wasn't
1306 * part of the same trace hierarchy. From now on, the event and its
1307 * class share the same lifetime guarantees and the reference is no
1310 BT_LOGV_STR("Putting the event's class.");
1311 bt_put(event
->event_class
);
1312 BT_LOGV("Appended event to stream: "
1313 "stream-addr=%p, stream-name=\"%s\", event-addr=%p, "
1314 "event-class-name=\"%s\", event-class-id=%" PRId64
,
1315 stream
, bt_ctf_stream_get_name(stream
), event
,
1316 bt_ctf_event_class_get_name(bt_ctf_event_borrow_event_class(event
)),
1317 bt_ctf_event_class_get_id(bt_ctf_event_borrow_event_class(event
)));
1324 * Orphan the event; we were not successful in associating it to
1327 bt_object_set_parent(event
, NULL
);
1332 struct bt_ctf_field
*bt_ctf_stream_get_packet_context(
1333 struct bt_ctf_stream
*stream
)
1335 struct bt_ctf_field
*packet_context
= NULL
;
1338 BT_LOGW_STR("Invalid parameter: stream is NULL.");
1342 if (stream
->pos
.fd
< 0) {
1343 BT_LOGW("Invalid parameter: stream is not a CTF writer stream: "
1344 "stream-addr=%p, stream-name=\"%s\"", stream
,
1345 bt_ctf_stream_get_name(stream
));
1349 packet_context
= stream
->packet_context
;
1350 if (packet_context
) {
1351 bt_get(packet_context
);
1354 return packet_context
;
1357 int bt_ctf_stream_set_packet_context(struct bt_ctf_stream
*stream
,
1358 struct bt_ctf_field
*field
)
1361 struct bt_ctf_field_type
*field_type
;
1364 BT_LOGW_STR("Invalid parameter: stream is NULL.");
1369 if (stream
->pos
.fd
< 0) {
1370 BT_LOGW_STR("Invalid parameter: stream is not a CTF writer stream.");
1375 field_type
= bt_ctf_field_get_type(field
);
1376 if (bt_ctf_field_type_compare(field_type
,
1377 stream
->stream_class
->packet_context_type
)) {
1378 BT_LOGW("Invalid parameter: packet context's field type is different from the stream's packet context field type: "
1379 "stream-addr=%p, stream-name=\"%s\", "
1380 "packet-context-field-addr=%p, "
1381 "packet-context-ft-addr=%p",
1382 stream
, bt_ctf_stream_get_name(stream
),
1389 bt_put(stream
->packet_context
);
1390 stream
->packet_context
= bt_get(field
);
1391 BT_LOGV("Set stream's packet context field: "
1392 "stream-addr=%p, stream-name=\"%s\", "
1393 "packet-context-field-addr=%p",
1394 stream
, bt_ctf_stream_get_name(stream
), field
);
1399 struct bt_ctf_field
*bt_ctf_stream_get_packet_header(
1400 struct bt_ctf_stream
*stream
)
1402 struct bt_ctf_field
*packet_header
= NULL
;
1405 BT_LOGW_STR("Invalid parameter: stream is NULL.");
1409 if (stream
->pos
.fd
< 0) {
1410 BT_LOGW("Invalid parameter: stream is not a CTF writer stream: "
1411 "stream-addr=%p, stream-name=\"%s\"", stream
,
1412 bt_ctf_stream_get_name(stream
));
1416 packet_header
= stream
->packet_header
;
1417 if (packet_header
) {
1418 bt_get(packet_header
);
1421 return packet_header
;
1424 int bt_ctf_stream_set_packet_header(struct bt_ctf_stream
*stream
,
1425 struct bt_ctf_field
*field
)
1428 struct bt_ctf_trace
*trace
= NULL
;
1429 struct bt_ctf_field_type
*field_type
= NULL
;
1432 BT_LOGW_STR("Invalid parameter: stream is NULL.");
1437 if (stream
->pos
.fd
< 0) {
1438 BT_LOGW_STR("Invalid parameter: stream is not a CTF writer stream.");
1443 trace
= (struct bt_ctf_trace
*) bt_object_get_parent(stream
);
1446 if (trace
->packet_header_type
) {
1447 BT_LOGW("Invalid parameter: setting no packet header but packet header field type is not NULL: "
1448 "stream-addr=%p, stream-name=\"%s\", "
1449 "packet-header-field-addr=%p, "
1450 "expected-ft-addr=%p",
1451 stream
, bt_ctf_stream_get_name(stream
),
1452 field
, trace
->packet_header_type
);
1457 goto skip_validation
;
1460 field_type
= bt_ctf_field_get_type(field
);
1463 if (bt_ctf_field_type_compare(field_type
, trace
->packet_header_type
)) {
1464 BT_LOGW("Invalid parameter: packet header's field type is different from the stream's packet header field type: "
1465 "stream-addr=%p, stream-name=\"%s\", "
1466 "packet-header-field-addr=%p, "
1467 "packet-header-ft-addr=%p",
1468 stream
, bt_ctf_stream_get_name(stream
),
1475 bt_put(stream
->packet_header
);
1476 stream
->packet_header
= bt_get(field
);
1477 BT_LOGV("Set stream's packet header field: "
1478 "stream-addr=%p, stream-name=\"%s\", "
1479 "packet-header-field-addr=%p",
1480 stream
, bt_ctf_stream_get_name(stream
), field
);
1488 void reset_structure_field(struct bt_ctf_field
*structure
, const char *name
)
1490 struct bt_ctf_field
*member
;
1492 member
= bt_ctf_field_structure_get_field(structure
, name
);
1494 (void) bt_ctf_field_reset(member
);
1499 int bt_ctf_stream_flush(struct bt_ctf_stream
*stream
)
1503 struct bt_ctf_stream_pos packet_context_pos
;
1504 struct bt_ctf_trace
*trace
;
1505 enum bt_ctf_byte_order native_byte_order
;
1506 bool has_packet_size
= false;
1509 BT_LOGW_STR("Invalid parameter: stream is NULL.");
1514 if (stream
->pos
.fd
< 0) {
1515 BT_LOGW_STR("Invalid parameter: stream is not a CTF writer stream.");
1520 if (stream
->packet_context
) {
1521 struct bt_ctf_field
*packet_size_field
;
1523 packet_size_field
= bt_ctf_field_structure_get_field(
1524 stream
->packet_context
, "packet_size");
1525 has_packet_size
= (packet_size_field
!= NULL
);
1526 bt_put(packet_size_field
);
1529 if (stream
->flushed_packet_count
== 1) {
1530 if (!stream
->packet_context
) {
1531 BT_LOGW_STR("Cannot flush a stream which has no packet context field more than once.");
1536 if (!has_packet_size
) {
1537 BT_LOGW_STR("Cannot flush a stream which has no packet context's `packet_size` field more than once.");
1543 BT_LOGV("Flushing stream's current packet: stream-addr=%p, "
1544 "stream-name=\"%s\", packet-index=%u", stream
,
1545 bt_ctf_stream_get_name(stream
), stream
->flushed_packet_count
);
1546 trace
= bt_ctf_stream_class_borrow_trace(stream
->stream_class
);
1548 native_byte_order
= bt_ctf_trace_get_native_byte_order(trace
);
1550 ret
= auto_populate_packet_header(stream
);
1552 BT_LOGW_STR("Cannot automatically populate the stream's packet header field.");
1557 ret
= auto_populate_packet_context(stream
);
1559 BT_LOGW_STR("Cannot automatically populate the stream's packet context field.");
1564 /* mmap the next packet */
1565 BT_LOGV("Seeking to the next packet: pos-offset=%" PRId64
,
1566 stream
->pos
.offset
);
1567 bt_ctf_stream_pos_packet_seek(&stream
->pos
, 0, SEEK_CUR
);
1568 assert(stream
->pos
.packet_size
% 8 == 0);
1570 if (stream
->packet_header
) {
1571 BT_LOGV_STR("Serializing packet header field.");
1572 ret
= bt_ctf_field_serialize(stream
->packet_header
, &stream
->pos
,
1575 BT_LOGW("Cannot serialize stream's packet header field: "
1576 "field-addr=%p", stream
->packet_header
);
1581 if (stream
->packet_context
) {
1582 /* Write packet context */
1583 memcpy(&packet_context_pos
, &stream
->pos
,
1584 sizeof(packet_context_pos
));
1585 BT_LOGV_STR("Serializing packet context field.");
1586 ret
= bt_ctf_field_serialize(stream
->packet_context
,
1587 &stream
->pos
, native_byte_order
);
1589 BT_LOGW("Cannot serialize stream's packet context field: "
1590 "field-addr=%p", stream
->packet_context
);
1595 BT_LOGV("Serializing events: count=%u", stream
->events
->len
);
1597 for (i
= 0; i
< stream
->events
->len
; i
++) {
1598 struct bt_ctf_event
*event
= g_ptr_array_index(
1600 struct bt_ctf_event_class
*event_class
=
1601 bt_ctf_event_borrow_event_class(event
);
1603 BT_LOGV("Serializing event: index=%zu, event-addr=%p, "
1604 "event-class-name=\"%s\", event-class-id=%" PRId64
", "
1605 "pos-offset=%" PRId64
", packet-size=%" PRIu64
,
1606 i
, event
, bt_ctf_event_class_get_name(event_class
),
1607 bt_ctf_event_class_get_id(event_class
),
1608 stream
->pos
.offset
, stream
->pos
.packet_size
);
1610 /* Write event header */
1611 if (event
->event_header
) {
1612 BT_LOGV_STR("Serializing event's header field.");
1613 ret
= bt_ctf_field_serialize(event
->event_header
,
1614 &stream
->pos
, native_byte_order
);
1616 BT_LOGW("Cannot serialize event's header field: "
1617 "field-addr=%p", event
->event_header
);
1622 /* Write stream event context */
1623 if (event
->stream_event_context
) {
1624 BT_LOGV_STR("Serializing event's stream event context field.");
1625 ret
= bt_ctf_field_serialize(
1626 event
->stream_event_context
, &stream
->pos
,
1629 BT_LOGW("Cannot serialize event's stream event context field: "
1630 "field-addr=%p", event
->stream_event_context
);
1635 /* Write event content */
1636 ret
= bt_ctf_event_serialize(event
, &stream
->pos
,
1639 /* bt_ctf_event_serialize() logs errors */
1644 if (!has_packet_size
&& stream
->pos
.offset
% 8 != 0) {
1645 BT_LOGW("Stream's packet context field type has no `packet_size` field, "
1646 "but current content size is not a multiple of 8 bits: "
1647 "content-size=%" PRId64
", "
1648 "packet-size=%" PRIu64
,
1650 stream
->pos
.packet_size
);
1655 assert(stream
->pos
.packet_size
% 8 == 0);
1658 * Remove extra padding bytes.
1660 stream
->pos
.packet_size
= (stream
->pos
.offset
+ 7) & ~7;
1662 if (stream
->packet_context
) {
1664 * The whole packet is serialized at this point. Make sure that,
1665 * if `packet_size` is missing, the current content size is
1666 * equal to the current packet size.
1668 struct bt_ctf_field
*field
= bt_ctf_field_structure_get_field(
1669 stream
->packet_context
, "content_size");
1673 if (stream
->pos
.offset
!= stream
->pos
.packet_size
) {
1674 BT_LOGW("Stream's packet context's `content_size` field is missing, "
1675 "but current packet's content size is not equal to its packet size: "
1676 "content-size=%" PRId64
", "
1677 "packet-size=%" PRIu64
,
1679 stream
->pos
.packet_size
);
1686 * Overwrite the packet context now that the stream
1687 * position's packet and content sizes have the correct
1690 * Copy base_mma as the packet may have been remapped
1691 * (e.g. when a packet is resized).
1693 packet_context_pos
.base_mma
= stream
->pos
.base_mma
;
1694 ret
= auto_populate_packet_context(stream
);
1696 BT_LOGW_STR("Cannot automatically populate the stream's packet context field.");
1701 BT_LOGV("Rewriting (serializing) packet context field.");
1702 ret
= bt_ctf_field_serialize(stream
->packet_context
,
1703 &packet_context_pos
, native_byte_order
);
1705 BT_LOGW("Cannot serialize stream's packet context field: "
1706 "field-addr=%p", stream
->packet_context
);
1711 g_ptr_array_set_size(stream
->events
, 0);
1712 stream
->flushed_packet_count
++;
1713 stream
->size
+= stream
->pos
.packet_size
/ CHAR_BIT
;
1716 ret
= ftruncate(stream
->pos
.fd
, stream
->size
);
1717 } while (ret
== -1 && errno
== EINTR
);
1719 BT_LOGE_ERRNO("Cannot truncate stream file to new size",
1720 ": size=%" PRIu64
", stream-addr=%p, "
1721 "stream-name=\"%s\"",
1722 stream
->size
, stream
,
1723 bt_ctf_stream_get_name(stream
));
1727 /* Reset automatically-set fields. */
1728 if (stream
->packet_context
) {
1729 reset_structure_field(stream
->packet_context
, "timestamp_begin");
1730 reset_structure_field(stream
->packet_context
, "timestamp_end");
1731 reset_structure_field(stream
->packet_context
, "packet_size");
1732 reset_structure_field(stream
->packet_context
, "content_size");
1733 reset_structure_field(stream
->packet_context
, "events_discarded");
1738 * We failed to write the packet. Its size is therefore set to 0
1739 * to ensure the next mapping is done in the same place rather
1740 * than advancing by "stream->pos.packet_size", which would
1741 * leave a corrupted packet in the trace.
1743 stream
->pos
.packet_size
= 0;
1745 BT_LOGV("Flushed stream's current packet: content-size=%" PRId64
", "
1746 "packet-size=%" PRIu64
,
1747 stream
->pos
.offset
, stream
->pos
.packet_size
);
1752 /* Pre-2.0 CTF writer backward compatibility */
1753 void bt_ctf_stream_get(struct bt_ctf_stream
*stream
)
1758 /* Pre-2.0 CTF writer backward compatibility */
1759 void bt_ctf_stream_put(struct bt_ctf_stream
*stream
)
1765 void bt_ctf_stream_destroy(struct bt_object
*obj
)
1767 struct bt_ctf_stream
*stream
;
1770 stream
= container_of(obj
, struct bt_ctf_stream
, base
);
1771 BT_LOGD("Destroying stream object: addr=%p, name=\"%s\"",
1772 stream
, bt_ctf_stream_get_name(stream
));
1774 /* Call destroy listeners in reverse registration order */
1775 for (i
= stream
->destroy_listeners
->len
- 1; i
>= 0; i
--) {
1776 struct bt_ctf_stream_destroy_listener
*listener
=
1777 &g_array_index(stream
->destroy_listeners
,
1778 struct bt_ctf_stream_destroy_listener
, i
);
1780 BT_LOGD("Calling destroy listener: func=%p, data=%p, index=%d",
1781 listener
->func
, listener
->data
, i
);
1782 listener
->func(stream
, listener
->data
);
1785 (void) bt_ctf_stream_pos_fini(&stream
->pos
);
1786 if (stream
->pos
.fd
>= 0) {
1790 * Truncate the file's size to the minimum required to fit the
1791 * last packet as we might have grown it too much on the last
1795 ret
= ftruncate(stream
->pos
.fd
, stream
->size
);
1796 } while (ret
== -1 && errno
== EINTR
);
1798 BT_LOGE("Failed to truncate stream file: %s: "
1799 "ret=%d, errno=%d, size=%" PRIu64
,
1800 strerror(errno
), ret
, errno
,
1801 (uint64_t) stream
->size
);
1804 if (close(stream
->pos
.fd
)) {
1805 BT_LOGE("Failed to close stream file: %s: "
1806 "ret=%d, errno=%d", strerror(errno
),
1811 if (stream
->events
) {
1812 BT_LOGD_STR("Putting events.");
1813 g_ptr_array_free(stream
->events
, TRUE
);
1817 g_string_free(stream
->name
, TRUE
);
1820 if (stream
->comp_cur_port
) {
1821 GHashTableIter ht_iter
;
1822 gpointer comp_gptr
, port_gptr
;
1825 * Since we're destroying the stream, remove the destroy
1826 * listeners that it registered for each component in
1827 * its component-port mapping hash table. Otherwise they
1828 * would be called and the stream would be accessed once
1829 * it's freed or another stream would be accessed.
1831 g_hash_table_iter_init(&ht_iter
, stream
->comp_cur_port
);
1833 while (g_hash_table_iter_next(&ht_iter
, &comp_gptr
, &port_gptr
)) {
1835 bt_component_remove_destroy_listener((void *) comp_gptr
,
1836 component_destroy_listener
, stream
);
1839 g_hash_table_destroy(stream
->comp_cur_port
);
1842 if (stream
->destroy_listeners
) {
1843 g_array_free(stream
->destroy_listeners
, TRUE
);
1846 BT_LOGD_STR("Putting packet header field.");
1847 bt_put(stream
->packet_header
);
1848 BT_LOGD_STR("Putting packet context field.");
1849 bt_put(stream
->packet_context
);
1854 int _set_structure_field_integer(struct bt_ctf_field
*structure
, char *name
,
1855 uint64_t value
, bt_bool force
)
1858 struct bt_ctf_field_type
*field_type
= NULL
;
1859 struct bt_ctf_field
*integer
;
1864 integer
= bt_ctf_field_structure_get_field(structure
, name
);
1866 /* Field not found, not an error. */
1867 BT_LOGV("Field not found: struct-field-addr=%p, "
1868 "name=\"%s\", force=%d", structure
, name
, force
);
1872 /* Make sure the payload has not already been set. */
1873 if (!force
&& bt_ctf_field_is_set(integer
)) {
1874 /* Payload already set, not an error */
1875 BT_LOGV("Field's payload is already set: struct-field-addr=%p, "
1876 "name=\"%s\", force=%d", structure
, name
, force
);
1880 field_type
= bt_ctf_field_get_type(integer
);
1882 if (bt_ctf_field_type_get_type_id(field_type
) != BT_CTF_FIELD_TYPE_ID_INTEGER
) {
1884 * The user most likely meant for us to populate this field
1885 * automatically. However, we can only do this if the field
1886 * is an integer. Return an error.
1888 BT_LOGW("Invalid parameter: field's type is not an integer field type: "
1889 "field-addr=%p, ft-addr=%p, ft-id=%s",
1890 integer
, field_type
,
1891 bt_ctf_field_type_id_string(field_type
->id
));
1896 if (bt_ctf_field_type_integer_get_signed(field_type
)) {
1897 ret
= bt_ctf_field_signed_integer_set_value(integer
,
1900 ret
= bt_ctf_field_unsigned_integer_set_value(integer
, value
);
1902 ret
= !ret
? 1 : ret
;
1910 * Returns the following codes:
1911 * 1 if the field was found and set,
1912 * 0 if nothing was done (field not found, or was already set),
1913 * <0 if an error was encoutered
1916 int try_set_structure_field_integer(struct bt_ctf_field
*structure
, char *name
,
1919 return _set_structure_field_integer(structure
, name
, value
, BT_FALSE
);
1922 const char *bt_ctf_stream_get_name(struct bt_ctf_stream
*stream
)
1924 const char *name
= NULL
;
1927 BT_LOGW_STR("Invalid parameter: stream is NULL.");
1931 name
= stream
->name
? stream
->name
->str
: NULL
;
1937 int bt_ctf_stream_is_writer(struct bt_ctf_stream
*stream
)
1942 BT_LOGW_STR("Invalid parameter: stream is NULL.");
1946 ret
= (stream
->pos
.fd
>= 0);
1953 void bt_ctf_stream_map_component_to_port(struct bt_ctf_stream
*stream
,
1954 struct bt_component
*comp
,
1955 struct bt_port
*port
)
1960 assert(stream
->comp_cur_port
);
1963 * Do not take a reference to the component here because we
1964 * don't want the component to exist as long as this stream
1965 * exists. Instead, keep a weak reference, but add a destroy
1966 * listener so that we remove this hash table entry when we know
1967 * the component is destroyed.
1969 BT_LOGV("Adding component's destroy listener for stream: "
1970 "stream-addr=%p, stream-name=\"%s\", comp-addr=%p, "
1971 "comp-name=\"%s\", port-addr=%p, port-name=\"%s\"",
1972 stream
, bt_ctf_stream_get_name(stream
),
1973 comp
, bt_component_get_name(comp
), port
,
1974 bt_port_get_name(port
));
1975 bt_component_add_destroy_listener(comp
, component_destroy_listener
,
1977 g_hash_table_insert(stream
->comp_cur_port
, comp
, port
);
1978 BT_LOGV_STR("Mapped component to port for stream.");
1982 struct bt_port
*bt_ctf_stream_port_for_component(struct bt_ctf_stream
*stream
,
1983 struct bt_component
*comp
)
1987 assert(stream
->comp_cur_port
);
1988 return g_hash_table_lookup(stream
->comp_cur_port
, comp
);
1992 void bt_ctf_stream_add_destroy_listener(struct bt_ctf_stream
*stream
,
1993 bt_ctf_stream_destroy_listener_func func
, void *data
)
1995 struct bt_ctf_stream_destroy_listener listener
;
1999 listener
.func
= func
;
2000 listener
.data
= data
;
2001 g_array_append_val(stream
->destroy_listeners
, listener
);
2002 BT_LOGV("Added stream destroy listener: stream-addr=%p, "
2003 "stream-name=\"%s\", func=%p, data=%p",
2004 stream
, bt_ctf_stream_get_name(stream
), func
, data
);
2008 void bt_ctf_stream_remove_destroy_listener(struct bt_ctf_stream
*stream
,
2009 bt_ctf_stream_destroy_listener_func func
, void *data
)
2016 for (i
= 0; i
< stream
->destroy_listeners
->len
; i
++) {
2017 struct bt_ctf_stream_destroy_listener
*listener
=
2018 &g_array_index(stream
->destroy_listeners
,
2019 struct bt_ctf_stream_destroy_listener
, i
);
2021 if (listener
->func
== func
&& listener
->data
== data
) {
2022 g_array_remove_index(stream
->destroy_listeners
, i
);
2024 BT_LOGV("Removed stream destroy listener: stream-addr=%p, "
2025 "stream-name=\"%s\", func=%p, data=%p",
2026 stream
, bt_ctf_stream_get_name(stream
),
2032 int64_t bt_ctf_stream_get_id(struct bt_ctf_stream
*stream
)
2037 BT_LOGW_STR("Invalid parameter: stream is NULL.");
2044 BT_LOGV("Stream's ID is not set: addr=%p, name=\"%s\"",
2045 stream
, bt_ctf_stream_get_name(stream
));