1 //===- OrcV2CBindingsDumpObjects.c - Dump JIT'd objects to disk via C API -===//
3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4 // See https://llvm.org/LICENSE.txt for license information.
5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
7 //===----------------------------------------------------------------------===//
9 // To run the demo build 'OrcV2CBindingsDumpObjects', then run the built
10 // program. It will execute as for OrcV2CBindingsBasicUsage, but will write
11 // a single JIT'd object out to the working directory.
13 // Try experimenting with the DumpDir and IdentifierOverride arguments to
14 // LLVMOrcCreateDumpObjects.
16 //===----------------------------------------------------------------------===//
18 #include "llvm-c/Core.h"
19 #include "llvm-c/Error.h"
20 #include "llvm-c/Initialization.h"
21 #include "llvm-c/LLJIT.h"
22 #include "llvm-c/Support.h"
23 #include "llvm-c/Target.h"
24 #include "llvm-c/Transforms/Scalar.h"
28 int handleError(LLVMErrorRef Err
) {
29 char *ErrMsg
= LLVMGetErrorMessage(Err
);
30 fprintf(stderr
, "Error: %s\n", ErrMsg
);
31 LLVMDisposeErrorMessage(ErrMsg
);
35 LLVMOrcThreadSafeModuleRef
createDemoModule() {
36 LLVMOrcThreadSafeContextRef TSCtx
= LLVMOrcCreateNewThreadSafeContext();
37 LLVMContextRef Ctx
= LLVMOrcThreadSafeContextGetContext(TSCtx
);
38 LLVMModuleRef M
= LLVMModuleCreateWithNameInContext("demo", Ctx
);
39 LLVMTypeRef ParamTypes
[] = {LLVMInt32Type(), LLVMInt32Type()};
40 LLVMTypeRef SumFunctionType
=
41 LLVMFunctionType(LLVMInt32Type(), ParamTypes
, 2, 0);
42 LLVMValueRef SumFunction
= LLVMAddFunction(M
, "sum", SumFunctionType
);
43 LLVMBasicBlockRef EntryBB
= LLVMAppendBasicBlock(SumFunction
, "entry");
44 LLVMBuilderRef Builder
= LLVMCreateBuilder();
45 LLVMPositionBuilderAtEnd(Builder
, EntryBB
);
46 LLVMValueRef SumArg0
= LLVMGetParam(SumFunction
, 0);
47 LLVMValueRef SumArg1
= LLVMGetParam(SumFunction
, 1);
48 LLVMValueRef Result
= LLVMBuildAdd(Builder
, SumArg0
, SumArg1
, "result");
49 LLVMBuildRet(Builder
, Result
);
50 LLVMOrcThreadSafeModuleRef TSM
= LLVMOrcCreateNewThreadSafeModule(M
, TSCtx
);
51 LLVMOrcDisposeThreadSafeContext(TSCtx
);
55 LLVMErrorRef
myModuleTransform(void *Ctx
, LLVMModuleRef Mod
) {
56 LLVMPassManagerRef PM
= LLVMCreatePassManager();
57 LLVMAddInstructionCombiningPass(PM
);
58 LLVMRunPassManager(PM
, Mod
);
59 LLVMDisposePassManager(PM
);
60 return LLVMErrorSuccess
;
63 LLVMErrorRef
transform(void *Ctx
, LLVMOrcThreadSafeModuleRef
*ModInOut
,
64 LLVMOrcMaterializationResponsibilityRef MR
) {
65 return LLVMOrcThreadSafeModuleWithModuleDo(*ModInOut
, myModuleTransform
, Ctx
);
68 int main(int argc
, char *argv
[]) {
72 LLVMParseCommandLineOptions(argc
, (const char **)argv
, "");
73 LLVMInitializeCore(LLVMGetGlobalPassRegistry());
75 LLVMInitializeNativeTarget();
76 LLVMInitializeNativeAsmPrinter();
78 // Create a DumpObjects instance to use when dumping objects to disk.
79 LLVMOrcDumpObjectsRef DumpObjects
= LLVMOrcCreateDumpObjects("", "");
81 // Create the JIT instance.
85 if ((Err
= LLVMOrcCreateLLJIT(&J
, 0))) {
86 MainResult
= handleError(Err
);
91 // Use TransformLayer to set IR transform.
93 LLVMOrcIRTransformLayerRef TL
= LLVMOrcLLJITGetIRTransformLayer(J
);
94 LLVMOrcIRTransformLayerSetTransform(TL
, *transform
, NULL
);
97 // Create our demo module.
98 LLVMOrcThreadSafeModuleRef TSM
= createDemoModule();
100 // Add our demo module to the JIT.
102 LLVMOrcJITDylibRef MainJD
= LLVMOrcLLJITGetMainJITDylib(J
);
104 if ((Err
= LLVMOrcLLJITAddLLVMIRModule(J
, MainJD
, TSM
))) {
105 // If adding the ThreadSafeModule fails then we need to clean it up
106 // ourselves. If adding it succeeds the JIT will manage the memory.
107 LLVMOrcDisposeThreadSafeModule(TSM
);
108 MainResult
= handleError(Err
);
113 // Look up the address of our demo entry point.
114 LLVMOrcJITTargetAddress SumAddr
;
117 if ((Err
= LLVMOrcLLJITLookup(J
, &SumAddr
, "sum"))) {
118 MainResult
= handleError(Err
);
123 // If we made it here then everything succeeded. Execute our JIT'd code.
124 int32_t (*Sum
)(int32_t, int32_t) = (int32_t(*)(int32_t, int32_t))SumAddr
;
125 int32_t Result
= Sum(1, 2);
128 printf("1 + 2 = %i\n", Result
);
132 // Destroy our JIT instance.
135 if ((Err
= LLVMOrcDisposeLLJIT(J
))) {
136 int NewFailureResult
= handleError(Err
);
138 MainResult
= NewFailureResult
;
143 // Destroy our DumpObjects instance.
144 LLVMOrcDisposeDumpObjects(DumpObjects
);