Provided by: linux-tools-common_3.2.0-23.36_all bug

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-stat(1), perf-annotate(1)