1 /* This file is part of the Linux Trace Toolkit viewer
2 * Copyright (C) 2003-2004 Michel Dagenais
4 * This program is free software; you can redistribute it and/or modify
5 * it under the terms of the GNU General Public License Version 2 as
6 * published by the Free Software Foundation;
8 * This program is distributed in the hope that it will be useful,
9 * but WITHOUT ANY WARRANTY; without even the implied warranty of
10 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11 * GNU General Public License for more details.
13 * You should have received a copy of the GNU General Public License
14 * along with this program; if not, write to the Free Software
15 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
22 #include <lttv/attribute.h>
23 #include <lttv/hook.h>
24 #include <lttv/event.h>
25 #include <lttv/time.h>
26 #include <lttv/trace.h>
28 /* A traceset is a set of traces to be analyzed together. */
30 typedef struct _LttvTraceset LttvTraceset
;
32 typedef struct _LttvTracesetPosition LttvTracesetPosition
;
37 //TODO ybrosseau 2012-05-15 put these struct in the .c to make them opaque
38 struct _LttvTraceset
{
40 GPtrArray
*traces
; /* Array of pointers to LttvTrace */
41 struct bt_context
*context
;
43 LttvHooks
*event_hooks
;
44 struct bt_ctf_iter
*iter
;
45 GPtrArray
*state_trace_handle_index
;
46 gboolean has_precomputed_states
;
47 TimeInterval time_span
;
51 #define TRACE_NAME_SIZE 100
54 // Trace id for babeltrace
55 LttvTraceset
*traceset
; /* container traceset */
59 LttvTraceState
*state
;
60 char short_name
[TRACE_NAME_SIZE
];
64 /* In babeltrace, the position concept is an iterator. */
65 struct _LttvTracesetPosition
{
66 struct bt_ctf_iter
*iter
;
67 struct bt_iter_pos
*bt_pos
;
72 /* Tracesets may be added to, removed from and their content listed. */
74 LttvTraceset
*lttv_traceset_new(void);
76 char * lttv_traceset_name(LttvTraceset
* s
);
79 LttvTrace
*lttv_trace_new(LttTrace
*t
);
82 void get_absolute_pathname(const gchar
*pathname
, gchar
* abs_pathname
);
84 LttvTraceset
*lttv_traceset_copy(LttvTraceset
*s_orig
);
86 LttvTraceset
*lttv_traceset_load(const gchar
*filename
);
88 struct bt_context
*lttv_traceset_get_context(LttvTraceset
*s
);
92 gint
lttv_traceset_save(LttvTraceset
*s
);
94 void lttv_traceset_destroy(LttvTraceset
*s
);
96 LttvHooks
*lttv_traceset_get_hooks(LttvTraceset
*s
);
98 void lttv_traceset_add(LttvTraceset
*s
, LttvTrace
*t
);
101 * lttv_trace_create : Add all traces recursively to a traceset from a path
104 * ts is the traceset in which will be contained the traces
106 * trace_path is the path where to find a set of trace.
107 * Traverse the path recursively to add all traces within.
109 * return 0 on success or a negative integer on failure
111 int lttv_traceset_add_path(LttvTraceset
*ts
, char *path
);
113 unsigned lttv_traceset_number(LttvTraceset
*s
);
115 LttvTrace
*lttv_traceset_get(LttvTraceset
*s
, unsigned i
);
117 void lttv_traceset_remove(LttvTraceset
*s
, unsigned i
);
119 int lttv_traceset_get_trace_index_from_event(LttvEvent
*event
);
121 int lttv_traceset_get_trace_index_from_handle_id(LttvTraceset
*ts
, int handle_id
);
123 /* An attributes table is attached to the set and to each trace in the set. */
125 LttvAttribute
*lttv_traceset_attribute(LttvTraceset
*s
);
127 /* Take a position snapshot */
128 LttvTracesetPosition
*lttv_traceset_create_current_position(const LttvTraceset
*traceset
);
130 /* Destroy position snapshot */
131 void lttv_traceset_destroy_position(LttvTracesetPosition
*traceset_pos
);
133 void lttv_traceset_seek_to_position(const LttvTracesetPosition
*traceset_pos
);
135 guint
lttv_traceset_get_cpuid_from_event(LttvEvent
*event
);
136 /* Returns the minimum timestamp of the traces in the traceset */
137 guint64
lttv_traceset_get_timestamp_begin(LttvTraceset
*traceset
);
138 /* Returns the maximum timestamp of the traces in the traceset */
139 guint64
lttv_traceset_get_timestamp_end(LttvTraceset
*traceset
);
140 /* Return a TimeInterval from timestamp of the first event to the last event [experimentale]*/
141 TimeInterval
lttv_traceset_get_time_span_real(LttvTraceset
*ts
);
142 /* Returns a TimeInterval struct that represents the min and max of the traceset */
143 TimeInterval
lttv_traceset_get_time_span(LttvTraceset
*traceset
);
145 const char *lttv_traceset_get_name_from_event(LttvEvent
*event
);
147 LttvTracesetPosition
*lttv_traceset_create_time_position(LttvTraceset
*ts
, LttTime timestamp
);
149 guint64
lttv_traceset_position_get_timestamp(const LttvTracesetPosition
*pos
);
151 LttTime
lttv_traceset_position_get_time(const LttvTracesetPosition
*pos
);
153 LttTime
lttv_traceset_get_current_time(const LttvTraceset
*ts
);
155 int lttv_traceset_position_compare(const LttvTracesetPosition
*pos1
, const LttvTracesetPosition
*pos2
);
157 int lttv_traceset_position_time_compare(const LttvTracesetPosition
*pos1
,
158 const LttvTracesetPosition
*pos2
);
160 int lttv_traceset_position_compare_current(const LttvTraceset
*ts
,
161 const LttvTracesetPosition
*pos
);