[lttv.git] / ltt / branches / poly / include / ltt / event.h

#ifndef EVENT_H
#define EVENT_H

#include <ltt/ltt.h>

/* Events and their content, including the raw data, are only valid 
   until reading another event from the same tracefile. 
   Indeed, since event reading is critical to the performance, 
   the memory associated with an event may be reused at each read. */


/* Obtain the trace unique integer id associated with the type of 
   this event */

unsigned ltt_event_eventtype_id(ltt_event *e);


/* Facility and type for the event */

ltt_facility *ltt_event_facility(ltt_event *e);

ltt_eventtype *ltt_event_eventtype(ltt_event *e);


/* Root field for the event */

ltt_field *ltt_event_field(ltt_event *e);


/* Time and cycle count for the event */

ltt_time ltt_event_time(ltt_event *e);

ltt_cycle_count ltt_event_cycle_count(ltt_event *e);


/* CPU id and system name of the event */

unsigned ltt_event_cpu_id(ltt_event *e);

char *ltt_event_system_name(ltt_event *e);


/* Pointer to the raw data for the event. This should not be used directly
   unless prepared to do all the architecture specific conversions. */

void *ltt_event_data(ltt_event *e);


/* The number of elements in a sequence field is specific to each event.
   This function returns the number of elements for an array or sequence
   field in an event. */

unsigned ltt_event_field_element_number(ltt_event *e, ltt_field *f);


/* Set the currently selected element for a sequence or array field. */

int ltt_event_field_element_select(ltt_event *e, ltt_field *f, unsigned i);


/* These functions extract data from an event after architecture specific
   conversions. */

unsigned ltt_event_get_unsigned(ltt_event *e, ltt_field *f);

int ltt_event_get_int(ltt_event *e, ltt_field *f);

unsigned long ltt_event_get_long_unsigned(ltt_event *e, ltt_field *f);

long int ltt_event_get_long_int(ltt_event *e, ltt_field *f);

float ltt_event_get_float(ltt_event *e, ltt_field *f);

double ltt_event_get_double(ltt_event *e, ltt_field *f);


/* The string obtained is only valid until the next read from
   the same tracefile. */

char *ltt_event_get_string(ltt_event *e, ltt_field *f);

#endif // EVENT_H
Commit	Line	Data
7c6b3cd7	1	#ifndef EVENT_H
	2	#define EVENT_H
	3
	4	#include <ltt/ltt.h>
975e44c7	5
	6	/* Events and their content, including the raw data, are only valid
	7	until reading another event from the same tracefile.
	8	Indeed, since event reading is critical to the performance,
	9	the memory associated with an event may be reused at each read. */
	10
	11
1b82f325	12	/* Obtain the trace unique integer id associated with the type of
975e44c7	13	this event */
	14
	15	unsigned ltt_event_eventtype_id(ltt_event *e);
	16
	17
	18	/* Facility and type for the event */
	19
	20	ltt_facility ltt_event_facility(ltt_event e);
	21
	22	ltt_eventtype ltt_event_eventtype(ltt_event e);
	23
1b82f325	24
	25	/* Root field for the event */
	26
975e44c7	27	ltt_field ltt_event_field(ltt_event e);
975e44c7	28
1b82f325	29
975e44c7	30	/* Time and cycle count for the event */
	31
	32	ltt_time ltt_event_time(ltt_event *e);
	33
	34	ltt_cycle_count ltt_event_cycle_count(ltt_event *e);
	35
	36
	37	/* CPU id and system name of the event */
	38
	39	unsigned ltt_event_cpu_id(ltt_event *e);
	40
	41	char ltt_event_system_name(ltt_event e);
	42
	43
	44	/* Pointer to the raw data for the event. This should not be used directly
	45	unless prepared to do all the architecture specific conversions. */
	46
	47	void ltt_event_data(ltt_event e);
	48
	49
	50	/* The number of elements in a sequence field is specific to each event.
	51	This function returns the number of elements for an array or sequence
	52	field in an event. */
	53
	54	unsigned ltt_event_field_element_number(ltt_event e, ltt_field f);
	55
	56
	57	/* Set the currently selected element for a sequence or array field. */
	58
	59	int ltt_event_field_element_select(ltt_event e, ltt_field f, unsigned i);
	60
	61
	62	/* These functions extract data from an event after architecture specific
	63	conversions. */
	64
	65	unsigned ltt_event_get_unsigned(ltt_event e, ltt_field f);
	66
	67	int ltt_event_get_int(ltt_event e, ltt_field f);
	68
	69	unsigned long ltt_event_get_long_unsigned(ltt_event e, ltt_field f);
	70
	71	long int ltt_event_get_long_int(ltt_event e, ltt_field f);
	72
	73	float ltt_event_get_float(ltt_event e, ltt_field f);
	74
	75	double ltt_event_get_double(ltt_event e, ltt_field f);
	76
	77
	78	/* The string obtained is only valid until the next read from
	79	the same tracefile. */
	80
	81	char ltt_event_get_string(ltt_event e, ltt_field *f);
7c6b3cd7	82
7c6b3cd7	83	#endif // EVENT_H