--- /dev/null
+Bsuildbot linux rc builder for OpenAFS
+=====================================
+
+Changes to the mainline Linux source code frequently requires changes to the
+OpenAFS kernel module code. In order to catch build errors as the Linux and
+OpenAFS code changes, a nightly builder on the OpenAFS buildbot has been
+created to automatically build the various git branches of OpenAFS on the most
+recent Linux kernel release candidate every day. The builder spins up a
+virtual machine guest, installs the most recent Linux release candidate image
+and headers, reboots the guest, then attempts to build and run OpenAFS on the
+release candidate.
+
+Linux KVM virtualization and `libvirt` commands is used for virtualization.
+The builder downloads pre-build Linux release candidates published by the
+Ubuntu Kernel Team.
+
+The components of this system are:
+
+* A Linux KVM host system (`kvm`, `qemu`, and `libvirt`)
+* An Ubuntu base image to be cloned
+* A script called `kernel-ppa` to find and download the most recent Linux kernels
+ from the Ubuntu Kernel Team's site.
+* A script called `virt-run` to clone the base image, run commands on the clone,
+ then destroy the clone
+* A buildbot worker which is always running
+* The buildbot master configuration
+
+Linux KVM host system
+---------------------
+
+todo
+
+Ubuntu base image
+-----------------
+
+todo
+
+`kernel-ppa`
+------------
+
+todo
+
+`virt-run`
+----------
+
+todo
+
+Buildbot worker
+---------------
+
+todo
+
+Buildbot master configuration
+-----------------------------
+
+todo
+
+
+
+====
+
+https://github.com/meffie/virt-utils.git
+