kernel.xml 9.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219
  1. <?xml version="1.0" encoding="ISO-8859-1"?>
  2. <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
  3. <!ENTITY % general-entities SYSTEM "../general.ent">
  4. %general-entities;
  5. ]>
  6. <sect1 id="ch-bootable-kernel" role="wrap">
  7. <title>Linux-&linux-version;</title>
  8. <?dbhtml filename="kernel.html"?>
  9. <indexterm zone="ch-bootable-kernel"><primary sortas="a-Linux">Linux</primary></indexterm>
  10. <sect2 role="package"><title/>
  11. <para>The Linux package contains the Linux kernel.</para>
  12. <segmentedlist>
  13. <segtitle>&buildtime;</segtitle>
  14. <segtitle>&diskspace;</segtitle>
  15. <seglistitem><seg>4.20 SBU</seg>
  16. <seg>181 MB</seg></seglistitem>
  17. </segmentedlist>
  18. <segmentedlist>
  19. <segtitle>&dependencies;</segtitle>
  20. <seglistitem><seg>Bash, Binutils, Coreutils, Findutils,
  21. GCC, Glibc, Grep, Gzip, Make, Modutils, Perl, and Sed</seg></seglistitem>
  22. </segmentedlist>
  23. </sect2>
  24. <sect2 role="installation">
  25. <title>Installation of the kernel</title>
  26. <para>Building the kernel involves a few steps&mdash;configuration, compilation,
  27. and installation. Read the <filename>README</filename> file in the kernel source
  28. tree for alternative methods to the way this book configures the kernel.</para>
  29. <para>Prepare for compilation by running the following command:</para>
  30. <screen><userinput>make mrproper</userinput></screen>
  31. <para>This ensures that the kernel tree is absolutely clean. The
  32. kernel team recommends that this command be issued prior to each
  33. kernel compilation. Do not rely on the source tree being clean after
  34. un-tarring.</para>
  35. <para>If, in <xref linkend="ch-scripts-console" role=","/> it was decided to
  36. compile the keymap into the kernel, issue the command below:</para>
  37. <screen><userinput>loadkeys -m /usr/share/kbd/keymaps/<replaceable>[path to keymap]</replaceable> &gt; \
  38. drivers/char/defkeymap.c</userinput></screen>
  39. <para>For example, if using a Dutch keyboard, use
  40. <filename>/usr/share/kbd/keymaps/i386/qwerty/nl.map.gz</filename>.</para>
  41. <para>Configure the kernel via a menu-driven interface. BLFS has some
  42. information regarding particular kernel configuration requirements of
  43. packages outside of LFS at <ulink
  44. url="&blfs-root;view/svn/longindex.html#kernel-config-index"/>:</para>
  45. <screen><userinput>make menuconfig</userinput></screen>
  46. <para>Alternatively, <command>make oldconfig</command> may be more appropriate in some
  47. situations. See the <filename>README</filename> file for more
  48. information.</para>
  49. <note><para>When configuring the kernel, be sure to enable the <quote>Support
  50. for hot-pluggable devices</quote> option under the <quote>General Setup</quote>
  51. menu. This enables hotplug events that are used by <command>udev</command> to
  52. populate the <filename class="directory">/dev</filename> directory with device
  53. nodes. Likewise, enable the <quote>Virtual memory file system support</quote>
  54. option under the <quote>File systems</quote>/<quote>Pseudo filesystems</quote>
  55. menu. This enables the virtual filesystem that the <filename
  56. class="directory">/dev</filename> directory will be mounted on.</para></note>
  57. <para>If desired, skip kernel configuration by copying the kernel
  58. config file, <filename>.config</filename>, from the host system
  59. (assuming it is available) to the unpacked <filename
  60. class="directory">linux-&linux-version;</filename> directory. However,
  61. we do not recommend this option. It is often better to explore all the
  62. configuration menus and create the kernel configuration from
  63. scratch.</para>
  64. <note><para>NPTL requires the kernel to be compiled with GCC 3.x, in
  65. this case &gcc-version;. Compiling with 2.95.x is known to cause failures in
  66. the glibc test suite, so it is not recommended to compile the kernel
  67. with gcc 2.95.x.</para></note>
  68. <para>Compile the kernel image and modules:</para>
  69. <screen><userinput>make</userinput></screen>
  70. <para>If using kernel modules, an <filename>/etc/modprobe.conf</filename> file
  71. may be needed. Information pertaining to modules and kernel configuration is
  72. located in the kernel documentation in the <filename
  73. class="directory">linux-&linux-version;/Documentation</filename> directory.
  74. Also, <filename>modprobe.conf(5)</filename> may be of interest.</para>
  75. <para>Be very careful when reading other documentation relating to kernel
  76. modules because it usually applies to 2.4.x kernels only. As far as we know,
  77. kernel configuration issues specific to Hotplug and Udev are not documented.
  78. The problem is that Udev will create a device node only if Hotplug or a
  79. user-written script inserts the corresponding module into the kernel, and not
  80. all modules are detectable by Hotplug. Note that statements like the one below
  81. in the <filename>/etc/modprobe.conf</filename> file do not work with
  82. Udev:</para>
  83. <para><screen>alias char-major-XXX some-module</screen></para>
  84. <para>Because of the complications with Hotplug, Udev, and modules, we
  85. strongly recommend starting with a completely non-modular kernel
  86. configuration, especially if this is the first time using Udev.</para>
  87. <para>Install the modules, if the kernel configuration uses them:</para>
  88. <screen><userinput>make modules_install</userinput></screen>
  89. <para>After kernel compilation is complete, additional steps are
  90. required to complete the installation. Some files need to be copied to
  91. the <filename class="directory">/boot</filename> directory.</para>
  92. <para>The path to the kernel image may vary depending on the platform
  93. being used. The following command assumes an x86 architecture:</para>
  94. <screen><userinput>cp arch/i386/boot/bzImage /boot/lfskernel-&linux-version;</userinput></screen>
  95. <para><filename>System.map</filename> is a symbol file for the kernel.
  96. It maps the function entry points of every function in the kernel API,
  97. as well as the addresses of the kernel data structures for the running
  98. kernel. Issue the following command to install the map file:</para>
  99. <screen><userinput>cp System.map /boot/System.map-&linux-version;</userinput></screen>
  100. <para>The kernel configuration file <filename>.config</filename>
  101. produced by the <command>make menuconfig</command> step
  102. above contains all the configuration selections for the kernel
  103. that was just compiled. It is a good idea to keep this file for future
  104. reference:</para>
  105. <screen><userinput>cp .config /boot/config-&linux-version;</userinput></screen>
  106. <para>It is important to note that the files in the kernel source
  107. directory are not owned by <emphasis>root</emphasis>. Whenever a
  108. package is unpacked as user <emphasis>root</emphasis> (like we did
  109. inside chroot), the files have the user and group IDs of whatever
  110. they were on the packager's computer. This is usually not a problem
  111. for any other package to be installed because the source tree is
  112. removed after the installation. However, the Linux source tree is
  113. often retained for a long time. Because of this, there is a chance
  114. that whatever user ID the packager used will be assigned to somebody
  115. on the machine. That person would then have write access to the kernel
  116. source.</para>
  117. <para>If the kernel source tree is going to be retained, run
  118. <command>chown -R 0:0</command> on the <filename
  119. class="directory">linux-&linux-version;</filename> directory to ensure
  120. all files are owned by user <emphasis>root</emphasis>.</para>
  121. <warning><para>Some kernel documentation recommends creating a symlink from
  122. <filename class="symlink">/usr/src/linux</filename> pointing to the kernel
  123. source directory. This is specific to kernels prior to the 2.6 series and
  124. <emphasis>must not</emphasis> be created on an LFS system as it can cause
  125. problems for packages you may wish to build once your base LFS system is
  126. complete.</para>
  127. <para>Also, the headers in the system's
  128. <filename class="directory">include</filename> directory should
  129. <emphasis>always</emphasis> be the ones against which Glibc was compiled,
  130. that is, the ones from the Linux-Libc-Headers package, and therefore, should
  131. <emphasis>never</emphasis> be replaced by the kernel headers.</para></warning>
  132. </sect2>
  133. <sect2 id="contents-kernel" role="content"><title>Contents of Linux</title>
  134. <segmentedlist>
  135. <segtitle>Installed files</segtitle>
  136. <seglistitem><seg>config-&linux-version;, lfskernel-&linux-version;,
  137. and System.map-&linux-version;</seg></seglistitem>
  138. </segmentedlist>
  139. <variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
  140. <?dbfo list-presentation="list"?>
  141. <?dbhtml list-presentation="table"?>
  142. <varlistentry id="config">
  143. <term><filename>config-&linux-version;</filename></term>
  144. <listitem>
  145. <para>Contains all the configuration selections for the kernel</para>
  146. <indexterm zone="ch-bootable-kernel config"><primary sortas="e-/boot/config">/boot/config-&linux-version;</primary></indexterm>
  147. </listitem>
  148. </varlistentry>
  149. <varlistentry id="lfskernel">
  150. <term><filename>lfskernel-&linux-version;</filename></term>
  151. <listitem>
  152. <para>The engine of the Linux system. When turning on the computer,
  153. the kernel is the first part of the operating system that gets loaded.
  154. It detects and initializes all components of the computer's hardware,
  155. then makes these components available as a tree of files to the
  156. software and turns a single CPU into a multitasking machine capable
  157. of running scores of programs seemingly at the same time</para>
  158. <indexterm zone="ch-bootable-kernel lfskernel"><primary sortas="b-lfskernel">lfskernel-&linux-version;</primary></indexterm>
  159. </listitem>
  160. </varlistentry>
  161. <varlistentry id="System.map">
  162. <term><filename>System.map-&linux-version;</filename></term>
  163. <listitem>
  164. <para>A list of addresses and symbols; it maps the entry points and
  165. addresses of all the functions and data structures in the
  166. kernel</para>
  167. <indexterm zone="ch-bootable-kernel System.map"><primary sortas="e-/boot/System.map">/boot/System.map-&linux-version;</primary></indexterm>
  168. </listitem>
  169. </varlistentry>
  170. </variablelist>
  171. </sect2>
  172. </sect1>