github.com/jollheef/go-qemu-kernel -> github.com/jollheef/out-of-tree/qemu

qemu/README.md

@@ -0,0 +1,76 @@
+# out-of-tree/qemu
+
+Qemu wrapper for kernel-related CI tasks. Supports *GNU/Linux* and *macOS*.
+
+Features:
+* Uses upstream virtualization -- KVM in GNU/Linux and Hypervisor.framework in macOS.
+* Run files and kernel modules directly from local filesystem. No need to copy byself!
+* Run commands inside qemu virtual machine at the same way as you run in it locally.
+
+## Installation
+
+    $ go get github.com/jollheef/out-of-tree/qemu
+
+### Generate root image
+
+First of all we need to generate rootfs for run qemu.
+
+#### GNU/Linux
+
+    $ sudo apt install -y debootstrap qemu
+    $ sudo qemu-debian-img generate sid.img
+
+#### macOS
+
+Note: qemu on macOS since v2.12 (24 April 2018) supports Hypervisor.framework.
+
+    $ brew install qemu
+
+Because it's a very complicated to debootstrap qemu images from macOS,
+preferred way is to use Vagrant with any hypervisor.
+
+    $ brew cask install vagrant
+    $ cd $GOPATH/src/github.com/jollheef/out-of-tree/qemu/tools/qemu-debian-image
+    $ vagrant up && vagrant destroy -f
+
+bionic.img and bionic-vmlinuz will be created in current directory.
+
+### Fill configuration file
+
+    $ $EDITOR $GOPATH/src/github.com/jollheef/out-of-tree/qemu/test.config.go
+
+### Run tests
+
+    $ go test -v
+
+## Usage
+
+    $ go get github.com/jollheef/out-of-tree/qemu
+
+Minimal example:
+
+	kernel := qemu.Kernel{
+		Name:       "Some kernel name",
+		KernelPath: "/path/to/vmlinuz",
+		InitrdPath: "/path/to/initrd", // if required
+	}
+	q, err := qemu.NewQemuSystem(qemu.X86_64, kernel, "/path/to/qcow2")
+	if err != nil {
+		log.Fatal(err)
+	}
+
+	if err = q.Start(); err != nil {
+		log.Fatal(err)
+	}
+	defer q.Stop()
+
+	output, err = q.Command("root", "echo Hello, World!")
+	if err != nil {
+		log.Fatal(err)
+	}
+
+	// output == "Hello, World!\n"
+
+More information and list of all functions see at go documentation project, or just run locally:
+
+    $ godoc github.com/jollheef/out-of-tree/qemu