Changeset e4b8b81

Timestamp:

10/27/2008 06:33:21 AM (16 years ago)

Author:

Bruce Dubbs <bdubbs@…>

Branches:

10.0, 10.0-rc1, 10.1, 10.1-rc1, 11.0, 11.0-rc1, 11.0-rc2, 11.0-rc3, 11.1, 11.1-rc1, 11.2, 11.2-rc1, 11.3, 11.3-rc1, 12.0, 12.0-rc1, 12.1, 12.1-rc1, 6.4, 6.5, 6.6, 6.7, 6.8, 7.0, 7.1, 7.2, 7.3, 7.4, 7.5, 7.5-systemd, 7.6, 7.6-systemd, 7.7, 7.7-systemd, 7.8, 7.8-systemd, 7.9, 7.9-systemd, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, arm, bdubbs/gcc13, ml-11.0, multilib, renodr/libudev-from-systemd, s6-init, trunk, xry111/arm64, xry111/arm64-12.0, xry111/clfs-ng, xry111/lfs-next, xry111/loongarch, xry111/loongarch-12.0, xry111/loongarch-12.1, xry111/mips64el, xry111/pip3, xry111/rust-wip-20221008, xry111/update-glibc

Children:

bdd7f27

Parents:

db2f21e

Message:

Added a brief explanation of the Linux API Headers instructions.

git-svn-id: ​http://svn.linuxfromscratch.org/LFS/trunk/BOOK@8708 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

Files:

• chapter01/changelog.xml (modified) (1 diff)
• chapter05/linux-headers.xml (modified) (1 diff)
• chapter06/linux-headers.xml (modified) (1 diff)

chapter01/changelog.xml

@@ -41 +41 @@
       <itemizedlist>
         <listitem>
+          <para>[bdubbs] - Added a brief explanation of the Linux API Headers
+          instructions.</para>
+        </listitem>
+        <listitem>
           <para>[bdubbs] - Added i386, linux32, and linux64 as symbolic 
           links to setarch in util-linux contents.</para>

chapter05/linux-headers.xml

@@ -45 +45 @@
 
     <para>The Linux kernel needs to expose an Application Programming Interface
-    (API) for the system's C library (Glibc in LFS) to utilize.  This is done
+    (API) for the system's C library (Glibc in LFS) to use.  This is done
     by way of sanitizing various C header files that are shipped in the Linux
     kernel source tarball.</para>
 
-    <para>Install the header files:</para>
+    <para>First, make sure there are no stale files and dependencies lying around
+    from previous activity:</para>
 
-<screen><userinput remap="install">make mrproper
-make headers_check
+<screen><userinput remap="install">make mrproper</userinput></screen>
+
+    <para>Now test and extract the user-visible kernel headers from the source.
+    They are placed in an intermediate local directory and copied to the needed
+    location because the extraction process removes any existing files in 
+    the target directory.</para>
+
+<screen><userinput remap="install">make headers_check
 make INSTALL_HDR_PATH=dest headers_install
 cp -rv dest/include/* /tools/include</userinput></screen>

chapter06/linux-headers.xml

@@ -43 +43 @@
 
     <para>The Linux kernel needs to expose an Application Programming Interface
-    (API) for the system's C library (Glibc in LFS) to utilize.  This is done
+    (API) for the system's C library (Glibc in LFS) to use.  This is done
     by way of sanitizing various C header files that are shipped in the Linux
     kernel source tarball.</para>
 
-    <para>Install the header files:</para>
+    <para>First, make sure there are no stale files and dependencies lying around
+    from previous activity:</para>
 
-<screen><userinput remap="install">make mrproper
-make headers_check
+<screen><userinput remap="install">make mrproper</userinput></screen>
+
+    <para>Now test and extract the user-visible kernel headers from the source.
+    They are placed in an intermediate local directory and copied to the needed
+    location because the extraction process removes any existing files in 
+    the target directory.</para>
+
+<screen><userinput remap="install">make headers_check
 make INSTALL_HDR_PATH=dest headers_install
 cp -rv dest/include/* /usr/include</userinput></screen>