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