llvm/include/llvm-c
David Majnemer 8cec2f2816 [IR] Reformulate LLVM's EH funclet IR
While we have successfully implemented a funclet-oriented EH scheme on
top of LLVM IR, our scheme has some notable deficiencies:
- catchendpad and cleanupendpad are necessary in the current design
  but they are difficult to explain to others, even to seasoned LLVM
  experts.
- catchendpad and cleanupendpad are optimization barriers.  They cannot
  be split and force all potentially throwing call-sites to be invokes.
  This has a noticable effect on the quality of our code generation.
- catchpad, while similar in some aspects to invoke, is fairly awkward.
  It is unsplittable, starts a funclet, and has control flow to other
  funclets.
- The nesting relationship between funclets is currently a property of
  control flow edges.  Because of this, we are forced to carefully
  analyze the flow graph to see if there might potentially exist illegal
  nesting among funclets.  While we have logic to clone funclets when
  they are illegally nested, it would be nicer if we had a
  representation which forbade them upfront.

Let's clean this up a bit by doing the following:
- Instead, make catchpad more like cleanuppad and landingpad: no control
  flow, just a bunch of simple operands;  catchpad would be splittable.
- Introduce catchswitch, a control flow instruction designed to model
  the constraints of funclet oriented EH.
- Make funclet scoping explicit by having funclet instructions consume
  the token produced by the funclet which contains them.
- Remove catchendpad and cleanupendpad.  Their presence can be inferred
  implicitly using coloring information.

N.B.  The state numbering code for the CLR has been updated but the
veracity of it's output cannot be spoken for.  An expert should take a
look to make sure the results are reasonable.

Reviewers: rnk, JosephTremoulet, andrew.w.kaylor

Differential Revision: http://reviews.llvm.org/D15139

git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@255422 91177308-0d34-0410-b5e6-96231b3b80d8
2015-12-12 05:38:55 +00:00
..
Transforms [BDCE] Add a bit-tracking DCE pass 2015-02-17 01:36:59 +00:00
Analysis.h Organize LLVM C API docs into doxygen modules; add docs 2012-03-21 03:54:29 +00:00
BitReader.h Canonicalize header guards into a common format. 2014-08-13 16:26:38 +00:00
BitWriter.h Introduce LLVMWriteBitcodeToMemoryBuffer C API function. 2014-10-14 00:30:59 +00:00
Core.h [IR] Reformulate LLVM's EH funclet IR 2015-12-12 05:38:55 +00:00
Disassembler.h Extend C disassembler API to allow specifying target features 2014-09-30 16:31:40 +00:00
ExecutionEngine.h [C API] Expose LLVMGetGlobalValueAddress and LLVMGetFunctionAddress. 2014-12-22 18:53:11 +00:00
Initialization.h Canonicalize header guards into a common format. 2014-08-13 16:26:38 +00:00
IRReader.h Fix known typos 2014-01-24 17:20:08 +00:00
Linker.h Restore LLVMLinkModules C API until it is properly deprecated. 2015-03-02 18:59:38 +00:00
LinkTimeOptimizer.h include/llvm-c: Whitespace. 2013-10-23 17:56:29 +00:00
lto.h LTO: Simplify merged module ownership. 2015-08-24 22:22:53 +00:00
module.modulemap [modules] The LLVM C API does not require C++! 2014-06-12 22:09:39 +00:00
Object.h Remove getRelocationAddress. 2015-07-06 14:55:37 +00:00
OrcBindings.h Revert "Revert "[Orc] Directly emit machine code for the x86 resolver block and trampolines."" 2015-11-03 16:40:37 +00:00
Support.h Add more wrappers for symbol APIs to the C API. 2015-06-09 15:57:30 +00:00
Target.h [llvm-c] Remove dead typedef 2013-11-11 14:47:01 +00:00
TargetMachine.h Add target analysis passes to the codegen pipeline for MCJIT. 2014-01-23 19:23:28 +00:00