cvs commit: LFS/BOOK/entities kernel.ent

timothy at timothy at
Wed Jan 15 06:55:22 PST 2003

timothy     03/01/15 09:55:22

  Modified:    BOOK/chapter06 kernel-exp-headers.xml kernel-inst.xml
               BOOK/entities kernel.ent
  Converted kernel header install page to new layout.
  Revision  Changes    Path
  1.5       +2 -0      LFS/BOOK/chapter06/kernel-exp-headers.xml
  Index: kernel-exp-headers.xml
  RCS file: /home/cvsroot/LFS/BOOK/chapter06/kernel-exp-headers.xml,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- kernel-exp-headers.xml	28 Sep 2002 21:08:29 -0000	1.4
  +++ kernel-exp-headers.xml	15 Jan 2003 14:55:21 -0000	1.5
  @@ -1,3 +1,5 @@
  +<sect2><title> </title><para> </para></sect2>
   <title>Why we copy the kernel headers and don't symlink them</title>
  1.8       +51 -17    LFS/BOOK/chapter06/kernel-inst.xml
  Index: kernel-inst.xml
  RCS file: /home/cvsroot/LFS/BOOK/chapter06/kernel-inst.xml,v
  retrieving revision 1.7
  retrieving revision 1.8
  diff -u -r1.7 -r1.8
  --- kernel-inst.xml	1 Jan 2003 14:27:12 -0000	1.7
  +++ kernel-inst.xml	15 Jan 2003 14:55:21 -0000	1.8
  @@ -1,10 +1,12 @@
  +<sect2><title> </title><para> </para></sect2>
   <title>Installation of the kernel headers</title>
   <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
   are not owned by root. Whenever you unpack a package as user root (like we
  @@ -12,26 +14,58 @@
   whatever they were on the packager's computer. This is usually not a
   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>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 &&</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
  +<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>
  +<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 &&
  +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>The kernel headers are installed by running the following
  +<para>Since the <filename>/bin/pwd</filename> symlink we created earlier
  +was only temporary, it can now be removed:</para>
  -<para><screen><userinput>ln -s /static/bin/pwd /bin/pwd &&
  -make mrproper &&
  -make include/linux/version.h &&
  -make symlinks &&
  -cp -HR include/asm /usr/include &&
  -cp -R include/asm-generic /usr/include &&
  -cp -R include/linux /usr/include &&
  -touch /usr/include/linux/autoconf.h &&
  -rm /bin/pwd</userinput></screen></para>
  +<para><screen><userinput>rm /bin/pwd</userinput></screen></para>
  1.4       +2 -3      LFS/BOOK/chapter06/kernel.xml
  Index: kernel.xml
  RCS file: /home/cvsroot/LFS/BOOK/chapter06/kernel.xml,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- kernel.xml	1 Jan 2003 14:27:12 -0000	1.3
  +++ kernel.xml	15 Jan 2003 14:55:21 -0000	1.4
  @@ -5,11 +5,10 @@
   <screen>Estimated build time:           &kernel-time-headers;
   Estimated required disk space:  &kernel-compsize-headers;</screen>
  1.13      +0 -1      LFS/BOOK/entities/kernel.ent
  Index: kernel.ent
  RCS file: /home/cvsroot/LFS/BOOK/entities/kernel.ent,v
  retrieving revision 1.12
  retrieving revision 1.13
  diff -u -r1.12 -r1.13
  --- kernel.ent	15 Jan 2003 03:31:13 -0000	1.12
  +++ kernel.ent	15 Jan 2003 14:55:21 -0000	1.13
  @@ -2,7 +2,6 @@
   <!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">
   <!ENTITY c6-kernel-manpages-inst SYSTEM "../chapter06/kernel-manpages-inst.xml">
Unsubscribe: send email to listar at
and put 'unsubscribe lfs-book' in the subject header of the message

More information about the lfs-book mailing list