X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemd-gpt-auto-generator.xml;h=db98582b7e44ca9827cc1dedd0fceda3a1f1c422;hb=e57e4e2be345f346bb49547ecad71dc000c406b2;hp=fb2544464528174acc32893a2bafc8109098bf7c;hpb=d67ca9ab8472ab012ac460555225924f6337e962;p=elogind.git
diff --git a/man/systemd-gpt-auto-generator.xml b/man/systemd-gpt-auto-generator.xml
index fb2544464..db98582b7 100644
--- a/man/systemd-gpt-auto-generator.xml
+++ b/man/systemd-gpt-auto-generator.xml
@@ -43,7 +43,8 @@
systemd-gpt-auto-generator
Generator for automatically discovering
- and mounting /home as well as
+ and mounting root, /home and
+ /srv partitions, as well as
discovering and enabling swap partitions, based on GPT
partition type GUIDs.
@@ -56,33 +57,115 @@
Description
systemd-gpt-auto-generator
- is a generator that automatically discovers
- /home and swap partitions and
- creates mount and swap units for them, based on the
- the partition type GUIDs of GUID partition tables
- (GPT). Note that this generator will execute no
- operation on non-GPT systems, on systems where the
- units are explicitly configured (for example, listed
- in
- fstab5)
- or where the mount point is non-empty.
-
- This generator will only look for partitions on
- the same physical disk the root file system is stored
- on. This generator has no effect on systems where the
- root file system is distributed on multiple disks, for
- example via btrfs RAID.
-
- This generator is useful for centralizing file
- system configuration in the partition table and making
- manual configuration in
- /etc/fstab or suchlike
+ is a unit generator that automatically discovers root,
+ /home, /srv
+ and swap partitions and creates mount and swap units
+ for them, based on the the partition type GUIDs of
+ GUID partition tables (GPT). It implements the Discoverable
+ Partitions Specification. Note that this
+ generator has no effect on non-GPT systems, on systems
+ where the units are explicitly configured (for
+ example, listed in
+ fstab5),
+ or where the mount points are non-empty.
+
+ This generator will only look for root
+ partitions on the same physical disk the EFI System
+ Partition (ESP) is located on. It will only look for
+ the other partitions on the same physical disk the
+ root file system is located on. These partitions will
+ not be search on systems where the root file system is
+ distributed on multiple disks, for example via btrfs
+ RAID.
+
+ systemd-gpt-auto-generator
+ is useful for centralizing file system configuration
+ in the partition table and making manual configuration
+ in /etc/fstab or suchlike
unnecessary.
+ This generator looks for the partitions based on
+ their partition type GUID. The following partition
+ type GUIDs are identified:
+
+
+ Partition Type GUIDs
+
+
+
+
+
+
+ Partition Type GUID
+ Name
+ Explanation
+
+
+
+
+ 44479540-f297-41b2-9af7-d131d5f0458a
+ Root Partition (x86)
+ On 32bit x86 systems the first x86 root partition on the disk the EFI ESP is located on is mounted to the root directory /.
+
+
+ 4f68bce3-e8cd-4db1-96e7-fbcaf984b709
+ Root Partition (x86-64)
+ On 64bit x86 systems the first x86-64 root partition on the disk the EFI ESP is located on is mounted to the root directory /.
+
+
+ 69dad710-2ce4-4e3c-b16c-21a1d49abed3
+ Root Partition (32bit ARM)
+ On 32bit ARM systems the first ARM root partition on the disk the EFI ESP is located on is mounted to the root directory /.
+
+
+ b921b045-1df0-41c3-af44-4c6f280d3fae
+ Root Partition (64bit ARM)
+ On 64bit ARM systems the first ARM root partition on the disk the EFI ESP is located on is mounted to the root directory /.
+
+
+ 933ac7e1-2eb4-4f13-b844-0e14e2aef915
+ Home Partition
+ The first home partition on the disk the root partition is located on is mounted to /home.
+
+
+ 3b8f8425-20e0-4f3b-907f-1a25a76f98e8
+ Server Data Partition
+ The first server data partition on the disk the root partition is located on is mounted to /srv.
+
+
+ 0657fd6d-a4ab-43c4-84e5-0933c84b4f4f
+ Swap
+ All swap partitions located on the disk the root partition is located on are enabled.
+
+
+
+
+
+ The /home and
+ /srv partitions may be encrypted
+ in LUKS format. In this case a device mapper device is
+ set up under the names
+ /dev/mapper/home and
+ /dev/mapper/srv. Note that this
+ might create conflicts if the same partition is listed
+ in /etc/crypttab with a different
+ device mapper device name.
+
+ Also note that
+ systemd-efi-boot-generator8
+ will mount the EFI System Partition (ESP) to
+ /boot if not otherwise mounted.
+
+ When using this generator in conjunction with
+ btrfs file systems make sure to set the correct
+ default subvolumes on them, using btrfs
+ subvolume set-default.
+
systemd-gpt-auto-generator
implements the generator
- specification.
+ url="http://www.freedesktop.org/wiki/Software/systemd/Generators">Generator
+ Specification.
@@ -91,8 +174,12 @@
systemd1,
systemd.mount5,
systemd.swap5,
+ systemd-fstab-generator8,
systemd-efi-boot-generator8,
- fstab5
+ systemd-cryptsetup@.service8,
+ cryptsetup8,
+ fstab5,
+ btrfs8