summaryrefslogtreecommitdiff
path: root/doc/guix.texi
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/guix.texi
parentdbab5eb8f52963ffff5742ebbdf6ce7919e18ab1 (diff)
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/guix.texi')
-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