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 -w::
  43 --field-width=::
  44         Force each column width to the provided list, for large terminal
  45         readability.
  46
  47 -t::
  48 --field-separator=::
  49
  50         Use a special separator character and don't pad with spaces, replacing
  51         all occurances of this separator in symbol names (and other output)
  52         with a '.' character, that thus it's the only non valid separator.
  53
  54 -g [type,min]::
  55 --call-graph::
  56         Display callchains using type and min percent threshold.
  57         type can be either:
  58         - flat: single column, linear exposure of callchains.
  59         - graph: use a graph tree, displaying absolute overhead rates.
  60         - fractal: like graph, but displays relative rates. Each branch of
  61                  the tree is considered as a new profiled object. +
  62         Default: fractal,0.5.
  63
  64 SEE ALSO
  65 --------
  66 linkperf:perf-stat[1]