kernel.xml 7.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181
  1. <?xml version="1.0" encoding="ISO-8859-1"?>
  2. <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
  3. <!ENTITY % general-entities SYSTEM "../general.ent">
  4. %general-entities;
  5. ]>
  6. <sect1 id="ch-bootable-kernel" xreflabel="Linux" 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 kernel and the header files.</para>
  12. <segmentedlist>
  13. <segtitle>&buildtime;</segtitle>
  14. <segtitle>&diskspace;</segtitle>
  15. <seglistitem><seg>All default options: 4.20 SBU</seg>
  16. <seg>All default options: 181 MB</seg></seglistitem>
  17. </segmentedlist>
  18. <segmentedlist>
  19. <segtitle>Linux installation depends on</segtitle>
  20. <seglistitem><seg>Bash, Binutils, Coreutils, Findutils,
  21. GCC, Glibc, Grep, Gzip, Make, Modutils, Perl, 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: configuration, compilation, and
  27. installation. If you don't like the way this book configures the kernel, view
  28. the <filename>README</filename> file in the kernel source tree for alternative
  29. methods.</para>
  30. <para>Prepare for compilation by running the following command:</para>
  31. <screen><userinput>make mrproper</userinput></screen>
  32. <para>This ensures that the kernel tree is absolutely clean. The kernel team
  33. recommends that this command be issued prior to <emphasis>each</emphasis>
  34. kernel compilation. You shouldn't rely on the source tree being clean after
  35. un-tarring.</para>
  36. <para>Configure the kernel via a menu-driven interface:</para>
  37. <screen><userinput>make menuconfig</userinput></screen>
  38. <para><userinput>make oldconfig</userinput> may be more appropriate in some
  39. situations. See the <filename>README</filename> file for more
  40. information.</para>
  41. <para>If you wish, you may skip kernel configuration by simply copying the
  42. kernel config file, <filename>.config</filename>, from your host system
  43. (assuming it is available) to the unpacked <filename class="directory">linux-&linux-version;</filename>
  44. directory. However, we
  45. don't recommend this option. You're much better off exploring all the
  46. configuration menus and creating your own kernel configuration from
  47. scratch.</para>
  48. <para>For POSIX shared memory support, ensure that the kernel config option
  49. <quote>Virtual memory file system support</quote> is enabled. It resides within
  50. the <quote>File systems</quote> menu and is normally enabled by default.</para>
  51. <note><para>NPTL requires the kernel to be compiled with GCC 3.x, in this case
  52. &gcc-version;. Compiling with 2.95.x is known to cause failures in the glibc
  53. testsuite, so do <emphasis>not</emphasis> compile the kernel with gcc 2.95.x
  54. unless you know what you're getting yourself into.</para></note>
  55. <para>Compile the kernel image and modules:</para>
  56. <screen><userinput>make</userinput></screen>
  57. <para>If you intend to use kernel modules, you will need an
  58. <filename>/etc/modprobe.conf</filename> file. Information pertaining
  59. to modules and to kernel configuration in general may be found in the
  60. kernel documentation, which is found in the
  61. <filename>linux-&linux-version;/Documentation</filename> directory. The
  62. modules.conf man page and the kernel HOWTO at
  63. <ulink url="http://www.tldp.org/HOWTO/Kernel-HOWTO.html"/> may also be of
  64. interest to you.</para>
  65. <para>Install the modules:</para>
  66. <screen><userinput>make modules_install</userinput></screen>
  67. <para>If you have a lot of modules and very little space, you may want to
  68. consider stripping and compressing the modules. For most people such compression
  69. isn't worth the trouble, but if you're really pressed for space, then have a look at
  70. <ulink url="http://www.linux-mips.org/archives/linux-mips/2002-04/msg00031.html"/>.</para>
  71. <para>Kernel compilation has finished but more steps are required to complete
  72. the installation. Some files need to be copied to the <filename>/boot</filename>
  73. directory.</para>
  74. <para>The path to the kernel image may vary depending on the platform you're
  75. using. Issue the following command to install the kernel:</para>
  76. <screen><userinput>cp arch/i386/boot/bzImage /boot/lfskernel-&linux-version;</userinput></screen>
  77. <para><filename>System.map</filename> is a symbol file for the kernel. It maps
  78. the function entry points of every function in the kernel API (Application Programming Interface), as well as the
  79. addresses of the kernel data structures for the running kernel. Issue the
  80. following command to install the map file:</para>
  81. <screen><userinput>cp System.map /boot/System.map-&linux-version;</userinput></screen>
  82. <para><filename>.config</filename> is the kernel configuration file that was
  83. produced by the <command>make menuconfig</command> step above. It contains all
  84. the config selections for the kernel that was just compiled. It's a good idea
  85. to keep this file for future reference:</para>
  86. <screen><userinput>cp .config /boot/config-&linux-version;</userinput></screen>
  87. <para>It is important to note that the files in the kernel source directory are
  88. not owned by <emphasis>root</emphasis>. Whenever you unpack a package as user
  89. <emphasis>root</emphasis> (like we did here inside chroot), the files end up
  90. having the user and group IDs of whatever they were on the packager's computer.
  91. This is usually not a problem for any other package you install because you
  92. remove the source tree after the installation. But the Linux source tree is
  93. often kept around for a long time, so there's a chance that whatever user ID
  94. the packager used will be assigned to somebody on your machine and then that
  95. person would have write access to the kernel source.</para>
  96. <para>If you are going to keep the kernel source tree around, you may want to
  97. run <userinput>chown -R 0:0</userinput> on the
  98. <filename>linux-2.4.25</filename> directory to ensure all files are
  99. owned by user <emphasis>root</emphasis>.</para>
  100. </sect2>
  101. <sect2 id="contents-kernel" role="content"><title>Contents of Linux</title>
  102. <segmentedlist>
  103. <segtitle>Installed files</segtitle>
  104. <seglistitem><seg>the kernel, the kernel headers,
  105. and the System.map</seg></seglistitem>
  106. </segmentedlist>
  107. <variablelist><title>Short descriptions</title>
  108. <varlistentry>
  109. <term id="kernel">The <emphasis>kernel</emphasis></term>
  110. <listitem>
  111. <indexterm zone="ch-bootable-kernel kernel"><primary sortas="b-kernel">kernel</primary></indexterm>
  112. <para>is the engine of your GNU/Linux system.
  113. When switching on your box, the kernel is the first part of your operating
  114. system that gets loaded. It detects and initializes all the components of your
  115. computer's hardware, then makes these components available as a tree of files
  116. to the software, and turns a single CPU into a multi-tasking machine capable
  117. of running scores of programs seemingly at the same time.</para>
  118. </listitem>
  119. </varlistentry>
  120. <varlistentry>
  121. <term id="kernel-headers">The <emphasis>kernel headers</emphasis></term>
  122. <listitem>
  123. <indexterm zone="ch-bootable-kernel kernel-headers"><primary sortas="e-kernel-headers">kernel headers</primary></indexterm>
  124. <para>define the interface to the
  125. services that the kernel provides. The headers in your system's
  126. <filename>include</filename> directory should <emphasis>always</emphasis> be
  127. the ones against which Glibc was compiled and should therefore
  128. <emphasis>not</emphasis> be replaced when upgrading the kernel.</para>
  129. </listitem>
  130. </varlistentry>
  131. <varlistentry>
  132. <term id="System.map"><filename>System.map</filename></term>
  133. <listitem>
  134. <indexterm zone="ch-bootable-kernel System.map"><primary sortas="e-/boot/System.map">/boot/System.map</primary></indexterm>
  135. <para>is a list of addresses and symbols. It maps the entry points and addresses
  136. of all the functions and data structures in the kernel.</para>
  137. </listitem>
  138. </varlistentry>
  139. </variablelist>
  140. </sect2>
  141. </sect1>