blob: cdc84ca2122317ee6e8192ff4904421c2ed32b48 [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"
Jeff Cohenafebb442006-03-24 03:11:31 +000032#include "llvm/ExecutionEngine/JIT.h"
33#include "llvm/ExecutionEngine/Interpreter.h"
Reid Spencere784fa42004-08-19 20:10:04 +000034#include "llvm/ExecutionEngine/GenericValue.h"
Chris Lattner38f024d2004-11-03 21:43:03 +000035#include <iostream>
Reid Spencere784fa42004-08-19 20:10:04 +000036using namespace llvm;
37
Chris Lattner38f024d2004-11-03 21:43:03 +000038static Function *CreateFibFunction(Module *M) {
39 // Create the fib function and insert it into module M. This function is said
40 // to return an int and take an int parameter.
Jeff Cohen66c5fd62005-10-23 04:37:20 +000041 Function *FibF = M->getOrInsertFunction("fib", Type::IntTy, Type::IntTy,
42 (Type *)0);
Misha Brukman237cef42005-04-20 16:42:34 +000043
Chris Lattner38f024d2004-11-03 21:43:03 +000044 // Add a basic block to the function.
45 BasicBlock *BB = new BasicBlock("EntryBlock", FibF);
Misha Brukman237cef42005-04-20 16:42:34 +000046
Chris Lattner38f024d2004-11-03 21:43:03 +000047 // Get pointers to the constants.
48 Value *One = ConstantSInt::get(Type::IntTy, 1);
49 Value *Two = ConstantSInt::get(Type::IntTy, 2);
Reid Spencere784fa42004-08-19 20:10:04 +000050
Chris Lattner38f024d2004-11-03 21:43:03 +000051 // Get pointer to the integer argument of the add1 function...
Alkis Evlogimenosdadf8812005-03-15 07:12:30 +000052 Argument *ArgX = FibF->arg_begin(); // Get the arg.
Chris Lattner38f024d2004-11-03 21:43:03 +000053 ArgX->setName("AnArg"); // Give it a nice symbolic name for fun.
54
Chris Lattner38f024d2004-11-03 21:43:03 +000055 // Create the true_block.
56 BasicBlock *RetBB = new BasicBlock("return", FibF);
57 // Create an exit block.
58 BasicBlock* RecurseBB = new BasicBlock("recurse", FibF);
59
60 // Create the "if (arg < 2) goto exitbb"
61 Value *CondInst = BinaryOperator::createSetLE(ArgX, Two, "cond", BB);
62 new BranchInst(RetBB, RecurseBB, CondInst, BB);
63
64 // Create: ret int 1
65 new ReturnInst(One, RetBB);
Misha Brukman237cef42005-04-20 16:42:34 +000066
Chris Lattner38f024d2004-11-03 21:43:03 +000067 // create fib(x-1)
68 Value *Sub = BinaryOperator::createSub(ArgX, One, "arg", RecurseBB);
Chris Lattnerf6b5c1a2005-05-06 06:21:59 +000069 CallInst *CallFibX1 = new CallInst(FibF, Sub, "fibx1", RecurseBB);
70 CallFibX1->setTailCall();
Misha Brukman237cef42005-04-20 16:42:34 +000071
Chris Lattner38f024d2004-11-03 21:43:03 +000072 // create fib(x-2)
73 Sub = BinaryOperator::createSub(ArgX, Two, "arg", RecurseBB);
Chris Lattnerf6b5c1a2005-05-06 06:21:59 +000074 CallInst *CallFibX2 = new CallInst(FibF, Sub, "fibx2", RecurseBB);
75 CallFibX2->setTailCall();
Chris Lattner47968e42005-05-06 05:59:50 +000076
Chris Lattner38f024d2004-11-03 21:43:03 +000077
78 // fib(x-1)+fib(x-2)
79 Value *Sum = BinaryOperator::createAdd(CallFibX1, CallFibX2,
80 "addresult", RecurseBB);
Misha Brukman237cef42005-04-20 16:42:34 +000081
Chris Lattner38f024d2004-11-03 21:43:03 +000082 // Create the return instruction and add it to the basic block
83 new ReturnInst(Sum, RecurseBB);
84
85 return FibF;
86}
87
88
89int main(int argc, char **argv) {
90 int n = argc > 1 ? atol(argv[1]) : 24;
Reid Spencere784fa42004-08-19 20:10:04 +000091
92 // Create some module to put our function into it.
93 Module *M = new Module("test");
94
Reid Spencere784fa42004-08-19 20:10:04 +000095 // We are about to create the "fib" function:
Chris Lattner38f024d2004-11-03 21:43:03 +000096 Function *FibF = CreateFibFunction(M);
Reid Spencere784fa42004-08-19 20:10:04 +000097
Misha Brukman237cef42005-04-20 16:42:34 +000098 // Now we going to create JIT
Chris Lattner38f024d2004-11-03 21:43:03 +000099 ExistingModuleProvider *MP = new ExistingModuleProvider(M);
100 ExecutionEngine *EE = ExecutionEngine::create(MP, false);
Reid Spencere784fa42004-08-19 20:10:04 +0000101
Chris Lattner38f024d2004-11-03 21:43:03 +0000102 std::cerr << "verifying... ";
Reid Spencere784fa42004-08-19 20:10:04 +0000103 if (verifyModule(*M)) {
Chris Lattner38f024d2004-11-03 21:43:03 +0000104 std::cerr << argv[0] << ": Error constructing function!\n";
Reid Spencere784fa42004-08-19 20:10:04 +0000105 return 1;
106 }
Reid Spencere784fa42004-08-19 20:10:04 +0000107
Chris Lattner38f024d2004-11-03 21:43:03 +0000108 std::cerr << "OK\n";
109 std::cerr << "We just constructed this LLVM module:\n\n---------\n" << *M;
Misha Brukman7cf540b2004-11-05 04:11:40 +0000110 std::cerr << "---------\nstarting fibonacci(" << n << ") with JIT...\n";
Reid Spencere784fa42004-08-19 20:10:04 +0000111
Misha Brukman7cf540b2004-11-05 04:11:40 +0000112 // Call the Fibonacci function with argument n:
Chris Lattner38f024d2004-11-03 21:43:03 +0000113 std::vector<GenericValue> Args(1);
Chris Lattner3c7d7ee2004-11-04 05:00:18 +0000114 Args[0].IntVal = n;
Chris Lattner38f024d2004-11-03 21:43:03 +0000115 GenericValue GV = EE->runFunction(FibF, Args);
Reid Spencere784fa42004-08-19 20:10:04 +0000116
Chris Lattner38f024d2004-11-03 21:43:03 +0000117 // import result of execution
118 std::cout << "Result: " << GV.IntVal << "\n";
Reid Spencere784fa42004-08-19 20:10:04 +0000119 return 0;
120}