diff options
| author | Ludovic Courtès <ludo@gnu.org> | 2019-04-27 10:09:27 +0200 |
|---|---|---|
| committer | Ludovic Courtès <ludo@gnu.org> | 2019-04-27 15:08:17 +0200 |
| commit | 05b60752a67af294c35d8f4218487c9a44b5fdee (patch) | |
| tree | 5bfc3123e86fbb448264d49ed7065e01d3313f72 /doc | |
| parent | dbab5eb8f52963ffff5742ebbdf6ce7919e18ab1 (diff) | |
| download | patches-05b60752a67af294c35d8f4218487c9a44b5fdee.tar patches-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.texi | 15 |
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 |