1 //===----------------------------------------------------------------------===//
2 //
3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4 // See https://llvm.org/LICENSE.txt for license information.
5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6 //
7 //
8 //  Defines macros used within libunwind project.
9 //
10 //===----------------------------------------------------------------------===//
11 
12 
13 #ifndef LIBUNWIND_CONFIG_H
14 #define LIBUNWIND_CONFIG_H
15 
16 #include <assert.h>
17 #include <stdio.h>
18 #include <stdint.h>
19 #include <stdlib.h>
20 
21 #include <__libunwind_config.h>
22 
23 // Platform specific configuration defines.
24 #ifdef __APPLE__
25   #if defined(FOR_DYLD)
26     #define _LIBUNWIND_SUPPORT_COMPACT_UNWIND 1
27   #else
28     #define _LIBUNWIND_SUPPORT_COMPACT_UNWIND 1
29     #define _LIBUNWIND_SUPPORT_DWARF_UNWIND 1
30   #endif
31 #elif defined(_WIN32)
32   #ifdef __SEH__
33     #define _LIBUNWIND_SUPPORT_SEH_UNWIND 1
34   #else
35     #define _LIBUNWIND_SUPPORT_DWARF_UNWIND 1
36   #endif
37 #elif defined(_LIBUNWIND_IS_BAREMETAL)
38   #if !defined(_LIBUNWIND_ARM_EHABI)
39     #define _LIBUNWIND_SUPPORT_DWARF_UNWIND 1
40     #define _LIBUNWIND_SUPPORT_DWARF_INDEX 1
41   #endif
42 #elif defined(__BIONIC__) && defined(_LIBUNWIND_ARM_EHABI)
43   // For ARM EHABI, Bionic didn't implement dl_iterate_phdr until API 21. After
44   // API 21, dl_iterate_phdr exists, but dl_unwind_find_exidx is much faster.
45   #define _LIBUNWIND_USE_DL_UNWIND_FIND_EXIDX 1
46 #elif defined(_AIX)
47 // The traceback table at the end of each function is used for unwinding.
48 #define _LIBUNWIND_SUPPORT_TBTAB_UNWIND 1
49 #else
50   // Assume an ELF system with a dl_iterate_phdr function.
51   #define _LIBUNWIND_USE_DL_ITERATE_PHDR 1
52   #if !defined(_LIBUNWIND_ARM_EHABI)
53     #define _LIBUNWIND_SUPPORT_DWARF_UNWIND 1
54     #define _LIBUNWIND_SUPPORT_DWARF_INDEX 1
55   #endif
56 #endif
57 
58 #if defined(_LIBUNWIND_HIDE_SYMBOLS)
59   // The CMake file passes -fvisibility=hidden to control ELF/Mach-O visibility.
60   #define _LIBUNWIND_EXPORT
61   #define _LIBUNWIND_HIDDEN
62 #else
63   #if !defined(__ELF__) && !defined(__MACH__) && !defined(_AIX)
64     #define _LIBUNWIND_EXPORT __declspec(dllexport)
65     #define _LIBUNWIND_HIDDEN
66   #else
67     #define _LIBUNWIND_EXPORT __attribute__((visibility("default")))
68     #define _LIBUNWIND_HIDDEN __attribute__((visibility("hidden")))
69   #endif
70 #endif
71 
72 #define STR(a) #a
73 #define XSTR(a) STR(a)
74 #define SYMBOL_NAME(name) XSTR(__USER_LABEL_PREFIX__) #name
75 
76 #if defined(__APPLE__)
77 #if defined(_LIBUNWIND_HIDE_SYMBOLS)
78 #define _LIBUNWIND_ALIAS_VISIBILITY(name) __asm__(".private_extern " name);
79 #else
80 #define _LIBUNWIND_ALIAS_VISIBILITY(name)
81 #endif
82 #define _LIBUNWIND_WEAK_ALIAS(name, aliasname)                                 \
83   __asm__(".globl " SYMBOL_NAME(aliasname));                                   \
84   __asm__(SYMBOL_NAME(aliasname) " = " SYMBOL_NAME(name));                     \
85   _LIBUNWIND_ALIAS_VISIBILITY(SYMBOL_NAME(aliasname))
86 #elif defined(__ELF__) || defined(_AIX)
87 #define _LIBUNWIND_WEAK_ALIAS(name, aliasname)                                 \
88   extern "C" _LIBUNWIND_EXPORT __typeof(name) aliasname                        \
89       __attribute__((weak, alias(#name)));
90 #elif defined(_WIN32)
91 #if defined(__MINGW32__)
92 #define _LIBUNWIND_WEAK_ALIAS(name, aliasname)                                 \
93   extern "C" _LIBUNWIND_EXPORT __typeof(name) aliasname                        \
94       __attribute__((alias(#name)));
95 #else
96 #define _LIBUNWIND_WEAK_ALIAS(name, aliasname)                                 \
97   __pragma(comment(linker, "/alternatename:" SYMBOL_NAME(aliasname) "="        \
98                                              SYMBOL_NAME(name)))               \
99   extern "C" _LIBUNWIND_EXPORT __typeof(name) aliasname;
100 #endif
101 #else
102 #error Unsupported target
103 #endif
104 
105 // Apple/armv7k defaults to DWARF/Compact unwinding, but its libunwind also
106 // needs to include the SJLJ APIs.
107 #if (defined(__APPLE__) && defined(__arm__)) || defined(__USING_SJLJ_EXCEPTIONS__)
108 #define _LIBUNWIND_BUILD_SJLJ_APIS
109 #endif
110 
111 #if defined(__i386__) || defined(__x86_64__) || defined(__powerpc__)
112 #define _LIBUNWIND_SUPPORT_FRAME_APIS
113 #endif
114 
115 #if defined(__i386__) || defined(__x86_64__) || defined(__powerpc__) ||        \
116     (!defined(__APPLE__) && defined(__arm__)) || defined(__aarch64__) ||       \
117     defined(__mips__) || defined(__riscv) || defined(__hexagon__) ||           \
118     defined(__sparc__) || defined(__s390x__)
119 #if !defined(_LIBUNWIND_BUILD_SJLJ_APIS)
120 #define _LIBUNWIND_BUILD_ZERO_COST_APIS
121 #endif
122 #endif
123 
124 #ifndef _LIBUNWIND_REMEMBER_HEAP_ALLOC
125 #if defined(_LIBUNWIND_REMEMBER_STACK_ALLOC) || defined(__APPLE__) ||          \
126     defined(__linux__) || defined(__ANDROID__) || defined(__MINGW32__) ||      \
127     defined(_LIBUNWIND_IS_BAREMETAL)
128 #define _LIBUNWIND_REMEMBER_ALLOC(_size) alloca(_size)
129 #define _LIBUNWIND_REMEMBER_FREE(_ptr)                                         \
130   do {                                                                         \
131   } while (0)
132 #elif defined(_WIN32)
133 #define _LIBUNWIND_REMEMBER_ALLOC(_size) _malloca(_size)
134 #define _LIBUNWIND_REMEMBER_FREE(_ptr) _freea(_ptr)
135 #define _LIBUNWIND_REMEMBER_CLEANUP_NEEDED
136 #else
137 #define _LIBUNWIND_REMEMBER_ALLOC(_size) malloc(_size)
138 #define _LIBUNWIND_REMEMBER_FREE(_ptr) free(_ptr)
139 #define _LIBUNWIND_REMEMBER_CLEANUP_NEEDED
140 #endif
141 #else /* _LIBUNWIND_REMEMBER_HEAP_ALLOC */
142 #define _LIBUNWIND_REMEMBER_ALLOC(_size) malloc(_size)
143 #define _LIBUNWIND_REMEMBER_FREE(_ptr) free(_ptr)
144 #define _LIBUNWIND_REMEMBER_CLEANUP_NEEDED
145 #endif
146 
147 #if defined(NDEBUG) && defined(_LIBUNWIND_IS_BAREMETAL)
148 #define _LIBUNWIND_ABORT(msg)                                                  \
149   do {                                                                         \
150     abort();                                                                   \
151   } while (0)
152 #else
153 #define _LIBUNWIND_ABORT(msg)                                                  \
154   do {                                                                         \
155     fprintf(stderr, "libunwind: %s - %s\n", __func__, msg);                    \
156     fflush(stderr);                                                            \
157     abort();                                                                   \
158   } while (0)
159 #endif
160 
161 #if defined(NDEBUG) && defined(_LIBUNWIND_IS_BAREMETAL)
162 #define _LIBUNWIND_LOG0(msg)
163 #define _LIBUNWIND_LOG(msg, ...)
164 #else
165 #define _LIBUNWIND_LOG0(msg)                                               \
166   fprintf(stderr, "libunwind: " msg "\n")
167 #define _LIBUNWIND_LOG(msg, ...)                                               \
168   fprintf(stderr, "libunwind: " msg "\n", __VA_ARGS__)
169 #endif
170 
171 #if defined(NDEBUG)
172   #define _LIBUNWIND_LOG_IF_FALSE(x) x
173 #else
174   #define _LIBUNWIND_LOG_IF_FALSE(x)                                           \
175     do {                                                                       \
176       bool _ret = x;                                                           \
177       if (!_ret)                                                               \
178         _LIBUNWIND_LOG("" #x " failed in %s", __FUNCTION__);                   \
179     } while (0)
180 #endif
181 
182 // Macros that define away in non-Debug builds
183 #ifdef NDEBUG
184   #define _LIBUNWIND_DEBUG_LOG(msg, ...)
185   #define _LIBUNWIND_TRACE_API(msg, ...)
186   #define _LIBUNWIND_TRACING_UNWINDING (0)
187   #define _LIBUNWIND_TRACING_DWARF (0)
188   #define _LIBUNWIND_TRACE_UNWINDING(msg, ...)
189   #define _LIBUNWIND_TRACE_DWARF(...)
190 #else
191   #ifdef __cplusplus
192     extern "C" {
193   #endif
194     extern  bool logAPIs(void);
195     extern  bool logUnwinding(void);
196     extern  bool logDWARF(void);
197   #ifdef __cplusplus
198     }
199   #endif
200   #define _LIBUNWIND_DEBUG_LOG(msg, ...)  _LIBUNWIND_LOG(msg, __VA_ARGS__)
201   #define _LIBUNWIND_TRACE_API(msg, ...)                                       \
202     do {                                                                       \
203       if (logAPIs())                                                           \
204         _LIBUNWIND_LOG(msg, __VA_ARGS__);                                      \
205     } while (0)
206   #define _LIBUNWIND_TRACING_UNWINDING logUnwinding()
207   #define _LIBUNWIND_TRACING_DWARF logDWARF()
208   #define _LIBUNWIND_TRACE_UNWINDING(msg, ...)                                 \
209     do {                                                                       \
210       if (logUnwinding())                                                      \
211         _LIBUNWIND_LOG(msg, __VA_ARGS__);                                      \
212     } while (0)
213   #define _LIBUNWIND_TRACE_DWARF(...)                                          \
214     do {                                                                       \
215       if (logDWARF())                                                          \
216         fprintf(stderr, __VA_ARGS__);                                          \
217     } while (0)
218 #endif
219 
220 #ifdef __cplusplus
221 // Used to fit UnwindCursor and Registers_xxx types against unw_context_t /
222 // unw_cursor_t sized memory blocks.
223 #if defined(_LIBUNWIND_IS_NATIVE_ONLY)
224 # define COMP_OP ==
225 #else
226 # define COMP_OP <=
227 #endif
228 template <typename _Type, typename _Mem>
229 struct check_fit {
230   template <typename T>
231   struct blk_count {
232     static const size_t count =
233       (sizeof(T) + sizeof(uint64_t) - 1) / sizeof(uint64_t);
234   };
235   static const bool does_fit =
236     (blk_count<_Type>::count COMP_OP blk_count<_Mem>::count);
237 };
238 #undef COMP_OP
239 #endif // __cplusplus
240 
241 #endif // LIBUNWIND_CONFIG_H
242