polly/www/get_started.html - external/github.com/llvm/llvm-project.git - Git at Google

 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
           "http://www.w3.org/TR/html4/strict.dtd">
 <html>
 <head>
   <META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
   <title>Polly - Getting Started</title>
   <link type="text/css" rel="stylesheet" href="menu.css" />
   <link type="text/css" rel="stylesheet" href="content.css" />
 </head>
 <body>

 <!--#include virtual="menu.html.incl"-->

 <div id="content">

 <h1>Getting Started: Building and Installing Polly</h1>


 <h2 id="prerequisites"> Prerequisites </h2>

 The following prerequisites can be installed through the package management
 system of your operating system.

 <ul>
 <li>libgmp (library + developer package)</li>
 </ul>

 <h3> Install ISL / CLooG libraries </h3>

 Polly requires the latest versions of <a href="http://www.cloog.org">CLooG</a>
 and <a href="http://repo.or.cz/w/isl.git">isl</a> checked out at
 commit cd1939ed06617d00159e8e51b72a804b467e98b4.

 <h4> First installation</h4>
 <pre>
 git clone git://repo.or.cz/cloog.git
 cd cloog
 git checkout cloog-0.16.3
 ./get_submodules.sh
 cd isl
 git remote update
 git checkout cd1939ed06617d00159e8e51b72a804b467e98b4
 cd ..
 ./autogen.sh
 ./configure --with-gmp-prefix=/path/to/gmp/installation --prefix=/path/to/cloog/installation
 make
 make install
 </pre>

 <h4> Update an earlier installation</h4>
 <pre>
 cd cloog
 git remote update
 git checkout cloog-0.16.3
 cd isl
 git remote update
 git checkout cd1939ed06617d00159e8e51b72a804b467e98b4
 cd ..
 make
 make install
 </pre>

 <h3> Install Pocc (Optional) </h3>

 <p>Polly can use <a href="http://www.cse.ohio-state.edu/~pouchet/software/pocc">
 PoCC</a> as an external optimizer. PoCC is a research project that provides
 an integrated version of <a href="http://pluto.sf.net">Pluto</a>, an
 advanced data-locality and tileability optimizer. Similar functionality was
 recently integrated in Polly (through isl), however the optimizations are not as
 mature as the ones in Pluto/PoCC. Hence, if you want to use Pluto to optimize
 your code or you want to compare the optimizer integrated in Polly to Pluto you
 may want to use PoCC.</p>

 Install PoCC 1.0-rc3.1 (the one with Polly support) and add it to your PATH.

 <pre>
 wget <a
 href="http://www.cse.ohio-state.edu/~pouchet/software/pocc/download/pocc-1.0-rc3.1-full.tar.gz">http://www.cse.ohio-state.edu/~pouchet/software/pocc/download/pocc-1.0-rc3.1-full.tar.gz</a>
 tar xzf pocc-1.0-rc3.1-full.tar.gz
 cd pocc-1.0-rc3.1
 ./install.sh
 export PATH=`pwd`/bin
 </pre>

 Install scoplib-0.2.0

 <pre>
 wget <a
 href="http://www.cse.ohio-state.edu/~pouchet/software/pocc/download/modules/scoplib-0.2.0.tar.gz"
 >http://www.cse.ohio-state.edu/~pouchet/software/pocc/download/modules/scoplib-0.2.0.tar.gz</a>
 tar xzf  scoplib-0.2.0.tar.gz
 cd scoplib-0.2.0
 ./configure --enable-mp-version --prefix=/path/to/scoplib/installation
 make && make install
 </pre>

 <h2 id="source"> Get the code </h2>

 <p>
 The Polly source code is available in the LLVM SVN repository. For convenience
 we also provide a git mirror. To build Polly we extract its source code into the
 <em>tools</em> directory of the llvm sources.</p>
 <b>A recent LLVM checkout is needed. Older versions may not work!</b>

 <h3>SVN</h3>
 <pre>
 export LLVM_SRC=`pwd`/llvm
 svn checkout http://llvm.org/svn/llvm-project/llvm/trunk ${LLVM_SRC}
 cd ${LLVM_SRC}/tools
 svn checkout http://llvm.org/svn/llvm-project/polly/trunk polly
 </pre>
 <h3>GIT</h3>
 <pre>
 export LLVM_SRC=`pwd`/llvm
 git clone http://llvm.org/git/llvm.git ${LLVM_SRC}
 cd ${LLVM_SRC}/tools
 git clone http://llvm.org/git/polly.git
 </pre>


 <h2 id="build">Build Polly</h2>

 To build Polly you can either use the autoconf or the cmake build system. At the
 moment only the autoconf build system allows to run the llvm test-suite and only
 the cmake build system allows to run 'make polly-test'.

 <h3>CMake</h3>

 <pre>
 mkdir build
 cd build
 cmake ${LLVM_SRC}

 # If CMAKE cannot find CLooG and ISL
 cmake -DCMAKE_PREFIX_PATH=/cloog/installation .

 # To point CMAKE to the scoplib source
 cmake -DCMAKE_PREFIX_PATH=/scoplib/installation .

 make
 </pre>

 <h3> Autoconf </h2>

 <pre>
 mkdir build
 cd build
 ${LLVM_SRC}/configure --with-cloog=/cloog/installation --with-isl=/cloog/installation --with-scoplib=/scoplib/installation
 make
 </pre>

 <h2> Test Polly</h2>

 To check if Polly works correctly you can run <em>make polly-test</em>. This
 currently works only with a cmake build.
 </div>
 </body>
 </html>
	<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
	"http://www.w3.org/TR/html4/strict.dtd">
	<html>
	<head>
	<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
	<title>Polly - Getting Started</title>
	<link type="text/css" rel="stylesheet" href="menu.css" />
	<link type="text/css" rel="stylesheet" href="content.css" />
	</head>
	<body>

	<!--#include virtual="menu.html.incl"-->

	<div id="content">

	<h1>Getting Started: Building and Installing Polly</h1>


	<h2 id="prerequisites"> Prerequisites </h2>

	The following prerequisites can be installed through the package management
	system of your operating system.

	<ul>
	<li>libgmp (library + developer package)</li>
	</ul>

	<h3> Install ISL / CLooG libraries </h3>

	Polly requires the latest versions of <a href="http://www.cloog.org">CLooG</a>
	and <a href="http://repo.or.cz/w/isl.git">isl</a> checked out at
	commit cd1939ed06617d00159e8e51b72a804b467e98b4.

	<h4> First installation</h4>
	<pre>
	git clone git://repo.or.cz/cloog.git
	cd cloog
	git checkout cloog-0.16.3
	./get_submodules.sh
	cd isl
	git remote update
	git checkout cd1939ed06617d00159e8e51b72a804b467e98b4
	cd ..
	./autogen.sh
	./configure --with-gmp-prefix=/path/to/gmp/installation --prefix=/path/to/cloog/installation
	make
	make install
	</pre>

	<h4> Update an earlier installation</h4>
	<pre>
	cd cloog
	git remote update
	git checkout cloog-0.16.3
	cd isl
	git remote update
	git checkout cd1939ed06617d00159e8e51b72a804b467e98b4
	cd ..
	make
	make install
	</pre>

	<h3> Install Pocc (Optional) </h3>

	<p>Polly can use <a href="http://www.cse.ohio-state.edu/~pouchet/software/pocc">
	PoCC</a> as an external optimizer. PoCC is a research project that provides
	an integrated version of <a href="http://pluto.sf.net">Pluto</a>, an
	advanced data-locality and tileability optimizer. Similar functionality was
	recently integrated in Polly (through isl), however the optimizations are not as
	mature as the ones in Pluto/PoCC. Hence, if you want to use Pluto to optimize
	your code or you want to compare the optimizer integrated in Polly to Pluto you
	may want to use PoCC.</p>

	Install PoCC 1.0-rc3.1 (the one with Polly support) and add it to your PATH.

	<pre>
	wget <a
	href="http://www.cse.ohio-state.edu/~pouchet/software/pocc/download/pocc-1.0-rc3.1-full.tar.gz">http://www.cse.ohio-state.edu/~pouchet/software/pocc/download/pocc-1.0-rc3.1-full.tar.gz</a>
	tar xzf pocc-1.0-rc3.1-full.tar.gz
	cd pocc-1.0-rc3.1
	./install.sh
	export PATH=`pwd`/bin
	</pre>

	Install scoplib-0.2.0

	<pre>
	wget <a
	href="http://www.cse.ohio-state.edu/~pouchet/software/pocc/download/modules/scoplib-0.2.0.tar.gz"
	>http://www.cse.ohio-state.edu/~pouchet/software/pocc/download/modules/scoplib-0.2.0.tar.gz</a>
	tar xzf scoplib-0.2.0.tar.gz
	cd scoplib-0.2.0
	./configure --enable-mp-version --prefix=/path/to/scoplib/installation
	make && make install
	</pre>

	<h2 id="source"> Get the code </h2>

	<p>
	The Polly source code is available in the LLVM SVN repository. For convenience
	we also provide a git mirror. To build Polly we extract its source code into the
	<em>tools</em> directory of the llvm sources.</p>
	<b>A recent LLVM checkout is needed. Older versions may not work!</b>

	<h3>SVN</h3>
	<pre>
	export LLVM_SRC=`pwd`/llvm
	svn checkout http://llvm.org/svn/llvm-project/llvm/trunk ${LLVM_SRC}
	cd ${LLVM_SRC}/tools
	svn checkout http://llvm.org/svn/llvm-project/polly/trunk polly
	</pre>
	<h3>GIT</h3>
	<pre>
	export LLVM_SRC=`pwd`/llvm
	git clone http://llvm.org/git/llvm.git ${LLVM_SRC}
	cd ${LLVM_SRC}/tools
	git clone http://llvm.org/git/polly.git
	</pre>



	<h2 id="build">Build Polly</h2>

	To build Polly you can either use the autoconf or the cmake build system. At the
	moment only the autoconf build system allows to run the llvm test-suite and only
	the cmake build system allows to run 'make polly-test'.

	<h3>CMake</h3>

	<pre>
	mkdir build
	cd build
	cmake ${LLVM_SRC}

	# If CMAKE cannot find CLooG and ISL
	cmake -DCMAKE_PREFIX_PATH=/cloog/installation .

	# To point CMAKE to the scoplib source
	cmake -DCMAKE_PREFIX_PATH=/scoplib/installation .

	make
	</pre>

	<h3> Autoconf </h2>

	<pre>
	mkdir build
	cd build
	${LLVM_SRC}/configure --with-cloog=/cloog/installation --with-isl=/cloog/installation --with-scoplib=/scoplib/installation
	make
	</pre>

	<h2> Test Polly</h2>

	To check if Polly works correctly you can run <em>make polly-test</em>. This
	currently works only with a cmake build.
	</div>
	</body>
	</html>