blob: 271484754feefb2f73047990cea61483d608aa5c [file] [log] [blame]
Adrian Hunter60b88d82015-07-17 19:33:44 +03001 i synthesize instructions events
2 b synthesize branches events
3 c synthesize branches events (calls only)
4 r synthesize branches events (returns only)
5 x synthesize transactions events
Adrian Hunter3bdafdf2017-05-26 11:17:24 +03006 w synthesize ptwrite events
Adrian Hunter70d110d2017-05-26 11:17:25 +03007 p synthesize power events
Adrian Hunter181ebb52019-08-06 11:46:03 +03008 o synthesize other events recorded due to the use
9 of aux-output (refer to perf record)
Adrian Hunter60b88d82015-07-17 19:33:44 +030010 e synthesize error events
11 d create a debug log
12 g synthesize a call chain (use with i or x)
Adrian Hunter1c5c25b2020-04-01 13:16:05 +030013 G synthesize a call chain on existing event records
Adrian Hunter601897b2015-09-25 16:15:39 +030014 l synthesize last branch entries (use with i or x)
Adrian Hunterec90e422020-04-29 18:07:46 +030015 L synthesize last branch entries on existing event records
Andi Kleend1706b32016-03-28 10:45:38 -070016 s skip initial number of events
Adrian Hunter60b88d82015-07-17 19:33:44 +030017
Andi Kleen4eb06812018-09-20 11:05:37 -070018 The default is all events i.e. the same as --itrace=ibxwpe,
19 except for perf script where it is --itrace=ce
Adrian Hunter60b88d82015-07-17 19:33:44 +030020
Andi Kleen4eb06812018-09-20 11:05:37 -070021 In addition, the period (default 100000, except for perf script where it is 1)
22 for instructions events can be specified in units of:
Adrian Hunter60b88d82015-07-17 19:33:44 +030023
24 i instructions
25 t ticks
26 ms milliseconds
27 us microseconds
28 ns nanoseconds (default)
29
30 Also the call chain size (default 16, max. 1024) for instructions or
31 transactions events can be specified.
Adrian Hunter601897b2015-09-25 16:15:39 +030032
33 Also the number of last branch entries (default 64, max. 1024) for
34 instructions or transactions events can be specified.
Andi Kleend1706b32016-03-28 10:45:38 -070035
Adrian Hunter43358d92020-04-29 18:07:50 +030036 Similar to options g and l, size may also be specified for options G and L.
37 On x86, note that G and L work poorly when data has been recorded with
38 large PEBS. Refer linkperf:perf-intel-pt[1] man page for details.
39
Adrian Hunter3bdafdf2017-05-26 11:17:24 +030040 It is also possible to skip events generated (instructions, branches, transactions,
Adrian Hunter70d110d2017-05-26 11:17:25 +030041 ptwrite, power) at the beginning. This is useful to ignore initialization code.
Andi Kleend1706b32016-03-28 10:45:38 -070042
43 --itrace=i0nss1000000
44
45 skips the first million instructions.