1 //===-- ExecutionEngineBindings.cpp - C bindings for EEs ------------------===//
2 //
3 // The LLVM Compiler Infrastructure
4 //
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
7 //
8 //===----------------------------------------------------------------------===//
9 //
10 // This file defines the C bindings for the ExecutionEngine library.
11 //
12 //===----------------------------------------------------------------------===//
13
14 #include "llvm-c/ExecutionEngine.h"
15 #include "llvm/ExecutionEngine/ExecutionEngine.h"
16 #include "llvm/ExecutionEngine/GenericValue.h"
17 #include "llvm/ExecutionEngine/RTDyldMemoryManager.h"
18 #include "llvm/IR/DerivedTypes.h"
19 #include "llvm/IR/Module.h"
20 #include "llvm/Support/ErrorHandling.h"
21 #include <cstring>
22
23 using namespace llvm;
24
25 #define DEBUG_TYPE "jit"
26
27 // Wrapping the C bindings types.
DEFINE_SIMPLE_CONVERSION_FUNCTIONS(GenericValue,LLVMGenericValueRef)28 DEFINE_SIMPLE_CONVERSION_FUNCTIONS(GenericValue, LLVMGenericValueRef)
29
30 inline TargetLibraryInfo *unwrap(LLVMTargetLibraryInfoRef P) {
31 return reinterpret_cast<TargetLibraryInfo*>(P);
32 }
33
wrap(const TargetLibraryInfo * P)34 inline LLVMTargetLibraryInfoRef wrap(const TargetLibraryInfo *P) {
35 TargetLibraryInfo *X = const_cast<TargetLibraryInfo*>(P);
36 return reinterpret_cast<LLVMTargetLibraryInfoRef>(X);
37 }
38
wrap(const TargetMachine * P)39 inline LLVMTargetMachineRef wrap(const TargetMachine *P) {
40 return
41 reinterpret_cast<LLVMTargetMachineRef>(const_cast<TargetMachine*>(P));
42 }
43
44 /*===-- Operations on generic values --------------------------------------===*/
45
LLVMCreateGenericValueOfInt(LLVMTypeRef Ty,unsigned long long N,LLVMBool IsSigned)46 LLVMGenericValueRef LLVMCreateGenericValueOfInt(LLVMTypeRef Ty,
47 unsigned long long N,
48 LLVMBool IsSigned) {
49 GenericValue *GenVal = new GenericValue();
50 GenVal->IntVal = APInt(unwrap<IntegerType>(Ty)->getBitWidth(), N, IsSigned);
51 return wrap(GenVal);
52 }
53
LLVMCreateGenericValueOfPointer(void * P)54 LLVMGenericValueRef LLVMCreateGenericValueOfPointer(void *P) {
55 GenericValue *GenVal = new GenericValue();
56 GenVal->PointerVal = P;
57 return wrap(GenVal);
58 }
59
LLVMCreateGenericValueOfFloat(LLVMTypeRef TyRef,double N)60 LLVMGenericValueRef LLVMCreateGenericValueOfFloat(LLVMTypeRef TyRef, double N) {
61 GenericValue *GenVal = new GenericValue();
62 switch (unwrap(TyRef)->getTypeID()) {
63 case Type::FloatTyID:
64 GenVal->FloatVal = N;
65 break;
66 case Type::DoubleTyID:
67 GenVal->DoubleVal = N;
68 break;
69 default:
70 llvm_unreachable("LLVMGenericValueToFloat supports only float and double.");
71 }
72 return wrap(GenVal);
73 }
74
LLVMGenericValueIntWidth(LLVMGenericValueRef GenValRef)75 unsigned LLVMGenericValueIntWidth(LLVMGenericValueRef GenValRef) {
76 return unwrap(GenValRef)->IntVal.getBitWidth();
77 }
78
LLVMGenericValueToInt(LLVMGenericValueRef GenValRef,LLVMBool IsSigned)79 unsigned long long LLVMGenericValueToInt(LLVMGenericValueRef GenValRef,
80 LLVMBool IsSigned) {
81 GenericValue *GenVal = unwrap(GenValRef);
82 if (IsSigned)
83 return GenVal->IntVal.getSExtValue();
84 else
85 return GenVal->IntVal.getZExtValue();
86 }
87
LLVMGenericValueToPointer(LLVMGenericValueRef GenVal)88 void *LLVMGenericValueToPointer(LLVMGenericValueRef GenVal) {
89 return unwrap(GenVal)->PointerVal;
90 }
91
LLVMGenericValueToFloat(LLVMTypeRef TyRef,LLVMGenericValueRef GenVal)92 double LLVMGenericValueToFloat(LLVMTypeRef TyRef, LLVMGenericValueRef GenVal) {
93 switch (unwrap(TyRef)->getTypeID()) {
94 case Type::FloatTyID:
95 return unwrap(GenVal)->FloatVal;
96 case Type::DoubleTyID:
97 return unwrap(GenVal)->DoubleVal;
98 default:
99 llvm_unreachable("LLVMGenericValueToFloat supports only float and double.");
100 }
101 }
102
LLVMDisposeGenericValue(LLVMGenericValueRef GenVal)103 void LLVMDisposeGenericValue(LLVMGenericValueRef GenVal) {
104 delete unwrap(GenVal);
105 }
106
107 /*===-- Operations on execution engines -----------------------------------===*/
108
LLVMCreateExecutionEngineForModule(LLVMExecutionEngineRef * OutEE,LLVMModuleRef M,char ** OutError)109 LLVMBool LLVMCreateExecutionEngineForModule(LLVMExecutionEngineRef *OutEE,
110 LLVMModuleRef M,
111 char **OutError) {
112 std::string Error;
113 EngineBuilder builder(unwrap(M));
114 builder.setEngineKind(EngineKind::Either)
115 .setErrorStr(&Error);
116 if (ExecutionEngine *EE = builder.create()){
117 *OutEE = wrap(EE);
118 return 0;
119 }
120 *OutError = strdup(Error.c_str());
121 return 1;
122 }
123
LLVMCreateInterpreterForModule(LLVMExecutionEngineRef * OutInterp,LLVMModuleRef M,char ** OutError)124 LLVMBool LLVMCreateInterpreterForModule(LLVMExecutionEngineRef *OutInterp,
125 LLVMModuleRef M,
126 char **OutError) {
127 std::string Error;
128 EngineBuilder builder(unwrap(M));
129 builder.setEngineKind(EngineKind::Interpreter)
130 .setErrorStr(&Error);
131 if (ExecutionEngine *Interp = builder.create()) {
132 *OutInterp = wrap(Interp);
133 return 0;
134 }
135 *OutError = strdup(Error.c_str());
136 return 1;
137 }
138
LLVMCreateJITCompilerForModule(LLVMExecutionEngineRef * OutJIT,LLVMModuleRef M,unsigned OptLevel,char ** OutError)139 LLVMBool LLVMCreateJITCompilerForModule(LLVMExecutionEngineRef *OutJIT,
140 LLVMModuleRef M,
141 unsigned OptLevel,
142 char **OutError) {
143 std::string Error;
144 EngineBuilder builder(unwrap(M));
145 builder.setEngineKind(EngineKind::JIT)
146 .setErrorStr(&Error)
147 .setOptLevel((CodeGenOpt::Level)OptLevel);
148 if (ExecutionEngine *JIT = builder.create()) {
149 *OutJIT = wrap(JIT);
150 return 0;
151 }
152 *OutError = strdup(Error.c_str());
153 return 1;
154 }
155
LLVMInitializeMCJITCompilerOptions(LLVMMCJITCompilerOptions * PassedOptions,size_t SizeOfPassedOptions)156 void LLVMInitializeMCJITCompilerOptions(LLVMMCJITCompilerOptions *PassedOptions,
157 size_t SizeOfPassedOptions) {
158 LLVMMCJITCompilerOptions options;
159 memset(&options, 0, sizeof(options)); // Most fields are zero by default.
160 options.CodeModel = LLVMCodeModelJITDefault;
161
162 memcpy(PassedOptions, &options,
163 std::min(sizeof(options), SizeOfPassedOptions));
164 }
165
LLVMCreateMCJITCompilerForModule(LLVMExecutionEngineRef * OutJIT,LLVMModuleRef M,LLVMMCJITCompilerOptions * PassedOptions,size_t SizeOfPassedOptions,char ** OutError)166 LLVMBool LLVMCreateMCJITCompilerForModule(
167 LLVMExecutionEngineRef *OutJIT, LLVMModuleRef M,
168 LLVMMCJITCompilerOptions *PassedOptions, size_t SizeOfPassedOptions,
169 char **OutError) {
170 LLVMMCJITCompilerOptions options;
171 // If the user passed a larger sized options struct, then they were compiled
172 // against a newer LLVM. Tell them that something is wrong.
173 if (SizeOfPassedOptions > sizeof(options)) {
174 *OutError = strdup(
175 "Refusing to use options struct that is larger than my own; assuming "
176 "LLVM library mismatch.");
177 return 1;
178 }
179
180 // Defend against the user having an old version of the API by ensuring that
181 // any fields they didn't see are cleared. We must defend against fields being
182 // set to the bitwise equivalent of zero, and assume that this means "do the
183 // default" as if that option hadn't been available.
184 LLVMInitializeMCJITCompilerOptions(&options, sizeof(options));
185 memcpy(&options, PassedOptions, SizeOfPassedOptions);
186
187 TargetOptions targetOptions;
188 targetOptions.NoFramePointerElim = options.NoFramePointerElim;
189 targetOptions.EnableFastISel = options.EnableFastISel;
190
191 std::string Error;
192 EngineBuilder builder(unwrap(M));
193 builder.setEngineKind(EngineKind::JIT)
194 .setErrorStr(&Error)
195 .setUseMCJIT(true)
196 .setOptLevel((CodeGenOpt::Level)options.OptLevel)
197 .setCodeModel(unwrap(options.CodeModel))
198 .setTargetOptions(targetOptions);
199 if (options.MCJMM)
200 builder.setMCJITMemoryManager(unwrap(options.MCJMM));
201 if (ExecutionEngine *JIT = builder.create()) {
202 *OutJIT = wrap(JIT);
203 return 0;
204 }
205 *OutError = strdup(Error.c_str());
206 return 1;
207 }
208
LLVMCreateExecutionEngine(LLVMExecutionEngineRef * OutEE,LLVMModuleProviderRef MP,char ** OutError)209 LLVMBool LLVMCreateExecutionEngine(LLVMExecutionEngineRef *OutEE,
210 LLVMModuleProviderRef MP,
211 char **OutError) {
212 /* The module provider is now actually a module. */
213 return LLVMCreateExecutionEngineForModule(OutEE,
214 reinterpret_cast<LLVMModuleRef>(MP),
215 OutError);
216 }
217
LLVMCreateInterpreter(LLVMExecutionEngineRef * OutInterp,LLVMModuleProviderRef MP,char ** OutError)218 LLVMBool LLVMCreateInterpreter(LLVMExecutionEngineRef *OutInterp,
219 LLVMModuleProviderRef MP,
220 char **OutError) {
221 /* The module provider is now actually a module. */
222 return LLVMCreateInterpreterForModule(OutInterp,
223 reinterpret_cast<LLVMModuleRef>(MP),
224 OutError);
225 }
226
LLVMCreateJITCompiler(LLVMExecutionEngineRef * OutJIT,LLVMModuleProviderRef MP,unsigned OptLevel,char ** OutError)227 LLVMBool LLVMCreateJITCompiler(LLVMExecutionEngineRef *OutJIT,
228 LLVMModuleProviderRef MP,
229 unsigned OptLevel,
230 char **OutError) {
231 /* The module provider is now actually a module. */
232 return LLVMCreateJITCompilerForModule(OutJIT,
233 reinterpret_cast<LLVMModuleRef>(MP),
234 OptLevel, OutError);
235 }
236
237
LLVMDisposeExecutionEngine(LLVMExecutionEngineRef EE)238 void LLVMDisposeExecutionEngine(LLVMExecutionEngineRef EE) {
239 delete unwrap(EE);
240 }
241
LLVMRunStaticConstructors(LLVMExecutionEngineRef EE)242 void LLVMRunStaticConstructors(LLVMExecutionEngineRef EE) {
243 unwrap(EE)->runStaticConstructorsDestructors(false);
244 }
245
LLVMRunStaticDestructors(LLVMExecutionEngineRef EE)246 void LLVMRunStaticDestructors(LLVMExecutionEngineRef EE) {
247 unwrap(EE)->runStaticConstructorsDestructors(true);
248 }
249
LLVMRunFunctionAsMain(LLVMExecutionEngineRef EE,LLVMValueRef F,unsigned ArgC,const char * const * ArgV,const char * const * EnvP)250 int LLVMRunFunctionAsMain(LLVMExecutionEngineRef EE, LLVMValueRef F,
251 unsigned ArgC, const char * const *ArgV,
252 const char * const *EnvP) {
253 unwrap(EE)->finalizeObject();
254
255 std::vector<std::string> ArgVec;
256 for (unsigned I = 0; I != ArgC; ++I)
257 ArgVec.push_back(ArgV[I]);
258
259 return unwrap(EE)->runFunctionAsMain(unwrap<Function>(F), ArgVec, EnvP);
260 }
261
LLVMRunFunction(LLVMExecutionEngineRef EE,LLVMValueRef F,unsigned NumArgs,LLVMGenericValueRef * Args)262 LLVMGenericValueRef LLVMRunFunction(LLVMExecutionEngineRef EE, LLVMValueRef F,
263 unsigned NumArgs,
264 LLVMGenericValueRef *Args) {
265 unwrap(EE)->finalizeObject();
266
267 std::vector<GenericValue> ArgVec;
268 ArgVec.reserve(NumArgs);
269 for (unsigned I = 0; I != NumArgs; ++I)
270 ArgVec.push_back(*unwrap(Args[I]));
271
272 GenericValue *Result = new GenericValue();
273 *Result = unwrap(EE)->runFunction(unwrap<Function>(F), ArgVec);
274 return wrap(Result);
275 }
276
LLVMFreeMachineCodeForFunction(LLVMExecutionEngineRef EE,LLVMValueRef F)277 void LLVMFreeMachineCodeForFunction(LLVMExecutionEngineRef EE, LLVMValueRef F) {
278 unwrap(EE)->freeMachineCodeForFunction(unwrap<Function>(F));
279 }
280
LLVMAddModule(LLVMExecutionEngineRef EE,LLVMModuleRef M)281 void LLVMAddModule(LLVMExecutionEngineRef EE, LLVMModuleRef M){
282 unwrap(EE)->addModule(unwrap(M));
283 }
284
LLVMAddModuleProvider(LLVMExecutionEngineRef EE,LLVMModuleProviderRef MP)285 void LLVMAddModuleProvider(LLVMExecutionEngineRef EE, LLVMModuleProviderRef MP){
286 /* The module provider is now actually a module. */
287 LLVMAddModule(EE, reinterpret_cast<LLVMModuleRef>(MP));
288 }
289
LLVMRemoveModule(LLVMExecutionEngineRef EE,LLVMModuleRef M,LLVMModuleRef * OutMod,char ** OutError)290 LLVMBool LLVMRemoveModule(LLVMExecutionEngineRef EE, LLVMModuleRef M,
291 LLVMModuleRef *OutMod, char **OutError) {
292 Module *Mod = unwrap(M);
293 unwrap(EE)->removeModule(Mod);
294 *OutMod = wrap(Mod);
295 return 0;
296 }
297
LLVMRemoveModuleProvider(LLVMExecutionEngineRef EE,LLVMModuleProviderRef MP,LLVMModuleRef * OutMod,char ** OutError)298 LLVMBool LLVMRemoveModuleProvider(LLVMExecutionEngineRef EE,
299 LLVMModuleProviderRef MP,
300 LLVMModuleRef *OutMod, char **OutError) {
301 /* The module provider is now actually a module. */
302 return LLVMRemoveModule(EE, reinterpret_cast<LLVMModuleRef>(MP), OutMod,
303 OutError);
304 }
305
LLVMFindFunction(LLVMExecutionEngineRef EE,const char * Name,LLVMValueRef * OutFn)306 LLVMBool LLVMFindFunction(LLVMExecutionEngineRef EE, const char *Name,
307 LLVMValueRef *OutFn) {
308 if (Function *F = unwrap(EE)->FindFunctionNamed(Name)) {
309 *OutFn = wrap(F);
310 return 0;
311 }
312 return 1;
313 }
314
LLVMRecompileAndRelinkFunction(LLVMExecutionEngineRef EE,LLVMValueRef Fn)315 void *LLVMRecompileAndRelinkFunction(LLVMExecutionEngineRef EE,
316 LLVMValueRef Fn) {
317 return unwrap(EE)->recompileAndRelinkFunction(unwrap<Function>(Fn));
318 }
319
LLVMGetExecutionEngineTargetData(LLVMExecutionEngineRef EE)320 LLVMTargetDataRef LLVMGetExecutionEngineTargetData(LLVMExecutionEngineRef EE) {
321 return wrap(unwrap(EE)->getDataLayout());
322 }
323
324 LLVMTargetMachineRef
LLVMGetExecutionEngineTargetMachine(LLVMExecutionEngineRef EE)325 LLVMGetExecutionEngineTargetMachine(LLVMExecutionEngineRef EE) {
326 return wrap(unwrap(EE)->getTargetMachine());
327 }
328
LLVMAddGlobalMapping(LLVMExecutionEngineRef EE,LLVMValueRef Global,void * Addr)329 void LLVMAddGlobalMapping(LLVMExecutionEngineRef EE, LLVMValueRef Global,
330 void* Addr) {
331 unwrap(EE)->addGlobalMapping(unwrap<GlobalValue>(Global), Addr);
332 }
333
LLVMGetPointerToGlobal(LLVMExecutionEngineRef EE,LLVMValueRef Global)334 void *LLVMGetPointerToGlobal(LLVMExecutionEngineRef EE, LLVMValueRef Global) {
335 unwrap(EE)->finalizeObject();
336
337 return unwrap(EE)->getPointerToGlobal(unwrap<GlobalValue>(Global));
338 }
339
340 /*===-- Operations on memory managers -------------------------------------===*/
341
342 namespace {
343
344 struct SimpleBindingMMFunctions {
345 LLVMMemoryManagerAllocateCodeSectionCallback AllocateCodeSection;
346 LLVMMemoryManagerAllocateDataSectionCallback AllocateDataSection;
347 LLVMMemoryManagerFinalizeMemoryCallback FinalizeMemory;
348 LLVMMemoryManagerDestroyCallback Destroy;
349 };
350
351 class SimpleBindingMemoryManager : public RTDyldMemoryManager {
352 public:
353 SimpleBindingMemoryManager(const SimpleBindingMMFunctions& Functions,
354 void *Opaque);
355 virtual ~SimpleBindingMemoryManager();
356
357 uint8_t *allocateCodeSection(uintptr_t Size, unsigned Alignment,
358 unsigned SectionID,
359 StringRef SectionName) override;
360
361 uint8_t *allocateDataSection(uintptr_t Size, unsigned Alignment,
362 unsigned SectionID, StringRef SectionName,
363 bool isReadOnly) override;
364
365 bool finalizeMemory(std::string *ErrMsg) override;
366
367 private:
368 SimpleBindingMMFunctions Functions;
369 void *Opaque;
370 };
371
SimpleBindingMemoryManager(const SimpleBindingMMFunctions & Functions,void * Opaque)372 SimpleBindingMemoryManager::SimpleBindingMemoryManager(
373 const SimpleBindingMMFunctions& Functions,
374 void *Opaque)
375 : Functions(Functions), Opaque(Opaque) {
376 assert(Functions.AllocateCodeSection &&
377 "No AllocateCodeSection function provided!");
378 assert(Functions.AllocateDataSection &&
379 "No AllocateDataSection function provided!");
380 assert(Functions.FinalizeMemory &&
381 "No FinalizeMemory function provided!");
382 assert(Functions.Destroy &&
383 "No Destroy function provided!");
384 }
385
~SimpleBindingMemoryManager()386 SimpleBindingMemoryManager::~SimpleBindingMemoryManager() {
387 Functions.Destroy(Opaque);
388 }
389
allocateCodeSection(uintptr_t Size,unsigned Alignment,unsigned SectionID,StringRef SectionName)390 uint8_t *SimpleBindingMemoryManager::allocateCodeSection(
391 uintptr_t Size, unsigned Alignment, unsigned SectionID,
392 StringRef SectionName) {
393 return Functions.AllocateCodeSection(Opaque, Size, Alignment, SectionID,
394 SectionName.str().c_str());
395 }
396
allocateDataSection(uintptr_t Size,unsigned Alignment,unsigned SectionID,StringRef SectionName,bool isReadOnly)397 uint8_t *SimpleBindingMemoryManager::allocateDataSection(
398 uintptr_t Size, unsigned Alignment, unsigned SectionID,
399 StringRef SectionName, bool isReadOnly) {
400 return Functions.AllocateDataSection(Opaque, Size, Alignment, SectionID,
401 SectionName.str().c_str(),
402 isReadOnly);
403 }
404
finalizeMemory(std::string * ErrMsg)405 bool SimpleBindingMemoryManager::finalizeMemory(std::string *ErrMsg) {
406 char *errMsgCString = nullptr;
407 bool result = Functions.FinalizeMemory(Opaque, &errMsgCString);
408 assert((result || !errMsgCString) &&
409 "Did not expect an error message if FinalizeMemory succeeded");
410 if (errMsgCString) {
411 if (ErrMsg)
412 *ErrMsg = errMsgCString;
413 free(errMsgCString);
414 }
415 return result;
416 }
417
418 } // anonymous namespace
419
LLVMCreateSimpleMCJITMemoryManager(void * Opaque,LLVMMemoryManagerAllocateCodeSectionCallback AllocateCodeSection,LLVMMemoryManagerAllocateDataSectionCallback AllocateDataSection,LLVMMemoryManagerFinalizeMemoryCallback FinalizeMemory,LLVMMemoryManagerDestroyCallback Destroy)420 LLVMMCJITMemoryManagerRef LLVMCreateSimpleMCJITMemoryManager(
421 void *Opaque,
422 LLVMMemoryManagerAllocateCodeSectionCallback AllocateCodeSection,
423 LLVMMemoryManagerAllocateDataSectionCallback AllocateDataSection,
424 LLVMMemoryManagerFinalizeMemoryCallback FinalizeMemory,
425 LLVMMemoryManagerDestroyCallback Destroy) {
426
427 if (!AllocateCodeSection || !AllocateDataSection || !FinalizeMemory ||
428 !Destroy)
429 return nullptr;
430
431 SimpleBindingMMFunctions functions;
432 functions.AllocateCodeSection = AllocateCodeSection;
433 functions.AllocateDataSection = AllocateDataSection;
434 functions.FinalizeMemory = FinalizeMemory;
435 functions.Destroy = Destroy;
436 return wrap(new SimpleBindingMemoryManager(functions, Opaque));
437 }
438
LLVMDisposeMCJITMemoryManager(LLVMMCJITMemoryManagerRef MM)439 void LLVMDisposeMCJITMemoryManager(LLVMMCJITMemoryManagerRef MM) {
440 delete unwrap(MM);
441 }
442
443