02/07: doc: Recommend virtio-blk to access the VM image.

[guix-commits]

civodul pushed a commit to branch master
in repository guix.

commit 05b60752a67af294c35d8f4218487c9a44b5fdee
Author: Ludovic Courtès <address@hidden>
Date:   Sat Apr 27 10:09:27 2019 +0200

    doc: Recommend virtio-blk to access the VM image.
    
    * doc/guix.texi (Running Guix in a VM): Recommend virtio-blk to access
    the image.
---
 doc/guix.texi | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/doc/guix.texi b/doc/guix.texi
index d9473a1..de30743 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -24647,7 +24647,9 @@ vm-image} on x86_64 hardware:
 @example
 $ qemu-system-x86_64 \
    -net user -net nic,model=virtio \
-   -enable-kvm -m 512 /tmp/qemu-image
+   -enable-kvm -m 512 \
+   -device virtio-blk,drive=myhd \
+   -drive if=none,file=/tmp/qemu-image,id=myhd
 @end example
 
 Here is what each of these options means:
@@ -24677,8 +24679,15 @@ faster.
 RAM available to the guest OS, in mebibytes.  Defaults to address@hidden,
 which may be insufficient for some operations.
 
address@hidden /tmp/qemu-image
-The file name of the qcow2 image.
address@hidden -device virtio-blk,drive=myhd
+Create a @code{virtio-blk} drive called ``myhd''.  @code{virtio-blk} is a
+``paravirtualization'' mechanism for block devices that allows QEMU to achieve
+better performance than if it were emulating a complete disk drive.  See the
+QEMU and KVM documentation for more info.
+
address@hidden -drive if=none,file=/tmp/qemu-image,id=myhd
+Use our QCOW image, the @file{/tmp/qemu-image} file, as the backing store the
+the ``myhd'' drive.
 @end table
 
 The default @command{run-vm.sh} script that is returned by an invocation of