doc: Write about file system configuration.
* doc/guix.texi (Using the Configuration System): Change 'guix system boot' to 'guix system reconfigure'. (File Systems, User Accounts, Services): New nodes.
This commit is contained in:
parent
d266b79332
commit
113daf6270
|
@ -3107,6 +3107,9 @@ instance to support new system services.
|
||||||
|
|
||||||
@menu
|
@menu
|
||||||
* Using the Configuration System:: Customizing your GNU system.
|
* Using the Configuration System:: Customizing your GNU system.
|
||||||
|
* File Systems:: Configuring file system mounts.
|
||||||
|
* User Accounts:: Specifying user accounts.
|
||||||
|
* Services:: Specifying system services.
|
||||||
* Invoking guix system:: Instantiating a system configuration.
|
* Invoking guix system:: Instantiating a system configuration.
|
||||||
* Defining Services:: Adding new service definitions.
|
* Defining Services:: Adding new service definitions.
|
||||||
@end menu
|
@end menu
|
||||||
|
@ -3180,7 +3183,7 @@ right command-line options, possibly with supporting configuration files
|
||||||
generated as needed (@pxref{Defining Services}).
|
generated as needed (@pxref{Defining Services}).
|
||||||
|
|
||||||
Assuming the above snippet is stored in the @file{my-system-config.scm}
|
Assuming the above snippet is stored in the @file{my-system-config.scm}
|
||||||
file, the @command{guix system boot my-system-config.scm} command
|
file, the @command{guix system reconfigure my-system-config.scm} command
|
||||||
instantiates that configuration, and makes it the default GRUB boot
|
instantiates that configuration, and makes it the default GRUB boot
|
||||||
entry (@pxref{Invoking guix system}). The normal way to change the
|
entry (@pxref{Invoking guix system}). The normal way to change the
|
||||||
system's configuration is by updating this file and re-running the
|
system's configuration is by updating this file and re-running the
|
||||||
|
@ -3199,6 +3202,83 @@ the packages, configuration files, and other supporting files needed to
|
||||||
instantiate @var{os}.
|
instantiate @var{os}.
|
||||||
@end deffn
|
@end deffn
|
||||||
|
|
||||||
|
@node File Systems
|
||||||
|
@subsection File Systems
|
||||||
|
|
||||||
|
The list of file systems to be mounted is specified in the
|
||||||
|
@code{file-systems} field of the operating system's declaration
|
||||||
|
(@pxref{Using the Configuration System}). Each file system is declared
|
||||||
|
using the @code{file-system} form, like this:
|
||||||
|
|
||||||
|
@example
|
||||||
|
(file-system
|
||||||
|
(mount-point "/home")
|
||||||
|
(device "/dev/sda3")
|
||||||
|
(type "ext4"))
|
||||||
|
@end example
|
||||||
|
|
||||||
|
As usual, some of the fields are mandatory---those shown in the example
|
||||||
|
above---while others can be omitted. These are described below.
|
||||||
|
|
||||||
|
@deftp {Data Type} file-system
|
||||||
|
Objects of these types represent file systems to be mounted. They
|
||||||
|
contain the following members:
|
||||||
|
|
||||||
|
@table @asis
|
||||||
|
@item @code{type}
|
||||||
|
This is a string specifying the type of the file system---e.g.,
|
||||||
|
@code{"ext4"}.
|
||||||
|
|
||||||
|
@item @code{mount-point}
|
||||||
|
This designates the place where the file system is to be mounted.
|
||||||
|
|
||||||
|
@item @code{device}
|
||||||
|
This names the ``source'' of the file system. By default it is the name
|
||||||
|
of a node under @file{/dev}, but its meaning depends on the @code{title}
|
||||||
|
field described below.
|
||||||
|
|
||||||
|
@item @code{title} (default: @code{'device})
|
||||||
|
This is a symbol that specifies how the @code{device} field is to be
|
||||||
|
interpreted.
|
||||||
|
|
||||||
|
When it is the symbol @code{device}, then the @code{device} field is
|
||||||
|
interpreted as a file name; when it is @code{label}, then @code{device}
|
||||||
|
is interpreted as a partition label name; when it is @code{uuid},
|
||||||
|
@code{device} is interpreted as a partition unique identifier (UUID).
|
||||||
|
|
||||||
|
The @code{label} and @code{uuid} options offer a way to refer to disk
|
||||||
|
partitions without having to hard-code their actual device name.
|
||||||
|
|
||||||
|
@item @code{flags} (default: @code{'()})
|
||||||
|
This is a list of symbols denoting mount flags. Recognized flags
|
||||||
|
include @code{read-only} and @code{bind-mount}.
|
||||||
|
|
||||||
|
@item @code{options} (default: @code{#f})
|
||||||
|
This is either @code{#f}, or a string denoting mount options.
|
||||||
|
|
||||||
|
@item @code{needed-for-boot?} (default: @code{#f})
|
||||||
|
This Boolean value indicates whether the file system is needed when
|
||||||
|
booting. If that is true, then the file system is mounted when the
|
||||||
|
initial RAM disk (initrd) is loaded. This is always the case, for
|
||||||
|
instance, for the root file system.
|
||||||
|
|
||||||
|
@item @code{check?} (default: @code{#t})
|
||||||
|
This Boolean indicates whether the file system needs to be checked for
|
||||||
|
errors before being mounted.
|
||||||
|
|
||||||
|
@end table
|
||||||
|
@end deftp
|
||||||
|
|
||||||
|
@node User Accounts
|
||||||
|
@subsection User Accounts
|
||||||
|
|
||||||
|
TODO
|
||||||
|
|
||||||
|
@node Services
|
||||||
|
@subsection Services
|
||||||
|
|
||||||
|
TODO
|
||||||
|
|
||||||
@node Invoking guix system
|
@node Invoking guix system
|
||||||
@subsection Invoking @code{guix system}
|
@subsection Invoking @code{guix system}
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue