Datasheet

ARMulator Reference

4.12 Tracer

This section describes the functions provided by the tracer module,

tracer.c

NoteNote

These functions are not exported. If you want to use any of these functions in your

model, you must build your model together with

tracer.c

The default implementations of these functions can be changed by compiling

tracer.c

with

EXTERNAL_DISPATCH

defined.

The formats of

Trace_State

and

Trace_Packet

are documented in

tracer.h

4.12.1 Tracer_Open

This function is called when the tracer is initialized.

Syntax

unsigned Tracer_Open(Trace_State *ts)

Usage

The implementation in

tracer.c

opens the output file from this function, and writes a

header.

4.12.2 Tracer_Dispatch

This function is called on each traced event for every instruction, event, or memory

access.

Syntax

void Tracer_Dispatch(Trace_State *ts, Trace_Packet *packet)

Usage

tracer.c

, this function writes the packet to the trace file.