~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

TOMOYO Linux Cross Reference
Linux/tools/perf/Documentation/intel-hybrid.txt

Version: ~ [ linux-6.12-rc7 ] ~ [ linux-6.11.7 ] ~ [ linux-6.10.14 ] ~ [ linux-6.9.12 ] ~ [ linux-6.8.12 ] ~ [ linux-6.7.12 ] ~ [ linux-6.6.60 ] ~ [ linux-6.5.13 ] ~ [ linux-6.4.16 ] ~ [ linux-6.3.13 ] ~ [ linux-6.2.16 ] ~ [ linux-6.1.116 ] ~ [ linux-6.0.19 ] ~ [ linux-5.19.17 ] ~ [ linux-5.18.19 ] ~ [ linux-5.17.15 ] ~ [ linux-5.16.20 ] ~ [ linux-5.15.171 ] ~ [ linux-5.14.21 ] ~ [ linux-5.13.19 ] ~ [ linux-5.12.19 ] ~ [ linux-5.11.22 ] ~ [ linux-5.10.229 ] ~ [ linux-5.9.16 ] ~ [ linux-5.8.18 ] ~ [ linux-5.7.19 ] ~ [ linux-5.6.19 ] ~ [ linux-5.5.19 ] ~ [ linux-5.4.285 ] ~ [ linux-5.3.18 ] ~ [ linux-5.2.21 ] ~ [ linux-5.1.21 ] ~ [ linux-5.0.21 ] ~ [ linux-4.20.17 ] ~ [ linux-4.19.323 ] ~ [ linux-4.18.20 ] ~ [ linux-4.17.19 ] ~ [ linux-4.16.18 ] ~ [ linux-4.15.18 ] ~ [ linux-4.14.336 ] ~ [ linux-4.13.16 ] ~ [ linux-4.12.14 ] ~ [ linux-4.11.12 ] ~ [ linux-4.10.17 ] ~ [ linux-4.9.337 ] ~ [ linux-4.4.302 ] ~ [ linux-3.10.108 ] ~ [ linux-2.6.32.71 ] ~ [ linux-2.6.0 ] ~ [ linux-2.4.37.11 ] ~ [ unix-v6-master ] ~ [ ccs-tools-1.8.12 ] ~ [ policy-sample ] ~
Architecture: ~ [ i386 ] ~ [ alpha ] ~ [ m68k ] ~ [ mips ] ~ [ ppc ] ~ [ sparc ] ~ [ sparc64 ] ~

Diff markup

