summary refs log tree commit diff
path: root/doc/guix.texi
diff options
context:
space:
mode:
authorLudovic Courtès <ludo@gnu.org>2014-11-08 14:49:13 +0100
committerLudovic Courtès <ludo@gnu.org>2014-11-08 15:10:42 +0100
commit6aa260af122ce445c2b41c2ce5f487724feea917 (patch)
tree52fe8eaf9f09cebf009fb7f2e2b1b1428df87993 /doc/guix.texi
parenta9967103de2dd16749f365569ee307637eb1b99a (diff)
downloadguix-6aa260af122ce445c2b41c2ce5f487724feea917.tar.gz
vm: Fix 'vm --full-boot' to produce a sufficient disk image.
* gnu/system/vm.scm (system-qemu-image/shared-store): Add
  #:disk-image-size and #:full-boot? parameters and honor them.  Pass
  '#:copy-inputs? full-boot?', and change #:inputs argument.
* guix/scripts/system.scm (system-derivation-for-action): Pass
  #:disk-image-size to 'system-qemu-image/shared-store'.
* doc/guix.texi (Invoking guix system): Mention use of '--image-size' in
  conjunction with '--full-boot'.
Diffstat (limited to 'doc/guix.texi')
-rw-r--r--doc/guix.texi12
1 files changed, 9 insertions, 3 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index 2da956cc73..bc839ecbbb 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -4151,9 +4151,15 @@ Build a virtual machine that contain the operating system declared in
 
 The VM shares its store with the host system.
 
-On GNU/Linux, the default is to boot directly to the kernel.  The
-@code{--full-boot} option forces a complete boot sequence, starting with
-the bootloader.
+On GNU/Linux, the default is to boot directly to the kernel; this has
+the advantage of requiring only a very tiny root disk image since the
+host's store can then be mounted.
+
+The @code{--full-boot} option forces a complete boot sequence, starting
+with the bootloader.  This requires more disk space since a root image
+containing at least the kernel, initrd, and bootloader data files must
+be created.  The @code{--image-size} option can be used to specify the
+image's size.
 
 @item vm-image
 @itemx disk-image