aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorLudovic Courtès <ludo@gnu.org>2020-09-04 10:41:23 +0200
committerLudovic Courtès <ludo@gnu.org>2020-09-04 11:29:51 +0200
commit2fc8337a149a2af6e2d945cf6585fc58bbd41c30 (patch)
tree472197df50b56f37a2fffb4099c781f73e286dd4 /doc
parentfe409700d85a8de0fadb9cdd052434a4e07b4267 (diff)
downloadguix-2fc8337a149a2af6e2d945cf6585fc58bbd41c30.tar
guix-2fc8337a149a2af6e2d945cf6585fc58bbd41c30.tar.gz
doc: Document 'file-system-label' and 'uuid'.
* doc/guix.texi (File Systems): Document 'file-system-label' and 'uuid'.
Diffstat (limited to 'doc')
-rw-r--r--doc/guix.texi36
1 files changed, 36 insertions, 0 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index 0a68457160..f224e356bc 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -12413,6 +12413,19 @@ example for an encrypted partition (@pxref{Mapped Devices}).
@end table
@end deftp
+@deffn {Scheme Procedure} file-system-label @var{str}
+This procedure returns an opaque file system label from @var{str}, a
+string:
+
+@lisp
+(file-system-label "home")
+@result{} #<file-system-label "home">
+@end lisp
+
+File system labels are used to refer to file systems by label rather
+than by device name. See above for examples.
+@end deffn
+
The @code{(gnu system file-systems)} exports the following useful
variables.
@@ -12459,6 +12472,29 @@ and unmount user-space FUSE file systems. This requires the
@code{fuse.ko} kernel module to be loaded.
@end defvr
+The @code{(gnu system uuid)} module provides tools to deal with file
+system ``unique identifiers'' (UUIDs).
+
+@deffn {Scheme Procedure} uuid @var{str} [@var{type}]
+Return an opaque UUID (unique identifier) object of the given @var{type}
+(a symbol) by parsing @var{str} (a string):
+
+@lisp
+(uuid "4dab5feb-d176-45de-b287-9b0a6e4c01cb")
+@result{} #<<uuid> type: dce bv: @dots{}>
+
+(uuid "1234-ABCD" 'fat)
+@result{} #<<uuid> type: fat bv: @dots{}>
+@end lisp
+
+@var{type} may be one of @code{dce}, @code{iso9660}, @code{fat},
+@code{ntfs}, or one of the commonly found synonyms for these.
+
+UUIDs are another way to unambiguously refer to file systems in
+operating system configuration. See the examples above.
+@end deffn
+
+
@node Btrfs file system
@subsection Btrfs file system