Differences between /tools/perf/Documentation/intel-hybrid.txt (Version linux-6.12-rc7) and /tools/perf/Documentation/intel-hybrid.txt (Version linux-6.11.7)


  1 Intel hybrid support                                1 Intel hybrid support
  2 --------------------                                2 --------------------
  3 Support for Intel hybrid events within perf to      3 Support for Intel hybrid events within perf tools.
  4                                                     4 
  5 For some Intel platforms, such as AlderLake, w      5 For some Intel platforms, such as AlderLake, which is hybrid platform and
  6 it consists of atom cpu and core cpu. Each cpu      6 it consists of atom cpu and core cpu. Each cpu has dedicated event list.
  7 Part of events are available on core cpu, part      7 Part of events are available on core cpu, part of events are available
  8 on atom cpu and even part of events are availa      8 on atom cpu and even part of events are available on both.
  9                                                     9 
 10 Kernel exports two new cpu pmus via sysfs:         10 Kernel exports two new cpu pmus via sysfs:
 11 /sys/devices/cpu_core                              11 /sys/devices/cpu_core
 12 /sys/devices/cpu_atom                              12 /sys/devices/cpu_atom
 13                                                    13 
 14 The 'cpus' files are created under the directo     14 The 'cpus' files are created under the directories. For example,
 15                                                    15 
 16 cat /sys/devices/cpu_core/cpus                     16 cat /sys/devices/cpu_core/cpus
 17 0-15                                               17 0-15
 18                                                    18 
 19 cat /sys/devices/cpu_atom/cpus                     19 cat /sys/devices/cpu_atom/cpus
 20 16-23                                              20 16-23
 21                                                    21 
 22 It indicates cpu0-cpu15 are core cpus and cpu1     22 It indicates cpu0-cpu15 are core cpus and cpu16-cpu23 are atom cpus.
 23                                                    23 
 24 As before, use perf-list to list the symbolic      24 As before, use perf-list to list the symbolic event.
 25                                                    25 
 26 perf list                                          26 perf list
 27                                                    27 
 28 inst_retired.any                                   28 inst_retired.any
 29         [Fixed Counter: Counts the number of i     29         [Fixed Counter: Counts the number of instructions retired. Unit: cpu_atom]
 30 inst_retired.any                                   30 inst_retired.any
 31         [Number of instructions retired. Fixed     31         [Number of instructions retired. Fixed Counter - architectural event. Unit: cpu_core]
 32                                                    32 
 33 The 'Unit: xxx' is added to brief description      33 The 'Unit: xxx' is added to brief description to indicate which pmu
 34 the event is belong to. Same event name but wi     34 the event is belong to. Same event name but with different pmu can
 35 be supported.                                      35 be supported.
 36                                                    36 
 37 Enable hybrid event with a specific pmu            37 Enable hybrid event with a specific pmu
 38                                                    38 
 39 To enable a core only event or atom only event     39 To enable a core only event or atom only event, following syntax is supported:
 40                                                    40 
 41         cpu_core/<event name>/                     41         cpu_core/<event name>/
 42 or                                                 42 or
 43         cpu_atom/<event name>/                     43         cpu_atom/<event name>/
 44                                                    44 
 45 For example, count the 'cycles' event on core      45 For example, count the 'cycles' event on core cpus.
 46                                                    46 
 47         perf stat -e cpu_core/cycles/              47         perf stat -e cpu_core/cycles/
 48                                                    48 
 49 Create two events for one hardware event autom     49 Create two events for one hardware event automatically
 50                                                    50 
 51 When creating one event and the event is avail     51 When creating one event and the event is available on both atom and core,
 52 two events are created automatically. One is f     52 two events are created automatically. One is for atom, the other is for
 53 core. Most of hardware events and cache events     53 core. Most of hardware events and cache events are available on both
 54 cpu_core and cpu_atom.                             54 cpu_core and cpu_atom.
 55                                                    55 
 56 For hardware events, they have pre-defined con     56 For hardware events, they have pre-defined configs (e.g. 0 for cycles).
 57 But on hybrid platform, kernel needs to know w     57 But on hybrid platform, kernel needs to know where the event comes from
 58 (from atom or from core). The original perf ev     58 (from atom or from core). The original perf event type PERF_TYPE_HARDWARE
 59 can't carry pmu information. So now this type      59 can't carry pmu information. So now this type is extended to be PMU aware
 60 type. The PMU type ID is stored at attr.config     60 type. The PMU type ID is stored at attr.config[63:32].
 61                                                    61 
 62 PMU type ID is retrieved from sysfs.               62 PMU type ID is retrieved from sysfs.
 63 /sys/devices/cpu_atom/type                         63 /sys/devices/cpu_atom/type
 64 /sys/devices/cpu_core/type                         64 /sys/devices/cpu_core/type
 65                                                    65 
 66 The new attr.config layout for PERF_TYPE_HARDW     66 The new attr.config layout for PERF_TYPE_HARDWARE:
 67                                                    67 
 68 PERF_TYPE_HARDWARE:                 0xEEEEEEEE     68 PERF_TYPE_HARDWARE:                 0xEEEEEEEE000000AA
 69                                     AA: hardwa     69                                     AA: hardware event ID
 70                                     EEEEEEEE:      70                                     EEEEEEEE: PMU type ID
 71                                                    71 
 72 Cache event is similar. The type PERF_TYPE_HW_     72 Cache event is similar. The type PERF_TYPE_HW_CACHE is extended to be
 73 PMU aware type. The PMU type ID is stored at a     73 PMU aware type. The PMU type ID is stored at attr.config[63:32].
 74                                                    74 
 75 The new attr.config layout for PERF_TYPE_HW_CA     75 The new attr.config layout for PERF_TYPE_HW_CACHE:
 76                                                    76 
 77 PERF_TYPE_HW_CACHE:                 0xEEEEEEEE     77 PERF_TYPE_HW_CACHE:                 0xEEEEEEEE00DDCCBB
 78                                     BB: hardwa     78                                     BB: hardware cache ID
 79                                     CC: hardwa     79                                     CC: hardware cache op ID
 80                                     DD: hardwa     80                                     DD: hardware cache op result ID
 81                                     EEEEEEEE:      81                                     EEEEEEEE: PMU type ID
 82                                                    82 
 83 When enabling a hardware event without specifi     83 When enabling a hardware event without specified pmu, such as,
 84 perf stat -e cycles -a (use system-wide in thi     84 perf stat -e cycles -a (use system-wide in this example), two events
 85 are created automatically.                         85 are created automatically.
 86                                                    86 
 87   --------------------------------------------     87   ------------------------------------------------------------
 88   perf_event_attr:                                 88   perf_event_attr:
 89     size                             120           89     size                             120
 90     config                           0x4000000     90     config                           0x400000000
 91     sample_type                      IDENTIFIE     91     sample_type                      IDENTIFIER
 92     read_format                      TOTAL_TIM     92     read_format                      TOTAL_TIME_ENABLED|TOTAL_TIME_RUNNING
 93     disabled                         1             93     disabled                         1
 94     inherit                          1             94     inherit                          1
 95     exclude_guest                    1             95     exclude_guest                    1
 96   --------------------------------------------     96   ------------------------------------------------------------
 97                                                    97 
 98 and                                                98 and
 99                                                    99 
100   --------------------------------------------    100   ------------------------------------------------------------
101   perf_event_attr:                                101   perf_event_attr:
102     size                             120          102     size                             120
103     config                           0x8000000    103     config                           0x800000000
104     sample_type                      IDENTIFIE    104     sample_type                      IDENTIFIER
105     read_format                      TOTAL_TIM    105     read_format                      TOTAL_TIME_ENABLED|TOTAL_TIME_RUNNING
106     disabled                         1            106     disabled                         1
107     inherit                          1            107     inherit                          1
108     exclude_guest                    1            108     exclude_guest                    1
109   --------------------------------------------    109   ------------------------------------------------------------
110                                                   110 
111 type 0 is PERF_TYPE_HARDWARE.                     111 type 0 is PERF_TYPE_HARDWARE.
112 0x4 in 0x400000000 indicates it's cpu_core pmu    112 0x4 in 0x400000000 indicates it's cpu_core pmu.
113 0x8 in 0x800000000 indicates it's cpu_atom pmu    113 0x8 in 0x800000000 indicates it's cpu_atom pmu (atom pmu type id is random).
114                                                   114 
115 The kernel creates 'cycles' (0x400000000) on c    115 The kernel creates 'cycles' (0x400000000) on cpu0-cpu15 (core cpus),
116 and create 'cycles' (0x800000000) on cpu16-cpu    116 and create 'cycles' (0x800000000) on cpu16-cpu23 (atom cpus).
117                                                   117 
118 For perf-stat result, it displays two events:     118 For perf-stat result, it displays two events:
119                                                   119 
120  Performance counter stats for 'system wide':     120  Performance counter stats for 'system wide':
121                                                   121 
122            6,744,979      cpu_core/cycles/        122            6,744,979      cpu_core/cycles/
123            1,965,552      cpu_atom/cycles/        123            1,965,552      cpu_atom/cycles/
124                                                   124 
125 The first 'cycles' is core event, the second '    125 The first 'cycles' is core event, the second 'cycles' is atom event.
126                                                   126 
127 Thread mode example:                              127 Thread mode example:
128                                                   128 
129 perf-stat reports the scaled counts for hybrid    129 perf-stat reports the scaled counts for hybrid event and with a percentage
130 displayed. The percentage is the event's runni    130 displayed. The percentage is the event's running time/enabling time.
131                                                   131 
132 One example, 'triad_loop' runs on cpu16 (atom     132 One example, 'triad_loop' runs on cpu16 (atom core), while we can see the
133 scaled value for core cycles is 160,444,092 an    133 scaled value for core cycles is 160,444,092 and the percentage is 0.47%.
134                                                   134 
135 perf stat -e cycles \-- taskset -c 16 ./triad_    135 perf stat -e cycles \-- taskset -c 16 ./triad_loop
136                                                   136 
137 As previous, two events are created.              137 As previous, two events are created.
138                                                   138 
139 ----------------------------------------------    139 ------------------------------------------------------------
140 perf_event_attr:                                  140 perf_event_attr:
141   size                             120            141   size                             120
142   config                           0x400000000    142   config                           0x400000000
143   sample_type                      IDENTIFIER     143   sample_type                      IDENTIFIER
144   read_format                      TOTAL_TIME_    144   read_format                      TOTAL_TIME_ENABLED|TOTAL_TIME_RUNNING
145   disabled                         1              145   disabled                         1
146   inherit                          1              146   inherit                          1
147   enable_on_exec                   1              147   enable_on_exec                   1
148   exclude_guest                    1              148   exclude_guest                    1
149 ----------------------------------------------    149 ------------------------------------------------------------
150                                                   150 
151 and                                               151 and
152                                                   152 
153 ----------------------------------------------    153 ------------------------------------------------------------
154 perf_event_attr:                                  154 perf_event_attr:
155   size                             120            155   size                             120
156   config                           0x800000000    156   config                           0x800000000
157   sample_type                      IDENTIFIER     157   sample_type                      IDENTIFIER
158   read_format                      TOTAL_TIME_    158   read_format                      TOTAL_TIME_ENABLED|TOTAL_TIME_RUNNING
159   disabled                         1              159   disabled                         1
160   inherit                          1              160   inherit                          1
161   enable_on_exec                   1              161   enable_on_exec                   1
162   exclude_guest                    1              162   exclude_guest                    1
163 ----------------------------------------------    163 ------------------------------------------------------------
164                                                   164 
165  Performance counter stats for 'taskset -c 16     165  Performance counter stats for 'taskset -c 16 ./triad_loop':
166                                                   166 
167        233,066,666      cpu_core/cycles/          167        233,066,666      cpu_core/cycles/                                              (0.43%)
168        604,097,080      cpu_atom/cycles/          168        604,097,080      cpu_atom/cycles/                                              (99.57%)
169                                                   169 
170 perf-record:                                      170 perf-record:
171                                                   171 
172 If there is no '-e' specified in perf record,     172 If there is no '-e' specified in perf record, on hybrid platform,
173 it creates two default 'cycles' and adds them     173 it creates two default 'cycles' and adds them to event list. One
174 is for core, the other is for atom.               174 is for core, the other is for atom.
175                                                   175 
176 perf-stat:                                        176 perf-stat:
177                                                   177 
178 If there is no '-e' specified in perf stat, on    178 If there is no '-e' specified in perf stat, on hybrid platform,
179 besides of software events, following events a    179 besides of software events, following events are created and
180 added to event list in order.                     180 added to event list in order.
181                                                   181 
182 cpu_core/cycles/,                                 182 cpu_core/cycles/,
183 cpu_atom/cycles/,                                 183 cpu_atom/cycles/,
184 cpu_core/instructions/,                           184 cpu_core/instructions/,
185 cpu_atom/instructions/,                           185 cpu_atom/instructions/,
186 cpu_core/branches/,                               186 cpu_core/branches/,
187 cpu_atom/branches/,                               187 cpu_atom/branches/,
188 cpu_core/branch-misses/,                          188 cpu_core/branch-misses/,
189 cpu_atom/branch-misses/                           189 cpu_atom/branch-misses/
190                                                   190 
191 Of course, both perf-stat and perf-record supp    191 Of course, both perf-stat and perf-record support to enable
192 hybrid event with a specific pmu.                 192 hybrid event with a specific pmu.
193                                                   193 
194 e.g.                                              194 e.g.
195 perf stat -e cpu_core/cycles/                     195 perf stat -e cpu_core/cycles/
196 perf stat -e cpu_atom/cycles/                     196 perf stat -e cpu_atom/cycles/
197 perf stat -e cpu_core/r1a/                        197 perf stat -e cpu_core/r1a/
198 perf stat -e cpu_atom/L1-icache-loads/            198 perf stat -e cpu_atom/L1-icache-loads/
199 perf stat -e cpu_core/cycles/,cpu_atom/instruc    199 perf stat -e cpu_core/cycles/,cpu_atom/instructions/
200 perf stat -e '{cpu_core/cycles/,cpu_core/instr    200 perf stat -e '{cpu_core/cycles/,cpu_core/instructions/}'
201                                                   201 
202 But '{cpu_core/cycles/,cpu_atom/instructions/}    202 But '{cpu_core/cycles/,cpu_atom/instructions/}' will return
203 warning and disable grouping, because the pmus    203 warning and disable grouping, because the pmus in group are
204 not matched (cpu_core vs. cpu_atom).              204 not matched (cpu_core vs. cpu_atom).
                                                      

~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

kernel.org | git.kernel.org | LWN.net | Project Home | SVN repository | Mail admin

Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.

sflogo.php