Global Trace Outputs

There is a global 32-bit trace mask: the low 16 bits are the global trace output types, while the upper 16 bits are the per-object trace output types. Each object has a similar trace mask. The upper 16 bits of the global trace mask are not defined, but can be used to set the per-object output types for all objects. To enable all trace output types for all objects, set the global trace mask to all 1s (i.e., -1).

The MPITrace{...} enum (declared in trace.h) specifies the global types of trace output, i.e., the types of trace output that can be produced by any object or module. The MPITrace{...} enum defines constants that you use together as a bit mask. You specify the desired trace output as a combination (logical OR) of MPITrace{...} constants.

There are 16 possible types of global trace output, with 12 global trace outputs defined.

Output Type Displays
MPITraceFUNCTION_ENTRY Function name & calling parameters upon entry to function
MPITraceFUNCTION_RETURN Function name, calling parameters & return value upon exit from function
MPITraceMEMORY_ALLOC The Address & byte count when memory is dynamically allocated
MPITraceMEMORY_FREE The Address & byte count when dynamically allocated memory is freed
MPITraceMEMORY_GET Source address, destination address, byte count when reading XMP firmware memory
MPITraceMEMORY_SET Source address, destination address, byte count when writing XMP firmware memory
MPITraceVALIDATE Results of object validation
MPITraceLOCK_GIVE When a resource lock is released
MPITraceLOCK_TAKE When a resource lock is waited for & obtained
MPITraceEVENT When an XMP event is received
MPITraceALL All global trace outputs (lower 16 bits)

Return to Trace Object's page

       Legal Notice  |  Tech Email  |  Feedback
Copyright ©
2001-2010 Motion Engineering