xref: /linux/tools/perf/util/db-export.c (revision 9b838a3c32d7a1edd7edeec1bc455eca76622218)
1 // SPDX-License-Identifier: GPL-2.0-only
2 /*
3  * db-export.c: Support for exporting data suitable for import to a database
4  * Copyright (c) 2014, Intel Corporation.
5  */
6 
7 #include <errno.h>
8 #include <stdlib.h>
9 
10 #include "dso.h"
11 #include "evsel.h"
12 #include "machine.h"
13 #include "thread.h"
14 #include "comm.h"
15 #include "symbol.h"
16 #include "map.h"
17 #include "event.h"
18 #include "thread-stack.h"
19 #include "callchain.h"
20 #include "call-path.h"
21 #include "db-export.h"
22 #include <linux/zalloc.h>
23 
24 int db_export__init(struct db_export *dbe)
25 {
26 	memset(dbe, 0, sizeof(struct db_export));
27 	return 0;
28 }
29 
30 void db_export__exit(struct db_export *dbe)
31 {
32 	call_return_processor__free(dbe->crp);
33 	dbe->crp = NULL;
34 }
35 
36 int db_export__evsel(struct db_export *dbe, struct evsel *evsel)
37 {
38 	if (evsel->db_id)
39 		return 0;
40 
41 	evsel->db_id = ++dbe->evsel_last_db_id;
42 
43 	if (dbe->export_evsel)
44 		return dbe->export_evsel(dbe, evsel);
45 
46 	return 0;
47 }
48 
49 int db_export__machine(struct db_export *dbe, struct machine *machine)
50 {
51 	if (machine->db_id)
52 		return 0;
53 
54 	machine->db_id = ++dbe->machine_last_db_id;
55 
56 	if (dbe->export_machine)
57 		return dbe->export_machine(dbe, machine);
58 
59 	return 0;
60 }
61 
62 int db_export__thread(struct db_export *dbe, struct thread *thread,
63 		      struct machine *machine, struct thread *main_thread)
64 {
65 	u64 main_thread_db_id = 0;
66 
67 	if (thread->db_id)
68 		return 0;
69 
70 	thread->db_id = ++dbe->thread_last_db_id;
71 
72 	if (main_thread)
73 		main_thread_db_id = main_thread->db_id;
74 
75 	if (dbe->export_thread)
76 		return dbe->export_thread(dbe, thread, main_thread_db_id,
77 					  machine);
78 
79 	return 0;
80 }
81 
82 static int __db_export__comm(struct db_export *dbe, struct comm *comm,
83 			     struct thread *thread)
84 {
85 	comm->db_id = ++dbe->comm_last_db_id;
86 
87 	if (dbe->export_comm)
88 		return dbe->export_comm(dbe, comm, thread);
89 
90 	return 0;
91 }
92 
93 int db_export__comm(struct db_export *dbe, struct comm *comm,
94 		    struct thread *thread)
95 {
96 	if (comm->db_id)
97 		return 0;
98 
99 	return __db_export__comm(dbe, comm, thread);
100 }
101 
102 /*
103  * Export the "exec" comm. The "exec" comm is the program / application command
104  * name at the time it first executes. It is used to group threads for the same
105  * program. Note that the main thread pid (or thread group id tgid) cannot be
106  * used because it does not change when a new program is exec'ed.
107  */
108 int db_export__exec_comm(struct db_export *dbe, struct comm *comm,
109 			 struct thread *main_thread)
110 {
111 	int err;
112 
113 	if (comm->db_id)
114 		return 0;
115 
116 	err = __db_export__comm(dbe, comm, main_thread);
117 	if (err)
118 		return err;
119 
120 	/*
121 	 * Record the main thread for this comm. Note that the main thread can
122 	 * have many "exec" comms because there will be a new one every time it
123 	 * exec's. An "exec" comm however will only ever have 1 main thread.
124 	 * That is different to any other threads for that same program because
125 	 * exec() will effectively kill them, so the relationship between the
126 	 * "exec" comm and non-main threads is 1-to-1. That is why
127 	 * db_export__comm_thread() is called here for the main thread, but it
128 	 * is called for non-main threads when they are exported.
129 	 */
130 	return db_export__comm_thread(dbe, comm, main_thread);
131 }
132 
133 int db_export__comm_thread(struct db_export *dbe, struct comm *comm,
134 			   struct thread *thread)
135 {
136 	u64 db_id;
137 
138 	db_id = ++dbe->comm_thread_last_db_id;
139 
140 	if (dbe->export_comm_thread)
141 		return dbe->export_comm_thread(dbe, db_id, comm, thread);
142 
143 	return 0;
144 }
145 
146 int db_export__dso(struct db_export *dbe, struct dso *dso,
147 		   struct machine *machine)
148 {
149 	if (dso->db_id)
150 		return 0;
151 
152 	dso->db_id = ++dbe->dso_last_db_id;
153 
154 	if (dbe->export_dso)
155 		return dbe->export_dso(dbe, dso, machine);
156 
157 	return 0;
158 }
159 
160 int db_export__symbol(struct db_export *dbe, struct symbol *sym,
161 		      struct dso *dso)
162 {
163 	u64 *sym_db_id = symbol__priv(sym);
164 
165 	if (*sym_db_id)
166 		return 0;
167 
168 	*sym_db_id = ++dbe->symbol_last_db_id;
169 
170 	if (dbe->export_symbol)
171 		return dbe->export_symbol(dbe, sym, dso);
172 
173 	return 0;
174 }
175 
176 static int db_ids_from_al(struct db_export *dbe, struct addr_location *al,
177 			  u64 *dso_db_id, u64 *sym_db_id, u64 *offset)
178 {
179 	int err;
180 
181 	if (al->map) {
182 		struct dso *dso = al->map->dso;
183 
184 		err = db_export__dso(dbe, dso, al->maps->machine);
185 		if (err)
186 			return err;
187 		*dso_db_id = dso->db_id;
188 
189 		if (!al->sym) {
190 			al->sym = symbol__new(al->addr, 0, 0, 0, "unknown");
191 			if (al->sym)
192 				dso__insert_symbol(dso, al->sym);
193 		}
194 
195 		if (al->sym) {
196 			u64 *db_id = symbol__priv(al->sym);
197 
198 			err = db_export__symbol(dbe, al->sym, dso);
199 			if (err)
200 				return err;
201 			*sym_db_id = *db_id;
202 			*offset = al->addr - al->sym->start;
203 		}
204 	}
205 
206 	return 0;
207 }
208 
209 static struct call_path *call_path_from_sample(struct db_export *dbe,
210 					       struct machine *machine,
211 					       struct thread *thread,
212 					       struct perf_sample *sample,
213 					       struct evsel *evsel)
214 {
215 	u64 kernel_start = machine__kernel_start(machine);
216 	struct call_path *current = &dbe->cpr->call_path;
217 	enum chain_order saved_order = callchain_param.order;
218 	int err;
219 
220 	if (!symbol_conf.use_callchain || !sample->callchain)
221 		return NULL;
222 
223 	/*
224 	 * Since the call path tree must be built starting with the root, we
225 	 * must use ORDER_CALL for call chain resolution, in order to process
226 	 * the callchain starting with the root node and ending with the leaf.
227 	 */
228 	callchain_param.order = ORDER_CALLER;
229 	err = thread__resolve_callchain(thread, &callchain_cursor, evsel,
230 					sample, NULL, NULL, PERF_MAX_STACK_DEPTH);
231 	if (err) {
232 		callchain_param.order = saved_order;
233 		return NULL;
234 	}
235 	callchain_cursor_commit(&callchain_cursor);
236 
237 	while (1) {
238 		struct callchain_cursor_node *node;
239 		struct addr_location al;
240 		u64 dso_db_id = 0, sym_db_id = 0, offset = 0;
241 
242 		memset(&al, 0, sizeof(al));
243 
244 		node = callchain_cursor_current(&callchain_cursor);
245 		if (!node)
246 			break;
247 		/*
248 		 * Handle export of symbol and dso for this node by
249 		 * constructing an addr_location struct and then passing it to
250 		 * db_ids_from_al() to perform the export.
251 		 */
252 		al.sym = node->ms.sym;
253 		al.map = node->ms.map;
254 		al.maps = thread->maps;
255 		al.addr = node->ip;
256 
257 		if (al.map && !al.sym)
258 			al.sym = dso__find_symbol(al.map->dso, al.addr);
259 
260 		db_ids_from_al(dbe, &al, &dso_db_id, &sym_db_id, &offset);
261 
262 		/* add node to the call path tree if it doesn't exist */
263 		current = call_path__findnew(dbe->cpr, current,
264 					     al.sym, node->ip,
265 					     kernel_start);
266 
267 		callchain_cursor_advance(&callchain_cursor);
268 	}
269 
270 	/* Reset the callchain order to its prior value. */
271 	callchain_param.order = saved_order;
272 
273 	if (current == &dbe->cpr->call_path) {
274 		/* Bail because the callchain was empty. */
275 		return NULL;
276 	}
277 
278 	return current;
279 }
280 
281 int db_export__branch_type(struct db_export *dbe, u32 branch_type,
282 			   const char *name)
283 {
284 	if (dbe->export_branch_type)
285 		return dbe->export_branch_type(dbe, branch_type, name);
286 
287 	return 0;
288 }
289 
290 static int db_export__threads(struct db_export *dbe, struct thread *thread,
291 			      struct thread *main_thread,
292 			      struct machine *machine, struct comm **comm_ptr)
293 {
294 	struct comm *comm = NULL;
295 	struct comm *curr_comm;
296 	int err;
297 
298 	if (main_thread) {
299 		/*
300 		 * A thread has a reference to the main thread, so export the
301 		 * main thread first.
302 		 */
303 		err = db_export__thread(dbe, main_thread, machine, main_thread);
304 		if (err)
305 			return err;
306 		/*
307 		 * Export comm before exporting the non-main thread because
308 		 * db_export__comm_thread() can be called further below.
309 		 */
310 		comm = machine__thread_exec_comm(machine, main_thread);
311 		if (comm) {
312 			err = db_export__exec_comm(dbe, comm, main_thread);
313 			if (err)
314 				return err;
315 			*comm_ptr = comm;
316 		}
317 	}
318 
319 	if (thread != main_thread) {
320 		/*
321 		 * For a non-main thread, db_export__comm_thread() must be
322 		 * called only if thread has not previously been exported.
323 		 */
324 		bool export_comm_thread = comm && !thread->db_id;
325 
326 		err = db_export__thread(dbe, thread, machine, main_thread);
327 		if (err)
328 			return err;
329 
330 		if (export_comm_thread) {
331 			err = db_export__comm_thread(dbe, comm, thread);
332 			if (err)
333 				return err;
334 		}
335 	}
336 
337 	curr_comm = thread__comm(thread);
338 	if (curr_comm)
339 		return db_export__comm(dbe, curr_comm, thread);
340 
341 	return 0;
342 }
343 
344 int db_export__sample(struct db_export *dbe, union perf_event *event,
345 		      struct perf_sample *sample, struct evsel *evsel,
346 		      struct addr_location *al)
347 {
348 	struct thread *thread = al->thread;
349 	struct export_sample es = {
350 		.event = event,
351 		.sample = sample,
352 		.evsel = evsel,
353 		.al = al,
354 	};
355 	struct thread *main_thread;
356 	struct comm *comm = NULL;
357 	int err;
358 
359 	err = db_export__evsel(dbe, evsel);
360 	if (err)
361 		return err;
362 
363 	err = db_export__machine(dbe, al->maps->machine);
364 	if (err)
365 		return err;
366 
367 	main_thread = thread__main_thread(al->maps->machine, thread);
368 
369 	err = db_export__threads(dbe, thread, main_thread, al->maps->machine, &comm);
370 	if (err)
371 		goto out_put;
372 
373 	if (comm)
374 		es.comm_db_id = comm->db_id;
375 
376 	es.db_id = ++dbe->sample_last_db_id;
377 
378 	err = db_ids_from_al(dbe, al, &es.dso_db_id, &es.sym_db_id, &es.offset);
379 	if (err)
380 		goto out_put;
381 
382 	if (dbe->cpr) {
383 		struct call_path *cp = call_path_from_sample(dbe, al->maps->machine,
384 							     thread, sample,
385 							     evsel);
386 		if (cp) {
387 			db_export__call_path(dbe, cp);
388 			es.call_path_id = cp->db_id;
389 		}
390 	}
391 
392 	if ((evsel->core.attr.sample_type & PERF_SAMPLE_ADDR) &&
393 	    sample_addr_correlates_sym(&evsel->core.attr)) {
394 		struct addr_location addr_al;
395 
396 		thread__resolve(thread, &addr_al, sample);
397 		err = db_ids_from_al(dbe, &addr_al, &es.addr_dso_db_id,
398 				     &es.addr_sym_db_id, &es.addr_offset);
399 		if (err)
400 			goto out_put;
401 		if (dbe->crp) {
402 			err = thread_stack__process(thread, comm, sample, al,
403 						    &addr_al, es.db_id,
404 						    dbe->crp);
405 			if (err)
406 				goto out_put;
407 		}
408 	}
409 
410 	if (dbe->export_sample)
411 		err = dbe->export_sample(dbe, &es);
412 
413 out_put:
414 	thread__put(main_thread);
415 	return err;
416 }
417 
418 static struct {
419 	u32 branch_type;
420 	const char *name;
421 } branch_types[] = {
422 	{0, "no branch"},
423 	{PERF_IP_FLAG_BRANCH | PERF_IP_FLAG_CALL, "call"},
424 	{PERF_IP_FLAG_BRANCH | PERF_IP_FLAG_RETURN, "return"},
425 	{PERF_IP_FLAG_BRANCH | PERF_IP_FLAG_CONDITIONAL, "conditional jump"},
426 	{PERF_IP_FLAG_BRANCH, "unconditional jump"},
427 	{PERF_IP_FLAG_BRANCH | PERF_IP_FLAG_CALL | PERF_IP_FLAG_INTERRUPT,
428 	 "software interrupt"},
429 	{PERF_IP_FLAG_BRANCH | PERF_IP_FLAG_RETURN | PERF_IP_FLAG_INTERRUPT,
430 	 "return from interrupt"},
431 	{PERF_IP_FLAG_BRANCH | PERF_IP_FLAG_CALL | PERF_IP_FLAG_SYSCALLRET,
432 	 "system call"},
433 	{PERF_IP_FLAG_BRANCH | PERF_IP_FLAG_RETURN | PERF_IP_FLAG_SYSCALLRET,
434 	 "return from system call"},
435 	{PERF_IP_FLAG_BRANCH | PERF_IP_FLAG_ASYNC, "asynchronous branch"},
436 	{PERF_IP_FLAG_BRANCH | PERF_IP_FLAG_CALL | PERF_IP_FLAG_ASYNC |
437 	 PERF_IP_FLAG_INTERRUPT, "hardware interrupt"},
438 	{PERF_IP_FLAG_BRANCH | PERF_IP_FLAG_TX_ABORT, "transaction abort"},
439 	{PERF_IP_FLAG_BRANCH | PERF_IP_FLAG_TRACE_BEGIN, "trace begin"},
440 	{PERF_IP_FLAG_BRANCH | PERF_IP_FLAG_TRACE_END, "trace end"},
441 	{PERF_IP_FLAG_BRANCH | PERF_IP_FLAG_CALL | PERF_IP_FLAG_VMENTRY, "vm entry"},
442 	{PERF_IP_FLAG_BRANCH | PERF_IP_FLAG_CALL | PERF_IP_FLAG_VMEXIT, "vm exit"},
443 	{0, NULL}
444 };
445 
446 int db_export__branch_types(struct db_export *dbe)
447 {
448 	int i, err = 0;
449 
450 	for (i = 0; branch_types[i].name ; i++) {
451 		err = db_export__branch_type(dbe, branch_types[i].branch_type,
452 					     branch_types[i].name);
453 		if (err)
454 			break;
455 	}
456 
457 	/* Add trace begin / end variants */
458 	for (i = 0; branch_types[i].name ; i++) {
459 		const char *name = branch_types[i].name;
460 		u32 type = branch_types[i].branch_type;
461 		char buf[64];
462 
463 		if (type == PERF_IP_FLAG_BRANCH ||
464 		    (type & (PERF_IP_FLAG_TRACE_BEGIN | PERF_IP_FLAG_TRACE_END)))
465 			continue;
466 
467 		snprintf(buf, sizeof(buf), "trace begin / %s", name);
468 		err = db_export__branch_type(dbe, type | PERF_IP_FLAG_TRACE_BEGIN, buf);
469 		if (err)
470 			break;
471 
472 		snprintf(buf, sizeof(buf), "%s / trace end", name);
473 		err = db_export__branch_type(dbe, type | PERF_IP_FLAG_TRACE_END, buf);
474 		if (err)
475 			break;
476 	}
477 
478 	return err;
479 }
480 
481 int db_export__call_path(struct db_export *dbe, struct call_path *cp)
482 {
483 	int err;
484 
485 	if (cp->db_id)
486 		return 0;
487 
488 	if (cp->parent) {
489 		err = db_export__call_path(dbe, cp->parent);
490 		if (err)
491 			return err;
492 	}
493 
494 	cp->db_id = ++dbe->call_path_last_db_id;
495 
496 	if (dbe->export_call_path)
497 		return dbe->export_call_path(dbe, cp);
498 
499 	return 0;
500 }
501 
502 int db_export__call_return(struct db_export *dbe, struct call_return *cr,
503 			   u64 *parent_db_id)
504 {
505 	int err;
506 
507 	err = db_export__call_path(dbe, cr->cp);
508 	if (err)
509 		return err;
510 
511 	if (!cr->db_id)
512 		cr->db_id = ++dbe->call_return_last_db_id;
513 
514 	if (parent_db_id) {
515 		if (!*parent_db_id)
516 			*parent_db_id = ++dbe->call_return_last_db_id;
517 		cr->parent_db_id = *parent_db_id;
518 	}
519 
520 	if (dbe->export_call_return)
521 		return dbe->export_call_return(dbe, cr);
522 
523 	return 0;
524 }
525 
526 static int db_export__pid_tid(struct db_export *dbe, struct machine *machine,
527 			      pid_t pid, pid_t tid, u64 *db_id,
528 			      struct comm **comm_ptr, bool *is_idle)
529 {
530 	struct thread *thread = machine__find_thread(machine, pid, tid);
531 	struct thread *main_thread;
532 	int err = 0;
533 
534 	if (!thread || !thread->comm_set)
535 		goto out_put;
536 
537 	*is_idle = !thread->pid_ && !thread->tid;
538 
539 	main_thread = thread__main_thread(machine, thread);
540 
541 	err = db_export__threads(dbe, thread, main_thread, machine, comm_ptr);
542 
543 	*db_id = thread->db_id;
544 
545 	thread__put(main_thread);
546 out_put:
547 	thread__put(thread);
548 
549 	return err;
550 }
551 
552 int db_export__switch(struct db_export *dbe, union perf_event *event,
553 		      struct perf_sample *sample, struct machine *machine)
554 {
555 	bool out = event->header.misc & PERF_RECORD_MISC_SWITCH_OUT;
556 	bool out_preempt = out &&
557 		(event->header.misc & PERF_RECORD_MISC_SWITCH_OUT_PREEMPT);
558 	int flags = out | (out_preempt << 1);
559 	bool is_idle_a = false, is_idle_b = false;
560 	u64 th_a_id = 0, th_b_id = 0;
561 	u64 comm_out_id, comm_in_id;
562 	struct comm *comm_a = NULL;
563 	struct comm *comm_b = NULL;
564 	u64 th_out_id, th_in_id;
565 	u64 db_id;
566 	int err;
567 
568 	err = db_export__machine(dbe, machine);
569 	if (err)
570 		return err;
571 
572 	err = db_export__pid_tid(dbe, machine, sample->pid, sample->tid,
573 				 &th_a_id, &comm_a, &is_idle_a);
574 	if (err)
575 		return err;
576 
577 	if (event->header.type == PERF_RECORD_SWITCH_CPU_WIDE) {
578 		pid_t pid = event->context_switch.next_prev_pid;
579 		pid_t tid = event->context_switch.next_prev_tid;
580 
581 		err = db_export__pid_tid(dbe, machine, pid, tid, &th_b_id,
582 					 &comm_b, &is_idle_b);
583 		if (err)
584 			return err;
585 	}
586 
587 	/*
588 	 * Do not export if both threads are unknown (i.e. not being traced),
589 	 * or one is unknown and the other is the idle task.
590 	 */
591 	if ((!th_a_id || is_idle_a) && (!th_b_id || is_idle_b))
592 		return 0;
593 
594 	db_id = ++dbe->context_switch_last_db_id;
595 
596 	if (out) {
597 		th_out_id   = th_a_id;
598 		th_in_id    = th_b_id;
599 		comm_out_id = comm_a ? comm_a->db_id : 0;
600 		comm_in_id  = comm_b ? comm_b->db_id : 0;
601 	} else {
602 		th_out_id   = th_b_id;
603 		th_in_id    = th_a_id;
604 		comm_out_id = comm_b ? comm_b->db_id : 0;
605 		comm_in_id  = comm_a ? comm_a->db_id : 0;
606 	}
607 
608 	if (dbe->export_context_switch)
609 		return dbe->export_context_switch(dbe, db_id, machine, sample,
610 						  th_out_id, comm_out_id,
611 						  th_in_id, comm_in_id, flags);
612 	return 0;
613 }
614