tools/perf/tests/builtin-test.c

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