1SYSTEMD-GPT-AUTO-GENERATOR(s8y)stemd-gpt-auto-generatSoYrSTEMD-GPT-AUTO-GENERATOR(8)
2
3
4
6 systemd-gpt-auto-generator - Generator for automatically discovering
7 and mounting root, /home and /srv partitions, as well as discovering
8 and enabling swap partitions, based on GPT partition type GUIDs.
9
11 /usr/lib/systemd/system-generators/systemd-gpt-auto-generator
12
14 systemd-gpt-auto-generator is a unit generator that automatically
15 discovers root, /home, /srv and swap partitions and creates mount and
16 swap units for them, based on the partition type GUIDs of GUID
17 partition tables (GPT). It implements the Discoverable Partitions
18 Specification[1]. Note that this generator has no effect on non-GPT
19 systems, on systems where the units are explicitly configured (for
20 example, listed in fstab(5)), or where the mount points are non-empty.
21
22 This generator will only look for root partitions on the same physical
23 disk the EFI System Partition (ESP) is located on. It will only look
24 for the other partitions on the same physical disk the root file system
25 is located on. These partitions will not be searched on systems where
26 the root file system is distributed on multiple disks, for example via
27 btrfs RAID.
28
29 systemd-gpt-auto-generator is useful for centralizing file system
30 configuration in the partition table and making manual configuration in
31 /etc/fstab or suchlike unnecessary.
32
33 This generator looks for the partitions based on their partition type
34 GUID. The following partition type GUIDs are identified:
35
36 Table 1. Partition Type GUIDs
37 ┌─────────────────────────────────────┬────────────────┬─────────────────────┐
38 │Partition Type GUID │ Name │ Explanation │
39 ├─────────────────────────────────────┼────────────────┼─────────────────────┤
40 │44479540-f297-41b2-9af7-d131d5f0458a │ Root Partition │ On 32-bit x86 │
41 │ │ (x86) │ systems, the first │
42 │ │ │ x86 root partition │
43 │ │ │ on the disk the EFI │
44 │ │ │ ESP is located on │
45 │ │ │ is mounted to the │
46 │ │ │ root directory /. │
47 ├─────────────────────────────────────┼────────────────┼─────────────────────┤
48 │4f68bce3-e8cd-4db1-96e7-fbcaf984b709 │ Root Partition │ On 64-bit x86 │
49 │ │ (x86-64) │ systems, the first │
50 │ │ │ x86-64 root │
51 │ │ │ partition on the │
52 │ │ │ disk the EFI ESP is │
53 │ │ │ located on is │
54 │ │ │ mounted to the root │
55 │ │ │ directory /. │
56 ├─────────────────────────────────────┼────────────────┼─────────────────────┤
57 │69dad710-2ce4-4e3c-b16c-21a1d49abed3 │ Root Partition │ On 32-bit ARM │
58 │ │ (32-bit ARM) │ systems, the first │
59 │ │ │ ARM root partition │
60 │ │ │ on the disk the EFI │
61 │ │ │ ESP is located on │
62 │ │ │ is mounted to the │
63 │ │ │ root directory /. │
64 ├─────────────────────────────────────┼────────────────┼─────────────────────┤
65 │b921b045-1df0-41c3-af44-4c6f280d3fae │ Root Partition │ On 64-bit ARM │
66 │ │ (64-bit ARM) │ systems, the first │
67 │ │ │ ARM root partition │
68 │ │ │ on the disk the EFI │
69 │ │ │ ESP is located on │
70 │ │ │ is mounted to the │
71 │ │ │ root directory /. │
72 ├─────────────────────────────────────┼────────────────┼─────────────────────┤
73 │933ac7e1-2eb4-4f13-b844-0e14e2aef915 │ Home Partition │ The first home │
74 │ │ │ partition on the │
75 │ │ │ disk the root │
76 │ │ │ partition is │
77 │ │ │ located on is │
78 │ │ │ mounted to /home. │
79 ├─────────────────────────────────────┼────────────────┼─────────────────────┤
80 │3b8f8425-20e0-4f3b-907f-1a25a76f98e8 │ Server Data │ The first server │
81 │ │ Partition │ data partition on │
82 │ │ │ the disk the root │
83 │ │ │ partition is │
84 │ │ │ located on is │
85 │ │ │ mounted to /srv. │
86 ├─────────────────────────────────────┼────────────────┼─────────────────────┤
87 │0657fd6d-a4ab-43c4-84e5-0933c84b4f4f │ Swap │ All swap partitions │
88 │ │ │ located on the disk │
89 │ │ │ the root partition │
90 │ │ │ is located on are │
91 │ │ │ enabled. │
92 └─────────────────────────────────────┴────────────────┴─────────────────────┘
93
94 The /home and /srv partitions may be encrypted in LUKS format. In this
95 case a device mapper device is set up under the names /dev/mapper/home
96 and /dev/mapper/srv. Note that this might create conflicts if the same
97 partition is listed in /etc/crypttab with a different device mapper
98 device name.
99
100 Also note that systemd-efi-boot-generator(8) will mount the EFI System
101 Partition (ESP) to /boot if not otherwise mounted.
102
103 When using this generator in conjunction with btrfs file systems, make
104 sure to set the correct default subvolumes on them, using btrfs
105 subvolume set-default.
106
107 systemd-gpt-auto-generator implements systemd.generator(7).
108
110 systemd(1), systemd.mount(5), systemd.swap(5), systemd-fstab-
111 generator(8), systemd-efi-boot-generator(8), systemd-
112 cryptsetup@.service(8), cryptsetup(8), fstab(5), btrfs(8)
113
115 1. Discoverable Partitions Specification
116 http://www.freedesktop.org/wiki/Specifications/DiscoverablePartitionsSpec/
117
118
119
120systemd 219 SYSTEMD-GPT-AUTO-GENERATOR(8)