| Arnaldo Carvalho de Melo | 86a9eee | 2009-12-14 20:09:31 -0200 | [diff] [blame] | 1 | perf-diff(1) | 
| Arnaldo Carvalho de Melo | 4778e0e | 2010-05-05 11:23:27 -0300 | [diff] [blame] | 2 | ============ | 
| Arnaldo Carvalho de Melo | 86a9eee | 2009-12-14 20:09:31 -0200 | [diff] [blame] | 3 |  | 
|  | 4 | NAME | 
|  | 5 | ---- | 
| Ingo Molnar | d30531c | 2009-12-15 10:24:08 +0100 | [diff] [blame] | 6 | perf-diff - Read two perf.data files and display the differential profile | 
| Arnaldo Carvalho de Melo | 86a9eee | 2009-12-14 20:09:31 -0200 | [diff] [blame] | 7 |  | 
|  | 8 | SYNOPSIS | 
|  | 9 | -------- | 
|  | 10 | [verse] | 
|  | 11 | 'perf diff' [oldfile] [newfile] | 
|  | 12 |  | 
|  | 13 | DESCRIPTION | 
|  | 14 | ----------- | 
| Ingo Molnar | d30531c | 2009-12-15 10:24:08 +0100 | [diff] [blame] | 15 | This command displays the performance difference amongst two perf.data files | 
| Arnaldo Carvalho de Melo | 86a9eee | 2009-12-14 20:09:31 -0200 | [diff] [blame] | 16 | captured via perf record. | 
|  | 17 |  | 
|  | 18 | If no parameters are passed it will assume perf.data.old and perf.data. | 
|  | 19 |  | 
|  | 20 | OPTIONS | 
|  | 21 | ------- | 
| Shawn Bohrer | 5ea4f85 | 2010-11-30 19:57:12 -0600 | [diff] [blame] | 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 |  | 
| Arnaldo Carvalho de Melo | c351c28 | 2009-12-16 13:49:27 -0200 | [diff] [blame] | 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 | 
| Shawn Bohrer | 5ea4f85 | 2010-11-30 19:57:12 -0600 | [diff] [blame] | 57 | all occurrences of this separator in symbol names (and other output) | 
| Arnaldo Carvalho de Melo | c351c28 | 2009-12-16 13:49:27 -0200 | [diff] [blame] | 58 | with a '.' character, that thus it's the only non valid separator. | 
|  | 59 |  | 
| Arnaldo Carvalho de Melo | 86a9eee | 2009-12-14 20:09:31 -0200 | [diff] [blame] | 60 | -v:: | 
|  | 61 | --verbose:: | 
| Ingo Molnar | d30531c | 2009-12-15 10:24:08 +0100 | [diff] [blame] | 62 | Be verbose, for instance, show the raw counts in addition to the | 
| Arnaldo Carvalho de Melo | 86a9eee | 2009-12-14 20:09:31 -0200 | [diff] [blame] | 63 | diff. | 
| Arnaldo Carvalho de Melo | cdccc69 | 2009-12-15 11:01:22 -0200 | [diff] [blame] | 64 |  | 
| Shawn Bohrer | 5ea4f85 | 2010-11-30 19:57:12 -0600 | [diff] [blame] | 65 | -f:: | 
|  | 66 | --force:: | 
|  | 67 | Don't complain, do it. | 
|  | 68 |  | 
| David Ahern | ec5761e | 2010-12-09 13:27:07 -0700 | [diff] [blame] | 69 | --symfs=<directory>:: | 
|  | 70 | Look for files with symbols relative to this directory. | 
| Shawn Bohrer | 5ea4f85 | 2010-11-30 19:57:12 -0600 | [diff] [blame] | 71 |  | 
| Arnaldo Carvalho de Melo | 86a9eee | 2009-12-14 20:09:31 -0200 | [diff] [blame] | 72 | SEE ALSO | 
|  | 73 | -------- | 
|  | 74 | linkperf:perf-record[1] |