/[gentoo]/xml/htdocs/doc/en/genkernel.xml
Gentoo

Diff of /xml/htdocs/doc/en/genkernel.xml

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

Revision 1.37 Revision 1.38
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/genkernel.xml,v 1.37 2011/09/03 07:18:26 swift Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/genkernel.xml,v 1.38 2012/06/29 19:20:43 swift Exp $ -->
3<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 3<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
4 4
5<guide> 5<guide>
6<title>Gentoo Linux Genkernel Guide</title> 6<title>Gentoo Linux Genkernel Guide</title>
7 7
8<author title="Author"> 8<author title="Author">
9 <mail link="plasmaroo@gentoo.org">Tim Yamin</mail> 9 <mail link="plasmaroo@gentoo.org">Tim Yamin</mail>
10</author> 10</author>
11<!-- folajimi@speakeasy.net --> 11<!-- folajimi@speakeasy.net -->
12<author title="Contributor"> 12<author title="Contributor">
13 Jimi Ayodele 13 Jimi Ayodele
14</author> 14</author>
15<!-- thseiler@gmail.com --> 15<!-- thseiler@gmail.com -->
16<author title="NFS Support"> 16<author title="NFS Support">
17 Thomas Seiler 17 Thomas Seiler
20 <mail link="nightmorph"/> 20 <mail link="nightmorph"/>
21</author> 21</author>
22<author title="Contributor"> 22<author title="Contributor">
23 <mail link="sping"/> 23 <mail link="sping"/>
24</author> 24</author>
25 25
26<abstract> 26<abstract>
27This guide intends to provide a reference of all the functions provided by 27This guide intends to provide a reference of all the functions provided by
28genkernel. 28genkernel.
29</abstract> 29</abstract>
30 30
31<!-- The content of this document is licensed under the CC-BY-SA license --> 31<!-- The content of this document is licensed under the CC-BY-SA license -->
32<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> 32<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
33<license/> 33<license/>
34 34
35<version>7</version> 35<version>8</version>
36<date>2011-09-03</date> 36<date>2012-06-29</date>
37 37
38<chapter> 38<chapter>
39<title>Introduction</title> 39<title>Introduction</title>
40<section> 40<section>
41<title>Rationale</title> 41<title>Rationale</title>
42<body> 42<body>
43 43
44<p> 44<p>
45For users who don't want to manually compile their kernels, genkernel is a tool 45For users who don't want to manually compile their kernels, genkernel is a tool
46to automate this process. It can help you create a kernel image akin to those 46to automate this process. It can help you create a kernel image akin to those
47available on Gentoo Installation CDs, which are designed to auto-detect the 47available on Gentoo Installation CDs, which are designed to auto-detect the
48hardware configuration of your system. Some users may also be interested in 48hardware configuration of your system. Some users may also be interested in
49using genkernel for hardware requiring initialization and a working kernel 49using genkernel for hardware requiring initialization and a working kernel
50before the system starts up. 50before the system starts up.
51</p> 51</p>
853 853
854DEFAULT gentoo 854DEFAULT gentoo
855TIMEOUT 40 855TIMEOUT 40
856PROMPT 1 856PROMPT 1
857 857
858LABEL gentoo 858LABEL gentoo
859 KERNEL kernel-X.Y.Z 859 KERNEL kernel-X.Y.Z
860 APPEND initrd=initrd-X.Y.Z root=/dev/ram0 init=/linuxrc ip=dhcp 860 APPEND initrd=initrd-X.Y.Z root=/dev/ram0 init=/linuxrc ip=dhcp
861</pre> 861</pre>
862 862
863</body> 863</body>
864</section> 864</section>
865</chapter> 865</chapter>
866 866
867<chapter> 867<chapter>
868<title>Booting a genkernel initramfs</title>
869<section>
870<title>Introduction</title>
871<body>
872
873<p>
874If you installed an initramfs with genkernel, you should definitely take a look
875at the various boot options that you can (or need to) define in your bootloader
876configuration. The most common ones are added to this guide for your reference.
877</p>
878
879</body>
880</section>
881<section>
882<title>Loading LVM or software-RAID</title>
883<body>
884
885<p>
886If your system uses LVM or software-RAID, you undoubtedly have built the
887initramfs using the <c>--lvm</c> and <c>--mdadm</c> options (didn't you).
888However, you should not forget to enable support during boot as well. This can
889be done using the <c>dolvm</c> and <c>domdadm</c> options.
890</p>
891
892<pre caption="Enabling LVM and/or MDADM support">
893<comment># Example for GRUB 1.x</comment>
894title Gentoo Linux
895root (hd0,0)
896kernel /vmlinuz root=/dev/md3 <i>dolvm domdadm</i>
897initrd /initramfs-genkernel-x86_64-3.4.3
898</pre>
899
900</body>
901</section>
902<section>
903<title>Booting in single-user mode</title>
904<body>
905
906<p>
907If for some reason boot-up fails, you might be able to rescue your system by
908booting in the single-user mode. This will only load the really necessary
909services and then drop you to a rescue (root) shell.
910</p>
911
912<pre caption="Booting in single-user mode">
913<comment># Example for GRUB 1.x</comment>
914title Gentoo Linux
915root (hd0,0)
916kernel /vmlinuz root=/dev/md3 <i>init_opts=S</i>
917initrd /initramfs-genkernel-x86_64-3.4.3
918</pre>
919
920</body>
921</section>
922</chapter>
923
924<chapter>
868<title>Conclusion</title> 925<title>Conclusion</title>
869<section> 926<section>
870<title>To Automate or not to Automate?</title> 927<title>To Automate or not to Automate?</title>
871<body> 928<body>
872 929
873<p> 930<p>
874The purpose of genkernel is to provide an (easier) alternative to the 931The purpose of genkernel is to provide an (easier) alternative to the
875time-tested approach to kernel compilation. As always, you are free to decide 932time-tested approach to kernel compilation. As always, you are free to decide
876on whether or not you want to automate the kernel compilation process. 933on whether or not you want to automate the kernel compilation process.
877</p> 934</p>
878 935
879</body> 936</body>
880</section> 937</section>
881</chapter> 938</chapter>
939
882</guide> 940</guide>

Legend:
Removed from v.1.37  
changed lines
  Added in v.1.38

  ViewVC Help
Powered by ViewVC 1.1.20