From 34d4789bf939b44e76af2f6ae2186e1638986aa2 Mon Sep 17 00:00:00 2001
From: "Richard W.M. Jones" <rjones@redhat.com>
Date: Sat, 26 Oct 2013 14:45:30 +0100
Subject: [PATCH] builder: Document how to boot VMs directly in qemu or KVM.

(cherry picked from commit 8b34855684fb660823a2801a4a5e8be32a6cc40f)
---
 builder/virt-builder.pod | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/builder/virt-builder.pod b/builder/virt-builder.pod
index e40dfd4..a5f766d 100644
--- a/builder/virt-builder.pod
+++ b/builder/virt-builder.pod
@@ -865,6 +865,21 @@ To boot up an instance of your image on a Nova compute node, do:
 Use S<C<nova flavor-list>> to list possible machine flavors.  Use
 S<C<nova list>> to list running instances.
 
+=head3 Booting directly using qemu or KVM
+
+The qemu command line is not very stable or easy to use, hence libvirt
+should be used if possible.  However a command line similar to the
+following could be used to boot the virtual machine:
+
+ qemu-system-x86_64 \
+   -machine accel=kvm:tcg \
+   -cpu host \
+   -m 2048 \
+   -drive file=disk.img,format=raw,if=virtio
+
+As with libvirt, it is very important that the correct format is
+chosen.  It will be C<raw> unless the I<--format> option was used.
+
 =head2 DEBUGGING BUILDS
 
 If virt-builder fails with an error, then enable debugging (I<-v>) and
-- 
1.8.4.2