roadmap update
[lttv.git] / ltt / branches / poly / ltt / trace.h
index 05ed31eb508bad3863b8cac1cddad9f348d906c4..2e8ec3a101871969c97f1f57cd27355e30c10cca 100644 (file)
@@ -21,6 +21,9 @@
 
 #include <ltt/ltt.h>
 
+extern GQuark LTT_FACILITY_NAME_HEARTBEAT,
+              LTT_EVENT_NAME_HEARTBEAT;
+
 /* A trace is specified as a pathname to the directory containing all the
    associated data (control tracefiles, per cpu tracefiles, event 
    descriptions...).
@@ -32,7 +35,7 @@
    
    */
 
-LttTrace *ltt_trace_open(const char *pathname);
+LttTrace *ltt_trace_open(const gchar *pathname);
 
 /* copy reopens a trace 
  *
@@ -40,10 +43,11 @@ LttTrace *ltt_trace_open(const char *pathname);
  */
 LttTrace *ltt_trace_copy(LttTrace *self);
 
-char * ltt_trace_name(LttTrace *t);
+GQuark ltt_trace_name(const LttTrace *t);
 
 void ltt_trace_close(LttTrace *t); 
 
+guint ltt_trace_get_num_cpu(LttTrace *t);
 
 LttSystemDescription *ltt_trace_system_description(LttTrace *t);
 
@@ -57,16 +61,10 @@ unsigned ltt_trace_facility_number(LttTrace *t);
 
 LttFacility *ltt_trace_facility_get(LttTrace *t, unsigned i);
 
-LttFacility * ltt_trace_facility_by_id(LttTrace * trace, unsigned id);
-
-/* Look for a facility by name. It returns the number of facilities found
-   and sets the position argument to the first found. Returning 0, the named
-   facility is unknown, returning 1, the named facility is at the specified
-   position, returning n, the facilities are from position to 
-   position + n - 1. */
-
-unsigned ltt_trace_facility_find(LttTrace *t, char *name, unsigned *position);
+LttFacility * ltt_trace_facility_by_id(LttTrace * trace, guint8 id);
 
+/* Returns an array of indexes (guint) that matches the facility name */
+GArray *ltt_trace_facility_get_by_name(LttTrace *t, GQuark name);
 
 /* Functions to discover all the event types in the trace */
 
@@ -75,32 +73,6 @@ unsigned ltt_trace_eventtype_number(LttTrace *t);
 LttEventType *ltt_trace_eventtype_get(LttTrace *t, unsigned i);
 
 
-/* There is one "per cpu" tracefile for each CPU, numbered from 0 to
-   the maximum number of CPU in the system. When the number of CPU installed
-   is less than the maximum, some positions are unused. There are also a
-   number of "control" tracefiles (facilities, interrupts...). */
-
-unsigned ltt_trace_control_tracefile_number(LttTrace *t);
-
-unsigned ltt_trace_per_cpu_tracefile_number(LttTrace *t);
-
-
-/* It is possible to search for the tracefiles by name or by CPU position.
-   The index within the tracefiles of the same type is returned if found
-   and a negative value otherwise. */
-
-int ltt_trace_control_tracefile_find(LttTrace *t, char *name);
-
-int ltt_trace_per_cpu_tracefile_find(LttTrace *t, unsigned i);
-
-
-/* Get a specific tracefile */
-
-LttTracefile *ltt_trace_control_tracefile_get(LttTrace *t, unsigned i);
-
-LttTracefile *ltt_trace_per_cpu_tracefile_get(LttTrace *t, unsigned i);
-
-
 /* Get the start time and end time of the trace */
 
 void ltt_trace_time_span_get(LttTrace *t, LttTime *start, LttTime *end);
@@ -108,8 +80,14 @@ void ltt_trace_time_span_get(LttTrace *t, LttTime *start, LttTime *end);
 
 /* Get the name of a tracefile */
 
-char *ltt_tracefile_name(LttTracefile *tf);
+GQuark ltt_tracefile_name(const LttTracefile *tf);
+GQuark ltt_tracefile_long_name(const LttTracefile *tf);
 
+/* get the cpu number of the tracefile */
+
+guint ltt_tracefile_num(LttTracefile *tf);
+
+LttTrace *ltt_tracefile_get_trace(LttTracefile *tf);
 
 /* Get the number of blocks in the tracefile */
 
