Linux Certif

Toute la documentation sur la certification Linux LPI

TAU_CONTEXT_EVENT

NAME

TAU_CONTEXT_EVENT - Triggers a context event

SYNOPSIS

C/C++:

TAU_CONTEXT_EVENT(TauUserEvent variable, double value);

Fortran:

TAU_CONTEXT_EVENT(integer variable(2), real value);

DESCRIPTION

Triggers a context event. A context event associates the name with 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 f2(void)
 {
   static int count = 0;
   count ++;
   TAU_PROFILE("f2()", "(sleeps 2 sec, calls f3)", TAU_USER);
   TAU_REGISTER_CONTEXT_EVENT(event, "Iteration count");
 /*
   if (count == 2)
     TAU_DISABLE_CONTEXT_EVENT(event);
 */
   printf("Inside f2: sleeps 2 sec, calls f3\n");
 
   TAU_CONTEXT_EVENT(event, 232+count);
   sleep(2);
   f3();
   return 0;
 }
     
 

Fortran :

 integer memevent(2) / 0, 0 /
 save memevent
 call TAU_REGISTER_CONTEXT_EVENT(memevent, "STORAGEARY mem allocated')
 call TAU_CONTEXT_EVENT(memevent, SIZEOF(STORAGEARY)*sizeof(INTEGER))
     
 

SEE ALSO

TAU_REGISTER_CONTEXT_EVENT(3)