diff options
Diffstat (limited to 'upstream/fedora-rawhide/man8/systemd-gpt-auto-generator.8')
| -rw-r--r-- | upstream/fedora-rawhide/man8/systemd-gpt-auto-generator.8 | 128 |
1 files changed, 78 insertions, 50 deletions
diff --git a/upstream/fedora-rawhide/man8/systemd-gpt-auto-generator.8 b/upstream/fedora-rawhide/man8/systemd-gpt-auto-generator.8 index 2282d2fe..2a4a5416 100644 --- a/upstream/fedora-rawhide/man8/systemd-gpt-auto-generator.8 +++ b/upstream/fedora-rawhide/man8/systemd-gpt-auto-generator.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-GPT\-AUTO\-GENERATOR" "8" "" "systemd 255" "systemd-gpt-auto-generator" +.TH "SYSTEMD\-GPT\-AUTO\-GENERATOR" "8" "" "systemd 256~rc3" "systemd-gpt-auto-generator" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -31,12 +31,19 @@ is a unit generator that automatically discovers the root partition, /home/, /srv/, /var/, -/var/tmp/, the EFI System Partition, the Extended Boot Loader Partition, and swap partitions and creates mount and swap units for them, based on the partition type GUIDs of GUID partition tables (GPT)\&. See +/var/tmp/, the EFI System Partition (ESP), the Extended Boot Loader Partition (XBOOTLDR), and swap partitions and creates mount and swap units for them, based on the partition type GUIDs of GUID partition tables (GPT)\&. See \m[blue]\fBUEFI Specification\fR\m[]\&\s-2\u[1]\d\s+2, chapter 5 for more details\&. It implements the \m[blue]\fBDiscoverable Partitions Specification\fR\m[]\&\s-2\u[2]\d\s+2\&. .PP Note that this generator has no effect on non\-GPT systems\&. It will also not create mount point configuration for directories which already contain files or if the mount point is explicitly configured in -\fBfstab\fR(5)\&. If the units this generator creates are overridden, for example by units in directories with higher precedence, drop\-ins and additional dependencies created by this generator might still be used\&. +\fBfstab\fR(5)\&. Additionally no unit will be created for the ESP or the XBOOTLDR partition if mount entries are found in the +/boot/ +or +/efi/ +hierarchies in +\fBfstab\fR(5)\&. +.PP +If the units this generator creates are overridden, for example by units in directories with higher precedence, drop\-ins and additional dependencies created by this generator might still be used\&. .PP This generator will only look for the root partition on the same physical disk where the EFI System Partition (ESP) is located\&. Note that support from the boot loader is required: the EFI variable \fILoaderDevicePartUUID\fR @@ -62,9 +69,11 @@ This generator looks for the partitions based on their partition type GUID\&. Th .B Table\ \&1.\ \&Partition Type GUIDs .TS allbox tab(:); -lB lB lB lB. +lB lB lB lB lB. T{ -Partition Type GUID +Partition Type +T}:T{ +GUID T}:T{ Name T}:T{ @@ -73,90 +82,108 @@ T}:T{ Explanation T} .T& -l l l l -l l l l -l l l l -l l l l -l l l l -l l l l -l l l l -l l l l -l l l l -l l l l. +l l l l l +l l l l l +l l l l l +l l l l l +l l l l l +l l l l l +l l l l l +l l l l l +l l l l l +l l l l l. T{ -\fBSD_GPT_ROOT_X86_64\fR \fB4f68bce3\-e8cd\-4db1\-96e7\-fbcaf984b709\fR +\fBSD_GPT_ROOT_X86_64\fR +T}:T{ +\fB4f68bce3\-e8cd\-4db1\-96e7\-fbcaf984b709\fR T}:T{ Root Partition (x86\-64) T}:T{ / T}:T{ -The first partition with this type UUID, located on the same disk as the ESP, is used as the root file system / on AMD64 / 64\-bit x86 systems\&. +The first partition with this type UUID, located on the same disk as the ESP used for booting, is used as the root file system / on AMD64 / 64\-bit x86 systems\&. T} T{ -\fBSD_GPT_ROOT_ARM64\fR \fBb921b045\-1df0\-41c3\-af44\-4c6f280d3fae\fR +\fBSD_GPT_ROOT_ARM64\fR +T}:T{ +\fBb921b045\-1df0\-41c3\-af44\-4c6f280d3fae\fR T}:T{ Root Partition (64\-bit ARM) T}:T{ / T}:T{ -The first partition with this type UUID, located on the same disk as the ESP, is used as the root file system / on AArch64 / 64\-bit ARM systems\&. +The first partition with this type UUID, located on the same disk as the ESP used for booting, is used as the root file system / on AArch64 / 64\-bit ARM systems\&. T} T{ \fBSD_GPT_ROOT_ALPHA\fR \fBSD_GPT_ROOT_ARC\fR \fBSD_GPT_ROOT_ARM\fR \fBSD_GPT_ROOT_ARM64\fR \fBSD_GPT_ROOT_IA64\fR \fBSD_GPT_ROOT_LOONGARCH64\fR \fBSD_GPT_ROOT_MIPS\fR \fBSD_GPT_ROOT_MIPS64\fR \fBSD_GPT_ROOT_MIPS_LE\fR \fBSD_GPT_ROOT_MIPS64_LE\fR \fBSD_GPT_ROOT_PARISC\fR \fBSD_GPT_ROOT_PPC\fR \fBSD_GPT_ROOT_PPC64\fR \fBSD_GPT_ROOT_PPC64_LE\fR \fBSD_GPT_ROOT_RISCV32\fR \fBSD_GPT_ROOT_RISCV64\fR \fBSD_GPT_ROOT_S390\fR \fBSD_GPT_ROOT_S390X\fR \fBSD_GPT_ROOT_TILEGX\fR \fBSD_GPT_ROOT_X86\fR \fBSD_GPT_ROOT_X86_64\fR \fBSD_GPT_USR_ALPHA\fR \fBSD_GPT_USR_ARC\fR \fBSD_GPT_USR_ARM\fR \fBSD_GPT_USR_IA64\fR \fBSD_GPT_USR_LOONGARCH64\fR \fBSD_GPT_USR_MIPS_LE\fR \fBSD_GPT_USR_MIPS64_LE\fR \fBSD_GPT_USR_PARISC\fR \fBSD_GPT_USR_PPC\fR \fBSD_GPT_USR_PPC64\fR \fBSD_GPT_USR_PPC64_LE\fR \fBSD_GPT_USR_RISCV32\fR \fBSD_GPT_USR_RISCV64\fR \fBSD_GPT_USR_S390\fR \fBSD_GPT_USR_S390X\fR \fBSD_GPT_USR_TILEGX\fR \fBSD_GPT_USR_X86\fR T}:T{ -root partitions for other architectures +\&... +T}:T{ +Root partitions for other architectures T}:T{ / T}:T{ -The first partition with the type UUID matching the architecture, located on the same disk as the ESP, is used as the root file system /\&. For the full list and constant values, see \m[blue]\fBDiscoverable Partitions Specification\fR\m[]\&\s-2\u[2]\d\s+2\&. +The first partition with the type UUID matching the architecture, located on the same disk as the ESP used for booting, is used as the root file system /\&. For the full list and constant values, see \m[blue]\fBDiscoverable Partitions Specification\fR\m[]\&\s-2\u[2]\d\s+2\&. T} T{ -\fBSD_GPT_HOME\fR \fB933ac7e1\-2eb4\-4f13\-b844\-0e14e2aef915\fR +\fBSD_GPT_HOME\fR +T}:T{ +\fB933ac7e1\-2eb4\-4f13\-b844\-0e14e2aef915\fR T}:T{ Home Partition T}:T{ /home/ T}:T{ -The first partition with this type UUID on the same disk as the ESP is mounted to /home/\&. +The first partition with this type UUID on the same disk as the root partition is mounted to /home/\&. T} T{ -\fBSD_GPT_SRV\fR \fB3b8f8425\-20e0\-4f3b\-907f\-1a25a76f98e8\fR +\fBSD_GPT_SRV\fR +T}:T{ +\fB3b8f8425\-20e0\-4f3b\-907f\-1a25a76f98e8\fR T}:T{ Server Data Partition T}:T{ /srv/ T}:T{ -The first partition with this type UUID on the same disk as the ESP is mounted to /srv/\&. +The first partition with this type UUID on the same disk as the root partition is mounted to /srv/\&. T} T{ -\fBSD_GPT_VAR\fR \fB4d21b016\-b534\-45c2\-a9fb\-5c16e091fd2d\fR +\fBSD_GPT_VAR\fR +T}:T{ +\fB4d21b016\-b534\-45c2\-a9fb\-5c16e091fd2d\fR T}:T{ Variable Data Partition T}:T{ /var/ T}:T{ -The first partition with this type UUID on the same disk as the ESP is mounted to /var/ \(em under the condition its partition UUID matches the first 128 bit of the HMAC\-SHA256 of the GPT type uuid of this partition keyed by the machine ID of the installation stored in \fBmachine-id\fR(5)\&. +The first partition with this type UUID on the same disk as the root partition is mounted to /var/ \(em under the condition its partition UUID matches the first 128 bit of the HMAC\-SHA256 of the GPT type uuid of this partition keyed by the machine ID of the installation stored in \fBmachine-id\fR(5)\&. T} T{ -\fBSD_GPT_TMP\fR \fB7ec6f557\-3bc5\-4aca\-b293\-16ef5df639d1\fR +\fBSD_GPT_TMP\fR +T}:T{ +\fB7ec6f557\-3bc5\-4aca\-b293\-16ef5df639d1\fR T}:T{ Temporary Data Partition T}:T{ /var/tmp/ T}:T{ -The first partition with this type UUID on the same disk as the ESP is mounted to /var/tmp/\&. +The first partition with this type UUID on the same disk as the root partition is mounted to /var/tmp/\&. T} T{ -\fBSD_GPT_SWAP\fR \fB0657fd6d\-a4ab\-43c4\-84e5\-0933c84b4f4f\fR +\fBSD_GPT_SWAP\fR +T}:T{ +\fB0657fd6d\-a4ab\-43c4\-84e5\-0933c84b4f4f\fR T}:T{ Swap T}:T{ n/a T}:T{ -All partitions with this type UUID on the same disk as the ESP are used as swap\&. +All partitions with this type UUID on the same disk as the root partition are used as swap\&. T} T{ -\fBSD_GPT_ESP\fR \fBc12a7328\-f81f\-11d2\-ba4b\-00a0c93ec93b\fR +\fBSD_GPT_ESP\fR +T}:T{ +\fBc12a7328\-f81f\-11d2\-ba4b\-00a0c93ec93b\fR T}:T{ EFI System Partition (ESP) T}:T{ @@ -165,7 +192,9 @@ T}:T{ The first partition with this type UUID located on the same disk as the root partition is mounted to /boot/ or /efi/, see below\&. T} T{ -\fBSD_GPT_XBOOTLDR\fR \fBbc13c2ff\-59e6\-4262\-a352\-b275fd6f7172\fR +\fBSD_GPT_XBOOTLDR\fR +T}:T{ +\fBbc13c2ff\-59e6\-4262\-a352\-b275fd6f7172\fR T}:T{ Extended Boot Loader Partition T}:T{ @@ -185,34 +214,42 @@ This generator understands the following attribute flags for partitions: .B Table\ \&2.\ \&Partition Attribute Flags .TS allbox tab(:); -lB lB lB. +lB lB lB lB. T{ Flag T}:T{ +Value +T}:T{ Applicable to T}:T{ Explanation T} .T& -l l l -l l l -l l l. +l l l l +l l l l +l l l l. T{ -\fBSD_GPT_FLAG_READ_ONLY\fR \fB0x1000000000000000\fR +\fBSD_GPT_FLAG_READ_ONLY\fR +T}:T{ +\fB0x1000000000000000\fR T}:T{ /, /home/, /srv/, /var/, /var/tmp/, Extended Boot Loader Partition T}:T{ Partition is mounted read\-only T} T{ -\fBSD_GPT_FLAG_NO_AUTO\fR \fB0x8000000000000000\fR +\fBSD_GPT_FLAG_NO_AUTO\fR +T}:T{ +\fB0x8000000000000000\fR T}:T{ /, /home/, /srv/, /var/, /var/tmp/, Extended Boot Loader Partition T}:T{ Partition is not mounted automatically T} T{ -\fBSD_GPT_FLAG_NO_BLOCK_IO_PROTOCOL\fR \fB0x0000000000000002\fR +\fBSD_GPT_FLAG_NO_BLOCK_IO_PROTOCOL\fR +T}:T{ +\fB0x0000000000000002\fR T}:T{ EFI System Partition (ESP) T}:T{ @@ -334,16 +371,7 @@ Added in version 254\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.mount\fR(5), -\fBsystemd.swap\fR(5), -\fBsystemd-fstab-generator\fR(8), -\fBsystemd-cryptsetup@.service\fR(8), -\fBsystemd-pcrfs@.service\fR(8), -\fBmachine-id\fR(5), -\fBcryptsetup\fR(8), -\fBfstab\fR(5), -\fBbtrfs\fR(8) +\fBsystemd\fR(1), \fBsystemd.mount\fR(5), \fBsystemd.swap\fR(5), \fBsystemd-fstab-generator\fR(8), \fBsystemd-cryptsetup@.service\fR(8), \fBsystemd-pcrfs@.service\fR(8), \fBmachine-id\fR(5), \fBcryptsetup\fR(8), \fBfstab\fR(5), \fBbtrfs\fR(8) .SH "NOTES" .IP " 1." 4 UEFI Specification |