@@ -118,63 +96,90 @@ unsigned ltt_tracefile_block_number(LttTracefile *tf);
 
 /* Seek to the first event of the trace with time larger or equal to time */
 
-void ltt_tracefile_seek_time(LttTracefile *t, LttTime time);
+int ltt_tracefile_seek_time(LttTracefile *t, LttTime time);
 
 /* Seek to the first event with position equal or larger to ep */
 
-void ltt_tracefile_seek_position(LttTracefile *t,
+int ltt_tracefile_seek_position(LttTracefile *t,
     const LttEventPosition *ep);
 
 /* Read the next event */
 
-LttEvent *ltt_tracefile_read(LttTracefile *t);
-
-/* open tracefile */
+int ltt_tracefile_read(LttTracefile *t);
 
-LttTracefile * ltt_tracefile_open(LttTrace *t, char * tracefile_name);
+/* ltt_tracefile_read cut down in pieces */
+int ltt_tracefile_read_seek(LttTracefile *t);
+int ltt_tracefile_read_update_event(LttTracefile *t);
+int ltt_tracefile_read_op(LttTracefile *t);
 
-void ltt_tracefile_open_cpu(LttTrace *t, char * tracefile_name);
+/* Get the current event of the tracefile : valid until the next read */
+LttEvent *ltt_tracefile_get_event(LttTracefile *tf);
 
-gint ltt_tracefile_open_control(LttTrace *t, char * control_name);
-
-
-/* obtain the time of an event */
-
-LttTime getEventTime(LttTracefile * tf);
+/* open tracefile */
 
+gint ltt_tracefile_open(LttTrace *t, gchar * fileName, LttTracefile *tf);
 
 /* get the data type size and endian type of the local machine */
 
 void getDataEndianType(LttArchSize * size, LttArchEndian * endian);
 
 /* get an integer number */
-
-int getIntNumber(int size1, void *evD);
-
+gint64 get_int(gboolean reverse_byte_order, gint size, void *data);
 
 /* get the node name of the system */
 
-char * ltt_trace_system_description_node_name (LttSystemDescription * s);
+gchar * ltt_trace_system_description_node_name (LttSystemDescription * s);
 
 
 /* get the domain name of the system */
 
-char * ltt_trace_system_description_domain_name (LttSystemDescription * s);
+gchar * ltt_trace_system_description_domain_name (LttSystemDescription * s);
 
 
 /* get the description of the system */
 
-char * ltt_trace_system_description_description (LttSystemDescription * s);
+gchar * ltt_trace_system_description_description (LttSystemDescription * s);
+
 
+/* get the NTP start time of the trace */
 
-/* get the start time of the trace */
+LttTime ltt_trace_start_time(LttTrace *t);
 
-LttTime ltt_trace_system_description_trace_start_time(LttSystemDescription *s);
+/* get the monotonic start time of the trace */
+
+LttTime ltt_trace_start_time_monotonic(LttTrace *t);
 
 /* copy tracefile info over another. Used for sync. */
 LttTracefile *ltt_tracefile_new();
 void ltt_tracefile_destroy(LttTracefile *tf);
 void ltt_tracefile_copy(LttTracefile *dest, const LttTracefile *src);
 
+void get_absolute_pathname(const gchar *pathname, gchar * abs_pathname);
+
+/* May return a NULL tracefile group */
+GData **ltt_trace_get_tracefiles_groups(LttTrace *trace);
+
+typedef void (*ForEachTraceFileFunc)(LttTracefile *tf, gpointer func_args);
+
+struct compute_tracefile_group_args {
+  ForEachTraceFileFunc func;
+  gpointer func_args;
+};
+
+
+void compute_tracefile_group(GQuark key_id,
+                             GArray *group,
+                             struct compute_tracefile_group_args *args);
+
+LttFacility *ltt_trace_get_facility_by_num(LttTrace *t, guint num);
+
+
+gint check_fields_compatibility(LttEventType *event_type1,
+    LttEventType *event_type2,
+    LttField *field1, LttField *field2);
+
+gint64 ltt_get_int(gboolean reverse_byte_order, gint size, void *data);
+
+guint64 ltt_get_uint(gboolean reverse_byte_order, gint size, void *data);
 
 #endif // TRACE_H
This page took 0.025648 seconds and 4 git commands to generate.