blob: 7c24e9e2fc8eeeaabab6156d22a1f64d811be976 [file] [log] [blame]
Reid Spencer66e7cd02004-09-11 20:30:11 +00001//===--- examples/Fibonacci/fibonacci.cpp - An example use of the JIT -----===//
Misha Brukman237cef42005-04-20 16:42:34 +00002//
Reid Spencere784fa42004-08-19 20:10:04 +00003// The LLVM Compiler Infrastructure
4//
5// This file was developed by Valery A. Khamenya and is distributed under the
6// University of Illinois Open Source License. See LICENSE.TXT for details.
Misha Brukman237cef42005-04-20 16:42:34 +00007//
Reid Spencere784fa42004-08-19 20:10:04 +00008//===----------------------------------------------------------------------===//
9//
Chris Lattner38f024d2004-11-03 21:43:03 +000010// 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 Spencere784fa42004-08-19 20:10:04 +000012//
Chris Lattner38f024d2004-11-03 21:43:03 +000013// The goal of this snippet is to create in the memory the LLVM module
14// consisting of one function as follow:
Reid Spencere784fa42004-08-19 20:10:04 +000015//
Chris Lattner38f024d2004-11-03 21:43:03 +000016// int fib(int x) {
17// if(x<=2) return 1;
18// return fib(x-1)+fib(x-2);
19// }
Misha Brukman237cef42005-04-20 16:42:34 +000020//
Chris Lattner38f024d2004-11-03 21:43:03 +000021// Once we have this, we compile the module via JIT, then execute the `fib'
Reid Spencere784fa42004-08-19 20:10:04 +000022// function and return result to a driver, i.e. to a "host program".
23//
Chris Lattner38f024d2004-11-03 21:43:03 +000024//===----------------------------------------------------------------------===//
Reid Spencere784fa42004-08-19 20:10:04 +000025
Chris Lattner38f024d2004-11-03 21:43:03 +000026#include "llvm/Module.h"
27#include "llvm/DerivedTypes.h"
28#include "llvm/Constants.h"
29#include "llvm/Instructions.h"
30#include "llvm/ModuleProvider.h"
31#include "llvm/Analysis/Verifier.h"
Reid Spencere784fa42004-08-19 20:10:04 +000032#include "llvm/ExecutionEngine/ExecutionEngine.h"
33#include "llvm/ExecutionEngine/GenericValue.h"
Chris Lattner38f024d2004-11-03 21:43:03 +000034#include <iostream>
Reid Spencere784fa42004-08-19 20:10:04 +000035using namespace llvm;
36
Chris Lattner38f024d2004-11-03 21:43:03 +000037static Function *CreateFibFunction(Module *M) {
38 // Create the fib function and insert it into module M. This function is said
39 // to return an int and take an int parameter.
40 Function *FibF = M->getOrInsertFunction("fib", Type::IntTy, Type::IntTy, 0);
Misha Brukman237cef42005-04-20 16:42:34 +000041
Chris Lattner38f024d2004-11-03 21:43:03 +000042 // Add a basic block to the function.
43 BasicBlock *BB = new BasicBlock("EntryBlock", FibF);
Misha Brukman237cef42005-04-20 16:42:34 +000044
Chris Lattner38f024d2004-11-03 21:43:03 +000045 // Get pointers to the constants.
46 Value *One = ConstantSInt::get(Type::IntTy, 1);
47 Value *Two = ConstantSInt::get(Type::IntTy, 2);
Reid Spencere784fa42004-08-19 20:10:04 +000048
Chris Lattner38f024d2004-11-03 21:43:03 +000049 // Get pointer to the integer argument of the add1 function...
Alkis Evlogimenosdadf8812005-03-15 07:12:30 +000050 Argument *ArgX = FibF->arg_begin(); // Get the arg.
Chris Lattner38f024d2004-11-03 21:43:03 +000051 ArgX->setName("AnArg"); // Give it a nice symbolic name for fun.
52
Chris Lattner38f024d2004-11-03 21:43:03 +000053 // Create the true_block.
54 BasicBlock *RetBB = new BasicBlock("return", FibF);
55 // Create an exit block.
56 BasicBlock* RecurseBB = new BasicBlock("recurse", FibF);
57
58 // Create the "if (arg < 2) goto exitbb"
59 Value *CondInst = BinaryOperator::createSetLE(ArgX, Two, "cond", BB);
60 new BranchInst(RetBB, RecurseBB, CondInst, BB);
61
62 // Create: ret int 1
63 new ReturnInst(One, RetBB);
Misha Brukman237cef42005-04-20 16:42:34 +000064
Chris Lattner38f024d2004-11-03 21:43:03 +000065 // create fib(x-1)
66 Value *Sub = BinaryOperator::createSub(ArgX, One, "arg", RecurseBB);
67 Value *CallFibX1 = new CallInst(FibF, Sub, "fibx1", RecurseBB);
Chris Lattner47968e42005-05-06 05:59:50 +000068 CallFibX1->setTailCall(true);
Misha Brukman237cef42005-04-20 16:42:34 +000069
Chris Lattner38f024d2004-11-03 21:43:03 +000070 // create fib(x-2)
71 Sub = BinaryOperator::createSub(ArgX, Two, "arg", RecurseBB);
72 Value *CallFibX2 = new CallInst(FibF, Sub, "fibx2", RecurseBB);
Chris Lattner47968e42005-05-06 05:59:50 +000073 CallFibX2->setTailCall(true);
74
Chris Lattner38f024d2004-11-03 21:43:03 +000075
76 // fib(x-1)+fib(x-2)
77 Value *Sum = BinaryOperator::createAdd(CallFibX1, CallFibX2,
78 "addresult", RecurseBB);
Misha Brukman237cef42005-04-20 16:42:34 +000079
Chris Lattner38f024d2004-11-03 21:43:03 +000080 // Create the return instruction and add it to the basic block
81 new ReturnInst(Sum, RecurseBB);
82
83 return FibF;
84}
85
86
87int main(int argc, char **argv) {
88 int n = argc > 1 ? atol(argv[1]) : 24;
Reid Spencere784fa42004-08-19 20:10:04 +000089
90 // Create some module to put our function into it.
91 Module *M = new Module("test");
92
Reid Spencere784fa42004-08-19 20:10:04 +000093 // We are about to create the "fib" function:
Chris Lattner38f024d2004-11-03 21:43:03 +000094 Function *FibF = CreateFibFunction(M);
Reid Spencere784fa42004-08-19 20:10:04 +000095
Misha Brukman237cef42005-04-20 16:42:34 +000096 // Now we going to create JIT
Chris Lattner38f024d2004-11-03 21:43:03 +000097 ExistingModuleProvider *MP = new ExistingModuleProvider(M);
98 ExecutionEngine *EE = ExecutionEngine::create(MP, false);
Reid Spencere784fa42004-08-19 20:10:04 +000099
Chris Lattner38f024d2004-11-03 21:43:03 +0000100 std::cerr << "verifying... ";
Reid Spencere784fa42004-08-19 20:10:04 +0000101 if (verifyModule(*M)) {
Chris Lattner38f024d2004-11-03 21:43:03 +0000102 std::cerr << argv[0] << ": Error constructing function!\n";
Reid Spencere784fa42004-08-19 20:10:04 +0000103 return 1;
104 }
Reid Spencere784fa42004-08-19 20:10:04 +0000105
Chris Lattner38f024d2004-11-03 21:43:03 +0000106 std::cerr << "OK\n";
107 std::cerr << "We just constructed this LLVM module:\n\n---------\n" << *M;
Misha Brukman7cf540b2004-11-05 04:11:40 +0000108 std::cerr << "---------\nstarting fibonacci(" << n << ") with JIT...\n";
Reid Spencere784fa42004-08-19 20:10:04 +0000109
Misha Brukman7cf540b2004-11-05 04:11:40 +0000110 // Call the Fibonacci function with argument n:
Chris Lattner38f024d2004-11-03 21:43:03 +0000111 std::vector<GenericValue> Args(1);
Chris Lattner3c7d7ee2004-11-04 05:00:18 +0000112 Args[0].IntVal = n;
Chris Lattner38f024d2004-11-03 21:43:03 +0000113 GenericValue GV = EE->runFunction(FibF, Args);
Reid Spencere784fa42004-08-19 20:10:04 +0000114
Chris Lattner38f024d2004-11-03 21:43:03 +0000115 // import result of execution
116 std::cout << "Result: " << GV.IntVal << "\n";
Reid Spencere784fa42004-08-19 20:10:04 +0000117 return 0;
118}