summaryrefslogtreecommitdiff
path: root/doc/guix.texi
diff options
context:
space:
mode:
authorLudovic Courtès <ludo@gnu.org>2014-11-29 14:40:26 +0100
committerLudovic Courtès <ludo@gnu.org>2014-11-29 14:40:26 +0100
commit3b09332adf7ce8e976a4d117a62c586a53af04aa (patch)
tree0400980787f83e8eb2b9a379af9b9f59347504a1 /doc/guix.texi
parent9cd0dfaa4654e49cd0af82993b91789cb3012354 (diff)
system: Add a 'needed-for-boot?' field to 'mapped-device'.
* gnu/system/file-systems.scm (<mapped-device>)[needed-for-boot?]: New field. * gnu/system.scm (operating-system-user-mapped-devices, operating-system-boot-mapped-devices): Use it instead of trying to guess. Guessing doesn't work when one refers to a partition using its label, for instance. * doc/guix.texi (Mapped Devices): Document 'needed-for-boot?'.
Diffstat (limited to 'doc/guix.texi')
-rw-r--r--doc/guix.texi16
1 files changed, 12 insertions, 4 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index aad201771a..9aeec41f83 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -3837,19 +3837,27 @@ detailed below.
Objects of this type represent device mappings that will be made when
the system boots up.
-@table @code
-@item source
+@table @asis
+@item @code{source}
This string specifies the name of the block device to be mapped, such as
@code{"/dev/sda3"}.
-@item target
+@item @code{target}
This string specifies the name of the mapping to be established. For
example, specifying @code{"my-partition"} will lead to the creation of
the @code{"/dev/mapper/my-partition"} device.
-@item type
+@item @code{type}
This must be a @code{mapped-device-kind} object, which specifies how
@var{source} is mapped to @var{target}.
+
+@item @code{needed-for-boot?} (default: @code{#f})
+This Boolean value indicates whether the device mapping must be made at
+boot time---i.e., from the initial RAM disk, before any user file
+systems are mounted.
+
+You would set it to @code{#t} for instance when the mapped device is
+used by the root file system.
@end table
@end deftp