1 /* This file is part of the Linux Trace Toolkit viewer
2 * Copyright (C) 2003-2004 Xiangxiu Yang
4 * This program is free software; you can redistribute it and/or modify
5 * it under the terms of the GNU General Public License Version 2 as
6 * published by the Free Software Foundation;
8 * This program 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
11 * GNU General Public License for more details.
13 * You should have received a copy of the GNU General Public License
14 * along with this program; if not, write to the Free Software
15 * Foundation, Inc., 59 Temple Place - Suite 330, Boston,
23 #include <sys/types.h>
29 #define max(a,b) ((a)>(b)?(a):(b))
33 #define LTT_MAGIC_NUMBER 0x00D6B7ED
34 #define LTT_REV_MAGIC_NUMBER 0xEDB7D600
36 #define NSEC_PER_USEC 1000
38 #define LTT_PACKED_STRUCT __attribute__ ((packed))
40 /* Hardcoded facilities */
41 #define LTT_FACILITY_CORE 0
44 #define LTT_GET_BO(t) ((t)->reverse_bo)
46 #define LTT_HAS_FLOAT(t) ((t)->float_word_order!=0)
47 #define LTT_GET_FLOAT_BO(t) \
48 (((t)->float_word_order==__BYTE_ORDER)?0:1)
50 /* Hardcoded core events */
51 enum ltt_core_events
{
52 LTT_EVENT_FACILITY_LOAD
,
53 LTT_EVENT_FACILITY_UNLOAD
,
55 LTT_EVENT_STATE_DUMP_FACILITY_LOAD
60 /* enumeration definition */
62 typedef enum _BuildinEvent
{
63 TRACE_FACILITY_LOAD
= 0,
64 TRACE_BLOCK_START
= 17,
66 TRACE_TIME_HEARTBEAT
= 19
70 /* structure definition */
72 typedef struct _FacilityLoad
{
76 } LTT_PACKED_STRUCT FacilityLoad
;
78 typedef struct _BlockStart
{
79 LttTime time
; //Time stamp of this block
80 LttCycleCount cycle_count
; //cycle count of the event
81 guint32 block_id
; //block id
82 } LTT_PACKED_STRUCT BlockStart
;
84 typedef struct _BlockEnd
{
85 LttTime time
; //Time stamp of this block
86 LttCycleCount cycle_count
; //cycle count of the event
87 guint32 block_id
; //block id
88 } LTT_PACKED_STRUCT BlockEnd
;
92 typedef guint8
uint8_t;
93 typedef guint16
uint16_t;
94 typedef guint32
uint32_t;
95 typedef guint64
uint64_t;
97 /* Hardcoded facility load event : this plus an preceding "name" string */
98 struct LttFacilityLoad
{
102 guint32 pointer_size
;
107 struct LttFacilityUnload
{
111 struct LttStateDumpFacilityLoad
{
115 guint32 pointer_size
;
120 typedef struct _TimeHeartbeat
{
121 LttTime time
; //Time stamp of this block
122 uint64_t cycle_count
; //cycle count of the event
123 } LTT_PACKED_STRUCT TimeHeartbeat
;
125 struct ltt_event_header_hb
{
127 unsigned char facility_id
;
128 unsigned char event_id
;
132 struct ltt_event_header_nohb
{
134 unsigned char facility_id
;
135 unsigned char event_id
;
140 /* Block and trace headers */
142 struct ltt_trace_header_any
{
143 uint32_t magic_number
;
145 uint32_t arch_variant
;
146 uint32_t float_word_order
;
148 uint8_t major_version
;
149 uint8_t minor_version
;
150 uint8_t flight_recorder
;
151 uint8_t has_heartbeat
;
152 uint8_t has_alignment
; /* Event header alignment */
157 /* For version 0.3 */
159 struct ltt_trace_header_0_3
{
160 uint32_t magic_number
;
162 uint32_t arch_variant
;
163 uint32_t float_word_order
;
165 uint8_t major_version
;
166 uint8_t minor_version
;
167 uint8_t flight_recorder
;
168 uint8_t has_heartbeat
;
169 uint8_t has_alignment
; /* Event header alignment */
173 /* For version 0.4 */
175 struct ltt_trace_header_0_4
{
176 uint32_t magic_number
;
178 uint32_t arch_variant
;
179 uint32_t float_word_order
;
181 uint8_t major_version
;
182 uint8_t minor_version
;
183 uint8_t flight_recorder
;
184 uint8_t has_heartbeat
;
185 uint8_t has_alignment
; /* Event header alignment */
189 uint64_t start_monotonic
;
190 struct timespec start_time
; // not portable
193 /* For version 0.5 */
195 struct ltt_trace_header_0_5
{
196 uint32_t magic_number
;
198 uint32_t arch_variant
;
199 uint32_t float_word_order
;
201 uint8_t major_version
;
202 uint8_t minor_version
;
203 uint8_t flight_recorder
;
204 uint8_t has_heartbeat
;
205 uint8_t has_alignment
; /* Event header alignment */
209 uint64_t start_monotonic
;
210 //struct timespec start_time; // not portable
211 uint64_t start_time_sec
;
212 uint64_t start_time_usec
;
216 struct ltt_block_start_header
{
218 //struct timeval timestamp;
219 uint64_t timestamp_sec
;
220 uint64_t timestamp_usec
;
221 uint64_t cycle_count
;
225 //struct timeval timestamp;
226 uint64_t timestamp_sec
;
227 uint64_t timestamp_usec
;
228 uint64_t cycle_count
;
231 uint32_t lost_size
; /* Size unused at the end of the buffer */
232 uint32_t buf_size
; /* The size of this sub-buffer */
233 struct ltt_trace_header_any trace
[0];
238 GQuark type_name
; //type name if it is a named type
239 GQuark element_name
; //elements name of the struct
242 LttTypeEnum type_class
; //which type
243 GQuark
* enum_strings
; //for enum labels
244 struct _LttType
** element_type
; //for array, sequence and struct
245 unsigned element_number
; //the number of elements
246 //for enum, array, sequence and structure
249 struct _LttEventType
{
252 guint index
; //id of the event type within the facility
253 LttFacility
* facility
; //the facility that contains the event type
254 LttField
* root_field
; //root field
257 /* Structure LttEvent and LttEventPosition must begin with the _exact_ same
258 * fields in the exact same order. LttEventPosition is a parent of LttEvent. */
261 /* Begin of LttEventPosition fields */
262 LttTracefile
*tracefile
;
267 uint64_t tsc
; /* Current timestamp counter */
269 /* End of LttEventPosition fields */
271 union { /* choice by trace has_tsc */
272 guint32 timestamp
; /* truncated timestamp */
276 unsigned char facility_id
; /* facility ID are never reused. */
277 unsigned char event_id
;
281 void * data
; //event data
283 guint event_size
; //event_size field of the header :
284 //used to verify data_size from facility.
286 int count
; //the number of overflow of cycle count
287 gint64 overflow_nsec
; //precalculated nsec for overflows
290 struct _LttEventPosition
{
291 LttTracefile
*tracefile
;
296 uint64_t tsc
; /* Current timestamp counter */
300 enum field_status
{ FIELD_UNKNOWN
, FIELD_VARIABLE
, FIELD_FIXED
};
303 //guint field_pos; //field position within its parent
304 LttType
* field_type
; //field type, if it is root field
305 //then it must be struct type
307 off_t offset_root
; //offset from the root, -1:uninitialized
308 enum field_status fixed_root
; //offset fixed according to the root
309 //-1:uninitialized, 0:unfixed, 1:fixed
310 off_t offset_parent
; //offset from the parent,-1:uninitialized
311 enum field_status fixed_parent
; //offset fixed according to its parent
312 //-1:uninitialized, 0:unfixed, 1:fixed
313 // void * base_address; //base address of the field ????
315 guint field_size
; // //>0: size of the field,
317 // //-1: uninitialize
318 enum field_status fixed_size
;
321 gint sequ_number_size
; //the size of unsigned used to save the
322 //number of elements in the sequence
324 gint element_size
; //the element size of the sequence
325 //int field_fixed; //0: field has string or sequence
326 //1: field has no string or sequenc
329 struct _LttField
* parent
;
330 struct _LttField
** child
; //for array, sequence, struct and union:
331 //list of fields, it may have only one
332 //field if the element is not a struct or
334 unsigned current_element
; //which element is currently processed
335 // Used for sequences and arrays.
341 //gchar * name; //facility name
343 guint32 checksum
; //checksum of the facility
344 guint32 id
; //id of the facility
346 guint32 pointer_size
;
352 //LttEventType ** events; //array of event types
353 //unsigned int event_number; //number of events in the facility
354 //LttType ** named_types;
355 //unsigned int named_types_number;
358 GData
*events_by_name
;
359 // GArray *named_types;
360 //GData *named_types_by_name;
363 unsigned char exists
; /* 0 does not exist, 1 exists */
366 typedef struct _LttBuffer
{
372 uint64_t cycle_count
;
373 uint64_t freq
; /* Frequency in khz */
377 uint64_t cycle_count
;
378 uint64_t freq
; /* Frequency in khz */
380 uint32_t lost_size
; /* Size unused at the end of the buffer */
383 uint64_t tsc
; /* Current timestamp counter */
384 uint64_t freq
; /* Frequency in khz */
385 //double nsecs_per_cycle; /* Precalculated from freq */
386 guint32 cyc2ns_scale
;
389 struct _LttTracefile
{
390 gboolean cpu_online
; //is the cpu online ?
391 GQuark long_name
; //tracefile complete filename
392 GQuark name
; //tracefile name
393 guint cpu_num
; //cpu number of the tracefile
394 LttTrace
* trace
; //trace containing the tracefile
395 int fd
; //file descriptor
396 off_t file_size
; //file size
397 //unsigned block_size; //block_size
398 unsigned int num_blocks
; //number of blocks in the file
399 gboolean reverse_bo
; //must we reverse byte order ?
400 gboolean float_word_order
; //what is the byte order of floats ?
402 size_t buffer_header_size
;
405 LttEvent event
; //Event currently accessible in the trace
408 LttBuffer buffer
; //current buffer
409 guint32 buf_size
; /* The size of blocks */
412 //unsigned int count; //the number of overflow of cycle count
413 //double nsec_per_cycle; //Nsec per cycle
414 //TimeHeartbeat * last_heartbeat; //last heartbeat
416 //LttCycleCount cycles_per_nsec_reciprocal; // Optimisation for speed
417 //void * last_event_pos;
419 //LttTime prev_block_end_time; //the end time of previous block
420 //LttTime prev_event_time; //the time of the previous event
421 //LttCycleCount pre_cycle_count; //previous cycle count of the event
425 GQuark pathname
; //the pathname of the trace
426 //LttSystemDescription * system_description;//system description
428 GArray
*facilities_by_num
; /* fac_id as index in array */
429 GData
*facilities_by_name
; /* fac name (GQuark) as index */
430 /* Points to array of fac_id of all the
431 * facilities that has this name. */
435 guint32 arch_variant
;
437 guint8 ltt_major_version
;
438 guint8 ltt_minor_version
;
439 guint8 flight_recorder
;
440 guint8 has_heartbeat
;
441 guint8 has_alignment
;
445 uint64_t start_monotonic
;
447 LttTime start_time_from_tsc
;
449 GData
*tracefiles
; //tracefiles groups
452 /* The characteristics of the system on which the trace was obtained
453 is described in a LttSystemDescription structure. */
455 struct _LttSystemDescription
{
461 LttArchEndian endian
;
463 gchar
*kernel_release
;
464 gchar
*kernel_version
;
467 gchar
*hardware_platform
;
468 gchar
*operating_system
;
473 /*****************************************************************************
474 macro for size of some data types
475 *****************************************************************************/
476 // alignment -> dynamic!
478 //#define TIMESTAMP_SIZE sizeof(guint32)
479 //#define EVENT_ID_SIZE sizeof(guint16)
480 //#define EVENT_HEADER_SIZE (TIMESTAMP_SIZE + EVENT_ID_SIZE)
483 #endif /* LTT_PRIVATE_H */