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

# tau\_convert(1)

convert TAU tracefiles into various alternative trace formats

## NAME

tau\_convert - convert TAU tracefiles into various alternative trace formats

## SYNOPSIS

**tau\_convert** \[\[**-alog**\] \[**-SSDF**\] \[**-dump**\] \[**-paraver** \[-t\]\] \[**-pv**\] \[**-vampir** \[ **-longsymbolbugfix** \] \[ **-compact** \] \[\[ **-user** \] \[ **-class** \] \[ **-all** \]\] \[ **-nocomm** \]\]\] \[*outputtrc*\] {*inputtrc*} {*edffile*}

## DESCRIPTION

tau\_convert is generated when TAU is configured with the -TRACE option.

This program requires specification of a TAU tracefile and eventfile. It will convert the given TAU traces to the ASCII-based trace format specified in the first argument. The conversion type specification may be followed by additional options specific to the conversion type. It defaults to the single threaded vampir format if no other format is specified. tau\_convert also accepts specification of an output file as the last argument. If none is given it prints the converted data to the standard out.

## OPTIONS

**-alog** convert TAU tracefile into the alog format (This format is deprecated. The SLOG2 format is recommended.)

**-SDDF** convert TAU tracefile into the SDDF format

**-dump** convert TAU tracefile into multi-column human readable text

**-paraver** convert TAU tracefile into paraver format

**-t** indicate conversion of multi threaded TAU trace into paraver format

**-pv** convert single threaded TAU tracefile into vampir format (all -vampir options apply) (default)

**-vampir** convert multi threaded TAU tracefile into vampir format

**-longsymbolbugfix** make the first characters of long, similar identifier strings unique to avoid a bug in vampir

**-compact** abbreviate individual event entries

**-all** compact all entries (default)

**-user** compact user entries only

**-class** compact class entries only

**-nocomm** disregard communication events

**\[outputtrc\]** specify the name of the output tracefile to be produced

## EXAMPLES

To print the contents of a TAU tracefile to the screen:

```
tau_convert -dump app.trc tau.edf
```

To convert a merged, threaded TAU tracefile to paraver format:

```
tau_convert -paraver -t app.trc tau.edf app.pv
```

## SEE ALSO

[tau\_merge(1)](/tau_merge/1.md), [tau2vtf(1)](/tau2vtf/1.md), [tau2profile(1)](/tau2profile/1.md), [tau2slog2(1)](/tau2slog2/1.md)