xref: /linux/tools/perf/tests/builtin-test.c (revision e0643c4e9fdb2e77ab83ca596460e2c9c15728aa)
1 /*
2  * builtin-test.c
3  *
4  * Builtin regression testing command: ever growing number of sanity tests
5  */
6 #include <unistd.h>
7 #include <string.h>
8 #include "builtin.h"
9 #include "hist.h"
10 #include "intlist.h"
11 #include "tests.h"
12 #include "debug.h"
13 #include "color.h"
14 #include <subcmd/parse-options.h>
15 #include "symbol.h"
16 
17 static bool dont_fork;
18 
19 struct test __weak arch_tests[] = {
20 	{
21 		.func = NULL,
22 	},
23 };
24 
25 static struct test generic_tests[] = {
26 	{
27 		.desc = "vmlinux symtab matches kallsyms",
28 		.func = test__vmlinux_matches_kallsyms,
29 	},
30 	{
31 		.desc = "detect openat syscall event",
32 		.func = test__openat_syscall_event,
33 	},
34 	{
35 		.desc = "detect openat syscall event on all cpus",
36 		.func = test__openat_syscall_event_on_all_cpus,
37 	},
38 	{
39 		.desc = "read samples using the mmap interface",
40 		.func = test__basic_mmap,
41 	},
42 	{
43 		.desc = "parse events tests",
44 		.func = test__parse_events,
45 	},
46 	{
47 		.desc = "Validate PERF_RECORD_* events & perf_sample fields",
48 		.func = test__PERF_RECORD,
49 	},
50 	{
51 		.desc = "Test perf pmu format parsing",
52 		.func = test__pmu,
53 	},
54 	{
55 		.desc = "Test dso data read",
56 		.func = test__dso_data,
57 	},
58 	{
59 		.desc = "Test dso data cache",
60 		.func = test__dso_data_cache,
61 	},
62 	{
63 		.desc = "Test dso data reopen",
64 		.func = test__dso_data_reopen,
65 	},
66 	{
67 		.desc = "roundtrip evsel->name check",
68 		.func = test__perf_evsel__roundtrip_name_test,
69 	},
70 	{
71 		.desc = "Check parsing of sched tracepoints fields",
72 		.func = test__perf_evsel__tp_sched_test,
73 	},
74 	{
75 		.desc = "Generate and check syscalls:sys_enter_openat event fields",
76 		.func = test__syscall_openat_tp_fields,
77 	},
78 	{
79 		.desc = "struct perf_event_attr setup",
80 		.func = test__attr,
81 	},
82 	{
83 		.desc = "Test matching and linking multiple hists",
84 		.func = test__hists_link,
85 	},
86 	{
87 		.desc = "Try 'import perf' in python, checking link problems",
88 		.func = test__python_use,
89 	},
90 	{
91 		.desc = "Test breakpoint overflow signal handler",
92 		.func = test__bp_signal,
93 	},
94 	{
95 		.desc = "Test breakpoint overflow sampling",
96 		.func = test__bp_signal_overflow,
97 	},
98 	{
99 		.desc = "Test number of exit event of a simple workload",
100 		.func = test__task_exit,
101 	},
102 	{
103 		.desc = "Test software clock events have valid period values",
104 		.func = test__sw_clock_freq,
105 	},
106 	{
107 		.desc = "Test object code reading",
108 		.func = test__code_reading,
109 	},
110 	{
111 		.desc = "Test sample parsing",
112 		.func = test__sample_parsing,
113 	},
114 	{
115 		.desc = "Test using a dummy software event to keep tracking",
116 		.func = test__keep_tracking,
117 	},
118 	{
119 		.desc = "Test parsing with no sample_id_all bit set",
120 		.func = test__parse_no_sample_id_all,
121 	},
122 	{
123 		.desc = "Test filtering hist entries",
124 		.func = test__hists_filter,
125 	},
126 	{
127 		.desc = "Test mmap thread lookup",
128 		.func = test__mmap_thread_lookup,
129 	},
130 	{
131 		.desc = "Test thread mg sharing",
132 		.func = test__thread_mg_share,
133 	},
134 	{
135 		.desc = "Test output sorting of hist entries",
136 		.func = test__hists_output,
137 	},
138 	{
139 		.desc = "Test cumulation of child hist entries",
140 		.func = test__hists_cumulate,
141 	},
142 	{
143 		.desc = "Test tracking with sched_switch",
144 		.func = test__switch_tracking,
145 	},
146 	{
147 		.desc = "Filter fds with revents mask in a fdarray",
148 		.func = test__fdarray__filter,
149 	},
150 	{
151 		.desc = "Add fd to a fdarray, making it autogrow",
152 		.func = test__fdarray__add,
153 	},
154 	{
155 		.desc = "Test kmod_path__parse function",
156 		.func = test__kmod_path__parse,
157 	},
158 	{
159 		.desc = "Test thread map",
160 		.func = test__thread_map,
161 	},
162 	{
163 		.desc = "Test LLVM searching and compiling",
164 		.func = test__llvm,
165 		.subtest = {
166 			.skip_if_fail	= true,
167 			.get_nr		= test__llvm_subtest_get_nr,
168 			.get_desc	= test__llvm_subtest_get_desc,
169 		},
170 	},
171 	{
172 		.desc = "Test topology in session",
173 		.func = test_session_topology,
174 	},
175 	{
176 		.desc = "Test BPF filter",
177 		.func = test__bpf,
178 		.subtest = {
179 			.skip_if_fail	= true,
180 			.get_nr		= test__bpf_subtest_get_nr,
181 			.get_desc	= test__bpf_subtest_get_desc,
182 		},
183 	},
184 	{
185 		.desc = "Test thread map synthesize",
186 		.func = test__thread_map_synthesize,
187 	},
188 	{
189 		.desc = "Test cpu map synthesize",
190 		.func = test__cpu_map_synthesize,
191 	},
192 	{
193 		.desc = "Test stat config synthesize",
194 		.func = test__synthesize_stat_config,
195 	},
196 	{
197 		.desc = "Test stat synthesize",
198 		.func = test__synthesize_stat,
199 	},
200 	{
201 		.desc = "Test stat round synthesize",
202 		.func = test__synthesize_stat_round,
203 	},
204 	{
205 		.desc = "Test attr update synthesize",
206 		.func = test__event_update,
207 	},
208 	{
209 		.desc = "Test events times",
210 		.func = test__event_times,
211 	},
212 	{
213 		.desc = "Test backward reading from ring buffer",
214 		.func = test__backward_ring_buffer,
215 	},
216 	{
217 		.desc = "Test cpu map print",
218 		.func = test__cpu_map_print,
219 	},
220 	{
221 		.desc = "Test SDT event probing",
222 		.func = test__sdt_event,
223 	},
224 	{
225 		.func = NULL,
226 	},
227 };
228 
229 static struct test *tests[] = {
230 	generic_tests,
231 	arch_tests,
232 };
233 
234 static bool perf_test__matches(struct test *test, int curr, int argc, const char *argv[])
235 {
236 	int i;
237 
238 	if (argc == 0)
239 		return true;
240 
241 	for (i = 0; i < argc; ++i) {
242 		char *end;
243 		long nr = strtoul(argv[i], &end, 10);
244 
245 		if (*end == '\0') {
246 			if (nr == curr + 1)
247 				return true;
248 			continue;
249 		}
250 
251 		if (strcasestr(test->desc, argv[i]))
252 			return true;
253 	}
254 
255 	return false;
256 }
257 
258 static int run_test(struct test *test, int subtest)
259 {
260 	int status, err = -1, child = dont_fork ? 0 : fork();
261 	char sbuf[STRERR_BUFSIZE];
262 
263 	if (child < 0) {
264 		pr_err("failed to fork test: %s\n",
265 			str_error_r(errno, sbuf, sizeof(sbuf)));
266 		return -1;
267 	}
268 
269 	if (!child) {
270 		if (!dont_fork) {
271 			pr_debug("test child forked, pid %d\n", getpid());
272 
273 			if (!verbose) {
274 				int nullfd = open("/dev/null", O_WRONLY);
275 
276 				if (nullfd >= 0) {
277 					close(STDERR_FILENO);
278 					close(STDOUT_FILENO);
279 
280 					dup2(nullfd, STDOUT_FILENO);
281 					dup2(STDOUT_FILENO, STDERR_FILENO);
282 					close(nullfd);
283 				}
284 			} else {
285 				signal(SIGSEGV, sighandler_dump_stack);
286 				signal(SIGFPE, sighandler_dump_stack);
287 			}
288 		}
289 
290 		err = test->func(subtest);
291 		if (!dont_fork)
292 			exit(err);
293 	}
294 
295 	if (!dont_fork) {
296 		wait(&status);
297 
298 		if (WIFEXITED(status)) {
299 			err = (signed char)WEXITSTATUS(status);
300 			pr_debug("test child finished with %d\n", err);
301 		} else if (WIFSIGNALED(status)) {
302 			err = -1;
303 			pr_debug("test child interrupted\n");
304 		}
305 	}
306 
307 	return err;
308 }
309 
310 #define for_each_test(j, t)	 				\
311 	for (j = 0; j < ARRAY_SIZE(tests); j++)	\
312 		for (t = &tests[j][0]; t->func; t++)
313 
314 static int test_and_print(struct test *t, bool force_skip, int subtest)
315 {
316 	int err;
317 
318 	if (!force_skip) {
319 		pr_debug("\n--- start ---\n");
320 		err = run_test(t, subtest);
321 		pr_debug("---- end ----\n");
322 	} else {
323 		pr_debug("\n--- force skipped ---\n");
324 		err = TEST_SKIP;
325 	}
326 
327 	if (!t->subtest.get_nr)
328 		pr_debug("%s:", t->desc);
329 	else
330 		pr_debug("%s subtest %d:", t->desc, subtest);
331 
332 	switch (err) {
333 	case TEST_OK:
334 		pr_info(" Ok\n");
335 		break;
336 	case TEST_SKIP:
337 		color_fprintf(stderr, PERF_COLOR_YELLOW, " Skip\n");
338 		break;
339 	case TEST_FAIL:
340 	default:
341 		color_fprintf(stderr, PERF_COLOR_RED, " FAILED!\n");
342 		break;
343 	}
344 
345 	return err;
346 }
347 
348 static int __cmd_test(int argc, const char *argv[], struct intlist *skiplist)
349 {
350 	struct test *t;
351 	unsigned int j;
352 	int i = 0;
353 	int width = 0;
354 
355 	for_each_test(j, t) {
356 		int len = strlen(t->desc);
357 
358 		if (width < len)
359 			width = len;
360 	}
361 
362 	for_each_test(j, t) {
363 		int curr = i++, err;
364 
365 		if (!perf_test__matches(t, curr, argc, argv))
366 			continue;
367 
368 		pr_info("%2d: %-*s:", i, width, t->desc);
369 
370 		if (intlist__find(skiplist, i)) {
371 			color_fprintf(stderr, PERF_COLOR_YELLOW, " Skip (user override)\n");
372 			continue;
373 		}
374 
375 		if (!t->subtest.get_nr) {
376 			test_and_print(t, false, -1);
377 		} else {
378 			int subn = t->subtest.get_nr();
379 			/*
380 			 * minus 2 to align with normal testcases.
381 			 * For subtest we print additional '.x' in number.
382 			 * for example:
383 			 *
384 			 * 35: Test LLVM searching and compiling                        :
385 			 * 35.1: Basic BPF llvm compiling test                          : Ok
386 			 */
387 			int subw = width > 2 ? width - 2 : width;
388 			bool skip = false;
389 			int subi;
390 
391 			if (subn <= 0) {
392 				color_fprintf(stderr, PERF_COLOR_YELLOW,
393 					      " Skip (not compiled in)\n");
394 				continue;
395 			}
396 			pr_info("\n");
397 
398 			for (subi = 0; subi < subn; subi++) {
399 				int len = strlen(t->subtest.get_desc(subi));
400 
401 				if (subw < len)
402 					subw = len;
403 			}
404 
405 			for (subi = 0; subi < subn; subi++) {
406 				pr_info("%2d.%1d: %-*s:", i, subi + 1, subw,
407 					t->subtest.get_desc(subi));
408 				err = test_and_print(t, skip, subi);
409 				if (err != TEST_OK && t->subtest.skip_if_fail)
410 					skip = true;
411 			}
412 		}
413 	}
414 
415 	return 0;
416 }
417 
418 static int perf_test__list(int argc, const char **argv)
419 {
420 	unsigned int j;
421 	struct test *t;
422 	int i = 0;
423 
424 	for_each_test(j, t) {
425 		if (argc > 1 && !strstr(t->desc, argv[1]))
426 			continue;
427 
428 		pr_info("%2d: %s\n", ++i, t->desc);
429 	}
430 
431 	return 0;
432 }
433 
434 int cmd_test(int argc, const char **argv, const char *prefix __maybe_unused)
435 {
436 	const char *test_usage[] = {
437 	"perf test [<options>] [{list <test-name-fragment>|[<test-name-fragments>|<test-numbers>]}]",
438 	NULL,
439 	};
440 	const char *skip = NULL;
441 	const struct option test_options[] = {
442 	OPT_STRING('s', "skip", &skip, "tests", "tests to skip"),
443 	OPT_INCR('v', "verbose", &verbose,
444 		    "be more verbose (show symbol address, etc)"),
445 	OPT_BOOLEAN('F', "dont-fork", &dont_fork,
446 		    "Do not fork for testcase"),
447 	OPT_END()
448 	};
449 	const char * const test_subcommands[] = { "list", NULL };
450 	struct intlist *skiplist = NULL;
451         int ret = hists__init();
452 
453         if (ret < 0)
454                 return ret;
455 
456 	argc = parse_options_subcommand(argc, argv, test_options, test_subcommands, test_usage, 0);
457 	if (argc >= 1 && !strcmp(argv[0], "list"))
458 		return perf_test__list(argc, argv);
459 
460 	symbol_conf.priv_size = sizeof(int);
461 	symbol_conf.sort_by_name = true;
462 	symbol_conf.try_vmlinux_path = true;
463 
464 	if (symbol__init(NULL) < 0)
465 		return -1;
466 
467 	if (skip != NULL)
468 		skiplist = intlist__new(skip);
469 
470 	return __cmd_test(argc, argv, skiplist);
471 }
472