summary refs log tree commit diff
path: root/doc
diff options
context:
space:
mode:
authorLudovic Courtès <ludo@gnu.org>2019-04-27 10:09:27 +0200
committerLudovic Courtès <ludo@gnu.org>2019-04-27 15:08:17 +0200
commit05b60752a67af294c35d8f4218487c9a44b5fdee (patch)
tree5bfc3123e86fbb448264d49ed7065e01d3313f72 /doc
parentdbab5eb8f52963ffff5742ebbdf6ce7919e18ab1 (diff)
downloadguix-05b60752a67af294c35d8f4218487c9a44b5fdee.tar.gz
doc: Recommend virtio-blk to access the VM image.
* doc/guix.texi (Running Guix in a VM): Recommend virtio-blk to access
the image.
Diffstat (limited to 'doc')
-rw-r--r--doc/guix.texi15
1 files changed, 12 insertions, 3 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index d9473a1820..de30743d58 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 128@tie{}MiB,
 which may be insufficient for some operations.
 
-@item /tmp/qemu-image
-The file name of the qcow2 image.
+@item -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.
+
+@item -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