itrace
Instrumented Trace
Event-related types

Classes

struct  itrace_event_t
 
struct  itrace_measured_events_t
 
struct  itrace_section_no_events_context_t
 
struct  itrace_section_context_t
 

Macros

#define ITRACE_PM_DEFAULT   0
 
#define ITRACE_PM_RAW   1
 
#define ITRACE_PM_DELTA   2
 
#define ITRACE_PM_NORMALIZED   3
 
#define ITRACE_PM_STID_FILTERING   0x10
 
#define ITRACE_STID_DISABLED   0
 
#define ITRACE_STID_PROCESS   0x8001
 

Typedefs

typedef uint32_t itrace_processing_mode_t
 
typedef uint32_t itrace_stid_t
 

Enumerations

enum  itrace_registration_status_t { ITRACE_RS_NOT_REGISTERED_YET, ITRACE_RS_REGISTERED, ITRACE_RS_INVALID_EVENT, ITRACE_RS_FAILED_REGISTRATION }
 

Detailed Description

Macro Definition Documentation

◆ ITRACE_PM_DEFAULT

#define ITRACE_PM_DEFAULT   0

Use ITRACE_PM_DELTA for running counters and ITRACE_PM_RAW otherwise

◆ ITRACE_PM_DELTA

#define ITRACE_PM_DELTA   2

Difference with previously measured event value

◆ ITRACE_PM_NORMALIZED

#define ITRACE_PM_NORMALIZED   3

Difference with previously measured event value, normalized by elapsed time

◆ ITRACE_PM_RAW

#define ITRACE_PM_RAW   1

Event value unmodified.

◆ ITRACE_PM_STID_FILTERING

#define ITRACE_PM_STID_FILTERING   0x10

Accumulate PMU only when matching STID. Upcoming feature!!

◆ ITRACE_STID_DISABLED

#define ITRACE_STID_DISABLED   0

Do not perform STID filtering (default)

◆ ITRACE_STID_PROCESS

#define ITRACE_STID_PROCESS   0x8001

Filter PMU by current process (assign automatically a new STID to the current process).

Typedef Documentation

◆ itrace_processing_mode_t

typedef uint32_t itrace_processing_mode_t

Method for post-processing a measured event

In the methods described below, "previously measured" values refer to the value of an event when it was last measured when reporting domain statistics, or to the value of an event when a section started when reporting section statistics.

ITRACE_PM_RAW event values have an 's' or 'e' postfix in the itrace output whenever corresponding to the Start and End values of a section. No postfix is present otherwise.

ITRACE_PM_DELTA event values have a 'd' postfix and ITRACE_PM_NORMALIZED events have a 'd/t' postfix.

◆ itrace_stid_t

typedef uint32_t itrace_stid_t

STID type

This functionality is only available on NSP domains.

The default is to ignore STID filtering. When ITRACE_STID_PROCESS or ITRACE_STID_THREAD is set, itrace will allocate, if necessary, an STID to the process or thread from which the API specifying the stid is being called. The STID will NOT be assigned at registration time. For all other STID value being set by the user, itrace will perform PMU filtering according to that value irrespective of the STID that the current process or thread may have.

Enumeration Type Documentation

◆ itrace_registration_status_t

Event registration status

Enumerator
ITRACE_RS_NOT_REGISTERED_YET 

No attempt made to register the event yet

ITRACE_RS_REGISTERED 

Event was successfully registered

ITRACE_RS_INVALID_EVENT 

Event is invalid

ITRACE_RS_FAILED_REGISTRATION 

Failed event registration