blob: 8092e19380dd3f4decbe068f7cd2aaa76a4386ab [file] [log] [blame]
Reid Spencer987319d2004-09-11 20:30:11 +00001//===--- examples/Fibonacci/fibonacci.cpp - An example use of the JIT -----===//
Misha Brukman2f72baf2005-04-20 16:42:34 +00002//
Reid Spencerf30f28e2004-08-19 20:10:04 +00003// The LLVM Compiler Infrastructure
4//
Chris Lattnerbcf65db2007-12-29 20:37:57 +00005// This file is distributed under the University of Illinois Open Source
6// License. See LICENSE.TXT for details.
Misha Brukman2f72baf2005-04-20 16:42:34 +00007//
Reid Spencerf30f28e2004-08-19 20:10:04 +00008//===----------------------------------------------------------------------===//
9//
Chris Lattnerbd2886d2004-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 Spencerf30f28e2004-08-19 20:10:04 +000012//
Chris Lattnerbd2886d2004-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 Spencerf30f28e2004-08-19 20:10:04 +000015//
Chris Lattnerbd2886d2004-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 Brukman2f72baf2005-04-20 16:42:34 +000020//
Chris Lattnerbd2886d2004-11-03 21:43:03 +000021// Once we have this, we compile the module via JIT, then execute the `fib'
Reid Spencerf30f28e2004-08-19 20:10:04 +000022// function and return result to a driver, i.e. to a "host program".
23//
Chris Lattnerbd2886d2004-11-03 21:43:03 +000024//===----------------------------------------------------------------------===//
Reid Spencerf30f28e2004-08-19 20:10:04 +000025
Chandler Carruthd7cd9ac92014-01-13 09:53:45 +000026#include "llvm/IR/Verifier.h"
Chandler Carruth605e30e2012-12-04 10:16:57 +000027#include "llvm/ExecutionEngine/GenericValue.h"
28#include "llvm/ExecutionEngine/Interpreter.h"
Chandler Carruth005f27a2013-01-02 11:56:33 +000029#include "llvm/IR/Constants.h"
30#include "llvm/IR/DerivedTypes.h"
31#include "llvm/IR/Instructions.h"
32#include "llvm/IR/LLVMContext.h"
33#include "llvm/IR/Module.h"
Evan Cheng2bb40352011-08-24 18:08:43 +000034#include "llvm/Support/TargetSelect.h"
Chandler Carruth605e30e2012-12-04 10:16:57 +000035#include "llvm/Support/raw_ostream.h"
Reid Spencerf30f28e2004-08-19 20:10:04 +000036using namespace llvm;
37
Owen Andersonb6b25302009-07-14 23:09:55 +000038static Function *CreateFibFunction(Module *M, LLVMContext &Context) {
Quentin Colombet301d05a2012-10-23 16:03:18 +000039 // Create the fib function and insert it into module M. This function is said
Chris Lattnerbd2886d2004-11-03 21:43:03 +000040 // to return an int and take an int parameter.
Chris Lattnerb800b392007-01-07 07:40:09 +000041 Function *FibF =
Arnaud A. de Grandmaison503ca9e2012-06-21 22:26:01 +000042 cast<Function>(M->getOrInsertFunction("fib", Type::getInt32Ty(Context),
Owen Anderson55f1c092009-08-13 21:58:54 +000043 Type::getInt32Ty(Context),
Chris Lattnerb800b392007-01-07 07:40:09 +000044 (Type *)0));
Misha Brukman2f72baf2005-04-20 16:42:34 +000045
Chris Lattnerbd2886d2004-11-03 21:43:03 +000046 // Add a basic block to the function.
Owen Anderson55f1c092009-08-13 21:58:54 +000047 BasicBlock *BB = BasicBlock::Create(Context, "EntryBlock", FibF);
Misha Brukman2f72baf2005-04-20 16:42:34 +000048
Chris Lattnerbd2886d2004-11-03 21:43:03 +000049 // Get pointers to the constants.
Owen Anderson55f1c092009-08-13 21:58:54 +000050 Value *One = ConstantInt::get(Type::getInt32Ty(Context), 1);
51 Value *Two = ConstantInt::get(Type::getInt32Ty(Context), 2);
Reid Spencerf30f28e2004-08-19 20:10:04 +000052
Chris Lattnerbd2886d2004-11-03 21:43:03 +000053 // Get pointer to the integer argument of the add1 function...
Alkis Evlogimenos84adfd82005-03-15 07:12:30 +000054 Argument *ArgX = FibF->arg_begin(); // Get the arg.
Chris Lattnerbd2886d2004-11-03 21:43:03 +000055 ArgX->setName("AnArg"); // Give it a nice symbolic name for fun.
56
Chris Lattnerbd2886d2004-11-03 21:43:03 +000057 // Create the true_block.
Owen Anderson55f1c092009-08-13 21:58:54 +000058 BasicBlock *RetBB = BasicBlock::Create(Context, "return", FibF);
Chris Lattnerbd2886d2004-11-03 21:43:03 +000059 // Create an exit block.
Owen Anderson55f1c092009-08-13 21:58:54 +000060 BasicBlock* RecurseBB = BasicBlock::Create(Context, "recurse", FibF);
Chris Lattnerbd2886d2004-11-03 21:43:03 +000061
Chris Lattner723f2a12008-03-13 03:29:42 +000062 // Create the "if (arg <= 2) goto exitbb"
Owen Anderson1e5f00e2009-07-09 23:48:35 +000063 Value *CondInst = new ICmpInst(*BB, ICmpInst::ICMP_SLE, ArgX, Two, "cond");
Gabor Greife9ecc682008-04-06 20:25:17 +000064 BranchInst::Create(RetBB, RecurseBB, CondInst, BB);
Chris Lattnerbd2886d2004-11-03 21:43:03 +000065
66 // Create: ret int 1
Owen Anderson55f1c092009-08-13 21:58:54 +000067 ReturnInst::Create(Context, One, RetBB);
Misha Brukman2f72baf2005-04-20 16:42:34 +000068
Chris Lattnerbd2886d2004-11-03 21:43:03 +000069 // create fib(x-1)
Gabor Greife1f6e4b2008-05-16 19:29:10 +000070 Value *Sub = BinaryOperator::CreateSub(ArgX, One, "arg", RecurseBB);
Gabor Greife9ecc682008-04-06 20:25:17 +000071 CallInst *CallFibX1 = CallInst::Create(FibF, Sub, "fibx1", RecurseBB);
Chris Lattner5879f9c2005-05-06 06:21:59 +000072 CallFibX1->setTailCall();
Misha Brukman2f72baf2005-04-20 16:42:34 +000073
Chris Lattnerbd2886d2004-11-03 21:43:03 +000074 // create fib(x-2)
Gabor Greife1f6e4b2008-05-16 19:29:10 +000075 Sub = BinaryOperator::CreateSub(ArgX, Two, "arg", RecurseBB);
Gabor Greife9ecc682008-04-06 20:25:17 +000076 CallInst *CallFibX2 = CallInst::Create(FibF, Sub, "fibx2", RecurseBB);
Chris Lattner5879f9c2005-05-06 06:21:59 +000077 CallFibX2->setTailCall();
Chris Lattnereaf625d2005-05-06 05:59:50 +000078
Chris Lattnerbd2886d2004-11-03 21:43:03 +000079
80 // fib(x-1)+fib(x-2)
Gabor Greife1f6e4b2008-05-16 19:29:10 +000081 Value *Sum = BinaryOperator::CreateAdd(CallFibX1, CallFibX2,
Chris Lattnerbd2886d2004-11-03 21:43:03 +000082 "addresult", RecurseBB);
Misha Brukman2f72baf2005-04-20 16:42:34 +000083
Chris Lattnerbd2886d2004-11-03 21:43:03 +000084 // Create the return instruction and add it to the basic block
Owen Anderson55f1c092009-08-13 21:58:54 +000085 ReturnInst::Create(Context, Sum, RecurseBB);
Chris Lattnerbd2886d2004-11-03 21:43:03 +000086
87 return FibF;
88}
89
90
91int main(int argc, char **argv) {
92 int n = argc > 1 ? atol(argv[1]) : 24;
Reid Spencerf30f28e2004-08-19 20:10:04 +000093
Chris Lattner4ba8e5d2009-12-01 01:56:27 +000094 InitializeNativeTarget();
Owen Anderson6773d382009-07-01 16:58:40 +000095 LLVMContext Context;
Arnaud A. de Grandmaison503ca9e2012-06-21 22:26:01 +000096
Reid Spencerf30f28e2004-08-19 20:10:04 +000097 // Create some module to put our function into it.
Rafael Espindola2a8a2792014-08-19 04:04:25 +000098 std::unique_ptr<Module> Owner(new Module("test", Context));
99 Module *M = Owner.get();
Reid Spencerf30f28e2004-08-19 20:10:04 +0000100
Reid Spencerf30f28e2004-08-19 20:10:04 +0000101 // We are about to create the "fib" function:
Rafael Espindola2a8a2792014-08-19 04:04:25 +0000102 Function *FibF = CreateFibFunction(M, Context);
Reid Spencerf30f28e2004-08-19 20:10:04 +0000103
Misha Brukman2f72baf2005-04-20 16:42:34 +0000104 // Now we going to create JIT
Chris Lattner4ba8e5d2009-12-01 01:56:27 +0000105 std::string errStr;
Chris Lattner7b7768a2010-09-05 23:09:30 +0000106 ExecutionEngine *EE =
Rafael Espindola2a8a2792014-08-19 04:04:25 +0000107 EngineBuilder(std::move(Owner))
Chris Lattner7b7768a2010-09-05 23:09:30 +0000108 .setErrorStr(&errStr)
109 .setEngineKind(EngineKind::JIT)
110 .create();
Chris Lattner4ba8e5d2009-12-01 01:56:27 +0000111
112 if (!EE) {
Chris Lattner7b7768a2010-09-05 23:09:30 +0000113 errs() << argv[0] << ": Failed to construct ExecutionEngine: " << errStr
114 << "\n";
Chris Lattner4ba8e5d2009-12-01 01:56:27 +0000115 return 1;
116 }
Reid Spencerf30f28e2004-08-19 20:10:04 +0000117
Chris Lattner0c19df42008-08-23 22:23:09 +0000118 errs() << "verifying... ";
Reid Spencerf30f28e2004-08-19 20:10:04 +0000119 if (verifyModule(*M)) {
Chris Lattner0c19df42008-08-23 22:23:09 +0000120 errs() << argv[0] << ": Error constructing function!\n";
Reid Spencerf30f28e2004-08-19 20:10:04 +0000121 return 1;
122 }
Reid Spencerf30f28e2004-08-19 20:10:04 +0000123
Chris Lattner0c19df42008-08-23 22:23:09 +0000124 errs() << "OK\n";
125 errs() << "We just constructed this LLVM module:\n\n---------\n" << *M;
126 errs() << "---------\nstarting fibonacci(" << n << ") with JIT...\n";
Reid Spencerf30f28e2004-08-19 20:10:04 +0000127
Misha Brukmana73e7ca2004-11-05 04:11:40 +0000128 // Call the Fibonacci function with argument n:
Chris Lattnerbd2886d2004-11-03 21:43:03 +0000129 std::vector<GenericValue> Args(1);
Reid Spencer8a9ae482007-03-06 17:24:31 +0000130 Args[0].IntVal = APInt(32, n);
Chris Lattnerbd2886d2004-11-03 21:43:03 +0000131 GenericValue GV = EE->runFunction(FibF, Args);
Reid Spencerf30f28e2004-08-19 20:10:04 +0000132
Chris Lattnerbd2886d2004-11-03 21:43:03 +0000133 // import result of execution
Chris Lattner0c19df42008-08-23 22:23:09 +0000134 outs() << "Result: " << GV.IntVal << "\n";
Arnaud A. de Grandmaison503ca9e2012-06-21 22:26:01 +0000135
Reid Spencerf30f28e2004-08-19 20:10:04 +0000136 return 0;
137}