man: document /efi in file-hiearchy(7)
authorLennart Poettering <lennart@poettering.net>
Wed, 2 May 2018 14:55:37 +0000 (16:55 +0200)
committerLennart Poettering <lennart@poettering.net>
Wed, 2 May 2018 14:56:19 +0000 (16:56 +0200)
We have been supporting the directory since a while in the gpt
generator, let's document it in file-hierarchy(7) too

man/file-hierarchy.xml

index f41039b..a0ceb40 100644 (file)
@@ -74,7 +74,7 @@
         <term><filename>/boot</filename></term>
         <listitem><para>The boot partition used for bringing up the
         system. On EFI systems, this is possibly the EFI System
-        Partition, also see
+        Partition (ESP), also see
         <citerefentry><refentrytitle>systemd-gpt-auto-generator</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
         This directory is usually strictly local to the host, and
         should be considered read-only, except when a new kernel or
       </varlistentry>
 
       <varlistentry>
+        <term><filename>/efi/</filename></term>
+        <listitem><para>If the boot partition <filename>/boot/</filename> is maintained separately from the EFI System
+        Partition (ESP), the latter is mounted here. Tools that need to operate on the EFI system partition should look
+        for it at this mount point first, and fall back to <filename>/boot/</filename> — if the former doesn't qualify
+        (for example if it is not a mount point or does not have the correct file system type
+        <constant>MSDOS_SUPER_MAGIC</constant>).</para></listitem>
+      </varlistentry>
+
+      <varlistentry>
         <term><filename>/etc</filename></term>
         <listitem><para>System-specific configuration. This directory
         may or may not be read-only. Frequently, this directory is