1 /**************************************************************************
3 * Copyright 2009 VMware, Inc.
6 * Permission is hereby granted, free of charge, to any person obtaining a
7 * copy of this software and associated documentation files (the
8 * "Software"), to deal in the Software without restriction, including
9 * without limitation the rights to use, copy, modify, merge, publish,
10 * distribute, sub license, and/or sell copies of the Software, and to
11 * permit persons to whom the Software is furnished to do so, subject to
12 * the following conditions:
14 * The above copyright notice and this permission notice (including the
15 * next paragraph) shall be included in all copies or substantial portions
18 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
19 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
20 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
21 * IN NO EVENT SHALL VMWARE AND/OR ITS SUPPLIERS BE LIABLE FOR
22 * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
23 * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
24 * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
26 **************************************************************************/
32 * @author Jose Fonseca <jfonseca@vmware.com>
36 #include "u_debug_symbol.h"
37 #include "u_debug_stack.h"
39 #if defined(HAVE_LIBUNWIND)
47 debug_backtrace_capture(struct debug_stack_frame
*backtrace
,
52 unw_context_t context
;
57 pip
.unwind_info
= NULL
;
59 unw_getcontext(&context
);
60 unw_init_local(&cursor
, &context
);
62 while ((start_frame
> 0) && (unw_step(&cursor
) > 0))
65 while (unw_step(&cursor
) > 0) {
71 unw_get_proc_info(&cursor
, &pip
);
73 ret
= unw_get_proc_name(&cursor
, procname
, 256, &off
);
74 if (ret
&& ret
!= -UNW_ENOMEM
) {
79 if (dladdr((void *)(uintptr_t)(pip
.start_ip
+ off
), &dlinfo
) && dlinfo
.dli_fname
&&
81 filename
= dlinfo
.dli_fname
;
85 snprintf(backtrace
[i
].buf
, sizeof(backtrace
[i
].buf
),
86 "%u: %s (%s%s+0x%x) [%p]", i
, filename
, procname
,
87 ret
== -UNW_ENOMEM
? "..." : "", (int)off
,
88 (void *)(uintptr_t)(pip
.start_ip
+ off
));
93 while (i
< nr_frames
) {
94 backtrace
[i
].buf
[0] = '\0';
100 debug_backtrace_dump(const struct debug_stack_frame
*backtrace
,
105 for (i
= 0; i
< nr_frames
; ++i
) {
106 if (backtrace
[i
].buf
[0] == '\0')
108 debug_printf("\t%s\n", backtrace
[i
].buf
);
113 debug_backtrace_print(FILE *f
,
114 const struct debug_stack_frame
*backtrace
,
119 for (i
= 0; i
< nr_frames
; ++i
) {
120 if (backtrace
[i
].buf
[0] == '\0')
122 fprintf(f
, "\t%s\n", backtrace
[i
].buf
);
126 #else /* ! HAVE_LIBUNWIND */
128 #if defined(PIPE_OS_WINDOWS)
134 * Capture stack backtrace.
136 * NOTE: The implementation of this function is quite big, but it is important
137 * not to break it down in smaller functions to avoid adding new frames to the
141 debug_backtrace_capture(struct debug_stack_frame
*backtrace
,
142 unsigned start_frame
,
145 const void **frame_pointer
= NULL
;
153 * On Windows try obtaining the stack backtrace via CaptureStackBackTrace.
155 * It works reliably both for x86 for x86_64.
157 #if defined(PIPE_OS_WINDOWS)
159 typedef USHORT (WINAPI
*PFNCAPTURESTACKBACKTRACE
)(ULONG
, ULONG
,
161 static PFNCAPTURESTACKBACKTRACE pfnCaptureStackBackTrace
= NULL
;
163 if (!pfnCaptureStackBackTrace
) {
164 static HMODULE hModule
= NULL
;
166 hModule
= LoadLibraryA("kernel32");
170 pfnCaptureStackBackTrace
=
171 (PFNCAPTURESTACKBACKTRACE
)GetProcAddress(hModule
,
172 "RtlCaptureStackBackTrace");
175 if (pfnCaptureStackBackTrace
) {
177 * Skip this (debug_backtrace_capture) function's frame.
182 assert(start_frame
+ nr_frames
< 63);
183 i
= pfnCaptureStackBackTrace(start_frame
, nr_frames
,
184 (PVOID
*) &backtrace
->function
, NULL
);
186 /* Pad remaing requested frames with NULL */
187 while (i
< nr_frames
) {
188 backtrace
[i
++].function
= NULL
;
196 #if defined(PIPE_CC_GCC)
197 frame_pointer
= ((const void **)__builtin_frame_address(1));
198 #elif defined(PIPE_CC_MSVC) && defined(PIPE_ARCH_X86)
200 mov frame_pointer
, ebp
202 frame_pointer
= (const void **)frame_pointer
[0];
204 frame_pointer
= NULL
;
209 const void **next_frame_pointer
;
217 backtrace
[i
++].function
= frame_pointer
[1];
221 next_frame_pointer
= (const void **)frame_pointer
[0];
223 /* Limit the stack walk to avoid referencing undefined memory */
224 if ((uintptr_t)next_frame_pointer
<= (uintptr_t)frame_pointer
||
225 (uintptr_t)next_frame_pointer
> (uintptr_t)frame_pointer
+ 64*1024)
228 frame_pointer
= next_frame_pointer
;
231 (void) frame_pointer
;
235 backtrace
[i
++].function
= NULL
;
242 debug_backtrace_dump(const struct debug_stack_frame
*backtrace
,
247 for (i
= 0; i
< nr_frames
; ++i
) {
248 if (!backtrace
[i
].function
)
250 debug_symbol_print(backtrace
[i
].function
);
256 debug_backtrace_print(FILE *f
,
257 const struct debug_stack_frame
*backtrace
,
262 for (i
= 0; i
< nr_frames
; ++i
) {
264 if (!backtrace
[i
].function
)
266 symbol
= debug_symbol_name_cached(backtrace
[i
].function
);
268 fprintf(f
, "%s\n", symbol
);
272 #endif /* HAVE_LIBUNWIND */