Gentoo Archives: gentoo-doc-cvs

From: Xavier Neys <neysx@×××××××××××.org>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] cvs commit: kernel-upgrade.xml
Date: Sun, 08 Jan 2006 15:16:32
Message-Id: 200601081516.k08FGGEf018833@robin.gentoo.org
1 neysx 06/01/08 15:16:15
2
3 Modified: xml/htdocs/doc/en kernel-upgrade.xml
4 Log:
5 #118060 add a blurb about module-rebuild
6
7 Revision Changes Path
8 1.13 +25 -14 xml/htdocs/doc/en/kernel-upgrade.xml
9
10 file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/kernel-upgrade.xml?rev=1.13&content-type=text/x-cvsweb-markup&cvsroot=gentoo
11 plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/kernel-upgrade.xml?rev=1.13&content-type=text/plain&cvsroot=gentoo
12 diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/kernel-upgrade.xml.diff?r1=1.12&r2=1.13&cvsroot=gentoo
13
14 Index: kernel-upgrade.xml
15 ===================================================================
16 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/kernel-upgrade.xml,v
17 retrieving revision 1.12
18 retrieving revision 1.13
19 diff -u -r1.12 -r1.13
20 --- kernel-upgrade.xml 1 Jan 2006 11:51:43 -0000 1.12
21 +++ kernel-upgrade.xml 8 Jan 2006 15:16:15 -0000 1.13
22 @@ -1,5 +1,5 @@
23 <?xml version="1.0" encoding="UTF-8"?>
24 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/kernel-upgrade.xml,v 1.12 2006/01/01 11:51:43 neysx Exp $ -->
25 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/kernel-upgrade.xml,v 1.13 2006/01/08 15:16:15 neysx Exp $ -->
26
27 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
28 <guide link="/doc/en/kernel-upgrade.xml">
29 @@ -17,8 +17,8 @@
30 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
31 <license/>
32
33 -<version>0.1.8</version>
34 -<date>2005-10-11</date>
35 +<version>0.2</version>
36 +<date>2006-01-06</date>
37
38 <chapter>
39 <title>Introduction</title>
40 @@ -258,20 +258,31 @@
41
42 <p>
43 If you use any kernel modules that are not included in the kernel source tree
44 -but are provided elsewhere in portage (e.g. NVIDIA or ATI graphics drivers),
45 -then you must reinstall these after upgrading the kernel. This is as simple as
46 -re-merging the packages involved. For more information, refer to the chapter on
47 -<e>Configuring the Kernel</e> in the <uri
48 -link="/doc/en/handbook/index.xml">Gentoo Handbook</uri>.
49 -To ensure these packages will build against the source tree at
50 -<path>/usr/src/linux</path>, first uninstall the packages, then re-emerge them.
51 -If old sources for these packages are kept by portage, this uninstall/re-emerge
52 -procedure will make sure that they are rebuilt to work with the new kernel.
53 +but are provided elsewhere in Portage (e.g. ALSA drivers and NVIDIA or ATI
54 +graphics drivers), then you must reinstall these after upgrading the kernel.
55 +This is as simple as re-merging the packages involved. For more information,
56 +refer to the chapter on <e>Configuring the Kernel</e> in the <uri
57 +link="/doc/en/handbook/">Gentoo Handbook</uri>. To ensure these
58 +packages will build against the source tree at <path>/usr/src/linux</path>,
59 +first uninstall the packages, then re-emerge them. If old sources for these
60 +packages are kept by portage, this uninstall/re-emerge procedure will make sure
61 +that they are rebuilt to work with the new kernel.
62 </p>
63
64 <p>
65 We provide you with an easy tool (<c>sys-kernel/module-rebuild</c>) which
66 -rebuilds all the kernel modules you have installed using separate ebuilds.
67 +rebuilds all the kernel modules you have installed using separate ebuilds (for
68 +the <b>currently running</b> kernel, not necessarily the one in
69 +<path>/usr/src/linux</path>). Its use is straightforward. After emerging it,
70 +simply run <c>module-rebuild populate</c> to populate the database with a list
71 +of packages that will need to be rebuilt after upgrading the kernel. Once you
72 +have finished upgrading or recompiling your kernel, run <c>module-rebuild
73 +rebuild</c> to rebuild the drivers for your new kernel before you reboot.
74 +</p>
75 +
76 +<p>
77 +For more information, run <c>module-rebuild</c> without any options to see a
78 +list of commands that can be passed to the utility.
79 </p>
80
81 </body>
82 @@ -294,7 +305,7 @@
83 in to resume whatever you were doing. If this is the case, then the upgrade is
84 complete.
85 </p>
86 -
87 +
88 <p>
89 If you made a mistake and the system fails to boot with the new kernel, reboot
90 the system and select the entry from the boot loader that corresponds to the
91
92
93
94 --
95 gentoo-doc-cvs@g.o mailing list