For Darwin/arm64 (including Apple Silicon Macs) this will enable exception
handling and stack unwinding in JIT'd code.
Darwin supports two unwind-info formats: DWARF eh-frames and compact-unwind. On
Darwin/x86-64 compilers usually produce both by default, and ORC supported
exceptions and unwinding via eh-frames (same as on Linux), discarding the
redundant compact-unwind info. On Darwin/arm64 compilers typically default to
producing compact-unwind only, with DWARF eh-frames as a fallback for functions
that can't be described in compact-unwind. Since ORC did not previously support
the compact-unwind format and eh-frames were not present ORC was unable to
handle exceptions or unwinding by default in Darwin/arm64 JIT'd code.
This patch enables support for the compact-unwind-info format, and contains
three major moving parts:
(1) The JITLink CompactUnwindManager class is responsible for transforming the
__compact_unwind records produced by the linker into the __unwind_info
tables that libunwind parses during unwinding. To enable this the
CompactUnwindManager class provides three JITLink passes: The
prepareForPrune pass that splits the __compact_unwind section into
single-record blocks, allowing unused records to be dead-stripped; the
processAndReserveUnwindInfo pass that reserves space for the final
__unwind_info section, and the writeUnwindInfo pass that writes the
__unwind_info section.
(2) The OrcTargetProcess UnwindInfoManager class maintains a table of
registered JIT'd __unwind_info and __eh_frame sections, and handles
requests from libunwind for unwind info sections (by registering a callback
with libunwind's __unw_add_find_dynamic_unwind_sections function).
(3) The Orc UnwindInfoRegistrationPlugin, which scans LinkGraphs for
__unwind_info and __eh_frame sections to register with the
UnwindInfoManager.
This commit adds the CompactUnwindManager passes to the default JITLink
pipelines for Darwin/arm64 and Darwin/x86-64, and UnwindInfoManager intances to
the SelfExecutorProcessControl class (when built for apple platforms) and the
llvm-jitlink-executor tool.
The LLJIT class will now create an UnwindInfoRegistrationPlugin when targeting
a process running on Darwin if it detects that an UnwindInfoManager is
available to handle the registrations.
The ORC runtime macho_platform class already supported libunwind callbacks, so
out-of-process execution and unwinding support will work when loading the ORC
runtime.
The llvm-jitlink tool will only support compact-unwind when the orc-runtime is
loaded, as the UnwindInfoRegistrationPlugin requires access to an IR compiler
to load a helper module and llvm-jitlink does not provide an IR compiler.
38 lines
859 B
CMake
38 lines
859 B
CMake
if( CMAKE_HOST_UNIX AND HAVE_LIBRT )
|
|
set(rt_lib rt)
|
|
endif()
|
|
|
|
set(intel_jit_profiling )
|
|
if( LLVM_USE_INTEL_JITEVENTS )
|
|
set(intel_jit_profiling IntelJITProfiling)
|
|
include_directories(${CMAKE_CURRENT_SOURCE_DIR}/../../IntelJITProfiling)
|
|
include_directories(${PROJECT_BINARY_DIR}/ittapi/include/ )
|
|
endif()
|
|
|
|
add_llvm_component_library(LLVMOrcTargetProcess
|
|
ExecutorSharedMemoryMapperService.cpp
|
|
JITLoaderGDB.cpp
|
|
JITLoaderPerf.cpp
|
|
JITLoaderVTune.cpp
|
|
OrcRTBootstrap.cpp
|
|
RegisterEHFrames.cpp
|
|
SimpleExecutorDylibManager.cpp
|
|
SimpleExecutorMemoryManager.cpp
|
|
SimpleRemoteEPCServer.cpp
|
|
TargetExecutionUtils.cpp
|
|
UnwindInfoManager.cpp
|
|
|
|
ADDITIONAL_HEADER_DIRS
|
|
${LLVM_MAIN_INCLUDE_DIR}/llvm/ExecutionEngine/Orc
|
|
|
|
LINK_LIBS
|
|
${LLVM_PTHREAD_LIB}
|
|
${rt_lib}
|
|
|
|
LINK_COMPONENTS
|
|
${intel_jit_profiling}
|
|
OrcShared
|
|
Support
|
|
TargetParser
|
|
)
|