summaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
Diffstat (limited to 'man')
-rw-r--r--man/systemd-gpt-auto-generator.xml84
1 files changed, 67 insertions, 17 deletions
diff --git a/man/systemd-gpt-auto-generator.xml b/man/systemd-gpt-auto-generator.xml
index 95c0c35046..75313994d7 100644
--- a/man/systemd-gpt-auto-generator.xml
+++ b/man/systemd-gpt-auto-generator.xml
@@ -43,7 +43,7 @@
<refnamediv>
<refname>systemd-gpt-auto-generator</refname>
<refpurpose>Generator for automatically discovering
- and mounting <filename>/home</filename> as well as
+ and mounting <filename>/home</filename> and <filename>/srv</filename>, as well as
discovering and enabling swap partitions, based on GPT
partition type GUIDs.</refpurpose>
</refnamediv>
@@ -56,16 +56,16 @@
<title>Description</title>
<para><filename>systemd-gpt-auto-generator</filename>
- is a generator that automatically discovers
- <filename>/home</filename> 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
+ is a unit generator that automatically discovers
+ <filename>/home</filename>, <filename>/srv</filename>
+ 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
+ has no effect on non-GPT systems, on systems where the
units are explicitly configured (for example, listed
in
- <citerefentry><refentrytitle>fstab</refentrytitle><manvolnum>5</manvolnum></citerefentry>)
- or where the mount point is non-empty.</para>
+ <citerefentry><refentrytitle>fstab</refentrytitle><manvolnum>5</manvolnum></citerefentry>),
+ or where the mount points are non-empty.</para>
<para>This generator will only look for partitions on
the same physical disk the root file system is stored
@@ -73,16 +73,63 @@
root file system is distributed on multiple disks, for
example via btrfs RAID.</para>
- <para>This generator is useful for centralizing file
- system configuration in the partition table and making
- manual configuration in
- <filename>/etc/fstab</filename> or suchlike
+ <para><filename>systemd-gpt-auto-generator</filename>
+ is useful for centralizing file system configuration
+ in the partition table and making manual configuration
+ in <filename>/etc/fstab</filename> or suchlike
unnecessary.</para>
- <para>This generator looks for swap partitions using
- GPT type 0657fd6d-a4ab-43c4-84e50933c84b4f4f. It looks
- for <filename>/home</filename> partitions using GPT
- type 933ac7e1-2eb4-4f13-b8440e14e2aef915.</para>
+ <para>This generator looks for the partitions based on
+ their partition type GUID. The following partition
+ type GUIDs are identified:</para>
+
+ <table>
+ <title>Partition Type GUIDs</title>
+ <tgroup cols='3' align='left' colsep='1' rowsep='1'>
+ <colspec colname="guid" />
+ <colspec colname="location" />
+ <colspec colname="explanation" />
+ <thead>
+ <row>
+ <entry>Partition Type GUID</entry>
+ <entry>Location</entry>
+ <entry>Explanation</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>0657fd6d-a4ab-43c4-84e50933c84b4f4f</entry>
+ <entry>Swap</entry>
+ <entry>All swap partitions are enabled.</entry>
+ </row>
+ <row>
+ <entry>933ac7e1-2eb4-4f13-b8440e14e2aef915</entry>
+ <entry><filename>/home</filename></entry>
+ <entry>The first home partition on the disk is mounted to <filename>/home</filename>.</entry>
+ </row>
+ <row>
+ <entry>3b8f8425-20e0-4f3b-907f1a25a76f98e8</entry>
+ <entry><filename>/srv</filename></entry>
+ <entry>The first server data partition on the disk is mounted to <filename>/srv</filename>.</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+
+ <para>The <filename>/home</filename> and
+ <filename>/srv</filename> partitions may be encrypted
+ in LUKS format. In this case a device mapper device is
+ set up under the names
+ <filename>/dev/mapper/home</filename> and
+ <filename>/dev/mapper/srv</filename>. Note that this
+ might create conflicts if the same partition is listed
+ in <filename>/etc/crypttab</filename> with a different
+ device mapper device name.</para>
+
+ <para>Also note that
+ <citerefentry><refentrytitle>systemd-efi-boot-generator</refentrytitle><manvolnum>8</manvolnum></citerefentry>
+ will mount the EFI System Partition to
+ <filename>/boot</filename> is not otherwise mounted.</para>
<para><filename>systemd-gpt-auto-generator</filename>
implements the <ulink
@@ -96,7 +143,10 @@
<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd.mount</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd.swap</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
+ <citerefentry><refentrytitle>systemd-fstab-generator</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd-efi-boot-generator</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
+ <citerefentry><refentrytitle>systemd-cryptsetup@.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
+ <citerefentry><refentrytitle>cryptsetup</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
<citerefentry><refentrytitle>fstab</refentrytitle><manvolnum>5</manvolnum></citerefentry>
</para>
</refsect1>