go-boot | https://github.com/usbarmory/go-boot
Copyright (c) WithSecure Corporation
Andrea Barisani
andrea@inversepath.com
TamaGo is a framework that enables compilation and execution of unencumbered Go applications on bare metal AMD64/ARM/RISC-V processors.
The uefi and uefi/x64 packages provides support for unikernels running under the Unified Extensible Firmware Interface UEFI on an AMD64 core.
For more information about TamaGo see its repository and project wiki.
For usage of these packages in the context of an UEFI application see the go-boot unikernel project.
The package API documentation can be found on pkg.go.dev.
Go applications are simply required to import, the relevant board package to ensure that hardware initialization and runtime support take place:
import (
_ "github.com/usbarmory/go-boot/uefi/x64"
)Build the TamaGo compiler (or use the latest binary release):
wget https://github.com/usbarmory/tamago-go/archive/refs/tags/latest.zip
unzip latest.zip
cd tamago-go-latest/src && ./all.bash
cd ../bin && export TAMAGO=`pwd`/go
Go applications can be compiled as usual, using the compiler built in the previous step, but with the addition of the following flags/variables:
GOOS=tamago GOARCH=amd64 ${TAMAGO} build -ldflags "-E cpuinit -T 0x00110000 -R 0x1000" main.go
An example application, targeting the UEFI environment, is go-boot.
go-boot | https://github.com/usbarmory/go-boot
Copyright (c) WithSecure Corporation
These source files are distributed under the BSD-style license found in the LICENSE file.
The TamaGo logo is adapted from the Go gopher designed by Renee French and licensed under the Creative Commons 3.0 Attributions license. Go Gopher vector illustration by Hugo Arganda.