Reid Spencer | 66e7cd0 | 2004-09-11 20:30:11 +0000 | [diff] [blame] | 1 | //===--- examples/Fibonacci/fibonacci.cpp - An example use of the JIT -----===// |
Misha Brukman | 237cef4 | 2005-04-20 16:42:34 +0000 | [diff] [blame] | 2 | // |
Reid Spencer | e784fa4 | 2004-08-19 20:10:04 +0000 | [diff] [blame] | 3 | // The LLVM Compiler Infrastructure |
| 4 | // |
Chris Lattner | fc001bb | 2007-12-29 20:37:57 +0000 | [diff] [blame] | 5 | // This file is distributed under the University of Illinois Open Source |
| 6 | // License. See LICENSE.TXT for details. |
Misha Brukman | 237cef4 | 2005-04-20 16:42:34 +0000 | [diff] [blame] | 7 | // |
Reid Spencer | e784fa4 | 2004-08-19 20:10:04 +0000 | [diff] [blame] | 8 | //===----------------------------------------------------------------------===// |
| 9 | // |
Chris Lattner | 38f024d | 2004-11-03 21:43:03 +0000 | [diff] [blame] | 10 | // This small program provides an example of how to build quickly a small module |
| 11 | // with function Fibonacci and execute it with the JIT. |
Reid Spencer | e784fa4 | 2004-08-19 20:10:04 +0000 | [diff] [blame] | 12 | // |
Chris Lattner | 38f024d | 2004-11-03 21:43:03 +0000 | [diff] [blame] | 13 | // The goal of this snippet is to create in the memory the LLVM module |
| 14 | // consisting of one function as follow: |
Reid Spencer | e784fa4 | 2004-08-19 20:10:04 +0000 | [diff] [blame] | 15 | // |
Chris Lattner | 38f024d | 2004-11-03 21:43:03 +0000 | [diff] [blame] | 16 | // int fib(int x) { |
| 17 | // if(x<=2) return 1; |
| 18 | // return fib(x-1)+fib(x-2); |
| 19 | // } |
Misha Brukman | 237cef4 | 2005-04-20 16:42:34 +0000 | [diff] [blame] | 20 | // |
Chris Lattner | 38f024d | 2004-11-03 21:43:03 +0000 | [diff] [blame] | 21 | // Once we have this, we compile the module via JIT, then execute the `fib' |
Reid Spencer | e784fa4 | 2004-08-19 20:10:04 +0000 | [diff] [blame] | 22 | // function and return result to a driver, i.e. to a "host program". |
| 23 | // |
Chris Lattner | 38f024d | 2004-11-03 21:43:03 +0000 | [diff] [blame] | 24 | //===----------------------------------------------------------------------===// |
Reid Spencer | e784fa4 | 2004-08-19 20:10:04 +0000 | [diff] [blame] | 25 | |
Owen Anderson | 8b477ed | 2009-07-01 16:58:40 +0000 | [diff] [blame] | 26 | #include "llvm/LLVMContext.h" |
Chris Lattner | 38f024d | 2004-11-03 21:43:03 +0000 | [diff] [blame] | 27 | #include "llvm/Module.h" |
| 28 | #include "llvm/DerivedTypes.h" |
| 29 | #include "llvm/Constants.h" |
| 30 | #include "llvm/Instructions.h" |
| 31 | #include "llvm/ModuleProvider.h" |
| 32 | #include "llvm/Analysis/Verifier.h" |
Jeff Cohen | afebb44 | 2006-03-24 03:11:31 +0000 | [diff] [blame] | 33 | #include "llvm/ExecutionEngine/JIT.h" |
| 34 | #include "llvm/ExecutionEngine/Interpreter.h" |
Reid Spencer | e784fa4 | 2004-08-19 20:10:04 +0000 | [diff] [blame] | 35 | #include "llvm/ExecutionEngine/GenericValue.h" |
Chris Lattner | 944fac7 | 2008-08-23 22:23:09 +0000 | [diff] [blame] | 36 | #include "llvm/Support/raw_ostream.h" |
Chris Lattner | 18f0c67 | 2009-12-01 01:56:27 +0000 | [diff] [blame^] | 37 | #include "llvm/Target/TargetSelect.h" |
Reid Spencer | e784fa4 | 2004-08-19 20:10:04 +0000 | [diff] [blame] | 38 | using namespace llvm; |
| 39 | |
Owen Anderson | 9adc0ab | 2009-07-14 23:09:55 +0000 | [diff] [blame] | 40 | static Function *CreateFibFunction(Module *M, LLVMContext &Context) { |
Chris Lattner | 38f024d | 2004-11-03 21:43:03 +0000 | [diff] [blame] | 41 | // Create the fib function and insert it into module M. This function is said |
| 42 | // to return an int and take an int parameter. |
Chris Lattner | 6a98754 | 2007-01-07 07:40:09 +0000 | [diff] [blame] | 43 | Function *FibF = |
Owen Anderson | 1d0be15 | 2009-08-13 21:58:54 +0000 | [diff] [blame] | 44 | cast<Function>(M->getOrInsertFunction("fib", Type::getInt32Ty(Context), |
| 45 | Type::getInt32Ty(Context), |
Chris Lattner | 6a98754 | 2007-01-07 07:40:09 +0000 | [diff] [blame] | 46 | (Type *)0)); |
Misha Brukman | 237cef4 | 2005-04-20 16:42:34 +0000 | [diff] [blame] | 47 | |
Chris Lattner | 38f024d | 2004-11-03 21:43:03 +0000 | [diff] [blame] | 48 | // Add a basic block to the function. |
Owen Anderson | 1d0be15 | 2009-08-13 21:58:54 +0000 | [diff] [blame] | 49 | BasicBlock *BB = BasicBlock::Create(Context, "EntryBlock", FibF); |
Misha Brukman | 237cef4 | 2005-04-20 16:42:34 +0000 | [diff] [blame] | 50 | |
Chris Lattner | 38f024d | 2004-11-03 21:43:03 +0000 | [diff] [blame] | 51 | // Get pointers to the constants. |
Owen Anderson | 1d0be15 | 2009-08-13 21:58:54 +0000 | [diff] [blame] | 52 | Value *One = ConstantInt::get(Type::getInt32Ty(Context), 1); |
| 53 | Value *Two = ConstantInt::get(Type::getInt32Ty(Context), 2); |
Reid Spencer | e784fa4 | 2004-08-19 20:10:04 +0000 | [diff] [blame] | 54 | |
Chris Lattner | 38f024d | 2004-11-03 21:43:03 +0000 | [diff] [blame] | 55 | // Get pointer to the integer argument of the add1 function... |
Alkis Evlogimenos | dadf881 | 2005-03-15 07:12:30 +0000 | [diff] [blame] | 56 | Argument *ArgX = FibF->arg_begin(); // Get the arg. |
Chris Lattner | 38f024d | 2004-11-03 21:43:03 +0000 | [diff] [blame] | 57 | ArgX->setName("AnArg"); // Give it a nice symbolic name for fun. |
| 58 | |
Chris Lattner | 38f024d | 2004-11-03 21:43:03 +0000 | [diff] [blame] | 59 | // Create the true_block. |
Owen Anderson | 1d0be15 | 2009-08-13 21:58:54 +0000 | [diff] [blame] | 60 | BasicBlock *RetBB = BasicBlock::Create(Context, "return", FibF); |
Chris Lattner | 38f024d | 2004-11-03 21:43:03 +0000 | [diff] [blame] | 61 | // Create an exit block. |
Owen Anderson | 1d0be15 | 2009-08-13 21:58:54 +0000 | [diff] [blame] | 62 | BasicBlock* RecurseBB = BasicBlock::Create(Context, "recurse", FibF); |
Chris Lattner | 38f024d | 2004-11-03 21:43:03 +0000 | [diff] [blame] | 63 | |
Chris Lattner | 7520fcd | 2008-03-13 03:29:42 +0000 | [diff] [blame] | 64 | // Create the "if (arg <= 2) goto exitbb" |
Owen Anderson | 333c400 | 2009-07-09 23:48:35 +0000 | [diff] [blame] | 65 | Value *CondInst = new ICmpInst(*BB, ICmpInst::ICMP_SLE, ArgX, Two, "cond"); |
Gabor Greif | 051a950 | 2008-04-06 20:25:17 +0000 | [diff] [blame] | 66 | BranchInst::Create(RetBB, RecurseBB, CondInst, BB); |
Chris Lattner | 38f024d | 2004-11-03 21:43:03 +0000 | [diff] [blame] | 67 | |
| 68 | // Create: ret int 1 |
Owen Anderson | 1d0be15 | 2009-08-13 21:58:54 +0000 | [diff] [blame] | 69 | ReturnInst::Create(Context, One, RetBB); |
Misha Brukman | 237cef4 | 2005-04-20 16:42:34 +0000 | [diff] [blame] | 70 | |
Chris Lattner | 38f024d | 2004-11-03 21:43:03 +0000 | [diff] [blame] | 71 | // create fib(x-1) |
Gabor Greif | 7cbd8a3 | 2008-05-16 19:29:10 +0000 | [diff] [blame] | 72 | Value *Sub = BinaryOperator::CreateSub(ArgX, One, "arg", RecurseBB); |
Gabor Greif | 051a950 | 2008-04-06 20:25:17 +0000 | [diff] [blame] | 73 | CallInst *CallFibX1 = CallInst::Create(FibF, Sub, "fibx1", RecurseBB); |
Chris Lattner | f6b5c1a | 2005-05-06 06:21:59 +0000 | [diff] [blame] | 74 | CallFibX1->setTailCall(); |
Misha Brukman | 237cef4 | 2005-04-20 16:42:34 +0000 | [diff] [blame] | 75 | |
Chris Lattner | 38f024d | 2004-11-03 21:43:03 +0000 | [diff] [blame] | 76 | // create fib(x-2) |
Gabor Greif | 7cbd8a3 | 2008-05-16 19:29:10 +0000 | [diff] [blame] | 77 | Sub = BinaryOperator::CreateSub(ArgX, Two, "arg", RecurseBB); |
Gabor Greif | 051a950 | 2008-04-06 20:25:17 +0000 | [diff] [blame] | 78 | CallInst *CallFibX2 = CallInst::Create(FibF, Sub, "fibx2", RecurseBB); |
Chris Lattner | f6b5c1a | 2005-05-06 06:21:59 +0000 | [diff] [blame] | 79 | CallFibX2->setTailCall(); |
Chris Lattner | 47968e4 | 2005-05-06 05:59:50 +0000 | [diff] [blame] | 80 | |
Chris Lattner | 38f024d | 2004-11-03 21:43:03 +0000 | [diff] [blame] | 81 | |
| 82 | // fib(x-1)+fib(x-2) |
Gabor Greif | 7cbd8a3 | 2008-05-16 19:29:10 +0000 | [diff] [blame] | 83 | Value *Sum = BinaryOperator::CreateAdd(CallFibX1, CallFibX2, |
Chris Lattner | 38f024d | 2004-11-03 21:43:03 +0000 | [diff] [blame] | 84 | "addresult", RecurseBB); |
Misha Brukman | 237cef4 | 2005-04-20 16:42:34 +0000 | [diff] [blame] | 85 | |
Chris Lattner | 38f024d | 2004-11-03 21:43:03 +0000 | [diff] [blame] | 86 | // Create the return instruction and add it to the basic block |
Owen Anderson | 1d0be15 | 2009-08-13 21:58:54 +0000 | [diff] [blame] | 87 | ReturnInst::Create(Context, Sum, RecurseBB); |
Chris Lattner | 38f024d | 2004-11-03 21:43:03 +0000 | [diff] [blame] | 88 | |
| 89 | return FibF; |
| 90 | } |
| 91 | |
| 92 | |
| 93 | int main(int argc, char **argv) { |
| 94 | int n = argc > 1 ? atol(argv[1]) : 24; |
Reid Spencer | e784fa4 | 2004-08-19 20:10:04 +0000 | [diff] [blame] | 95 | |
Chris Lattner | 18f0c67 | 2009-12-01 01:56:27 +0000 | [diff] [blame^] | 96 | InitializeNativeTarget(); |
Owen Anderson | 8b477ed | 2009-07-01 16:58:40 +0000 | [diff] [blame] | 97 | LLVMContext Context; |
| 98 | |
Reid Spencer | e784fa4 | 2004-08-19 20:10:04 +0000 | [diff] [blame] | 99 | // Create some module to put our function into it. |
Owen Anderson | 31895e7 | 2009-07-01 21:22:36 +0000 | [diff] [blame] | 100 | Module *M = new Module("test", Context); |
Reid Spencer | e784fa4 | 2004-08-19 20:10:04 +0000 | [diff] [blame] | 101 | |
Reid Spencer | e784fa4 | 2004-08-19 20:10:04 +0000 | [diff] [blame] | 102 | // We are about to create the "fib" function: |
Owen Anderson | 9adc0ab | 2009-07-14 23:09:55 +0000 | [diff] [blame] | 103 | Function *FibF = CreateFibFunction(M, Context); |
Reid Spencer | e784fa4 | 2004-08-19 20:10:04 +0000 | [diff] [blame] | 104 | |
Misha Brukman | 237cef4 | 2005-04-20 16:42:34 +0000 | [diff] [blame] | 105 | // Now we going to create JIT |
Chris Lattner | 18f0c67 | 2009-12-01 01:56:27 +0000 | [diff] [blame^] | 106 | std::string errStr; |
| 107 | ExecutionEngine *EE = EngineBuilder(M).setErrorStr(&errStr).setEngineKind(EngineKind::JIT).create(); |
| 108 | |
| 109 | if (!EE) { |
| 110 | errs() << argv[0] << ": Failed to construct ExecutionEngine: " << errStr << "\n"; |
| 111 | return 1; |
| 112 | } |
Reid Spencer | e784fa4 | 2004-08-19 20:10:04 +0000 | [diff] [blame] | 113 | |
Chris Lattner | 944fac7 | 2008-08-23 22:23:09 +0000 | [diff] [blame] | 114 | errs() << "verifying... "; |
Reid Spencer | e784fa4 | 2004-08-19 20:10:04 +0000 | [diff] [blame] | 115 | if (verifyModule(*M)) { |
Chris Lattner | 944fac7 | 2008-08-23 22:23:09 +0000 | [diff] [blame] | 116 | errs() << argv[0] << ": Error constructing function!\n"; |
Reid Spencer | e784fa4 | 2004-08-19 20:10:04 +0000 | [diff] [blame] | 117 | return 1; |
| 118 | } |
Reid Spencer | e784fa4 | 2004-08-19 20:10:04 +0000 | [diff] [blame] | 119 | |
Chris Lattner | 944fac7 | 2008-08-23 22:23:09 +0000 | [diff] [blame] | 120 | errs() << "OK\n"; |
| 121 | errs() << "We just constructed this LLVM module:\n\n---------\n" << *M; |
| 122 | errs() << "---------\nstarting fibonacci(" << n << ") with JIT...\n"; |
Reid Spencer | e784fa4 | 2004-08-19 20:10:04 +0000 | [diff] [blame] | 123 | |
Misha Brukman | 7cf540b | 2004-11-05 04:11:40 +0000 | [diff] [blame] | 124 | // Call the Fibonacci function with argument n: |
Chris Lattner | 38f024d | 2004-11-03 21:43:03 +0000 | [diff] [blame] | 125 | std::vector<GenericValue> Args(1); |
Reid Spencer | 34bd70d | 2007-03-06 17:24:31 +0000 | [diff] [blame] | 126 | Args[0].IntVal = APInt(32, n); |
Chris Lattner | 38f024d | 2004-11-03 21:43:03 +0000 | [diff] [blame] | 127 | GenericValue GV = EE->runFunction(FibF, Args); |
Reid Spencer | e784fa4 | 2004-08-19 20:10:04 +0000 | [diff] [blame] | 128 | |
Chris Lattner | 38f024d | 2004-11-03 21:43:03 +0000 | [diff] [blame] | 129 | // import result of execution |
Chris Lattner | 944fac7 | 2008-08-23 22:23:09 +0000 | [diff] [blame] | 130 | outs() << "Result: " << GV.IntVal << "\n"; |
Reid Spencer | e784fa4 | 2004-08-19 20:10:04 +0000 | [diff] [blame] | 131 | return 0; |
| 132 | } |