nightmorph 12/11/05 05:32:27 Added: hb-install-initramfs.xml Log: add hb-install-initramfs.xml snippet
Revision Changes Path 1.1 xml/htdocs/doc/en/handbook/hb-install-initramfs.xml file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-initramfs.xml?rev=1.1&view=markup plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-initramfs.xml?rev=1.1&content-type=text/plain Index: hb-install-initramfs.xml =================================================================== <?xml version='1.0' encoding="UTF-8"?> <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-initramfs.xml,v 1.1 2012/11/05 05:32:27 nightmorph Exp $ --> <!DOCTYPE included SYSTEM "/dtd/guide.dtd"> <included> <version>1</version> <date>2012-09-11</date> <section id="initramfs"> <title>(Optional) Building an Initramfs</title> <body> <p> If you use a specific partition layout where important file system locations (like <path>/usr</path> or <path>/var</path>) are on separate partitions, then you will need to setup an initramfs so that this partition can be mounted before it is needed. </p> <p> Without an initramfs, you risk that the system will not boot up properly as the tools that are responsible for mounting the file systems need information that resides on those file systems. An initramfs will pull in the necessary files into an archive which is used right after the kernel boots, but before the control is handed over to the <c>init</c> tool. Scripts on the initramfs will then make sure that the partitions are properly mounted before the system continues booting. </p> <p> To install an initramfs, install <c>genkernel</c> first, then have it generate an initramfs for you. </p> <pre caption="Building an initramfs"> # <i>emerge genkernel</i> # <i>genkernel --install initramfs</i> </pre> <p> If you need specific support in the initramfs, such as lvm or raid, add in the appropriate options to genkernel. See <c>genkernel --help</c> for more information, or the next example which enables support for LVM and software raid (mdadm): </p> <pre caption="Building an initramfs with support for LVM and software raid"> # <i>genkernel --lvm --mdadm --install initramfs</i> </pre> <p> The initramfs will be stored in <path>/boot</path>. You can find the file by simply listing the files starting with <path>initramfs</path>: </p> <pre caption="Checking the initramfs file name"> # <i>ls /boot/initramfs*</i> </pre> <p> Now continue with <uri link="#kernel_modules">Kernel Modules</uri>. </p> </body> </section> </included>
