Scroll to navigation

TAU_REGISTER_EVENT(3) TAU Instrumentation API TAU_REGISTER_EVENT(3)

NAME

TAU_REGISTER_EVENT - Registers a user event

SYNOPSIS

C/C++:
TAU_REGISTER_EVENT(TauUserEvent variable, char *event_name);
Fortran:
TAU_REGISTER_EVENT(int variable(2), character event_name(size));

DESCRIPTION

TAU can profile user-defined events using TAU_REGISTER_EVENT. The meaning of the event is determined by the user. The first argument to TAU_REGISTER_EVENT is the pointer to an integer array. This array is declared with a save attribute as shown below.

EXAMPLE

C/C++ :
 
int user_square(int count) {
  TAU_REGISTER_EVENT(ue1, "UserSquare Event");
  TAU_EVENT(ue1, count * count);
  return 0;
}
Fortran :
 
integer eventid(2)
save eventid
call TAU_REGISTER_EVENT(eventid, 'Error in Iteration')
call TAU_EVENT(eventid, count)

SEE ALSO

TAU_EVENT(3), TAU_REGISTER_CONTEXT_EVENT(3), TAU_REPORT_STATISTICS(3), TAU_REPORT_THREAD_STATISTICS(3), TAU_GET_EVENT_NAMES(3), TAU_GET_EVENT_VALS(3)
08/31/2005