xref: /linux/tools/perf/util/unwind.h (revision 7a92fc8b4d20680e4c20289a670d8fca2d1f2c1b)
1 /* SPDX-License-Identifier: GPL-2.0 */
2 #ifndef __UNWIND_H
3 #define __UNWIND_H
4 
5 #include <linux/compiler.h>
6 #include <linux/types.h>
7 #include "util/map_symbol.h"
8 
9 struct maps;
10 struct perf_sample;
11 struct thread;
12 
13 struct unwind_entry {
14 	struct map_symbol ms;
15 	u64		  ip;
16 };
17 
18 typedef int (*unwind_entry_cb_t)(struct unwind_entry *entry, void *arg);
19 
20 struct unwind_libunwind_ops {
21 	int (*prepare_access)(struct maps *maps);
22 	void (*flush_access)(struct maps *maps);
23 	void (*finish_access)(struct maps *maps);
24 	int (*get_entries)(unwind_entry_cb_t cb, void *arg,
25 			   struct thread *thread,
26 			   struct perf_sample *data, int max_stack, bool best_effort);
27 };
28 
29 #ifdef HAVE_DWARF_UNWIND_SUPPORT
30 /*
31  * When best_effort is set, don't report errors and fail silently. This could
32  * be expanded in the future to be more permissive about things other than
33  * error messages.
34  */
35 int unwind__get_entries(unwind_entry_cb_t cb, void *arg,
36 			struct thread *thread,
37 			struct perf_sample *data, int max_stack,
38 			bool best_effort);
39 /* libunwind specific */
40 #ifdef HAVE_LIBUNWIND_SUPPORT
41 #ifndef LIBUNWIND__ARCH_REG_ID
42 #define LIBUNWIND__ARCH_REG_ID(regnum) libunwind__arch_reg_id(regnum)
43 #endif
44 
45 int LIBUNWIND__ARCH_REG_ID(int regnum);
46 int unwind__prepare_access(struct maps *maps, struct map *map, bool *initialized);
47 void unwind__flush_access(struct maps *maps);
48 void unwind__finish_access(struct maps *maps);
49 #else
50 static inline int unwind__prepare_access(struct maps *maps __maybe_unused,
51 					 struct map *map __maybe_unused,
52 					 bool *initialized __maybe_unused)
53 {
54 	return 0;
55 }
56 
57 static inline void unwind__flush_access(struct maps *maps __maybe_unused) {}
58 static inline void unwind__finish_access(struct maps *maps __maybe_unused) {}
59 #endif
60 #else
61 static inline int
62 unwind__get_entries(unwind_entry_cb_t cb __maybe_unused,
63 		    void *arg __maybe_unused,
64 		    struct thread *thread __maybe_unused,
65 		    struct perf_sample *data __maybe_unused,
66 		    int max_stack __maybe_unused,
67 		    bool best_effort __maybe_unused)
68 {
69 	return 0;
70 }
71 
72 static inline int unwind__prepare_access(struct maps *maps __maybe_unused,
73 					 struct map *map __maybe_unused,
74 					 bool *initialized __maybe_unused)
75 {
76 	return 0;
77 }
78 
79 static inline void unwind__flush_access(struct maps *maps __maybe_unused) {}
80 static inline void unwind__finish_access(struct maps *maps __maybe_unused) {}
81 #endif /* HAVE_DWARF_UNWIND_SUPPORT */
82 #endif /* __UNWIND_H */
83