/[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.23 Revision 1.24
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.23 2005/08/18 11:33:54 neysx Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/genkernel.xml,v 1.24 2005/09/04 23:04:25 cam Exp $ -->
3<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 3<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
4 4
5<guide link="/doc/en/genkernel.xml"> 5<guide link="/doc/en/genkernel.xml">
6<title>Gentoo Linux Genkernel Guide</title> 6<title>Gentoo Linux Genkernel Guide</title>
7 7
19 Thomas Seiler 19 Thomas Seiler
20</author> 20</author>
21 21
22<abstract> 22<abstract>
23This guide intends to provide a reference of all the functions provided by 23This guide intends to provide a reference of all the functions provided by
24genkernel. 24genkernel.
25</abstract> 25</abstract>
26 26
27<license/> 27<license/>
28 28
29<version>1.4.1</version> 29<version>1.4.1</version>
75<body> 75<body>
76 76
77<p> 77<p>
78To obtain genkernel, run <c>emerge genkernel</c> from the command line. If you 78To obtain genkernel, run <c>emerge genkernel</c> from the command line. If you
79are using the <uri 79are using the <uri
80link="/doc/en/handbook/2005.0/hb-install-about.xml#doc_chap2_sect1"> Gentoo 80link="/doc/en/handbook/2005.0/hb-install-about.xml#doc_chap2_sect1">Gentoo
81Reference Platform</uri> (GRP), remember to install binary packages by passing 81Reference Platform</uri> (GRP), remember to install binary packages by passing
82the <c>-k</c> flag to emerge. Since the GRP is bundled with an older version of 82the <c>-k</c> flag to emerge. Since the GRP is bundled with an older version of
83genkernel, the flags may be different. In any case, consult <c>genkernel 83genkernel, the flags may be different. In any case, consult <c>genkernel
84--help</c> for help on how to use the version of genkernel installed on your 84--help</c> for help on how to use the version of genkernel installed on your
85system. 85system.
86</p> 86</p>
87 87
88</body> 88</body>
89</section> 89</section>
90</chapter> 90</chapter>
91 91
92<chapter> 92<chapter>
143and their effects are enclosed within the square brackets, []. 143and their effects are enclosed within the square brackets, [].
144</p> 144</p>
145 145
146</body> 146</body>
147</section> 147</section>
148
149<section> 148<section>
150<title>Configuration Flags</title> 149<title>Configuration Flags</title>
151<body> 150<body>
152 151
153<p> 152<p>
537 <c>splash=verbose</c> or <c>splash=silent</c> depending on the verboseness 536 <c>splash=verbose</c> or <c>splash=silent</c> depending on the verboseness
538 you require from your bootloader. 537 you require from your bootloader.
539 </li> 538 </li>
540 <li> 539 <li>
541 Add the initrd information as required by the bootloader. Consult the <uri 540 Add the initrd information as required by the bootloader. Consult the <uri
542 link="/doc/en/handbook/handbook-x86.xml?part=1&amp;chap=10"> Bootloader 541 link="/doc/en/handbook/handbook-x86.xml?part=1&amp;chap=10">Bootloader
543 Configuration Chapter</uri> of the Gentoo Handbook for details on how to 542 Configuration Chapter</uri> of the Gentoo Handbook for details on how to
544 make your bootloader initrd-aware. 543 make your bootloader initrd-aware.
545 </li> 544 </li>
546</ol> 545</ol>
547 546
631By choosing the appropriate options in <path>/etc/genkernel.conf</path>, you 630By choosing the appropriate options in <path>/etc/genkernel.conf</path>, you
632can halve the number of flags passed to genkernel from the command line: 631can halve the number of flags passed to genkernel from the command line:
633</p> 632</p>
634 633
635<pre caption="Running genkernel (with flags), after employing genkernel.conf"> 634<pre caption="Running genkernel (with flags), after employing genkernel.conf">
636# <i>genkernel --gensplash --kerneldir=/path/to/alternate/kernel/sources \ 635# <i>genkernel --gensplash --kerneldir=/path/to/alternate/kernel/sources \
637--kernel-config=/path/to/preferred/configfile --install all</i> 636--kernel-config=/path/to/preferred/configfile --install all</i>
638</pre> 637</pre>
639 638
640<p> 639<p>
641Identical results are obtained from both approaches, but the latter has most of 640Identical results are obtained from both approaches, but the latter has most of
652<title>Network Booting from an Installation CD</title> 651<title>Network Booting from an Installation CD</title>
653<body> 652<body>
654 653
655<p> 654<p>
656The genkernel utility can build kernel and initrd images that provide support 655The genkernel utility can build kernel and initrd images that provide support
657for network booting, or <e>netboot</e>ing . With any luck, you should be able 656for network booting, or <e>netboot</e>ing. With any luck, you should be able
658to netboot any recent computer into the environment provided by the 657to netboot any recent computer into the environment provided by the
659Installation CD. 658Installation CD.
660</p> 659</p>
661 660
662<p> 661<p>
688</p> 687</p>
689 688
690<pre caption="Configuring a 2.6.x series kernel to support your NIC driver"> 689<pre caption="Configuring a 2.6.x series kernel to support your NIC driver">
691Device Drivers ---> 690Device Drivers --->
692 Networking Support ---> 691 Networking Support --->
693 Ethernet (10 or 100Mbit) ---> 692 Ethernet (10 or 100Mbit) --->
694 [*] Ethernet (10 or 100Mbit) 693 [*] Ethernet (10 or 100Mbit)
695 &lt;*&gt; the driver for your network card 694 &lt;*&gt; the driver for your network card
696<comment>(Be sure to select &lt;*&gt; and not &lt;M&gt;)</comment> 695<comment>(Be sure to select &lt;*&gt; and not &lt;M&gt;)</comment>
697</pre> 696</pre>
698 697
699<p> 698<p>
706</p> 705</p>
707 706
708<pre caption="Configuring a 2.6.x series kernel to support DHCP"> 707<pre caption="Configuring a 2.6.x series kernel to support DHCP">
709Device Drivers ---> 708Device Drivers --->
710 Networking Support ---> 709 Networking Support --->
711 Networking options 710 Networking options
712 [*] TCP/IP networking---> 711 [*] TCP/IP networking--->
713 [*] IP: kernel level autoconfiguration 712 [*] IP: kernel level autoconfiguration
714 [*] IP: DHCP support 713 [*] IP: DHCP support
715<comment>(These options tell the kernel to send a DHCP request at bootup.)</comment> 714<comment>(These options tell the kernel to send a DHCP request at bootup.)</comment>
716</pre> 715</pre>
721generic kernel source tree. To enable SquashFS, apply the necessary patches to 720generic kernel source tree. To enable SquashFS, apply the necessary patches to
722the generic kernel source or install <c>gentoo-sources</c>. 721the generic kernel source or install <c>gentoo-sources</c>.
723</p> 722</p>
724 723
725<pre caption="Configuring the kernel to support SquashFS"> 724<pre caption="Configuring the kernel to support SquashFS">
726File systems---> 725File systems--->
727 Miscellaneous filesystems ---> 726 Miscellaneous filesystems --->
728 [*] SquashFS 2.X - Squashed file system support 727 [*] SquashFS 2.X - Squashed file system support
729</pre> 728</pre>
730 729
731<p> 730<p>
800<title>DHCP Setup</title> 799<title>DHCP Setup</title>
801<body> 800<body>
802 801
803<p> 802<p>
804The netboot images will ask your DHCP server for an IP as well as a root-path 803The netboot images will ask your DHCP server for an IP as well as a root-path
805parameter. Both can be specified per host using a MAC address to identify 804parameter. Both can be specified per host using a MAC address to identify
806machines: 805machines:
807</p> 806</p>
808 807
809<pre caption="Sample client dhcpd.conf setup"> 808<pre caption="Sample client dhcpd.conf setup">
810... 809...
856</section> 855</section>
857</chapter> 856</chapter>
858 857
859<chapter> 858<chapter>
860<title>Conclusion</title> 859<title>Conclusion</title>
861
862<section> 860<section>
863<title>To Automate or not to Automate?</title> 861<title>To Automate or not to Automate?</title>
864<body> 862<body>
865 863
866<p> 864<p>

Legend:
Removed from v.1.23  
changed lines
  Added in v.1.24

  ViewVC Help
Powered by ViewVC 1.1.20