2 * Unwinder backends interface.
4 * Copyright (c) 2013 Luca Clementi <luca.clementi@gmail.com>
5 * Copyright (c) 2013-2018 The strace developers.
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
10 * 1. Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer.
12 * 2. Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in the
14 * documentation and/or other materials provided with the distribution.
15 * 3. The name of the author may not be used to endorse or promote products
16 * derived from this software without specific prior written permission.
18 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
19 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
20 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
21 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
22 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
23 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
24 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
25 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
26 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
27 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
30 #ifndef STRACE_UNWIND_H
31 #define STRACE_UNWIND_H
36 * Type used in stacktrace walker.
39 /* This storage be enough large to store unw_word_t. */
40 typedef unsigned long unwind_function_offset_t;
42 typedef void (*unwind_call_action_fn)(void *data,
43 const char *binary_filename,
44 const char *symbol_name,
45 unwind_function_offset_t function_offset,
46 unsigned long true_offset);
47 typedef void (*unwind_error_action_fn)(void *data,
49 unsigned long true_offset);
51 struct unwind_unwinder_t {
54 /* Initialize the unwinder. */
57 /* Make/destroy the context data attached to tcb. */
58 void * (*tcb_init)(struct tcb *);
59 void (*tcb_fin)(struct tcb *);
62 void (*tcb_walk)(struct tcb *,
63 unwind_call_action_fn,
64 unwind_error_action_fn,
68 extern const struct unwind_unwinder_t unwinder;
70 #endif /* !STRACE_UNWIND_H */