drm/nouveau: fix kernel-doc comments
[drm/drm-misc.git] / tools / perf / tests / sample-parsing.c
blob25a3f6cece50549b32c1267b7249a934ec2c5e28
1 // SPDX-License-Identifier: GPL-2.0
2 #include <stdbool.h>
3 #include <inttypes.h>
4 #include <stdlib.h>
5 #include <string.h>
6 #include <linux/bitops.h>
7 #include <linux/kernel.h>
8 #include <linux/types.h>
10 #include "map_symbol.h"
11 #include "branch.h"
12 #include "event.h"
13 #include "evsel.h"
14 #include "debug.h"
15 #include "util/synthetic-events.h"
16 #include "util/util.h"
18 #include "tests.h"
20 #define COMP(m) do { \
21 if (s1->m != s2->m) { \
22 pr_debug("Samples differ at '"#m"'\n"); \
23 return false; \
24 } \
25 } while (0)
27 #define MCOMP(m) do { \
28 if (memcmp(&s1->m, &s2->m, sizeof(s1->m))) { \
29 pr_debug("Samples differ at '"#m"'\n"); \
30 return false; \
31 } \
32 } while (0)
35 * Hardcode the expected values for branch_entry flags.
36 * These are based on the input value (213) specified
37 * in branch_stack variable.
39 #define BS_EXPECTED_BE 0xa000d00000000000
40 #define BS_EXPECTED_LE 0x1aa00000000
41 #define FLAG(s) s->branch_stack->entries[i].flags
43 static bool samples_same(const struct perf_sample *s1,
44 const struct perf_sample *s2,
45 u64 type, u64 read_format, bool needs_swap)
47 size_t i;
49 if (type & PERF_SAMPLE_IDENTIFIER)
50 COMP(id);
52 if (type & PERF_SAMPLE_IP)
53 COMP(ip);
55 if (type & PERF_SAMPLE_TID) {
56 COMP(pid);
57 COMP(tid);
60 if (type & PERF_SAMPLE_TIME)
61 COMP(time);
63 if (type & PERF_SAMPLE_ADDR)
64 COMP(addr);
66 if (type & PERF_SAMPLE_ID)
67 COMP(id);
69 if (type & PERF_SAMPLE_STREAM_ID)
70 COMP(stream_id);
72 if (type & PERF_SAMPLE_CPU)
73 COMP(cpu);
75 if (type & PERF_SAMPLE_PERIOD)
76 COMP(period);
78 if (type & PERF_SAMPLE_READ) {
79 if (read_format & PERF_FORMAT_GROUP)
80 COMP(read.group.nr);
81 else
82 COMP(read.one.value);
83 if (read_format & PERF_FORMAT_TOTAL_TIME_ENABLED)
84 COMP(read.time_enabled);
85 if (read_format & PERF_FORMAT_TOTAL_TIME_RUNNING)
86 COMP(read.time_running);
87 /* PERF_FORMAT_ID is forced for PERF_SAMPLE_READ */
88 if (read_format & PERF_FORMAT_GROUP) {
89 for (i = 0; i < s1->read.group.nr; i++) {
90 /* FIXME: check values without LOST */
91 if (read_format & PERF_FORMAT_LOST)
92 MCOMP(read.group.values[i]);
94 } else {
95 COMP(read.one.id);
96 if (read_format & PERF_FORMAT_LOST)
97 COMP(read.one.lost);
101 if (type & PERF_SAMPLE_CALLCHAIN) {
102 COMP(callchain->nr);
103 for (i = 0; i < s1->callchain->nr; i++)
104 COMP(callchain->ips[i]);
107 if (type & PERF_SAMPLE_RAW) {
108 COMP(raw_size);
109 if (memcmp(s1->raw_data, s2->raw_data, s1->raw_size)) {
110 pr_debug("Samples differ at 'raw_data'\n");
111 return false;
115 if (type & PERF_SAMPLE_BRANCH_STACK) {
116 COMP(branch_stack->nr);
117 COMP(branch_stack->hw_idx);
118 for (i = 0; i < s1->branch_stack->nr; i++) {
119 if (needs_swap)
120 return ((host_is_bigendian()) ?
121 (FLAG(s2).value == BS_EXPECTED_BE) :
122 (FLAG(s2).value == BS_EXPECTED_LE));
123 else
124 MCOMP(branch_stack->entries[i]);
128 if (type & PERF_SAMPLE_REGS_USER) {
129 size_t sz = hweight_long(s1->user_regs.mask) * sizeof(u64);
131 COMP(user_regs.mask);
132 COMP(user_regs.abi);
133 if (s1->user_regs.abi &&
134 (!s1->user_regs.regs || !s2->user_regs.regs ||
135 memcmp(s1->user_regs.regs, s2->user_regs.regs, sz))) {
136 pr_debug("Samples differ at 'user_regs'\n");
137 return false;
141 if (type & PERF_SAMPLE_STACK_USER) {
142 COMP(user_stack.size);
143 if (memcmp(s1->user_stack.data, s2->user_stack.data,
144 s1->user_stack.size)) {
145 pr_debug("Samples differ at 'user_stack'\n");
146 return false;
150 if (type & PERF_SAMPLE_WEIGHT)
151 COMP(weight);
153 if (type & PERF_SAMPLE_DATA_SRC)
154 COMP(data_src);
156 if (type & PERF_SAMPLE_TRANSACTION)
157 COMP(transaction);
159 if (type & PERF_SAMPLE_REGS_INTR) {
160 size_t sz = hweight_long(s1->intr_regs.mask) * sizeof(u64);
162 COMP(intr_regs.mask);
163 COMP(intr_regs.abi);
164 if (s1->intr_regs.abi &&
165 (!s1->intr_regs.regs || !s2->intr_regs.regs ||
166 memcmp(s1->intr_regs.regs, s2->intr_regs.regs, sz))) {
167 pr_debug("Samples differ at 'intr_regs'\n");
168 return false;
172 if (type & PERF_SAMPLE_PHYS_ADDR)
173 COMP(phys_addr);
175 if (type & PERF_SAMPLE_CGROUP)
176 COMP(cgroup);
178 if (type & PERF_SAMPLE_DATA_PAGE_SIZE)
179 COMP(data_page_size);
181 if (type & PERF_SAMPLE_CODE_PAGE_SIZE)
182 COMP(code_page_size);
184 if (type & PERF_SAMPLE_AUX) {
185 COMP(aux_sample.size);
186 if (memcmp(s1->aux_sample.data, s2->aux_sample.data,
187 s1->aux_sample.size)) {
188 pr_debug("Samples differ at 'aux_sample'\n");
189 return false;
193 return true;
196 static int do_test(u64 sample_type, u64 sample_regs, u64 read_format)
198 struct evsel evsel = {
199 .needs_swap = false,
200 .core = {
201 . attr = {
202 .sample_type = sample_type,
203 .read_format = read_format,
207 union perf_event *event;
208 union {
209 struct ip_callchain callchain;
210 u64 data[64];
211 } callchain = {
212 /* 3 ips */
213 .data = {3, 201, 202, 203},
215 union {
216 struct branch_stack branch_stack;
217 u64 data[64];
218 } branch_stack = {
219 /* 1 branch_entry */
220 .data = {1, -1ULL, 211, 212, 213},
222 u64 regs[64];
223 const u32 raw_data[] = {0x12345678, 0x0a0b0c0d, 0x11020304, 0x05060708, 0 };
224 const u64 data[] = {0x2211443366558877ULL, 0, 0xaabbccddeeff4321ULL};
225 const u64 aux_data[] = {0xa55a, 0, 0xeeddee, 0x0282028202820282};
226 struct perf_sample sample = {
227 .ip = 101,
228 .pid = 102,
229 .tid = 103,
230 .time = 104,
231 .addr = 105,
232 .id = 106,
233 .stream_id = 107,
234 .period = 108,
235 .weight = 109,
236 .cpu = 110,
237 .raw_size = sizeof(raw_data),
238 .data_src = 111,
239 .transaction = 112,
240 .raw_data = (void *)raw_data,
241 .callchain = &callchain.callchain,
242 .no_hw_idx = false,
243 .branch_stack = &branch_stack.branch_stack,
244 .user_regs = {
245 .abi = PERF_SAMPLE_REGS_ABI_64,
246 .mask = sample_regs,
247 .regs = regs,
249 .user_stack = {
250 .size = sizeof(data),
251 .data = (void *)data,
253 .read = {
254 .time_enabled = 0x030a59d664fca7deULL,
255 .time_running = 0x011b6ae553eb98edULL,
257 .intr_regs = {
258 .abi = PERF_SAMPLE_REGS_ABI_64,
259 .mask = sample_regs,
260 .regs = regs,
262 .phys_addr = 113,
263 .cgroup = 114,
264 .data_page_size = 115,
265 .code_page_size = 116,
266 .aux_sample = {
267 .size = sizeof(aux_data),
268 .data = (void *)aux_data,
271 struct sample_read_value values[] = {{1, 5, 0}, {9, 3, 0}, {2, 7, 0}, {6, 4, 1},};
272 struct perf_sample sample_out, sample_out_endian;
273 size_t i, sz, bufsz;
274 int err, ret = -1;
276 if (sample_type & PERF_SAMPLE_REGS_USER)
277 evsel.core.attr.sample_regs_user = sample_regs;
279 if (sample_type & PERF_SAMPLE_REGS_INTR)
280 evsel.core.attr.sample_regs_intr = sample_regs;
282 if (sample_type & PERF_SAMPLE_BRANCH_STACK)
283 evsel.core.attr.branch_sample_type |= PERF_SAMPLE_BRANCH_HW_INDEX;
285 for (i = 0; i < sizeof(regs); i++)
286 *(i + (u8 *)regs) = i & 0xfe;
288 if (read_format & PERF_FORMAT_GROUP) {
289 sample.read.group.nr = 4;
290 sample.read.group.values = values;
291 } else {
292 sample.read.one.value = 0x08789faeb786aa87ULL;
293 sample.read.one.id = 99;
294 sample.read.one.lost = 1;
297 sz = perf_event__sample_event_size(&sample, sample_type, read_format);
298 bufsz = sz + 4096; /* Add a bit for overrun checking */
299 event = malloc(bufsz);
300 if (!event) {
301 pr_debug("malloc failed\n");
302 return -1;
305 memset(event, 0xff, bufsz);
306 event->header.type = PERF_RECORD_SAMPLE;
307 event->header.misc = 0;
308 event->header.size = sz;
310 err = perf_event__synthesize_sample(event, sample_type, read_format,
311 &sample);
312 if (err) {
313 pr_debug("%s failed for sample_type %#"PRIx64", error %d\n",
314 "perf_event__synthesize_sample", sample_type, err);
315 goto out_free;
318 /* The data does not contain 0xff so we use that to check the size */
319 for (i = bufsz; i > 0; i--) {
320 if (*(i - 1 + (u8 *)event) != 0xff)
321 break;
323 if (i != sz) {
324 pr_debug("Event size mismatch: actual %zu vs expected %zu\n",
325 i, sz);
326 goto out_free;
329 evsel.sample_size = __evsel__sample_size(sample_type);
331 err = evsel__parse_sample(&evsel, event, &sample_out);
332 if (err) {
333 pr_debug("%s failed for sample_type %#"PRIx64", error %d\n",
334 "evsel__parse_sample", sample_type, err);
335 goto out_free;
338 if (!samples_same(&sample, &sample_out, sample_type, read_format, evsel.needs_swap)) {
339 pr_debug("parsing failed for sample_type %#"PRIx64"\n",
340 sample_type);
341 goto out_free;
344 if (sample_type == PERF_SAMPLE_BRANCH_STACK) {
345 evsel.needs_swap = true;
346 evsel.sample_size = __evsel__sample_size(sample_type);
347 err = evsel__parse_sample(&evsel, event, &sample_out_endian);
348 if (err) {
349 pr_debug("%s failed for sample_type %#"PRIx64", error %d\n",
350 "evsel__parse_sample", sample_type, err);
351 goto out_free;
354 if (!samples_same(&sample, &sample_out_endian, sample_type, read_format, evsel.needs_swap)) {
355 pr_debug("parsing failed for sample_type %#"PRIx64"\n",
356 sample_type);
357 goto out_free;
361 ret = 0;
362 out_free:
363 free(event);
364 if (ret && read_format)
365 pr_debug("read_format %#"PRIx64"\n", read_format);
366 return ret;
370 * test__sample_parsing - test sample parsing.
372 * This function implements a test that synthesizes a sample event, parses it
373 * and then checks that the parsed sample matches the original sample. The test
374 * checks sample format bits separately and together. If the test passes %0 is
375 * returned, otherwise %-1 is returned.
377 static int test__sample_parsing(struct test_suite *test __maybe_unused, int subtest __maybe_unused)
379 const u64 rf[] = {4, 5, 6, 7, 12, 13, 14, 15, 20, 21, 22, 28, 29, 30, 31};
380 u64 sample_type;
381 u64 sample_regs;
382 size_t i;
383 int err;
386 * Fail the test if it has not been updated when new sample format bits
387 * were added. Please actually update the test rather than just change
388 * the condition below.
390 if (PERF_SAMPLE_MAX > PERF_SAMPLE_WEIGHT_STRUCT << 1) {
391 pr_debug("sample format has changed, some new PERF_SAMPLE_ bit was introduced - test needs updating\n");
392 return -1;
395 /* Test each sample format bit separately */
396 for (sample_type = 1; sample_type != PERF_SAMPLE_MAX;
397 sample_type <<= 1) {
398 /* Test read_format variations */
399 if (sample_type == PERF_SAMPLE_READ) {
400 for (i = 0; i < ARRAY_SIZE(rf); i++) {
401 err = do_test(sample_type, 0, rf[i]);
402 if (err)
403 return err;
405 continue;
407 sample_regs = 0;
409 if (sample_type == PERF_SAMPLE_REGS_USER)
410 sample_regs = 0x3fff;
412 if (sample_type == PERF_SAMPLE_REGS_INTR)
413 sample_regs = 0xff0fff;
415 err = do_test(sample_type, sample_regs, 0);
416 if (err)
417 return err;
421 * Test all sample format bits together
422 * Note: PERF_SAMPLE_WEIGHT and PERF_SAMPLE_WEIGHT_STRUCT cannot
423 * be set simultaneously.
425 sample_type = (PERF_SAMPLE_MAX - 1) & ~PERF_SAMPLE_WEIGHT;
426 sample_regs = 0x3fff; /* shared yb intr and user regs */
427 for (i = 0; i < ARRAY_SIZE(rf); i++) {
428 err = do_test(sample_type, sample_regs, rf[i]);
429 if (err)
430 return err;
433 return 0;
436 DEFINE_SUITE("Sample parsing", sample_parsing);