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