perf stat: clarify unsupported events from uncounted events
[linux-2.6-block.git] / tools / perf / Documentation / perf-diff.txt
CommitLineData
86a9eee0 1perf-diff(1)
4778e0e8 2============
86a9eee0
ACM
3
4NAME
5----
d30531c6 6perf-diff - Read two perf.data files and display the differential profile
86a9eee0
ACM
7
8SYNOPSIS
9--------
10[verse]
11'perf diff' [oldfile] [newfile]
12
13DESCRIPTION
14-----------
d30531c6 15This command displays the performance difference amongst two perf.data files
86a9eee0
ACM
16captured via perf record.
17
18If no parameters are passed it will assume perf.data.old and perf.data.
19
20OPTIONS
21-------
5ea4f857
SB
22-M::
23--displacement::
24 Show position displacement relative to baseline.
25
26-D::
27--dump-raw-trace::
28 Dump raw trace in ASCII.
29
30-m::
31--modules::
32 Load module symbols. WARNING: use only with -k and LIVE kernel
33
c351c281
ACM
34-d::
35--dsos=::
36 Only consider symbols in these dsos. CSV that understands
37 file://filename entries.
38
39-C::
40--comms=::
41 Only consider symbols in these comms. CSV that understands
42 file://filename entries.
43
44-S::
45--symbols=::
46 Only consider these symbols. CSV that understands
47 file://filename entries.
48
49-s::
50--sort=::
51 Sort by key(s): pid, comm, dso, symbol.
52
53-t::
54--field-separator=::
55
56 Use a special separator character and don't pad with spaces, replacing
5ea4f857 57 all occurrences of this separator in symbol names (and other output)
c351c281
ACM
58 with a '.' character, that thus it's the only non valid separator.
59
86a9eee0
ACM
60-v::
61--verbose::
d30531c6 62 Be verbose, for instance, show the raw counts in addition to the
86a9eee0 63 diff.
cdccc690 64
5ea4f857
SB
65-f::
66--force::
67 Don't complain, do it.
68
ec5761ea
DA
69--symfs=<directory>::
70 Look for files with symbols relative to this directory.
5ea4f857 71
86a9eee0
ACM
72SEE ALSO
73--------
74linkperf:perf-record[1]