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)