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