Skip to content
load and run golang code at runtime.
Branch: master
Clone or download
dearplain Update dymcode.go
fix 32bit build error
Latest commit 2b1e47d Jan 7, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
examples loader Jun 18, 2018
.travis.yml update May 13, 2018
LICENSE
README.md
dymcode.go
empty_asm.s goloader Mar 3, 2018
mmap_unix.go itab overflow; random test; Apr 6, 2018
mmap_windows.go itab overflow; random test; Apr 6, 2018
module.go
register.go read multi objs Jun 18, 2018
type.go

README.md

Goloader

Build Status

Goloader can load and run Golang code at runtime.

How does it work?

Goloader works like a linker: it relocates the address of symbols in an object file, generates runnable code, and then reuses the runtime function and the type pointer of the loader.

Goloader provides some information to the runtime and gc of Go, which allows it to work correctly with them.

Please note that Goloader is not a scripting engine. It reads the output of Go compiler and makes them runnable. All features of Go are supported, and run just as fast and lightweight as native Go code.

Comparison with plugin

Goloader reuses the Go runtime, which makes it much smaller. And code loaded by Goloader is unloadable.

Goloader is debuggable, and supports pprof tool(Yes, you can see code loaded by Goloader in pprof).

Build

Make sure you're using go >= 1.8.

First, execute the following command, then do build and test. This is because Goloader relies on the internal package, which is forbidden by the Go compiler.

cp -r $GOROOT/src/cmd/internal $GOROOT/src/cmd/objfile

Examples

go build github.com/dearplain/goloader/examples/loader

go tool compile $GOPATH/src/github.com/dearplain/goloader/examples/schedule/schedule.go
./loader -o schedule.o -run main.main -times 10

go tool compile $GOPATH/src/github.com/dearplain/goloader/examples/base/base.go
./loader -o base.o -run main.main

go tool compile $GOPATH/src/github.com/dearplain/goloader/examples/http/http.go
./loader -o http.o -run main.main

#build multiple go files
go tool compile -I $GOPATH/pkg/darwin_amd64 1.go 2.go

#build for arm32
GOOS=linux GOARCH=arm GOARM=5 go install fmt runtime sync net/http time
GOOS=linux GOARCH=arm GOARM=5 go build github.com/dearplain/goloader/examples/loader
GOOS=linux GOARCH=arm GOARM=5 go tool compile $GOPATH/src/github.com/dearplain/goloader/examples/base/base.go
#test on arm32 linux
./loader -o base.o -run main.main

Warning

This has currently only been tested and developed on Golang 1.8, 1.9, and 1.10 (x64/x86, darwin, linux, windows). Be aware of Golang's internal structs change, especially the moduledata struct.

You can’t perform that action at this time.