man/systemd-gpt-auto-generator.html

   1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>systemd-gpt-auto-generator</title><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><style>
   2     a.headerlink {
   3       color: #c60f0f;
   4       font-size: 0.8em;
   5       padding: 0 4px 0 4px;
   6       text-decoration: none;
   7       visibility: hidden;
   8     }
   9
  10     a.headerlink:hover {
  11       background-color: #c60f0f;
  12       color: white;
  13     }
  14
  15     h1:hover > a.headerlink, h2:hover > a.headerlink, h3:hover > a.headerlink, dt:hover > a.headerlink {
  16       visibility: visible;
  17     }
  18   </style><a href="index.html">Index </a>·
  19   <a href="systemd.directives.html">Directives </a>·
  20   <a href="../python-systemd/index.html">Python </a>·
  21   <a href="../libudev/index.html">libudev </a>·
  22   <a href="../libudev/index.html">gudev </a><span style="float:right">systemd 218</span><hr><div class="refentry"><a name="systemd-gpt-auto-generator"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>systemd-gpt-auto-generator — Generator for automatically discovering
  23                 and mounting root, <code class="filename">/home</code> and
  24                 <code class="filename">/srv</code> partitions, as well as
  25                 discovering and enabling swap partitions, based on GPT
  26                 partition type GUIDs.</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><p><code class="filename">/usr/lib/systemd/system-generators/systemd-gpt-auto-generator</code></p></div><div class="refsect1"><a name="idm139813771640800"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><code class="filename">systemd-gpt-auto-generator</code>
  27                 is a unit generator that automatically discovers root,
  28                 <code class="filename">/home</code>, <code class="filename">/srv</code>
  29                 and swap partitions and creates mount and swap units
  30                 for them, based on the partition type GUIDs of
  31                 GUID partition tables (GPT). It implements the <a class="ulink" href="http://www.freedesktop.org/wiki/Specifications/DiscoverablePartitionsSpec/" target="_top">Discoverable
  32                 Partitions Specification</a>. Note that this
  33                 generator has no effect on non-GPT systems, on systems
  34                 where the units are explicitly configured (for
  35                 example, listed in
  36                 <a href="fstab.html"><span class="citerefentry"><span class="refentrytitle">fstab</span>(5)</span></a>),
  37                 or where the mount points are non-empty.</p><p>This generator will only look for root
  38                 partitions on the same physical disk the EFI System
  39                 Partition (ESP) is located on. It will only look for
  40                 the other partitions on the same physical disk the
  41                 root file system is located on. These partitions will
  42                 not be searched on systems where the root file system is
  43                 distributed on multiple disks, for example via btrfs
  44                 RAID.</p><p><code class="filename">systemd-gpt-auto-generator</code>
  45                 is useful for centralizing file system configuration
  46                 in the partition table and making manual configuration
  47                 in <code class="filename">/etc/fstab</code> or suchlike
  48                 unnecessary.</p><p>This generator looks for the partitions based on
  49                 their partition type GUID. The following partition
  50                 type GUIDs are identified:</p><div class="table"><a name="idm139813771632512"></a><p class="title"><b>Table 1. Partition Type GUIDs</b></p><div class="table-contents"><table summary="Partition Type GUIDs" border="1"><colgroup><col align="left" class="guid"><col align="left" class="name"><col align="left" class="explanation"></colgroup><thead><tr><th align="left">Partition Type GUID</th><th align="left">Name</th><th align="left">Explanation</th></tr></thead><tbody><tr><td align="left">44479540-f297-41b2-9af7-d131d5f0458a</td><td align="left"><code class="filename">Root Partition (x86)</code></td><td align="left">On 32-bit x86 systems, the first x86 root partition on the disk the EFI ESP is located on is mounted to the root directory <code class="filename">/</code>.</td></tr><tr><td align="left">4f68bce3-e8cd-4db1-96e7-fbcaf984b709</td><td align="left"><code class="filename">Root Partition (x86-64)</code></td><td align="left">On 64-bit x86 systems, the first x86-64 root partition on the disk the EFI ESP is located on is mounted to the root directory <code class="filename">/</code>.</td></tr><tr><td align="left">69dad710-2ce4-4e3c-b16c-21a1d49abed3</td><td align="left"><code class="filename">Root Partition (32-bit ARM)</code></td><td align="left">On 32-bit ARM systems, the first ARM root partition on the disk the EFI ESP is located on is mounted to the root directory <code class="filename">/</code>.</td></tr><tr><td align="left">b921b045-1df0-41c3-af44-4c6f280d3fae</td><td align="left"><code class="filename">Root Partition (64-bit ARM)</code></td><td align="left">On 64-bit ARM systems, the first ARM root partition on the disk the EFI ESP is located on is mounted to the root directory <code class="filename">/</code>.</td></tr><tr><td align="left">933ac7e1-2eb4-4f13-b844-0e14e2aef915</td><td align="left">Home Partition</td><td align="left">The first home partition on the disk the root partition is located on is mounted to <code class="filename">/home</code>.</td></tr><tr><td align="left">3b8f8425-20e0-4f3b-907f-1a25a76f98e8</td><td align="left">Server Data Partition</td><td align="left">The first server data partition on the disk the root partition is located on is mounted to <code class="filename">/srv</code>.</td></tr><tr><td align="left">0657fd6d-a4ab-43c4-84e5-0933c84b4f4f</td><td align="left">Swap</td><td align="left">All swap partitions located on the disk the root partition is located on are enabled.</td></tr></tbody></table></div></div><br class="table-break"><p>The <code class="filename">/home</code> and
  51                 <code class="filename">/srv</code> partitions may be encrypted
  52                 in LUKS format. In this case a device mapper device is
  53                 set up under the names
  54                 <code class="filename">/dev/mapper/home</code> and
  55                 <code class="filename">/dev/mapper/srv</code>. Note that this
  56                 might create conflicts if the same partition is listed
  57                 in <code class="filename">/etc/crypttab</code> with a different
  58                 device mapper device name.</p><p>Also note that
  59                 <a href="systemd-efi-boot-generator.html"><span class="citerefentry"><span class="refentrytitle">systemd-efi-boot-generator</span>(8)</span></a>
  60                 will mount the EFI System Partition (ESP) to
  61                 <code class="filename">/boot</code> if not otherwise mounted.</p><p>When using this generator in conjunction with
  62                 btrfs file systems, make sure to set the correct
  63                 default subvolumes on them, using <span class="command"><strong>btrfs
  64                 subvolume set-default</strong></span>.</p><p><code class="filename">systemd-gpt-auto-generator</code>
  65                 implements the <a class="ulink" href="http://www.freedesktop.org/wiki/Software/systemd/Generators" target="_top">Generator
  66                 Specification</a>.</p></div><div class="refsect1"><a name="idm139813775495552"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
  67                         <a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
  68                         <a href="systemd.mount.html"><span class="citerefentry"><span class="refentrytitle">systemd.mount</span>(5)</span></a>,
  69                         <a href="systemd.swap.html"><span class="citerefentry"><span class="refentrytitle">systemd.swap</span>(5)</span></a>,
  70                         <a href="systemd-fstab-generator.html"><span class="citerefentry"><span class="refentrytitle">systemd-fstab-generator</span>(8)</span></a>,
  71                         <a href="systemd-efi-boot-generator.html"><span class="citerefentry"><span class="refentrytitle">systemd-efi-boot-generator</span>(8)</span></a>,
  72                         <a href="systemd-cryptsetup@.service.html"><span class="citerefentry"><span class="refentrytitle">systemd-cryptsetup@.service</span>(8)</span></a>,
  73                         <a href="cryptsetup.html"><span class="citerefentry"><span class="refentrytitle">cryptsetup</span>(8)</span></a>,
  74                         <a href="fstab.html"><span class="citerefentry"><span class="refentrytitle">fstab</span>(5)</span></a>,
  75                         <a href="btrfs.html"><span class="citerefentry"><span class="refentrytitle">btrfs</span>(8)</span></a>
  76                 </p></div></div></body></html>