xref: /openbmc/linux/tools/perf/builtin-trace.c (revision 1fa6ac37)
1 #include "builtin.h"
2 
3 #include "util/util.h"
4 #include "util/cache.h"
5 #include "util/symbol.h"
6 #include "util/thread.h"
7 #include "util/header.h"
8 #include "util/exec_cmd.h"
9 #include "util/trace-event.h"
10 #include "util/session.h"
11 
12 static char const		*script_name;
13 static char const		*generate_script_lang;
14 static bool			debug_ordering;
15 static u64			last_timestamp;
16 
17 static int default_start_script(const char *script __unused,
18 				int argc __unused,
19 				const char **argv __unused)
20 {
21 	return 0;
22 }
23 
24 static int default_stop_script(void)
25 {
26 	return 0;
27 }
28 
29 static int default_generate_script(const char *outfile __unused)
30 {
31 	return 0;
32 }
33 
34 static struct scripting_ops default_scripting_ops = {
35 	.start_script		= default_start_script,
36 	.stop_script		= default_stop_script,
37 	.process_event		= print_event,
38 	.generate_script	= default_generate_script,
39 };
40 
41 static struct scripting_ops	*scripting_ops;
42 
43 static void setup_scripting(void)
44 {
45 	/* make sure PERF_EXEC_PATH is set for scripts */
46 	perf_set_argv_exec_path(perf_exec_path());
47 
48 	setup_perl_scripting();
49 	setup_python_scripting();
50 
51 	scripting_ops = &default_scripting_ops;
52 }
53 
54 static int cleanup_scripting(void)
55 {
56 	pr_debug("\nperf trace script stopped\n");
57 
58 	return scripting_ops->stop_script();
59 }
60 
61 #include "util/parse-options.h"
62 
63 #include "perf.h"
64 #include "util/debug.h"
65 
66 #include "util/trace-event.h"
67 #include "util/exec_cmd.h"
68 
69 static char const		*input_name = "perf.data";
70 
71 static int process_sample_event(event_t *event, struct perf_session *session)
72 {
73 	struct sample_data data;
74 	struct thread *thread;
75 
76 	memset(&data, 0, sizeof(data));
77 	data.time = -1;
78 	data.cpu = -1;
79 	data.period = 1;
80 
81 	event__parse_sample(event, session->sample_type, &data);
82 
83 	dump_printf("(IP, %d): %d/%d: %#Lx period: %Ld\n", event->header.misc,
84 		    data.pid, data.tid, data.ip, data.period);
85 
86 	thread = perf_session__findnew(session, event->ip.pid);
87 	if (thread == NULL) {
88 		pr_debug("problem processing %d event, skipping it.\n",
89 			 event->header.type);
90 		return -1;
91 	}
92 
93 	if (session->sample_type & PERF_SAMPLE_RAW) {
94 		if (debug_ordering) {
95 			if (data.time < last_timestamp) {
96 				pr_err("Samples misordered, previous: %llu "
97 					"this: %llu\n", last_timestamp,
98 					data.time);
99 			}
100 			last_timestamp = data.time;
101 		}
102 		/*
103 		 * FIXME: better resolve from pid from the struct trace_entry
104 		 * field, although it should be the same than this perf
105 		 * event pid
106 		 */
107 		scripting_ops->process_event(data.cpu, data.raw_data,
108 					     data.raw_size,
109 					     data.time, thread->comm);
110 	}
111 
112 	session->hists.stats.total_period += data.period;
113 	return 0;
114 }
115 
116 static struct perf_event_ops event_ops = {
117 	.sample	= process_sample_event,
118 	.comm	= event__process_comm,
119 	.attr	= event__process_attr,
120 	.event_type = event__process_event_type,
121 	.tracing_data = event__process_tracing_data,
122 	.build_id = event__process_build_id,
123 	.ordered_samples = true,
124 };
125 
126 extern volatile int session_done;
127 
128 static void sig_handler(int sig __unused)
129 {
130 	session_done = 1;
131 }
132 
133 static int __cmd_trace(struct perf_session *session)
134 {
135 	signal(SIGINT, sig_handler);
136 
137 	return perf_session__process_events(session, &event_ops);
138 }
139 
140 struct script_spec {
141 	struct list_head	node;
142 	struct scripting_ops	*ops;
143 	char			spec[0];
144 };
145 
146 LIST_HEAD(script_specs);
147 
148 static struct script_spec *script_spec__new(const char *spec,
149 					    struct scripting_ops *ops)
150 {
151 	struct script_spec *s = malloc(sizeof(*s) + strlen(spec) + 1);
152 
153 	if (s != NULL) {
154 		strcpy(s->spec, spec);
155 		s->ops = ops;
156 	}
157 
158 	return s;
159 }
160 
161 static void script_spec__delete(struct script_spec *s)
162 {
163 	free(s->spec);
164 	free(s);
165 }
166 
167 static void script_spec__add(struct script_spec *s)
168 {
169 	list_add_tail(&s->node, &script_specs);
170 }
171 
172 static struct script_spec *script_spec__find(const char *spec)
173 {
174 	struct script_spec *s;
175 
176 	list_for_each_entry(s, &script_specs, node)
177 		if (strcasecmp(s->spec, spec) == 0)
178 			return s;
179 	return NULL;
180 }
181 
182 static struct script_spec *script_spec__findnew(const char *spec,
183 						struct scripting_ops *ops)
184 {
185 	struct script_spec *s = script_spec__find(spec);
186 
187 	if (s)
188 		return s;
189 
190 	s = script_spec__new(spec, ops);
191 	if (!s)
192 		goto out_delete_spec;
193 
194 	script_spec__add(s);
195 
196 	return s;
197 
198 out_delete_spec:
199 	script_spec__delete(s);
200 
201 	return NULL;
202 }
203 
204 int script_spec_register(const char *spec, struct scripting_ops *ops)
205 {
206 	struct script_spec *s;
207 
208 	s = script_spec__find(spec);
209 	if (s)
210 		return -1;
211 
212 	s = script_spec__findnew(spec, ops);
213 	if (!s)
214 		return -1;
215 
216 	return 0;
217 }
218 
219 static struct scripting_ops *script_spec__lookup(const char *spec)
220 {
221 	struct script_spec *s = script_spec__find(spec);
222 	if (!s)
223 		return NULL;
224 
225 	return s->ops;
226 }
227 
228 static void list_available_languages(void)
229 {
230 	struct script_spec *s;
231 
232 	fprintf(stderr, "\n");
233 	fprintf(stderr, "Scripting language extensions (used in "
234 		"perf trace -s [spec:]script.[spec]):\n\n");
235 
236 	list_for_each_entry(s, &script_specs, node)
237 		fprintf(stderr, "  %-42s [%s]\n", s->spec, s->ops->name);
238 
239 	fprintf(stderr, "\n");
240 }
241 
242 static int parse_scriptname(const struct option *opt __used,
243 			    const char *str, int unset __used)
244 {
245 	char spec[PATH_MAX];
246 	const char *script, *ext;
247 	int len;
248 
249 	if (strcmp(str, "lang") == 0) {
250 		list_available_languages();
251 		exit(0);
252 	}
253 
254 	script = strchr(str, ':');
255 	if (script) {
256 		len = script - str;
257 		if (len >= PATH_MAX) {
258 			fprintf(stderr, "invalid language specifier");
259 			return -1;
260 		}
261 		strncpy(spec, str, len);
262 		spec[len] = '\0';
263 		scripting_ops = script_spec__lookup(spec);
264 		if (!scripting_ops) {
265 			fprintf(stderr, "invalid language specifier");
266 			return -1;
267 		}
268 		script++;
269 	} else {
270 		script = str;
271 		ext = strchr(script, '.');
272 		if (!ext) {
273 			fprintf(stderr, "invalid script extension");
274 			return -1;
275 		}
276 		scripting_ops = script_spec__lookup(++ext);
277 		if (!scripting_ops) {
278 			fprintf(stderr, "invalid script extension");
279 			return -1;
280 		}
281 	}
282 
283 	script_name = strdup(script);
284 
285 	return 0;
286 }
287 
288 #define for_each_lang(scripts_dir, lang_dirent, lang_next)		\
289 	while (!readdir_r(scripts_dir, &lang_dirent, &lang_next) &&	\
290 	       lang_next)						\
291 		if (lang_dirent.d_type == DT_DIR &&			\
292 		    (strcmp(lang_dirent.d_name, ".")) &&		\
293 		    (strcmp(lang_dirent.d_name, "..")))
294 
295 #define for_each_script(lang_dir, script_dirent, script_next)		\
296 	while (!readdir_r(lang_dir, &script_dirent, &script_next) &&	\
297 	       script_next)						\
298 		if (script_dirent.d_type != DT_DIR)
299 
300 
301 #define RECORD_SUFFIX			"-record"
302 #define REPORT_SUFFIX			"-report"
303 
304 struct script_desc {
305 	struct list_head	node;
306 	char			*name;
307 	char			*half_liner;
308 	char			*args;
309 };
310 
311 LIST_HEAD(script_descs);
312 
313 static struct script_desc *script_desc__new(const char *name)
314 {
315 	struct script_desc *s = zalloc(sizeof(*s));
316 
317 	if (s != NULL)
318 		s->name = strdup(name);
319 
320 	return s;
321 }
322 
323 static void script_desc__delete(struct script_desc *s)
324 {
325 	free(s->name);
326 	free(s);
327 }
328 
329 static void script_desc__add(struct script_desc *s)
330 {
331 	list_add_tail(&s->node, &script_descs);
332 }
333 
334 static struct script_desc *script_desc__find(const char *name)
335 {
336 	struct script_desc *s;
337 
338 	list_for_each_entry(s, &script_descs, node)
339 		if (strcasecmp(s->name, name) == 0)
340 			return s;
341 	return NULL;
342 }
343 
344 static struct script_desc *script_desc__findnew(const char *name)
345 {
346 	struct script_desc *s = script_desc__find(name);
347 
348 	if (s)
349 		return s;
350 
351 	s = script_desc__new(name);
352 	if (!s)
353 		goto out_delete_desc;
354 
355 	script_desc__add(s);
356 
357 	return s;
358 
359 out_delete_desc:
360 	script_desc__delete(s);
361 
362 	return NULL;
363 }
364 
365 static char *ends_with(char *str, const char *suffix)
366 {
367 	size_t suffix_len = strlen(suffix);
368 	char *p = str;
369 
370 	if (strlen(str) > suffix_len) {
371 		p = str + strlen(str) - suffix_len;
372 		if (!strncmp(p, suffix, suffix_len))
373 			return p;
374 	}
375 
376 	return NULL;
377 }
378 
379 static char *ltrim(char *str)
380 {
381 	int len = strlen(str);
382 
383 	while (len && isspace(*str)) {
384 		len--;
385 		str++;
386 	}
387 
388 	return str;
389 }
390 
391 static int read_script_info(struct script_desc *desc, const char *filename)
392 {
393 	char line[BUFSIZ], *p;
394 	FILE *fp;
395 
396 	fp = fopen(filename, "r");
397 	if (!fp)
398 		return -1;
399 
400 	while (fgets(line, sizeof(line), fp)) {
401 		p = ltrim(line);
402 		if (strlen(p) == 0)
403 			continue;
404 		if (*p != '#')
405 			continue;
406 		p++;
407 		if (strlen(p) && *p == '!')
408 			continue;
409 
410 		p = ltrim(p);
411 		if (strlen(p) && p[strlen(p) - 1] == '\n')
412 			p[strlen(p) - 1] = '\0';
413 
414 		if (!strncmp(p, "description:", strlen("description:"))) {
415 			p += strlen("description:");
416 			desc->half_liner = strdup(ltrim(p));
417 			continue;
418 		}
419 
420 		if (!strncmp(p, "args:", strlen("args:"))) {
421 			p += strlen("args:");
422 			desc->args = strdup(ltrim(p));
423 			continue;
424 		}
425 	}
426 
427 	fclose(fp);
428 
429 	return 0;
430 }
431 
432 static int list_available_scripts(const struct option *opt __used,
433 				  const char *s __used, int unset __used)
434 {
435 	struct dirent *script_next, *lang_next, script_dirent, lang_dirent;
436 	char scripts_path[MAXPATHLEN];
437 	DIR *scripts_dir, *lang_dir;
438 	char script_path[MAXPATHLEN];
439 	char lang_path[MAXPATHLEN];
440 	struct script_desc *desc;
441 	char first_half[BUFSIZ];
442 	char *script_root;
443 	char *str;
444 
445 	snprintf(scripts_path, MAXPATHLEN, "%s/scripts", perf_exec_path());
446 
447 	scripts_dir = opendir(scripts_path);
448 	if (!scripts_dir)
449 		return -1;
450 
451 	for_each_lang(scripts_dir, lang_dirent, lang_next) {
452 		snprintf(lang_path, MAXPATHLEN, "%s/%s/bin", scripts_path,
453 			 lang_dirent.d_name);
454 		lang_dir = opendir(lang_path);
455 		if (!lang_dir)
456 			continue;
457 
458 		for_each_script(lang_dir, script_dirent, script_next) {
459 			script_root = strdup(script_dirent.d_name);
460 			str = ends_with(script_root, REPORT_SUFFIX);
461 			if (str) {
462 				*str = '\0';
463 				desc = script_desc__findnew(script_root);
464 				snprintf(script_path, MAXPATHLEN, "%s/%s",
465 					 lang_path, script_dirent.d_name);
466 				read_script_info(desc, script_path);
467 			}
468 			free(script_root);
469 		}
470 	}
471 
472 	fprintf(stdout, "List of available trace scripts:\n");
473 	list_for_each_entry(desc, &script_descs, node) {
474 		sprintf(first_half, "%s %s", desc->name,
475 			desc->args ? desc->args : "");
476 		fprintf(stdout, "  %-36s %s\n", first_half,
477 			desc->half_liner ? desc->half_liner : "");
478 	}
479 
480 	exit(0);
481 }
482 
483 static char *get_script_path(const char *script_root, const char *suffix)
484 {
485 	struct dirent *script_next, *lang_next, script_dirent, lang_dirent;
486 	char scripts_path[MAXPATHLEN];
487 	char script_path[MAXPATHLEN];
488 	DIR *scripts_dir, *lang_dir;
489 	char lang_path[MAXPATHLEN];
490 	char *str, *__script_root;
491 	char *path = NULL;
492 
493 	snprintf(scripts_path, MAXPATHLEN, "%s/scripts", perf_exec_path());
494 
495 	scripts_dir = opendir(scripts_path);
496 	if (!scripts_dir)
497 		return NULL;
498 
499 	for_each_lang(scripts_dir, lang_dirent, lang_next) {
500 		snprintf(lang_path, MAXPATHLEN, "%s/%s/bin", scripts_path,
501 			 lang_dirent.d_name);
502 		lang_dir = opendir(lang_path);
503 		if (!lang_dir)
504 			continue;
505 
506 		for_each_script(lang_dir, script_dirent, script_next) {
507 			__script_root = strdup(script_dirent.d_name);
508 			str = ends_with(__script_root, suffix);
509 			if (str) {
510 				*str = '\0';
511 				if (strcmp(__script_root, script_root))
512 					continue;
513 				snprintf(script_path, MAXPATHLEN, "%s/%s",
514 					 lang_path, script_dirent.d_name);
515 				path = strdup(script_path);
516 				free(__script_root);
517 				break;
518 			}
519 			free(__script_root);
520 		}
521 	}
522 
523 	return path;
524 }
525 
526 static const char * const trace_usage[] = {
527 	"perf trace [<options>] <command>",
528 	NULL
529 };
530 
531 static const struct option options[] = {
532 	OPT_BOOLEAN('D', "dump-raw-trace", &dump_trace,
533 		    "dump raw trace in ASCII"),
534 	OPT_INCR('v', "verbose", &verbose,
535 		    "be more verbose (show symbol address, etc)"),
536 	OPT_BOOLEAN('L', "Latency", &latency_format,
537 		    "show latency attributes (irqs/preemption disabled, etc)"),
538 	OPT_CALLBACK_NOOPT('l', "list", NULL, NULL, "list available scripts",
539 			   list_available_scripts),
540 	OPT_CALLBACK('s', "script", NULL, "name",
541 		     "script file name (lang:script name, script name, or *)",
542 		     parse_scriptname),
543 	OPT_STRING('g', "gen-script", &generate_script_lang, "lang",
544 		   "generate perf-trace.xx script in specified language"),
545 	OPT_STRING('i', "input", &input_name, "file",
546 		    "input file name"),
547 	OPT_BOOLEAN('d', "debug-ordering", &debug_ordering,
548 		   "check that samples time ordering is monotonic"),
549 
550 	OPT_END()
551 };
552 
553 int cmd_trace(int argc, const char **argv, const char *prefix __used)
554 {
555 	struct perf_session *session;
556 	const char *suffix = NULL;
557 	const char **__argv;
558 	char *script_path;
559 	int i, err;
560 
561 	if (argc >= 2 && strncmp(argv[1], "rec", strlen("rec")) == 0) {
562 		if (argc < 3) {
563 			fprintf(stderr,
564 				"Please specify a record script\n");
565 			return -1;
566 		}
567 		suffix = RECORD_SUFFIX;
568 	}
569 
570 	if (argc >= 2 && strncmp(argv[1], "rep", strlen("rep")) == 0) {
571 		if (argc < 3) {
572 			fprintf(stderr,
573 				"Please specify a report script\n");
574 			return -1;
575 		}
576 		suffix = REPORT_SUFFIX;
577 	}
578 
579 	if (!suffix && argc >= 2 && strncmp(argv[1], "-", strlen("-")) != 0) {
580 		char *record_script_path, *report_script_path;
581 		int live_pipe[2];
582 		pid_t pid;
583 
584 		record_script_path = get_script_path(argv[1], RECORD_SUFFIX);
585 		if (!record_script_path) {
586 			fprintf(stderr, "record script not found\n");
587 			return -1;
588 		}
589 
590 		report_script_path = get_script_path(argv[1], REPORT_SUFFIX);
591 		if (!report_script_path) {
592 			fprintf(stderr, "report script not found\n");
593 			return -1;
594 		}
595 
596 		if (pipe(live_pipe) < 0) {
597 			perror("failed to create pipe");
598 			exit(-1);
599 		}
600 
601 		pid = fork();
602 		if (pid < 0) {
603 			perror("failed to fork");
604 			exit(-1);
605 		}
606 
607 		if (!pid) {
608 			dup2(live_pipe[1], 1);
609 			close(live_pipe[0]);
610 
611 			__argv = malloc(5 * sizeof(const char *));
612 			__argv[0] = "/bin/sh";
613 			__argv[1] = record_script_path;
614 			__argv[2] = "-o";
615 			__argv[3] = "-";
616 			__argv[4] = NULL;
617 
618 			execvp("/bin/sh", (char **)__argv);
619 			exit(-1);
620 		}
621 
622 		dup2(live_pipe[0], 0);
623 		close(live_pipe[1]);
624 
625 		__argv = malloc((argc + 3) * sizeof(const char *));
626 		__argv[0] = "/bin/sh";
627 		__argv[1] = report_script_path;
628 		for (i = 2; i < argc; i++)
629 			__argv[i] = argv[i];
630 		__argv[i++] = "-i";
631 		__argv[i++] = "-";
632 		__argv[i++] = NULL;
633 
634 		execvp("/bin/sh", (char **)__argv);
635 		exit(-1);
636 	}
637 
638 	if (suffix) {
639 		script_path = get_script_path(argv[2], suffix);
640 		if (!script_path) {
641 			fprintf(stderr, "script not found\n");
642 			return -1;
643 		}
644 
645 		__argv = malloc((argc + 1) * sizeof(const char *));
646 		__argv[0] = "/bin/sh";
647 		__argv[1] = script_path;
648 		for (i = 3; i < argc; i++)
649 			__argv[i - 1] = argv[i];
650 		__argv[argc - 1] = NULL;
651 
652 		execvp("/bin/sh", (char **)__argv);
653 		exit(-1);
654 	}
655 
656 	setup_scripting();
657 
658 	argc = parse_options(argc, argv, options, trace_usage,
659 			     PARSE_OPT_STOP_AT_NON_OPTION);
660 
661 	if (symbol__init() < 0)
662 		return -1;
663 	if (!script_name)
664 		setup_pager();
665 
666 	session = perf_session__new(input_name, O_RDONLY, 0, false);
667 	if (session == NULL)
668 		return -ENOMEM;
669 
670 	if (strcmp(input_name, "-") &&
671 	    !perf_session__has_traces(session, "record -R"))
672 		return -EINVAL;
673 
674 	if (generate_script_lang) {
675 		struct stat perf_stat;
676 
677 		int input = open(input_name, O_RDONLY);
678 		if (input < 0) {
679 			perror("failed to open file");
680 			exit(-1);
681 		}
682 
683 		err = fstat(input, &perf_stat);
684 		if (err < 0) {
685 			perror("failed to stat file");
686 			exit(-1);
687 		}
688 
689 		if (!perf_stat.st_size) {
690 			fprintf(stderr, "zero-sized file, nothing to do!\n");
691 			exit(0);
692 		}
693 
694 		scripting_ops = script_spec__lookup(generate_script_lang);
695 		if (!scripting_ops) {
696 			fprintf(stderr, "invalid language specifier");
697 			return -1;
698 		}
699 
700 		err = scripting_ops->generate_script("perf-trace");
701 		goto out;
702 	}
703 
704 	if (script_name) {
705 		err = scripting_ops->start_script(script_name, argc, argv);
706 		if (err)
707 			goto out;
708 		pr_debug("perf trace started with script %s\n\n", script_name);
709 	}
710 
711 	err = __cmd_trace(session);
712 
713 	perf_session__delete(session);
714 	cleanup_scripting();
715 out:
716 	return err;
717 }
718