4 * Babeltrace Trace Converter Library
6 * Copyright 2010-2011 EfficiOS Inc. and Linux Foundation
8 * Author: Mathieu Desnoyers <mathieu.desnoyers@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.
25 #include <babeltrace/babeltrace-internal.h>
26 #include <babeltrace/format.h>
27 #include <babeltrace/ctf/types.h>
28 #include <babeltrace/ctf/metadata.h>
29 #include <babeltrace/ctf-text/types.h>
30 #include <babeltrace/prio_heap.h>
31 #include <babeltrace/babeltrace.h>
32 #include <babeltrace/types.h>
33 #include <babeltrace/ctf/types.h>
34 #include <babeltrace/ctf-ir/metadata.h>
37 int babeltrace_verbose
, babeltrace_debug
;
39 struct stream_saved_pos
{
41 * Use file_stream pointer to check if the trace collection we
42 * restore to match the one we saved from, for each stream.
44 struct ctf_file_stream
*file_stream
;
45 size_t cur_index
; /* current index in packet index */
46 ssize_t offset
; /* offset from base, in bits. EOF for end of file. */
49 struct babeltrace_saved_pos
{
50 struct trace_collection
*tc
;
51 GArray
*stream_saved_pos
; /* Contains struct stream_saved_pos */
55 int prio
; /* Callback order priority. Lower first. Dynamically assigned from dependency graph. */
58 struct bt_dependencies
*depends
;
59 struct bt_dependencies
*weak_depends
;
60 struct bt_dependencies
*provides
;
61 enum bt_cb_ret (*callback
)(struct bt_ctf_data
*ctf_data
,
65 struct bt_callback_chain
{
66 GArray
*callback
; /* Array of struct bt_callback, ordered by priority */
70 * per id callbacks need to be per stream class because event ID vs
71 * event name mapping can vary from stream to stream.
73 struct bt_stream_callbacks
{
74 GArray
*per_id_callbacks
; /* Array of struct bt_callback_chain */
78 * struct babeltrace_iter: data structure representing an iterator on a trace
81 struct babeltrace_iter
{
82 struct ptr_heap
*stream_heap
;
83 struct trace_collection
*tc
;
84 struct trace_collection_pos
*end_pos
;
85 GArray
*callbacks
; /* Array of struct bt_stream_callbacks */
86 struct bt_callback_chain main_callbacks
; /* For all events */
88 * Flag indicating if dependency graph needs to be recalculated.
89 * Set by babeltrace_iter_add_callback(), and checked (and
90 * cleared) by upon entry into babeltrace_iter_read_event().
91 * babeltrace_iter_read_event() is responsible for calling dep
92 * graph calculation if it sees this flag set.
94 int recalculate_dep_graph
;
96 * Array of pointers to struct bt_dependencies, for garbage
97 * collection. We're not using a linked list here because each
98 * struct bt_dependencies can belong to more than one
104 struct bt_dependencies
{
105 GArray
*deps
; /* Array of GQuarks */
106 int refcount
; /* free when decremented to 0 */
110 struct bt_dependencies
*_babeltrace_dependencies_create(const char *first
,
114 struct bt_dependencies
*dep
;
116 dep
= g_new0(struct bt_dependencies
, 1);
118 dep
->deps
= g_array_new(FALSE
, TRUE
, sizeof(GQuark
));
121 GQuark q
= g_quark_from_string(iter
);
122 g_array_append_val(dep
->deps
, q
);
123 iter
= va_arg(ap
, const char *);
128 struct bt_dependencies
*babeltrace_dependencies_create(const char *first
, ...)
131 struct bt_dependencies
*deps
;
134 deps
= _babeltrace_dependencies_create(first
, ap
);
140 * babeltrace_iter_add_callback: Add a callback to iterator.
142 int babeltrace_iter_add_callback(struct babeltrace_iter
*iter
,
143 bt_event_name event
, void *private_data
, int flags
,
144 enum bt_cb_ret (*callback
)(struct bt_ctf_data
*ctf_data
,
146 struct bt_dependencies
*depends
,
147 struct bt_dependencies
*weak_depends
,
148 struct bt_dependencies
*provides
)
151 gpointer
*event_id_ptr
;
152 unsigned long event_id
;
153 struct trace_collection
*tc
= iter
->tc
;
155 for (i
= 0; i
< tc
->array
->len
; i
++) {
156 struct ctf_trace
*tin
;
157 struct trace_descriptor
*td_read
;
159 td_read
= g_ptr_array_index(tc
->array
, i
);
160 tin
= container_of(td_read
, struct ctf_trace
, parent
);
162 for (stream_id
= 0; stream_id
< tin
->streams
->len
; stream_id
++) {
163 struct ctf_stream_class
*stream
;
164 struct bt_stream_callbacks
*bt_stream_cb
= NULL
;
165 struct bt_callback_chain
*bt_chain
= NULL
;
166 struct bt_callback new_callback
;
168 stream
= g_ptr_array_index(tin
->streams
, stream_id
);
170 if (stream_id
>= iter
->callbacks
->len
) {
171 g_array_set_size(iter
->callbacks
, stream
->stream_id
+ 1);
173 bt_stream_cb
= &g_array_index(iter
->callbacks
,
174 struct bt_stream_callbacks
, stream
->stream_id
);
175 if (!bt_stream_cb
->per_id_callbacks
) {
176 bt_stream_cb
->per_id_callbacks
= g_array_new(FALSE
, TRUE
,
177 sizeof(struct bt_callback_chain
));
181 /* find the event id */
182 event_id_ptr
= g_hash_table_lookup(stream
->event_quark_to_id
,
183 (gconstpointer
) (unsigned long) event
);
184 /* event not found in this stream class */
186 printf("event not found\n");
189 event_id
= (uint64_t)(unsigned long) *event_id_ptr
;
191 /* find or create the bt_callback_chain for this event */
192 if (event_id
>= bt_stream_cb
->per_id_callbacks
->len
) {
193 g_array_set_size(bt_stream_cb
->per_id_callbacks
, event_id
+ 1);
195 bt_chain
= &g_array_index(bt_stream_cb
->per_id_callbacks
,
196 struct bt_callback_chain
, event_id
);
197 if (!bt_chain
->callback
) {
198 bt_chain
->callback
= g_array_new(FALSE
, TRUE
,
199 sizeof(struct bt_callback
));
202 /* callback for all events */
203 if (!iter
->main_callbacks
.callback
) {
204 iter
->main_callbacks
.callback
= g_array_new(FALSE
, TRUE
,
205 sizeof(struct bt_callback
));
207 bt_chain
= &iter
->main_callbacks
;
210 new_callback
.private_data
= private_data
;
211 new_callback
.flags
= flags
;
212 new_callback
.callback
= callback
;
213 new_callback
.depends
= depends
;
214 new_callback
.weak_depends
= weak_depends
;
215 new_callback
.provides
= provides
;
217 /* TODO : take care of priority, for now just FIFO */
218 g_array_append_val(bt_chain
->callback
, new_callback
);
225 static int stream_read_event(struct ctf_file_stream
*sin
)
229 ret
= sin
->pos
.parent
.event_cb(&sin
->pos
.parent
, &sin
->parent
);
233 fprintf(stdout
, "[error] Reading event failed.\n");
240 * returns true if a < b, false otherwise.
242 int stream_compare(void *a
, void *b
)
244 struct ctf_file_stream
*s_a
= a
, *s_b
= b
;
246 if (s_a
->parent
.timestamp
< s_b
->parent
.timestamp
)
253 * babeltrace_filestream_seek: seek a filestream to given position.
255 * The stream_id parameter is only useful for BT_SEEK_RESTORE.
257 static int babeltrace_filestream_seek(struct ctf_file_stream
*file_stream
,
258 const struct trace_collection_pos
*begin_pos
,
259 unsigned long stream_id
)
263 switch (begin_pos
->type
) {
266 * just insert into the heap we should already know
271 file_stream
->pos
.move_pos_slow(&file_stream
->pos
, 0, SEEK_SET
);
272 ret
= stream_read_event(file_stream
);
275 case BT_SEEK_RESTORE
:
278 assert(0); /* Not yet defined */
285 * babeltrace_iter_seek: seek iterator to given position.
287 int babeltrace_iter_seek(struct babeltrace_iter
*iter
,
288 const struct trace_collection_pos
*begin_pos
)
292 struct trace_collection
*tc
= iter
->tc
;
294 for (i
= 0; i
< tc
->array
->len
; i
++) {
295 struct ctf_trace
*tin
;
296 struct trace_descriptor
*td_read
;
298 td_read
= g_ptr_array_index(tc
->array
, i
);
299 tin
= container_of(td_read
, struct ctf_trace
, parent
);
301 /* Populate heap with each stream */
302 for (stream_id
= 0; stream_id
< tin
->streams
->len
;
304 struct ctf_stream_class
*stream
;
307 stream
= g_ptr_array_index(tin
->streams
, stream_id
);
308 for (filenr
= 0; filenr
< stream
->streams
->len
;
310 struct ctf_file_stream
*file_stream
;
312 file_stream
= g_ptr_array_index(stream
->streams
,
314 ret
= babeltrace_filestream_seek(file_stream
, begin_pos
,
325 struct babeltrace_iter
*babeltrace_iter_create(struct trace_collection
*tc
,
326 struct trace_collection_pos
*begin_pos
,
327 struct trace_collection_pos
*end_pos
)
331 struct babeltrace_iter
*iter
;
333 iter
= malloc(sizeof(struct babeltrace_iter
));
336 iter
->stream_heap
= g_new(struct ptr_heap
, 1);
338 iter
->end_pos
= end_pos
;
339 iter
->callbacks
= g_array_new(0, 1, sizeof(struct bt_stream_callbacks
));
340 iter
->recalculate_dep_graph
= 0;
341 iter
->main_callbacks
.callback
= NULL
;
342 iter
->dep_gc
= g_ptr_array_new();
344 ret
= heap_init(iter
->stream_heap
, 0, stream_compare
);
346 goto error_heap_init
;
348 for (i
= 0; i
< tc
->array
->len
; i
++) {
349 struct ctf_trace
*tin
;
350 struct trace_descriptor
*td_read
;
352 td_read
= g_ptr_array_index(tc
->array
, i
);
353 tin
= container_of(td_read
, struct ctf_trace
, parent
);
355 /* Populate heap with each stream */
356 for (stream_id
= 0; stream_id
< tin
->streams
->len
;
358 struct ctf_stream_class
*stream
;
361 stream
= g_ptr_array_index(tin
->streams
, stream_id
);
364 for (filenr
= 0; filenr
< stream
->streams
->len
;
366 struct ctf_file_stream
*file_stream
;
368 file_stream
= g_ptr_array_index(stream
->streams
,
372 ret
= babeltrace_filestream_seek(file_stream
, begin_pos
,
382 ret
= heap_insert(iter
->stream_heap
, file_stream
);
392 heap_free(iter
->stream_heap
);
394 g_free(iter
->stream_heap
);
400 void babeltrace_iter_destroy(struct babeltrace_iter
*iter
)
402 struct bt_stream_callbacks
*bt_stream_cb
;
403 struct bt_callback_chain
*bt_chain
;
406 heap_free(iter
->stream_heap
);
407 g_free(iter
->stream_heap
);
409 /* free all events callbacks */
410 if (iter
->main_callbacks
.callback
)
411 g_array_free(iter
->main_callbacks
.callback
, TRUE
);
413 /* free per-event callbacks */
414 for (i
= 0; i
< iter
->callbacks
->len
; i
++) {
415 bt_stream_cb
= &g_array_index(iter
->callbacks
,
416 struct bt_stream_callbacks
, i
);
417 if (!bt_stream_cb
|| !bt_stream_cb
->per_id_callbacks
)
419 for (j
= 0; j
< bt_stream_cb
->per_id_callbacks
->len
; j
++) {
420 bt_chain
= &g_array_index(bt_stream_cb
->per_id_callbacks
,
421 struct bt_callback_chain
, j
);
422 if (bt_chain
->callback
) {
423 g_array_free(bt_chain
->callback
, TRUE
);
426 g_array_free(bt_stream_cb
->per_id_callbacks
, TRUE
);
432 int babeltrace_iter_next(struct babeltrace_iter
*iter
)
434 struct ctf_file_stream
*file_stream
, *removed
;
437 file_stream
= heap_maximum(iter
->stream_heap
);
439 /* end of file for all streams */
444 ret
= stream_read_event(file_stream
);
446 removed
= heap_remove(iter
->stream_heap
);
447 assert(removed
== file_stream
);
453 /* Reinsert the file stream into the heap, and rebalance. */
454 removed
= heap_replace_max(iter
->stream_heap
, file_stream
);
455 assert(removed
== file_stream
);
462 struct ctf_stream_event
*extract_ctf_stream_event(struct ctf_stream
*stream
)
464 struct ctf_stream_class
*stream_class
= stream
->stream_class
;
465 struct ctf_event
*event_class
;
466 struct ctf_stream_event
*event
;
467 uint64_t id
= stream
->event_id
;
469 if (id
>= stream_class
->events_by_id
->len
) {
470 fprintf(stdout
, "[error] Event id %" PRIu64
" is outside range.\n", id
);
473 event
= g_ptr_array_index(stream
->events_by_id
, id
);
475 fprintf(stdout
, "[error] Event id %" PRIu64
" is unknown.\n", id
);
478 event_class
= g_ptr_array_index(stream_class
->events_by_id
, id
);
480 fprintf(stdout
, "[error] Event id %" PRIu64
" is unknown.\n", id
);
488 void process_callbacks(struct babeltrace_iter
*iter
,
489 struct ctf_stream
*stream
)
491 struct bt_stream_callbacks
*bt_stream_cb
;
492 struct bt_callback_chain
*bt_chain
;
493 struct bt_callback
*cb
;
496 struct bt_ctf_data ctf_data
;
498 ctf_data
.event
= extract_ctf_stream_event(stream
);
499 ctf_data
.stream
= stream
;
501 /* process all events callback first */
502 if (iter
->main_callbacks
.callback
) {
503 for (i
= 0; i
< iter
->main_callbacks
.callback
->len
; i
++) {
504 cb
= &g_array_index(iter
->main_callbacks
.callback
, struct bt_callback
, i
);
507 ret
= cb
->callback(&ctf_data
, cb
->private_data
);
510 case BT_CB_ERROR_STOP
:
518 /* process per event callbacks */
519 bt_stream_cb
= &g_array_index(iter
->callbacks
,
520 struct bt_stream_callbacks
, stream
->stream_id
);
521 if (!bt_stream_cb
|| !bt_stream_cb
->per_id_callbacks
)
524 if (stream
->event_id
> bt_stream_cb
->per_id_callbacks
->len
)
526 bt_chain
= &g_array_index(bt_stream_cb
->per_id_callbacks
,
527 struct bt_callback_chain
, stream
->event_id
);
528 if (!bt_chain
|| !bt_chain
->callback
)
531 for (i
= 0; i
< bt_chain
->callback
->len
; i
++) {
532 cb
= &g_array_index(bt_chain
->callback
, struct bt_callback
, i
);
535 ret
= cb
->callback(&ctf_data
, cb
->private_data
);
538 case BT_CB_ERROR_STOP
:
549 int babeltrace_iter_read_event(struct babeltrace_iter
*iter
,
550 struct ctf_stream
**stream
,
551 struct ctf_stream_event
**event
)
553 struct ctf_file_stream
*file_stream
;
556 file_stream
= heap_maximum(iter
->stream_heap
);
558 /* end of file for all streams */
562 *stream
= &file_stream
->parent
;
563 *event
= g_ptr_array_index((*stream
)->events_by_id
, (*stream
)->event_id
);
565 if ((*stream
)->stream_id
> iter
->callbacks
->len
)
568 process_callbacks(iter
, *stream
);
574 int convert_trace(struct trace_descriptor
*td_write
,
575 struct trace_collection
*trace_collection_read
)
577 struct babeltrace_iter
*iter
;
578 struct ctf_stream
*stream
;
579 struct ctf_stream_event
*event
;
580 struct ctf_text_stream_pos
*sout
;
581 struct trace_collection_pos begin_pos
;
584 sout
= container_of(td_write
, struct ctf_text_stream_pos
,
587 begin_pos
.type
= BT_SEEK_BEGIN
;
588 iter
= babeltrace_iter_create(trace_collection_read
, &begin_pos
, NULL
);
589 while (babeltrace_iter_read_event(iter
, &stream
, &event
) == 0) {
590 ret
= sout
->parent
.event_cb(&sout
->parent
, stream
);
592 fprintf(stdout
, "[error] Writing event failed.\n");
595 ret
= babeltrace_iter_next(iter
);
600 babeltrace_iter_destroy(iter
);
605 void __attribute__((constructor
)) init_babeltrace_lib(void)
607 if (getenv("BABELTRACE_VERBOSE"))
608 babeltrace_verbose
= 1;
609 if (getenv("BABELTRACE_DEBUG"))
610 babeltrace_debug
= 1;