tau_profile_set_context(3) [debian man page]

TAU_PROFILE_SET_CONT(3) 				      TAU Instrumentation API					   TAU_PROFILE_SET_CONT(3)

NAME

       TAU_PROFILE_SET_CONTEXT - Informs the measurement system of the context id

SYNOPSIS

       C/C++:

       TAU_PROFILE_SET_CONTEXT(int context);

       Fortran:

       TAU_PROFILE_SET_CONTEXT(integer context);

DESCRIPTION

       The TAU_PROFILE_SET_CONTEXT macro sets the context identifier of the executing task for profiling and tracing. Tasks are identified using
       context, context and thread ids. The profile data files generated will accordingly be named profile.<context>.<context>.<thread>. Note that
       it is not necessary to call TAU_PROFILE_SET_CONTEXT when using the TAU MPI wrapper library.

EXAMPLE

       C/C++ :

       int main (int argc, char **argv) {
	 int ret, i;
	 pthread_attr_t  attr;
	 pthread_t	 tid;
	 TAU_PROFILE_TIMER(tautimer,"main()", "int (int, char **)",
			   TAU_DEFAULT);
	 TAU_PROFILE_START(tautimer);
	 TAU_PROFILE_INIT(argc, argv);
	 TAU_PROFILE_SET_NODE(0);
	 TAU_PROFILE_SET_CONTEXT(1);
	 /* ... */
	 TAU_PROFILE_STOP(tautimer);
	 return 0;
       }

       Fortran :

	    PROGRAM SUM_OF_CUBES
	      integer profiler(2) / 0, 0 /
	       save profiler
	     INTEGER :: H, T, U
	       call TAU_PROFILE_INIT()
	       call TAU_PROFILE_TIMER(profiler, 'PROGRAM SUM_OF_CUBES')
	       call TAU_PROFILE_START(profiler)
	       call TAU_PROFILE_SET_NODE(0)
	       call TAU_PROFILE_SET_CONTEXT(1)
	     ! This program prints all 3-digit numbers that
	     ! equal the sum of the cubes of their digits.
	     DO H = 1, 9
	       DO T = 0, 9
		 DO U = 0, 9
		 IF (100*H + 10*T + U == H**3 + T**3 + U**3) THEN
		    PRINT "(3I1)", H, T, U
		 ENDIF
		 END DO
	       END DO
	     END DO
	     call TAU_PROFILE_STOP(profiler)
	     END PROGRAM SUM_OF_CUBES

SEE ALSO

       TAU_PROFILE_SET_NODE(3)

								    08/31/2005						   TAU_PROFILE_SET_CONT(3)

TAU_PROFILE_TIMER(3)					      TAU Instrumentation API					      TAU_PROFILE_TIMER(3)

NAME

       TAU_PROFILE_TIMER - Defines a static timer.

SYNOPSIS

       C/C++:

       TAU_PROFILE_TIMER(Profiler timer, char* or string& function_name, char* or string& type, TauGroup_t group);

       Fortran:

       TAU_PROFILE_TIMER(integer profiler(2), character name(size));

DESCRIPTION

       C/C++ :

       With TAU_PROFILE_TIMER, a group of one or more statements is profiled. This macro has a timer variable as its first argument, and then
       strings for name and type, as described earlier. It associates the timer to the profile group specified in the last parameter.

       Fortran :

       To profile a block of Fortran code, such as a function, subroutine, loop etc., the user must first declare a profiler, which is an integer
       array of two elements (pointer) with the save attribute, and pass it as the first parameter to the TAU_PROFILE_TIMER subroutine. The second
       parameter must contain the name of the routine, which is enclosed in a single quote.  TAU_PROFILE_TIMER declares the profiler that must be
       used to profile a block of code. The profiler is used to profile the statements using TAU_PROFILE_START and TAU_PROFILE_STOP as explained
       later.

EXAMPLE

       C/C++ :

       template< class T, unsigned Dim >
       void BareField<T,Dim>::fillGuardCells(bool reallyFill)
       {
	// profiling macros
	TAU_TYPE_STRING(taustr, CT(*this) + " void (bool)" );
	TAU_PROFILE("BareField::fillGuardCells()", taustr, TAU_FIELD);
	TAU_PROFILE_TIMER(sendtimer, "fillGuardCells-send",
			  taustr, TAU_FIELD);
	TAU_PROFILE_TIMER(localstimer, "fillGuardCells-locals",
			  taustr, TAU_FIELD);
	...
       }

       Fortran :

       subroutine bcast_inputs
       implicit none
       integer profiler(2)
       save profiler

       include 'mpinpb.h'
       include 'applu.incl'

       interger IERR

       call TAU_PROFILE_TIMER(profiler, 'bcast_inputs')

SEE ALSO

       TAU_PROFILE_TIMER_DYNAMIC(3), TAU_PROFILE_START(3), TAU_PROFILE_STOP(3)

								    08/31/2005						      TAU_PROFILE_TIMER(3)