/[gentoo]/xml/htdocs/doc/en/kernel-upgrade.xml
Gentoo

Diff of /xml/htdocs/doc/en/kernel-upgrade.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.17 Revision 1.18
1<?xml version="1.0" encoding="UTF-8"?> 1<?xml version="1.0" encoding="UTF-8"?>
2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/kernel-upgrade.xml,v 1.17 2007/06/22 07:01:11 nightmorph Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/kernel-upgrade.xml,v 1.18 2008/05/20 18:40:36 swift Exp $ -->
3 3
4<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 4<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
5<guide link="/doc/en/kernel-upgrade.xml"> 5<guide link="/doc/en/kernel-upgrade.xml">
6<title>Gentoo Linux Kernel Upgrade Guide</title> 6<title>Gentoo Linux Kernel Upgrade Guide</title>
7<author title="Author"> 7<author title="Author">
53<body> 53<body>
54 54
55<p> 55<p>
56Generally, upgrading from one minor kernel release to the next won't bring any 56Generally, upgrading from one minor kernel release to the next won't bring any
57major differences. There are several reasons to upgrade the kernel. One is to 57major differences. There are several reasons to upgrade the kernel. One is to
58take advantage of a specific new feature or driver; another is to be protected 58take advantage of a specific new feature or driver; another is to be protected
59against a security vulnerability, or just to maintain an up-to-date and healthy 59against a security vulnerability, or just to maintain an up-to-date and healthy
60system. 60system.
61</p> 61</p>
62 62
63<p> 63<p>
64Even if you choose not to update to every new kernel revision, it is 64Even if you choose not to update to every new kernel revision, it is
102<pre caption="Upgrading your kernel sources"> 102<pre caption="Upgrading your kernel sources">
103# <i>emerge -u gentoo-sources</i> 103# <i>emerge -u gentoo-sources</i>
104</pre> 104</pre>
105 105
106<p> 106<p>
107The kernel sources will then be installed into a subdirectory of 107The kernel sources will then be installed into a subdirectory of
108<path>/usr/src</path>. In the above example, the new kernel sources will be 108<path>/usr/src</path>. In the above example, the new kernel sources will be
109installed at <path>/usr/src/linux-2.6.9-gentoo-r2</path>. 109installed at <path>/usr/src/linux-2.6.9-gentoo-r2</path>.
110</p> 110</p>
111 111
112</body> 112</body>
113</section> 113</section>
249# <i>mount /boot</i> 249# <i>mount /boot</i>
250# <i>cp arch/i386/boot/bzImage /boot/bzImage-2.6.9-gentoo-r2</i> 250# <i>cp arch/i386/boot/bzImage /boot/bzImage-2.6.9-gentoo-r2</i>
251</pre> 251</pre>
252 252
253<p> 253<p>
254Finally, you should update your boot loader configuration, adding an entry for 254Finally, you should update your boot loader configuration, adding an entry for
255the new kernel (don't delete the old one just yet!) and unmount the 255the new kernel (don't delete the old one just yet!) and unmount the
256<path>/boot</path> partition. Again, refer to the 256<path>/boot</path> partition. Again, refer to the
257<uri link="/doc/en/handbook/index.xml">Gentoo Handbook</uri> 257<uri link="/doc/en/handbook/index.xml">Gentoo Handbook</uri>
258for detailed instructions on this procedure. 258for detailed instructions on this procedure.
259</p> 259</p>
260 260
261</body> 261</body>
311in to resume whatever you were doing. If this is the case, then the upgrade is 311in to resume whatever you were doing. If this is the case, then the upgrade is
312complete. 312complete.
313</p> 313</p>
314 314
315<p> 315<p>
316If you made a mistake and the system fails to boot with the new kernel, reboot 316If you made a mistake and the system fails to boot with the new kernel, reboot
317the system and select the entry from the boot loader that corresponds to the 317the system and select the entry from the boot loader that corresponds to the
318last known working kernel. You can then restart from the <uri link="#install"> 318last known working kernel. You can then restart from the <uri link="#install">
319Configuring, compiling, and installing the new kernel</uri> stage -- making 319Configuring, compiling, and installing the new kernel</uri> stage -- making
320the appropriate changes to correct your mistake. In some cases, you might not 320the appropriate changes to correct your mistake. In some cases, you might not
321even need to reboot to do this (e.g. you missed a driver for an audio device, 321even need to reboot to do this (e.g. you missed a driver for an audio device,
322Ethernet adapter, etc.) 322Ethernet adapter, etc.)
323</p> 323</p>
324 324
325</body> 325</body>
326</section> 326</section>
337allows you to easily switch between running different kernels. 337allows you to easily switch between running different kernels.
338</p> 338</p>
339 339
340<p> 340<p>
341Switching between multiple kernels is as simple as leaving the kernel sources 341Switching between multiple kernels is as simple as leaving the kernel sources
342under <path>/usr/src/</path> and leaving the <path>bzImage</path> binaries on 342under <path>/usr/src/</path> and leaving the <path>bzImage</path> binaries on
343your <path>/boot</path> partition (referenced by entries in your boot loader 343your <path>/boot</path> partition (referenced by entries in your boot loader
344configuration). Every time you boot up, you will be presented with a choice of 344configuration). Every time you boot up, you will be presented with a choice of
345which kernel to boot into. 345which kernel to boot into.
346</p> 346</p>
347 347
348</body> 348</body>
349</section> 349</section>
366# <i>emerge -P gentoo-sources</i> 366# <i>emerge -P gentoo-sources</i>
367</pre> 367</pre>
368 368
369<p> 369<p>
370In most cases, temporary files used during compilation will still remain under 370In most cases, temporary files used during compilation will still remain under
371the appropriate source directory under <path>/usr/src</path>. It is safe to 371the appropriate source directory under <path>/usr/src</path>. It is safe to
372remove these using <c>rm</c>. 372remove these using <c>rm</c>.
373</p> 373</p>
374 374
375<p> 375<p>
376You can also safely delete any modules that were used by this kernel. This can 376You can also safely delete any modules that were used by this kernel. This can
378that relate to the kernel versions you are removing. Be careful not to delete 378that relate to the kernel versions you are removing. Be careful not to delete
379modules belonging to kernels that you still use! 379modules belonging to kernels that you still use!
380</p> 380</p>
381 381
382<p> 382<p>
383Finally, you can mount your <path>/boot</path> partition and remove the 383Finally, you can mount your <path>/boot</path> partition and remove the
384<path>bzImage</path> file(s) for the kernel(s) you are pruning. You should also 384<path>bzImage</path> file(s) for the kernel(s) you are pruning. You should also
385edit your boot loader configuration so that it no longer references such 385edit your boot loader configuration so that it no longer references such
386kernel(s). 386kernel(s).
387</p> 387</p>
388 388

Legend:
Removed from v.1.17  
changed lines
  Added in v.1.18

  ViewVC Help
Powered by ViewVC 1.1.20