summary refs log tree commit diff
path: root/doc
diff options
context:
space:
mode:
authorMathieu Othacehe <othacehe@gnu.org>2022-01-13 11:35:40 +0100
committerMathieu Othacehe <othacehe@gnu.org>2022-01-14 12:26:07 +0100
commit2d12ec724ea2ab4e96c9040094194ddfa4b2692b (patch)
tree839dab11cbf48ec48c5a2776d10f66726c7c76d2 /doc
parent3dbb7112d443ab0220febb467effc5f4c46141b8 (diff)
downloadguix-2d12ec724ea2ab4e96c9040094194ddfa4b2692b.tar.gz
scripts: system: Rationalize persistency.
Make sure that the images are created with a non volatile root by default and
the vm are created with a volatile root by default. Break the --volatile
option into --volatile-image and --persistent-vm options.

* guix/scripts/system.scm (perform-action): Turn volatile? argument into
volatile-vm-root?.
(show-help): Introduce --volatile-image and --persistent-vm options instead of
--volatile.
(%default-options): Adapt it.
(%options): Handle those options.
(process-action): Honor them.
* doc/guix.texi (Invoking guix system): Adapt it accordingly.
Diffstat (limited to 'doc')
-rw-r--r--doc/guix.texi9
1 files changed, 7 insertions, 2 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index 92971a531c..42691570ff 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -35162,6 +35162,11 @@ $ $(guix system vm my-config.scm) -m 1024 -smp 2 -nic user,model=virtio-net-pci
 
 The VM shares its store with the host system.
 
+By default, the root file system of the VM is mounted volatile; the
+@option{--persistent} option can be provided to make it persistent
+instead.  In that case, the VM disk-image file will be copied from the
+store to the @env{TMPDIR} directory to make it writable.
+
 Additional file systems can be shared between the host and the VM using
 the @option{--share} and @option{--expose} command-line options: the former
 specifies a directory to be shared with write access, while the latter
@@ -35199,8 +35204,8 @@ QEMU monitor and the VM.
 @cindex Creating system images in various formats
 @item image
 @cindex image, creating disk images
-The @code{image} command can produce various image types.  The
-image type can be selected using the @option{--image-type} option.  It
+The @code{image} command can produce various image types.  The image
+type can be selected using the @option{--image-type} option.  It
 defaults to @code{efi-raw}.  When its value is @code{iso9660}, the
 @option{--label} option can be used to specify a volume ID with
 @code{image}.  By default, the root file system of a disk image is