GNU Linux-libre 4.9.337-gnu1
[releases.git] / tools / perf / Documentation / itrace.txt
1                 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
6                 e       synthesize error events
7                 d       create a debug log
8                 g       synthesize a call chain (use with i or x)
9                 l       synthesize last branch entries (use with i or x)
10                 s       skip initial number of events
11
12         The default is all events i.e. the same as --itrace=ibxe
13
14         In addition, the period (default 100000) for instructions events
15         can be specified in units of:
16
17                 i       instructions
18                 t       ticks
19                 ms      milliseconds
20                 us      microseconds
21                 ns      nanoseconds (default)
22
23         Also the call chain size (default 16, max. 1024) for instructions or
24         transactions events can be specified.
25
26         Also the number of last branch entries (default 64, max. 1024) for
27         instructions or transactions events can be specified.
28
29         It is also possible to skip events generated (instructions, branches, transactions)
30         at the beginning. This is useful to ignore initialization code.
31
32         --itrace=i0nss1000000
33
34         skips the first million instructions.