CnC
Macros
Instrumenting with/for ITAC

Macros

#define VT_THREAD_NAME(threadName)
 
#define VT_FUNC(funcName)
 
#define VT_FUNC_D(funcName)
 
#define VT_INIT()
 

Detailed Description

Two Macros are provided for a convenient way to instrument your code with ITAC. When adding instrumentation you need to take care about building your bainry properly (Compiling and linking with ITAC instrumentation).

Macro Definition Documentation

◆ VT_FUNC

#define VT_FUNC (   funcName)

Use this macro to manually instrument your function (or scope) at its beginning, e.g. VT_FUNC( "MyClass::myMethod" ); See also Compiling and linking with ITAC instrumentation

Parameters
funcNamename of function (in double quotes), potentially including class/namespace hierachy

Definition at line 151 of file itac.h.

◆ VT_FUNC_D

#define VT_FUNC_D (   funcName)

Similar to VT_FUNC, but the recorded function name can change between invocations. It is slower, so don't use it unless really needed. See also Compiling and linking with ITAC instrumentation

Parameters
funcNamename of function (in double quotes), potentially including class/namespace hierachy

Definition at line 158 of file itac.h.

◆ VT_INIT

#define VT_INIT ( )

In shared memory, ITC needs to be initialized. This is done automatically with the first context construction. Use this only if you want to see things in the trace before the first context is created. Don't use it for distributed memory.

Definition at line 164 of file itac.h.

◆ VT_THREAD_NAME

#define VT_THREAD_NAME (   threadName)

Use this macro to define an (optional) name for your application thread, e.g. VT_THREAD_NAME( "myApp" ). This name will appear for your thread in ITAC's event timeline.

Parameters
threadNamename of calling thread (in double quotes), to appear in ITAC tracefile

Definition at line 145 of file itac.h.