Skip to content

Commit

Permalink
perf report: Document missing options
Browse files Browse the repository at this point in the history
Cc: Ingo Molnar <mingo@elte.hu>
Cc: Paul Mackerras <paulus@samba.org>
Cc: Peter Zijlstra <a.p.zijlstra@chello.nl>
LKML-Reference: <1291168642-11402-10-git-send-email-shawn.bohrer@gmail.com>
Signed-off-by: Shawn Bohrer <shawn.bohrer@gmail.com>
Signed-off-by: Arnaldo Carvalho de Melo <acme@redhat.com>
  • Loading branch information
Shawn Bohrer authored and Arnaldo Carvalho de Melo committed Dec 1, 2010
1 parent 08dbd7e commit e04fffc
Showing 1 changed file with 45 additions and 4 deletions.
49 changes: 45 additions & 4 deletions tools/perf/Documentation/perf-report.txt
Original file line number Diff line number Diff line change
Expand Up @@ -20,13 +20,22 @@ 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
Expand All @@ -39,39 +48,71 @@ OPTIONS
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::
--field-width=::
--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 occurances of this separator in symbol names (and other output)
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]::
--call-graph::
Display callchains using type and min percent threshold.
Display call chains using type and min percent threshold.
type can be either:
- flat: single column, linear exposure of callchains.
- 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. +
Default: fractal,0.5.

--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

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

-f::
--force::
Don't complain, do it.

SEE ALSO
--------
linkperf:perf-stat[1]

0 comments on commit e04fffc

Please sign in to comment.