tau_mapping_create(3) [debian man page]

TAU_MAPPING_CREATE(3)						  TAU Mapping API					     TAU_MAPPING_CREATE(3)

NAME

       TAU_MAPPING_CREATE - Creates a mapping

SYNOPSIS

       C/C++:

       TAU_MAPPING_CREATE(char *name, char *type, char *groupname, unsigned long key, int tid);

DESCRIPTION

       TAU_MAPPING_CREATE creates a mapping and associates it with the key that is specified. Later, this key may be used to retrieve the
       FunctionInfo object associated with this key for timing purposes. The thread identifier is specified in the tid parameter.

EXAMPLE

       C/C++ :

       class MyClass {
	 public:
	   MyClass() {
	     TAU_MAPPING_LINK(runtimer, TAU_USER);
	   }
	   ~MyClass() {}

	   void Run(void) {
	     TAU_MAPPING_PROFILE(runtimer); // For one object
	     TAU_PROFILE("MyClass::Run()", " void (void)", TAU_USER1);

	     cout <<"Sleeping for 2 secs..."<<endl;
	     sleep(2);
	   }
	 private:
	   TAU_MAPPING_OBJECT(runtimer)  // EMBEDDED ASSOCIATION
       };

       int main(int argc, char **argv) {
	 TAU_PROFILE_INIT(argc, argv);
	 TAU_PROFILE("main()", "int (int, char **)", TAU_DEFAULT);
	 MyClass x, y, z;
	 TAU_MAPPING_CREATE("MyClass::Run() for object a", " " , TAU_USER,
			    "TAU_USER", 0);
	 MyClass a;
	 TAU_PROFILE_SET_NODE(0);
	 cout <<"Inside main"<<endl;

	 a.Run();
	 x.Run();
	 y.Run();
       }

SEE ALSO

       TAU_MAPPING_LINK(3), TAU_MAPPING_OBJECT(3), TAU_MAPPING_PROFILE(3)

								    08/31/2005						     TAU_MAPPING_CREATE(3)

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)