X-Git-Url: http://git.liburcu.org/?a=blobdiff_plain;f=ltt%2Fbranches%2Fpoly%2Fltt%2Ftrace.h;h=0b63c9378aa6193eb966c44a1db97beb8818bf38;hb=6d0cdf22a0f14b0ebbff26a675547a6410899b33;hp=73adc0bffd0adae25032957e113e5c1ed970fe89;hpb=8959a0c85e48eda1a73038bb74708a01b1d0886d;p=lttv.git diff --git a/ltt/branches/poly/ltt/trace.h b/ltt/branches/poly/ltt/trace.h index 73adc0bf..0b63c937 100644 --- a/ltt/branches/poly/ltt/trace.h +++ b/ltt/branches/poly/ltt/trace.h @@ -1,5 +1,6 @@ /* This file is part of the Linux Trace Toolkit trace reading library * Copyright (C) 2003-2004 Michel Dagenais + * 2005 Mathieu Desnoyers * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public @@ -21,6 +22,9 @@ #include +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 +36,7 @@ */ -LttTrace *ltt_trace_open(const char *pathname); +LttTrace *ltt_trace_open(const gchar *pathname); /* copy reopens a trace * @@ -40,10 +44,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 +62,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,43 +74,27 @@ 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 tracefile - * name. - * 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, const gchar *name); - -int ltt_trace_per_cpu_tracefile_find(LttTrace *t, const gchar *name); - - -/* Get a specific tracefile */ +/* Get the start time and end time of the trace */ -LttTracefile *ltt_trace_control_tracefile_get(LttTrace *t, unsigned i); +void ltt_trace_time_span_get(LttTrace *t, LttTime *start, LttTime *end); -LttTracefile *ltt_trace_per_cpu_tracefile_get(LttTrace *t, unsigned i); +/* Get the name of a tracefile */ -/* Get the start time and end time of the trace */ +GQuark ltt_tracefile_name(const LttTracefile *tf); +GQuark ltt_tracefile_long_name(const LttTracefile *tf); -void ltt_trace_time_span_get(LttTrace *t, LttTime *start, LttTime *end); +/* get the cpu number of the tracefile */ +guint ltt_tracefile_cpu(LttTracefile *tf); -/* Get the name of a tracefile */ +/* For usertrace */ +guint ltt_tracefile_tid(LttTracefile *tf); +guint ltt_tracefile_pgid(LttTracefile *tf); +guint64 ltt_tracefile_creation(LttTracefile *tf); -char *ltt_tracefile_name(LttTracefile *tf); +LttTrace *ltt_tracefile_get_trace(LttTracefile *tf); /* Get the number of blocks in the tracefile */ @@ -120,58 +103,92 @@ 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, LttEvent *event); +int ltt_tracefile_read(LttTracefile *t); -/* open tracefile */ - -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); +/* 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 */ - -gint64 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 start time of the trace */ +/* get the NTP start time of the trace */ -LttTime ltt_trace_system_description_trace_start_time(LttSystemDescription *s); +LttTime ltt_trace_start_time(LttTrace *t); + +/* 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); + +LttTime ltt_interpolate_time_from_tsc(LttTracefile *tf, guint64 tsc); #endif // TRACE_H