Changes in postlfs/filesystems/uefi-bootloaders/grub-efi.xml [f1a7af6:3f2db3a6]

File:

• postlfs/filesystems/uefi-bootloaders/grub-efi.xml (modified) (8 diffs)

postlfs/filesystems/uefi-bootloaders/grub-efi.xml

@@ -9 +9 @@
   <!ENTITY grub-efi-md5sum        "cf0fd928b1e5479c8108ee52cb114363">
   <!ENTITY grub-efi-size          "6.3 MB">
-  <!ENTITY grub-efi-buildsize     "185 MB">
-  <!ENTITY grub-efi-time          "0.9 SBU">
+  <!ENTITY grub-efi-buildsize     "137 MB">
+  <!ENTITY grub-efi-time          "1.0 SBU (on 64-bit LFS)">
 
   <!ENTITY unifont-download-http  "https://unifoundry.com/pub/unifont/unifont-&unifont-version;/font-builds/unifont-&unifont-version;.pcf.gz">
-  <!ENTITY unifont-md5sum         "4fbc33c8d8d25985f1bcdd4d28bc2420">
+  <!ENTITY unifont-md5sum         "428aa81e2433db172bbf7f4136cee6c5">
   <!ENTITY unifont-size           "1.3 MB">
+
+  <!ENTITY gcc-download-http      "&gnu-http;/gcc/gcc-&gcc-version;/gcc-&gcc-version;.tar.xz">
+  <!ENTITY gcc-md5sum             "73bafd0af874439dcdb9fc063b6fb069">
+  <!ENTITY gcc-size               "81 MB">
 ]>
 
@@ -20 +24 @@
   <?dbhtml filename="grub-efi.html"?>
 
-  <sect1info>
-    <date>$Date$</date>
-  </sect1info>
 
   <title>GRUB-&grub-version; for EFI</title>
@@ -39 +40 @@
     </para>
 
-    &lfs110a_checked;
+    &lfs112_checked;
 
     <bridgehead renderas="sect3">Package Information</bridgehead>
@@ -96 +97 @@
     </itemizedlist>
 
+    <itemizedlist spacing="compact">
+      <title>GCC (only needed if building on 32-bit LFS)</title>
+      <listitem>
+        <para>
+          Download (HTTP): <ulink url="&gcc-download-http;"/>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Download MD5 sum: &gcc-md5sum;
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Download size: &gcc-size;
+        </para>
+      </listitem>
+    </itemizedlist>
+
     <bridgehead renderas="sect3">GRUB Dependencies</bridgehead>
-
-    <bridgehead renderas="sect4">Required (runtime)</bridgehead>
-    <para role="runtime">
-      <xref linkend="efibootmgr"/>
-    </para>
 
     <bridgehead renderas="sect4">Recommended</bridgehead>
     <para role="recommended">
+      <xref role="runtime" linkend="efibootmgr"/> (runtime) and
       <xref linkend="freetype2"/>
     </para>
@@ -140 +156 @@
     </warning>
 
+    <para>If you are running a 32-bit LFS, prepare a 64-bit compiler:</para>
+
+<!-- 'literal' is used deliberately to show this is only for 32-bit LFS -->
+<screen><userinput>case $(uname -m) in i?86 )
+    <literal>tar xf ../gcc-&gcc-version;.tar.xz
+    mkdir gcc-&gcc-version;/build
+    pushd gcc-&gcc-version;/build
+        ../configure --prefix=$PWD/../../x86_64-gcc \
+                     --target=x86_64-linux-gnu      \
+                     --with-system-zlib             \
+                     --enable-languages=c,c++       \
+                     --with-ld=/usr/bin/ld
+        make all-gcc
+        make install-gcc
+    popd
+    export TARGET_CC=$PWD/x86_64-gcc/bin/x86_64-linux-gnu-gcc</literal>
+esac</userinput></screen>
+
     <para>
       Build <application>GRUB</application> with the following commands:
@@ -149 +183 @@
             --enable-grub-mkfont \
             --with-platform=efi  \
+            --target=x86_64      \
             --disable-werror     &amp;&amp;
+unset TARGET_CC &amp;&amp;
 make</userinput></screen>
 
@@ -178 +214 @@
       installed, it is possible to omit this option and build GRUB.  However,
       if <command>grub-mkfont</command> is not built, or the unicode font
-      data is not avaliable at the time GRUB is built, GRUB won't install
+      data is not available at the time GRUB is built, GRUB won't install
       any font for the boot loader.  The GRUB boot menu will be displayed
       using a coarse font and the early stage of kernel initialization will be
@@ -192 +228 @@
     </para>
 
+    <para>
+      <parameter>--target=x86_64</parameter>: Ensures building GRUB for
+      x86_64 even if building on a 32-bit LFS system.  Most EFI firmwares
+      on x86_64 does not support 32-bit bootloaders.
+    </para>
+
+    <para>
+      <option>--target=i386</option>: A few 32-bit x86 platforms have EFI
+      support.  And, some x86_64 platforms have a 32-bit EFI implementation,
+      but they are very old and rare. Use this instead of
+      <parameter>--target=x86_64</parameter> if you are
+      <emphasis role='bold'>absolutely sure</emphasis> that LFS is running
+      on such a system.
+    </para>
+
   </sect2>