96c47f1984
Adding support to sort hist entries based on the outcome of selected
computation. It's now possible to specify '+' as a first character of
'-c' option value to make such sort.
Example:
$ perf diff -c ratio -b
# Event 'cache-misses'
#
# Baseline Ratio Shared Object Symbol
# ........ .............. ................. ................................
#
19.64% 0.69 [kernel.kallsyms] [k] clear_page
0.30% 0.17 [kernel.kallsyms] [k] mm_alloc
0.04% 0.20 [kernel.kallsyms] [k] kmem_cache_alloc
$ perf diff -c +ratio -b
# Event 'cache-misses'
#
# Baseline Ratio Shared Object Symbol
# ........ .............. ................. ................................
#
19.64% 0.69 [kernel.kallsyms] [k] clear_page
0.04% 0.20 [kernel.kallsyms] [k] kmem_cache_alloc
0.30% 0.17 [kernel.kallsyms] [k] mm_alloc
Signed-off-by: Jiri Olsa <jolsa@redhat.com>
Cc: Andi Kleen <andi@firstfloor.org>
Cc: Corey Ashford <cjashfor@linux.vnet.ibm.com>
Cc: Frederic Weisbecker <fweisbec@gmail.com>
Cc: Ingo Molnar <mingo@elte.hu>
Cc: Namhyung Kim <namhyung@kernel.org>
Cc: Paul Mackerras <paulus@samba.org>
Cc: Peter Zijlstra <a.p.zijlstra@chello.nl>
Link: http://lkml.kernel.org/r/1349448287-18919-4-git-send-email-jolsa@redhat.com
Signed-off-by: Arnaldo Carvalho de Melo <acme@redhat.com>
117 lines
2.5 KiB
Plaintext
117 lines
2.5 KiB
Plaintext
perf-diff(1)
|
|
============
|
|
|
|
NAME
|
|
----
|
|
perf-diff - Read two perf.data files and display the differential profile
|
|
|
|
SYNOPSIS
|
|
--------
|
|
[verse]
|
|
'perf diff' [oldfile] [newfile]
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
This command displays the performance difference amongst two perf.data files
|
|
captured via perf record.
|
|
|
|
If no parameters are passed it will assume perf.data.old and perf.data.
|
|
|
|
The differential profile is displayed only for events matching both
|
|
specified perf.data files.
|
|
|
|
OPTIONS
|
|
-------
|
|
-M::
|
|
--displacement::
|
|
Show position displacement relative to baseline.
|
|
|
|
-D::
|
|
--dump-raw-trace::
|
|
Dump raw trace in ASCII.
|
|
|
|
-m::
|
|
--modules::
|
|
Load module symbols. WARNING: use only with -k and LIVE kernel
|
|
|
|
-d::
|
|
--dsos=::
|
|
Only consider symbols in these dsos. CSV that understands
|
|
file://filename entries.
|
|
|
|
-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.
|
|
|
|
-s::
|
|
--sort=::
|
|
Sort by key(s): pid, comm, dso, symbol.
|
|
|
|
-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.
|
|
|
|
-v::
|
|
--verbose::
|
|
Be verbose, for instance, show the raw counts in addition to the
|
|
diff.
|
|
|
|
-f::
|
|
--force::
|
|
Don't complain, do it.
|
|
|
|
--symfs=<directory>::
|
|
Look for files with symbols relative to this directory.
|
|
|
|
-b::
|
|
--baseline-only::
|
|
Show only items with match in baseline.
|
|
|
|
-c::
|
|
--compute::
|
|
Differential computation selection - delta,ratio (default is delta).
|
|
If '+' is specified as a first character, the output is sorted based
|
|
on the computation results.
|
|
See COMPARISON METHODS section for more info.
|
|
|
|
COMPARISON METHODS
|
|
------------------
|
|
delta
|
|
~~~~~
|
|
If specified the 'Delta' column is displayed with value 'd' computed as:
|
|
|
|
d = A->period_percent - B->period_percent
|
|
|
|
with:
|
|
- A/B being matching hist entry from first/second file specified
|
|
(or perf.data/perf.data.old) respectively.
|
|
|
|
- period_percent being the % of the hist entry period value within
|
|
single data file
|
|
|
|
ratio
|
|
~~~~~
|
|
If specified the 'Ratio' column is displayed with value 'r' computed as:
|
|
|
|
r = A->period / B->period
|
|
|
|
with:
|
|
- A/B being matching hist entry from first/second file specified
|
|
(or perf.data/perf.data.old) respectively.
|
|
|
|
- period being the hist entry period value
|
|
|
|
|
|
SEE ALSO
|
|
--------
|
|
linkperf:perf-record[1]
|