Compiling and Installing AESOP

Requirements

• The GNU "gold" linker
• Some OS which LLVM supports.
• GCC 4.6-4.8, (for Dragonegg) if you want to use the GCC-based aesopfort and aesopgcc drivers. Dragonegg works best with GCC 4.6.

We mostly test on x86 Linux, but everything should work on other architectures and FreeBSD/OSX with only a small effort.

On debian-like systems, to install build dependencies, try
sudo aptitude install binutils-gold binutils-dev python man-db bc

Ensure that running ld --version reports that you are using the "gold" linker by creating a link to /usr/bin/ld.gold as ld in your PATH.

To additionally grab GCC 4.6 for Dragonegg:
sudo aptitude install {gcc,gfortran,g++}-4.6{,-multilib} gcc-4.6-plugin-dev

Building AESOP

AESOP is an LLVM project, but we build LLVM with a few patches. This guide should get you started.

• Choose a path to install LLVM/AESOP to. Something like $HOME/opt is good. Call this PREFIX. Create it and set up some environment variables:
  

     mkdir $PREFIX
     export PATH=$PREFIX/bin:$PATH
     export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$PREFIX/lib

• Download and extract the LLVM 3.3 sources somewhere else, say $HOME/llvm-3.3. Call this LLVM_SRC.
• Download and extract the Clang 3.3 sources to $LLVM_SRC/tools/clang.
• Download AESOP from bitbucket to somewhere else, say $HOME/aesop. Call this AESOP_SRC.
  NOTE: ~/aesop MUST be $AESOP_SRC or a link to it right now. Sorry.
• Apply the LTO patch to LLVM:
  

     cd $LLVM_SRC
     patch -p0 < $AESOP_SRC/patches/aesop-lto-for-3.3.patch

• Configure and build LLVM, e.g.:
  

     cd $LLVM_SRC
     ./configure --prefix=$PREFIX --enable-optimized --enable-assertions --enable-pic --with-binutils-include=/usr/include
     make -j8 && make install

• Finally, we'll build and install AESOP.
  

     cd $AESOP_SRC
     ./configure --prefix=$(llvm-config --prefix) --with-llvmobj=$(llvm-config --obj-root) --with-llvmsrc=$(llvm-config --src-root) --includedir=$(llvm-config --includedir)
     make -j8 && make install

• If you are on a 64-bit system and want to build for 32-bit, you might want to install the gcc-multilib package to support the same using

         sudo apt-get install gcc-multilib

• To support the aesopgcc and aesopfort drivers which use Dragonegg, build and install the dragonegg plugin (a single dragonegg.so file) into $PREFIX/lib. The aesopgcc and aesopfort scripts/drivers will automatically look here when invoking gcc and gfortran.

• If GCC 4.6 is not your distribution's default compiler, you may want to ensure that cc, gcc, g++, and gfortran in your PATH are symlinks to GCC 4.6 binaries: AESOP tools assume that these binaries will work with Dragonegg.