projects / deliverable / linux.git / blame
| Commit | Line | Data |
|---|---|---|
| 86a9eee0 | 1 | perf-diff(1) |
| 4778e0e8 | 2 | ============ |
| 86a9eee0 ACM |
3 | |
| 4 | NAME | |
| 5 | ---- | |
| d30531c6 | 6 | perf-diff - Read two perf.data files and display the differential profile |
| 86a9eee0 ACM |
7 | |
| 8 | SYNOPSIS | |
| 9 | -------- | |
| 10 | [verse] | |
| 11 | 'perf diff' [oldfile] [newfile] | |
| 12 | ||
| 13 | DESCRIPTION | |
| 14 | ----------- | |
| d30531c6 | 15 | This command displays the performance difference amongst two perf.data files |
| 86a9eee0 ACM |
16 | captured via perf record. |
| 17 | ||
| 18 | If no parameters are passed it will assume perf.data.old and perf.data. | |
| 19 | ||
| 863e451f JO |
20 | The differential profile is displayed only for events matching both |
| 21 | specified perf.data files. | |
| 22 | ||
| 86a9eee0 ACM |
23 | OPTIONS |
| 24 | ------- | |
| 5ea4f857 SB |
25 | -M:: |
| 26 | --displacement:: | |
| 27 | Show position displacement relative to baseline. | |
| 28 | ||
| 29 | -D:: | |
| 30 | --dump-raw-trace:: | |
| 31 | Dump raw trace in ASCII. | |
| 32 | ||
| 33 | -m:: | |
| 34 | --modules:: | |
| 35 | Load module symbols. WARNING: use only with -k and LIVE kernel | |
| 36 | ||
| c351c281 ACM |
37 | -d:: |
| 38 | --dsos=:: | |
| 39 | Only consider symbols in these dsos. CSV that understands | |
| 40 | file://filename entries. | |
| 41 | ||
| 42 | -C:: | |
| 43 | --comms=:: | |
| 44 | Only consider symbols in these comms. CSV that understands | |
| 45 | file://filename entries. | |
| 46 | ||
| 47 | -S:: | |
| 48 | --symbols=:: | |
| 49 | Only consider these symbols. CSV that understands | |
| 50 | file://filename entries. | |
| 51 | ||
| 52 | -s:: | |
| 53 | --sort=:: | |
| 54 | Sort by key(s): pid, comm, dso, symbol. | |
| 55 | ||
| 56 | -t:: | |
| 57 | --field-separator=:: | |
| 58 | ||
| 59 | Use a special separator character and don't pad with spaces, replacing | |
| 5ea4f857 | 60 | all occurrences of this separator in symbol names (and other output) |
| c351c281 ACM |
61 | with a '.' character, that thus it's the only non valid separator. |
| 62 | ||
| 86a9eee0 ACM |
63 | -v:: |
| 64 | --verbose:: | |
| d30531c6 | 65 | Be verbose, for instance, show the raw counts in addition to the |
| 86a9eee0 | 66 | diff. |
| cdccc690 | 67 | |
| 5ea4f857 SB |
68 | -f:: |
| 69 | --force:: | |
| 70 | Don't complain, do it. | |
| 71 | ||
| ec5761ea DA |
72 | --symfs=<directory>:: |
| 73 | Look for files with symbols relative to this directory. | |
| 5ea4f857 | 74 | |
| a06d143e JO |
75 | -b:: |
| 76 | --baseline-only:: | |
| 77 | Show only items with match in baseline. | |
| 78 | ||
| 7aaf6b35 JO |
79 | -c:: |
| 80 | --compute:: | |
| 81d5f958 | 81 | Differential computation selection - delta,ratio,wdiff (default is delta). |
| 96c47f19 JO |
82 | If '+' is specified as a first character, the output is sorted based |
| 83 | on the computation results. | |
| 7aaf6b35 JO |
84 | See COMPARISON METHODS section for more info. |
| 85 | ||
| 61949b21 JO |
86 | -p:: |
| 87 | --period:: | |
| 88 | Show period values for both compared hist entries. | |
| 89 | ||
| 7aaf6b35 JO |
90 | COMPARISON METHODS |
| 91 | ------------------ | |
| 92 | delta | |
| 93 | ~~~~~ | |
| 94 | If specified the 'Delta' column is displayed with value 'd' computed as: | |
| 95 | ||
| 96 | d = A->period_percent - B->period_percent | |
| 97 | ||
| 98 | with: | |
| 99 | - A/B being matching hist entry from first/second file specified | |
| 100 | (or perf.data/perf.data.old) respectively. | |
| 101 | ||
| 102 | - period_percent being the % of the hist entry period value within | |
| 103 | single data file | |
| 104 | ||
| 105 | ratio | |
| 106 | ~~~~~ | |
| 107 | If specified the 'Ratio' column is displayed with value 'r' computed as: | |
| 108 | ||
| 109 | r = A->period / B->period | |
| 110 | ||
| 111 | with: | |
| 112 | - A/B being matching hist entry from first/second file specified | |
| 113 | (or perf.data/perf.data.old) respectively. | |
| 114 | ||
| 115 | - period being the hist entry period value | |
| 116 | ||
| 81d5f958 JO |
117 | wdiff |
| 118 | ~~~~~ | |
| 119 | If specified the 'Weighted diff' column is displayed with value 'd' computed as: | |
| 120 | ||
| 121 | d = B->period * WEIGHT-A - A->period * WEIGHT-B | |
| 122 | ||
| 123 | - A/B being matching hist entry from first/second file specified | |
| 124 | (or perf.data/perf.data.old) respectively. | |
| 125 | ||
| 126 | - period being the hist entry period value | |
| 127 | ||
| 128 | - WEIGHT-A/WEIGHT-B being user suplied weights in the the '-c' option | |
| 129 | behind ':' separator like '-c wdiff:1,2'. | |
| 7aaf6b35 | 130 | |
| 86a9eee0 ACM |
131 | SEE ALSO |
| 132 | -------- | |
| 133 | linkperf:perf-record[1] |