tools/perf/Documentation/perf-report.txt

   1 perf-report(1)
   2 ==============
   3
   4 NAME
   5 ----
   6 perf-report - Read perf.data (created by perf record) and display the profile
   7
   8 SYNOPSIS
   9 --------
  10 [verse]
  11 'perf report' [-i <file> | --input=file]
  12
  13 DESCRIPTION
  14 -----------
  15 This command displays the performance counter profile information recorded
  16 via perf record.
  17
  18 OPTIONS
  19 -------
  20 -i::
  21 --input=::
  22         Input file name. (default: perf.data)
  23 -d::
  24 --dsos=::
  25         Only consider symbols in these dsos. CSV that understands
  26         file://filename entries.
  27 -n::
  28 --show-nr-samples::
  29         Show the number of samples for each symbol
  30 -T::
  31 --threads::
  32         Show per-thread event counters
  33 -C::
  34 --comms=::
  35         Only consider symbols in these comms. CSV that understands
  36         file://filename entries.
  37 -S::
  38 --symbols=::
  39         Only consider these symbols. CSV that understands
  40         file://filename entries.
  41
  42 -s::
  43 --sort=::
  44         Sort by key(s): pid, comm, dso, symbol, parent.
  45
  46 -w::
  47 --field-width=::
  48         Force each column width to the provided list, for large terminal
  49         readability.
  50
  51 -t::
  52 --field-separator=::
  53
  54         Use a special separator character and don't pad with spaces, replacing
  55         all occurances of this separator in symbol names (and other output)
  56         with a '.' character, that thus it's the only non valid separator.
  57
  58 -g [type,min]::
  59 --call-graph::
  60         Display callchains using type and min percent threshold.
  61         type can be either:
  62         - flat: single column, linear exposure of callchains.
  63         - graph: use a graph tree, displaying absolute overhead rates.
  64         - fractal: like graph, but displays relative rates. Each branch of
  65                  the tree is considered as a new profiled object. +
  66         Default: fractal,0.5.
  67
  68 SEE ALSO
  69 --------
  70 linkperf:perf-stat[1]