Merge branch 'for-linus' of git://git.kernel.org/pub/scm/linux/kernel/git/rafael...
[linux-2.6.git] / 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 --stdio:: Use the stdio interface.
69
70 --tui:: Use the TUI interface, that is integrated with annotate and allows
71         zooming into DSOs or threads, among other features. Use of --tui
72         requires a tty, if one is not present, as when piping to other
73         commands, the stdio interface is used.
74
75 SEE ALSO
76 --------
77 linkperf:perf-stat[1]