---
name: "perf_3.2-report"
section: "1"
platform: "linux"
package: "linux-tools-3.2"
version: "3.2.17-1"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/perf_3.2-report"
---

# perf\_3.2-report(1)

Read perf.data (created by perf record) and display the profile

## NAME

perf-report - Read perf.data (created by perf record) and display the profile

## SYNOPSIS

```
perf report [-i <file> | --input=file]
```

## DESCRIPTION

This command displays the performance counter profile information recorded via perf record.

## OPTIONS

\-i, --input=

Input file name. (default: perf.data)

- \-v, --verbose

  Be more verbose. (show symbol address, etc)

\-d, --dsos=

Only consider symbols in these dsos. CSV that understands **file://filename** entries.

- \-n, --show-nr-samples

  Show the number of samples for each symbol

- \--showcpuutilization

  Show sample percentage for different cpu modes.

- \-T, --threads

  Show per-thread event counters

\-C, --comms=

Only consider symbols in these comms. CSV that understands **file://filename** entries.

\-S, --symbols=

Only consider these symbols. CSV that understands **file://filename** entries.

- \-U, --hide-unresolved

  Only display entries resolved to a symbol.

\-s, --sort=

Sort by key(s): pid, comm, dso, symbol, parent.

- \-p, --parent=\<regex\>

  regex filter to identify parent, see: *--sort parent*

- \-x, --exclude-other

  Only display entries with parent-match.

- \-w, --column-widths=\<width\[,width...\]\>

  Force each column width to the provided list, for large terminal readability.

\-t, --field-separator=

Use a special separator character and don’t pad with spaces, replacing all occurrences of this separator in symbol names (and other output) with a *.* character, that thus it’s the only non valid separator.

- \-D, --dump-raw-trace

  Dump raw trace in ASCII.

- \-g \[type,min,order\], --call-graph

  Display call chains using type, min percent threshold and order. type can be either:

  • flat: single column, linear exposure of call chains.

  • graph: use a graph tree, displaying absolute overhead rates.

  • fractal: like graph, but displays relative rates. Each branch of the tree is considered as a new profiled object.

  ```
  order can be either:
  - callee: callee based call graph.
  - caller: inverted caller based call graph.
  ```

  ```
  Default: fractal,0.5,callee.
  ```

- \-G, --inverted

  alias for inverted caller based call graph.

- \--pretty=\<key\>

  Pretty printing style. key: normal, raw

- \--stdio

  Use the stdio interface.

- \--tui

  Use the TUI interface, that is integrated with annotate and allows zooming into DSOs or threads, among other features. Use of --tui requires a tty, if one is not present, as when piping to other commands, the stdio interface is used.

- \-k, --vmlinux=\<file\>

  vmlinux pathname

- \--kallsyms=\<file\>

  kallsyms pathname

- \-m, --modules

  Load module symbols. WARNING: This should only be used with -k and a LIVE kernel.

- \-f, --force

  Don’t complain, do it.

- \--symfs=\<directory\>

  Look for files with symbols relative to this directory.

- \-c, --cpu

  Only report samples for the list of CPUs provided. Multiple CPUs can be provided as a comma-separated list with no space: 0,1. Ranges of CPUs are specified with -: 0-2. Default is to report samples on all CPUs.

\-M, --disassembler-style=

Set disassembler style for objdump.

- \--source

  Interleave source code with assembly code. Enabled by default, disable with --no-source.

- \--asm-raw

  Show raw instruction encoding of assembly instructions.

- \--show-total-period

  Show a column with the sum of periods.

- \-I, --show-info

  Display extended information about the perf.data file. This adds information which may be very large and thus may clutter the display. It currently includes: cpu and numa topology of the host system.

## SEE ALSO

[**perf\_3.2-stat**(1)](/perf_3.2-stat/1.md), [**perf\_3.2-annotate**(1)](/perf_3.2-annotate/1.md)
