[lfs] branch trunk updated: fstab: Document ESP mounting.

This is an automated email from the git hooks/post-receive script.

git pushed a commit to branch trunk
in repository lfs.

The following commit(s) were added to refs/heads/trunk by this push:
     new 37885247e fstab: Document ESP mounting.
37885247e is described below

commit 37885247eb8a7adbcefd1b4bbe575fad9c21cdd4
Author: Zeckmathederg <[email protected]>
AuthorDate: Mon Apr 6 21:28:45 2026 -0600

    fstab: Document ESP mounting.
---
 chapter10/fstab.xml | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/chapter10/fstab.xml b/chapter10/fstab.xml
index 8eb314b87..ad5ae2a41 100644
--- a/chapter10/fstab.xml
+++ b/chapter10/fstab.xml
@@ -88,6 +88,24 @@ EOF</userinput></screen>
   the kernel to convert the file names using UTF-8 so they can be
   interpreted in the UTF-8 locale.</para>
 
+  <para>
+    When booting with UEFI, the ESP must be formatted as a FAT filesystem, most
+    commonly VFAT. This file sees it as VFAT regardless. An example of how you
+    would go about an entry for the ESP would look like this:
+  </para>
+
+<screen><userinput>cat &gt;&gt; /etc/fstab &lt;&lt; "EOF"
+<literal>/dev/<replaceable>&lt;zzz&gt;</replaceable>     /boot/efi    vfat     rw,relatime,codepage=437,iocharset=iso8859-1,shortname=mixed,errors=remount-ro 0 2</literal>
+EOF</userinput></screen>
+
+  <para>
+    The <literal>iso8859-1</literal> IO charset is used here since UEFI
+    firmware implementations search for <filename
+    class="directory">\EFI\BOOT\BOOT...EFI</filename>, which in a
+    case-sensitive environment would not be satisfied. So that charset is used
+    to ensure the EFI image can be found.
+  </para>
+
   <!--note>
     <para>In the latter case, the kernel emits the following message:</para>
 
@@ -126,4 +144,5 @@ EOF</userinput></screen>
   <para>Note: Logical Volume Management (LVM) based partitions cannot use the
   <option>barrier</option> option.</para>
 -->
+
 </sect1>

-- 
To stop receiving notification emails like this one, please contact
the administrator of this repository.

-- 
http://lists.linuxfromscratch.org/sympa/info/lfs-book
Unsubscribe: See the above information page