root/tools/perf/util/evlist.c

/* [<][>][^][v][top][bottom][index][help] */

DEFINITIONS

This source file includes following definitions.
  1. evlist__init
  2. evlist__new
  3. perf_evlist__new_default
  4. perf_evlist__new_dummy
  5. perf_evlist__set_id_pos
  6. perf_evlist__update_id_pos
  7. evlist__purge
  8. evlist__exit
  9. evlist__delete
  10. evlist__add
  11. evlist__remove
  12. perf_evlist__splice_list_tail
  13. __perf_evlist__set_leader
  14. perf_evlist__set_leader
  15. __perf_evlist__add_default
  16. perf_evlist__add_dummy
  17. evlist__add_attrs
  18. __perf_evlist__add_default_attrs
  19. perf_evlist__find_tracepoint_by_id
  20. perf_evlist__find_tracepoint_by_name
  21. perf_evlist__add_newtp
  22. perf_evlist__nr_threads
  23. evlist__disable
  24. evlist__enable
  25. perf_evlist__toggle_enable
  26. perf_evlist__enable_event_cpu
  27. perf_evlist__enable_event_thread
  28. perf_evlist__enable_event_idx
  29. evlist__add_pollfd
  30. perf_evlist__munmap_filtered
  31. evlist__filter_pollfd
  32. evlist__poll
  33. perf_evlist__set_sid_idx
  34. perf_evlist__id2sid
  35. perf_evlist__id2evsel
  36. perf_evlist__id2evsel_strict
  37. perf_evlist__event2id
  38. perf_evlist__event2evsel
  39. perf_evlist__set_paused
  40. perf_evlist__pause
  41. perf_evlist__resume
  42. evlist__munmap_nofree
  43. evlist__munmap
  44. evlist__alloc_mmap
  45. perf_evlist__should_poll
  46. evlist__mmap_per_evsel
  47. evlist__mmap_per_cpu
  48. evlist__mmap_per_thread
  49. perf_event_mlock_kb_in_pages
  50. evlist__mmap_size
  51. parse_pages_arg
  52. __perf_evlist__parse_mmap_pages
  53. perf_evlist__parse_mmap_pages
  54. evlist__mmap_ex
  55. evlist__mmap
  56. perf_evlist__create_maps
  57. __perf_evlist__set_sample_bit
  58. __perf_evlist__reset_sample_bit
  59. perf_evlist__apply_filters
  60. perf_evlist__set_tp_filter
  61. perf_evlist__set_tp_filter_pids
  62. perf_evlist__set_tp_filter_pid
  63. perf_evlist__valid_sample_type
  64. __perf_evlist__combined_sample_type
  65. perf_evlist__combined_sample_type
  66. perf_evlist__combined_branch_type
  67. perf_evlist__valid_read_format
  68. perf_evlist__id_hdr_size
  69. perf_evlist__valid_sample_id_all
  70. perf_evlist__sample_id_all
  71. perf_evlist__set_selected
  72. evlist__close
  73. perf_evlist__create_syswide_maps
  74. evlist__open
  75. perf_evlist__prepare_workload
  76. perf_evlist__start_workload
  77. perf_evlist__parse_sample
  78. perf_evlist__parse_sample_timestamp
  79. perf_evlist__strerror_open
  80. perf_evlist__strerror_mmap
  81. perf_evlist__to_front
  82. perf_evlist__set_tracking_event
  83. perf_evlist__find_evsel_by_str
  84. perf_evlist__toggle_bkw_mmap
  85. perf_evlist__exclude_kernel
  86. perf_evlist__force_leader
  87. perf_evlist__reset_weak_group
  88. perf_evlist__add_sb_event
  89. perf_evlist__poll_thread
  90. perf_evlist__start_sb_thread
  91. perf_evlist__stop_sb_thread

   1 // SPDX-License-Identifier: GPL-2.0-only
   2 /*
   3  * Copyright (C) 2011, Red Hat Inc, Arnaldo Carvalho de Melo <acme@redhat.com>
   4  *
   5  * Parts came from builtin-{top,stat,record}.c, see those files for further
   6  * copyright notes.
   7  */
   8 #include <api/fs/fs.h>
   9 #include <errno.h>
  10 #include <inttypes.h>
  11 #include <poll.h>
  12 #include "cpumap.h"
  13 #include "util/mmap.h"
  14 #include "thread_map.h"
  15 #include "target.h"
  16 #include "evlist.h"
  17 #include "evsel.h"
  18 #include "debug.h"
  19 #include "units.h"
  20 #include <internal/lib.h> // page_size
  21 #include "../perf.h"
  22 #include "asm/bug.h"
  23 #include "bpf-event.h"
  24 #include <signal.h>
  25 #include <unistd.h>
  26 #include <sched.h>
  27 #include <stdlib.h>
  28 
  29 #include "parse-events.h"
  30 #include <subcmd/parse-options.h>
  31 
  32 #include <fcntl.h>
  33 #include <sys/ioctl.h>
  34 #include <sys/mman.h>
  35 
  36 #include <linux/bitops.h>
  37 #include <linux/hash.h>
  38 #include <linux/log2.h>
  39 #include <linux/err.h>
  40 #include <linux/string.h>
  41 #include <linux/zalloc.h>
  42 #include <perf/evlist.h>
  43 #include <perf/evsel.h>
  44 #include <perf/cpumap.h>
  45 
  46 #include <internal/xyarray.h>
  47 
  48 #ifdef LACKS_SIGQUEUE_PROTOTYPE
  49 int sigqueue(pid_t pid, int sig, const union sigval value);
  50 #endif
  51 
  52 #define FD(e, x, y) (*(int *)xyarray__entry(e->core.fd, x, y))
  53 #define SID(e, x, y) xyarray__entry(e->core.sample_id, x, y)
  54 
  55 void evlist__init(struct evlist *evlist, struct perf_cpu_map *cpus,
  56                   struct perf_thread_map *threads)
  57 {
  58         perf_evlist__init(&evlist->core);
  59         perf_evlist__set_maps(&evlist->core, cpus, threads);
  60         fdarray__init(&evlist->core.pollfd, 64);
  61         evlist->workload.pid = -1;
  62         evlist->bkw_mmap_state = BKW_MMAP_NOTREADY;
  63 }
  64 
  65 struct evlist *evlist__new(void)
  66 {
  67         struct evlist *evlist = zalloc(sizeof(*evlist));
  68 
  69         if (evlist != NULL)
  70                 evlist__init(evlist, NULL, NULL);
  71 
  72         return evlist;
  73 }
  74 
  75 struct evlist *perf_evlist__new_default(void)
  76 {
  77         struct evlist *evlist = evlist__new();
  78 
  79         if (evlist && perf_evlist__add_default(evlist)) {
  80                 evlist__delete(evlist);
  81                 evlist = NULL;
  82         }
  83 
  84         return evlist;
  85 }
  86 
  87 struct evlist *perf_evlist__new_dummy(void)
  88 {
  89         struct evlist *evlist = evlist__new();
  90 
  91         if (evlist && perf_evlist__add_dummy(evlist)) {
  92                 evlist__delete(evlist);
  93                 evlist = NULL;
  94         }
  95 
  96         return evlist;
  97 }
  98 
  99 /**
 100  * perf_evlist__set_id_pos - set the positions of event ids.
 101  * @evlist: selected event list
 102  *
 103  * Events with compatible sample types all have the same id_pos
 104  * and is_pos.  For convenience, put a copy on evlist.
 105  */
 106 void perf_evlist__set_id_pos(struct evlist *evlist)
 107 {
 108         struct evsel *first = evlist__first(evlist);
 109 
 110         evlist->id_pos = first->id_pos;
 111         evlist->is_pos = first->is_pos;
 112 }
 113 
 114 static void perf_evlist__update_id_pos(struct evlist *evlist)
 115 {
 116         struct evsel *evsel;
 117 
 118         evlist__for_each_entry(evlist, evsel)
 119                 perf_evsel__calc_id_pos(evsel);
 120 
 121         perf_evlist__set_id_pos(evlist);
 122 }
 123 
 124 static void evlist__purge(struct evlist *evlist)
 125 {
 126         struct evsel *pos, *n;
 127 
 128         evlist__for_each_entry_safe(evlist, n, pos) {
 129                 list_del_init(&pos->core.node);
 130                 pos->evlist = NULL;
 131                 evsel__delete(pos);
 132         }
 133 
 134         evlist->core.nr_entries = 0;
 135 }
 136 
 137 void evlist__exit(struct evlist *evlist)
 138 {
 139         zfree(&evlist->mmap);
 140         zfree(&evlist->overwrite_mmap);
 141         fdarray__exit(&evlist->core.pollfd);
 142 }
 143 
 144 void evlist__delete(struct evlist *evlist)
 145 {
 146         if (evlist == NULL)
 147                 return;
 148 
 149         evlist__munmap(evlist);
 150         evlist__close(evlist);
 151         perf_cpu_map__put(evlist->core.cpus);
 152         perf_thread_map__put(evlist->core.threads);
 153         evlist->core.cpus = NULL;
 154         evlist->core.threads = NULL;
 155         evlist__purge(evlist);
 156         evlist__exit(evlist);
 157         free(evlist);
 158 }
 159 
 160 void evlist__add(struct evlist *evlist, struct evsel *entry)
 161 {
 162         entry->evlist = evlist;
 163         entry->idx = evlist->core.nr_entries;
 164         entry->tracking = !entry->idx;
 165 
 166         perf_evlist__add(&evlist->core, &entry->core);
 167 
 168         if (evlist->core.nr_entries == 1)
 169                 perf_evlist__set_id_pos(evlist);
 170 }
 171 
 172 void evlist__remove(struct evlist *evlist, struct evsel *evsel)
 173 {
 174         evsel->evlist = NULL;
 175         perf_evlist__remove(&evlist->core, &evsel->core);
 176 }
 177 
 178 void perf_evlist__splice_list_tail(struct evlist *evlist,
 179                                    struct list_head *list)
 180 {
 181         struct evsel *evsel, *temp;
 182 
 183         __evlist__for_each_entry_safe(list, temp, evsel) {
 184                 list_del_init(&evsel->core.node);
 185                 evlist__add(evlist, evsel);
 186         }
 187 }
 188 
 189 void __perf_evlist__set_leader(struct list_head *list)
 190 {
 191         struct evsel *evsel, *leader;
 192 
 193         leader = list_entry(list->next, struct evsel, core.node);
 194         evsel = list_entry(list->prev, struct evsel, core.node);
 195 
 196         leader->core.nr_members = evsel->idx - leader->idx + 1;
 197 
 198         __evlist__for_each_entry(list, evsel) {
 199                 evsel->leader = leader;
 200         }
 201 }
 202 
 203 void perf_evlist__set_leader(struct evlist *evlist)
 204 {
 205         if (evlist->core.nr_entries) {
 206                 evlist->nr_groups = evlist->core.nr_entries > 1 ? 1 : 0;
 207                 __perf_evlist__set_leader(&evlist->core.entries);
 208         }
 209 }
 210 
 211 int __perf_evlist__add_default(struct evlist *evlist, bool precise)
 212 {
 213         struct evsel *evsel = perf_evsel__new_cycles(precise);
 214 
 215         if (evsel == NULL)
 216                 return -ENOMEM;
 217 
 218         evlist__add(evlist, evsel);
 219         return 0;
 220 }
 221 
 222 int perf_evlist__add_dummy(struct evlist *evlist)
 223 {
 224         struct perf_event_attr attr = {
 225                 .type   = PERF_TYPE_SOFTWARE,
 226                 .config = PERF_COUNT_SW_DUMMY,
 227                 .size   = sizeof(attr), /* to capture ABI version */
 228         };
 229         struct evsel *evsel = perf_evsel__new_idx(&attr, evlist->core.nr_entries);
 230 
 231         if (evsel == NULL)
 232                 return -ENOMEM;
 233 
 234         evlist__add(evlist, evsel);
 235         return 0;
 236 }
 237 
 238 static int evlist__add_attrs(struct evlist *evlist,
 239                                   struct perf_event_attr *attrs, size_t nr_attrs)
 240 {
 241         struct evsel *evsel, *n;
 242         LIST_HEAD(head);
 243         size_t i;
 244 
 245         for (i = 0; i < nr_attrs; i++) {
 246                 evsel = perf_evsel__new_idx(attrs + i, evlist->core.nr_entries + i);
 247                 if (evsel == NULL)
 248                         goto out_delete_partial_list;
 249                 list_add_tail(&evsel->core.node, &head);
 250         }
 251 
 252         perf_evlist__splice_list_tail(evlist, &head);
 253 
 254         return 0;
 255 
 256 out_delete_partial_list:
 257         __evlist__for_each_entry_safe(&head, n, evsel)
 258                 evsel__delete(evsel);
 259         return -1;
 260 }
 261 
 262 int __perf_evlist__add_default_attrs(struct evlist *evlist,
 263                                      struct perf_event_attr *attrs, size_t nr_attrs)
 264 {
 265         size_t i;
 266 
 267         for (i = 0; i < nr_attrs; i++)
 268                 event_attr_init(attrs + i);
 269 
 270         return evlist__add_attrs(evlist, attrs, nr_attrs);
 271 }
 272 
 273 struct evsel *
 274 perf_evlist__find_tracepoint_by_id(struct evlist *evlist, int id)
 275 {
 276         struct evsel *evsel;
 277 
 278         evlist__for_each_entry(evlist, evsel) {
 279                 if (evsel->core.attr.type   == PERF_TYPE_TRACEPOINT &&
 280                     (int)evsel->core.attr.config == id)
 281                         return evsel;
 282         }
 283 
 284         return NULL;
 285 }
 286 
 287 struct evsel *
 288 perf_evlist__find_tracepoint_by_name(struct evlist *evlist,
 289                                      const char *name)
 290 {
 291         struct evsel *evsel;
 292 
 293         evlist__for_each_entry(evlist, evsel) {
 294                 if ((evsel->core.attr.type == PERF_TYPE_TRACEPOINT) &&
 295                     (strcmp(evsel->name, name) == 0))
 296                         return evsel;
 297         }
 298 
 299         return NULL;
 300 }
 301 
 302 int perf_evlist__add_newtp(struct evlist *evlist,
 303                            const char *sys, const char *name, void *handler)
 304 {
 305         struct evsel *evsel = perf_evsel__newtp(sys, name);
 306 
 307         if (IS_ERR(evsel))
 308                 return -1;
 309 
 310         evsel->handler = handler;
 311         evlist__add(evlist, evsel);
 312         return 0;
 313 }
 314 
 315 static int perf_evlist__nr_threads(struct evlist *evlist,
 316                                    struct evsel *evsel)
 317 {
 318         if (evsel->core.system_wide)
 319                 return 1;
 320         else
 321                 return perf_thread_map__nr(evlist->core.threads);
 322 }
 323 
 324 void evlist__disable(struct evlist *evlist)
 325 {
 326         struct evsel *pos;
 327 
 328         evlist__for_each_entry(evlist, pos) {
 329                 if (pos->disabled || !perf_evsel__is_group_leader(pos) || !pos->core.fd)
 330                         continue;
 331                 evsel__disable(pos);
 332         }
 333 
 334         evlist->enabled = false;
 335 }
 336 
 337 void evlist__enable(struct evlist *evlist)
 338 {
 339         struct evsel *pos;
 340 
 341         evlist__for_each_entry(evlist, pos) {
 342                 if (!perf_evsel__is_group_leader(pos) || !pos->core.fd)
 343                         continue;
 344                 evsel__enable(pos);
 345         }
 346 
 347         evlist->enabled = true;
 348 }
 349 
 350 void perf_evlist__toggle_enable(struct evlist *evlist)
 351 {
 352         (evlist->enabled ? evlist__disable : evlist__enable)(evlist);
 353 }
 354 
 355 static int perf_evlist__enable_event_cpu(struct evlist *evlist,
 356                                          struct evsel *evsel, int cpu)
 357 {
 358         int thread;
 359         int nr_threads = perf_evlist__nr_threads(evlist, evsel);
 360 
 361         if (!evsel->core.fd)
 362                 return -EINVAL;
 363 
 364         for (thread = 0; thread < nr_threads; thread++) {
 365                 int err = ioctl(FD(evsel, cpu, thread), PERF_EVENT_IOC_ENABLE, 0);
 366                 if (err)
 367                         return err;
 368         }
 369         return 0;
 370 }
 371 
 372 static int perf_evlist__enable_event_thread(struct evlist *evlist,
 373                                             struct evsel *evsel,
 374                                             int thread)
 375 {
 376         int cpu;
 377         int nr_cpus = perf_cpu_map__nr(evlist->core.cpus);
 378 
 379         if (!evsel->core.fd)
 380                 return -EINVAL;
 381 
 382         for (cpu = 0; cpu < nr_cpus; cpu++) {
 383                 int err = ioctl(FD(evsel, cpu, thread), PERF_EVENT_IOC_ENABLE, 0);
 384                 if (err)
 385                         return err;
 386         }
 387         return 0;
 388 }
 389 
 390 int perf_evlist__enable_event_idx(struct evlist *evlist,
 391                                   struct evsel *evsel, int idx)
 392 {
 393         bool per_cpu_mmaps = !perf_cpu_map__empty(evlist->core.cpus);
 394 
 395         if (per_cpu_mmaps)
 396                 return perf_evlist__enable_event_cpu(evlist, evsel, idx);
 397         else
 398                 return perf_evlist__enable_event_thread(evlist, evsel, idx);
 399 }
 400 
 401 int evlist__add_pollfd(struct evlist *evlist, int fd)
 402 {
 403         return perf_evlist__add_pollfd(&evlist->core, fd, NULL, POLLIN);
 404 }
 405 
 406 static void perf_evlist__munmap_filtered(struct fdarray *fda, int fd,
 407                                          void *arg __maybe_unused)
 408 {
 409         struct mmap *map = fda->priv[fd].ptr;
 410 
 411         if (map)
 412                 perf_mmap__put(map);
 413 }
 414 
 415 int evlist__filter_pollfd(struct evlist *evlist, short revents_and_mask)
 416 {
 417         return fdarray__filter(&evlist->core.pollfd, revents_and_mask,
 418                                perf_evlist__munmap_filtered, NULL);
 419 }
 420 
 421 int evlist__poll(struct evlist *evlist, int timeout)
 422 {
 423         return perf_evlist__poll(&evlist->core, timeout);
 424 }
 425 
 426 static void perf_evlist__set_sid_idx(struct evlist *evlist,
 427                                      struct evsel *evsel, int idx, int cpu,
 428                                      int thread)
 429 {
 430         struct perf_sample_id *sid = SID(evsel, cpu, thread);
 431         sid->idx = idx;
 432         if (evlist->core.cpus && cpu >= 0)
 433                 sid->cpu = evlist->core.cpus->map[cpu];
 434         else
 435                 sid->cpu = -1;
 436         if (!evsel->core.system_wide && evlist->core.threads && thread >= 0)
 437                 sid->tid = perf_thread_map__pid(evlist->core.threads, thread);
 438         else
 439                 sid->tid = -1;
 440 }
 441 
 442 struct perf_sample_id *perf_evlist__id2sid(struct evlist *evlist, u64 id)
 443 {
 444         struct hlist_head *head;
 445         struct perf_sample_id *sid;
 446         int hash;
 447 
 448         hash = hash_64(id, PERF_EVLIST__HLIST_BITS);
 449         head = &evlist->core.heads[hash];
 450 
 451         hlist_for_each_entry(sid, head, node)
 452                 if (sid->id == id)
 453                         return sid;
 454 
 455         return NULL;
 456 }
 457 
 458 struct evsel *perf_evlist__id2evsel(struct evlist *evlist, u64 id)
 459 {
 460         struct perf_sample_id *sid;
 461 
 462         if (evlist->core.nr_entries == 1 || !id)
 463                 return evlist__first(evlist);
 464 
 465         sid = perf_evlist__id2sid(evlist, id);
 466         if (sid)
 467                 return container_of(sid->evsel, struct evsel, core);
 468 
 469         if (!perf_evlist__sample_id_all(evlist))
 470                 return evlist__first(evlist);
 471 
 472         return NULL;
 473 }
 474 
 475 struct evsel *perf_evlist__id2evsel_strict(struct evlist *evlist,
 476                                                 u64 id)
 477 {
 478         struct perf_sample_id *sid;
 479 
 480         if (!id)
 481                 return NULL;
 482 
 483         sid = perf_evlist__id2sid(evlist, id);
 484         if (sid)
 485                 return container_of(sid->evsel, struct evsel, core);
 486 
 487         return NULL;
 488 }
 489 
 490 static int perf_evlist__event2id(struct evlist *evlist,
 491                                  union perf_event *event, u64 *id)
 492 {
 493         const __u64 *array = event->sample.array;
 494         ssize_t n;
 495 
 496         n = (event->header.size - sizeof(event->header)) >> 3;
 497 
 498         if (event->header.type == PERF_RECORD_SAMPLE) {
 499                 if (evlist->id_pos >= n)
 500                         return -1;
 501                 *id = array[evlist->id_pos];
 502         } else {
 503                 if (evlist->is_pos > n)
 504                         return -1;
 505                 n -= evlist->is_pos;
 506                 *id = array[n];
 507         }
 508         return 0;
 509 }
 510 
 511 struct evsel *perf_evlist__event2evsel(struct evlist *evlist,
 512                                             union perf_event *event)
 513 {
 514         struct evsel *first = evlist__first(evlist);
 515         struct hlist_head *head;
 516         struct perf_sample_id *sid;
 517         int hash;
 518         u64 id;
 519 
 520         if (evlist->core.nr_entries == 1)
 521                 return first;
 522 
 523         if (!first->core.attr.sample_id_all &&
 524             event->header.type != PERF_RECORD_SAMPLE)
 525                 return first;
 526 
 527         if (perf_evlist__event2id(evlist, event, &id))
 528                 return NULL;
 529 
 530         /* Synthesized events have an id of zero */
 531         if (!id)
 532                 return first;
 533 
 534         hash = hash_64(id, PERF_EVLIST__HLIST_BITS);
 535         head = &evlist->core.heads[hash];
 536 
 537         hlist_for_each_entry(sid, head, node) {
 538                 if (sid->id == id)
 539                         return container_of(sid->evsel, struct evsel, core);
 540         }
 541         return NULL;
 542 }
 543 
 544 static int perf_evlist__set_paused(struct evlist *evlist, bool value)
 545 {
 546         int i;
 547 
 548         if (!evlist->overwrite_mmap)
 549                 return 0;
 550 
 551         for (i = 0; i < evlist->core.nr_mmaps; i++) {
 552                 int fd = evlist->overwrite_mmap[i].core.fd;
 553                 int err;
 554 
 555                 if (fd < 0)
 556                         continue;
 557                 err = ioctl(fd, PERF_EVENT_IOC_PAUSE_OUTPUT, value ? 1 : 0);
 558                 if (err)
 559                         return err;
 560         }
 561         return 0;
 562 }
 563 
 564 static int perf_evlist__pause(struct evlist *evlist)
 565 {
 566         return perf_evlist__set_paused(evlist, true);
 567 }
 568 
 569 static int perf_evlist__resume(struct evlist *evlist)
 570 {
 571         return perf_evlist__set_paused(evlist, false);
 572 }
 573 
 574 static void evlist__munmap_nofree(struct evlist *evlist)
 575 {
 576         int i;
 577 
 578         if (evlist->mmap)
 579                 for (i = 0; i < evlist->core.nr_mmaps; i++)
 580                         perf_mmap__munmap(&evlist->mmap[i]);
 581 
 582         if (evlist->overwrite_mmap)
 583                 for (i = 0; i < evlist->core.nr_mmaps; i++)
 584                         perf_mmap__munmap(&evlist->overwrite_mmap[i]);
 585 }
 586 
 587 void evlist__munmap(struct evlist *evlist)
 588 {
 589         evlist__munmap_nofree(evlist);
 590         zfree(&evlist->mmap);
 591         zfree(&evlist->overwrite_mmap);
 592 }
 593 
 594 static struct mmap *evlist__alloc_mmap(struct evlist *evlist,
 595                                        bool overwrite)
 596 {
 597         int i;
 598         struct mmap *map;
 599 
 600         evlist->core.nr_mmaps = perf_cpu_map__nr(evlist->core.cpus);
 601         if (perf_cpu_map__empty(evlist->core.cpus))
 602                 evlist->core.nr_mmaps = perf_thread_map__nr(evlist->core.threads);
 603         map = zalloc(evlist->core.nr_mmaps * sizeof(struct mmap));
 604         if (!map)
 605                 return NULL;
 606 
 607         for (i = 0; i < evlist->core.nr_mmaps; i++) {
 608                 map[i].core.fd = -1;
 609                 map[i].core.overwrite = overwrite;
 610                 /*
 611                  * When the perf_mmap() call is made we grab one refcount, plus
 612                  * one extra to let perf_mmap__consume() get the last
 613                  * events after all real references (perf_mmap__get()) are
 614                  * dropped.
 615                  *
 616                  * Each PERF_EVENT_IOC_SET_OUTPUT points to this mmap and
 617                  * thus does perf_mmap__get() on it.
 618                  */
 619                 refcount_set(&map[i].core.refcnt, 0);
 620         }
 621         return map;
 622 }
 623 
 624 static bool
 625 perf_evlist__should_poll(struct evlist *evlist __maybe_unused,
 626                          struct evsel *evsel)
 627 {
 628         if (evsel->core.attr.write_backward)
 629                 return false;
 630         return true;
 631 }
 632 
 633 static int evlist__mmap_per_evsel(struct evlist *evlist, int idx,
 634                                        struct mmap_params *mp, int cpu_idx,
 635                                        int thread, int *_output, int *_output_overwrite)
 636 {
 637         struct evsel *evsel;
 638         int revent;
 639         int evlist_cpu = cpu_map__cpu(evlist->core.cpus, cpu_idx);
 640 
 641         evlist__for_each_entry(evlist, evsel) {
 642                 struct mmap *maps = evlist->mmap;
 643                 int *output = _output;
 644                 int fd;
 645                 int cpu;
 646 
 647                 mp->prot = PROT_READ | PROT_WRITE;
 648                 if (evsel->core.attr.write_backward) {
 649                         output = _output_overwrite;
 650                         maps = evlist->overwrite_mmap;
 651 
 652                         if (!maps) {
 653                                 maps = evlist__alloc_mmap(evlist, true);
 654                                 if (!maps)
 655                                         return -1;
 656                                 evlist->overwrite_mmap = maps;
 657                                 if (evlist->bkw_mmap_state == BKW_MMAP_NOTREADY)
 658                                         perf_evlist__toggle_bkw_mmap(evlist, BKW_MMAP_RUNNING);
 659                         }
 660                         mp->prot &= ~PROT_WRITE;
 661                 }
 662 
 663                 if (evsel->core.system_wide && thread)
 664                         continue;
 665 
 666                 cpu = perf_cpu_map__idx(evsel->core.cpus, evlist_cpu);
 667                 if (cpu == -1)
 668                         continue;
 669 
 670                 fd = FD(evsel, cpu, thread);
 671 
 672                 if (*output == -1) {
 673                         *output = fd;
 674 
 675                         if (perf_mmap__mmap(&maps[idx], mp, *output, evlist_cpu) < 0)
 676                                 return -1;
 677                 } else {
 678                         if (ioctl(fd, PERF_EVENT_IOC_SET_OUTPUT, *output) != 0)
 679                                 return -1;
 680 
 681                         perf_mmap__get(&maps[idx]);
 682                 }
 683 
 684                 revent = perf_evlist__should_poll(evlist, evsel) ? POLLIN : 0;
 685 
 686                 /*
 687                  * The system_wide flag causes a selected event to be opened
 688                  * always without a pid.  Consequently it will never get a
 689                  * POLLHUP, but it is used for tracking in combination with
 690                  * other events, so it should not need to be polled anyway.
 691                  * Therefore don't add it for polling.
 692                  */
 693                 if (!evsel->core.system_wide &&
 694                      perf_evlist__add_pollfd(&evlist->core, fd, &maps[idx], revent) < 0) {
 695                         perf_mmap__put(&maps[idx]);
 696                         return -1;
 697                 }
 698 
 699                 if (evsel->core.attr.read_format & PERF_FORMAT_ID) {
 700                         if (perf_evlist__id_add_fd(&evlist->core, &evsel->core, cpu, thread,
 701                                                    fd) < 0)
 702                                 return -1;
 703                         perf_evlist__set_sid_idx(evlist, evsel, idx, cpu,
 704                                                  thread);
 705                 }
 706         }
 707 
 708         return 0;
 709 }
 710 
 711 static int evlist__mmap_per_cpu(struct evlist *evlist,
 712                                      struct mmap_params *mp)
 713 {
 714         int cpu, thread;
 715         int nr_cpus = perf_cpu_map__nr(evlist->core.cpus);
 716         int nr_threads = perf_thread_map__nr(evlist->core.threads);
 717 
 718         pr_debug2("perf event ring buffer mmapped per cpu\n");
 719         for (cpu = 0; cpu < nr_cpus; cpu++) {
 720                 int output = -1;
 721                 int output_overwrite = -1;
 722 
 723                 auxtrace_mmap_params__set_idx(&mp->auxtrace_mp, evlist, cpu,
 724                                               true);
 725 
 726                 for (thread = 0; thread < nr_threads; thread++) {
 727                         if (evlist__mmap_per_evsel(evlist, cpu, mp, cpu,
 728                                                         thread, &output, &output_overwrite))
 729                                 goto out_unmap;
 730                 }
 731         }
 732 
 733         return 0;
 734 
 735 out_unmap:
 736         evlist__munmap_nofree(evlist);
 737         return -1;
 738 }
 739 
 740 static int evlist__mmap_per_thread(struct evlist *evlist,
 741                                         struct mmap_params *mp)
 742 {
 743         int thread;
 744         int nr_threads = perf_thread_map__nr(evlist->core.threads);
 745 
 746         pr_debug2("perf event ring buffer mmapped per thread\n");
 747         for (thread = 0; thread < nr_threads; thread++) {
 748                 int output = -1;
 749                 int output_overwrite = -1;
 750 
 751                 auxtrace_mmap_params__set_idx(&mp->auxtrace_mp, evlist, thread,
 752                                               false);
 753 
 754                 if (evlist__mmap_per_evsel(evlist, thread, mp, 0, thread,
 755                                                 &output, &output_overwrite))
 756                         goto out_unmap;
 757         }
 758 
 759         return 0;
 760 
 761 out_unmap:
 762         evlist__munmap_nofree(evlist);
 763         return -1;
 764 }
 765 
 766 unsigned long perf_event_mlock_kb_in_pages(void)
 767 {
 768         unsigned long pages;
 769         int max;
 770 
 771         if (sysctl__read_int("kernel/perf_event_mlock_kb", &max) < 0) {
 772                 /*
 773                  * Pick a once upon a time good value, i.e. things look
 774                  * strange since we can't read a sysctl value, but lets not
 775                  * die yet...
 776                  */
 777                 max = 512;
 778         } else {
 779                 max -= (page_size / 1024);
 780         }
 781 
 782         pages = (max * 1024) / page_size;
 783         if (!is_power_of_2(pages))
 784                 pages = rounddown_pow_of_two(pages);
 785 
 786         return pages;
 787 }
 788 
 789 size_t evlist__mmap_size(unsigned long pages)
 790 {
 791         if (pages == UINT_MAX)
 792                 pages = perf_event_mlock_kb_in_pages();
 793         else if (!is_power_of_2(pages))
 794                 return 0;
 795 
 796         return (pages + 1) * page_size;
 797 }
 798 
 799 static long parse_pages_arg(const char *str, unsigned long min,
 800                             unsigned long max)
 801 {
 802         unsigned long pages, val;
 803         static struct parse_tag tags[] = {
 804                 { .tag  = 'B', .mult = 1       },
 805                 { .tag  = 'K', .mult = 1 << 10 },
 806                 { .tag  = 'M', .mult = 1 << 20 },
 807                 { .tag  = 'G', .mult = 1 << 30 },
 808                 { .tag  = 0 },
 809         };
 810 
 811         if (str == NULL)
 812                 return -EINVAL;
 813 
 814         val = parse_tag_value(str, tags);
 815         if (val != (unsigned long) -1) {
 816                 /* we got file size value */
 817                 pages = PERF_ALIGN(val, page_size) / page_size;
 818         } else {
 819                 /* we got pages count value */
 820                 char *eptr;
 821                 pages = strtoul(str, &eptr, 10);
 822                 if (*eptr != '\0')
 823                         return -EINVAL;
 824         }
 825 
 826         if (pages == 0 && min == 0) {
 827                 /* leave number of pages at 0 */
 828         } else if (!is_power_of_2(pages)) {
 829                 char buf[100];
 830 
 831                 /* round pages up to next power of 2 */
 832                 pages = roundup_pow_of_two(pages);
 833                 if (!pages)
 834                         return -EINVAL;
 835 
 836                 unit_number__scnprintf(buf, sizeof(buf), pages * page_size);
 837                 pr_info("rounding mmap pages size to %s (%lu pages)\n",
 838                         buf, pages);
 839         }
 840 
 841         if (pages > max)
 842                 return -EINVAL;
 843 
 844         return pages;
 845 }
 846 
 847 int __perf_evlist__parse_mmap_pages(unsigned int *mmap_pages, const char *str)
 848 {
 849         unsigned long max = UINT_MAX;
 850         long pages;
 851 
 852         if (max > SIZE_MAX / page_size)
 853                 max = SIZE_MAX / page_size;
 854 
 855         pages = parse_pages_arg(str, 1, max);
 856         if (pages < 0) {
 857                 pr_err("Invalid argument for --mmap_pages/-m\n");
 858                 return -1;
 859         }
 860 
 861         *mmap_pages = pages;
 862         return 0;
 863 }
 864 
 865 int perf_evlist__parse_mmap_pages(const struct option *opt, const char *str,
 866                                   int unset __maybe_unused)
 867 {
 868         return __perf_evlist__parse_mmap_pages(opt->value, str);
 869 }
 870 
 871 /**
 872  * evlist__mmap_ex - Create mmaps to receive events.
 873  * @evlist: list of events
 874  * @pages: map length in pages
 875  * @overwrite: overwrite older events?
 876  * @auxtrace_pages - auxtrace map length in pages
 877  * @auxtrace_overwrite - overwrite older auxtrace data?
 878  *
 879  * If @overwrite is %false the user needs to signal event consumption using
 880  * perf_mmap__write_tail().  Using evlist__mmap_read() does this
 881  * automatically.
 882  *
 883  * Similarly, if @auxtrace_overwrite is %false the user needs to signal data
 884  * consumption using auxtrace_mmap__write_tail().
 885  *
 886  * Return: %0 on success, negative error code otherwise.
 887  */
 888 int evlist__mmap_ex(struct evlist *evlist, unsigned int pages,
 889                          unsigned int auxtrace_pages,
 890                          bool auxtrace_overwrite, int nr_cblocks, int affinity, int flush,
 891                          int comp_level)
 892 {
 893         struct evsel *evsel;
 894         const struct perf_cpu_map *cpus = evlist->core.cpus;
 895         const struct perf_thread_map *threads = evlist->core.threads;
 896         /*
 897          * Delay setting mp.prot: set it before calling perf_mmap__mmap.
 898          * Its value is decided by evsel's write_backward.
 899          * So &mp should not be passed through const pointer.
 900          */
 901         struct mmap_params mp = { .nr_cblocks = nr_cblocks, .affinity = affinity, .flush = flush,
 902                                   .comp_level = comp_level };
 903 
 904         if (!evlist->mmap)
 905                 evlist->mmap = evlist__alloc_mmap(evlist, false);
 906         if (!evlist->mmap)
 907                 return -ENOMEM;
 908 
 909         if (evlist->core.pollfd.entries == NULL && perf_evlist__alloc_pollfd(&evlist->core) < 0)
 910                 return -ENOMEM;
 911 
 912         evlist->core.mmap_len = evlist__mmap_size(pages);
 913         pr_debug("mmap size %zuB\n", evlist->core.mmap_len);
 914         mp.mask = evlist->core.mmap_len - page_size - 1;
 915 
 916         auxtrace_mmap_params__init(&mp.auxtrace_mp, evlist->core.mmap_len,
 917                                    auxtrace_pages, auxtrace_overwrite);
 918 
 919         evlist__for_each_entry(evlist, evsel) {
 920                 if ((evsel->core.attr.read_format & PERF_FORMAT_ID) &&
 921                     evsel->core.sample_id == NULL &&
 922                     perf_evsel__alloc_id(&evsel->core, perf_cpu_map__nr(cpus), threads->nr) < 0)
 923                         return -ENOMEM;
 924         }
 925 
 926         if (perf_cpu_map__empty(cpus))
 927                 return evlist__mmap_per_thread(evlist, &mp);
 928 
 929         return evlist__mmap_per_cpu(evlist, &mp);
 930 }
 931 
 932 int evlist__mmap(struct evlist *evlist, unsigned int pages)
 933 {
 934         return evlist__mmap_ex(evlist, pages, 0, false, 0, PERF_AFFINITY_SYS, 1, 0);
 935 }
 936 
 937 int perf_evlist__create_maps(struct evlist *evlist, struct target *target)
 938 {
 939         bool all_threads = (target->per_thread && target->system_wide);
 940         struct perf_cpu_map *cpus;
 941         struct perf_thread_map *threads;
 942 
 943         /*
 944          * If specify '-a' and '--per-thread' to perf record, perf record
 945          * will override '--per-thread'. target->per_thread = false and
 946          * target->system_wide = true.
 947          *
 948          * If specify '--per-thread' only to perf record,
 949          * target->per_thread = true and target->system_wide = false.
 950          *
 951          * So target->per_thread && target->system_wide is false.
 952          * For perf record, thread_map__new_str doesn't call
 953          * thread_map__new_all_cpus. That will keep perf record's
 954          * current behavior.
 955          *
 956          * For perf stat, it allows the case that target->per_thread and
 957          * target->system_wide are all true. It means to collect system-wide
 958          * per-thread data. thread_map__new_str will call
 959          * thread_map__new_all_cpus to enumerate all threads.
 960          */
 961         threads = thread_map__new_str(target->pid, target->tid, target->uid,
 962                                       all_threads);
 963 
 964         if (!threads)
 965                 return -1;
 966 
 967         if (target__uses_dummy_map(target))
 968                 cpus = perf_cpu_map__dummy_new();
 969         else
 970                 cpus = perf_cpu_map__new(target->cpu_list);
 971 
 972         if (!cpus)
 973                 goto out_delete_threads;
 974 
 975         evlist->core.has_user_cpus = !!target->cpu_list;
 976 
 977         perf_evlist__set_maps(&evlist->core, cpus, threads);
 978 
 979         return 0;
 980 
 981 out_delete_threads:
 982         perf_thread_map__put(threads);
 983         return -1;
 984 }
 985 
 986 void __perf_evlist__set_sample_bit(struct evlist *evlist,
 987                                    enum perf_event_sample_format bit)
 988 {
 989         struct evsel *evsel;
 990 
 991         evlist__for_each_entry(evlist, evsel)
 992                 __perf_evsel__set_sample_bit(evsel, bit);
 993 }
 994 
 995 void __perf_evlist__reset_sample_bit(struct evlist *evlist,
 996                                      enum perf_event_sample_format bit)
 997 {
 998         struct evsel *evsel;
 999 
1000         evlist__for_each_entry(evlist, evsel)
1001                 __perf_evsel__reset_sample_bit(evsel, bit);
1002 }
1003 
1004 int perf_evlist__apply_filters(struct evlist *evlist, struct evsel **err_evsel)
1005 {
1006         struct evsel *evsel;
1007         int err = 0;
1008 
1009         evlist__for_each_entry(evlist, evsel) {
1010                 if (evsel->filter == NULL)
1011                         continue;
1012 
1013                 /*
1014                  * filters only work for tracepoint event, which doesn't have cpu limit.
1015                  * So evlist and evsel should always be same.
1016                  */
1017                 err = perf_evsel__apply_filter(&evsel->core, evsel->filter);
1018                 if (err) {
1019                         *err_evsel = evsel;
1020                         break;
1021                 }
1022         }
1023 
1024         return err;
1025 }
1026 
1027 int perf_evlist__set_tp_filter(struct evlist *evlist, const char *filter)
1028 {
1029         struct evsel *evsel;
1030         int err = 0;
1031 
1032         evlist__for_each_entry(evlist, evsel) {
1033                 if (evsel->core.attr.type != PERF_TYPE_TRACEPOINT)
1034                         continue;
1035 
1036                 err = perf_evsel__set_filter(evsel, filter);
1037                 if (err)
1038                         break;
1039         }
1040 
1041         return err;
1042 }
1043 
1044 int perf_evlist__set_tp_filter_pids(struct evlist *evlist, size_t npids, pid_t *pids)
1045 {
1046         char *filter;
1047         int ret = -1;
1048         size_t i;
1049 
1050         for (i = 0; i < npids; ++i) {
1051                 if (i == 0) {
1052                         if (asprintf(&filter, "common_pid != %d", pids[i]) < 0)
1053                                 return -1;
1054                 } else {
1055                         char *tmp;
1056 
1057                         if (asprintf(&tmp, "%s && common_pid != %d", filter, pids[i]) < 0)
1058                                 goto out_free;
1059 
1060                         free(filter);
1061                         filter = tmp;
1062                 }
1063         }
1064 
1065         ret = perf_evlist__set_tp_filter(evlist, filter);
1066 out_free:
1067         free(filter);
1068         return ret;
1069 }
1070 
1071 int perf_evlist__set_tp_filter_pid(struct evlist *evlist, pid_t pid)
1072 {
1073         return perf_evlist__set_tp_filter_pids(evlist, 1, &pid);
1074 }
1075 
1076 bool perf_evlist__valid_sample_type(struct evlist *evlist)
1077 {
1078         struct evsel *pos;
1079 
1080         if (evlist->core.nr_entries == 1)
1081                 return true;
1082 
1083         if (evlist->id_pos < 0 || evlist->is_pos < 0)
1084                 return false;
1085 
1086         evlist__for_each_entry(evlist, pos) {
1087                 if (pos->id_pos != evlist->id_pos ||
1088                     pos->is_pos != evlist->is_pos)
1089                         return false;
1090         }
1091 
1092         return true;
1093 }
1094 
1095 u64 __perf_evlist__combined_sample_type(struct evlist *evlist)
1096 {
1097         struct evsel *evsel;
1098 
1099         if (evlist->combined_sample_type)
1100                 return evlist->combined_sample_type;
1101 
1102         evlist__for_each_entry(evlist, evsel)
1103                 evlist->combined_sample_type |= evsel->core.attr.sample_type;
1104 
1105         return evlist->combined_sample_type;
1106 }
1107 
1108 u64 perf_evlist__combined_sample_type(struct evlist *evlist)
1109 {
1110         evlist->combined_sample_type = 0;
1111         return __perf_evlist__combined_sample_type(evlist);
1112 }
1113 
1114 u64 perf_evlist__combined_branch_type(struct evlist *evlist)
1115 {
1116         struct evsel *evsel;
1117         u64 branch_type = 0;
1118 
1119         evlist__for_each_entry(evlist, evsel)
1120                 branch_type |= evsel->core.attr.branch_sample_type;
1121         return branch_type;
1122 }
1123 
1124 bool perf_evlist__valid_read_format(struct evlist *evlist)
1125 {
1126         struct evsel *first = evlist__first(evlist), *pos = first;
1127         u64 read_format = first->core.attr.read_format;
1128         u64 sample_type = first->core.attr.sample_type;
1129 
1130         evlist__for_each_entry(evlist, pos) {
1131                 if (read_format != pos->core.attr.read_format)
1132                         return false;
1133         }
1134 
1135         /* PERF_SAMPLE_READ imples PERF_FORMAT_ID. */
1136         if ((sample_type & PERF_SAMPLE_READ) &&
1137             !(read_format & PERF_FORMAT_ID)) {
1138                 return false;
1139         }
1140 
1141         return true;
1142 }
1143 
1144 u16 perf_evlist__id_hdr_size(struct evlist *evlist)
1145 {
1146         struct evsel *first = evlist__first(evlist);
1147         struct perf_sample *data;
1148         u64 sample_type;
1149         u16 size = 0;
1150 
1151         if (!first->core.attr.sample_id_all)
1152                 goto out;
1153 
1154         sample_type = first->core.attr.sample_type;
1155 
1156         if (sample_type & PERF_SAMPLE_TID)
1157                 size += sizeof(data->tid) * 2;
1158 
1159        if (sample_type & PERF_SAMPLE_TIME)
1160                 size += sizeof(data->time);
1161 
1162         if (sample_type & PERF_SAMPLE_ID)
1163                 size += sizeof(data->id);
1164 
1165         if (sample_type & PERF_SAMPLE_STREAM_ID)
1166                 size += sizeof(data->stream_id);
1167 
1168         if (sample_type & PERF_SAMPLE_CPU)
1169                 size += sizeof(data->cpu) * 2;
1170 
1171         if (sample_type & PERF_SAMPLE_IDENTIFIER)
1172                 size += sizeof(data->id);
1173 out:
1174         return size;
1175 }
1176 
1177 bool perf_evlist__valid_sample_id_all(struct evlist *evlist)
1178 {
1179         struct evsel *first = evlist__first(evlist), *pos = first;
1180 
1181         evlist__for_each_entry_continue(evlist, pos) {
1182                 if (first->core.attr.sample_id_all != pos->core.attr.sample_id_all)
1183                         return false;
1184         }
1185 
1186         return true;
1187 }
1188 
1189 bool perf_evlist__sample_id_all(struct evlist *evlist)
1190 {
1191         struct evsel *first = evlist__first(evlist);
1192         return first->core.attr.sample_id_all;
1193 }
1194 
1195 void perf_evlist__set_selected(struct evlist *evlist,
1196                                struct evsel *evsel)
1197 {
1198         evlist->selected = evsel;
1199 }
1200 
1201 void evlist__close(struct evlist *evlist)
1202 {
1203         struct evsel *evsel;
1204 
1205         evlist__for_each_entry_reverse(evlist, evsel)
1206                 evsel__close(evsel);
1207 }
1208 
1209 static int perf_evlist__create_syswide_maps(struct evlist *evlist)
1210 {
1211         struct perf_cpu_map *cpus;
1212         struct perf_thread_map *threads;
1213         int err = -ENOMEM;
1214 
1215         /*
1216          * Try reading /sys/devices/system/cpu/online to get
1217          * an all cpus map.
1218          *
1219          * FIXME: -ENOMEM is the best we can do here, the cpu_map
1220          * code needs an overhaul to properly forward the
1221          * error, and we may not want to do that fallback to a
1222          * default cpu identity map :-\
1223          */
1224         cpus = perf_cpu_map__new(NULL);
1225         if (!cpus)
1226                 goto out;
1227 
1228         threads = perf_thread_map__new_dummy();
1229         if (!threads)
1230                 goto out_put;
1231 
1232         perf_evlist__set_maps(&evlist->core, cpus, threads);
1233 out:
1234         return err;
1235 out_put:
1236         perf_cpu_map__put(cpus);
1237         goto out;
1238 }
1239 
1240 int evlist__open(struct evlist *evlist)
1241 {
1242         struct evsel *evsel;
1243         int err;
1244 
1245         /*
1246          * Default: one fd per CPU, all threads, aka systemwide
1247          * as sys_perf_event_open(cpu = -1, thread = -1) is EINVAL
1248          */
1249         if (evlist->core.threads == NULL && evlist->core.cpus == NULL) {
1250                 err = perf_evlist__create_syswide_maps(evlist);
1251                 if (err < 0)
1252                         goto out_err;
1253         }
1254 
1255         perf_evlist__update_id_pos(evlist);
1256 
1257         evlist__for_each_entry(evlist, evsel) {
1258                 err = evsel__open(evsel, evsel->core.cpus, evsel->core.threads);
1259                 if (err < 0)
1260                         goto out_err;
1261         }
1262 
1263         return 0;
1264 out_err:
1265         evlist__close(evlist);
1266         errno = -err;
1267         return err;
1268 }
1269 
1270 int perf_evlist__prepare_workload(struct evlist *evlist, struct target *target,
1271                                   const char *argv[], bool pipe_output,
1272                                   void (*exec_error)(int signo, siginfo_t *info, void *ucontext))
1273 {
1274         int child_ready_pipe[2], go_pipe[2];
1275         char bf;
1276 
1277         if (pipe(child_ready_pipe) < 0) {
1278                 perror("failed to create 'ready' pipe");
1279                 return -1;
1280         }
1281 
1282         if (pipe(go_pipe) < 0) {
1283                 perror("failed to create 'go' pipe");
1284                 goto out_close_ready_pipe;
1285         }
1286 
1287         evlist->workload.pid = fork();
1288         if (evlist->workload.pid < 0) {
1289                 perror("failed to fork");
1290                 goto out_close_pipes;
1291         }
1292 
1293         if (!evlist->workload.pid) {
1294                 int ret;
1295 
1296                 if (pipe_output)
1297                         dup2(2, 1);
1298 
1299                 signal(SIGTERM, SIG_DFL);
1300 
1301                 close(child_ready_pipe[0]);
1302                 close(go_pipe[1]);
1303                 fcntl(go_pipe[0], F_SETFD, FD_CLOEXEC);
1304 
1305                 /*
1306                  * Tell the parent we're ready to go
1307                  */
1308                 close(child_ready_pipe[1]);
1309 
1310                 /*
1311                  * Wait until the parent tells us to go.
1312                  */
1313                 ret = read(go_pipe[0], &bf, 1);
1314                 /*
1315                  * The parent will ask for the execvp() to be performed by
1316                  * writing exactly one byte, in workload.cork_fd, usually via
1317                  * perf_evlist__start_workload().
1318                  *
1319                  * For cancelling the workload without actually running it,
1320                  * the parent will just close workload.cork_fd, without writing
1321                  * anything, i.e. read will return zero and we just exit()
1322                  * here.
1323                  */
1324                 if (ret != 1) {
1325                         if (ret == -1)
1326                                 perror("unable to read pipe");
1327                         exit(ret);
1328                 }
1329 
1330                 execvp(argv[0], (char **)argv);
1331 
1332                 if (exec_error) {
1333                         union sigval val;
1334 
1335                         val.sival_int = errno;
1336                         if (sigqueue(getppid(), SIGUSR1, val))
1337                                 perror(argv[0]);
1338                 } else
1339                         perror(argv[0]);
1340                 exit(-1);
1341         }
1342 
1343         if (exec_error) {
1344                 struct sigaction act = {
1345                         .sa_flags     = SA_SIGINFO,
1346                         .sa_sigaction = exec_error,
1347                 };
1348                 sigaction(SIGUSR1, &act, NULL);
1349         }
1350 
1351         if (target__none(target)) {
1352                 if (evlist->core.threads == NULL) {
1353                         fprintf(stderr, "FATAL: evlist->threads need to be set at this point (%s:%d).\n",
1354                                 __func__, __LINE__);
1355                         goto out_close_pipes;
1356                 }
1357                 perf_thread_map__set_pid(evlist->core.threads, 0, evlist->workload.pid);
1358         }
1359 
1360         close(child_ready_pipe[1]);
1361         close(go_pipe[0]);
1362         /*
1363          * wait for child to settle
1364          */
1365         if (read(child_ready_pipe[0], &bf, 1) == -1) {
1366                 perror("unable to read pipe");
1367                 goto out_close_pipes;
1368         }
1369 
1370         fcntl(go_pipe[1], F_SETFD, FD_CLOEXEC);
1371         evlist->workload.cork_fd = go_pipe[1];
1372         close(child_ready_pipe[0]);
1373         return 0;
1374 
1375 out_close_pipes:
1376         close(go_pipe[0]);
1377         close(go_pipe[1]);
1378 out_close_ready_pipe:
1379         close(child_ready_pipe[0]);
1380         close(child_ready_pipe[1]);
1381         return -1;
1382 }
1383 
1384 int perf_evlist__start_workload(struct evlist *evlist)
1385 {
1386         if (evlist->workload.cork_fd > 0) {
1387                 char bf = 0;
1388                 int ret;
1389                 /*
1390                  * Remove the cork, let it rip!
1391                  */
1392                 ret = write(evlist->workload.cork_fd, &bf, 1);
1393                 if (ret < 0)
1394                         perror("unable to write to pipe");
1395 
1396                 close(evlist->workload.cork_fd);
1397                 return ret;
1398         }
1399 
1400         return 0;
1401 }
1402 
1403 int perf_evlist__parse_sample(struct evlist *evlist, union perf_event *event,
1404                               struct perf_sample *sample)
1405 {
1406         struct evsel *evsel = perf_evlist__event2evsel(evlist, event);
1407 
1408         if (!evsel)
1409                 return -EFAULT;
1410         return perf_evsel__parse_sample(evsel, event, sample);
1411 }
1412 
1413 int perf_evlist__parse_sample_timestamp(struct evlist *evlist,
1414                                         union perf_event *event,
1415                                         u64 *timestamp)
1416 {
1417         struct evsel *evsel = perf_evlist__event2evsel(evlist, event);
1418 
1419         if (!evsel)
1420                 return -EFAULT;
1421         return perf_evsel__parse_sample_timestamp(evsel, event, timestamp);
1422 }
1423 
1424 int perf_evlist__strerror_open(struct evlist *evlist,
1425                                int err, char *buf, size_t size)
1426 {
1427         int printed, value;
1428         char sbuf[STRERR_BUFSIZE], *emsg = str_error_r(err, sbuf, sizeof(sbuf));
1429 
1430         switch (err) {
1431         case EACCES:
1432         case EPERM:
1433                 printed = scnprintf(buf, size,
1434                                     "Error:\t%s.\n"
1435                                     "Hint:\tCheck /proc/sys/kernel/perf_event_paranoid setting.", emsg);
1436 
1437                 value = perf_event_paranoid();
1438 
1439                 printed += scnprintf(buf + printed, size - printed, "\nHint:\t");
1440 
1441                 if (value >= 2) {
1442                         printed += scnprintf(buf + printed, size - printed,
1443                                              "For your workloads it needs to be <= 1\nHint:\t");
1444                 }
1445                 printed += scnprintf(buf + printed, size - printed,
1446                                      "For system wide tracing it needs to be set to -1.\n");
1447 
1448                 printed += scnprintf(buf + printed, size - printed,
1449                                     "Hint:\tTry: 'sudo sh -c \"echo -1 > /proc/sys/kernel/perf_event_paranoid\"'\n"
1450                                     "Hint:\tThe current value is %d.", value);
1451                 break;
1452         case EINVAL: {
1453                 struct evsel *first = evlist__first(evlist);
1454                 int max_freq;
1455 
1456                 if (sysctl__read_int("kernel/perf_event_max_sample_rate", &max_freq) < 0)
1457                         goto out_default;
1458 
1459                 if (first->core.attr.sample_freq < (u64)max_freq)
1460                         goto out_default;
1461 
1462                 printed = scnprintf(buf, size,
1463                                     "Error:\t%s.\n"
1464                                     "Hint:\tCheck /proc/sys/kernel/perf_event_max_sample_rate.\n"
1465                                     "Hint:\tThe current value is %d and %" PRIu64 " is being requested.",
1466                                     emsg, max_freq, first->core.attr.sample_freq);
1467                 break;
1468         }
1469         default:
1470 out_default:
1471                 scnprintf(buf, size, "%s", emsg);
1472                 break;
1473         }
1474 
1475         return 0;
1476 }
1477 
1478 int perf_evlist__strerror_mmap(struct evlist *evlist, int err, char *buf, size_t size)
1479 {
1480         char sbuf[STRERR_BUFSIZE], *emsg = str_error_r(err, sbuf, sizeof(sbuf));
1481         int pages_attempted = evlist->core.mmap_len / 1024, pages_max_per_user, printed = 0;
1482 
1483         switch (err) {
1484         case EPERM:
1485                 sysctl__read_int("kernel/perf_event_mlock_kb", &pages_max_per_user);
1486                 printed += scnprintf(buf + printed, size - printed,
1487                                      "Error:\t%s.\n"
1488                                      "Hint:\tCheck /proc/sys/kernel/perf_event_mlock_kb (%d kB) setting.\n"
1489                                      "Hint:\tTried using %zd kB.\n",
1490                                      emsg, pages_max_per_user, pages_attempted);
1491 
1492                 if (pages_attempted >= pages_max_per_user) {
1493                         printed += scnprintf(buf + printed, size - printed,
1494                                              "Hint:\tTry 'sudo sh -c \"echo %d > /proc/sys/kernel/perf_event_mlock_kb\"', or\n",
1495                                              pages_max_per_user + pages_attempted);
1496                 }
1497 
1498                 printed += scnprintf(buf + printed, size - printed,
1499                                      "Hint:\tTry using a smaller -m/--mmap-pages value.");
1500                 break;
1501         default:
1502                 scnprintf(buf, size, "%s", emsg);
1503                 break;
1504         }
1505 
1506         return 0;
1507 }
1508 
1509 void perf_evlist__to_front(struct evlist *evlist,
1510                            struct evsel *move_evsel)
1511 {
1512         struct evsel *evsel, *n;
1513         LIST_HEAD(move);
1514 
1515         if (move_evsel == evlist__first(evlist))
1516                 return;
1517 
1518         evlist__for_each_entry_safe(evlist, n, evsel) {
1519                 if (evsel->leader == move_evsel->leader)
1520                         list_move_tail(&evsel->core.node, &move);
1521         }
1522 
1523         list_splice(&move, &evlist->core.entries);
1524 }
1525 
1526 void perf_evlist__set_tracking_event(struct evlist *evlist,
1527                                      struct evsel *tracking_evsel)
1528 {
1529         struct evsel *evsel;
1530 
1531         if (tracking_evsel->tracking)
1532                 return;
1533 
1534         evlist__for_each_entry(evlist, evsel) {
1535                 if (evsel != tracking_evsel)
1536                         evsel->tracking = false;
1537         }
1538 
1539         tracking_evsel->tracking = true;
1540 }
1541 
1542 struct evsel *
1543 perf_evlist__find_evsel_by_str(struct evlist *evlist,
1544                                const char *str)
1545 {
1546         struct evsel *evsel;
1547 
1548         evlist__for_each_entry(evlist, evsel) {
1549                 if (!evsel->name)
1550                         continue;
1551                 if (strcmp(str, evsel->name) == 0)
1552                         return evsel;
1553         }
1554 
1555         return NULL;
1556 }
1557 
1558 void perf_evlist__toggle_bkw_mmap(struct evlist *evlist,
1559                                   enum bkw_mmap_state state)
1560 {
1561         enum bkw_mmap_state old_state = evlist->bkw_mmap_state;
1562         enum action {
1563                 NONE,
1564                 PAUSE,
1565                 RESUME,
1566         } action = NONE;
1567 
1568         if (!evlist->overwrite_mmap)
1569                 return;
1570 
1571         switch (old_state) {
1572         case BKW_MMAP_NOTREADY: {
1573                 if (state != BKW_MMAP_RUNNING)
1574                         goto state_err;
1575                 break;
1576         }
1577         case BKW_MMAP_RUNNING: {
1578                 if (state != BKW_MMAP_DATA_PENDING)
1579                         goto state_err;
1580                 action = PAUSE;
1581                 break;
1582         }
1583         case BKW_MMAP_DATA_PENDING: {
1584                 if (state != BKW_MMAP_EMPTY)
1585                         goto state_err;
1586                 break;
1587         }
1588         case BKW_MMAP_EMPTY: {
1589                 if (state != BKW_MMAP_RUNNING)
1590                         goto state_err;
1591                 action = RESUME;
1592                 break;
1593         }
1594         default:
1595                 WARN_ONCE(1, "Shouldn't get there\n");
1596         }
1597 
1598         evlist->bkw_mmap_state = state;
1599 
1600         switch (action) {
1601         case PAUSE:
1602                 perf_evlist__pause(evlist);
1603                 break;
1604         case RESUME:
1605                 perf_evlist__resume(evlist);
1606                 break;
1607         case NONE:
1608         default:
1609                 break;
1610         }
1611 
1612 state_err:
1613         return;
1614 }
1615 
1616 bool perf_evlist__exclude_kernel(struct evlist *evlist)
1617 {
1618         struct evsel *evsel;
1619 
1620         evlist__for_each_entry(evlist, evsel) {
1621                 if (!evsel->core.attr.exclude_kernel)
1622                         return false;
1623         }
1624 
1625         return true;
1626 }
1627 
1628 /*
1629  * Events in data file are not collect in groups, but we still want
1630  * the group display. Set the artificial group and set the leader's
1631  * forced_leader flag to notify the display code.
1632  */
1633 void perf_evlist__force_leader(struct evlist *evlist)
1634 {
1635         if (!evlist->nr_groups) {
1636                 struct evsel *leader = evlist__first(evlist);
1637 
1638                 perf_evlist__set_leader(evlist);
1639                 leader->forced_leader = true;
1640         }
1641 }
1642 
1643 struct evsel *perf_evlist__reset_weak_group(struct evlist *evsel_list,
1644                                                  struct evsel *evsel)
1645 {
1646         struct evsel *c2, *leader;
1647         bool is_open = true;
1648 
1649         leader = evsel->leader;
1650         pr_debug("Weak group for %s/%d failed\n",
1651                         leader->name, leader->core.nr_members);
1652 
1653         /*
1654          * for_each_group_member doesn't work here because it doesn't
1655          * include the first entry.
1656          */
1657         evlist__for_each_entry(evsel_list, c2) {
1658                 if (c2 == evsel)
1659                         is_open = false;
1660                 if (c2->leader == leader) {
1661                         if (is_open)
1662                                 perf_evsel__close(&c2->core);
1663                         c2->leader = c2;
1664                         c2->core.nr_members = 0;
1665                 }
1666         }
1667         return leader;
1668 }
1669 
1670 int perf_evlist__add_sb_event(struct evlist **evlist,
1671                               struct perf_event_attr *attr,
1672                               perf_evsel__sb_cb_t cb,
1673                               void *data)
1674 {
1675         struct evsel *evsel;
1676         bool new_evlist = (*evlist) == NULL;
1677 
1678         if (*evlist == NULL)
1679                 *evlist = evlist__new();
1680         if (*evlist == NULL)
1681                 return -1;
1682 
1683         if (!attr->sample_id_all) {
1684                 pr_warning("enabling sample_id_all for all side band events\n");
1685                 attr->sample_id_all = 1;
1686         }
1687 
1688         evsel = perf_evsel__new_idx(attr, (*evlist)->core.nr_entries);
1689         if (!evsel)
1690                 goto out_err;
1691 
1692         evsel->side_band.cb = cb;
1693         evsel->side_band.data = data;
1694         evlist__add(*evlist, evsel);
1695         return 0;
1696 
1697 out_err:
1698         if (new_evlist) {
1699                 evlist__delete(*evlist);
1700                 *evlist = NULL;
1701         }
1702         return -1;
1703 }
1704 
1705 static void *perf_evlist__poll_thread(void *arg)
1706 {
1707         struct evlist *evlist = arg;
1708         bool draining = false;
1709         int i, done = 0;
1710         /*
1711          * In order to read symbols from other namespaces perf to needs to call
1712          * setns(2).  This isn't permitted if the struct_fs has multiple users.
1713          * unshare(2) the fs so that we may continue to setns into namespaces
1714          * that we're observing when, for instance, reading the build-ids at
1715          * the end of a 'perf record' session.
1716          */
1717         unshare(CLONE_FS);
1718 
1719         while (!done) {
1720                 bool got_data = false;
1721 
1722                 if (evlist->thread.done)
1723                         draining = true;
1724 
1725                 if (!draining)
1726                         evlist__poll(evlist, 1000);
1727 
1728                 for (i = 0; i < evlist->core.nr_mmaps; i++) {
1729                         struct mmap *map = &evlist->mmap[i];
1730                         union perf_event *event;
1731 
1732                         if (perf_mmap__read_init(map))
1733                                 continue;
1734                         while ((event = perf_mmap__read_event(map)) != NULL) {
1735                                 struct evsel *evsel = perf_evlist__event2evsel(evlist, event);
1736 
1737                                 if (evsel && evsel->side_band.cb)
1738                                         evsel->side_band.cb(event, evsel->side_band.data);
1739                                 else
1740                                         pr_warning("cannot locate proper evsel for the side band event\n");
1741 
1742                                 perf_mmap__consume(map);
1743                                 got_data = true;
1744                         }
1745                         perf_mmap__read_done(map);
1746                 }
1747 
1748                 if (draining && !got_data)
1749                         break;
1750         }
1751         return NULL;
1752 }
1753 
1754 int perf_evlist__start_sb_thread(struct evlist *evlist,
1755                                  struct target *target)
1756 {
1757         struct evsel *counter;
1758 
1759         if (!evlist)
1760                 return 0;
1761 
1762         if (perf_evlist__create_maps(evlist, target))
1763                 goto out_delete_evlist;
1764 
1765         evlist__for_each_entry(evlist, counter) {
1766                 if (evsel__open(counter, evlist->core.cpus,
1767                                      evlist->core.threads) < 0)
1768                         goto out_delete_evlist;
1769         }
1770 
1771         if (evlist__mmap(evlist, UINT_MAX))
1772                 goto out_delete_evlist;
1773 
1774         evlist__for_each_entry(evlist, counter) {
1775                 if (evsel__enable(counter))
1776                         goto out_delete_evlist;
1777         }
1778 
1779         evlist->thread.done = 0;
1780         if (pthread_create(&evlist->thread.th, NULL, perf_evlist__poll_thread, evlist))
1781                 goto out_delete_evlist;
1782 
1783         return 0;
1784 
1785 out_delete_evlist:
1786         evlist__delete(evlist);
1787         evlist = NULL;
1788         return -1;
1789 }
1790 
1791 void perf_evlist__stop_sb_thread(struct evlist *evlist)
1792 {
1793         if (!evlist)
1794                 return;
1795         evlist->thread.done = 1;
1796         pthread_join(evlist->thread.th, NULL);
1797         evlist__delete(evlist);
1798 }

/* [<][>][^][v][top][bottom][index][help] */