2009-05-26 03:17:18 -04:00
|
|
|
perf-report(1)
|
2009-05-30 06:38:51 -04:00
|
|
|
==============
|
2009-05-26 03:17:18 -04:00
|
|
|
|
|
|
|
|
NAME
|
|
|
|
|
----
|
2009-05-27 03:33:18 -04:00
|
|
|
perf-report - Read perf.data (created by perf record) and display the profile
|
2009-05-26 03:17:18 -04:00
|
|
|
|
|
|
|
|
SYNOPSIS
|
|
|
|
|
--------
|
|
|
|
|
[verse]
|
|
|
|
|
'perf report' [-i <file> | --input=file]
|
|
|
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
|
-----------
|
|
|
|
|
This command displays the performance counter profile information recorded
|
2009-06-23 10:39:53 -04:00
|
|
|
via perf record.
|
2009-05-26 03:17:18 -04:00
|
|
|
|
|
|
|
|
OPTIONS
|
|
|
|
|
-------
|
|
|
|
|
-i::
|
|
|
|
|
--input=::
|
2009-05-27 03:33:18 -04:00
|
|
|
Input file name. (default: perf.data)
|
2009-06-30 18:01:20 -04:00
|
|
|
-d::
|
|
|
|
|
--dsos=::
|
|
|
|
|
Only consider symbols in these dsos. CSV that understands
|
|
|
|
|
file://filename entries.
|
2009-11-09 06:26:13 -05:00
|
|
|
-n::
|
|
|
|
|
--show-nr-samples::
|
2009-07-11 11:18:37 -04:00
|
|
|
Show the number of samples for each symbol
|
2009-11-09 06:26:13 -05:00
|
|
|
-T::
|
|
|
|
|
--threads::
|
2009-08-07 07:55:24 -04:00
|
|
|
Show per-thread event counters
|
2009-06-30 18:01:21 -04:00
|
|
|
-C::
|
|
|
|
|
--comms=::
|
|
|
|
|
Only consider symbols in these comms. CSV that understands
|
|
|
|
|
file://filename entries.
|
2009-06-30 18:01:22 -04:00
|
|
|
-S::
|
|
|
|
|
--symbols=::
|
|
|
|
|
Only consider these symbols. CSV that understands
|
|
|
|
|
file://filename entries.
|
2009-05-26 03:17:18 -04:00
|
|
|
|
perf diff: Use perf_session__fprintf_hists just like 'perf record'
That means that almost everything you can do with 'perf report'
can be done with 'perf diff', for instance:
$ perf record -f find / > /dev/null
[ perf record: Woken up 1 times to write data ]
[ perf record: Captured and wrote 0.062 MB perf.data (~2699
samples) ] $ perf record -f find / > /dev/null
[ perf record: Woken up 1 times to write data ]
[ perf record: Captured and wrote 0.062 MB perf.data (~2687
samples) ] perf diff | head -8
9.02% +1.00% find libc-2.10.1.so [.] _IO_vfprintf_internal
2.91% -1.00% find [kernel] [k] __kmalloc
2.85% -1.00% find [kernel] [k] ext4_htree_store_dirent
1.99% -1.00% find [kernel] [k] _atomic_dec_and_lock
2.44% find [kernel] [k] half_md4_transform
$
So if you want to zoom into libc:
$ perf diff --dsos libc-2.10.1.so | head -8
37.34% find [.] _IO_vfprintf_internal
10.34% find [.] __GI_memmove
8.25% +2.00% find [.] _int_malloc
5.07% -1.00% find [.] __GI_mempcpy
7.62% +2.00% find [.] _int_free
$
And if there were multiple commands using libc, it is also
possible to aggregate them all by using --sort symbol:
$ perf diff --dsos libc-2.10.1.so --sort symbol | head -8
37.34% [.] _IO_vfprintf_internal
10.34% [.] __GI_memmove
8.25% +2.00% [.] _int_malloc
5.07% -1.00% [.] __GI_mempcpy
7.62% +2.00% [.] _int_free
$
The displacement column now is off by default, to use it:
perf diff -m --dsos libc-2.10.1.so --sort symbol | head -8
37.34% [.] _IO_vfprintf_internal
10.34% [.] __GI_memmove
8.25% +2.00% [.] _int_malloc
5.07% -1.00% +2 [.] __GI_mempcpy
7.62% +2.00% -1 [.] _int_free
$
Using -t/--field-separator can be used for scripting:
$ perf diff -t, -m --dsos libc-2.10.1.so --sort symbol | head -8
37.34, , ,[.] _IO_vfprintf_internal
10.34, , ,[.] __GI_memmove
8.25,+2.00%, ,[.] _int_malloc
5.07,-1.00%, +2,[.] __GI_mempcpy
7.62,+2.00%, -1,[.] _int_free
6.99,+1.00%, -1,[.] _IO_new_file_xsputn
1.89,-2.00%, +4,[.] __readdir64
$
Signed-off-by: Arnaldo Carvalho de Melo <acme@redhat.com>
Cc: Frédéric Weisbecker <fweisbec@gmail.com>
Cc: Mike Galbraith <efault@gmx.de>
Cc: Peter Zijlstra <a.p.zijlstra@chello.nl>
Cc: Paul Mackerras <paulus@samba.org>
LKML-Reference: <1260978567-550-1-git-send-email-acme@infradead.org>
Signed-off-by: Ingo Molnar <mingo@elte.hu>
2009-12-16 10:49:27 -05:00
|
|
|
-s::
|
|
|
|
|
--sort=::
|
|
|
|
|
Sort by key(s): pid, comm, dso, symbol, parent.
|
|
|
|
|
|
2009-07-10 21:47:28 -04:00
|
|
|
-w::
|
|
|
|
|
--field-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)
|
|
|
|
|
with a '.' character, that thus it's the only non valid separator.
|
|
|
|
|
|
2009-08-30 21:32:03 -04:00
|
|
|
-g [type,min]::
|
|
|
|
|
--call-graph::
|
|
|
|
|
Display callchains using type and min percent threshold.
|
|
|
|
|
type can be either:
|
|
|
|
|
- flat: single column, linear exposure of callchains.
|
|
|
|
|
- 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.
|
|
|
|
|
|
2009-05-26 03:17:18 -04:00
|
|
|
SEE ALSO
|
|
|
|
|
--------
|
|
|
|
|
linkperf:perf-stat[1]
|
