4 /* A trace is a sequence of events gathered in the same tracing session. The
5 events may be stored in several tracefiles in the same directory.
6 A trace set is defined when several traces are to be analyzed together,
7 possibly to study the interactions between events in the different traces.
10 typedef struct _lttv_trace_set lttv_trace_set
;
12 typedef struct _lttv_trace lttv_trace
;
14 typedef struct _lttv_tracefile lttv_tracefile
;
17 /* Trace sets may be added to, removed from and their content listed. */
19 lttv_trace_set
*lttv_trace_set_new();
21 lttv_trace_set
*lttv_trace_set_destroy(lttv_trace_set
*s
);
23 void lttv_trace_set_add(lttv_trace_set
*s
, lttv_trace
*t
);
25 unsigned lttv_trace_set_number(lttv_trace_set
*s
);
27 lttv_trace
*lttv_trace_set_get(lttv_trace_set
*s
, unsigned i
);
29 lttv_trace
*lttv_trace_set_remove(lttv_trace_set
*s
, unsigned i
);
32 /* A trace is identified by the pathname of its containing directory */
34 lttv_trace
*lttv_trace_open(char *pathname
);
36 int lttv_trace_close(lttv_trace
*t
);
38 char *lttv_trace_name(lttv_trace
*t
);
41 /* A trace typically contains one tracefile with important events
42 (for all CPUs), and one tracefile with ordinary events per cpu.
43 The tracefiles in a trace may be enumerated for each category
44 (all cpu and per cpu). The total number of tracefiles and of CPUs
45 may also be obtained. */
47 unsigned int lttv_trace_tracefile_number(lttv_trace
*t
);
49 unsigned int lttv_trace_cpu_number(lttv_trace
*t
);
51 unsigned int lttv_trace_tracefile_number_per_cpu(lttv_trace
*t
);
53 unsigned int lttv_trace_tracefile_number_all_cpu(lttv_trace
*t
);
55 lttv_tracefile
*lttv_trace_tracefile_get_per_cpu(lttv_trace
*t
, unsigned i
);
57 lttv_tracefile
*lttv_trace_tracefile_get_all_cpu(lttv_trace
*t
, unsigned i
);
60 /* A set of attributes is attached to each trace set, trace and tracefile
61 to store user defined data as needed. */
63 lttv_attributes
*lttv_trace_set_attributes(lttv_trace_set
*s
);
65 lttv_attributes
*lttv_trace_attributes(lttv_trace
*t
);
67 lttv_attributes
*lttv_tracefile_attributes(lttv_tracefile
*tf
);
70 /* The underlying ltt_tracefile, from which events may be read, is accessible.
71 The tracefile name is also available. */
73 lttv_tracefile
*lttv_tracefile_ltt_tracefile(lttv_tracefile
*tf
);
75 char *lttv_tracefile_name(lttv_tracefile
*tf
);