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

Contents of /xml/htdocs/doc/en/handbook/hb-install-initramfs.xml

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.1 - (show annotations) (download) (as text)
Mon Nov 5 05:32:27 2012 UTC (5 years, 7 months ago) by nightmorph
Branch: MAIN
CVS Tags: HEAD
File MIME type: application/xml
add hb-install-initramfs.xml snippet

1 <?xml version='1.0' encoding="UTF-8"?>
2 <!-- $Header: $ -->
3 <!DOCTYPE included SYSTEM "/dtd/guide.dtd">
4
5 <included>
6
7 <version>1</version>
8 <date>2012-09-11</date>
9
10 <section id="initramfs">
11 <title>(Optional) Building an Initramfs</title>
12 <body>
13
14 <p>
15 If you use a specific partition layout where important file system locations
16 (like <path>/usr</path> or <path>/var</path>) are on separate partitions, then
17 you will need to setup an initramfs so that this partition can be mounted before
18 it is needed.
19 </p>
20
21 <p>
22 Without an initramfs, you risk that the system will not boot up properly as the
23 tools that are responsible for mounting the file systems need information that
24 resides on those file systems. An initramfs will pull in the necessary files
25 into an archive which is used right after the kernel boots, but before the
26 control is handed over to the <c>init</c> tool. Scripts on the initramfs will
27 then make sure that the partitions are properly mounted before the system
28 continues booting.
29 </p>
30
31 <p>
32 To install an initramfs, install <c>genkernel</c> first, then have it
33 generate an initramfs for you.
34 </p>
35
36 <pre caption="Building an initramfs">
37 # <i>emerge genkernel</i>
38 # <i>genkernel --install initramfs</i>
39 </pre>
40
41 <p>
42 If you need specific support in the initramfs, such as lvm or raid, add in the
43 appropriate options to genkernel. See <c>genkernel --help</c> for more
44 information, or the next example which enables support for LVM and software raid
45 (mdadm):
46 </p>
47
48 <pre caption="Building an initramfs with support for LVM and software raid">
49 # <i>genkernel --lvm --mdadm --install initramfs</i>
50 </pre>
51
52 <p>
53 The initramfs will be stored in <path>/boot</path>. You can find the file by
54 simply listing the files starting with <path>initramfs</path>:
55 </p>
56
57 <pre caption="Checking the initramfs file name">
58 # <i>ls /boot/initramfs*</i>
59 </pre>
60
61 <p>
62 Now continue with <uri link="#kernel_modules">Kernel Modules</uri>.
63 </p>
64
65 </body>
66 </section>
67
68 </included>

  ViewVC Help
Powered by ViewVC 1.1.20