ltt/branches/poly/include/lttv/processTrace.h

   1 #ifndef PROCESSTRACE_H
   2 #define PROCESSTRACE_H
   3
   4 #include <lttv/traceset.h>
   5 #include <lttv/attribute.h>
   6 #include <lttv/hook.h>
   7 #include <ltt/ltt.h>
   8
   9 /* This is the generic part of trace processing. All events within a
  10    certain time interval are accessed and processing hooks are called for
  11    each. The events are examined in monotonically increasing time to more
  12    closely follow the traced system behavior.
  13
  14    Hooks are called at several different places during the processing:
  15    before traceset, after traceset, check trace, before trace, after trace,
  16    check tracefile, before tracefile, after tracefile,
  17    check_event, before_event, before_event_by_id,
  18    after_event, after_event_by_id.
  19
  20    In each case the "check" hooks are called first to determine if further
  21    processing of the trace, tracefile or event is wanted. Then, the before
  22    hooks and the after hooks are called. The before hooks for a traceset
  23    are called before those for the contained traces, which are called before
  24    those for the contained tracefiles. The after hooks are called in reverse
  25    order. The event hooks are called after all the before_tracefile hooks
  26    and before all the after_tracefile hooks.
  27
  28    The hooks receive two arguments, the hook_data and call_data. The hook_data
  29    is specified when the hook is registered and typically links to the
  30    object registering the hook (e.g. a graphical events viewer). The call_data
  31    must contain all the context related to the call. The traceset hooks receive
  32    the LttvTracesetContext provided by the caller. The trace hooks receive
  33    the LttvTraceContext from the traces array in the LttvTracesetContext.
  34    The tracefile and event hooks receive the LttvTracefileContext from
  35    the tracefiles array in the LttvTraceContext. The LttEvent and LttTime
  36    fields in the tracefile context are set to the current event and current
  37    event time before calling the event hooks. No other context field is
  38    modified.
  39
  40    The contexts in the traces and tracefiles arrays must be allocated by
  41    the caller, either before the call or during the before hooks of the
  42    enclosing traceset or trace. The order in the traces array must
  43    correspond to the lttv_traceset_get function. The order in the tracefiles
  44    arrays must correspond to the ltt_trace_control_tracefile_get and
  45    ltt_trace_per_cpu_tracefile_get functions. The traceset, trace and
  46    tracefile contexts may be subtyped as needed. Indeed, both the contexts
  47    and the hooks are defined by the caller. */
  48
  49
  50 typedef struct _LttvTracesetContext LttvTracesetContext;
  51 typedef struct _LttvTracesetContextClass LttvTracesetContextClass;
  52
  53 typedef struct _LttvTraceContext LttvTraceContext;
  54 typedef struct _LttvTraceContextClass LttvTraceContextClass;
  55
  56 typedef struct _LttvTracefileContext LttvTracefileContext;
  57 typedef struct _LttvTracefileContextClass LttvTracefileContextClass;
  58
  59 #define LTTV_TRACESET_CONTEXT_TYPE  (lttv_traceset_context_get_type ())
  60 #define LTTV_TRACESET_CONTEXT(obj)  (G_TYPE_CHECK_INSTANCE_CAST ((obj), LTTV_TRACESET_CONTEXT_TYPE, LttvTracesetContext))
  61 #define LTTV_TRACESET_CONTEXT_CLASS(vtable)  (G_TYPE_CHECK_CLASS_CAST ((vtable), LTTV_TRACESET_CONTEXT_TYPE, LttvTracesetContextClass))
  62 #define LTTV_IS_TRACESET_CONTEXT(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), LTTV_TRACESET_CONTEXT_TYPE))
  63 #define LTTV_IS_TRACESET_CONTEXT_CLASS(vtable) (G_TYPE_CHECK_CLASS_TYPE ((vtable), LTTV_TRACESET_CONTEXT_TYPE))
  64 #define LTTV_TRACESET_CONTEXT_GET_CLASS(inst)  (G_TYPE_INSTANCE_GET_CLASS ((inst), LTTV_TRACESET_CONTEXT_TYPE, LttvTracesetContextClass))
  65
  66 struct _LttvTracesetContext {
  67   GObject parent;
  68
  69   LttvTraceset *ts;
  70   LttvHooks *before;
  71   LttvHooks *after;
  72   LttvTraceContext **traces;
  73   LttvAttribute *a;
  74   TimeInterval *Time_Span;
  75 };
  76
  77 struct _LttvTracesetContextClass {
  78   GObjectClass parent;
  79
  80   void (*init) (LttvTracesetContext *self, LttvTraceset *ts);
  81   void (*fini) (LttvTracesetContext *self);
  82   LttvTracesetContext* (*new_traceset_context) (LttvTracesetContext *self);
  83   LttvTraceContext* (*new_trace_context) (LttvTracesetContext *self);
  84   LttvTracefileContext* (*new_tracefile_context) (LttvTracesetContext *self);
  85 };
  86
  87 GType lttv_traceset_context_get_type (void);
  88
  89 void lttv_context_init(LttvTracesetContext *self, LttvTraceset *ts);
  90
  91 void lttv_context_fini(LttvTracesetContext *self);
  92
  93 LttvTracesetContext *
  94 lttv_context_new_traceset_context(LttvTracesetContext *self);
  95
  96 LttvTraceContext *
  97 lttv_context_new_trace_context(LttvTracesetContext *self);
  98
  99 LttvTracefileContext *
 100 lttv_context_new_tracefile_context(LttvTracesetContext *self);
 101
 102
 103 #define LTTV_TRACE_CONTEXT_TYPE  (lttv_trace_context_get_type ())
 104 #define LTTV_TRACE_CONTEXT(obj)  (G_TYPE_CHECK_INSTANCE_CAST ((obj), LTTV_TRACE_CONTEXT_TYPE, LttvTraceContext))
 105 #define LTTV_TRACE_CONTEXT_CLASS(vtable)  (G_TYPE_CHECK_CLASS_CAST ((vtable), LTTV_TRACE_CONTEXT_TYPE, LttvTraceContextClass))
 106 #define LTTV_IS_TRACE_CONTEXT(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), LTTV_TRACE_CONTEXT_TYPE))
 107 #define LTTV_IS_TRACE_CONTEXT_CLASS(vtable) (G_TYPE_CHECK_CLASS_TYPE ((vtable), LTTV_TRACE_CONTEXT_TYPE))
 108 #define LTTV_TRACE_CONTEXT_GET_CLASS(inst)  (G_TYPE_INSTANCE_GET_CLASS ((inst), LTTV_TRACE_CONTEXT_TYPE, LttvTraceContextClass))
 109
 110 struct _LttvTraceContext {
 111   GObject parent;
 112
 113   LttvTracesetContext *ts_context;
 114   guint index;                /* in ts_context->traces */
 115   LttTrace *t;
 116   LttvHooks *check;
 117   LttvHooks *before;
 118   LttvHooks *after;
 119   LttvTracefileContext **control_tracefiles;
 120   LttvTracefileContext **per_cpu_tracefiles;
 121   LttvAttribute *a;
 122 };
 123
 124 struct _LttvTraceContextClass {
 125   GObjectClass parent;
 126 };
 127
 128 GType lttv_trace_context_get_type (void);
 129
 130 #define LTTV_TRACEFILE_CONTEXT_TYPE  (lttv_tracefile_context_get_type ())
 131 #define LTTV_TRACEFILE_CONTEXT(obj)  (G_TYPE_CHECK_INSTANCE_CAST ((obj), LTTV_TRACEFILE_CONTEXT_TYPE, LttvTracefileContext))
 132 #define LTTV_TRACEFILE_CONTEXT_CLASS(vtable)  (G_TYPE_CHECK_CLASS_CAST ((vtable), LTTV_TRACEFILE_CONTEXT_TYPE, LttvTracefileContextClass))
 133 #define LTTV_IS_TRACEFILE_CONTEXT(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), LTTV_TRACEFILE_CONTEXT_TYPE))
 134 #define LTTV_IS_TRACEFILE_CONTEXT_CLASS(vtable) (G_TYPE_CHECK_CLASS_TYPE ((vtable), LTTV_TRACEFILE_CONTEXT_TYPE))
 135 #define LTTV_TRACEFILE_CONTEXT_GET_CLASS(inst)  (G_TYPE_INSTANCE_GET_CLASS ((inst), LTTV_TRACEFILE_CONTEXT_TYPE, LttvTracefileContextClass))
 136
 137 struct _LttvTracefileContext {
 138   GObject parent;
 139
 140   LttvTraceContext *t_context;
 141   gboolean control;
 142   guint index;                /* in ts_context->control/per_cpu_tracefiles */
 143   LttTracefile *tf;
 144   LttvHooks *check;
 145   LttvHooks *before;
 146   LttvHooks *after;
 147   LttEvent *e;
 148   LttvHooks *check_event;
 149   LttvHooks *before_event;
 150   LttvHooksById *before_event_by_id;
 151   LttvHooks *after_event;
 152   LttvHooksById *after_event_by_id;
 153   LttTime timestamp;
 154   LttvAttribute *a;
 155 };
 156
 157 struct _LttvTracefileContextClass {
 158   GObjectClass parent;
 159 };
 160
 161 GType lttv_tracefile_context_get_type (void);
 162
 163 void lttv_process_trace(LttTime start, LttTime end, LttvTraceset *traceset,
 164     LttvTracesetContext *context, unsigned maxNumEvents);
 165
 166 void lttv_traceset_context_add_hooks(LttvTracesetContext *self,
 167     LttvHooks *before_traceset,
 168     LttvHooks *after_traceset,
 169     LttvHooks *check_trace,
 170     LttvHooks *before_trace,
 171     LttvHooks *after_trace,
 172     LttvHooks *check_tracefile,
 173     LttvHooks *before_tracefile,
 174     LttvHooks *after_tracefile,
 175     LttvHooks *check_event,
 176     LttvHooks *before_event,
 177     LttvHooks *after_event);
 178
 179 void lttv_traceset_context_remove_hooks(LttvTracesetContext *self,
 180     LttvHooks *before_traceset,
 181     LttvHooks *after_traceset,
 182     LttvHooks *check_trace,
 183     LttvHooks *before_trace,
 184     LttvHooks *after_trace,
 185     LttvHooks *check_tracefile,
 186     LttvHooks *before_tracefile,
 187     LttvHooks *after_tracefile,
 188     LttvHooks *check_event,
 189     LttvHooks *before_event,
 190     LttvHooks *after_event);
 191
 192 typedef struct _LttvTraceHook {
 193   LttvHook h;
 194   guint id;
 195   LttField *f1;
 196   LttField *f2;
 197   LttField *f3;
 198 } LttvTraceHook;
 199
 200
 201 /* Search in the trace for the id of the named event type within the named
 202    facility. Then, find the three (if non null) named fields. All that
 203    information is then used to fill the LttvTraceHook structure. This
 204    is useful to find the specific id for an event within a trace, for
 205    registering a hook using this structure as event data;
 206    it already contains the (up to three) needed fields handles. */
 207
 208 void lttv_trace_find_hook(LttTrace *t, char *facility, char *event_type,
 209     char *field1, char *field2, char *field3, LttvHook h, LttvTraceHook *th);
 210
 211 #endif // PROCESSTRACE_H