1 /* This file is part of the Linux Trace Toolkit trace reading library
2 * Copyright (C) 2003-2004 Michel Dagenais
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License Version 2.1 as published by the Free Software Foundation.
8 * This library 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 GNU
11 * Lesser General Public License for more details.
13 * You should have received a copy of the GNU Lesser General Public
14 * License along with this library; if not, write to the
15 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
16 * Boston, MA 02111-1307, USA.
24 /* A trace is specified as a pathname to the directory containing all the
25 associated data (control tracefiles, per cpu tracefiles, event
28 When a trace is closed, all the associated facilities, types and fields
31 return value is NULL if there is an error when opening the trace.
35 LttTrace
*ltt_trace_open(const char *pathname
);
37 /* copy reopens a trace
39 * return value NULL if error while opening the trace
41 LttTrace
*ltt_trace_copy(LttTrace
*self
);
43 char * ltt_trace_name(LttTrace
*t
);
45 void ltt_trace_close(LttTrace
*t
);
48 LttSystemDescription
*ltt_trace_system_description(LttTrace
*t
);
51 /* Functions to discover the facilities in the trace. Once the number
52 of facilities is known, they may be accessed by position. Multiple
53 versions of a facility (same name, different checksum) have consecutive
56 unsigned ltt_trace_facility_number(LttTrace
*t
);
58 LttFacility
*ltt_trace_facility_get(LttTrace
*t
, unsigned i
);
60 LttFacility
* ltt_trace_facility_by_id(LttTrace
* trace
, unsigned id
);
62 /* Look for a facility by name. It returns the number of facilities found
63 and sets the position argument to the first found. Returning 0, the named
64 facility is unknown, returning 1, the named facility is at the specified
65 position, returning n, the facilities are from position to
68 unsigned ltt_trace_facility_find(LttTrace
*t
, char *name
, unsigned *position
);
71 /* Functions to discover all the event types in the trace */
73 unsigned ltt_trace_eventtype_number(LttTrace
*t
);
75 LttEventType
*ltt_trace_eventtype_get(LttTrace
*t
, unsigned i
);
78 /* There is one "per cpu" tracefile for each CPU, numbered from 0 to
79 the maximum number of CPU in the system. When the number of CPU installed
80 is less than the maximum, some positions are unused. There are also a
81 number of "control" tracefiles (facilities, interrupts...). */
83 unsigned ltt_trace_control_tracefile_number(LttTrace
*t
);
85 unsigned ltt_trace_per_cpu_tracefile_number(LttTrace
*t
);
88 /* It is possible to search for the tracefiles by name or by CPU tracefile
90 * The index within the tracefiles of the same type is returned if found
91 * and a negative value otherwise.
94 int ltt_trace_control_tracefile_find(LttTrace
*t
, const gchar
*name
);
96 int ltt_trace_per_cpu_tracefile_find(LttTrace
*t
, const gchar
*name
);
99 /* Get a specific tracefile */
101 LttTracefile
*ltt_trace_control_tracefile_get(LttTrace
*t
, unsigned i
);
103 LttTracefile
*ltt_trace_per_cpu_tracefile_get(LttTrace
*t
, unsigned i
);
106 /* Get the start time and end time of the trace */
108 void ltt_trace_time_span_get(LttTrace
*t
, LttTime
*start
, LttTime
*end
);
111 /* Get the name of a tracefile */
113 char *ltt_tracefile_name(LttTracefile
*tf
);
116 /* Get the number of blocks in the tracefile */
118 unsigned ltt_tracefile_block_number(LttTracefile
*tf
);
121 /* Seek to the first event of the trace with time larger or equal to time */
123 void ltt_tracefile_seek_time(LttTracefile
*t
, LttTime time
);
125 /* Seek to the first event with position equal or larger to ep */
127 void ltt_tracefile_seek_position(LttTracefile
*t
,
128 const LttEventPosition
*ep
);
130 /* Read the next event */
132 LttEvent
*ltt_tracefile_read(LttTracefile
*t
, LttEvent
*event
);
136 LttTracefile
* ltt_tracefile_open(LttTrace
*t
, char * tracefile_name
);
138 void ltt_tracefile_open_cpu(LttTrace
*t
, char * tracefile_name
);
140 gint
ltt_tracefile_open_control(LttTrace
*t
, char * control_name
);
143 /* obtain the time of an event */
145 LttTime
getEventTime(LttTracefile
* tf
);
148 /* get the data type size and endian type of the local machine */
150 void getDataEndianType(LttArchSize
* size
, LttArchEndian
* endian
);
152 /* get an integer number */
154 gint64
getIntNumber(int size1
, void *evD
);
157 /* get the node name of the system */
159 char * ltt_trace_system_description_node_name (LttSystemDescription
* s
);
162 /* get the domain name of the system */
164 char * ltt_trace_system_description_domain_name (LttSystemDescription
* s
);
167 /* get the description of the system */
169 char * ltt_trace_system_description_description (LttSystemDescription
* s
);
172 /* get the start time of the trace */
174 LttTime
ltt_trace_system_description_trace_start_time(LttSystemDescription
*s
);
176 /* copy tracefile info over another. Used for sync. */
177 LttTracefile
*ltt_tracefile_new();
178 void ltt_tracefile_destroy(LttTracefile
*tf
);
179 void ltt_tracefile_copy(LttTracefile
*dest
, const LttTracefile
*src
);
This page took 0.032557 seconds and 4 git commands to generate.