| 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.19 2011/05/29 00:39:18 nightmorph Exp $ --> |
2 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/kernel-upgrade.xml,v 1.20 2011/09/04 14:46:59 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"> |
| … | |
… | |
| 15 | |
15 | |
| 16 | <!-- The content of this document is licensed under the CC-BY-SA license --> |
16 | <!-- The content of this document is licensed under the CC-BY-SA license --> |
| 17 | <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
17 | <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
| 18 | <license/> |
18 | <license/> |
| 19 | |
19 | |
| 20 | <version>1</version> |
20 | <version>2</version> |
| 21 | <date>2011-05-28</date> |
21 | <date>2011-09-04</date> |
| 22 | |
22 | |
| 23 | <chapter> |
23 | <chapter> |
| 24 | <title>Introduction</title> |
24 | <title>Introduction</title> |
| 25 | <section> |
25 | <section> |
| 26 | <body> |
26 | <body> |
| … | |
… | |
| 84 | </p> |
84 | </p> |
| 85 | |
85 | |
| 86 | <pre caption="New kernel sources appearing on update list"> |
86 | <pre caption="New kernel sources appearing on update list"> |
| 87 | # <i>emerge -Dup world</i> |
87 | # <i>emerge -Dup world</i> |
| 88 | Calculating dependencies ...done! |
88 | Calculating dependencies ...done! |
| 89 | [ebuild NS ] sys-kernel/gentoo-sources-2.6.9-r2 [2.6.8-r5] |
89 | [ebuild NS ] sys-kernel/gentoo-sources-2.6.39-r3 [2.6.38-r6] |
| 90 | </pre> |
90 | </pre> |
| 91 | |
91 | |
| 92 | <note> |
92 | <note> |
| 93 | The "NS" label in the above output means that the new kernel will be installed |
93 | The "NS" label in the above output means that the new kernel will be installed |
| 94 | in a New Slot, i.e. the sources of your old kernel will be kept around, until |
94 | in a New Slot, i.e. the sources of your old kernel will be kept around, until |
| … | |
… | |
| 104 | </pre> |
104 | </pre> |
| 105 | |
105 | |
| 106 | <p> |
106 | <p> |
| 107 | The kernel sources will then be installed into a subdirectory of |
107 | The 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 |
| 109 | installed at <path>/usr/src/linux-2.6.9-gentoo-r2</path>. |
109 | installed at <path>/usr/src/linux-2.6.39-gentoo-r3</path>. |
| 110 | </p> |
110 | </p> |
| 111 | |
111 | |
| 112 | </body> |
112 | </body> |
| 113 | </section> |
113 | </section> |
| 114 | </chapter> |
114 | </chapter> |
| … | |
… | |
| 142 | <comment>(Install eselect if you don't have it)</comment> |
142 | <comment>(Install eselect if you don't have it)</comment> |
| 143 | # <i>emerge eselect</i> |
143 | # <i>emerge eselect</i> |
| 144 | <comment>(See the list of available kernels)</comment> |
144 | <comment>(See the list of available kernels)</comment> |
| 145 | # <i>eselect kernel list</i> |
145 | # <i>eselect kernel list</i> |
| 146 | Available kernel symlink targets: |
146 | Available kernel symlink targets: |
| 147 | [1] linux-2.6.9-gentoo-r1 |
147 | [1] linux-2.6.39-gentoo-r3 |
| 148 | [2] linux-2.6.9-gentoo-r2 * |
148 | [2] linux-2.6.38-gentoo-r6 * |
| 149 | <comment>(Select the correct kernel)</comment> |
149 | <comment>(Select the correct kernel)</comment> |
| 150 | # <i>eselect kernel set 1</i> |
150 | # <i>eselect kernel set 1</i> |
| 151 | <comment>(Verify the kernel was symlinked)</comment> |
151 | <comment>(Verify the kernel was symlinked)</comment> |
| 152 | # <i>eselect kernel list</i> |
152 | # <i>eselect kernel list</i> |
| 153 | [1] linux-2.6.9-gentoo-r1 * |
153 | [1] linux-2.6.39-gentoo-r3 * |
| 154 | [2] linux-2.6.9-gentoo-r2 |
154 | [2] linux-2.6.38-gentoo-r6 |
| 155 | </pre> |
155 | </pre> |
| 156 | |
156 | |
| 157 | <p> |
157 | <p> |
| 158 | If you really want to do it yourself, the following example shows you how to |
158 | If you really want to do it yourself, the following example shows you how to |
| 159 | make the link point to <path>linux-2.6.9-gentoo-r2</path>: |
159 | make the link point to <path>linux-2.6.39-gentoo-r3</path>: |
| 160 | </p> |
160 | </p> |
| 161 | |
161 | |
| 162 | <pre caption="Updating the /usr/src/linux softlink manually"> |
162 | <pre caption="Updating the /usr/src/linux softlink manually"> |
| 163 | # <i>cd /usr/src</i> |
163 | # <i>cd /usr/src</i> |
| 164 | # <i>ln -sfn linux-2.6.9-gentoo-r2 linux</i> |
164 | # <i>ln -sfn linux-2.6.39-gentoo-r3 linux</i> |
| 165 | </pre> |
165 | </pre> |
| 166 | |
166 | |
| 167 | </body> |
167 | </body> |
| 168 | </section> |
168 | </section> |
| 169 | </chapter> |
169 | </chapter> |
| … | |
… | |
| 249 | </p> |
249 | </p> |
| 250 | |
250 | |
| 251 | <pre caption="Compiling and installing the new kernel"> |
251 | <pre caption="Compiling and installing the new kernel"> |
| 252 | # <i>make && make modules_install</i> |
252 | # <i>make && make modules_install</i> |
| 253 | # <i>mount /boot</i> |
253 | # <i>mount /boot</i> |
| 254 | # <i>cp arch/i386/boot/bzImage /boot/bzImage-2.6.9-gentoo-r2</i> |
254 | # <i>cp arch/i386/boot/bzImage /boot/bzImage-2.6.39-gentoo-r3</i> |
| 255 | </pre> |
255 | </pre> |
| 256 | |
256 | |
| 257 | <p> |
257 | <p> |
| 258 | Finally, you should update your boot loader configuration, adding an entry for |
258 | Finally, you should update your boot loader configuration, adding an entry for |
| 259 | the new kernel (don't delete the old one just yet!) and unmount the |
259 | the new kernel (don't delete the old one just yet!) and unmount the |
| … | |
… | |
| 292 | |
292 | |
| 293 | <p> |
293 | <p> |
| 294 | For more information, run <c>module-rebuild</c> without any options to see a |
294 | For more information, run <c>module-rebuild</c> without any options to see a |
| 295 | list of commands that can be passed to the utility. |
295 | list of commands that can be passed to the utility. |
| 296 | </p> |
296 | </p> |
|
|
297 | |
|
|
298 | </body> |
|
|
299 | </section> |
|
|
300 | </chapter> |
|
|
301 | |
|
|
302 | <chapter> |
|
|
303 | <title>Updating your module configuration</title> |
|
|
304 | <section> |
|
|
305 | <body> |
|
|
306 | |
|
|
307 | <p> |
|
|
308 | If you have put specific module configuration entries in |
|
|
309 | <path>/etc/conf.d/modules</path>, then you might need to update the entries |
|
|
310 | accordingly. |
|
|
311 | </p> |
|
|
312 | |
|
|
313 | <pre caption="Sample /etc/conf.d/modules file"> |
|
|
314 | <comment># The following will only auto-load the ieee1394 module in 2.6.38-gentoo-r6 kernels</comment> |
|
|
315 | modules_2_6_38_gentoo_r6="ieee1394" |
|
|
316 | |
|
|
317 | <comment># To support auto-loading on all possible versions, drop any reference to versions:</comment> |
|
|
318 | modules="ohci1394" |
|
|
319 | </pre> |
| 297 | |
320 | |
| 298 | </body> |
321 | </body> |
| 299 | </section> |
322 | </section> |
| 300 | </chapter> |
323 | </chapter> |
| 301 | |
324 | |