README
¶
elf64load
Plugin system in pure go, includes an ELF64 loader.
Current status
NOT WORKING. Still futzing with relocations and working out how to invoke the .init and .init_array intitialization functions
Documentation
¶
Overview ¶
Package plugin implements loading and symbol resolution of Go plugins.
A plugin is a Go main package with exported functions and variables that has been built with:
go build -buildmode=plugin
When a plugin is first opened, the init functions of all packages not already part of the program are called. The main function is not run. A plugin is only initialized once, and cannot be closed.
Currently plugins are only supported on Linux and macOS. Please report any issues.
Index ¶
Constants ¶
const ( ET_REL uint16 = 1 //Relocatable object file ET_DYN uint16 = 3 //SharedObject file )
Variables ¶
var ( ErrInvalidFileType = errors.New("invalid filetype, only ELF64 supported") ErrInvalidArch = errors.New("invalid architecture, only AMD64 supported") )
Functions ¶
This section is empty.
Types ¶
type Plugin ¶
type Plugin struct {
// contains filtered or unexported fields
}
Plugin is a loaded Go plugin.
type Symbol ¶
type Symbol interface{}
A Symbol is a pointer to a variable or function.
For example, a plugin defined as
package main
import "fmt"
var V int
func F() { fmt.Printf("Hello, number %d\n", V) }
may be loaded with the Open function and then the exported package symbols V and F can be accessed
p, err := plugin.Open("plugin_name.so")
if err != nil {
panic(err)
}
v, err := p.Lookup("V")
if err != nil {
panic(err)
}
f, err := p.Lookup("F")
if err != nil {
panic(err)
}
*v.(*int) = 7
f.(func())() // prints "Hello, number 7"
Source Files
Directories