Skip to content
forked from bobuhiro11/gokvm

KVM based tiny x86 hypervisor written in pure golang

License

Notifications You must be signed in to change notification settings

linuxboot/gokvm

 
 

Repository files navigation

gokvm Build Status Coverage Status code lines Go Reference Go Report Card Maintainability

gokvm is a hypervisor that uses KVM as an acceleration. It is implemented completely in the Go language and has no dependencies other than the standard library. With only 1.5k lines of code, it can boot Linux 5.10, the latest version at the time, without any modifications (see v0.0.1). It includes naive and simple device emulation for serial console, virtio-net, and virtio-blk. The execution environment is limited to the x86-64 Linux environment. This should be useful for those who are interested in how to use KVM from userland. The latest version supports the following features:

  • kvm acceleration
  • multi processors
  • serial console
  • virtio-net
  • virtio-blk

This is an experimental project, so please do not use it in production.

demo

CLI

Extract the latest release from the Github Release tab and run it. Before running, make sure /dev/kvm exists. You can use existing bzImage and initrd, or you can create them using the Makefile of this project.

tar zxvf gokvm*.tar.gz
./gokvm -k ./bzImage -i ./initrd  # To exit, press Ctrl-a x.

Go package

This project includes a thin wrapper for the KVM API using ioctl. Please refer to the following link to use it.

https://pkg.go.dev/github.com/bobuhiro11/gokvm

Reference

Thanks to the many useful resources on KVM, this project was able to boot Linux on a virtual machine.

About

KVM based tiny x86 hypervisor written in pure golang

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Go 95.7%
  • Makefile 3.7%
  • Shell 0.6%