llgo

module
v0.6.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: May 6, 2024 License: Apache-2.0

README

llgo - A Go compiler based on LLVM

Build Status Go Report Card GitHub release Coverage Status GoDoc Language

This is a Go compiler based on LLVM in order to better integrate Go with the C ecosystem. It's a subproject of the Go+ project.

How to install

Follow these steps to generate the llgo command (its usage is the same as the go command):

on macOS
brew update  # execute if needed
brew install llvm@17
go install -v ./...
on Linux
echo 'deb http://apt.llvm.org/focal/ llvm-toolchain-focal-17 main' | sudo tee /etc/apt/sources.list.d/llvm.list
wget -O - https://apt.llvm.org/llvm-snapshot.gpg.key | sudo apt-key add -
sudo apt-get update  # execute if needed
sudo apt-get install --no-install-recommends llvm-17-dev
go install -v ./...

Demo

The _demo directory contains our demos (it start with _ to prevent the go command from compiling it):

  • hello: call C printf to print Hello world
  • concat: call C fprintf with stderr, and Go variadic function
  • qsort: call C function with a callback (eg. qsort)
  • genints: various forms of closure usage (including C function, recv.method and anonymous function)
How to run demos
cd <demo-directory>  # eg. cd _demo/genints
llgo run .

Directories

Path Synopsis
_demo module
concat command
genints command
hello command
qsort command
c module
embed module
go module
py module
_pydemo module
_xtool module
c
chore
ardump command
clangast command
clangpp command
gentests command
llgen command
nmdump command
nmindex command
ssadump command
ssadump: a tool for displaying and interpreting the SSA form of Go programs.
ssadump: a tool for displaying and interpreting the SSA form of Go programs.
cl
_testdata/print command
_testrt/alloca command
_testrt/any command
_testrt/builtin command
_testrt/closure command
_testrt/concat command
_testrt/cstr command
_testrt/cvar command
_testrt/fprintf command
_testrt/gotypes command
_testrt/hello command
_testrt/index command
_testrt/intgen command
_testrt/map command
_testrt/panic command
_testrt/qsort command
_testrt/result command
_testrt/strlen command
_testrt/struct command
_testrt/sum command
cmd
internal/base
Package base defines shared basic pieces of the llgo command, in particular logging and the Command structure.
Package base defines shared basic pieces of the llgo command, in particular logging and the Command structure.
internal/build
Package build implements the "llgo build" command.
Package build implements the "llgo build" command.
internal/clean
Package clean implements the "llgo clean" command.
Package clean implements the "llgo clean" command.
internal/help
Package help implements the “llgo help” command.
Package help implements the “llgo help” command.
internal/install
Package install implements the "llgo install" command.
Package install implements the "llgo install" command.
internal/run
Package run implements the "llgo run" command.
Package run implements the "llgo run" command.
llgo command
compiler module
doc
_readme module
internal
abi
ar
mod
typeutil
Package typeutil defines various utilities for types, such as Map, a mapping from types.Type to interface{} values.
Package typeutil defines various utilities for types, such as Map, a mapping from types.Type to interface{} values.
runtime module
x
ar
nm

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL