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.30 2007/09/21 23:01:43 nightmorph Exp $ --> |
2 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/genkernel.xml,v 1.31 2008/06/23 05:07:13 nightmorph Exp $ --> |
3 | <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
3 | <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
4 | |
4 | |
5 | <guide link="/doc/en/genkernel.xml" disclaimer="obsolete"> |
5 | <guide link="/doc/en/genkernel.xml" disclaimer="obsolete"> |
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 | |
|
|
12 | <!-- folajimi@speakeasy.net --> |
11 | <!-- folajimi@speakeasy.net --> |
13 | <author title="Contributor"> |
12 | <author title="Contributor"> |
14 | Jimi Ayodele |
13 | Jimi Ayodele |
15 | </author> |
14 | </author> |
16 | |
|
|
17 | <!-- thseiler@gmail.com --> |
15 | <!-- thseiler@gmail.com --> |
18 | <author title="NFS Support"> |
16 | <author title="NFS Support"> |
19 | Thomas Seiler |
17 | Thomas Seiler |
20 | </author> |
18 | </author> |
|
|
19 | <author title="Editor"> |
|
|
20 | <mail link="nightmorph"/> |
|
|
21 | </author> |
21 | |
22 | |
22 | <abstract> |
23 | <abstract> |
23 | This guide intends to provide a reference of all the functions provided by |
24 | This guide intends to provide a reference of all the functions provided by |
24 | genkernel. |
25 | genkernel. |
25 | </abstract> |
26 | </abstract> |
26 | |
27 | |
27 | <license/> |
28 | <license/> |
28 | |
29 | |
29 | <version>1.5</version> |
30 | <version>1.6</version> |
30 | <date>2007-06-20</date> |
31 | <date>2008-06-22</date> |
31 | |
32 | |
32 | <chapter> |
33 | <chapter> |
33 | <title>Introduction</title> |
34 | <title>Introduction</title> |
34 | <section> |
35 | <section> |
35 | <title>Rationale</title> |
36 | <title>Rationale</title> |
… | |
… | |
103 | and may increase compile time. Below is an illustration of a more efficient |
104 | and may increase compile time. Below is an illustration of a more efficient |
104 | approach, achieved by passing certain flags to genkernel as root: |
105 | approach, achieved by passing certain flags to genkernel as root: |
105 | </p> |
106 | </p> |
106 | |
107 | |
107 | <pre caption="Running genkernel (with flags)"> |
108 | <pre caption="Running genkernel (with flags)"> |
108 | # <i>genkernel --bootsplash --no-install --no-clean --menuconfig all</i> |
109 | # <i>genkernel --splash --no-install --no-clean --menuconfig all</i> |
109 | </pre> |
110 | </pre> |
110 | |
111 | |
111 | <p> |
112 | <p> |
112 | The above operation causes genkernel to create a bootsplash-enabled kernel |
113 | The above operation causes genkernel to create a framebuffer splash-enabled |
113 | (<c>--bootsplash</c>) that will have to be manually installed |
114 | kernel (<c>--splash</c>) that will have to be manually installed |
114 | (<c>--no-install</c>). While preparing the kernel source tree, genkernel will |
115 | (<c>--no-install</c>). While preparing the kernel source tree, genkernel will |
115 | refrain from cleaning out any preexisting object files present in the source |
116 | refrain from cleaning out any preexisting object files present in the source |
116 | tree (<c>--no-clean</c>). A menu-driven kernel configuration utility will be |
117 | tree (<c>--no-clean</c>). A menu-driven kernel configuration utility will be |
117 | displayed that allows the user to select which modules will be built for the |
118 | displayed that allows the user to select which modules will be built for the |
118 | system (<c>--menuconfig</c>). |
119 | system (<c>--menuconfig</c>). |
… | |
… | |
378 | enabling certain features on the system. |
379 | enabling certain features on the system. |
379 | </p> |
380 | </p> |
380 | |
381 | |
381 | <ul> |
382 | <ul> |
382 | <li> |
383 | <li> |
383 | <b>--<c>no-</c>bootsplash</b>: Activates <e>[or deactivates]</e> support |
|
|
384 | for <uri link="http://www.bootsplash.org/">bootsplash</uri> in the |
|
|
385 | genkernel-built initrd image. The bootsplash feature is supported on a |
|
|
386 | limited number of architectures, and a kernel that supports bootsplash is |
|
|
387 | also required. |
|
|
388 | </li> |
|
|
389 | <li> |
|
|
390 | <b>--<c>no-</c>gensplash</b>: Activates <e>[or deactivates]</e> support for |
384 | <b>--<c>no-</c>splash</b>: Activates <e>[or deactivates]</e> support for |
391 | <uri |
385 | <uri link="http://fbsplash.berlios.de/wiki/doku.php">framebuffer |
392 | link="http://dev.gentoo.org/~spock/projects/gensplash/">gensplash</uri> |
386 | splash</uri> support in the genkernel-built initrd image. To override the |
393 | support in the genkernel-built initrd image. The gensplash utility is |
387 | default theme used by fbsplash, use <b>--splash=<c>PreferredTheme</c></b> |
394 | intended to be a replacement for bootsplash, and is designed for use with |
388 | (where <c>PreferredTheme</c> is the title of one of the directories inside |
395 | 2.6.x series kernels. To override the default theme used by gensplash, use |
389 | the <path>/etc/splash/</path> directory. |
396 | <b>--gensplash=<c>PreferredTheme</c></b> (where <c>PreferredTheme</c> is |
|
|
397 | the title of one of the directories inside the <path>/etc/splash/</path> |
|
|
398 | directory. |
|
|
399 | </li> |
|
|
400 | <li> |
390 | </li> |
|
|
391 | <li> |
401 | <b>--gensplash-res=<c>PreferredResolution</c></b>: This flag allows you to |
392 | <b>--splash-res=<c>PreferredResolution</c></b>: This flag allows you to |
402 | select which splash screen resolutions will be supported in the initrd |
393 | select which splash screen resolutions will be supported in the initrd |
403 | during the start-up of the system. This is useful for two reasons: First, |
394 | during the start-up of the system. This is useful for two reasons: First, |
404 | you are able to select only the splash screen resolution(s) relevant to |
395 | you are able to select only the splash screen resolution(s) relevant to your |
405 | your system. Second, you avoid the unnecessary increase in the disk space |
396 | system. Second, you avoid the unnecessary increase in the disk space |
406 | required by initrd (since the initrd does not have to support resolutions |
397 | required by initrd (since the initrd does not have to support resolutions |
407 | that are irrelevant for your system configuration.) However, you may want |
398 | that are irrelevant for your system configuration.) However, you may want to |
408 | to omit this flag if the kernel is being compiled for an Installation CD; |
399 | omit this flag if the kernel is being compiled for an Installation CD; this |
409 | this allows gensplash support for all possible resolutions. |
400 | allows splash support for all possible resolutions. |
410 | </li> |
401 | </li> |
411 | <li> |
402 | <li> |
412 | <b>--do-keymap-auto</b>: Force keymap selection during the boot sequence. |
403 | <b>--do-keymap-auto</b>: Force keymap selection during the boot sequence. |
413 | </li> |
404 | </li> |
414 | <li> |
405 | <li> |
… | |
… | |
539 | Add <c>real_root=/dev/hda3</c>, for example, to the kernel parameters |
530 | Add <c>real_root=/dev/hda3</c>, for example, to the kernel parameters |
540 | passed to the kernel image, if <path>/dev/hda3</path> contains your root |
531 | passed to the kernel image, if <path>/dev/hda3</path> contains your root |
541 | partition. |
532 | partition. |
542 | </li> |
533 | </li> |
543 | <li> |
534 | <li> |
544 | If you are using bootsplash, add a suitable mode line such as |
535 | If you are using splash, add a suitable mode line such as <c>vga=0x317</c> |
545 | <c>vga=0x317</c> to the parameters passed to the kernel and also add |
536 | to the parameters passed to the kernel and also add <c>splash=verbose</c> or |
546 | <c>splash=verbose</c> or <c>splash=silent</c> depending on the verboseness |
537 | <c>splash=silent</c> depending on the verboseness you require from your |
547 | you require from your bootloader. |
538 | bootloader. |
548 | </li> |
539 | </li> |
549 | <li> |
540 | <li> |
550 | Add the initrd information as required by the bootloader. Consult the <uri |
541 | Add the initrd information as required by the bootloader. Consult the <uri |
551 | link="/doc/en/handbook/handbook-x86.xml?part=1&chap=10">Bootloader |
542 | link="/doc/en/handbook/handbook-x86.xml?part=1&chap=10">Bootloader |
552 | Configuration Chapter</uri> of the Gentoo Handbook for details on how to |
543 | Configuration Chapter</uri> of the Gentoo Handbook for details on how to |
… | |
… | |
568 | Passing flags to genkernel from the command line can be cumbersome, especially |
559 | Passing flags to genkernel from the command line can be cumbersome, especially |
569 | if you have about a dozen flags: |
560 | if you have about a dozen flags: |
570 | </p> |
561 | </p> |
571 | |
562 | |
572 | <pre caption="Running genkernel (overloaded with flags)"> |
563 | <pre caption="Running genkernel (overloaded with flags)"> |
573 | # <i>genkernel --debuglevel=5 --no-color --no-mrproper --clean --gensplash \ |
564 | # <i>genkernel --debuglevel=5 --no-color --no-mrproper --clean --splash \ |
574 | --kerneldir=/path/to/alternate/kernel/sources --install --menuconfig \ |
565 | --kerneldir=/path/to/alternate/kernel/sources --install --menuconfig \ |
575 | --kernel-config=/path/to/preferred/configfile --save-config --mountboot all</i> |
566 | --kernel-config=/path/to/preferred/configfile --save-config --mountboot all</i> |
576 | </pre> |
567 | </pre> |
577 | |
568 | |
578 | <p> |
569 | <p> |
… | |
… | |
640 | By choosing the appropriate options in <path>/etc/genkernel.conf</path>, you |
631 | By choosing the appropriate options in <path>/etc/genkernel.conf</path>, you |
641 | can halve the number of flags passed to genkernel from the command line: |
632 | can halve the number of flags passed to genkernel from the command line: |
642 | </p> |
633 | </p> |
643 | |
634 | |
644 | <pre caption="Running genkernel (with flags), after employing genkernel.conf"> |
635 | <pre caption="Running genkernel (with flags), after employing genkernel.conf"> |
645 | # <i>genkernel --gensplash --kerneldir=/path/to/alternate/kernel/sources \ |
636 | # <i>genkernel --splash --kerneldir=/path/to/alternate/kernel/sources \ |
646 | --kernel-config=/path/to/preferred/configfile --install all</i> |
637 | --kernel-config=/path/to/preferred/configfile --install all</i> |
647 | </pre> |
638 | </pre> |
648 | |
639 | |
649 | <p> |
640 | <p> |
650 | Identical results are obtained from both approaches, but the latter has most of |
641 | Identical results are obtained from both approaches, but the latter has most of |