/[gentoo]/xml/htdocs/doc/en/handbook/hb-install-ia64-kernel.xml
Gentoo

Diff of /xml/htdocs/doc/en/handbook/hb-install-ia64-kernel.xml

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

Revision 1.26 Revision 1.27
2<!DOCTYPE sections SYSTEM "/dtd/book.dtd"> 2<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
3 3
4<!-- The content of this document is licensed under the CC-BY-SA license --> 4<!-- The content of this document is licensed under the CC-BY-SA license -->
5<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> 5<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
6 6
7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ia64-kernel.xml,v 1.26 2012/03/27 17:46:07 swift Exp $ --> 7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ia64-kernel.xml,v 1.27 2012/09/11 22:49:20 nightmorph Exp $ -->
8 8
9<sections> 9<sections>
10 10
11<version>16</version> 11<version>17</version>
12<date>2012-03-27</date> 12<date>2012-09-11</date>
13 13
14<section> 14<section>
15<title>Timezone</title> 15<title>Timezone</title>
16<body> 16<body>
17 17
253<pre caption="Compiling the kernel"> 253<pre caption="Compiling the kernel">
254# <i>make &amp;&amp; make modules_install</i> 254# <i>make &amp;&amp; make modules_install</i>
255</pre> 255</pre>
256 256
257<p> 257<p>
258When the kernel has finished compiling, copy the kernel image to 258When the kernel has finished compiling, copy the kernel image to <path>/</path>.
259<path>/boot</path>. Use whatever name you feel is appropriate for your kernel 259Use whatever name you feel is appropriate for your kernel choice and remember it
260choice and remember it as you will need it later on when you configure your 260as you will need it later on when you configure your bootloader. Remember to
261bootloader. Remember to replace <c><keyval id="kernel-name"/></c> with the 261replace <c>vmlinuz</c> with the name and version of your kernel.
262name and version of your kernel.
263</p> 262</p>
264 263
265<pre caption="Installing the kernel"> 264<pre caption="Installing the kernel">
266# <i>cp vmlinux.gz /boot/<keyval id="kernel-name"/></i> 265# <i>cp vmlinux.gz /boot/vmlinuz</i>
266</pre>
267
268</body>
269</subsection>
270<subsection id="initramfs">
271<title>(Optional) Building an Initramfs</title>
272<body>
273
274<p>
275If you use a specific partition layout where important file system locations
276(like <path>/usr</path> or <path>/var</path>) are on separate partitions, then
277you will need to setup an initramfs so that this partition can be mounted before
278it is needed.
279</p>
280
281<p>
282Without an initramfs, you risk that the system will not boot up properly as the
283tools that are responsible for mounting the file systems need information that
284resides on those file systems. An initramfs will pull in the necessary files
285into an archive which is used right after the kernel boots, but before the
286control is handed over to the <c>init</c> tool. Scripts on the initramfs will
287then make sure that the partitions are properly mounted before the system
288continues booting.
289</p>
290
291<p>
292To install an initramfs, install <c>genkernel</c> first, then have it
293generate an initramfs for you.
294</p>
295
296<pre caption="Building an initramfs">
297# <i>emerge genkernel</i>
298# <i>genkernel --bootdir=/. --no-mountboot --install initramfs</i>
299</pre>
300
301<p>
302If you need specific support in the initramfs, such as lvm or raid, add in the
303appropriate options to genkernel. See <c>genkernel --help</c> for more
304information, or the next example which enables support for LVM and software raid
305(mdadm):
306</p>
307
308<pre caption="Building an initramfs with support for LVM and software raid">
309# <i>genkernel --bootdir=/. --no-mountboot --lvm --mdadm --install initramfs</i>
310</pre>
311
312<p>
313The initramfs will be stored in <path>/</path>. You can find the file by simply
314listing the files starting with <path>initramfs</path>:
315</p>
316
317<pre caption="Checking the initramfs file name">
318# <i>ls /initramfs*</i>
267</pre> 319</pre>
268 320
269<p> 321<p>
270Now continue with <uri link="#kernel_modules">Kernel Modules</uri>. 322Now continue with <uri link="#kernel_modules">Kernel Modules</uri>.
271</p> 323</p>
300<pre caption="Emerging genkernel"> 352<pre caption="Emerging genkernel">
301# <i>emerge genkernel</i> 353# <i>emerge genkernel</i>
302</pre> 354</pre>
303 355
304<p> 356<p>
305Now, compile your kernel sources by running <c>genkernel all</c>. Be aware 357Now, compile your kernel sources by running <c>genkernel</c>. Be aware
306though, as <c>genkernel</c> compiles a kernel that supports almost all hardware, 358though, as <c>genkernel</c> compiles a kernel that supports almost all hardware,
307this compilation will take quite a while to finish! 359this compilation will take quite a while to finish!
308</p> 360</p>
309 361
310<note> 362<note>
311Users of LVM2 will probably want to add <c>--lvm2</c> to the genkernel 363Users of LVM2 will probably want to add <c>--lvm2</c> to the genkernel
312command-line. 364command-line.
313</note> 365</note>
314 366
315<pre caption="Running genkernel"> 367<pre caption="Running genkernel">
316# <i>genkernel all</i> 368# <i>genkernel --bootdir=/. --no-mountboot all</i>
317</pre> 369</pre>
318 370
319<p> 371<p>
320Once <c>genkernel</c> completes, a kernel, full set of modules and 372Once <c>genkernel</c> completes, a kernel, full set of modules and
321<e>initial ram disk</e> (initramfs) will be created. We will use the kernel 373<e>initial ram disk</e> (initramfs) will be created. We will use the kernel
325booting to perform hardware autodetection (just like on the Installation CD) 377booting to perform hardware autodetection (just like on the Installation CD)
326before your "real" system starts up. 378before your "real" system starts up.
327</p> 379</p>
328 380
329<pre caption="Checking the created kernel image name and initrd"> 381<pre caption="Checking the created kernel image name and initrd">
330# <i>ls /boot/kernel* /boot/initramfs*</i> 382# <i>ls /kernel* /initramfs*</i>
331</pre> 383</pre>
332 384
333</body> 385</body>
334</section> 386</section>
335<section id="kernel_modules"> 387<section id="kernel_modules">

Legend:
Removed from v.1.26  
changed lines
  Added in v.1.27

  ViewVC Help
Powered by ViewVC 1.1.20