Changeset 39d9ed8 for chapter10/kernel.xml

Timestamp:

04/01/2023 01:06:22 PM (18 months ago)

Author:

Xi Ruoyao <xry111@…>

Branches:

xry111/clfs-ng

Children:

7a570bd

Parents:

6bced9f (diff), fd531b84 (diff)
Note: this is a merge changeset, the changes displayed below correspond to the merge itself.
Use the (diff) links above to see all the changes relative to each parent.

Message:

Merge remote-tracking branch 'origin/trunk' into xry111/clfs-ng

File:

• chapter10/kernel.xml (modified) (6 diffs)

chapter10/kernel.xml

@@ -46 +46 @@
     configures the kernel.</para>
 
+    <important>
+      <para>
+        Building the linux kernel for the first time is one of the most
+        challenging tasks in LFS.  Getting it right depends on the specific
+        hardware for the target system and your specific needs. There are
+        almost 12,000 configuration items that are available for the kernel
+        although only about a third of them are needed for most computers. The
+        LFS editors recommend that users not familiar with this process follow
+        the procedures below fairly closely.  The objective is to get an
+        initial system to a point where you can log in at the command line when
+        you reboot later in <xref linkend="ch-finish-reboot"/>.  At his point
+        optimization and customization is not a goal.
+      </para>
+
+      
+      <para>
+        For general information on kernel configuration see <ulink
+        url="&hints-root;kernel-configuration.txt"/>.  Additional information
+        about configuring and building the kernel can be found at <ulink
+        url="&anduin-sources;/kernel-nutshell/"/>. 
+        These references are a bit
+        dated, but still give a reasonable overview of the process.
+      </para>
+
+      <para>
+        If all else fails, you can ask for help on the <ulink
+        url="https://www.linuxfromscratch.org/mail.html">lfs-support</ulink>
+        mailing list.  Note that subscribing is required in order for the list
+        to avoid spam.
+      </para>
+    </important>
+
     <para>Prepare for compilation by running the following command:</para>
 
@@ -89 +121 @@
     <!-- Support for compiling a keymap into the kernel is deliberately removed -->
 
-    <para>For general information on kernel configuration see <ulink
-    url="&hints-root;kernel-configuration.txt"/>.  BLFS has some information
-    regarding particular kernel configuration requirements of packages outside
-    of LFS at <ulink
-    url="&blfs-book;longindex.html#kernel-config-index"/>.  Additional
-    information about configuring and building the kernel can be found at
-    <ulink url="http://www.kroah.com/lkn/"/> </para>
 
     <note>
@@ -135 +160 @@
    CPU/Task time and stats accounting ---&gt;
       [*] Pressure stall information tracking [CONFIG_PSI]
+      [ ]   Require boot parameter to enable pressure stall information tracking [CONFIG_PSI_DEFAULT_DISABLED]
    &lt; &gt; Enable kernel headers through /sys/kernel/kheaders.tar.xz [CONFIG_IKHEADERS]
    [*] Control Group support [CONFIG_CGROUPS]   ---&gt;
@@ -180 +206 @@
   [*] IOMMU Hardware Support ---&gt; [CONFIG_IOMMU_SUPPORT]
     [*] Support for Interrupt Remapping [CONFIG_IRQ_REMAP]</screen>
+
+      <para>If you are building a 32-bit system running on a hardware
+      with RAM more than 4GB, adjust the configuration so the kernel will
+      be able to use up to 64GB physical RAM:</para>
+
+      <screen role="nodump">Processor type and features ---&gt;
+  High Memory Support ---&gt;
+    (X) 64GB [CONFIG_HIGHMEM64G]</screen>
+
+      <para>If the partition for the LFS system is in a NVME SSD (i. e. the
+      device node for the partition is <filename>/dev/nvme*</filename>
+      instead of <filename>/dev/sd*</filename>), enable NVME support or
+      the LFS system won't boot:</para>
+
+      <screen role="nodump">Device Drivers ---&gt;
+  NVME Support ---&gt;
+    &lt;*&gt; NVM Express block device [CONFIG_BLK_DEV_NVME]</screen>
     </note>
 
@@ -187 +230 @@
     </note>
 
-    <para revision="sysv">There are several other options that may be desired
+    <para>There are several other options that may be desired
     depending on the requirements for the system. For a list of options needed
     for BLFS packages, see the <ulink
     url="&lfs-root;blfs/view/&short-version;/longindex.html#kernel-config-index">BLFS
-    Index of Kernel Settings</ulink>
-    (&lfs-root;blfs/view/&short-version;/longindex.html#kernel-config-index).</para>
+    Index of Kernel Settings</ulink>.</para>
 
     <note>
@@ -198 +240 @@
       LFS system with it, you should adjust some kernel configuration
       following <ulink url="&blfs-book;postlfs/grub-setup.html#uefi-kernel">
-      the BLFS page</ulink>.</para>
+      the BLFS page</ulink> <emphasis role='bold'>even if you'll use the
+      UEFI bootloader from the host distro</emphasis>.</para>
     </note>