projects/linux·blob master · refs

58 lines · 1.7 KiB

1/* SPDX-License-Identifier: GPL-2.0 */
2#ifndef PERF_LIBDW_H
3#define PERF_LIBDW_H
4
5#include <linux/types.h>
6
7struct dso;
8struct inline_node;
9struct 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 */
28int 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 */
39void dso__free_libdw(struct dso *dso);
40
41#else /* HAVE_LIBDW_SUPPORT */
42
43static 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
53static inline void dso__free_libdw(struct dso *dso __maybe_unused)
54{
55}
56#endif /* HAVE_LIBDW_SUPPORT */
57
58#endif /* PERF_LIBDW_H */