• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1=============================================================================
2Building a JIT: Remote-JITing -- Process Isolation and Laziness at a Distance
3=============================================================================
4
5.. contents::
6   :local:
7
8**This tutorial is under active development. It is incomplete and details may
9change frequently.** Nonetheless we invite you to try it out as it stands, and
10we welcome any feedback.
11
12Chapter 5 Introduction
13======================
14
15Welcome to Chapter 5 of the "Building an ORC-based JIT in LLVM" tutorial. This
16chapter introduces the ORC RemoteJIT Client/Server APIs and shows how to use
17them to build a JIT stack that will execute its code via a communications
18channel with a different process. This can be a separate process on the same
19machine, a process on a different machine, or even a process on a different
20platform/architecture. The code builds on top of the lazy-AST-compiling JIT
21stack from `Chapter 4 <BuildingAJIT3.html>`_.
22
23**To be done -- this is going to be a long one:**
24
25**(1) Introduce channels, RPC, RemoteJIT Client and Server APIs**
26
27**(2) Describe the client code in greater detail. Discuss modifications of the
28KaleidoscopeJIT class, and the REPL itself.**
29
30**(3) Describe the server code.**
31
32**(4) Describe how to run the demo.**
33
34Full Code Listing
35=================
36
37Here is the complete code listing for our running example that JITs lazily from
38Kaleidoscope ASTS. To build this example, use:
39
40.. code-block:: bash
41
42    # Compile
43    clang++ -g toy.cpp `llvm-config --cxxflags --ldflags --system-libs --libs core orcjit native` -O3 -o toy
44    clang++ -g Server/server.cpp `llvm-config --cxxflags --ldflags --system-libs --libs core orcjit native` -O3 -o toy-server
45    # Run
46    ./toy-server &
47    ./toy
48
49Here is the code for the modified KaleidoscopeJIT:
50
51.. literalinclude:: ../../examples/Kaleidoscope/BuildingAJIT/Chapter5/KaleidoscopeJIT.h
52   :language: c++
53
54And the code for the JIT server:
55
56.. literalinclude:: ../../examples/Kaleidoscope/BuildingAJIT/Chapter5/Server/server.cpp
57   :language: c++
58