Skip to content

Commit 88271c3

Browse files
weliveindetailweliveindetail
committed
[clang-repl] Add CreateJITBuilder() for specialization in derived classes
The LLJITBuilder interface provides a very convenient way to configure the JIT.
1 parent bde7a6b commit 88271c3

File tree

5 files changed

+175
-21
lines changed

5 files changed

+175
-21
lines changed

‎clang/include/clang/Interpreter/Interpreter.h

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,9 @@
2929

3030
namespace llvm {
3131
namespace orc {
32+
class JITTargetMachineBuilder;
3233
class LLJIT;
34+
class LLJITBuilder;
3335
class ThreadSafeContext;
3436
} // namespace orc
3537
} // namespace llvm
@@ -127,6 +129,13 @@ class Interpreter {
127129
// custom runtime.
128130
virtual std::unique_ptr<RuntimeInterfaceBuilder> FindRuntimeInterface();
129131

132+
// Lazily construct thev ORCv2 JITBuilder. This called when the internal
133+
// IncrementalExecutor is created. The default implementation populates an
134+
// in-process JIT with debugging support. Override this to configure the JIT
135+
// engine used for execution.
136+
virtual llvm::Expected<std::unique_ptr<llvm::orc::LLJITBuilder>>
137+
CreateJITBuilder(CompilerInstance &CI);
138+
130139
public:
131140
virtual ~Interpreter();
132141

‎clang/lib/Interpreter/IncrementalExecutor.cpp

Lines changed: 18 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,7 @@
2020
#include "llvm/ExecutionEngine/Orc/Debugging/DebuggerSupport.h"
2121
#include "llvm/ExecutionEngine/Orc/ExecutionUtils.h"
2222
#include "llvm/ExecutionEngine/Orc/IRCompileLayer.h"
23+
#include "llvm/ExecutionEngine/Orc/JITTargetMachineBuilder.h"
2324
#include "llvm/ExecutionEngine/Orc/LLJIT.h"
2425
#include "llvm/ExecutionEngine/Orc/RTDyldObjectLinkingLayer.h"
2526
#include "llvm/ExecutionEngine/Orc/TargetProcess/JITLoaderGDB.h"
@@ -36,26 +37,28 @@ LLVM_ATTRIBUTE_USED void linkComponents() {
3637

3738
namespace clang {
3839

40+
llvm::Expected<std::unique_ptr<llvm::orc::LLJITBuilder>>
41+
IncrementalExecutor::createDefaultJITBuilder(
42+
llvm::orc::JITTargetMachineBuilder JTMB) {
43+
auto JITBuilder = std::make_unique<llvm::orc::LLJITBuilder>();
44+
JITBuilder->setJITTargetMachineBuilder(std::move(JTMB));
45+
JITBuilder->setPrePlatformSetup([](llvm::orc::LLJIT &J) {
46+
// Try to enable debugging of JIT'd code (only works with JITLink for
47+
// ELF and MachO).
48+
consumeError(llvm::orc::enableDebuggerSupport(J));
49+
return llvm::Error::success();
50+
});
51+
return std::move(JITBuilder);
52+
}
53+
3954
IncrementalExecutor::IncrementalExecutor(llvm::orc::ThreadSafeContext &TSC,
40-
llvm::Error &Err,
41-
const clang::TargetInfo &TI)
55+
llvm::orc::LLJITBuilder &JITBuilder,
56+
llvm::Error &Err)
4257
: TSCtx(TSC) {
4358
using namespace llvm::orc;
4459
llvm::ErrorAsOutParameter EAO(&Err);
4560

46-
auto JTMB = JITTargetMachineBuilder(TI.getTriple());
47-
JTMB.addFeatures(TI.getTargetOpts().Features);
48-
LLJITBuilder Builder;
49-
Builder.setJITTargetMachineBuilder(JTMB);
50-
Builder.setPrePlatformSetup(
51-
[](LLJIT &J) {
52-
// Try to enable debugging of JIT'd code (only works with JITLink for
53-
// ELF and MachO).
54-
consumeError(enableDebuggerSupport(J));
55-
return llvm::Error::success();
56-
});
57-
58-
if (auto JitOrErr = Builder.create())
61+
if (auto JitOrErr = JITBuilder.create())
5962
Jit = std::move(*JitOrErr);
6063
else {
6164
Err = JitOrErr.takeError();

‎clang/lib/Interpreter/IncrementalExecutor.h

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,9 @@
2323
namespace llvm {
2424
class Error;
2525
namespace orc {
26+
class JITTargetMachineBuilder;
2627
class LLJIT;
28+
class LLJITBuilder;
2729
class ThreadSafeContext;
2830
} // namespace orc
2931
} // namespace llvm
@@ -44,8 +46,8 @@ class IncrementalExecutor {
4446
public:
4547
enum SymbolNameKind { IRName, LinkerName };
4648

47-
IncrementalExecutor(llvm::orc::ThreadSafeContext &TSC, llvm::Error &Err,
48-
const clang::TargetInfo &TI);
49+
IncrementalExecutor(llvm::orc::ThreadSafeContext &TSC,
50+
llvm::orc::LLJITBuilder &JITBuilder, llvm::Error &Err);
4951
~IncrementalExecutor();
5052

5153
llvm::Error addModule(PartialTranslationUnit &PTU);
@@ -56,6 +58,9 @@ class IncrementalExecutor {
5658
getSymbolAddress(llvm::StringRef Name, SymbolNameKind NameKind) const;
5759

5860
llvm::orc::LLJIT &GetExecutionEngine() { return *Jit; }
61+
62+
static llvm::Expected<std::unique_ptr<llvm::orc::LLJITBuilder>>
63+
createDefaultJITBuilder(llvm::orc::JITTargetMachineBuilder JTMB);
5964
};
6065

6166
} // end namespace clang

‎clang/lib/Interpreter/Interpreter.cpp

Lines changed: 23 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -372,15 +372,35 @@ Interpreter::Parse(llvm::StringRef Code) {
372372
return IncrParser->Parse(Code);
373373
}
374374

375+
static llvm::Expected<llvm::orc::JITTargetMachineBuilder>
376+
createJITTargetMachineBuilder(const std::string &TT) {
377+
if (TT == llvm::sys::getProcessTriple())
378+
// This fails immediately if the target backend is not registered
379+
return llvm::orc::JITTargetMachineBuilder::detectHost();
380+
381+
// If the target backend is not registered, LLJITBuilder::create() will fail
382+
return llvm::orc::JITTargetMachineBuilder(llvm::Triple(TT));
383+
}
384+
385+
llvm::Expected<std::unique_ptr<llvm::orc::LLJITBuilder>>
386+
Interpreter::CreateJITBuilder(CompilerInstance &CI) {
387+
auto JTMB = createJITTargetMachineBuilder(CI.getTargetOpts().Triple);
388+
if (!JTMB)
389+
return JTMB.takeError();
390+
return IncrementalExecutor::createDefaultJITBuilder(std::move(*JTMB));
391+
}
392+
375393
llvm::Error Interpreter::CreateExecutor() {
376-
const clang::TargetInfo &TI =
377-
getCompilerInstance()->getASTContext().getTargetInfo();
378394
if (IncrExecutor)
379395
return llvm::make_error<llvm::StringError>("Operation failed. "
380396
"Execution engine exists",
381397
std::error_code());
398+
llvm::Expected<std::unique_ptr<llvm::orc::LLJITBuilder>> JB =
399+
CreateJITBuilder(*getCompilerInstance());
400+
if (!JB)
401+
return JB.takeError();
382402
llvm::Error Err = llvm::Error::success();
383-
auto Executor = std::make_unique<IncrementalExecutor>(*TSCtx, Err, TI);
403+
auto Executor = std::make_unique<IncrementalExecutor>(*TSCtx, **JB, Err);
384404
if (!Err)
385405
IncrExecutor = std::move(Executor);
386406

‎clang/unittests/Interpreter/InterpreterExtensionsTest.cpp

Lines changed: 118 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,11 @@
1717
#include "clang/Sema/Lookup.h"
1818
#include "clang/Sema/Sema.h"
1919

20+
#include "llvm/ExecutionEngine/Orc/LLJIT.h"
21+
#include "llvm/ExecutionEngine/Orc/Shared/ExecutorAddress.h"
2022
#include "llvm/Support/Error.h"
23+
#include "llvm/Support/TargetSelect.h"
24+
#include "llvm/Support/Threading.h"
2125
#include "llvm/Testing/Support/Error.h"
2226

2327
#include "gmock/gmock.h"
@@ -33,16 +37,36 @@ class TestCreateResetExecutor : public Interpreter {
3337
llvm::Error &Err)
3438
: Interpreter(std::move(CI), Err) {}
3539

36-
llvm::Error testCreateExecutor() { return Interpreter::CreateExecutor(); }
40+
llvm::Error testCreateJITBuilderError() {
41+
JB = nullptr;
42+
return Interpreter::CreateExecutor();
43+
}
44+
45+
llvm::Error testCreateExecutor() {
46+
JB = std::make_unique<llvm::orc::LLJITBuilder>();
47+
return Interpreter::CreateExecutor();
48+
}
3749

3850
void resetExecutor() { Interpreter::ResetExecutor(); }
51+
52+
private:
53+
llvm::Expected<std::unique_ptr<llvm::orc::LLJITBuilder>>
54+
CreateJITBuilder(CompilerInstance &CI) override {
55+
if (JB)
56+
return std::move(JB);
57+
return llvm::make_error<llvm::StringError>("TestError", std::error_code());
58+
}
59+
60+
std::unique_ptr<llvm::orc::LLJITBuilder> JB;
3961
};
4062

4163
TEST(InterpreterExtensionsTest, ExecutorCreateReset) {
4264
clang::IncrementalCompilerBuilder CB;
4365
llvm::Error ErrOut = llvm::Error::success();
4466
TestCreateResetExecutor Interp(cantFail(CB.CreateCpp()), ErrOut);
4567
cantFail(std::move(ErrOut));
68+
EXPECT_THAT_ERROR(Interp.testCreateJITBuilderError(),
69+
llvm::FailedWithMessage("TestError"));
4670
cantFail(Interp.testCreateExecutor());
4771
Interp.resetExecutor();
4872
cantFail(Interp.testCreateExecutor());
@@ -100,4 +124,97 @@ TEST(InterpreterExtensionsTest, FindRuntimeInterface) {
100124
EXPECT_EQ(1U, Interp.RuntimeIBPtr->TransformerQueries);
101125
}
102126

127+
class CustomJBInterpreter : public Interpreter {
128+
using CustomJITBuilderCreatorFunction =
129+
std::function<llvm::Expected<std::unique_ptr<llvm::orc::LLJITBuilder>>()>;
130+
CustomJITBuilderCreatorFunction JBCreator = nullptr;
131+
132+
public:
133+
CustomJBInterpreter(std::unique_ptr<CompilerInstance> CI, llvm::Error &ErrOut)
134+
: Interpreter(std::move(CI), ErrOut) {}
135+
136+
~CustomJBInterpreter() override {
137+
// Skip cleanUp() because it would trigger LLJIT default dtors
138+
Interpreter::ResetExecutor();
139+
}
140+
141+
void setCustomJITBuilderCreator(CustomJITBuilderCreatorFunction Fn) {
142+
JBCreator = std::move(Fn);
143+
}
144+
145+
llvm::Expected<std::unique_ptr<llvm::orc::LLJITBuilder>>
146+
CreateJITBuilder(CompilerInstance &CI) override {
147+
if (JBCreator)
148+
return JBCreator();
149+
return Interpreter::CreateJITBuilder(CI);
150+
}
151+
152+
llvm::Error CreateExecutor() { return Interpreter::CreateExecutor(); }
153+
};
154+
155+
static void initArmTarget() {
156+
static llvm::once_flag F;
157+
llvm::call_once(F, [] {
158+
LLVMInitializeARMTarget();
159+
LLVMInitializeARMTargetInfo();
160+
LLVMInitializeARMTargetMC();
161+
LLVMInitializeARMAsmPrinter();
162+
});
163+
}
164+
165+
llvm::llvm_shutdown_obj Shutdown;
166+
167+
TEST(InterpreterExtensionsTest, DefaultCrossJIT) {
168+
IncrementalCompilerBuilder CB;
169+
CB.SetTargetTriple("armv6-none-eabi");
170+
auto CI = cantFail(CB.CreateCpp());
171+
llvm::Error ErrOut = llvm::Error::success();
172+
CustomJBInterpreter Interp(std::move(CI), ErrOut);
173+
cantFail(std::move(ErrOut));
174+
175+
initArmTarget();
176+
cantFail(Interp.CreateExecutor());
177+
}
178+
179+
TEST(InterpreterExtensionsTest, CustomCrossJIT) {
180+
std::string TargetTriple = "armv6-none-eabi";
181+
182+
IncrementalCompilerBuilder CB;
183+
CB.SetTargetTriple(TargetTriple);
184+
auto CI = cantFail(CB.CreateCpp());
185+
llvm::Error ErrOut = llvm::Error::success();
186+
CustomJBInterpreter Interp(std::move(CI), ErrOut);
187+
cantFail(std::move(ErrOut));
188+
189+
using namespace llvm::orc;
190+
LLJIT *JIT = nullptr;
191+
std::vector<std::unique_ptr<llvm::MemoryBuffer>> Objs;
192+
Interp.setCustomJITBuilderCreator([&]() {
193+
initArmTarget();
194+
auto JTMB = JITTargetMachineBuilder(llvm::Triple(TargetTriple));
195+
JTMB.setCPU("cortex-m0plus");
196+
auto JB = std::make_unique<LLJITBuilder>();
197+
JB->setJITTargetMachineBuilder(JTMB);
198+
JB->setPlatformSetUp(setUpInactivePlatform);
199+
JB->setNotifyCreatedCallback([&](LLJIT &J) {
200+
ObjectLayer &ObjLayer = J.getObjLinkingLayer();
201+
auto *JITLinkObjLayer = llvm::dyn_cast<ObjectLinkingLayer>(&ObjLayer);
202+
JITLinkObjLayer->setReturnObjectBuffer(
203+
[&Objs](std::unique_ptr<llvm::MemoryBuffer> MB) {
204+
Objs.push_back(std::move(MB));
205+
});
206+
JIT = &J;
207+
return llvm::Error::success();
208+
});
209+
return JB;
210+
});
211+
212+
EXPECT_EQ(0U, Objs.size());
213+
cantFail(Interp.CreateExecutor());
214+
cantFail(Interp.ParseAndExecute("int a = 1;"));
215+
ExecutorAddr Addr = cantFail(JIT->lookup("a"));
216+
EXPECT_NE(0U, Addr.getValue());
217+
EXPECT_EQ(1U, Objs.size());
218+
}
219+
103220
} // end anonymous namespace

0 commit comments

Comments
 (0)