bionic (3) TAU_PROFILER_CREATE.3.gz

NAME

       TAU_PROFILER_CREATE - Creates a profiler object referenced as a standard pointer

SYNOPSIS

       C/C++:

       TAU_PROFILER_CREATE(Timer timer, char* or string& function_name, char* or string& type,
                           taugroup_t group);

DESCRIPTION

       TAU_PROFILER_CREATE creates a timer the that can be controlled by the Timer pointer object.

       The TAU_PROFILER_* API is intended for applications to easily layer their legacy timing measurements APIs
       on top of TAU, Unlike other TAU API calls (TAU_PROFILE_TIMER) that are statically expanded in the source
       code, these calls allocate TAU entities on the heap. So the pointer to the TAU timer may be used as a
       handle to access the TAU performance data.

EXAMPLE

       >C/C++:

           void *ptr;
           TAU_PROFILER_CREATE(ptr, "foo","", TAU_USER);

           TAU_PROFILER_START(ptr);
           foo(2);
           TAU_PROFILER_STOP(ptr);

SEE ALSO

       TAU_PROFILER_START TAU_PROFILER_STOP TAU_PROFILER_GET_CALLS TAU_PROFILER_GET_CHILD_CALLS
       TAU_PROFILER_GET_INCLUSIVE_VALUES TAU_PROFILER_GET_ExCLUSIVE_VALUES TAU_PROFILER_GET_COUNTER_INFO

[FIXME: source]                                    08/12/2008                             TAU_PROFILER_CREATE(3)