LLVM-based compiler for Go
Go CMake C Shell R
Pull request Compare This branch is 64 commits ahead, 1001 commits behind go-llvm:master.
Permalink
Failed to load latest commit information.
autoconf [llgo] Roll gofrontend forward Mar 15, 2016
build
cmd [llgo] llgoi: separate evaluation from printing Apr 25, 2016
debug debug: set debug log even for synthesised code Aug 5, 2016
docs Add documentation for llgoi, update README Apr 5, 2015
driver
include
irgen [llgo] Roll gofrontend forward Mar 15, 2016
ssaopt Roll gotools to 47f2109c. Jan 13, 2015
test
third_party
utils/benchcomp benchcomp: Add a mode for analyzing rule execution time in ninja log … Apr 8, 2016
.arcconfig Upgrade all the .arcconfigs to https. Jul 14, 2016
CMakeLists.txt [llgo] add llgo source path to LLVM_GO_PACKAGES Jul 27, 2016
LICENSE.TXT
README.TXT Update to new lists.llvm.org Aug 5, 2015
buildslave-config.yaml
libgo-check-failures.diff [llgo] Roll gofrontend forward Mar 15, 2016
libgo-noext.diff Roll gofrontend to 07baa07598ea; roll libffi to r219477. Apr 5, 2015
llgo-go.sh Initial commit of llgo. Nov 27, 2014
update_third_party.sh [llgo] Roll gofrontend forward Mar 15, 2016

README.TXT

llgo
====

llgo is a Go (http://golang.org) frontend for LLVM, written in Go.

llgo is under active development. It compiles and passes most of the
standard library test suite and a substantial portion of the gc test suite,
but there are some corner cases that are known not to be handled correctly
yet. Nevertheless it can compile modestly substantial programs (including
itself; it is self hosting on x86-64 Linux).

Mailing list: https://groups.google.com/d/forum/llgo-dev

Supported platforms
-------------------

llgo is currently only supported on the x86-64 Linux platform. Contributions
that add support for other platforms are welcome.

There are two components which would need to be ported to new platforms: the
compiler and the runtime library. The compiler has little platform-specific
code; the most significant is in irgen/cabi.go. The main limiting factor
for new platforms is the runtime library in third_party/gofrontend/libgo,
which inherits some support for other platforms from the gc compiler's
runtime library, but this support tends to be incomplete.

Installation
------------

llgo requires:
* Go 1.3 or later.
* CMake 2.8.8 or later (to build LLVM).
* A modern C++ toolchain (to build LLVM).
  http://llvm.org/docs/GettingStarted.html#getting-a-modern-host-c-toolchain

Note that Ubuntu Precise is one Linux distribution which does not package
a sufficiently new CMake or C++ toolchain.

To build and install llgo:

    # Checkout LLVM:
    svn co http://llvm.org/svn/llvm-project/llvm/trunk /path/to/llvm

    # Checkout Clang:
    cd /path/to/llvm/tools
    svn co http://llvm.org/svn/llvm-project/cfe/trunk clang

    # Checkout llgo:
    svn co http://llvm.org/svn/llvm-project/llgo/trunk llgo

    # Build LLVM, Clang and llgo: (see also http://llvm.org/docs/CMake.html)
    mkdir /path/to/llvm-build
    cd /path/to/llvm-build
    cmake /path/to/llvm -DCMAKE_INSTALL_PREFIX=/path/to/llvm-inst
    make install

Running
-------

llgo-go is llgo's version of the "go" command. It has the same command line
interface as go, and works the same way, but it uses llgo to compile.

llgoi is an interactive REPL for Go. It supports expressions, statements, most
declarations and imports, including binary imports from the standard library
and source imports from $GOPATH. See docs/llgoi.rst for more information.

llgo is the compiler binary. It has a command line interface that is intended
to be compatible to a large extent with gccgo.

Contributing
------------

Changes to code outside the third_party directory should be contributed in
the normal way by sending patches to <llvm-commits@lists.llvm.org>.

Changes to code in the third_party directory must first be made in the
respective upstream project, from which they will be mirrored into the llgo
repository. See the script update_third_party.sh for the locations of the
upstream projects and details of how the mirroring works.