TAU_MAPPING_PROFILE(3)						  TAU Mapping API					    TAU_MAPPING_PROFILE(3)

NAME

       TAU_MAPPING_PROFILE - Profiles a block based on a mapping

SYNOPSIS

       C/C++:

       TAU_MAPPING_PROFILE(FunctionInfo *FuncIdVar);

DESCRIPTION

       The TAU_MAPPING_PROFILE macro measures the time and attributes it to the statement mapped in TAU_MAPPING macro. It takes as its argument
       the identifier of the higher level statement that is stored using TAU_MAPPING_OBJECT and linked to the statement using TAU_MAPPING_LINK
       macros.	TAU_MAPPING_PROFILE measures the time spent in the entire block in which it is invoked. For example, if the time spent in the run
       method of the class does work that must be associated with the higher-level array expression, then, we can instrument it as follows:

EXAMPLE

       C/C++ :

       // Evaluate the kernel
       // Just tell an InlineEvaluator to do it.

       template<class LHS,class Op,class RHS,class EvalTag>
       void
       ExpressionKernel<LHS,Op,RHS,EvalTag>::run() {
	 TAU_MAPPING_PROFILE(TauMapFI)

	 // Just evaluate the expression.
	 KernelEvaluator<EvalTag>().evalate(lhs_m,op_m,rhs_m);
	 // we could release the locks here or in dtor
       }

SEE ALSO

       TAU_MAPPING_CREATE(3), TAU_MAPPING_LINK(3), TAU_MAPPING_OBJECT(3)

								    08/31/2005						    TAU_MAPPING_PROFILE(3)