libunwind.cpp revision 6dc154019d5f0997d7df1d9e9f3ba1425396dcd8
1b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik//===--------------------------- libuwind.cpp -----------------------------===// 2b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik// 3b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik// The LLVM Compiler Infrastructure 4b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik// 5b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik// This file is dual licensed under the MIT and the University of Illinois Open 6b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik// Source Licenses. See LICENSE.TXT for details. 7b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik// 8b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik// 9b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik// Implements unw_* functions from <libunwind.h> 10b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik// 11b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik//===----------------------------------------------------------------------===// 12b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 13b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik#include <libunwind.h> 14b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 15b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik#include <new> 16b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 17b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik#include "libunwind_ext.h" 18b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik#include "config.h" 19b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 20b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 21b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik#if _LIBUNWIND_BUILD_ZERO_COST_APIS 22b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 23b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik#include "UnwindCursor.hpp" 24b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 25b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzikusing namespace libunwind; 26b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 27b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik/// internal object to represent this processes address space 28b78da9875b6e35187b5d584746c78faaf3230a3dNick KledzikLocalAddressSpace LocalAddressSpace::sThisAddressSpace; 29b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 30b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik/// record the registers and stack position of the caller 31b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzikextern int unw_getcontext(unw_context_t *); 32b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik// note: unw_getcontext() implemented in assembly 33b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 34b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik/// Create a cursor of a thread in this process given 'context' recorded by 35b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik/// unw_getcontext(). 36b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik_LIBUNWIND_EXPORT int unw_init_local(unw_cursor_t *cursor, 37b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik unw_context_t *context) { 38b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik _LIBUNWIND_TRACE_API("unw_init_local(cursor=%p, context=%p)\n", 39b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik cursor, context); 40b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik // Use "placement new" to allocate UnwindCursor in the cursor buffer. 41b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik#if __i386__ 42b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik new ((void *)cursor) UnwindCursor<LocalAddressSpace, Registers_x86>( 43b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik context, LocalAddressSpace::sThisAddressSpace); 44b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik#elif __x86_64__ 45b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik new ((void *)cursor) UnwindCursor<LocalAddressSpace, Registers_x86_64>( 46b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik context, LocalAddressSpace::sThisAddressSpace); 47b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik#elif __ppc__ 48b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik new ((void *)cursor) UnwindCursor<LocalAddressSpace, Registers_ppc>( 49b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik context, LocalAddressSpace::sThisAddressSpace); 50b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik#elif __arm64__ 51b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik new ((void *)cursor) UnwindCursor<LocalAddressSpace, Registers_arm64>( 52b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik context, LocalAddressSpace::sThisAddressSpace); 53b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik#endif 54b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik AbstractUnwindCursor *co = (AbstractUnwindCursor *)cursor; 55b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik co->setInfoBasedOnIPRegister(); 56b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 57b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik return UNW_ESUCCESS; 58b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik} 59b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 60b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik#if UNW_REMOTE 61b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 62b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik_LIBUNWIND_EXPORT unw_addr_space_t unw_local_addr_space = 63b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik (unw_addr_space_t) & sThisAddressSpace; 64b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 65b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik/// Create a cursor into a thread in another process. 66b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik_LIBUNWIND_EXPORT int unw_init_remote_thread(unw_cursor_t *cursor, 67b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik unw_addr_space_t as, 686dc154019d5f0997d7df1d9e9f3ba1425396dcd8Nick Kledzik void *arg) { 69b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik // special case: unw_init_remote(xx, unw_local_addr_space, xx) 70b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik if (as == (unw_addr_space_t) & sThisAddressSpace) 71b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik return unw_init_local(cursor, NULL); //FIXME 72b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 73b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik // use "placement new" to allocate UnwindCursor in the cursor buffer 74b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik switch (as->cpuType) { 75b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik case CPU_TYPE_I386: 76b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik new ((void *)cursor) 77b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik UnwindCursor<OtherAddressSpace<Pointer32<LittleEndian> >, 786dc154019d5f0997d7df1d9e9f3ba1425396dcd8Nick Kledzik Registers_x86>(((unw_addr_space_i386 *)as)->oas, arg); 79b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik break; 80b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik case CPU_TYPE_X86_64: 81b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik new ((void *)cursor) UnwindCursor< 82b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik OtherAddressSpace<Pointer64<LittleEndian> >, Registers_x86_64>( 836dc154019d5f0997d7df1d9e9f3ba1425396dcd8Nick Kledzik ((unw_addr_space_x86_64 *)as)->oas, arg); 84b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik break; 85b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik case CPU_TYPE_POWERPC: 86b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik new ((void *)cursor) 87b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik UnwindCursor<OtherAddressSpace<Pointer32<BigEndian> >, Registers_ppc>( 886dc154019d5f0997d7df1d9e9f3ba1425396dcd8Nick Kledzik ((unw_addr_space_ppc *)as)->oas, arg); 89b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik break; 90b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik default: 91b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik return UNW_EUNSPEC; 92b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik } 93b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik return UNW_ESUCCESS; 94b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik} 95b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 96b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 97b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzikstatic bool is64bit(task_t task) { 98b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik return false; // FIXME 99b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik} 100b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 101b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik/// Create an address_space object for use in examining another task. 102b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik_LIBUNWIND_EXPORT unw_addr_space_t unw_create_addr_space_for_task(task_t task) { 103b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik#if __i386__ 104b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik if (is64bit(task)) { 105b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik unw_addr_space_x86_64 *as = new unw_addr_space_x86_64(task); 106b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik as->taskPort = task; 107b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik as->cpuType = CPU_TYPE_X86_64; 108b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik //as->oas 109b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik } else { 110b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik unw_addr_space_i386 *as = new unw_addr_space_i386(task); 111b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik as->taskPort = task; 112b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik as->cpuType = CPU_TYPE_I386; 113b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik //as->oas 114b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik } 115b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik#else 116b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik// FIXME 117b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik#endif 118b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik} 119b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 120b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 121b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik/// Delete an address_space object. 122b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik_LIBUNWIND_EXPORT void unw_destroy_addr_space(unw_addr_space_t asp) { 123b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik switch (asp->cpuType) { 124b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik#if __i386__ || __x86_64__ 125b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik case CPU_TYPE_I386: { 126b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik unw_addr_space_i386 *as = (unw_addr_space_i386 *)asp; 127b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik delete as; 128b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik } 129b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik break; 130b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik case CPU_TYPE_X86_64: { 131b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik unw_addr_space_x86_64 *as = (unw_addr_space_x86_64 *)asp; 132b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik delete as; 133b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik } 134b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik break; 135b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik#endif 136b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik case CPU_TYPE_POWERPC: { 137b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik unw_addr_space_ppc *as = (unw_addr_space_ppc *)asp; 138b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik delete as; 139b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik } 140b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik break; 141b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik } 142b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik} 143b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik#endif // UNW_REMOTE 144b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 145b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 146b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik/// Get value of specified register at cursor position in stack frame. 147b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik_LIBUNWIND_EXPORT int unw_get_reg(unw_cursor_t *cursor, unw_regnum_t regNum, 148b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik unw_word_t *value) { 149b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik _LIBUNWIND_TRACE_API("unw_get_reg(cursor=%p, regNum=%d, &value=%p)\n", 150b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik cursor, regNum, value); 151b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik AbstractUnwindCursor *co = (AbstractUnwindCursor *)cursor; 152b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik if (co->validReg(regNum)) { 153b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik *value = co->getReg(regNum); 154b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik return UNW_ESUCCESS; 155b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik } 156b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik return UNW_EBADREG; 157b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik} 158b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 159b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 160b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik/// Set value of specified register at cursor position in stack frame. 161b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik_LIBUNWIND_EXPORT int unw_set_reg(unw_cursor_t *cursor, unw_regnum_t regNum, 162b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik unw_word_t value) { 163b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik _LIBUNWIND_TRACE_API("unw_set_reg(cursor=%p, regNum=%d, value=0x%llX)\n", 164b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik cursor, regNum, value); 165b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik typedef LocalAddressSpace::pint_t pint_t; 166b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik AbstractUnwindCursor *co = (AbstractUnwindCursor *)cursor; 167b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik if (co->validReg(regNum)) { 168b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik co->setReg(regNum, (pint_t)value); 169b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik // specical case altering IP to re-find info (being called by personality 170b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik // function) 171b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik if (regNum == UNW_REG_IP) { 172b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik unw_proc_info_t info; 173b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik co->getInfo(&info); 174b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik pint_t orgArgSize = (pint_t)info.gp; 175b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik uint64_t orgFuncStart = info.start_ip; 176b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik co->setInfoBasedOnIPRegister(false); 177b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik // and adjust REG_SP if there was a DW_CFA_GNU_args_size 178b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik if ((orgFuncStart == info.start_ip) && (orgArgSize != 0)) 179b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik co->setReg(UNW_REG_SP, co->getReg(UNW_REG_SP) + orgArgSize); 180b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik } 181b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik return UNW_ESUCCESS; 182b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik } 183b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik return UNW_EBADREG; 184b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik} 185b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 186b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 187b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik/// Get value of specified float register at cursor position in stack frame. 188b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik_LIBUNWIND_EXPORT int unw_get_fpreg(unw_cursor_t *cursor, unw_regnum_t regNum, 189b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik unw_fpreg_t *value) { 190b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik _LIBUNWIND_TRACE_API("unw_get_fpreg(cursor=%p, regNum=%d, &value=%p)\n", 191b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik cursor, regNum, value); 192b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik AbstractUnwindCursor *co = (AbstractUnwindCursor *)cursor; 193b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik if (co->validFloatReg(regNum)) { 194b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik *value = co->getFloatReg(regNum); 195b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik return UNW_ESUCCESS; 196b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik } 197b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik return UNW_EBADREG; 198b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik} 199b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 200b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 201b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik/// Set value of specified float register at cursor position in stack frame. 202b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik_LIBUNWIND_EXPORT int unw_set_fpreg(unw_cursor_t *cursor, unw_regnum_t regNum, 203b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik unw_fpreg_t value) { 204b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik _LIBUNWIND_TRACE_API("unw_set_fpreg(cursor=%p, regNum=%d, value=%g)\n", 205b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik cursor, regNum, value); 206b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik AbstractUnwindCursor *co = (AbstractUnwindCursor *)cursor; 207b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik if (co->validFloatReg(regNum)) { 208b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik co->setFloatReg(regNum, value); 209b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik return UNW_ESUCCESS; 210b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik } 211b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik return UNW_EBADREG; 212b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik} 213b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 214b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 215b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik/// Move cursor to next frame. 216b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik_LIBUNWIND_EXPORT int unw_step(unw_cursor_t *cursor) { 217b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik _LIBUNWIND_TRACE_API("unw_step(cursor=%p)\n", cursor); 218b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik AbstractUnwindCursor *co = (AbstractUnwindCursor *)cursor; 219b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik return co->step(); 220b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik} 221b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 222b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 223b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik/// Get unwind info at cursor position in stack frame. 224b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik_LIBUNWIND_EXPORT int unw_get_proc_info(unw_cursor_t *cursor, 225b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik unw_proc_info_t *info) { 226b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik _LIBUNWIND_TRACE_API("unw_get_proc_info(cursor=%p, &info=%p)\n", 227b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik cursor, info); 228b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik AbstractUnwindCursor *co = (AbstractUnwindCursor *)cursor; 229b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik co->getInfo(info); 230b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik if (info->end_ip == 0) 231b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik return UNW_ENOINFO; 232b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik else 233b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik return UNW_ESUCCESS; 234b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik} 235b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 236b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 237b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik/// Resume execution at cursor position (aka longjump). 238b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik_LIBUNWIND_EXPORT int unw_resume(unw_cursor_t *cursor) { 239b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik _LIBUNWIND_TRACE_API("unw_resume(cursor=%p)\n", cursor); 240b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik AbstractUnwindCursor *co = (AbstractUnwindCursor *)cursor; 241b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik co->jumpto(); 242b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik return UNW_EUNSPEC; 243b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik} 244b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 245b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 246b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik/// Get name of function at cursor position in stack frame. 247b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik_LIBUNWIND_EXPORT int unw_get_proc_name(unw_cursor_t *cursor, char *buf, 248b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik size_t bufLen, unw_word_t *offset) { 249b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik _LIBUNWIND_TRACE_API("unw_get_proc_name(cursor=%p, &buf=%p," 250b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik "bufLen=%ld)\n", cursor, buf, bufLen); 251b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik AbstractUnwindCursor *co = (AbstractUnwindCursor *)cursor; 252b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik if (co->getFunctionName(buf, bufLen, offset)) 253b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik return UNW_ESUCCESS; 254b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik else 255b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik return UNW_EUNSPEC; 256b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik} 257b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 258b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 259b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik/// Checks if a register is a floating-point register. 260b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik_LIBUNWIND_EXPORT int unw_is_fpreg(unw_cursor_t *cursor, unw_regnum_t regNum) { 261b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik _LIBUNWIND_TRACE_API("unw_is_fpreg(cursor=%p, regNum=%d)\n", 262b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik cursor, regNum); 263b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik AbstractUnwindCursor *co = (AbstractUnwindCursor *)cursor; 264b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik return co->validFloatReg(regNum); 265b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik} 266b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 267b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 268b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik/// Checks if a register is a floating-point register. 269b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik_LIBUNWIND_EXPORT const char *unw_regname(unw_cursor_t *cursor, 270b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik unw_regnum_t regNum) { 271b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik _LIBUNWIND_TRACE_API("unw_regname(cursor=%p, regNum=%d)\n", 272b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik cursor, regNum); 273b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik AbstractUnwindCursor *co = (AbstractUnwindCursor *)cursor; 274b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik return co->getRegisterName(regNum); 275b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik} 276b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 277b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 278b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik/// Checks if current frame is signal trampoline. 279b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik_LIBUNWIND_EXPORT int unw_is_signal_frame(unw_cursor_t *cursor) { 280b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik _LIBUNWIND_TRACE_API("unw_is_signal_frame(cursor=%p)\n", cursor); 281b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik AbstractUnwindCursor *co = (AbstractUnwindCursor *)cursor; 282b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik return co->isSignalFrame(); 283b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik} 284b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 285b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 286b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik#if _LIBUNWIND_SUPPORT_DWARF_UNWIND 287b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik/// SPI: walks cached dwarf entries 288b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik_LIBUNWIND_EXPORT void unw_iterate_dwarf_unwind_cache(void (*func)( 289b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik unw_word_t ip_start, unw_word_t ip_end, unw_word_t fde, unw_word_t mh)) { 290b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik _LIBUNWIND_TRACE_API("unw_iterate_dwarf_unwind_cache(func=%p)\n", func); 291b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik DwarfFDECache<LocalAddressSpace>::iterateCacheEntries(func); 292b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik} 293b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 294b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 295b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik/// IPI: for __register_frame() 296b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzikvoid _unw_add_dynamic_fde(unw_word_t fde) { 297b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik CFI_Parser<LocalAddressSpace>::FDE_Info fdeInfo; 298b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik CFI_Parser<LocalAddressSpace>::CIE_Info cieInfo; 299b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik const char *message = CFI_Parser<LocalAddressSpace>::decodeFDE( 300b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik LocalAddressSpace::sThisAddressSpace, 301b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik (LocalAddressSpace::pint_t) fde, &fdeInfo, &cieInfo); 302b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik if (message == NULL) { 303b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik // dynamically registered FDEs don't have a mach_header group they are in. 304b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik // Use fde as mh_group 305b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik unw_word_t mh_group = fdeInfo.fdeStart; 306b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik DwarfFDECache<LocalAddressSpace>::add((LocalAddressSpace::pint_t)mh_group, 307b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik fdeInfo.pcStart, fdeInfo.pcEnd, 308b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik fdeInfo.fdeStart); 309b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik } else { 310b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik _LIBUNWIND_DEBUG_LOG("_unw_add_dynamic_fde: bad fde: %s", message); 311b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik } 312b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik} 313b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 314b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik/// IPI: for __deregister_frame() 315b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzikvoid _unw_remove_dynamic_fde(unw_word_t fde) { 316b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik // fde is own mh_group 317b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik DwarfFDECache<LocalAddressSpace>::removeAllIn((LocalAddressSpace::pint_t)fde); 318b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik} 319b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik#endif // _LIBUNWIND_SUPPORT_DWARF_UNWIND 320b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 321b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik#endif // _LIBUNWIND_BUILD_ZERO_COST_APIS 322b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 323b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 324b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 325b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik// Add logging hooks in Debug builds only 326b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik#ifndef NDEBUG 327b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 328b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik_LIBUNWIND_HIDDEN 329b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzikbool logAPIs() { 330b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik // do manual lock to avoid use of _cxa_guard_acquire or initializers 331b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik static bool checked = false; 332b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik static bool log = false; 333b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik if (!checked) { 334b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik log = (getenv("LIBUNWIND_PRINT_APIS") != NULL); 335b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik checked = true; 336b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik } 337b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik return log; 338b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik} 339b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 340b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik_LIBUNWIND_HIDDEN 341b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzikbool logUnwinding() { 342b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik // do manual lock to avoid use of _cxa_guard_acquire or initializers 343b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik static bool checked = false; 344b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik static bool log = false; 345b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik if (!checked) { 346b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik log = (getenv("LIBUNWIND_PRINT_UNWINDING") != NULL); 347b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik checked = true; 348b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik } 349b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik return log; 350b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik} 351b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 352b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik#endif // NDEBUG 353b78da9875b6e35187b5d584746c78faaf3230a3dNick Kledzik 354