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., 59 Temple Place - Suite 330, Boston,
23 #include <lttv/state.h>
25 /* The statistics are for a complete time interval. These structures differ
26 from the system state since they relate to static components of the
27 system (all processes which existed instead of just the currently
30 The basic attributes tree to gather for several different execution modes
31 (e.g., user mode, syscall, irq), thereafter called the "events tree",
32 contains the following attributes: the number of events of each type,
33 the total number of events, the number of bytes written, the time spent
34 executing, waiting for a resource, waiting for a cpu, and possibly many
35 others. The name "facility-event_type" below is to be replaced
36 by specific event types (e.g., core-schedchange, code-syscall_entry...).
48 The events for several different execution modes are joined together to
49 form the "execution modes tree". The name "execution mode" is to be replaced
50 by "system call", "trap", "irq", "user mode" or "kernel thread".
51 The name "submode" is to be replaced by the specific system call, trap or
52 irq name. The "submode" is an empty string if none is applicable, which is
53 the case for "user mode" and "kernel thread".
55 An "events tree" for each "execution mode" contains the sum for all its
56 different submodes. An "events tree" in the "execution modes tree" contains
57 the sum for all its different execution modes.
69 Each trace set contains an "execution modes tree". While the traces
70 come from possibly different systems, which may differ in their system
71 calls..., most of the system calls will have the same name, even if their
72 actual internal numeric id differs. Categories such as cpu id and process
73 id are not kept since these are specific to each system. When several
74 traces are taken from the same system, these categories may make sense and
75 could eventually be considered.
77 Each trace contains a global "execution modes tree", one for each
78 cpu and process, and one for each process/cpu combination. The name
79 "cpu number" stands for the cpu identifier, and "process_id-start_time"
80 is a unique process identifier composed of the process id
81 (unique at any given time but which may be reused over time) concatenated
82 with the process start time. Each process has a "functions" tree which
83 contains each process'function address (when the information is available).
84 If not, only the 0x0 function will appear.
92 "process_id-start_time"/
109 All the events and derived values (cpu, elapsed and wait time) are
110 added during the trace analysis in the relevant
111 trace/processes/ * /cpu/ * /functions/ * /mode_types/ * /submodes/ *
112 "events tree". To achieve this efficiently, each tracefile context
113 contains a pointer to the current relevant "events tree" and "event_types"
116 Once all the events are processed, the total number of events is computed
118 trace/processes/ * /cpu/ * /functions/ * /mode_types/ * /submodes/ *.
119 Then, the "events tree" are summed for all submodes within each mode type
120 and for all mode types within a processes/ * /cpu/ * /functions/ *
121 "execution modes tree".
123 Then, the "execution modes trees" for all functions within a
124 trace/processes/ * /cpu for all cpu within a process, for all processes,
125 and for all traces are computed. Separately, the "execution modes tree" for
126 each function (over all cpus) for all processes, and for all traces are
127 summed in the trace/processes/ * /functions/ * subtree.
129 Finally, the "execution modes trees" for all cpu within a process,
130 for all processes, and for all traces are computed. Separately,
131 the "execution modes tree" for each cpu but for all processes within a
132 trace are summed in the trace / cpu / * subtrees.
137 /* The various statistics branch names are GQuarks. They are pre-computed for
138 easy and efficient access */
140 #define LTTV_PRIO_STATS_BEFORE_STATE LTTV_PRIO_STATE-5
141 #define LTTV_PRIO_STATS_AFTER_STATE LTTV_PRIO_STATE+5
145 LTTV_STATS_PROCESS_UNKNOWN
,
146 LTTV_STATS_PROCESSES
,
148 LTTV_STATS_MODE_TYPES
,
150 LTTV_STATS_FUNCTIONS
,
151 LTTV_STATS_EVENT_TYPES
,
153 LTTV_STATS_ELAPSED_TIME
,
155 LTTV_STATS_EVENTS_COUNT
,
156 LTTV_STATS_BEFORE_HOOKS
,
157 LTTV_STATS_AFTER_HOOKS
;
160 typedef struct _LttvTracesetStats LttvTracesetStats
;
161 typedef struct _LttvTracesetStatsClass LttvTracesetStatsClass
;
163 typedef struct _LttvTraceStats LttvTraceStats
;
164 typedef struct _LttvTraceStatsClass LttvTraceStatsClass
;
166 typedef struct _LttvTracefileStats LttvTracefileStats
;
167 typedef struct _LttvTracefileStatsClass LttvTracefileStatsClass
;
171 // Hook wrapper. call_data is a trace context.
172 gboolean
lttv_stats_hook_add_event_hooks(void *hook_data
, void *call_data
);
173 void lttv_stats_add_event_hooks(LttvTracesetStats
*self
);
175 // Hook wrapper. call_data is a trace context.
176 gboolean
lttv_stats_hook_remove_event_hooks(void *hook_data
, void *call_data
);
177 void lttv_stats_remove_event_hooks(LttvTracesetStats
*self
);
179 gboolean
lttv_stats_sum_traceset_hook(void *hook_data
, void *call_data
);
180 void lttv_stats_sum_traceset(LttvTracesetStats
*self
);
182 void lttv_stats_sum_trace(LttvTraceStats
*self
, LttvAttribute
*ts_stats
);
184 /* Reset all statistics containers */
185 void lttv_stats_reset(LttvTracesetStats
*self
);
188 /* The LttvTracesetStats, LttvTraceStats and LttvTracefileStats types
189 inherit from the corresponding State objects defined in state.h.. */
191 #define LTTV_TRACESET_STATS_TYPE (lttv_traceset_stats_get_type ())
192 #define LTTV_TRACESET_STATS(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), LTTV_TRACESET_STATS_TYPE, LttvTracesetStats))
193 #define LTTV_TRACESET_STATS_CLASS(vtable) (G_TYPE_CHECK_CLASS_CAST ((vtable), LTTV_TRACESET_STATS_TYPE, LttvTracesetStatsClass))
194 #define LTTV_IS_TRACESET_STATS(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), LTTV_TRACESET_STATS_TYPE))
195 #define LTTV_IS_TRACESET_STATS_CLASS(vtable) (G_TYPE_CHECK_CLASS_TYPE ((vtable), LTTV_TRACESET_STATS_TYPE))
196 #define LTTV_TRACESET_STATS_GET_CLASS(inst) (G_TYPE_INSTANCE_GET_CLASS ((inst), LTTV_TRACESET_STATS_TYPE, LttvTracesetStatsClass))
198 struct _LttvTracesetStats
{
199 LttvTracesetState parent
;
201 LttvAttribute
*stats
;
204 struct _LttvTracesetStatsClass
{
205 LttvTracesetStateClass parent
;
208 GType
lttv_traceset_stats_get_type (void);
211 #define LTTV_TRACE_STATS_TYPE (lttv_trace_stats_get_type ())
212 #define LTTV_TRACE_STATS(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), LTTV_TRACE_STATS_TYPE, LttvTraceStats))
213 #define LTTV_TRACE_STATS_CLASS(vtable) (G_TYPE_CHECK_CLASS_CAST ((vtable), LTTV_TRACE_STATS_TYPE, LttvTraceStatsClass))
214 #define LTTV_IS_TRACE_STATS(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), LTTV_TRACE_STATS_TYPE))
215 #define LTTV_IS_TRACE_STATS_CLASS(vtable) (G_TYPE_CHECK_CLASS_TYPE ((vtable), LTTV_TRACE_STATS_TYPE))
216 #define LTTV_TRACE_STATS_GET_CLASS(inst) (G_TYPE_INSTANCE_GET_CLASS ((inst), LTTV_TRACE_STATS_TYPE, LttvTraceStatsClass))
218 struct _LttvTraceStats
{
219 LttvTraceState parent
;
221 LttvAttribute
*stats
;
224 struct _LttvTraceStatsClass
{
225 LttvTraceStateClass parent
;
228 GType
lttv_trace_stats_get_type (void);
231 #define LTTV_TRACEFILE_STATS_TYPE (lttv_tracefile_stats_get_type ())
232 #define LTTV_TRACEFILE_STATS(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), LTTV_TRACEFILE_STATS_TYPE, LttvTracefileStats))
233 #define LTTV_TRACEFILE_STATS_CLASS(vtable) (G_TYPE_CHECK_CLASS_CAST ((vtable), LTTV_TRACEFILE_STATS_TYPE, LttvTracefileStatsClass))
234 #define LTTV_IS_TRACEFILE_STATS(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), LTTV_TRACEFILE_STATS_TYPE))
235 #define LTTV_IS_TRACEFILE_STATS_CLASS(vtable) (G_TYPE_CHECK_CLASS_TYPE ((vtable), LTTV_TRACEFILE_STATS_TYPE))
236 #define LTTV_TRACEFILE_STATS_GET_CLASS(inst) (G_TYPE_INSTANCE_GET_CLASS ((inst), LTTV_TRACEFILE_STATS_TYPE, LttvTracefileStatsClass))
238 struct _LttvTracefileStats
{
239 LttvTracefileState parent
;
241 LttvAttribute
*stats
;
242 LttvAttribute
*current_events_tree
;
243 LttvAttribute
*current_event_types_tree
;
246 struct _LttvTracefileStatsClass
{
247 LttvTracefileStateClass parent
;
250 GType
lttv_tracefile_stats_get_type (void);