gronod/lfs
1
0
Fork 0
mirror of https://git.linuxfromscratch.org/lfs.git synced 2025-03-10 07:59:38 +00:00
Code Issues Packages Projects Releases Wiki Activity

loongarch: hostreqs: Reword the rationale for host kernel requirement

Browse Source 
Highlight the "old-world" vs. "new-world" issue.
This commit is contained in:
Xi Ruoyao 2023-06-11 00:47:59 +08:00
parent dae9e98af1
commit 1cab1bf5b2
No known key found for this signature in database
GPG Key ID: ACAAD20E19E710E3
1 changed files with 24 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

37
chapter02/hostreqs.xml
View File

@ -93,20 +93,31 @@
<para>The reason for the kernel version requirement is that we specify
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>
<xref linkend="chapter-building-system"/>, and
&min-kernel; is the oldest kernel release supported by Glibc for
LoongArch.</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>
<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
(PTY). It should be enabled on all desktop or server distros shipping