llvm-project.git/llvm/docs/tutorial/BuildingAJIT3.rst, branch users/nico/python-2

[ORC] Move most ORC APIs to ExecutorAddr, introduce ExecutorSymbolDef.

2023-03-28T00:37:58+00:00

ExecutorAddr was introduced in b8e5f918166 as an eventual replacement for
JITTargetAddress. ExecutorSymbolDef is introduced in this patch as a
replacement for JITEvaluatedSymbol: ExecutorSymbolDef is an (ExecutorAddr,
JITSymbolFlags) pair, where JITEvaluatedSymbol was a (JITTargetAddress,
JITSymbolFlags) pair.

A number of APIs had already migrated from JITTargetAddress to ExecutorAddr,
but many of ORC's internals were still using the older type. This patch aims
to address that.

Some public APIs are affected as well. If you need to migrate your APIs you can
use the following operations:

* ExecutorAddr::toPtr replaces jitTargetAddressToPointer and
  jitTargetAddressToFunction.

* ExecutorAddr::fromPtr replace pointerToJITTargetAddress.

* ExecutorAddr(JITTargetAddress) creates an ExecutorAddr value from a
  JITTargetAddress.

* ExecutorAddr::getValue() creates a JITTargetAddress value from an
  ExecutorAddr.

JITTargetAddress and JITEvaluatedSymbol will remain in JITSymbol.h for now, but
the aim will be to eventually deprecate and remove these types (probably when
MCJIT and RuntimeDyld are deprecated).

[docs] Add out-of-date warnings to the BuildingAJIT tutorial text.

2018-02-06T21:25:20+00:00

The text will be updated once the ORC API churn dies down.

llvm-svn: 324406

[ORC][Kaleidoscope] Update ORCJit tutorial.

2017-09-17T00:24:43+00:00

Summary: Fix a few typos and update names to match current source.

Differential Revision: https://reviews.llvm.org/D37948

llvm-svn: 313473

[BuildingAJIT] Fix a couple of typos in the Chapter 3 draft.

2016-08-08T18:09:56+00:00

llvm-svn: 278033

[ExecutionEngine][MCJIT][Orc] Replace RuntimeDyld::SymbolInfo with JITSymbol.

2016-08-01T20:49:11+00:00

This patch replaces RuntimeDyld::SymbolInfo with JITSymbol: A symbol class
that is capable of lazy materialization (i.e. the symbol definition needn't be
emitted until the address is requested). This can be used to support common
and weak symbols in the JIT (though this is not implemented in this patch).

For consistency, RuntimeDyld::SymbolResolver is renamed to JITSymbolResolver.

For space efficiency a new class, JITEvaluatedSymbol, is introduced that
behaves like the old RuntimeDyld::SymbolInfo - i.e. it is just a pair of an
address and symbol flags. Instances of JITEvaluatedSymbol can be used in
symbol-tables to avoid paying the space cost of the materializer.

llvm-svn: 277386

[Kaleidoscope][BuildingAJIT] More work on the text for Chapter 3.

2016-07-19T00:25:52+00:00

Add an overview of stubs and compile callbacks before the discussion of the
source changes.

-- This line, and those below, will be ignored--

M    docs/tutorial/BuildingAJIT3.rst

llvm-svn: 275933

Fixed errors in docs.

2016-07-18T14:13:18+00:00

llvm-svn: 275789

[Kaleidoscope][BuildingAJIT] Start filling in text for chapter 3.

2016-07-15T01:39:49+00:00

llvm-svn: 275518

[Kaleidoscope][BuildingAJIT] Fix strong emphasis markup by removing whitespace.

2016-05-26T21:21:18+00:00

llvm-svn: 270918

[Kaleidoscope][BuildingAJIT] Add docs for Chapter 3 of the Building A JIT

2016-05-26T21:17:06+00:00

tutorial.

llvm-svn: 270917