Skip to content

tiborvass/xhyve-bindings

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
main
main
 
 
upstream
upstream
 
 
Makefile
Makefile
 
 
README.md
README.md
 
 
acpitbl.c
acpitbl.c
 
 
atkbdc.c
atkbdc.c
 
 
block_if.c
block_if.c
 
 
consport.c
consport.c
 
 
dbgport.c
dbgport.c
 
 
fbsd.c
fbsd.c
 
 
generate.sh
generate.sh
 
 
inout.c
inout.c
 
 
ioapic.c
ioapic.c
 
 
kexec.c
kexec.c
 
 
md5c.c
md5c.c
 
 
mem.c
mem.c
 
 
mevent.c
mevent.c
 
 
mptbl.c
mptbl.c
 
 
pci_ahci.c
pci_ahci.c
 
 
pci_emul.c
pci_emul.c
 
 
pci_hostbridge.c
pci_hostbridge.c
 
 
pci_irq.c
pci_irq.c
 
 
pci_lpc.c
pci_lpc.c
 
 
pci_uart.c
pci_uart.c
 
 
pci_virtio_block.c
pci_virtio_block.c
 
 
pci_virtio_net_tap.c
pci_virtio_net_tap.c
 
 
pci_virtio_net_vmnet.c
pci_virtio_net_vmnet.c
 
 
pci_virtio_rnd.c
pci_virtio_rnd.c
 
 
pm.c
pm.c
 
 
post.c
post.c
 
 
rtc.c
rtc.c
 
 
smbiostbl.c
smbiostbl.c
 
 
task_switch.c
task_switch.c
 
 
uart_emul.c
uart_emul.c
 
 
upstream.patch
upstream.patch
 
 
vatpic.c
vatpic.c
 
 
vatpit.c
vatpit.c
 
 
vhpet.c
vhpet.c
 
 
vioapic.c
vioapic.c
 
 
virtio.c
virtio.c
 
 
vlapic.c
vlapic.c
 
 
vmcs.c
vmcs.c
 
 
vmm.c
vmm.c
 
 
vmm_api.c
vmm_api.c
 
 
vmm_callout.c
vmm_callout.c
 
 
vmm_host.c
vmm_host.c
 
 
vmm_instruction_emul.c
vmm_instruction_emul.c
 
 
vmm_ioport.c
vmm_ioport.c
 
 
vmm_lapic.c
vmm_lapic.c
 
 
vmm_mem.c
vmm_mem.c
 
 
vmm_stat.c
vmm_stat.c
 
 
vmm_util.c
vmm_util.c
 
 
vmx.c
vmx.c
 
 
vmx_msr.c
vmx_msr.c
 
 
vpmtmr.c
vpmtmr.c
 
 
vrtc.c
vrtc.c
 
 
x86.c
x86.c
 
 
xhyve.c
xhyve.c
 
 
xhyve.go
xhyve.go
 
 
xmsr.c
xmsr.c
 
 

Repository files navigation

Xhyve from Go

The goal of this project is to compile xhyve into a Go package and be able to distribute a Go binary with xhyve embedded.

Currently, the bindings are only for the main() entrypoint in xhyve.c, allowing the Go program to pass in any command line arguments to xhyve. This is a stop-gap for now, and I welcome any effort to make actual Go bindings to the underlying xhyve functions.

Installation

I only tested on OS X Yosemite, which is the first OS X version to have Hypervisor.framework which is what xhyve leverages.

$ go get github.com/tiborvass/xhyve-bindings
$ cd $GOPATH/src/github.com/tiborvass/xhyve-bindings
$ go run main/main.go upstream/test/vmlinuz upstream/test/initrd.gz

Once in the VM, type sudo halt to quit it.

Documentation

Follow Godoc.

Roadmap

  • fork-exec: Go program should be able to run multiple xhyve instances. I suggest we use the reexec package.
  • cross-compiling: We should be able to compile it from Linux. I was thinking of using xgo but any other solution that works should be good.
  • management: Start, Stop and Kill fork-exec'd xhyve instance.
  • pty: Not sure how important this is, but I wanted to have a way to attach and detach from the TTY.

Contributing

Just send pull requests, open issues.

The upstream/ directory is a git subtree. It's the first time I use that functionality so bear with me. Suggestions welcome.

If you need to update upstream, run make clean first, update upstream, and run make. It will apply a small patch upstream.patch that's currently needed.

By using cgo, we're limited to requiring all *.c files at the root of the repository, hence all those symlinks created by generate.sh when doing make. This also means, that no two C files can have the same name.

License

The bindings are under MIT License. For xhyve itself, read https://github.com/mist64/xhyve.

About

Go bindings for xhyve

Resources

Readme
Activity

Stars

12 stars

Watchers

3 watching

Forks

4 forks
Report repository

Releases

No releases published

Packages

No packages published

Languages