The Go Programming Language
RISC-V Go Port
This repository is home of the RISC-V port of the Go programming language.
The upstream Go project can be found at https://github.com/golang/go.
This port has been upstreamed in Go 1.14. Please refer to upstream for all RISC-V development. This repository is outdated and archived.
Quick Start
Setup:
$ git clone https://review.gerrithub.io/riscv/riscv-go riscv-go
$ cd riscv-go
$ git checkout riscvdev # RISC-V work happens on this branch
$ export GOROOT_BOOTSTRAP=/path/to/prebuilt/go/tree
$ export PATH="$(pwd)/misc/riscv:$(pwd)/bin:$PATH"
$ cd src
$ ./make.bash
Compile and run in qemu-riscv64 (which is expected to be in PATH):
$ GOARCH=riscv GOOS=linux go run ../riscvtest/add.go
Build:
$ GOARCH=riscv GOOS=linux go build ../riscvtest/add.go
Test:
Our basic tests are in the riscvtest
directory:
$ cd ../riscvtest
$ go run run.go
If this exits without error, all is well!
QEMU
Spike plus pk support only a small subset of Linux syscalls and will not be capable of supporting the full Go runtime.
The RISC-V QEMU port supports a much wider set of syscalls with its "User Mode Simulation". See Method 2 in the QEMU README for instructions.
Contributing
All contributors must sign the upstream Contributor License Agreement, as this port will be merged into upstream Go upon completion.
Code review occurs via our GerritHub project, rather than via GitHub Pull Requests.
The upstream contribution guidelines
include a basic overview of using Gerrit. While the upstream Go Gerrit server
is different from ours, codereview.cfg
will configure git-codereview
to
send CLs to GerritHub.