X-Git-Url: http://git.lttng.org./?a=blobdiff_plain;f=ltt%2Fbranches%2Fpoly%2Fltt%2Ftrace.h;h=f6f20ab667f51e763ecb0784cd1c232cf28ecc3e;hb=cc544c4d0506c9149185cedccc7a857034b5ac29;hp=ba66c33aa6669f54c6801035db25c543e9d8d959;hpb=2a74fbf4e7e641f94517b3e996c674291248bb1d;p=lttv.git diff --git a/ltt/branches/poly/ltt/trace.h b/ltt/branches/poly/ltt/trace.h index ba66c33a..f6f20ab6 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 @@ -20,6 +21,40 @@ #define TRACE_H #include +#include +#include + +struct LttTrace { + GQuark pathname; //the pathname of the trace + //LttSystemDescription * system_description;//system description + + guint num_cpu; + + guint32 arch_type; + guint32 arch_variant; + guint8 arch_size; + guint8 ltt_major_version; + guint8 ltt_minor_version; + guint8 flight_recorder; + guint32 freq_scale; + uint64_t start_freq; + uint64_t start_tsc; + uint64_t start_monotonic; + LttTime start_time; + LttTime start_time_from_tsc; + + GData *tracefiles; //tracefiles groups + /* Support for markers */ + GArray *markers; //indexed by marker ID + GHashTable *markers_hash; //indexed by name hash + GHashTable *markers_format_hash; //indexed by name hash +}; + + + +extern GQuark LTT_FACILITY_NAME_HEARTBEAT, + LTT_EVENT_NAME_HEARTBEAT, + LTT_EVENT_NAME_HEARTBEAT_FULL; /* A trace is specified as a pathname to the directory containing all the associated data (control tracefiles, per cpu tracefiles, event @@ -32,7 +67,7 @@ */ -LttTrace *ltt_trace_open(const char *pathname); +LttTrace *ltt_trace_open(const gchar *pathname); /* copy reopens a trace * @@ -40,10 +75,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); @@ -53,122 +89,138 @@ LttSystemDescription *ltt_trace_system_description(LttTrace *t); versions of a facility (same name, different checksum) have consecutive positions. */ -unsigned ltt_trace_facility_number(LttTrace *t); +//unsigned ltt_trace_facility_number(LttTrace *t); -LttFacility *ltt_trace_facility_get(LttTrace *t, unsigned i); +//LttFacility * ltt_trace_facility_by_id(LttTrace * trace, guint8 id); -LttFacility * ltt_trace_facility_by_id(LttTrace * trace, unsigned id); +/* Returns an array of indexes (guint) that matches the facility name */ +//GArray *ltt_trace_facility_get_by_name(LttTrace *t, GQuark name); -/* 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. */ +/* Functions to discover all the event types in the trace */ -unsigned ltt_trace_facility_find(LttTrace *t, char *name, unsigned *position); +//unsigned ltt_trace_eventtype_number(LttTrace *t); +//LttEventType *ltt_trace_eventtype_get(LttTrace *t, unsigned i); -/* Functions to discover all the event types in the trace */ -unsigned ltt_trace_eventtype_number(LttTrace *t); - -LttEventType *ltt_trace_eventtype_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); -/* 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); +/* Get the name of a tracefile */ -unsigned ltt_trace_per_cpu_tracefile_number(LttTrace *t); +GQuark ltt_tracefile_name(const LttTracefile *tf); +GQuark ltt_tracefile_long_name(const LttTracefile *tf); +/* get the cpu number of the tracefile */ -/* 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. */ +guint ltt_tracefile_cpu(LttTracefile *tf); -int ltt_trace_control_tracefile_find(LttTrace *t, char *name); +/* For usertrace */ +guint ltt_tracefile_tid(LttTracefile *tf); +guint ltt_tracefile_pgid(LttTracefile *tf); +guint64 ltt_tracefile_creation(LttTracefile *tf); -int ltt_trace_per_cpu_tracefile_find(LttTrace *t, unsigned i); +LttTrace *ltt_tracefile_get_trace(LttTracefile *tf); -/* Get a specific tracefile */ +/* Get the number of blocks in the tracefile */ -LttTracefile *ltt_trace_control_tracefile_get(LttTrace *t, unsigned i); +unsigned ltt_tracefile_block_number(LttTracefile *tf); -LttTracefile *ltt_trace_per_cpu_tracefile_get(LttTrace *t, unsigned i); +/* Seek to the first event of the trace with time larger or equal to time */ -/* Get the start time and end time of the trace */ +int ltt_tracefile_seek_time(LttTracefile *t, LttTime time); -void ltt_trace_time_span_get(LttTrace *t, LttTime *start, LttTime *end); +/* Seek to the first event with position equal or larger to ep */ +int ltt_tracefile_seek_position(LttTracefile *t, + const LttEventPosition *ep); -/* Get the name of a tracefile */ +/* Read the next event */ -char *ltt_tracefile_name(LttTracefile *tf); +int ltt_tracefile_read(LttTracefile *t); +/* 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); -/* Get the number of blocks in the tracefile */ +/* Get the current event of the tracefile : valid until the next read */ +LttEvent *ltt_tracefile_get_event(LttTracefile *tf); -unsigned ltt_tracefile_block_number(LttTracefile *tf); +/* open tracefile */ +gint ltt_tracefile_open(LttTrace *t, gchar * fileName, LttTracefile *tf); -/* Seek to the first event of the trace with time larger or equal to time */ +/* get the data type size and endian type of the local machine */ -void ltt_tracefile_seek_time(LttTracefile *t, LttTime time); +void getDataEndianType(LttArchSize * size, LttArchEndian * endian); -/* Seek to the first event with position equal or larger to ep */ +/* get an integer number */ +gint64 get_int(gboolean reverse_byte_order, gint size, void *data); -void ltt_tracefile_seek_position(LttTracefile *t, - const LttEventPosition *ep); +/* get the node name of the system */ -/* Read the next event */ +gchar * ltt_trace_system_description_node_name (LttSystemDescription * s); -LttEvent *ltt_tracefile_read(LttTracefile *t); -/* open tracefile */ +/* get the domain name of the system */ -LttTracefile * ltt_tracefile_open(LttTrace *t, char * tracefile_name); +gchar * ltt_trace_system_description_domain_name (LttSystemDescription * s); -void ltt_tracefile_open_cpu(LttTrace *t, char * tracefile_name); -gint ltt_tracefile_open_control(LttTrace *t, char * control_name); +/* get the description of the system */ +gchar * ltt_trace_system_description_description (LttSystemDescription * s); -/* obtain the time of an event */ -LttTime getEventTime(LttTracefile * tf); +/* get the NTP start time of the trace */ +LttTime ltt_trace_start_time(LttTrace *t); -/* get the data type size and endian type of the local machine */ +/* get the monotonic start time of the trace */ -void getDataEndianType(LttArchSize * size, LttArchEndian * endian); +LttTime ltt_trace_start_time_monotonic(LttTrace *t); -/* get an integer number */ +/* 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); -int getIntNumber(int size1, void *evD); +void get_absolute_pathname(const gchar *pathname, gchar * abs_pathname); +/* May return a NULL tracefile group */ +GData **ltt_trace_get_tracefiles_groups(LttTrace *trace); -/* get the node name of the system */ +typedef void (*ForEachTraceFileFunc)(LttTracefile *tf, gpointer func_args); -char * ltt_trace_system_description_node_name (LttSystemDescription * s); +struct compute_tracefile_group_args { + ForEachTraceFileFunc func; + gpointer func_args; +}; -/* get the domain name of the system */ +void compute_tracefile_group(GQuark key_id, + GArray *group, + struct compute_tracefile_group_args *args); -char * ltt_trace_system_description_domain_name (LttSystemDescription * s); +//LttFacility *ltt_trace_get_facility_by_num(LttTrace *t, guint num); -/* get the description of the system */ +//gint check_fields_compatibility(LttEventType *event_type1, +// LttEventType *event_type2, +// LttField *field1, LttField *field2); -char * ltt_trace_system_description_description (LttSystemDescription * s); +gint64 ltt_get_int(gboolean reverse_byte_order, gint size, void *data); +guint64 ltt_get_uint(gboolean reverse_byte_order, gint size, void *data); -/* get the start time of the trace */ +LttTime ltt_interpolate_time_from_tsc(LttTracefile *tf, guint64 tsc); -LttTime ltt_trace_system_description_trace_start_time(LttSystemDescription *s); +/* Set to enable event debugging output */ +void ltt_event_debug(int state); #endif // TRACE_H