tau_profile_set_node(3) [debian man page]

TAU_PROFILE_SET_NODE(3) 				      TAU Instrumentation API					   TAU_PROFILE_SET_NODE(3)

NAME

       TAU_PROFILE_SET_NODE - Informs the measurement system of the node id

SYNOPSIS

       C/C++:

       TAU_PROFILE_SET_NODE(int node);

       Fortran:

       TAU_PROFILE_SET_NODE(integer node);

DESCRIPTION

       The TAU_PROFILE_SET_NODE macro sets the node identifier of the executing task for profiling and tracing. Tasks are identified using node,
       context and thread ids. The profile data files generated will accordingly be named profile.<node>.<context>.<thread>. Note that it is not
       necessary to call TAU_PROFILE_SET_NODE 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_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)
	     ! 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_CONTEXT(3)

								    08/31/2005						   TAU_PROFILE_SET_NODE(3)

TAU_REGISTER_CONTEXT(3) 				      TAU Instrumentation API					   TAU_REGISTER_CONTEXT(3)

NAME

       TAU_REGISTER_CONTEXT_EVENT - Registers a context event

SYNOPSIS

       C/C++:

       TAU_REGISTER_CONTEXT_EVENT(TauUserEvent variable, char *event_name);

       Fortran:

       TAU_REGISTER_CONTEXT_EVENT(int variable(2), character event_name(size));

DESCRIPTION

       Creates a context event with name. A context event appends the names of routines executing on the callstack to the name specified by the
       user. Whenver a context event is triggered, the callstack is examined to determine the context of execution. Starting from the parent
       function where the event is triggered, TAU walks up the callstack to a depth specified by the user in the environment variable
       TAU_CALLPATH_DEPTH. If this environment variable is not specified, TAU uses 2 as the default depth. For e.g., if the user registers a
       context event with the name "memory used" and specifies 3 as the callpath depth, and if the event is triggered in two locations (in routine
       a, when it was called by b, when it was called by c, and in routine h, when it was called by g, when it was called by i), then, we'd see
       the user defined event information for "memory used: c() => b() => a()" and "memory used: i() => g() => h()".

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
");

	 TAU_CONTEXT_EVENT(event, 232+count);
	 sleep(2);
	 f3();
	 return 0;
       }

       Fortran :

       subroutine foo(id)
	 integer id

	 integer profiler(2) / 0, 0 /
	 integer maev(2) / 0, 0 /
	 integer mdev(2) / 0, 0 /
	 save profiler, maev, mdev

	 integer :: ierr
	 integer :: h, t, u
	 INTEGER, ALLOCATABLE :: STORAGEARY(:)
	 DOUBLEPRECISION   edata

	 call TAU_PROFILE_TIMER(profiler, 'FOO')
	 call TAU_PROFILE_START(profiler)
	 call TAU_PROFILE_SET_NODE(0)

	 call TAU_REGISTER_CONTEXT_EVENT(maev, "STORAGEARY Alloc [cubes.f:20]")
	 call TAU_REGISTER_CONTEXT_EVENT(mdev, "STORAGEARY Dealloc [cubes.f:37]")

	 allocate(STORAGEARY(1:999), STAT=IERR)
	 edata = SIZE(STORAGEARY)*sizeof(INTEGER)
	 call TAU_CONTEXT_EVENT(maev, edata)
	 ...
	 deallocate(STORAGEARY)
	 edata = SIZE(STORAGEARY)*sizeof(INTEGER)
	 call TAU_CONTEXT_EVENT(mdev, edata)
	 call TAU_PROFILE_STOP(profiler)
	 end subroutine foo

SEE ALSO

       TAU_CONTEXT_EVENT(3), TAU_ENABLE_CONTEXT_EVENT(3), TAU_DISABLE_CONTEXT_EVENT(3), TAU_REGISTER_EVENT(3), TAU_REPORT_STATISTICS(3),
       TAU_REPORT_THREAD_STATISTICS(3), TAU_GET_EVENT_NAMES(3), TAU_GET_EVENT_VALS(3)

								    08/31/2005						   TAU_REGISTER_CONTEXT(3)