@hackage llvm-base3.2.0.2

FFI bindings to the LLVM compiler toolkit.

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 haskell-llvm@projects.haskellorg. 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.