---
name: "TAU_REGISTER_EVENT"
section: "3"
platform: "linux"
package: "tau"
version: "2.17.3.1.dfsg-4.2"
release: "Debian 9 (Stretch)"
platforms: ["linux"]
url: "https://new.carta.tech/TAU_REGISTER_EVENT"
---

# TAU\_REGISTER\_EVENT(3)

Registers a user event

## 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_EVENT/3.md), [TAU\_REGISTER\_CONTEXT\_EVENT(3)](/TAU_REGISTER_CONTEXT_EVENT/3.md), [TAU\_REPORT\_STATISTICS(3)](/TAU_REPORT_STATISTICS/3.md), [TAU\_REPORT\_THREAD\_STATISTICS(3)](/TAU_REPORT_THREAD_STATISTICS/3.md), [TAU\_GET\_EVENT\_NAMES(3)](/TAU_GET_EVENT_NAMES/3.md), [TAU\_GET\_EVENT\_VALS(3)](/TAU_GET_EVENT_VALS/3.md)