Changeset ef2b63b

Timestamp:

01/15/2003 02:55:21 PM (21 years ago)

Author:

Timothy Bauscher <timothy@…>

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.0, 6.1, 6.1.1, 6.3, 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, v4_1, v5_0, v5_1, v5_1_1, 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:

9de7ed3

Parents:

f8fe1c1e

Message:

Converted kernel header install page to new layout.

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

Files:

• chapter06/kernel-exp-headers.xml (modified) (1 diff)
• chapter06/kernel-inst.xml (modified) (3 diffs)
• chapter06/kernel.xml (modified) (1 diff)
• entities/kernel.ent (modified) (1 diff)

chapter06/kernel-exp-headers.xml

@@ +1 @@
+<sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
+
 <sect2>
 <title>Why we copy the kernel headers and don't symlink them</title>

chapter06/kernel-inst.xml

@@ +1 @@
+<sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
+
 <sect2>
 <title>Installation of the kernel headers</title>
@@ -4 +6 @@
 <para>We won't be compiling a new kernel yet -- we'll do that when we have
 finished the installation of all the packages. But as some packages need the
-kernel header files, we're going to unpack the kernel archive now, set it up,
-and copy the header files to where they will be found by these packages.</para>
+kernel header files, we're going to unpack the kernel archive now, set it up
+and copy the header files so they can be found by these packages.</para>
 
 <para>It is important to note that the files in the kernel source directory
@@ -13 +15 @@
 problem for any other package you install because you remove the source
 tree after the installation. But the Linux kernel source tree is often kept
-around for a long time, so there's a chance whatever userid was used will
-be assigned to somebody on your machine, and that person would get write
+around for a long time, so there's a chance that whatever userid was used will
+be assigned to somebody on your machine and that person would have write
 access to the kernel source.</para>
 
 <para>In light of this, you might want to run <userinput>chown
-0.0</userinput> on the linux-&kernel-version; directory to ensure all files
-are owned by user <emphasis>root</emphasis>.</para>
+0.0</userinput> on the <filename>linux-&kernel-version;</filename> directory
+to ensure all files are owned by user <emphasis>root</emphasis>.</para>
 
-<para>The kernel headers are installed by running the following
-commands:</para>
+<para>Kernel header installation requires the <emphasis>pwd</emphasis> program.
+In the kernel source, the path to the pwd program is hard-wired as /bin/pwd.
+Create a symlink to account for that:</para>
 
-<para><screen><userinput>ln -s /static/bin/pwd /bin/pwd &amp;&amp;
-make mrproper &amp;&amp;
-make include/linux/version.h &amp;&amp;
-make symlinks &amp;&amp;
-cp -HR include/asm /usr/include &amp;&amp;
-cp -R include/asm-generic /usr/include &amp;&amp;
-cp -R include/linux /usr/include &amp;&amp;
-touch /usr/include/linux/autoconf.h &amp;&amp;
-rm /bin/pwd</userinput></screen></para>
+<para><screen><userinput>ln -s /static/bin/pwd /bin/pwd &amp;&amp;</userinput></screen></para>
+
+<para>Prepare for header installation:</para>
+
+<para><screen><userinput>make mrproper</userinput></screen></para>
+
+<para>This ensures that the kernel tree is absolutely clean. The kernel team
+recommends that this command be issued prior to <emphasis>each</emphasis> kernel
+compilation. You shouldn't rely on the source tree being clean after
+untarring.</para>
+
+<para>Create the <filename>include/linux/version.h</filename> file:</para>
+
+<para><screen><userinput>make include/linux/version.h</userinput></screen></para>
+
+<para>Create the platform-specific <filename>include/asm</filename>
+symlink:</para>
+
+<para><screen><userinput>make symlinks</userinput></screen></para>
+
+<para>Install the platform specific-header files:</para>
+
+<para><screen><userinput>cp -HR include/asm /usr/include &amp;&amp;
+cp -R include/asm-generic /usr/include</userinput></screen></para>
+
+<para>Install the cross-platform kernel header files:</para>
+
+<para><screen><userinput>cp -R include/linux /usr/include</userinput></screen></para>
+
+<para>There are a few kernel header files which make use of the
+<filename>autoconf.h</filename> header file. Since we do not yet configure the
+kernel, we need to create this file ourselves in order to avoid compilation
+failures. Create an empty autoconf.h file:</para>
+
+<para><screen><userinput>touch /usr/include/linux/autoconf.h</userinput></screen></para>
+
+<para>Since the <filename>/bin/pwd</filename> symlink we created earlier
+was only temporary, it can now be removed:</para>
+
+<para><screen><userinput>rm /bin/pwd</userinput></screen></para>
 
 </sect2>

chapter06/kernel.xml

@@ -6 +6 @@
 Estimated required disk space:  &kernel-compsize-headers;</screen>
 
+&aa-kernel-shortdesc;
+&aa-kernel-dep;
 &c6-kernel-inst;
-&c6-kernel-exp;
 &c6-kernel-exp-headers;
-&aa-kernel-desc;
-&aa-kernel-dep;
 
 </sect1>

entities/kernel.ent

@@ -3 +3 @@
 <!ENTITY c6-kernel SYSTEM "../chapter06/kernel.xml">
 <!ENTITY c6-kernel-inst SYSTEM "../chapter06/kernel-inst.xml">
-<!ENTITY c6-kernel-exp SYSTEM "../chapter06/kernel-exp.xml">
 <!ENTITY c6-kernel-exp-headers SYSTEM "../chapter06/kernel-exp-headers.xml">
 <!ENTITY c6-kernel-manpages SYSTEM "../chapter06/kernel-manpages.xml">