Changeset 1cab1bf for chapter02

Timestamp:

06/11/2023 08:40:42 PM (16 months ago)

Author:

Xi Ruoyao <xry111@…>

Branches:

xry111/loongarch, xry111/loongarch-12.0, xry111/loongarch-12.1, xry111/loongarch-12.2

Children:

cc44a47b

Parents:

dae9e98

git-author:

Xi Ruoyao <xry111@…> (06/10/2023 04:47:59 PM)

git-committer:

Xi Ruoyao <xry111@…> (06/11/2023 08:40:42 PM)

Message:

loongarch: hostreqs: Reword the rationale for host kernel requirement

Highlight the "old-world" vs. "new-world" issue.

File:

• chapter02/hostreqs.xml (modified) (1 diff)

chapter02/hostreqs.xml

@@ -94 +94 @@
       that version when building <application>glibc</application> in
       <xref linkend="chapter-cross-tools"/> and
-      <xref linkend="chapter-building-system"/>, so the workarounds for
-      older kernels are not enabled and the compiled
-      <application>glibc</application> is slightly faster and smaller.
-      As at June 2023, &min-kernel; is the oldest kernel release still
-      supported by the kernel developers.</para>
-
-      <para>If the host kernel is earlier than &min-kernel; you will need to replace
-      the kernel with a more up-to-date version. There are two ways
-      you can go about this. First, see if your Linux vendor provides a &min-kernel;
-      or later kernel package. If so, you may wish to install it. If your
-      vendor doesn't offer an acceptable kernel package, or you would prefer not to
-      install it, you can compile a kernel yourself. Instructions for
-      compiling the kernel and configuring the boot loader (assuming the host
-      uses GRUB) are located in <xref linkend="chapter-bootable"/>.</para>
+      <xref linkend="chapter-building-system"/>, and
+      &min-kernel; is the oldest kernel release supported by Glibc for
+      LoongArch.</para>
+
+      <important>
+        <para>
+          If a Linux distribution on LoongArch provides a kernel older than
+          &min-kernel;, it indicates the distribution is using a preliminary
+          version of the kernel ABI.  The preliminary draft was rejected by
+          the kernel maintainers and it's fundamentally incompatible with
+          the packages we will built for LFS.  Such <quote>old-world</quote>
+          distributions (for example, Loongnix) cannot be used as a host
+          distro for building LFS.
+        </para>
+
+        <para>
+          Do not attempt to update the kernel to &min-kernel; or later on
+          a old-world distro because doing so will cause a boot failure.
+          Use a <quote>new-world</quote> distribution providing Linux Kernel
+          &min-kernel; or newer instead.  You may need to contact the vendor
+          of your hardware to get a firmware update for booting a new-world
+          distribution because the boot protocol of LoongArch is stabilized
+          after the launch of the early LoongArch hardwares.
+        </para>
+      </important>
 
       <para>We require the host kernel to support UNIX 98 pseudo terminal