tau_profile_timer(3) [debian man page]

TAU_PROFILE_TIMER(3)					      TAU Instrumentation API					      TAU_PROFILE_TIMER(3)

NAME

       TAU_PROFILE_TIMER - Defines a static timer.

SYNOPSIS

       C/C++:

       TAU_PROFILE_TIMER(Profiler timer, char* or string& function_name, char* or string& type, TauGroup_t group);

       Fortran:

       TAU_PROFILE_TIMER(integer profiler(2), character name(size));

DESCRIPTION

       C/C++ :

       With TAU_PROFILE_TIMER, a group of one or more statements is profiled. This macro has a timer variable as its first argument, and then
       strings for name and type, as described earlier. It associates the timer to the profile group specified in the last parameter.

       Fortran :

       To profile a block of Fortran code, such as a function, subroutine, loop etc., the user must first declare a profiler, which is an integer
       array of two elements (pointer) with the save attribute, and pass it as the first parameter to the TAU_PROFILE_TIMER subroutine. The second
       parameter must contain the name of the routine, which is enclosed in a single quote.  TAU_PROFILE_TIMER declares the profiler that must be
       used to profile a block of code. The profiler is used to profile the statements using TAU_PROFILE_START and TAU_PROFILE_STOP as explained
       later.

EXAMPLE

       C/C++ :

       template< class T, unsigned Dim >
       void BareField<T,Dim>::fillGuardCells(bool reallyFill)
       {
	// profiling macros
	TAU_TYPE_STRING(taustr, CT(*this) + " void (bool)" );
	TAU_PROFILE("BareField::fillGuardCells()", taustr, TAU_FIELD);
	TAU_PROFILE_TIMER(sendtimer, "fillGuardCells-send",
			  taustr, TAU_FIELD);
	TAU_PROFILE_TIMER(localstimer, "fillGuardCells-locals",
			  taustr, TAU_FIELD);
	...
       }

       Fortran :

       subroutine bcast_inputs
       implicit none
       integer profiler(2)
       save profiler

       include 'mpinpb.h'
       include 'applu.incl'

       interger IERR

       call TAU_PROFILE_TIMER(profiler, 'bcast_inputs')

SEE ALSO

       TAU_PROFILE_TIMER_DYNAMIC(3), TAU_PROFILE_START(3), TAU_PROFILE_STOP(3)

								    08/31/2005						      TAU_PROFILE_TIMER(3)

profiler(n)							   Tcl Profiler 						       profiler(n)

NAME

       profiler - Tcl source code profiler

SYNOPSIS

       package require Tcl 8.3

       package require profiler ?0.2?

       ::profiler::init

       ::profiler::dump pattern

       ::profiler::print ?pattern?

       ::profiler::reset

       ::profiler::suspend ?pattern?

       ::profiler::resume ?pattern?

       ::profiler::sortFunctions key

DESCRIPTION

       The profiler package provides a simple Tcl source code profiler.  It is a function-level profiler; that is, it collects only function-level
       information, not the more detailed line-level information.  It operates by redefining the Tcl proc command.  Profiling is initiated via the
       ::profiler::init command.

COMMANDS

       ::profiler::init
	      Initiate	profiling.   All procedures created after this command is called will be profiled.  To profile an entire application, this
	      command must be called before any other commands.

       ::profiler::dump pattern
	      Dump profiling information for the all functions matching pattern.  If no pattern is specified, information for all  functions  will
	      be  returned.  The result is a list of key/value pairs that maps function names to information about that function.  The information
	      about each function is in turn a list of key/value pairs.  The keys used and their values are:

	      totalCalls
		     The total number of times functionName was called.

	      callerDist
		     A list of key/value pairs mapping each calling function that called functionName to the number of times it  called  function-
		     Name.

	      compileTime
		     The runtime, in clock clicks, of functionName the first time that it was called.

	      totalRuntime
		     The sum of the runtimes of all calls of functionName.

	      averageRuntime
		     Average runtime of functionName.

	      descendantTime
		     Sum of the time spent in descendants of functionName.

	      averageDescendantTime
		     Average time spent in descendants of functionName.

       ::profiler::print ?pattern?
	      Print profiling information for all functions matching pattern.  If no pattern is specified, information about all functions will be
	      displayed.  The return result is a human readable display of the profiling information.

       ::profiler::reset
	      Reset profiling information for all functions matching pattern.  If no pattern is specified, information will be reset for all func-
	      tions.

       ::profiler::suspend ?pattern?
	      Suspend profiling for all functions matching pattern.  If no pattern is specified, profiling will be suspended for all functions. It
	      stops gathering profiling information after this command is issued. However, it does not erase any profiling  information  that  has
	      been gathered previously.  Use resume command to re-enable profiling.

       ::profiler::resume ?pattern?
	      Resume profiling for all functions matching pattern.  If no pattern is specified, profiling will be resumed for all functions.  This
	      command should be invoked after suspending the profiler in the code.

       ::profiler::sortFunctions key
	      Return a list of functions sorted by a particular profiling statistic.  Supported values for key are: calls, exclusiveTime, compile-
	      Time, nonCompileTime, totalRuntime, avgExclusiveTime, and avgRuntime.  The return result is a list of lists, where each sublist con-
	      sists of a function name and the value of key for that function.

KEYWORDS

       profile, performance, speed

profiler								0.2							       profiler(n)