1 /* SPDX-License-Identifier: GPL-2.0 */
2 #ifndef PERF_LIBDW_H
3 #define PERF_LIBDW_H
4
5 #include <linux/types.h>
6
7 struct dso;
8 struct inline_node;
9 struct symbol;
10
11 #ifdef HAVE_LIBDW_SUPPORT
12 /*
13 * libdw__addr2line - Convert address to source location using libdw
14 * @addr: Address to resolve
15 * @file: Pointer to return filename (caller must free)
16 * @line_nr: Pointer to return line number
17 * @dso: The dso struct
18 * @unwind_inlines: Whether to unwind inline function calls
19 * @node: Inline node list to append to
20 * @sym: The symbol associated with the address
21 *
22 * This function initializes a Dwfl context for the DSO if not already present,
23 * finds the source line information for the given address, and optionally
24 * resolves inline function call chains.
25 *
26 * Returns 1 on success (found), 0 on failure (not found).
27 */
28 int libdw__addr2line(u64 addr, char **file,
29 unsigned int *line_nr, struct dso *dso,
30 bool unwind_inlines, struct inline_node *node,
31 struct symbol *sym);
32
33 /*
34 * dso__free_libdw - Free libdw resources associated with the DSO
35 * @dso: The dso to free resources for
36 *
37 * This function cleans up the Dwfl context used for addr2line lookups.
38 */
39 void dso__free_libdw(struct dso *dso);
40
41 #else /* HAVE_LIBDW_SUPPORT */
42
libdw__addr2line(u64 addr __maybe_unused,char ** file __maybe_unused,unsigned int * line_nr __maybe_unused,struct dso * dso __maybe_unused,bool unwind_inlines __maybe_unused,struct inline_node * node __maybe_unused,struct symbol * sym __maybe_unused)43 static inline int libdw__addr2line(u64 addr __maybe_unused, char **file __maybe_unused,
44 unsigned int *line_nr __maybe_unused,
45 struct dso *dso __maybe_unused,
46 bool unwind_inlines __maybe_unused,
47 struct inline_node *node __maybe_unused,
48 struct symbol *sym __maybe_unused)
49 {
50 return 0;
51 }
52
dso__free_libdw(struct dso * dso __maybe_unused)53 static inline void dso__free_libdw(struct dso *dso __maybe_unused)
54 {
55 }
56 #endif /* HAVE_LIBDW_SUPPORT */
57
58 #endif /* PERF_LIBDW_H */
59