blob: 89f3ef2d753d2c6bf984724e67b5e86ff880f31c [file] [log] [blame]
Dan Gohmanf17a25c2007-07-18 16:29:46 +00001//===--- examples/Fibonacci/fibonacci.cpp - An example use of the JIT -----===//
2//
3// The LLVM Compiler Infrastructure
4//
Chris Lattner45ca7c12007-12-29 20:37:57 +00005// This file is distributed under the University of Illinois Open Source
6// License. See LICENSE.TXT for details.
Dan Gohmanf17a25c2007-07-18 16:29:46 +00007//
8//===----------------------------------------------------------------------===//
9//
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.
12//
13// The goal of this snippet is to create in the memory the LLVM module
14// consisting of one function as follow:
15//
16// int fib(int x) {
17// if(x<=2) return 1;
18// return fib(x-1)+fib(x-2);
19// }
20//
21// Once we have this, we compile the module via JIT, then execute the `fib'
22// function and return result to a driver, i.e. to a "host program".
23//
24//===----------------------------------------------------------------------===//
25
Owen Anderson25209b42009-07-01 16:58:40 +000026#include "llvm/LLVMContext.h"
Dan Gohmanf17a25c2007-07-18 16:29:46 +000027#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"
33#include "llvm/ExecutionEngine/JIT.h"
34#include "llvm/ExecutionEngine/Interpreter.h"
35#include "llvm/ExecutionEngine/GenericValue.h"
Chris Lattner1fefaac2008-08-23 22:23:09 +000036#include "llvm/Support/raw_ostream.h"
Dan Gohmanf17a25c2007-07-18 16:29:46 +000037using namespace llvm;
38
39static Function *CreateFibFunction(Module *M) {
40 // Create the fib function and insert it into module M. This function is said
41 // to return an int and take an int parameter.
42 Function *FibF =
43 cast<Function>(M->getOrInsertFunction("fib", Type::Int32Ty, Type::Int32Ty,
44 (Type *)0));
45
46 // Add a basic block to the function.
Gabor Greifd6da1d02008-04-06 20:25:17 +000047 BasicBlock *BB = BasicBlock::Create("EntryBlock", FibF);
Dan Gohmanf17a25c2007-07-18 16:29:46 +000048
49 // Get pointers to the constants.
50 Value *One = ConstantInt::get(Type::Int32Ty, 1);
51 Value *Two = ConstantInt::get(Type::Int32Ty, 2);
52
53 // Get pointer to the integer argument of the add1 function...
54 Argument *ArgX = FibF->arg_begin(); // Get the arg.
55 ArgX->setName("AnArg"); // Give it a nice symbolic name for fun.
56
57 // Create the true_block.
Gabor Greifd6da1d02008-04-06 20:25:17 +000058 BasicBlock *RetBB = BasicBlock::Create("return", FibF);
Dan Gohmanf17a25c2007-07-18 16:29:46 +000059 // Create an exit block.
Gabor Greifd6da1d02008-04-06 20:25:17 +000060 BasicBlock* RecurseBB = BasicBlock::Create("recurse", FibF);
Dan Gohmanf17a25c2007-07-18 16:29:46 +000061
Chris Lattnerd6298a32008-03-13 03:29:42 +000062 // Create the "if (arg <= 2) goto exitbb"
Owen Anderson6601fcd2009-07-09 23:48:35 +000063 Value *CondInst = new ICmpInst(*BB, ICmpInst::ICMP_SLE, ArgX, Two, "cond");
Gabor Greifd6da1d02008-04-06 20:25:17 +000064 BranchInst::Create(RetBB, RecurseBB, CondInst, BB);
Dan Gohmanf17a25c2007-07-18 16:29:46 +000065
66 // Create: ret int 1
Gabor Greifd6da1d02008-04-06 20:25:17 +000067 ReturnInst::Create(One, RetBB);
Dan Gohmanf17a25c2007-07-18 16:29:46 +000068
69 // create fib(x-1)
Gabor Greifa645dd32008-05-16 19:29:10 +000070 Value *Sub = BinaryOperator::CreateSub(ArgX, One, "arg", RecurseBB);
Gabor Greifd6da1d02008-04-06 20:25:17 +000071 CallInst *CallFibX1 = CallInst::Create(FibF, Sub, "fibx1", RecurseBB);
Dan Gohmanf17a25c2007-07-18 16:29:46 +000072 CallFibX1->setTailCall();
73
74 // create fib(x-2)
Gabor Greifa645dd32008-05-16 19:29:10 +000075 Sub = BinaryOperator::CreateSub(ArgX, Two, "arg", RecurseBB);
Gabor Greifd6da1d02008-04-06 20:25:17 +000076 CallInst *CallFibX2 = CallInst::Create(FibF, Sub, "fibx2", RecurseBB);
Dan Gohmanf17a25c2007-07-18 16:29:46 +000077 CallFibX2->setTailCall();
78
79
80 // fib(x-1)+fib(x-2)
Gabor Greifa645dd32008-05-16 19:29:10 +000081 Value *Sum = BinaryOperator::CreateAdd(CallFibX1, CallFibX2,
Dan Gohmanf17a25c2007-07-18 16:29:46 +000082 "addresult", RecurseBB);
83
84 // Create the return instruction and add it to the basic block
Gabor Greifd6da1d02008-04-06 20:25:17 +000085 ReturnInst::Create(Sum, RecurseBB);
Dan Gohmanf17a25c2007-07-18 16:29:46 +000086
87 return FibF;
88}
89
90
91int main(int argc, char **argv) {
92 int n = argc > 1 ? atol(argv[1]) : 24;
93
Owen Anderson25209b42009-07-01 16:58:40 +000094 LLVMContext Context;
95
Dan Gohmanf17a25c2007-07-18 16:29:46 +000096 // Create some module to put our function into it.
Owen Andersona148fdd2009-07-01 21:22:36 +000097 Module *M = new Module("test", Context);
Dan Gohmanf17a25c2007-07-18 16:29:46 +000098
99 // We are about to create the "fib" function:
100 Function *FibF = CreateFibFunction(M);
101
102 // Now we going to create JIT
103 ExistingModuleProvider *MP = new ExistingModuleProvider(M);
104 ExecutionEngine *EE = ExecutionEngine::create(MP, false);
105
Chris Lattner1fefaac2008-08-23 22:23:09 +0000106 errs() << "verifying... ";
Dan Gohmanf17a25c2007-07-18 16:29:46 +0000107 if (verifyModule(*M)) {
Chris Lattner1fefaac2008-08-23 22:23:09 +0000108 errs() << argv[0] << ": Error constructing function!\n";
Dan Gohmanf17a25c2007-07-18 16:29:46 +0000109 return 1;
110 }
111
Chris Lattner1fefaac2008-08-23 22:23:09 +0000112 errs() << "OK\n";
113 errs() << "We just constructed this LLVM module:\n\n---------\n" << *M;
114 errs() << "---------\nstarting fibonacci(" << n << ") with JIT...\n";
Dan Gohmanf17a25c2007-07-18 16:29:46 +0000115
116 // Call the Fibonacci function with argument n:
117 std::vector<GenericValue> Args(1);
118 Args[0].IntVal = APInt(32, n);
119 GenericValue GV = EE->runFunction(FibF, Args);
120
121 // import result of execution
Chris Lattner1fefaac2008-08-23 22:23:09 +0000122 outs() << "Result: " << GV.IntVal << "\n";
Dan Gohmanf17a25c2007-07-18 16:29:46 +0000123 return 0;
124}