.\" ** You probably do not want to edit this file directly ** .\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). .\" Instead of manually editing it, you probably should edit the DocBook XML .\" source for it and then use the DocBook XSL Stylesheets to regenerate it. .TH "TAU_MAPPING_PROFILE_" "3" "08/31/2005" "" "TAU Mapping API" .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .SH "NAME" TAU_MAPPING_PROFILE_TIMER \- Declares a mapping timer .SH "SYNOPSIS" .PP \fBC/C++:\fR .HP 26 \fB\fBTAU_MAPPING_PROFILE_TIMER\fR\fR\fB(\fR\fBProfiler\ \fR\fB\fItimer\fR\fR\fB, \fR\fBFunctionInfo\ *\fR\fB\fIFuncIdVar\fR\fR\fB);\fR .SH "DESCRIPTION" .PP TAU_MAPPING_PROFILE_TIMER enables timing of individual statements, instead of complete blocks. It will attribute the time to a higher\-level statement. The second argument is the identifier of the statement that is obtained after TAU_MAPPING_OBJECT and TAU_MAPPING_LINK have executed. The timer argument in this macro is any variable that is used subsequently to start and stop the timer. .SH "EXAMPLE" .PP \fBC/C++ :\fR .sp .nf template void ExpressionKernel::run() { TAU_MAPPING_PROFILE_TIMER(timer, TauMapFI); printf("ExpressionKernel::run() this = 4854\\n", this); // Just evaluate the expression. TAU_MAPPING_PROFILE_START(timer); KernelEvaluator().evaluate(lhs_m, op_m, rhs_m); TAU_MAPPING_PROFILE_STOP(); // we could release the locks here instead of in the dtor. } .fi .SH "SEE ALSO" .PP TAU_MAPPING_LINK(3), TAU_MAPPING_OBJECT(3), TAU_MAPPING_PROFILE_START(3), TAU_MAPPING_PROFILE_STOP(3)