4 #include "util/cache.h"
5 #include "util/debug.h"
6 #include <subcmd/exec-cmd.h>
7 #include "util/header.h"
8 #include <subcmd/parse-options.h>
9 #include "util/perf_regs.h"
10 #include "util/session.h"
11 #include "util/tool.h"
12 #include "util/symbol.h"
13 #include "util/thread.h"
14 #include "util/trace-event.h"
15 #include "util/util.h"
16 #include "util/evlist.h"
17 #include "util/evsel.h"
18 #include "util/sort.h"
19 #include "util/data.h"
20 #include "util/auxtrace.h"
21 #include "util/cpumap.h"
22 #include "util/thread_map.h"
23 #include "util/stat.h"
24 #include "util/thread-stack.h"
25 #include "util/time-utils.h"
26 #include <linux/bitmap.h>
27 #include <linux/stringify.h>
28 #include <linux/time64.h>
30 #include "util/mem-events.h"
32 static char const *script_name;
33 static char const *generate_script_lang;
34 static bool debug_mode;
35 static u64 last_timestamp;
36 static u64 nr_unordered;
37 static bool no_callchain;
38 static bool latency_format;
39 static bool system_wide;
40 static bool print_flags;
42 static const char *cpu_list;
43 static DECLARE_BITMAP(cpu_bitmap, MAX_NR_CPUS);
44 static struct perf_stat_config stat_config;
46 unsigned int scripting_max_stack = PERF_MAX_STACK_DEPTH;
48 enum perf_output_field {
49 PERF_OUTPUT_COMM = 1U << 0,
50 PERF_OUTPUT_TID = 1U << 1,
51 PERF_OUTPUT_PID = 1U << 2,
52 PERF_OUTPUT_TIME = 1U << 3,
53 PERF_OUTPUT_CPU = 1U << 4,
54 PERF_OUTPUT_EVNAME = 1U << 5,
55 PERF_OUTPUT_TRACE = 1U << 6,
56 PERF_OUTPUT_IP = 1U << 7,
57 PERF_OUTPUT_SYM = 1U << 8,
58 PERF_OUTPUT_DSO = 1U << 9,
59 PERF_OUTPUT_ADDR = 1U << 10,
60 PERF_OUTPUT_SYMOFFSET = 1U << 11,
61 PERF_OUTPUT_SRCLINE = 1U << 12,
62 PERF_OUTPUT_PERIOD = 1U << 13,
63 PERF_OUTPUT_IREGS = 1U << 14,
64 PERF_OUTPUT_BRSTACK = 1U << 15,
65 PERF_OUTPUT_BRSTACKSYM = 1U << 16,
66 PERF_OUTPUT_DATA_SRC = 1U << 17,
67 PERF_OUTPUT_WEIGHT = 1U << 18,
68 PERF_OUTPUT_BPF_OUTPUT = 1U << 19,
69 PERF_OUTPUT_CALLINDENT = 1U << 20,
70 PERF_OUTPUT_INSN = 1U << 21,
71 PERF_OUTPUT_INSNLEN = 1U << 22,
74 struct output_option {
76 enum perf_output_field field;
77 } all_output_options[] = {
78 {.str = "comm", .field = PERF_OUTPUT_COMM},
79 {.str = "tid", .field = PERF_OUTPUT_TID},
80 {.str = "pid", .field = PERF_OUTPUT_PID},
81 {.str = "time", .field = PERF_OUTPUT_TIME},
82 {.str = "cpu", .field = PERF_OUTPUT_CPU},
83 {.str = "event", .field = PERF_OUTPUT_EVNAME},
84 {.str = "trace", .field = PERF_OUTPUT_TRACE},
85 {.str = "ip", .field = PERF_OUTPUT_IP},
86 {.str = "sym", .field = PERF_OUTPUT_SYM},
87 {.str = "dso", .field = PERF_OUTPUT_DSO},
88 {.str = "addr", .field = PERF_OUTPUT_ADDR},
89 {.str = "symoff", .field = PERF_OUTPUT_SYMOFFSET},
90 {.str = "srcline", .field = PERF_OUTPUT_SRCLINE},
91 {.str = "period", .field = PERF_OUTPUT_PERIOD},
92 {.str = "iregs", .field = PERF_OUTPUT_IREGS},
93 {.str = "brstack", .field = PERF_OUTPUT_BRSTACK},
94 {.str = "brstacksym", .field = PERF_OUTPUT_BRSTACKSYM},
95 {.str = "data_src", .field = PERF_OUTPUT_DATA_SRC},
96 {.str = "weight", .field = PERF_OUTPUT_WEIGHT},
97 {.str = "bpf-output", .field = PERF_OUTPUT_BPF_OUTPUT},
98 {.str = "callindent", .field = PERF_OUTPUT_CALLINDENT},
99 {.str = "insn", .field = PERF_OUTPUT_INSN},
100 {.str = "insnlen", .field = PERF_OUTPUT_INSNLEN},
103 /* default set to maintain compatibility with current format */
107 unsigned int print_ip_opts;
110 } output[PERF_TYPE_MAX] = {
112 [PERF_TYPE_HARDWARE] = {
115 .fields = PERF_OUTPUT_COMM | PERF_OUTPUT_TID |
116 PERF_OUTPUT_CPU | PERF_OUTPUT_TIME |
117 PERF_OUTPUT_EVNAME | PERF_OUTPUT_IP |
118 PERF_OUTPUT_SYM | PERF_OUTPUT_DSO |
121 .invalid_fields = PERF_OUTPUT_TRACE | PERF_OUTPUT_BPF_OUTPUT,
124 [PERF_TYPE_SOFTWARE] = {
127 .fields = PERF_OUTPUT_COMM | PERF_OUTPUT_TID |
128 PERF_OUTPUT_CPU | PERF_OUTPUT_TIME |
129 PERF_OUTPUT_EVNAME | PERF_OUTPUT_IP |
130 PERF_OUTPUT_SYM | PERF_OUTPUT_DSO |
131 PERF_OUTPUT_PERIOD | PERF_OUTPUT_BPF_OUTPUT,
133 .invalid_fields = PERF_OUTPUT_TRACE,
136 [PERF_TYPE_TRACEPOINT] = {
139 .fields = PERF_OUTPUT_COMM | PERF_OUTPUT_TID |
140 PERF_OUTPUT_CPU | PERF_OUTPUT_TIME |
141 PERF_OUTPUT_EVNAME | PERF_OUTPUT_TRACE
147 .fields = PERF_OUTPUT_COMM | PERF_OUTPUT_TID |
148 PERF_OUTPUT_CPU | PERF_OUTPUT_TIME |
149 PERF_OUTPUT_EVNAME | PERF_OUTPUT_IP |
150 PERF_OUTPUT_SYM | PERF_OUTPUT_DSO |
151 PERF_OUTPUT_PERIOD | PERF_OUTPUT_ADDR |
152 PERF_OUTPUT_DATA_SRC | PERF_OUTPUT_WEIGHT,
154 .invalid_fields = PERF_OUTPUT_TRACE | PERF_OUTPUT_BPF_OUTPUT,
157 [PERF_TYPE_BREAKPOINT] = {
160 .fields = PERF_OUTPUT_COMM | PERF_OUTPUT_TID |
161 PERF_OUTPUT_CPU | PERF_OUTPUT_TIME |
162 PERF_OUTPUT_EVNAME | PERF_OUTPUT_IP |
163 PERF_OUTPUT_SYM | PERF_OUTPUT_DSO |
166 .invalid_fields = PERF_OUTPUT_TRACE | PERF_OUTPUT_BPF_OUTPUT,
170 static bool output_set_by_user(void)
173 for (j = 0; j < PERF_TYPE_MAX; ++j) {
174 if (output[j].user_set)
180 static const char *output_field2str(enum perf_output_field field)
182 int i, imax = ARRAY_SIZE(all_output_options);
183 const char *str = "";
185 for (i = 0; i < imax; ++i) {
186 if (all_output_options[i].field == field) {
187 str = all_output_options[i].str;
194 #define PRINT_FIELD(x) (output[attr->type].fields & PERF_OUTPUT_##x)
196 static int perf_evsel__do_check_stype(struct perf_evsel *evsel,
197 u64 sample_type, const char *sample_msg,
198 enum perf_output_field field,
201 struct perf_event_attr *attr = &evsel->attr;
202 int type = attr->type;
205 if (attr->sample_type & sample_type)
208 if (output[type].user_set) {
211 evname = perf_evsel__name(evsel);
212 pr_err("Samples for '%s' event do not have %s attribute set. "
213 "Cannot print '%s' field.\n",
214 evname, sample_msg, output_field2str(field));
218 /* user did not ask for it explicitly so remove from the default list */
219 output[type].fields &= ~field;
220 evname = perf_evsel__name(evsel);
221 pr_debug("Samples for '%s' event do not have %s attribute set. "
222 "Skipping '%s' field.\n",
223 evname, sample_msg, output_field2str(field));
228 static int perf_evsel__check_stype(struct perf_evsel *evsel,
229 u64 sample_type, const char *sample_msg,
230 enum perf_output_field field)
232 return perf_evsel__do_check_stype(evsel, sample_type, sample_msg, field,
236 static int perf_evsel__check_attr(struct perf_evsel *evsel,
237 struct perf_session *session)
239 struct perf_event_attr *attr = &evsel->attr;
242 if (perf_header__has_feat(&session->header, HEADER_STAT))
245 allow_user_set = perf_header__has_feat(&session->header,
248 if (PRINT_FIELD(TRACE) &&
249 !perf_session__has_traces(session, "record -R"))
252 if (PRINT_FIELD(IP)) {
253 if (perf_evsel__check_stype(evsel, PERF_SAMPLE_IP, "IP",
258 if (PRINT_FIELD(ADDR) &&
259 perf_evsel__do_check_stype(evsel, PERF_SAMPLE_ADDR, "ADDR",
260 PERF_OUTPUT_ADDR, allow_user_set))
263 if (PRINT_FIELD(DATA_SRC) &&
264 perf_evsel__check_stype(evsel, PERF_SAMPLE_DATA_SRC, "DATA_SRC",
265 PERF_OUTPUT_DATA_SRC))
268 if (PRINT_FIELD(WEIGHT) &&
269 perf_evsel__check_stype(evsel, PERF_SAMPLE_WEIGHT, "WEIGHT",
273 if (PRINT_FIELD(SYM) && !PRINT_FIELD(IP) && !PRINT_FIELD(ADDR)) {
274 pr_err("Display of symbols requested but neither sample IP nor "
275 "sample address\nis selected. Hence, no addresses to convert "
279 if (PRINT_FIELD(SYMOFFSET) && !PRINT_FIELD(SYM)) {
280 pr_err("Display of offsets requested but symbol is not"
284 if (PRINT_FIELD(DSO) && !PRINT_FIELD(IP) && !PRINT_FIELD(ADDR)) {
285 pr_err("Display of DSO requested but neither sample IP nor "
286 "sample address\nis selected. Hence, no addresses to convert "
290 if (PRINT_FIELD(SRCLINE) && !PRINT_FIELD(IP)) {
291 pr_err("Display of source line number requested but sample IP is not\n"
292 "selected. Hence, no address to lookup the source line number.\n");
296 if ((PRINT_FIELD(PID) || PRINT_FIELD(TID)) &&
297 perf_evsel__check_stype(evsel, PERF_SAMPLE_TID, "TID",
298 PERF_OUTPUT_TID|PERF_OUTPUT_PID))
301 if (PRINT_FIELD(TIME) &&
302 perf_evsel__check_stype(evsel, PERF_SAMPLE_TIME, "TIME",
306 if (PRINT_FIELD(CPU) &&
307 perf_evsel__do_check_stype(evsel, PERF_SAMPLE_CPU, "CPU",
308 PERF_OUTPUT_CPU, allow_user_set))
311 if (PRINT_FIELD(PERIOD) &&
312 perf_evsel__check_stype(evsel, PERF_SAMPLE_PERIOD, "PERIOD",
316 if (PRINT_FIELD(IREGS) &&
317 perf_evsel__check_stype(evsel, PERF_SAMPLE_REGS_INTR, "IREGS",
324 static void set_print_ip_opts(struct perf_event_attr *attr)
326 unsigned int type = attr->type;
328 output[type].print_ip_opts = 0;
330 output[type].print_ip_opts |= EVSEL__PRINT_IP;
332 if (PRINT_FIELD(SYM))
333 output[type].print_ip_opts |= EVSEL__PRINT_SYM;
335 if (PRINT_FIELD(DSO))
336 output[type].print_ip_opts |= EVSEL__PRINT_DSO;
338 if (PRINT_FIELD(SYMOFFSET))
339 output[type].print_ip_opts |= EVSEL__PRINT_SYMOFFSET;
341 if (PRINT_FIELD(SRCLINE))
342 output[type].print_ip_opts |= EVSEL__PRINT_SRCLINE;
346 * verify all user requested events exist and the samples
347 * have the expected data
349 static int perf_session__check_output_opt(struct perf_session *session)
352 struct perf_evsel *evsel;
354 for (j = 0; j < PERF_TYPE_MAX; ++j) {
355 evsel = perf_session__find_first_evtype(session, j);
358 * even if fields is set to 0 (ie., show nothing) event must
359 * exist if user explicitly includes it on the command line
361 if (!evsel && output[j].user_set && !output[j].wildcard_set) {
362 pr_err("%s events do not exist. "
363 "Remove corresponding -f option to proceed.\n",
368 if (evsel && output[j].fields &&
369 perf_evsel__check_attr(evsel, session))
375 set_print_ip_opts(&evsel->attr);
379 bool use_callchain = false;
380 bool not_pipe = false;
382 evlist__for_each_entry(session->evlist, evsel) {
384 if (evsel->attr.sample_type & PERF_SAMPLE_CALLCHAIN) {
385 use_callchain = true;
389 if (not_pipe && !use_callchain)
390 symbol_conf.use_callchain = false;
394 * set default for tracepoints to print symbols only
395 * if callchains are present
397 if (symbol_conf.use_callchain &&
398 !output[PERF_TYPE_TRACEPOINT].user_set) {
399 struct perf_event_attr *attr;
401 j = PERF_TYPE_TRACEPOINT;
403 evlist__for_each_entry(session->evlist, evsel) {
404 if (evsel->attr.type != j)
409 if (attr->sample_type & PERF_SAMPLE_CALLCHAIN) {
410 output[j].fields |= PERF_OUTPUT_IP;
411 output[j].fields |= PERF_OUTPUT_SYM;
412 output[j].fields |= PERF_OUTPUT_DSO;
413 set_print_ip_opts(attr);
423 static void print_sample_iregs(struct perf_sample *sample,
424 struct perf_event_attr *attr)
426 struct regs_dump *regs = &sample->intr_regs;
427 uint64_t mask = attr->sample_regs_intr;
433 for_each_set_bit(r, (unsigned long *) &mask, sizeof(mask) * 8) {
434 u64 val = regs->regs[i++];
435 printf("%5s:0x%"PRIx64" ", perf_reg_name(r), val);
439 static void print_sample_start(struct perf_sample *sample,
440 struct thread *thread,
441 struct perf_evsel *evsel)
443 struct perf_event_attr *attr = &evsel->attr;
445 unsigned long long nsecs;
447 if (PRINT_FIELD(COMM)) {
449 printf("%8.8s ", thread__comm_str(thread));
450 else if (PRINT_FIELD(IP) && symbol_conf.use_callchain)
451 printf("%s ", thread__comm_str(thread));
453 printf("%16s ", thread__comm_str(thread));
456 if (PRINT_FIELD(PID) && PRINT_FIELD(TID))
457 printf("%5d/%-5d ", sample->pid, sample->tid);
458 else if (PRINT_FIELD(PID))
459 printf("%5d ", sample->pid);
460 else if (PRINT_FIELD(TID))
461 printf("%5d ", sample->tid);
463 if (PRINT_FIELD(CPU)) {
465 printf("%3d ", sample->cpu);
467 printf("[%03d] ", sample->cpu);
470 if (PRINT_FIELD(TIME)) {
471 nsecs = sample->time;
472 secs = nsecs / NSEC_PER_SEC;
473 nsecs -= secs * NSEC_PER_SEC;
476 printf("%5lu.%09llu: ", secs, nsecs);
478 char sample_time[32];
479 timestamp__scnprintf_usec(sample->time, sample_time, sizeof(sample_time));
480 printf("%12s: ", sample_time);
486 mispred_str(struct branch_entry *br)
488 if (!(br->flags.mispred || br->flags.predicted))
491 return br->flags.predicted ? 'P' : 'M';
494 static void print_sample_brstack(struct perf_sample *sample)
496 struct branch_stack *br = sample->branch_stack;
502 for (i = 0; i < br->nr; i++) {
503 printf(" 0x%"PRIx64"/0x%"PRIx64"/%c/%c/%c/%d ",
506 mispred_str( br->entries + i),
507 br->entries[i].flags.in_tx? 'X' : '-',
508 br->entries[i].flags.abort? 'A' : '-',
509 br->entries[i].flags.cycles);
513 static void print_sample_brstacksym(struct perf_sample *sample,
514 struct thread *thread)
516 struct branch_stack *br = sample->branch_stack;
517 struct addr_location alf, alt;
523 for (i = 0; i < br->nr; i++) {
525 memset(&alf, 0, sizeof(alf));
526 memset(&alt, 0, sizeof(alt));
527 from = br->entries[i].from;
528 to = br->entries[i].to;
530 thread__find_addr_map(thread, sample->cpumode, MAP__FUNCTION, from, &alf);
532 alf.sym = map__find_symbol(alf.map, alf.addr);
534 thread__find_addr_map(thread, sample->cpumode, MAP__FUNCTION, to, &alt);
536 alt.sym = map__find_symbol(alt.map, alt.addr);
538 symbol__fprintf_symname_offs(alf.sym, &alf, stdout);
540 symbol__fprintf_symname_offs(alt.sym, &alt, stdout);
541 printf("/%c/%c/%c/%d ",
542 mispred_str( br->entries + i),
543 br->entries[i].flags.in_tx? 'X' : '-',
544 br->entries[i].flags.abort? 'A' : '-',
545 br->entries[i].flags.cycles);
550 static void print_sample_addr(struct perf_sample *sample,
551 struct thread *thread,
552 struct perf_event_attr *attr)
554 struct addr_location al;
556 printf("%16" PRIx64, sample->addr);
558 if (!sample_addr_correlates_sym(attr))
561 thread__resolve(thread, &al, sample);
563 if (PRINT_FIELD(SYM)) {
565 if (PRINT_FIELD(SYMOFFSET))
566 symbol__fprintf_symname_offs(al.sym, &al, stdout);
568 symbol__fprintf_symname(al.sym, stdout);
571 if (PRINT_FIELD(DSO)) {
573 map__fprintf_dsoname(al.map, stdout);
578 static void print_sample_callindent(struct perf_sample *sample,
579 struct perf_evsel *evsel,
580 struct thread *thread,
581 struct addr_location *al)
583 struct perf_event_attr *attr = &evsel->attr;
584 size_t depth = thread_stack__depth(thread);
585 struct addr_location addr_al;
586 const char *name = NULL;
592 * The 'return' has already been popped off the stack so the depth has
593 * to be adjusted to match the 'call'.
595 if (thread->ts && sample->flags & PERF_IP_FLAG_RETURN)
598 if (sample->flags & (PERF_IP_FLAG_CALL | PERF_IP_FLAG_TRACE_BEGIN)) {
599 if (sample_addr_correlates_sym(attr)) {
600 thread__resolve(thread, &addr_al, sample);
602 name = addr_al.sym->name;
608 } else if (sample->flags & (PERF_IP_FLAG_RETURN | PERF_IP_FLAG_TRACE_END)) {
610 name = al->sym->name;
616 len = printf("%*s%s", (int)depth * 4, "", name);
618 len = printf("%*s%16" PRIx64, (int)depth * 4, "", ip);
624 * Try to keep the output length from changing frequently so that the
625 * output lines up more nicely.
627 if (len > spacing || (len && len < spacing - 52))
628 spacing = round_up(len + 4, 32);
631 printf("%*s", spacing - len, "");
634 static void print_insn(struct perf_sample *sample,
635 struct perf_event_attr *attr)
637 if (PRINT_FIELD(INSNLEN))
638 printf(" ilen: %d", sample->insn_len);
639 if (PRINT_FIELD(INSN)) {
643 for (i = 0; i < sample->insn_len; i++)
644 printf(" %02x", (unsigned char)sample->insn[i]);
648 static void print_sample_bts(struct perf_sample *sample,
649 struct perf_evsel *evsel,
650 struct thread *thread,
651 struct addr_location *al)
653 struct perf_event_attr *attr = &evsel->attr;
654 bool print_srcline_last = false;
656 if (PRINT_FIELD(CALLINDENT))
657 print_sample_callindent(sample, evsel, thread, al);
659 /* print branch_from information */
660 if (PRINT_FIELD(IP)) {
661 unsigned int print_opts = output[attr->type].print_ip_opts;
662 struct callchain_cursor *cursor = NULL;
664 if (symbol_conf.use_callchain && sample->callchain &&
665 thread__resolve_callchain(al->thread, &callchain_cursor, evsel,
666 sample, NULL, NULL, scripting_max_stack) == 0)
667 cursor = &callchain_cursor;
669 if (cursor == NULL) {
671 if (print_opts & EVSEL__PRINT_SRCLINE) {
672 print_srcline_last = true;
673 print_opts &= ~EVSEL__PRINT_SRCLINE;
678 sample__fprintf_sym(sample, al, 0, print_opts, cursor, stdout);
681 /* print branch_to information */
682 if (PRINT_FIELD(ADDR) ||
683 ((evsel->attr.sample_type & PERF_SAMPLE_ADDR) &&
684 !output[attr->type].user_set)) {
686 print_sample_addr(sample, thread, attr);
689 if (print_srcline_last)
690 map__fprintf_srcline(al->map, al->addr, "\n ", stdout);
692 print_insn(sample, attr);
701 {PERF_IP_FLAG_BRANCH | PERF_IP_FLAG_CALL, "call"},
702 {PERF_IP_FLAG_BRANCH | PERF_IP_FLAG_RETURN, "return"},
703 {PERF_IP_FLAG_BRANCH | PERF_IP_FLAG_CONDITIONAL, "jcc"},
704 {PERF_IP_FLAG_BRANCH, "jmp"},
705 {PERF_IP_FLAG_BRANCH | PERF_IP_FLAG_CALL | PERF_IP_FLAG_INTERRUPT, "int"},
706 {PERF_IP_FLAG_BRANCH | PERF_IP_FLAG_RETURN | PERF_IP_FLAG_INTERRUPT, "iret"},
707 {PERF_IP_FLAG_BRANCH | PERF_IP_FLAG_CALL | PERF_IP_FLAG_SYSCALLRET, "syscall"},
708 {PERF_IP_FLAG_BRANCH | PERF_IP_FLAG_RETURN | PERF_IP_FLAG_SYSCALLRET, "sysret"},
709 {PERF_IP_FLAG_BRANCH | PERF_IP_FLAG_ASYNC, "async"},
710 {PERF_IP_FLAG_BRANCH | PERF_IP_FLAG_CALL | PERF_IP_FLAG_ASYNC | PERF_IP_FLAG_INTERRUPT, "hw int"},
711 {PERF_IP_FLAG_BRANCH | PERF_IP_FLAG_TX_ABORT, "tx abrt"},
712 {PERF_IP_FLAG_BRANCH | PERF_IP_FLAG_TRACE_BEGIN, "tr strt"},
713 {PERF_IP_FLAG_BRANCH | PERF_IP_FLAG_TRACE_END, "tr end"},
717 static void print_sample_flags(u32 flags)
719 const char *chars = PERF_IP_FLAG_CHARS;
720 const int n = strlen(PERF_IP_FLAG_CHARS);
721 bool in_tx = flags & PERF_IP_FLAG_IN_TX;
722 const char *name = NULL;
726 for (i = 0; sample_flags[i].name ; i++) {
727 if (sample_flags[i].flags == (flags & ~PERF_IP_FLAG_IN_TX)) {
728 name = sample_flags[i].name;
733 for (i = 0; i < n; i++, flags >>= 1) {
735 str[pos++] = chars[i];
737 for (; i < 32; i++, flags >>= 1) {
744 printf(" %-7s%4s ", name, in_tx ? "(x)" : "");
746 printf(" %-11s ", str);
749 struct printer_data {
756 print_sample_bpf_output_printer(enum binary_printer_ops op,
760 unsigned char ch = (unsigned char)val;
761 struct printer_data *printer_data = extra;
764 case BINARY_PRINT_DATA_BEGIN:
767 case BINARY_PRINT_LINE_BEGIN:
768 printf("%17s", !printer_data->line_no ? "BPF output:" :
771 case BINARY_PRINT_ADDR:
772 printf(" %04x:", val);
774 case BINARY_PRINT_NUM_DATA:
775 printf(" %02x", val);
777 case BINARY_PRINT_NUM_PAD:
780 case BINARY_PRINT_SEP:
783 case BINARY_PRINT_CHAR_DATA:
784 if (printer_data->hit_nul && ch)
785 printer_data->is_printable = false;
790 if (!printer_data->is_printable)
794 printer_data->hit_nul = true;
796 printer_data->is_printable = false;
801 case BINARY_PRINT_CHAR_PAD:
804 case BINARY_PRINT_LINE_END:
806 printer_data->line_no++;
808 case BINARY_PRINT_DATA_END:
814 static void print_sample_bpf_output(struct perf_sample *sample)
816 unsigned int nr_bytes = sample->raw_size;
817 struct printer_data printer_data = {0, false, true};
819 print_binary(sample->raw_data, nr_bytes, 8,
820 print_sample_bpf_output_printer, &printer_data);
822 if (printer_data.is_printable && printer_data.hit_nul)
823 printf("%17s \"%s\"\n", "BPF string:",
824 (char *)(sample->raw_data));
828 struct perf_tool tool;
829 struct perf_session *session;
830 bool show_task_events;
831 bool show_mmap_events;
832 bool show_switch_events;
834 struct cpu_map *cpus;
835 struct thread_map *threads;
837 const char *time_str;
838 struct perf_time_interval ptime;
841 static int perf_evlist__max_name_len(struct perf_evlist *evlist)
843 struct perf_evsel *evsel;
846 evlist__for_each_entry(evlist, evsel) {
847 int len = strlen(perf_evsel__name(evsel));
855 static size_t data_src__printf(u64 data_src)
857 struct mem_info mi = { .data_src.val = data_src };
863 perf_script__meminfo_scnprintf(decode, 100, &mi);
865 len = scnprintf(out, 100, "%16" PRIx64 " %s", data_src, decode);
869 return printf("%-*s", maxlen, out);
872 static void process_event(struct perf_script *script,
873 struct perf_sample *sample, struct perf_evsel *evsel,
874 struct addr_location *al)
876 struct thread *thread = al->thread;
877 struct perf_event_attr *attr = &evsel->attr;
879 if (output[attr->type].fields == 0)
882 print_sample_start(sample, thread, evsel);
884 if (PRINT_FIELD(PERIOD))
885 printf("%10" PRIu64 " ", sample->period);
887 if (PRINT_FIELD(EVNAME)) {
888 const char *evname = perf_evsel__name(evsel);
890 if (!script->name_width)
891 script->name_width = perf_evlist__max_name_len(script->session->evlist);
893 printf("%*s: ", script->name_width,
894 evname ? evname : "[unknown]");
898 print_sample_flags(sample->flags);
900 if (is_bts_event(attr)) {
901 print_sample_bts(sample, evsel, thread, al);
905 if (PRINT_FIELD(TRACE))
906 event_format__print(evsel->tp_format, sample->cpu,
907 sample->raw_data, sample->raw_size);
908 if (PRINT_FIELD(ADDR))
909 print_sample_addr(sample, thread, attr);
911 if (PRINT_FIELD(DATA_SRC))
912 data_src__printf(sample->data_src);
914 if (PRINT_FIELD(WEIGHT))
915 printf("%16" PRIu64, sample->weight);
917 if (PRINT_FIELD(IP)) {
918 struct callchain_cursor *cursor = NULL;
920 if (symbol_conf.use_callchain && sample->callchain &&
921 thread__resolve_callchain(al->thread, &callchain_cursor, evsel,
922 sample, NULL, NULL, scripting_max_stack) == 0)
923 cursor = &callchain_cursor;
925 putchar(cursor ? '\n' : ' ');
926 sample__fprintf_sym(sample, al, 0, output[attr->type].print_ip_opts, cursor, stdout);
929 if (PRINT_FIELD(IREGS))
930 print_sample_iregs(sample, attr);
932 if (PRINT_FIELD(BRSTACK))
933 print_sample_brstack(sample);
934 else if (PRINT_FIELD(BRSTACKSYM))
935 print_sample_brstacksym(sample, thread);
937 if (perf_evsel__is_bpf_output(evsel) && PRINT_FIELD(BPF_OUTPUT))
938 print_sample_bpf_output(sample);
939 print_insn(sample, attr);
943 static struct scripting_ops *scripting_ops;
945 static void __process_stat(struct perf_evsel *counter, u64 tstamp)
947 int nthreads = thread_map__nr(counter->threads);
948 int ncpus = perf_evsel__nr_cpus(counter);
950 static int header_printed;
952 if (counter->system_wide)
955 if (!header_printed) {
956 printf("%3s %8s %15s %15s %15s %15s %s\n",
957 "CPU", "THREAD", "VAL", "ENA", "RUN", "TIME", "EVENT");
961 for (thread = 0; thread < nthreads; thread++) {
962 for (cpu = 0; cpu < ncpus; cpu++) {
963 struct perf_counts_values *counts;
965 counts = perf_counts(counter->counts, cpu, thread);
967 printf("%3d %8d %15" PRIu64 " %15" PRIu64 " %15" PRIu64 " %15" PRIu64 " %s\n",
968 counter->cpus->map[cpu],
969 thread_map__pid(counter->threads, thread),
974 perf_evsel__name(counter));
979 static void process_stat(struct perf_evsel *counter, u64 tstamp)
981 if (scripting_ops && scripting_ops->process_stat)
982 scripting_ops->process_stat(&stat_config, counter, tstamp);
984 __process_stat(counter, tstamp);
987 static void process_stat_interval(u64 tstamp)
989 if (scripting_ops && scripting_ops->process_stat_interval)
990 scripting_ops->process_stat_interval(tstamp);
993 static void setup_scripting(void)
995 setup_perl_scripting();
996 setup_python_scripting();
999 static int flush_scripting(void)
1001 return scripting_ops ? scripting_ops->flush_script() : 0;
1004 static int cleanup_scripting(void)
1006 pr_debug("\nperf script stopped\n");
1008 return scripting_ops ? scripting_ops->stop_script() : 0;
1011 static int process_sample_event(struct perf_tool *tool,
1012 union perf_event *event,
1013 struct perf_sample *sample,
1014 struct perf_evsel *evsel,
1015 struct machine *machine)
1017 struct perf_script *scr = container_of(tool, struct perf_script, tool);
1018 struct addr_location al;
1020 if (perf_time__skip_sample(&scr->ptime, sample->time))
1024 if (sample->time < last_timestamp) {
1025 pr_err("Samples misordered, previous: %" PRIu64
1026 " this: %" PRIu64 "\n", last_timestamp,
1030 last_timestamp = sample->time;
1034 if (machine__resolve(machine, &al, sample) < 0) {
1035 pr_err("problem processing %d event, skipping it.\n",
1036 event->header.type);
1043 if (cpu_list && !test_bit(sample->cpu, cpu_bitmap))
1047 scripting_ops->process_event(event, sample, evsel, &al);
1049 process_event(scr, sample, evsel, &al);
1052 addr_location__put(&al);
1056 static int process_attr(struct perf_tool *tool, union perf_event *event,
1057 struct perf_evlist **pevlist)
1059 struct perf_script *scr = container_of(tool, struct perf_script, tool);
1060 struct perf_evlist *evlist;
1061 struct perf_evsel *evsel, *pos;
1064 err = perf_event__process_attr(tool, event, pevlist);
1069 evsel = perf_evlist__last(*pevlist);
1071 if (evsel->attr.type >= PERF_TYPE_MAX)
1074 evlist__for_each_entry(evlist, pos) {
1075 if (pos->attr.type == evsel->attr.type && pos != evsel)
1079 set_print_ip_opts(&evsel->attr);
1081 if (evsel->attr.sample_type)
1082 err = perf_evsel__check_attr(evsel, scr->session);
1087 static int process_comm_event(struct perf_tool *tool,
1088 union perf_event *event,
1089 struct perf_sample *sample,
1090 struct machine *machine)
1092 struct thread *thread;
1093 struct perf_script *script = container_of(tool, struct perf_script, tool);
1094 struct perf_session *session = script->session;
1095 struct perf_evsel *evsel = perf_evlist__id2evsel(session->evlist, sample->id);
1098 thread = machine__findnew_thread(machine, event->comm.pid, event->comm.tid);
1099 if (thread == NULL) {
1100 pr_debug("problem processing COMM event, skipping it.\n");
1104 if (perf_event__process_comm(tool, event, sample, machine) < 0)
1107 if (!evsel->attr.sample_id_all) {
1110 sample->tid = event->comm.tid;
1111 sample->pid = event->comm.pid;
1113 print_sample_start(sample, thread, evsel);
1114 perf_event__fprintf(event, stdout);
1117 thread__put(thread);
1121 static int process_fork_event(struct perf_tool *tool,
1122 union perf_event *event,
1123 struct perf_sample *sample,
1124 struct machine *machine)
1126 struct thread *thread;
1127 struct perf_script *script = container_of(tool, struct perf_script, tool);
1128 struct perf_session *session = script->session;
1129 struct perf_evsel *evsel = perf_evlist__id2evsel(session->evlist, sample->id);
1131 if (perf_event__process_fork(tool, event, sample, machine) < 0)
1134 thread = machine__findnew_thread(machine, event->fork.pid, event->fork.tid);
1135 if (thread == NULL) {
1136 pr_debug("problem processing FORK event, skipping it.\n");
1140 if (!evsel->attr.sample_id_all) {
1142 sample->time = event->fork.time;
1143 sample->tid = event->fork.tid;
1144 sample->pid = event->fork.pid;
1146 print_sample_start(sample, thread, evsel);
1147 perf_event__fprintf(event, stdout);
1148 thread__put(thread);
1152 static int process_exit_event(struct perf_tool *tool,
1153 union perf_event *event,
1154 struct perf_sample *sample,
1155 struct machine *machine)
1158 struct thread *thread;
1159 struct perf_script *script = container_of(tool, struct perf_script, tool);
1160 struct perf_session *session = script->session;
1161 struct perf_evsel *evsel = perf_evlist__id2evsel(session->evlist, sample->id);
1163 thread = machine__findnew_thread(machine, event->fork.pid, event->fork.tid);
1164 if (thread == NULL) {
1165 pr_debug("problem processing EXIT event, skipping it.\n");
1169 if (!evsel->attr.sample_id_all) {
1172 sample->tid = event->fork.tid;
1173 sample->pid = event->fork.pid;
1175 print_sample_start(sample, thread, evsel);
1176 perf_event__fprintf(event, stdout);
1178 if (perf_event__process_exit(tool, event, sample, machine) < 0)
1181 thread__put(thread);
1185 static int process_mmap_event(struct perf_tool *tool,
1186 union perf_event *event,
1187 struct perf_sample *sample,
1188 struct machine *machine)
1190 struct thread *thread;
1191 struct perf_script *script = container_of(tool, struct perf_script, tool);
1192 struct perf_session *session = script->session;
1193 struct perf_evsel *evsel = perf_evlist__id2evsel(session->evlist, sample->id);
1195 if (perf_event__process_mmap(tool, event, sample, machine) < 0)
1198 thread = machine__findnew_thread(machine, event->mmap.pid, event->mmap.tid);
1199 if (thread == NULL) {
1200 pr_debug("problem processing MMAP event, skipping it.\n");
1204 if (!evsel->attr.sample_id_all) {
1207 sample->tid = event->mmap.tid;
1208 sample->pid = event->mmap.pid;
1210 print_sample_start(sample, thread, evsel);
1211 perf_event__fprintf(event, stdout);
1212 thread__put(thread);
1216 static int process_mmap2_event(struct perf_tool *tool,
1217 union perf_event *event,
1218 struct perf_sample *sample,
1219 struct machine *machine)
1221 struct thread *thread;
1222 struct perf_script *script = container_of(tool, struct perf_script, tool);
1223 struct perf_session *session = script->session;
1224 struct perf_evsel *evsel = perf_evlist__id2evsel(session->evlist, sample->id);
1226 if (perf_event__process_mmap2(tool, event, sample, machine) < 0)
1229 thread = machine__findnew_thread(machine, event->mmap2.pid, event->mmap2.tid);
1230 if (thread == NULL) {
1231 pr_debug("problem processing MMAP2 event, skipping it.\n");
1235 if (!evsel->attr.sample_id_all) {
1238 sample->tid = event->mmap2.tid;
1239 sample->pid = event->mmap2.pid;
1241 print_sample_start(sample, thread, evsel);
1242 perf_event__fprintf(event, stdout);
1243 thread__put(thread);
1247 static int process_switch_event(struct perf_tool *tool,
1248 union perf_event *event,
1249 struct perf_sample *sample,
1250 struct machine *machine)
1252 struct thread *thread;
1253 struct perf_script *script = container_of(tool, struct perf_script, tool);
1254 struct perf_session *session = script->session;
1255 struct perf_evsel *evsel = perf_evlist__id2evsel(session->evlist, sample->id);
1257 if (perf_event__process_switch(tool, event, sample, machine) < 0)
1260 thread = machine__findnew_thread(machine, sample->pid,
1262 if (thread == NULL) {
1263 pr_debug("problem processing SWITCH event, skipping it.\n");
1267 print_sample_start(sample, thread, evsel);
1268 perf_event__fprintf(event, stdout);
1269 thread__put(thread);
1273 static void sig_handler(int sig __maybe_unused)
1278 static int __cmd_script(struct perf_script *script)
1282 signal(SIGINT, sig_handler);
1284 /* override event processing functions */
1285 if (script->show_task_events) {
1286 script->tool.comm = process_comm_event;
1287 script->tool.fork = process_fork_event;
1288 script->tool.exit = process_exit_event;
1290 if (script->show_mmap_events) {
1291 script->tool.mmap = process_mmap_event;
1292 script->tool.mmap2 = process_mmap2_event;
1294 if (script->show_switch_events)
1295 script->tool.context_switch = process_switch_event;
1297 ret = perf_session__process_events(script->session);
1300 pr_err("Misordered timestamps: %" PRIu64 "\n", nr_unordered);
1305 struct script_spec {
1306 struct list_head node;
1307 struct scripting_ops *ops;
1311 static LIST_HEAD(script_specs);
1313 static struct script_spec *script_spec__new(const char *spec,
1314 struct scripting_ops *ops)
1316 struct script_spec *s = malloc(sizeof(*s) + strlen(spec) + 1);
1319 strcpy(s->spec, spec);
1326 static void script_spec__add(struct script_spec *s)
1328 list_add_tail(&s->node, &script_specs);
1331 static struct script_spec *script_spec__find(const char *spec)
1333 struct script_spec *s;
1335 list_for_each_entry(s, &script_specs, node)
1336 if (strcasecmp(s->spec, spec) == 0)
1341 int script_spec_register(const char *spec, struct scripting_ops *ops)
1343 struct script_spec *s;
1345 s = script_spec__find(spec);
1349 s = script_spec__new(spec, ops);
1353 script_spec__add(s);
1358 static struct scripting_ops *script_spec__lookup(const char *spec)
1360 struct script_spec *s = script_spec__find(spec);
1367 static void list_available_languages(void)
1369 struct script_spec *s;
1371 fprintf(stderr, "\n");
1372 fprintf(stderr, "Scripting language extensions (used in "
1373 "perf script -s [spec:]script.[spec]):\n\n");
1375 list_for_each_entry(s, &script_specs, node)
1376 fprintf(stderr, " %-42s [%s]\n", s->spec, s->ops->name);
1378 fprintf(stderr, "\n");
1381 static int parse_scriptname(const struct option *opt __maybe_unused,
1382 const char *str, int unset __maybe_unused)
1384 char spec[PATH_MAX];
1385 const char *script, *ext;
1388 if (strcmp(str, "lang") == 0) {
1389 list_available_languages();
1393 script = strchr(str, ':');
1396 if (len >= PATH_MAX) {
1397 fprintf(stderr, "invalid language specifier");
1400 strncpy(spec, str, len);
1402 scripting_ops = script_spec__lookup(spec);
1403 if (!scripting_ops) {
1404 fprintf(stderr, "invalid language specifier");
1410 ext = strrchr(script, '.');
1412 fprintf(stderr, "invalid script extension");
1415 scripting_ops = script_spec__lookup(++ext);
1416 if (!scripting_ops) {
1417 fprintf(stderr, "invalid script extension");
1422 script_name = strdup(script);
1427 static int parse_output_fields(const struct option *opt __maybe_unused,
1428 const char *arg, int unset __maybe_unused)
1431 int i, imax = ARRAY_SIZE(all_output_options);
1434 char *str = strdup(arg);
1440 /* first word can state for which event type the user is specifying
1441 * the fields. If no type exists, the specified fields apply to all
1442 * event types found in the file minus the invalid fields for a type.
1444 tok = strchr(str, ':');
1448 if (!strcmp(str, "hw"))
1449 type = PERF_TYPE_HARDWARE;
1450 else if (!strcmp(str, "sw"))
1451 type = PERF_TYPE_SOFTWARE;
1452 else if (!strcmp(str, "trace"))
1453 type = PERF_TYPE_TRACEPOINT;
1454 else if (!strcmp(str, "raw"))
1455 type = PERF_TYPE_RAW;
1456 else if (!strcmp(str, "break"))
1457 type = PERF_TYPE_BREAKPOINT;
1459 fprintf(stderr, "Invalid event type in field string.\n");
1464 if (output[type].user_set)
1465 pr_warning("Overriding previous field request for %s events.\n",
1468 output[type].fields = 0;
1469 output[type].user_set = true;
1470 output[type].wildcard_set = false;
1474 if (strlen(str) == 0) {
1476 "Cannot set fields to 'none' for all event types.\n");
1481 if (output_set_by_user())
1482 pr_warning("Overriding previous field request for all events.\n");
1484 for (j = 0; j < PERF_TYPE_MAX; ++j) {
1485 output[j].fields = 0;
1486 output[j].user_set = true;
1487 output[j].wildcard_set = true;
1491 for (tok = strtok(tok, ","); tok; tok = strtok(NULL, ",")) {
1492 for (i = 0; i < imax; ++i) {
1493 if (strcmp(tok, all_output_options[i].str) == 0)
1496 if (i == imax && strcmp(tok, "flags") == 0) {
1501 fprintf(stderr, "Invalid field requested.\n");
1507 /* add user option to all events types for
1510 for (j = 0; j < PERF_TYPE_MAX; ++j) {
1511 if (output[j].invalid_fields & all_output_options[i].field) {
1512 pr_warning("\'%s\' not valid for %s events. Ignoring.\n",
1513 all_output_options[i].str, event_type(j));
1515 output[j].fields |= all_output_options[i].field;
1518 if (output[type].invalid_fields & all_output_options[i].field) {
1519 fprintf(stderr, "\'%s\' not valid for %s events.\n",
1520 all_output_options[i].str, event_type(type));
1525 output[type].fields |= all_output_options[i].field;
1530 if (output[type].fields == 0) {
1531 pr_debug("No fields requested for %s type. "
1532 "Events will not be displayed.\n", event_type(type));
1541 /* Helper function for filesystems that return a dent->d_type DT_UNKNOWN */
1542 static int is_directory(const char *base_path, const struct dirent *dent)
1544 char path[PATH_MAX];
1547 sprintf(path, "%s/%s", base_path, dent->d_name);
1548 if (stat(path, &st))
1551 return S_ISDIR(st.st_mode);
1554 #define for_each_lang(scripts_path, scripts_dir, lang_dirent) \
1555 while ((lang_dirent = readdir(scripts_dir)) != NULL) \
1556 if ((lang_dirent->d_type == DT_DIR || \
1557 (lang_dirent->d_type == DT_UNKNOWN && \
1558 is_directory(scripts_path, lang_dirent))) && \
1559 (strcmp(lang_dirent->d_name, ".")) && \
1560 (strcmp(lang_dirent->d_name, "..")))
1562 #define for_each_script(lang_path, lang_dir, script_dirent) \
1563 while ((script_dirent = readdir(lang_dir)) != NULL) \
1564 if (script_dirent->d_type != DT_DIR && \
1565 (script_dirent->d_type != DT_UNKNOWN || \
1566 !is_directory(lang_path, script_dirent)))
1569 #define RECORD_SUFFIX "-record"
1570 #define REPORT_SUFFIX "-report"
1572 struct script_desc {
1573 struct list_head node;
1579 static LIST_HEAD(script_descs);
1581 static struct script_desc *script_desc__new(const char *name)
1583 struct script_desc *s = zalloc(sizeof(*s));
1585 if (s != NULL && name)
1586 s->name = strdup(name);
1591 static void script_desc__delete(struct script_desc *s)
1594 zfree(&s->half_liner);
1599 static void script_desc__add(struct script_desc *s)
1601 list_add_tail(&s->node, &script_descs);
1604 static struct script_desc *script_desc__find(const char *name)
1606 struct script_desc *s;
1608 list_for_each_entry(s, &script_descs, node)
1609 if (strcasecmp(s->name, name) == 0)
1614 static struct script_desc *script_desc__findnew(const char *name)
1616 struct script_desc *s = script_desc__find(name);
1621 s = script_desc__new(name);
1623 goto out_delete_desc;
1625 script_desc__add(s);
1630 script_desc__delete(s);
1635 static const char *ends_with(const char *str, const char *suffix)
1637 size_t suffix_len = strlen(suffix);
1638 const char *p = str;
1640 if (strlen(str) > suffix_len) {
1641 p = str + strlen(str) - suffix_len;
1642 if (!strncmp(p, suffix, suffix_len))
1649 static int read_script_info(struct script_desc *desc, const char *filename)
1651 char line[BUFSIZ], *p;
1654 fp = fopen(filename, "r");
1658 while (fgets(line, sizeof(line), fp)) {
1665 if (strlen(p) && *p == '!')
1669 if (strlen(p) && p[strlen(p) - 1] == '\n')
1670 p[strlen(p) - 1] = '\0';
1672 if (!strncmp(p, "description:", strlen("description:"))) {
1673 p += strlen("description:");
1674 desc->half_liner = strdup(ltrim(p));
1678 if (!strncmp(p, "args:", strlen("args:"))) {
1679 p += strlen("args:");
1680 desc->args = strdup(ltrim(p));
1690 static char *get_script_root(struct dirent *script_dirent, const char *suffix)
1692 char *script_root, *str;
1694 script_root = strdup(script_dirent->d_name);
1698 str = (char *)ends_with(script_root, suffix);
1708 static int list_available_scripts(const struct option *opt __maybe_unused,
1709 const char *s __maybe_unused,
1710 int unset __maybe_unused)
1712 struct dirent *script_dirent, *lang_dirent;
1713 char scripts_path[MAXPATHLEN];
1714 DIR *scripts_dir, *lang_dir;
1715 char script_path[MAXPATHLEN];
1716 char lang_path[MAXPATHLEN];
1717 struct script_desc *desc;
1718 char first_half[BUFSIZ];
1721 snprintf(scripts_path, MAXPATHLEN, "%s/scripts", get_argv_exec_path());
1723 scripts_dir = opendir(scripts_path);
1726 "open(%s) failed.\n"
1727 "Check \"PERF_EXEC_PATH\" env to set scripts dir.\n",
1732 for_each_lang(scripts_path, scripts_dir, lang_dirent) {
1733 snprintf(lang_path, MAXPATHLEN, "%s/%s/bin", scripts_path,
1734 lang_dirent->d_name);
1735 lang_dir = opendir(lang_path);
1739 for_each_script(lang_path, lang_dir, script_dirent) {
1740 script_root = get_script_root(script_dirent, REPORT_SUFFIX);
1742 desc = script_desc__findnew(script_root);
1743 snprintf(script_path, MAXPATHLEN, "%s/%s",
1744 lang_path, script_dirent->d_name);
1745 read_script_info(desc, script_path);
1751 fprintf(stdout, "List of available trace scripts:\n");
1752 list_for_each_entry(desc, &script_descs, node) {
1753 sprintf(first_half, "%s %s", desc->name,
1754 desc->args ? desc->args : "");
1755 fprintf(stdout, " %-36s %s\n", first_half,
1756 desc->half_liner ? desc->half_liner : "");
1763 * Some scripts specify the required events in their "xxx-record" file,
1764 * this function will check if the events in perf.data match those
1765 * mentioned in the "xxx-record".
1767 * Fixme: All existing "xxx-record" are all in good formats "-e event ",
1768 * which is covered well now. And new parsing code should be added to
1769 * cover the future complexing formats like event groups etc.
1771 static int check_ev_match(char *dir_name, char *scriptname,
1772 struct perf_session *session)
1774 char filename[MAXPATHLEN], evname[128];
1775 char line[BUFSIZ], *p;
1776 struct perf_evsel *pos;
1780 sprintf(filename, "%s/bin/%s-record", dir_name, scriptname);
1782 fp = fopen(filename, "r");
1786 while (fgets(line, sizeof(line), fp)) {
1792 p = strstr(p, "-e");
1798 len = strcspn(p, " \t");
1802 snprintf(evname, len + 1, "%s", p);
1805 evlist__for_each_entry(session->evlist, pos) {
1806 if (!strcmp(perf_evsel__name(pos), evname)) {
1824 * Return -1 if none is found, otherwise the actual scripts number.
1826 * Currently the only user of this function is the script browser, which
1827 * will list all statically runnable scripts, select one, execute it and
1828 * show the output in a perf browser.
1830 int find_scripts(char **scripts_array, char **scripts_path_array)
1832 struct dirent *script_dirent, *lang_dirent;
1833 char scripts_path[MAXPATHLEN], lang_path[MAXPATHLEN];
1834 DIR *scripts_dir, *lang_dir;
1835 struct perf_session *session;
1836 struct perf_data_file file = {
1838 .mode = PERF_DATA_MODE_READ,
1843 session = perf_session__new(&file, false, NULL);
1847 snprintf(scripts_path, MAXPATHLEN, "%s/scripts", get_argv_exec_path());
1849 scripts_dir = opendir(scripts_path);
1851 perf_session__delete(session);
1855 for_each_lang(scripts_path, scripts_dir, lang_dirent) {
1856 snprintf(lang_path, MAXPATHLEN, "%s/%s", scripts_path,
1857 lang_dirent->d_name);
1859 if (strstr(lang_path, "perl"))
1863 if (strstr(lang_path, "python"))
1867 lang_dir = opendir(lang_path);
1871 for_each_script(lang_path, lang_dir, script_dirent) {
1872 /* Skip those real time scripts: xxxtop.p[yl] */
1873 if (strstr(script_dirent->d_name, "top."))
1875 sprintf(scripts_path_array[i], "%s/%s", lang_path,
1876 script_dirent->d_name);
1877 temp = strchr(script_dirent->d_name, '.');
1878 snprintf(scripts_array[i],
1879 (temp - script_dirent->d_name) + 1,
1880 "%s", script_dirent->d_name);
1882 if (check_ev_match(lang_path,
1883 scripts_array[i], session))
1891 closedir(scripts_dir);
1892 perf_session__delete(session);
1896 static char *get_script_path(const char *script_root, const char *suffix)
1898 struct dirent *script_dirent, *lang_dirent;
1899 char scripts_path[MAXPATHLEN];
1900 char script_path[MAXPATHLEN];
1901 DIR *scripts_dir, *lang_dir;
1902 char lang_path[MAXPATHLEN];
1903 char *__script_root;
1905 snprintf(scripts_path, MAXPATHLEN, "%s/scripts", get_argv_exec_path());
1907 scripts_dir = opendir(scripts_path);
1911 for_each_lang(scripts_path, scripts_dir, lang_dirent) {
1912 snprintf(lang_path, MAXPATHLEN, "%s/%s/bin", scripts_path,
1913 lang_dirent->d_name);
1914 lang_dir = opendir(lang_path);
1918 for_each_script(lang_path, lang_dir, script_dirent) {
1919 __script_root = get_script_root(script_dirent, suffix);
1920 if (__script_root && !strcmp(script_root, __script_root)) {
1921 free(__script_root);
1923 closedir(scripts_dir);
1924 snprintf(script_path, MAXPATHLEN, "%s/%s",
1925 lang_path, script_dirent->d_name);
1926 return strdup(script_path);
1928 free(__script_root);
1932 closedir(scripts_dir);
1937 static bool is_top_script(const char *script_path)
1939 return ends_with(script_path, "top") == NULL ? false : true;
1942 static int has_required_arg(char *script_path)
1944 struct script_desc *desc;
1948 desc = script_desc__new(NULL);
1950 if (read_script_info(desc, script_path))
1956 for (p = desc->args; *p; p++)
1960 script_desc__delete(desc);
1965 static int have_cmd(int argc, const char **argv)
1967 char **__argv = malloc(sizeof(const char *) * argc);
1970 pr_err("malloc failed\n");
1974 memcpy(__argv, argv, sizeof(const char *) * argc);
1975 argc = parse_options(argc, (const char **)__argv, record_options,
1976 NULL, PARSE_OPT_STOP_AT_NON_OPTION);
1979 system_wide = (argc == 0);
1984 static void script__setup_sample_type(struct perf_script *script)
1986 struct perf_session *session = script->session;
1987 u64 sample_type = perf_evlist__combined_sample_type(session->evlist);
1989 if (symbol_conf.use_callchain || symbol_conf.cumulate_callchain) {
1990 if ((sample_type & PERF_SAMPLE_REGS_USER) &&
1991 (sample_type & PERF_SAMPLE_STACK_USER))
1992 callchain_param.record_mode = CALLCHAIN_DWARF;
1993 else if (sample_type & PERF_SAMPLE_BRANCH_STACK)
1994 callchain_param.record_mode = CALLCHAIN_LBR;
1996 callchain_param.record_mode = CALLCHAIN_FP;
2000 static int process_stat_round_event(struct perf_tool *tool __maybe_unused,
2001 union perf_event *event,
2002 struct perf_session *session)
2004 struct stat_round_event *round = &event->stat_round;
2005 struct perf_evsel *counter;
2007 evlist__for_each_entry(session->evlist, counter) {
2008 perf_stat_process_counter(&stat_config, counter);
2009 process_stat(counter, round->time);
2012 process_stat_interval(round->time);
2016 static int process_stat_config_event(struct perf_tool *tool __maybe_unused,
2017 union perf_event *event,
2018 struct perf_session *session __maybe_unused)
2020 perf_event__read_stat_config(&stat_config, &event->stat_config);
2024 static int set_maps(struct perf_script *script)
2026 struct perf_evlist *evlist = script->session->evlist;
2028 if (!script->cpus || !script->threads)
2031 if (WARN_ONCE(script->allocated, "stats double allocation\n"))
2034 perf_evlist__set_maps(evlist, script->cpus, script->threads);
2036 if (perf_evlist__alloc_stats(evlist, true))
2039 script->allocated = true;
2044 int process_thread_map_event(struct perf_tool *tool,
2045 union perf_event *event,
2046 struct perf_session *session __maybe_unused)
2048 struct perf_script *script = container_of(tool, struct perf_script, tool);
2050 if (script->threads) {
2051 pr_warning("Extra thread map event, ignoring.\n");
2055 script->threads = thread_map__new_event(&event->thread_map);
2056 if (!script->threads)
2059 return set_maps(script);
2063 int process_cpu_map_event(struct perf_tool *tool __maybe_unused,
2064 union perf_event *event,
2065 struct perf_session *session __maybe_unused)
2067 struct perf_script *script = container_of(tool, struct perf_script, tool);
2070 pr_warning("Extra cpu map event, ignoring.\n");
2074 script->cpus = cpu_map__new_data(&event->cpu_map.data);
2078 return set_maps(script);
2081 int cmd_script(int argc, const char **argv, const char *prefix __maybe_unused)
2083 bool show_full_info = false;
2084 bool header = false;
2085 bool header_only = false;
2086 bool script_started = false;
2087 char *rec_script_path = NULL;
2088 char *rep_script_path = NULL;
2089 struct perf_session *session;
2090 struct itrace_synth_opts itrace_synth_opts = { .set = false, };
2091 char *script_path = NULL;
2092 const char **__argv;
2094 struct perf_script script = {
2096 .sample = process_sample_event,
2097 .mmap = perf_event__process_mmap,
2098 .mmap2 = perf_event__process_mmap2,
2099 .comm = perf_event__process_comm,
2100 .exit = perf_event__process_exit,
2101 .fork = perf_event__process_fork,
2102 .attr = process_attr,
2103 .event_update = perf_event__process_event_update,
2104 .tracing_data = perf_event__process_tracing_data,
2105 .build_id = perf_event__process_build_id,
2106 .id_index = perf_event__process_id_index,
2107 .auxtrace_info = perf_event__process_auxtrace_info,
2108 .auxtrace = perf_event__process_auxtrace,
2109 .auxtrace_error = perf_event__process_auxtrace_error,
2110 .stat = perf_event__process_stat_event,
2111 .stat_round = process_stat_round_event,
2112 .stat_config = process_stat_config_event,
2113 .thread_map = process_thread_map_event,
2114 .cpu_map = process_cpu_map_event,
2115 .ordered_events = true,
2116 .ordering_requires_timestamps = true,
2119 struct perf_data_file file = {
2120 .mode = PERF_DATA_MODE_READ,
2122 const struct option options[] = {
2123 OPT_BOOLEAN('D', "dump-raw-trace", &dump_trace,
2124 "dump raw trace in ASCII"),
2125 OPT_INCR('v', "verbose", &verbose,
2126 "be more verbose (show symbol address, etc)"),
2127 OPT_BOOLEAN('L', "Latency", &latency_format,
2128 "show latency attributes (irqs/preemption disabled, etc)"),
2129 OPT_CALLBACK_NOOPT('l', "list", NULL, NULL, "list available scripts",
2130 list_available_scripts),
2131 OPT_CALLBACK('s', "script", NULL, "name",
2132 "script file name (lang:script name, script name, or *)",
2134 OPT_STRING('g', "gen-script", &generate_script_lang, "lang",
2135 "generate perf-script.xx script in specified language"),
2136 OPT_STRING('i', "input", &input_name, "file", "input file name"),
2137 OPT_BOOLEAN('d', "debug-mode", &debug_mode,
2138 "do various checks like samples ordering and lost events"),
2139 OPT_BOOLEAN(0, "header", &header, "Show data header."),
2140 OPT_BOOLEAN(0, "header-only", &header_only, "Show only data header."),
2141 OPT_STRING('k', "vmlinux", &symbol_conf.vmlinux_name,
2142 "file", "vmlinux pathname"),
2143 OPT_STRING(0, "kallsyms", &symbol_conf.kallsyms_name,
2144 "file", "kallsyms pathname"),
2145 OPT_BOOLEAN('G', "hide-call-graph", &no_callchain,
2146 "When printing symbols do not display call chain"),
2147 OPT_CALLBACK(0, "symfs", NULL, "directory",
2148 "Look for files with symbols relative to this directory",
2149 symbol__config_symfs),
2150 OPT_CALLBACK('F', "fields", NULL, "str",
2151 "comma separated output fields prepend with 'type:'. "
2152 "Valid types: hw,sw,trace,raw. "
2153 "Fields: comm,tid,pid,time,cpu,event,trace,ip,sym,dso,"
2154 "addr,symoff,period,iregs,brstack,brstacksym,flags,"
2155 "bpf-output,callindent,insn,insnlen", parse_output_fields),
2156 OPT_BOOLEAN('a', "all-cpus", &system_wide,
2157 "system-wide collection from all CPUs"),
2158 OPT_STRING('S', "symbols", &symbol_conf.sym_list_str, "symbol[,symbol...]",
2159 "only consider these symbols"),
2160 OPT_STRING(0, "stop-bt", &symbol_conf.bt_stop_list_str, "symbol[,symbol...]",
2161 "Stop display of callgraph at these symbols"),
2162 OPT_STRING('C', "cpu", &cpu_list, "cpu", "list of cpus to profile"),
2163 OPT_STRING('c', "comms", &symbol_conf.comm_list_str, "comm[,comm...]",
2164 "only display events for these comms"),
2165 OPT_STRING(0, "pid", &symbol_conf.pid_list_str, "pid[,pid...]",
2166 "only consider symbols in these pids"),
2167 OPT_STRING(0, "tid", &symbol_conf.tid_list_str, "tid[,tid...]",
2168 "only consider symbols in these tids"),
2169 OPT_UINTEGER(0, "max-stack", &scripting_max_stack,
2170 "Set the maximum stack depth when parsing the callchain, "
2171 "anything beyond the specified depth will be ignored. "
2172 "Default: kernel.perf_event_max_stack or " __stringify(PERF_MAX_STACK_DEPTH)),
2173 OPT_BOOLEAN('I', "show-info", &show_full_info,
2174 "display extended information from perf.data file"),
2175 OPT_BOOLEAN('\0', "show-kernel-path", &symbol_conf.show_kernel_path,
2176 "Show the path of [kernel.kallsyms]"),
2177 OPT_BOOLEAN('\0', "show-task-events", &script.show_task_events,
2178 "Show the fork/comm/exit events"),
2179 OPT_BOOLEAN('\0', "show-mmap-events", &script.show_mmap_events,
2180 "Show the mmap events"),
2181 OPT_BOOLEAN('\0', "show-switch-events", &script.show_switch_events,
2182 "Show context switch events (if recorded)"),
2183 OPT_BOOLEAN('f', "force", &symbol_conf.force, "don't complain, do it"),
2184 OPT_BOOLEAN(0, "ns", &nanosecs,
2185 "Use 9 decimal places when displaying time"),
2186 OPT_CALLBACK_OPTARG(0, "itrace", &itrace_synth_opts, NULL, "opts",
2187 "Instruction Tracing options",
2188 itrace_parse_synth_opts),
2189 OPT_BOOLEAN(0, "full-source-path", &srcline_full_filename,
2190 "Show full source file name path for source lines"),
2191 OPT_BOOLEAN(0, "demangle", &symbol_conf.demangle,
2192 "Enable symbol demangling"),
2193 OPT_BOOLEAN(0, "demangle-kernel", &symbol_conf.demangle_kernel,
2194 "Enable kernel symbol demangling"),
2195 OPT_STRING(0, "time", &script.time_str, "str",
2196 "Time span of interest (start,stop)"),
2199 const char * const script_subcommands[] = { "record", "report", NULL };
2200 const char *script_usage[] = {
2201 "perf script [<options>]",
2202 "perf script [<options>] record <script> [<record-options>] <command>",
2203 "perf script [<options>] report <script> [script-args]",
2204 "perf script [<options>] <script> [<record-options>] <command>",
2205 "perf script [<options>] <top-script> [script-args]",
2211 argc = parse_options_subcommand(argc, argv, options, script_subcommands, script_usage,
2212 PARSE_OPT_STOP_AT_NON_OPTION);
2214 file.path = input_name;
2215 file.force = symbol_conf.force;
2217 if (argc > 1 && !strncmp(argv[0], "rec", strlen("rec"))) {
2218 rec_script_path = get_script_path(argv[1], RECORD_SUFFIX);
2219 if (!rec_script_path)
2220 return cmd_record(argc, argv, NULL);
2223 if (argc > 1 && !strncmp(argv[0], "rep", strlen("rep"))) {
2224 rep_script_path = get_script_path(argv[1], REPORT_SUFFIX);
2225 if (!rep_script_path) {
2227 "Please specify a valid report script"
2228 "(see 'perf script -l' for listing)\n");
2233 if (itrace_synth_opts.callchain &&
2234 itrace_synth_opts.callchain_sz > scripting_max_stack)
2235 scripting_max_stack = itrace_synth_opts.callchain_sz;
2237 /* make sure PERF_EXEC_PATH is set for scripts */
2238 set_argv_exec_path(get_argv_exec_path());
2240 if (argc && !script_name && !rec_script_path && !rep_script_path) {
2245 rec_script_path = get_script_path(argv[0], RECORD_SUFFIX);
2246 rep_script_path = get_script_path(argv[0], REPORT_SUFFIX);
2248 if (!rec_script_path && !rep_script_path) {
2249 usage_with_options_msg(script_usage, options,
2250 "Couldn't find script `%s'\n\n See perf"
2251 " script -l for available scripts.\n", argv[0]);
2254 if (is_top_script(argv[0])) {
2255 rep_args = argc - 1;
2259 rep_args = has_required_arg(rep_script_path);
2260 rec_args = (argc - 1) - rep_args;
2262 usage_with_options_msg(script_usage, options,
2263 "`%s' script requires options."
2264 "\n\n See perf script -l for available "
2265 "scripts and options.\n", argv[0]);
2269 if (pipe(live_pipe) < 0) {
2270 perror("failed to create pipe");
2276 perror("failed to fork");
2283 dup2(live_pipe[1], 1);
2284 close(live_pipe[0]);
2286 if (is_top_script(argv[0])) {
2288 } else if (!system_wide) {
2289 if (have_cmd(argc - rep_args, &argv[rep_args]) != 0) {
2295 __argv = malloc((argc + 6) * sizeof(const char *));
2297 pr_err("malloc failed\n");
2302 __argv[j++] = "/bin/sh";
2303 __argv[j++] = rec_script_path;
2309 for (i = rep_args + 1; i < argc; i++)
2310 __argv[j++] = argv[i];
2313 execvp("/bin/sh", (char **)__argv);
2318 dup2(live_pipe[0], 0);
2319 close(live_pipe[1]);
2321 __argv = malloc((argc + 4) * sizeof(const char *));
2323 pr_err("malloc failed\n");
2329 __argv[j++] = "/bin/sh";
2330 __argv[j++] = rep_script_path;
2331 for (i = 1; i < rep_args + 1; i++)
2332 __argv[j++] = argv[i];
2337 execvp("/bin/sh", (char **)__argv);
2342 if (rec_script_path)
2343 script_path = rec_script_path;
2344 if (rep_script_path)
2345 script_path = rep_script_path;
2350 if (!rec_script_path)
2351 system_wide = false;
2352 else if (!system_wide) {
2353 if (have_cmd(argc - 1, &argv[1]) != 0) {
2359 __argv = malloc((argc + 2) * sizeof(const char *));
2361 pr_err("malloc failed\n");
2366 __argv[j++] = "/bin/sh";
2367 __argv[j++] = script_path;
2370 for (i = 2; i < argc; i++)
2371 __argv[j++] = argv[i];
2374 execvp("/bin/sh", (char **)__argv);
2382 session = perf_session__new(&file, false, &script.tool);
2383 if (session == NULL)
2386 if (header || header_only) {
2387 perf_session__fprintf_info(session, stdout, show_full_info);
2392 if (symbol__init(&session->header.env) < 0)
2395 script.session = session;
2396 script__setup_sample_type(&script);
2398 if (output[PERF_TYPE_HARDWARE].fields & PERF_OUTPUT_CALLINDENT)
2399 itrace_synth_opts.thread_stack = true;
2401 session->itrace_synth_opts = &itrace_synth_opts;
2404 err = perf_session__cpu_bitmap(session, cpu_list, cpu_bitmap);
2410 symbol_conf.use_callchain = true;
2412 symbol_conf.use_callchain = false;
2414 if (session->tevent.pevent &&
2415 pevent_set_function_resolver(session->tevent.pevent,
2416 machine__resolve_kernel_addr,
2417 &session->machines.host) < 0) {
2418 pr_err("%s: failed to set libtraceevent function resolver\n", __func__);
2422 if (generate_script_lang) {
2423 struct stat perf_stat;
2426 if (output_set_by_user()) {
2428 "custom fields not supported for generated scripts");
2433 input = open(file.path, O_RDONLY); /* input_name */
2436 perror("failed to open file");
2440 err = fstat(input, &perf_stat);
2442 perror("failed to stat file");
2446 if (!perf_stat.st_size) {
2447 fprintf(stderr, "zero-sized file, nothing to do!\n");
2451 scripting_ops = script_spec__lookup(generate_script_lang);
2452 if (!scripting_ops) {
2453 fprintf(stderr, "invalid language specifier");
2458 err = scripting_ops->generate_script(session->tevent.pevent,
2464 err = scripting_ops->start_script(script_name, argc, argv);
2467 pr_debug("perf script started with script %s\n\n", script_name);
2468 script_started = true;
2472 err = perf_session__check_output_opt(session);
2476 /* needs to be parsed after looking up reference time */
2477 if (perf_time__parse_str(&script.ptime, script.time_str) != 0) {
2478 pr_err("Invalid time string\n");
2482 err = __cmd_script(&script);
2487 perf_evlist__free_stats(session->evlist);
2488 perf_session__delete(session);
2491 cleanup_scripting();