TAU_REGISTER

TAU_REGISTER_EVENT

Section: TAU Instrumentation API (3) Updated: 08/31/2005 Local index Up

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)