Name
TAU_TRIGGER_CONTEXT_EVENT_THREAD — Triggers a context user event
Synopsis
C/C++:
TAU_TRIGGER_CONTEXT_EVENT_THREAD( |
name,
|
|
| |
value,
|
|
| |
thread);
|
|
| const char * |
name;
|
| double |
value;
|
| int |
thread;
|
Fortran:
TAU_TRIGGER_CONTEXT_EVENT_THREAD( |
integer ,
|
|
| |
integer ,
|
|
| |
event_name);
|
|
| int |
integer (2);
|
| int |
integer (2);
|
| character |
event_name(size);
|
Description
Triggers an event with a name and
the list of routines along the callstack. A context event tracks
information like a user defined event and TAU records the maxima,
minima, mean, std. deviation and the number of samples for each
context event. A context event helps distinguish the data supplied
by the user based on the location where an event occurs and the
sequence of actions (routine/timer invocations) that preceeded the
event. The depth of the the callstack embedded in the context
event's name is specified by the user in the environment variable
TAU_CALLPATH_DEPTH. If this variable is not
specified, TAU uses a default depth of 2.
Example
C/C++ :
int user_square(int count) {
TAU_TRIGGER_CONTEXT_EVENT_THREAD("Error in Iteration", count * count, workTask);
return 0;
}
Fortran :
call TAU_TRIGGER_CONTEXT_EVENT_THREAD(count, workTask, 'Error in Iteration')