Author: jtr
Update of /cvs/docs/release-notes/FC4 In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv26603
Modified Files: kernel.xml Log Message: Added instructions to set the kernel Makefile variable EXTRAVERSION to match the running kernel.
Index: kernel.xml =================================================================== RCS file: /cvs/docs/release-notes/FC4/kernel.xml,v retrieving revision 1.9 retrieving revision 1.10 diff -u -r1.9 -r1.10 --- kernel.xml 22 Jun 2005 18:43:07 -0000 1.9 +++ kernel.xml 19 Jul 2005 03:56:19 -0000 1.10 @@ -23,7 +23,7 @@ features. For this reason, the &FC; kernel may not be line-for-line equivalent to the so-called vanilla kernel from the <ulink - url="http://www.kernel.org%22%3E<filename>kernel.org</filename></ulink> + url="http://www.kernel.org%22%3E<filename>kernel.org</filename></ulink> web site. </para> <para> @@ -42,12 +42,12 @@ <listitem> <para> Native kernel, in both uniprocessor and <abbrev>SMP</abbrev> - varieties. + varieties. </para> <para> Configured sources are available in the - <filename>kernel-devel-<replaceable><version></replaceable>.<replaceable><arch></replaceable>.rpm</filename> - package. + <filename>kernel-devel-<replaceable><version></replaceable>.<replaceable><arch></replaceable>.rpm</filename> + package. </para> </listitem> <listitem> @@ -56,19 +56,19 @@ </para> <para> Configured sources are available in the - <filename>kernel-xen0-devel-<replaceable><version></replaceable>.<replaceable><arch></replaceable>.rpm</filename> - package. + <filename>kernel-xen0-devel-<replaceable><version></replaceable>.<replaceable><arch></replaceable>.rpm</filename> + package. </para> </listitem> </itemizedlist> <para> Sources for both kernel flavors may be installed at the same time. The files will be installed into the - <filename>/usr/src/kernels/<replaceable><version></replaceable>[-xen0]-<replaceable><arch></replaceable>/</filename> + <filename>/usr/src/kernels/<replaceable><version></replaceable>[-xen0]-<replaceable><arch></replaceable>/</filename> tree. Use the command: </para> <screen width="56"> -<command>rpm <parameter class="option">-Uvh</parameter> <filename>kernel-devel[-xen0]-<replaceable><version></replaceable>.<replaceable><arch></replaceable>.rpm</filename></command> +<command>rpm <parameter class="option">-Uvh</parameter> <filename>kernel-devel[-xen0]-<replaceable><version></replaceable>.<replaceable><arch></replaceable>.rpm</filename></command> </screen> <para> as appropriate. @@ -77,11 +77,11 @@ <title>Following Generic Textbooks</title> <para> Many of the tutorials, examples, and textbooks about Linux - kernel development assume the kernel sources are installed under - the <filename>/usr/src/linux</filename> directory. If you make a - symbolic link, as shown below, you should be able to use those - learning materials with the &FC; packages. Install the - appropriate kernel sources, as shown earlier, and then: + kernel development assume the kernel sources are installed under + the <filename>/usr/src/linux</filename> directory. If you make a + symbolic link, as shown below, you should be able to use those + learning materials with the &FC; packages. Install the + appropriate kernel sources, as shown earlier, and then: </para> <screen width="56"> <command>ln <parameter class="option">-s</parameter> <filename>/usr/src/kernels/kernel-<replaceable><all-the-rest></replaceable></filename> <filename>/usr/src/linux</filename></command> @@ -112,7 +112,7 @@ <filename>kernel-source</filename> package provided by older versions. Instead, configured sources are available as described in <xref - linkend="sn-kernel-flavors"/>. Users that require access to &FC; + linkend="sn-kernel-flavors"/>. Users that require access to &FC; original kernel sources can find them in the <filename>kernel</filename> <filename>.src.rpm</filename> package. To create an exploded source tree from this file, perform the @@ -121,12 +121,12 @@ <important> <title>These Instructions Refer to the Currently-running Kernel!</title> <para> - To simplify the following directions, we have assumed that you - want to configure the kernel sources to match your - currently-running kernel. In the steps below, you must - understand that the phrase - <replaceable><version></replaceable> refers to the kernel - version shown by this command: + To simplify the following directions, we have assumed that you + want to configure the kernel sources to match your + currently-running kernel. In the steps below, you must + understand that the phrase + <replaceable><version></replaceable> refers to the kernel + version shown by this command: </para> <screen width="56"> <command>uname <parameter class="option">-r</parameter></command> @@ -136,15 +136,15 @@ <step> <para> Obtain the - <filename>kernel-<replaceable><version></replaceable>.src.rpm</filename> - file from one of the following sources: + <filename>kernel-<replaceable><version></replaceable>.src.rpm</filename> + file from one of the following sources: </para> <itemizedlist> <listitem> <para> - The <filename>SRPMS</filename> directory on the - appropriate <wordasword>SRPMS</wordasword> - <abbrev>CD</abbrev> <filename>iso</filename> image. + The <filename>SRPMS</filename> directory on the + appropriate <wordasword>SRPMS</wordasword> + <abbrev>CD</abbrev> <filename>iso</filename> image. </para> </listitem> <listitem> @@ -165,16 +165,16 @@ <step> <para> Install - <filename>kernel-<replaceable><version></replaceable>.src.rpm</filename> - using the command: + <filename>kernel-<replaceable><version></replaceable>.src.rpm</filename> + using the command: </para> <screen width="56"> <command>rpm <parameter class="option">-Uvh</parameter> <filename>kernel-<replaceable><version></replaceable>.src.rpm</filename></command> </screen> <para> This writes the <abbrev>RPM</abbrev> contents into - <filename>/usr/src/redhat/SOURCES</filename> and - <filename>/usr/src/redhat/SPECS</filename>. + <filename>/usr/src/redhat/SOURCES</filename> and + <filename>/usr/src/redhat/SPECS</filename>. </para> </step> <step> @@ -187,12 +187,12 @@ </screen> <para> The kernel source tree will be located in the - <filename>/usr/src/redhat/BUILD/kernel-</filename><replaceable><version></replaceable> - directory. It is common practice to move the resulting - <filename>linux-</filename><replaceable><version></replaceable> - directory to the <filename>/usr/src</filename> tree; while not - strictly necessary, we suggest that you do this to match the - generally-available documentation. + <filename>/usr/src/redhat/BUILD/kernel-</filename><replaceable><version></replaceable> + directory. It is common practice to move the resulting + <filename>linux-</filename><replaceable><version></replaceable> + directory to the <filename>/usr/src</filename> tree; while not + strictly necessary, we suggest that you do this to match the + generally-available documentation. </para> <screen width="56"> <command>cd <filename>/usr/src/redhat/BUILD/kernel-<replaceable><version></replaceable></filename> <filename>/usr/src/</filename></command> @@ -205,16 +205,37 @@ <step> <para> The configurations for the specific kernels shipped in - &DISTRO; &DISTROVER; are in the <filename>configs/</filename> - directory. For example, the i686 SMP configuration file is - named - <filename>configs/kernel-<replaceable><version></replaceable>-i686-smp.config</filename>. - Issue the following command to place the desired configuration - file in the proper place for building: + &DISTRO; &DISTROVER; are in the <filename>configs/</filename> + directory. For example, the i686 SMP configuration file is + named + <filename>configs/kernel-<replaceable><version></replaceable>-i686-smp.config</filename>. + Issue the following command to place the desired configuration + file in the proper place for building: </para> <screen width="56"> <command>cp <filename>configs/<replaceable><desired-config-file></replaceable></filename> <filename>.config</filename></command> </screen> + <para> + You can also find the <filename>.config</filename> file that matches your current kernel configuration in the <filename>/lib/modules/</filename><replaceable><version></replaceable><filename>/build/.config</filename> file. + </para> + </step> + <step> + <para> + Every kernel gets a name based on its version number. + This is the value the <command>uname -r</command> command displays. + The kernel name is defined by the first four lines of the kernel <filename>Makefile</filename>. + To protect the innocent, the <filename>Makefile</filename> has been changed to generate a kernel with a different name from that of the running kernel. + Before a module will be accepted by the running kernel, that module must have been compiled for a kernel with the correct name. + </para> + <para> + Assume that <command>uname -r</command> returns the string <systemitem class="osname">2.6.11-1.234_FC4</systemitem> and correct the kernel name by editing the kernel <filename>Makefile</filename>, changing the <systemitem class="macro">EXTRAVERSION</systemitem> definition from this: + </para> + <screen width="60">EXTRAVERSION = -prep</screen> + <para>to this:</para> + <screen width="60">EXTRAVERSION = -1.234_FC4</screen> + <para> + that is, substitude everything from the final dash onward. + </para> </step> <step> <para> @@ -263,13 +284,13 @@ utilities, such as management daemons. Consequently, to remove such a kernel, perhaps after an update, you <emphasis>cannot</emphasis> simply use the <command>rpm -e - kernel-<replaceable><version></replaceable></command> + kernel-<replaceable><version></replaceable></command> command as in earlier distributions because these userspace packages depend on the kernel package. You may either list both the kernel package and its userspace dependant packages on the <command>rpm -e</command> command, or you may wish to use the <command>yum remove - kernel-<replaceable><version></replaceable></command> + kernel-<replaceable><version></replaceable></command> command instead since <command>yum</command> automatically removes dependant packages if necesssary. </para>
docs-commits@lists.fedoraproject.org