This package converts the LLVM IR (either bitcode files or LLVM assembly) into a Haskell data type (defined in llvm-base-types). The conversion uses the LLVM libraries to read bitcode. It then traverses the IR and produces a Haskell structure that can be pattern matched against in pure code.

After the conversion, no C++ data is referenced and no C++ code is called. This library does link against LLVM directly, and therefore also uses libstdc++. This can make linking tricky sometimes. For example, mixing template-haskell with C++-linked code does not seem to work.

Note that this library only works with LLVM 3.0-3.3, and will try to retain as much compatibility with future and past versions as is reasonable.

Installation Notes

• Currently, this library is set up to link against the LLVM shared library (libLLVM-3.X.so). Most distro packages build the LLVM shared library. If you make a custom build, be sure to configure with --enable-shared.

Debian and Ubuntu

You need the development libraries and headers, so be sure to install the llvm-3.X-dev package, where X is the version you would like to use. You will also need clang.

Changes

v0.3.0

• Support LLVM-3.3 (contributed by Patrick Hulin)
• Minor breaking change in MetaDW*Type. These no longer have a MetaDWFile; instead, they directly contain their file and directory information.