FFI bindings to the LLVM compiler toolkit.
FFI bindings to the LLVM compiler toolkit.
We try to stay up to date with LLVM releases. The current version of this package is compatible with at least LLVM 3.2. Please understand that the package may or may not work against older LLVM releases; we don't have the time or resources to test across multiple releases.
New in 3.2: Builds against LLVM 3.2, new mid-level Wrapper interface and ST-based pure interface
New in 3.0: Builds against LLVM 3.0.
New in 0.9.1.1: Builds against LLVM 2.9.
New in 0.9.1.0: Util.Memory for memory related intrinsics.
New in 0.9.0.0: Adapted to LLVM 2.8 (removed support for Union types).
Haskell LLVM bindings
This package provides Haskell bindings for the popular LLVM compiler infrastructure project.
Compatibility
We try to stay up to date with LLVM releases. The current version of this package is compatible with LLVM 2.9 and 2.8. Please understand that the package may or may not work against older LLVM releases; we don't have the time or resources to test across multiple releases.
Configuration
By default, when you run cabal install, the Haskell bindings will be configured to look for LLVM in /usr/local.
If you have LLVM installed in a different location, e.g. /usr, you can tell the configure script where to find it as follows:
cabal install --configure-option=--with-llvm-prefix=/usr
Package status - what to expect
This package is still under development.
The high level bindings are currently incomplete, so there are some limits on what you can do. Adding new functions is generally easy, though, so don't be afraid to get your hands dirty.
The high level interface is mostly safe, but the type system cannot protect against everything that can go wrong, so take care. And, of course, there's no way to guarantee anything about the generated code.
GHCi
llvm-base will not work under GHCi. It fails to resolve some symbols, however under GHC it works fine. It appears related to the bugs listed in:
http://hackage.haskell.org/trac/ghc/ticket/3333 http://hackage.haskell.org/trac/ghc/ticket/3658 http://hackage.haskell.org/trac/ghc/ticket/5987
ghci versions < 7.7 have their own special linker, we do not support it. ghci versions >= 7.7 use the system dynamic linker, we do support it. If you have a problem using llvm-base with ghci >= 7.7 please file a bug report.
Staying in touch
There is a low-volume mailing list named [email protected]. If you use the LLVM bindings, you should think about joining.
If you want to contribute patches, please clone a copy of the git repository:
git clone git://github.com/bos/llvm
Patches are best submitted via the github "pull request" interface.
To file a bug or a request for an enhancement, please use the github issue tracker.