Adrian Hunter | 60b88d8 | 2015-07-17 19:33:44 +0300 | [diff] [blame] | 1 | i synthesize instructions events |
Tan Xiaojun | 9f74d77 | 2020-05-30 20:24:41 +0800 | [diff] [blame] | 2 | b synthesize branches events (branch misses for Arm SPE) |
Adrian Hunter | 60b88d8 | 2015-07-17 19:33:44 +0300 | [diff] [blame] | 3 | c synthesize branches events (calls only) |
| 4 | r synthesize branches events (returns only) |
| 5 | x synthesize transactions events |
Adrian Hunter | 3bdafdf | 2017-05-26 11:17:24 +0300 | [diff] [blame] | 6 | w synthesize ptwrite events |
Adrian Hunter | 70d110d | 2017-05-26 11:17:25 +0300 | [diff] [blame] | 7 | p synthesize power events |
Adrian Hunter | 181ebb5 | 2019-08-06 11:46:03 +0300 | [diff] [blame] | 8 | o synthesize other events recorded due to the use |
| 9 | of aux-output (refer to perf record) |
Adrian Hunter | 60b88d8 | 2015-07-17 19:33:44 +0300 | [diff] [blame] | 10 | e synthesize error events |
| 11 | d create a debug log |
Tan Xiaojun | 9f74d77 | 2020-05-30 20:24:41 +0800 | [diff] [blame] | 12 | f synthesize first level cache events |
| 13 | m synthesize last level cache events |
| 14 | t synthesize TLB events |
| 15 | a synthesize remote access events |
Adrian Hunter | 60b88d8 | 2015-07-17 19:33:44 +0300 | [diff] [blame] | 16 | g synthesize a call chain (use with i or x) |
Adrian Hunter | 1c5c25b | 2020-04-01 13:16:05 +0300 | [diff] [blame] | 17 | G synthesize a call chain on existing event records |
Adrian Hunter | 601897b | 2015-09-25 16:15:39 +0300 | [diff] [blame] | 18 | l synthesize last branch entries (use with i or x) |
Adrian Hunter | ec90e42 | 2020-04-29 18:07:46 +0300 | [diff] [blame] | 19 | L synthesize last branch entries on existing event records |
Andi Kleen | d1706b3 | 2016-03-28 10:45:38 -0700 | [diff] [blame] | 20 | s skip initial number of events |
Adrian Hunter | 5197153 | 2020-07-10 18:11:02 +0300 | [diff] [blame] | 21 | q quicker (less detailed) decoding |
Adrian Hunter | 60b88d8 | 2015-07-17 19:33:44 +0300 | [diff] [blame] | 22 | |
Andi Kleen | 4eb0681 | 2018-09-20 11:05:37 -0700 | [diff] [blame] | 23 | The default is all events i.e. the same as --itrace=ibxwpe, |
| 24 | except for perf script where it is --itrace=ce |
Adrian Hunter | 60b88d8 | 2015-07-17 19:33:44 +0300 | [diff] [blame] | 25 | |
Andi Kleen | 4eb0681 | 2018-09-20 11:05:37 -0700 | [diff] [blame] | 26 | In addition, the period (default 100000, except for perf script where it is 1) |
| 27 | for instructions events can be specified in units of: |
Adrian Hunter | 60b88d8 | 2015-07-17 19:33:44 +0300 | [diff] [blame] | 28 | |
| 29 | i instructions |
| 30 | t ticks |
| 31 | ms milliseconds |
| 32 | us microseconds |
| 33 | ns nanoseconds (default) |
| 34 | |
| 35 | Also the call chain size (default 16, max. 1024) for instructions or |
| 36 | transactions events can be specified. |
Adrian Hunter | 601897b | 2015-09-25 16:15:39 +0300 | [diff] [blame] | 37 | |
| 38 | Also the number of last branch entries (default 64, max. 1024) for |
| 39 | instructions or transactions events can be specified. |
Andi Kleen | d1706b3 | 2016-03-28 10:45:38 -0700 | [diff] [blame] | 40 | |
Adrian Hunter | 43358d9 | 2020-04-29 18:07:50 +0300 | [diff] [blame] | 41 | Similar to options g and l, size may also be specified for options G and L. |
| 42 | On x86, note that G and L work poorly when data has been recorded with |
| 43 | large PEBS. Refer linkperf:perf-intel-pt[1] man page for details. |
| 44 | |
Adrian Hunter | 3bdafdf | 2017-05-26 11:17:24 +0300 | [diff] [blame] | 45 | It is also possible to skip events generated (instructions, branches, transactions, |
Adrian Hunter | 70d110d | 2017-05-26 11:17:25 +0300 | [diff] [blame] | 46 | ptwrite, power) at the beginning. This is useful to ignore initialization code. |
Andi Kleen | d1706b3 | 2016-03-28 10:45:38 -0700 | [diff] [blame] | 47 | |
| 48 | --itrace=i0nss1000000 |
| 49 | |
| 50 | skips the first million instructions. |
Adrian Hunter | cb97143 | 2020-07-10 18:10:57 +0300 | [diff] [blame] | 51 | |
| 52 | The 'e' option may be followed by flags which affect what errors will or |
| 53 | will not be reported. Each flag must be preceded by either '+' or '-'. |
| 54 | The flags are: |
| 55 | o overflow |
| 56 | l trace data lost |
Adrian Hunter | 935aac2 | 2020-07-10 18:10:59 +0300 | [diff] [blame] | 57 | |
| 58 | If supported, the 'd' option may be followed by flags which affect what |
| 59 | debug messages will or will not be logged. Each flag must be preceded |
| 60 | by either '+' or '-'. The flags are: |
| 61 | a all perf events |
Adrian Hunter | 5197153 | 2020-07-10 18:11:02 +0300 | [diff] [blame] | 62 | |
| 63 | If supported, the 'q' option may be repeated to increase the effect. |