Extend coroutines to support a "returned continuation" lowering.

Authored by rjmccall on Aug 13 2019, 8:53 PM.


Extend coroutines to support a "returned continuation" lowering.

A quick contrast of this ABI with the currently-implemented ABI:

  • Allocation is implicitly managed by the lowering passes, which is fine for frontends that are fine with assuming that allocation cannot fail. This assumption is necessary to implement dynamic allocas anyway.
  • The lowering attempts to fit the coroutine frame into an opaque, statically-sized buffer before falling back on allocation; the same buffer must be provided to every resume point. A buffer must be at least pointer-sized.
  • The resume and destroy functions have been combined; the continuation function takes a parameter indicating whether it has succeeded.
  • Conversely, every suspend point begins its own continuation function.
  • The continuation function pointer is directly returned to the caller instead of being stored in the frame. The continuation can therefore directly destroy the frame when exiting the coroutine instead of having to leave it in a defunct state.
  • Other values can be returned directly to the caller instead of going through a promise allocation. The frontend provides a "prototype" function declaration from which the type, calling convention, and attributes of the continuation functions are taken.
  • On the caller side, the frontend can generate natural IR that directly uses the continuation functions as long as it prevents IPO with the coroutine until lowering has happened. In combination with the point above, the frontend is almost totally in charge of the ABI of the coroutine.
  • Unique-yield coroutines are given some special treatment.

llvm-svn: 368788


rjmccallAug 13 2019, 8:53 PM
rGdbb757f46205: [FileCheck] Document FILECHECK_OPTS in -help