debian man page for tau_mapping_create

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)