<div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr">Hi All,</div><div dir="ltr"><br></div><div dir="ltr">Happy 2021!<br><div><br></div><div>I've just posted a new Orc Runtime Preview patch: <a href="https://github.com/lhames/llvm-project/commit/8833a7f24693f1c7a3616438718e7927c6624894">https://github.com/lhames/llvm-project/commit/8833a7f24693f1c7a3616438718e7927c6624894</a></div><div><br></div><div>Quick background:</div><div><br></div><div>To date, neither ORC nor MCJIT have had their own runtime libraries. This has limited and complicated the implementation of many features (e.g. jit re-entry functions, exception handling, JID'd initializers and de-initializers), and more-or-less prevented the implementation of others (e.g. native thread local storage).</div><div><br></div><div>Late last year I started work on a prototype ORC runtime library to address this, and with the above commit I've finally got something worth sharing.</div><div><br></div><div>The prototype above is simultaneously limited and complex. Limited, in that it only tackles a small subset of the desired functionality. Complex in that it's one of the most involved pieces of functionality that I anticipate supporting, as it requires two-way communication between the executor and JIT processes. My aim in choosing to tackle the hard part first was to get a sense of our ultimate requirements for the project, particularly in regards to <i>where it should live within the LLVM Project</i>. It's not a perfect fit for LLVM proper: there will be lots of target specific code, including assembly, and it should be easily buildable for multiple targets (that sounds more like compiler-rt). On the other hand it's not a perfect fit for compiler-rt: it shares data structures with LLVM, and it would be very useful to be able to re-use llvm::Error  / llvm::Expected (that sounds like LLVM). At the moment I think the best way to square things would be to keep it in compiler-rt, allow inclusion of header-only code from LLVM in compiler-rt, and then make Error / Expected header-only (or copy / adapt them for this library). This will be a discussion for llvm-dev at some point in the near future.</div><div><br></div><div>On to the actual functionality though: The prototype makes significant changes to the MachOPlatform class and introduces an ORC runtime library in compiler-rt/lib/orc. Together, these changes allow us to emulate the dlopen / dlsym / dlclose in the JIT executor process. We can use this to define what it means to run a <i>JIT program</i>, rather than just running a JIT function (the way TargetProcessControl::runAsMain does):</div><div><br></div><div><div style="color:rgb(0,0,0)"><font face="monospace">ORC_RT_INTERFACE <font color="#38761d">int64_t</font> <font color="#0b5394">__orc_rt_macho_run_program</font>(<font color="#38761d">int</font> <font color="#bf9000">argc</font>, <font color="#38761d">char</font> *<font color="#bf9000">argv</font>[]) {</font></div><div style="color:rgb(0,0,0)"><font face="monospace">  <font color="#45818e">using</font> <font color="#38761d">MainTy</font> = <font color="#38761d">int</font> (*)(<font color="#38761d">int</font>, <font color="#38761d">char</font> *[]);</font></div><div style="color:rgb(0,0,0)"><font face="monospace"><br></font></div><div style="color:rgb(0,0,0)"><font face="monospace">  <font color="#38761d">void</font> *<font color="#bf9000">H</font> = __orc_rt_macho_jit_dlopen(<font color="#6aa84f">"Main"</font>, ORC_RT_RTLD_LAZY);</font></div><div style="color:rgb(0,0,0)"><font face="monospace">  <font color="#45818e">if</font> (!H) {</font></div><div style="color:rgb(0,0,0)"><font face="monospace">    __orc_rt_log_error(__orc_rt_macho_jit_dlerror());</font></div><div style="color:rgb(0,0,0)"><font face="monospace">    <font color="#45818e">return</font> -1;</font></div><div style="color:rgb(0,0,0)"><font face="monospace">  }</font></div><div style="color:rgb(0,0,0)"><font face="monospace"><br></font></div><div style="color:rgb(0,0,0)"><font face="monospace">  <font color="#45818e">auto</font> *<font color="#bf9000">Main</font> = <font color="#45818e">reinterpret_cast</font><<font color="#38761d">MainTy</font>>(__orc_rt_macho_jit_dlsym(H, <font color="#6aa84f">"main"</font>));</font></div><div style="color:rgb(0,0,0)"><font face="monospace">  <font color="#45818e">if</font> (!Main) {<br></font></div><div style="color:rgb(0,0,0)"><font face="monospace">    __orc_rt_log_error(__orc_rt_macho_jit_dlerror());</font></div><div style="color:rgb(0,0,0)"><font face="monospace">    <font color="#45818e">return</font> -1;</font></div><div style="color:rgb(0,0,0)"><font face="monospace">  }</font></div><div style="color:rgb(0,0,0)"><font face="monospace"><br></font></div><div style="color:rgb(0,0,0)"><font face="monospace">  <font color="#38761d">int</font> <font color="#bf9000">Result</font> = Main(argc, argv);</font></div><div style="color:rgb(0,0,0)"><font face="monospace"><br></font></div><div style="color:rgb(0,0,0)"><font face="monospace">  <font color="#45818e">if</font> (__orc_rt_macho_jit_dlclose(H) == -1)</font></div><div style="color:rgb(0,0,0)"><font face="monospace">    __orc_rt_log_error(__orc_rt_macho_jit_dlerror());</font></div><div style="color:rgb(0,0,0)"><font face="monospace"><br></font></div><div style="color:rgb(0,0,0)"><font face="monospace">  <font color="#45818e">return</font> Result;</font></div><div style="color:rgb(0,0,0)"><font face="monospace">}</font></div></div><div><br></div><div>The functions __orc_rt_macho_jit_dlopen, __orc_rt_macho_jit_dlsym, and __orc_rt_macho_jit_dlclose behave the same as their dlfcn.h counterparts (dlopen, dlsym, dlclose), but operate on JITDylibs rather than regular dylibs. This includes running static initializers and registering with language runtimes (e.g. ObjC). </div><div><br></div><div>While we could run static initializers before (e.g. via LLJIT::runConstructors), we had to initiate this from the JIT process side, which has two significant drawbacks: (1) Extra RPC round trips, and (2) in the out-of-process case: initializers not running on the executor thread that requested them, since that thread will be blocked waiting for its call to return. Issue (1) only affects performance, but (2) can affect correctness if the initializers modify thread local values, or interact with locks or threads. Interacting with threads from initializers is generally best avoided, but nonetheless is done by real-world code, so we want to support it. By using the runtime we can improve both performance and correctness (or at least consistency with current behavior). </div><div><br></div><div>The effect of this is that we can now load C++, Objective-C and Swift programs in the JIT and expect them to run correctly, at least for simple cases. This works regardless of whether the JIT'd code runs in-process or out-of-process. To test all this I have integrated support for the prototype runtime into llvm-jitlink. You can demo output from this tool below for two simple input programs: One swift, one C++. All of this is MachO specific at the moment, but provides a template that could be easily re-used to support this on ELF platforms, and likely on COFF platforms too.<br></div><div><br></div><div>While the discussion on where the runtime should live plays out I will continue adding / moving functionality to the prototype runtime. Next up will be eh-frame registration and resolver functions (both currently in OrcTargetProcess). After that I'll try to tackle support for native MachO thread local storage.</div><div><br></div><div>As always: Questions and comments are very welcome.</div><div><br></div><div>-- Lang.</div><div><br></div><div><div style="color:rgb(0,0,0)"><div><font face="monospace">lhames@Langs-MacBook-Pro scratch % cat foo.swift</font></div><div><font face="monospace">class MyClass {</font></div><div><font face="monospace">  func foo() {</font></div><div><font face="monospace">    print("foo")</font></div><div><font face="monospace">  }</font></div><div><font face="monospace">}</font></div><div><font face="monospace"><br></font></div><div><font face="monospace">let m = MyClass()</font></div><div><font face="monospace">m.foo();</font></div><div><font face="monospace"><br></font></div><div><font face="monospace">lhames@Langs-MacBook-Pro scratch % xcrun swiftc -emit-object -o foo.o foo.swift                                    </font></div><div><font face="monospace">lhames@Langs-MacBook-Pro scratch % llvm-jitlink -dlopen /usr/lib/swift/libswiftCore.dylib foo.o              </font></div><div><font face="monospace">foo</font></div><div><font face="monospace">lhames@Langs-MacBook-Pro scratch % llvm-jitlink -oop-executor -dlopen /usr/lib/swift/libswiftCore.dylib foo.o</font></div><div><font face="monospace">foo</font></div><div><font face="monospace">lhames@Langs-MacBook-Pro scratch % cat inits.cpp </font></div><div><font face="monospace">#include <iostream></font></div><div><font face="monospace"><br></font></div><div><font face="monospace">class Foo {</font></div><div><font face="monospace">public:</font></div><div><font face="monospace">  Foo() { std::cout << "Foo::Foo()\n"; }</font></div><div><font face="monospace">  ~Foo() { std::cout << "Foo::~Foo()\n"; }</font></div><div><font face="monospace">  void foo() { std::cout << "Foo::foo()\n"; }</font></div><div><font face="monospace">};</font></div><div><font face="monospace"><br></font></div><div><font face="monospace">Foo F;</font></div><div><font face="monospace"><br></font></div><div><font face="monospace">int main(int argc, char *argv[]) {</font></div><div><font face="monospace">  F.foo();</font></div><div><font face="monospace">  return 0;</font></div><div><font face="monospace">}</font></div><div><font face="monospace">lhames@Langs-MacBook-Pro scratch % xcrun clang++ -c -o inits.o inits.cpp</font></div><div><font face="monospace">lhames@Langs-MacBook-Pro scratch % llvm-jitlink inits.o                                                      </font></div><div><font face="monospace">Foo::Foo()</font></div><div><font face="monospace">Foo::foo()</font></div><div><font face="monospace">Foo::~Foo()</font></div><div><font face="monospace">lhames@Langs-MacBook-Pro scratch % llvm-jitlink -oop-executor inits.o</font></div><div><font face="monospace">Foo::Foo()</font></div><div><font face="monospace">Foo::foo()</font></div><div><font face="monospace">Foo::~Foo()</font></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div>