froggey / Iota
Programming Languages
Iota is an LLVM to CL transpiler, similar to emscripten. It converts LLVM bitcode to safe, portable Common Lisp code.
Quick Start
You'll probably want to make this available as a quicklisp local project.
Optional, for parallel builds
export MAKEFLAGS=-j2
Clone the LLVM/Clang repos.
./fetch-llvm.sh
Build LLVM, Clang, and the translator.
This will take a long time unless you have a beefy machine.
./build-llvm.sh
Build & translate libraries and programs.
./build.sh
Load into Lisp.
lisp --load load.lisp
prboom & sdlquake can now be run using (CL-USER::RUN-PRBOOM) and (CL-USER::RUN-SDLQUAKE).
Usage
The build-llvm.sh and build.sh scripts build the translator and compiler, installing them in the toolchain/ subdirectory. C source code can be compiled to object files as normal using clang -c. There is no ld-style linker, so object code and libraries must be linked with llvm-link. The linked bitcode file can then be translated with iota.
Example
cat > example.c <<EOF #include <stdio.h> int main(int argc, char **argv) { printf("Hello, World!\n"); return 0; } EOF toolchain/bin/clang -c example.c toolchain/bin/llvm-link -o=example.bc example.o toolchain/le32-iota/lib/libc.a toolchain/bin/iota -package=":example" example.bc > example.lisp