Existing documentation doesn't discuss event modifiers, so add a description of what's currently possible to the documentation of perf-list.
Unified · Split
| @@ -15,6 +15,23 @@ DESCRIPTION · 14 unmodified lines | ||
| 15 | 15 | This command displays the symbolic event types which can be selected in the |
| 16 | 16 | various perf commands with the -e option. |
| 17 | 17 | |
| 18 | +EVENT MODIFIERS | |
| 19 | +--------------- | |
| 20 | + | |
| 21 | +Events can optionally have a modifer by appending a colon and one or | |
| 22 | +more modifiers. Modifiers allow the user to restrict when events are | |
| 23 | +counted with 'u' for user-space, 'k' for kernel, 'h' for hypervisor. | |
| 24 | + | |
| 25 | +The 'p' modifier can be used for specifying how precise the instruction | |
| 26 | +address should be. The 'p' modifier is currently only implemented for | |
| 27 | +Intel PEBS and can be specified multiple times: | |
| 28 | + 0 - SAMPLE_IP can have arbitrary skid | |
| 29 | + 1 - SAMPLE_IP must have constant skid | |
| 30 | + 2 - SAMPLE_IP requested to have 0 skid | |
| 31 | + 3 - SAMPLE_IP must have 0 skid | |
| 32 | + | |
| 33 | +The PEBS implementation now supports up to 2. | |
| 34 | + | |
| 18 | 35 | RAW HARDWARE EVENT DESCRIPTOR |
| 19 | 36 | ----------------------------- |
| 20 | 37 | Even when an event is not available in a symbolic form within perf right now, |