tau_dump_func_vals_incr(3) [debian man page]

TAU_DUMP_FUNC_VALS_I(3) 				      TAU Instrumentation API					   TAU_DUMP_FUNC_VALS_I(3)

NAME

       TAU_DUMP_FUNC_VALS_INCR - Dumps function values with a timestamp

SYNOPSIS

       C/C++:

       TAU_DUMP_FUNC_VALS_INCR(char **inFuncs, int numFuncs);

DESCRIPTION

       Similar to TAU_DUMP_FUNC_VALS. This macro creates an incremental selective dump and dumps the results with a date stamp to the filename
       such as sel_dump__Thu-Mar-28-16:30:48-2002__.0.0.0. In this manner the previous TAU_DUMP_FUNC_VALS_INCR(...)  are not overwritten (unless
       they occur within a second).

EXAMPLE

       C/C++ :

       const char **inFuncs;
       /* The first dimension is functions, and the second dimension is counters */
       double **counterExclusiveValues;
       double **counterInclusiveValues;
       int *numOfCalls;
       int *numOfSubRoutines;
       const char **counterNames;
       int numOfCouns;

       TAU_GET_FUNC_VALS(inFuncs, 2,
	 counterExclusiveValues,
	 counterInclusiveValues,
	 numOfCalls,
	 numOfSubRoutines,
	 counterNames,
	 numOfCouns);

       TAU_DUMP_FUNC_VALS(inFuncs, 2);

SEE ALSO

       TAU_DB_DUMP(3), TAU_DUMP_FUNC_NAMES(3), TAU_DUMP_FUNC_VALS(3)

								    08/31/2005						   TAU_DUMP_FUNC_VALS_I(3)

TAU_GET_EVENT_VALS(3)					      TAU Instrumentation API					     TAU_GET_EVENT_VALS(3)

NAME

       TAU_GET_EVENT_VALS - Gets user event data for given user events.

SYNOPSIS

       C/C++:

       TAU_GET_EVENT_VALS(const char **inUserEvents, int numUserEvents, int **numEvents, double **max, double **min, double **mean,
			  double **sumSqe);

DESCRIPTION

       Retrieves user defined event data for the specified user defined events. The list of events are specified by the first parameter
       (eventList) and the user specifies the number of events in the second parameter (numUserEvents). TAU returns the number of times the event
       was invoked in the numUserEvents. The max, min, mean values are returned in the following parameters. TAU computes the sum of squares of
       the given event and returns this value in the next argument (sumSqe).

EXAMPLE

       C/C++ :

	 const char **eventList;
	 int numEvents;

	 TAU_GET_EVENT_NAMES(eventList, numEvents);

	 cout << "numEvents: " << numEvents << endl;

	 if (numEvents > 0) {
	   int *numSamples;
	   double *max;
	   double *min;
	   double *mean;
	   double *sumSqr;

	   TAU_GET_EVENT_VALS(eventList, numEvents, numSamples,
	     max, min, mean, sumSqr);
	   for (int i=0; i<numEvents; i++) {
	     cout << "-------------------
";
	     cout << "User Event:	 " << eventList[i] << endl;
	     cout << "Number of Samples: " << numSamples[i] << endl;
	     cout << "Maximum Value:	 " << max[i] << endl;
	     cout << "Minimum Value:	 " << min[i] << endl;
	     cout << "Mean Value:	 " << mean[i] << endl;
	     cout << "Sum Squared:	 " << sumSqr[i] << endl;
	   }
	 }
       }

SEE ALSO

       TAU_REGISTER_EVENT(3), TAU_REGISTER_CONTEXT_EVENT(3), TAU_GET_EVENT_NAMES(3)

								    08/31/2005						     TAU_GET_EVENT_VALS(3)