llvm

llvm

Library for interacting with LLVM IR in pure Go.

Introduction

• Introductory blog post "LLVM IR and Go"
• Our Document

Installation

go get github.com/llir/llvm/...

Versions

Map between llir/llvm tagged releases and LLVM release versions.

• llir/llvm v0.3.7: LLVM 15.0 (yet to be released)
• llir/llvm v0.3.6: LLVM 14.0
• llir/llvm v0.3.5: LLVM 13.0
• llir/llvm v0.3.4: LLVM 12.0
• llir/llvm v0.3.3: LLVM 11.0
• llir/llvm v0.3.2: LLVM 10.0
• llir/llvm v0.3.0: LLVM 9.0

Users

• decomp: LLVM IR to Go decompiler by @decomp.
• geode: Geode to LLVM IR compiler by @nickwanninger.
• leaven: LLVM IR to Go decompiler by @andybalholm.
• slate: Slate to LLVM IR compiler by @nektro.
• tre: Go to LLVM IR compiler by @zegl.
• uc: µC to LLVM IR compiler by @sangisos and @mewmew.
• B++: B++ to LLVM IR compiler by @Nv7-Github.

Usage

Input example, parsing LLVM IR assembly

Example usage in GoDoc.

// This example parses an LLVM IR assembly file and pretty-prints the data types
// of the parsed module to standard output.
package main

import (
	"log"

	"github.com/kr/pretty"
	"github.com/llir/llvm/asm"
)

func main() {
	// Parse the LLVM IR assembly file `foo.ll`.
	m, err := asm.ParseFile("foo.ll")
	if err != nil {
		log.Fatalf("%+v", err)
	}
	// Pretty-print the data types of the parsed LLVM IR module.
	pretty.Println(m)
}

Output examples, producing LLVM IR assembly

Hello, World

Example usage in GoDoc.

…

Pseudo Random-Number Generator

Example usage in GoDoc.

…

Analysis example, processing LLVM IR

Example usage in GoDoc.

…

License

The llir/llvm project is dual-licensed to the public domain and under a zero-clause BSD license. You may choose either license to govern your use of llir/llvm.