| 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.31 2008/06/23 05:07:13 nightmorph Exp $ --> |
2 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/genkernel.xml,v 1.32 2010/12/06 12:00:32 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 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> |
| … | |
… | |
| 17 | Thomas Seiler |
17 | Thomas Seiler |
| 18 | </author> |
18 | </author> |
| 19 | <author title="Editor"> |
19 | <author title="Editor"> |
| 20 | <mail link="nightmorph"/> |
20 | <mail link="nightmorph"/> |
| 21 | </author> |
21 | </author> |
|
|
22 | <author title="Contributor"> |
|
|
23 | <mail link="sping"/> |
|
|
24 | </author> |
| 22 | |
25 | |
| 23 | <abstract> |
26 | <abstract> |
| 24 | This guide intends to provide a reference of all the functions provided by |
27 | This guide intends to provide a reference of all the functions provided by |
| 25 | genkernel. |
28 | genkernel. |
| 26 | </abstract> |
29 | </abstract> |
| 27 | |
30 | |
|
|
31 | <!-- The content of this document is licensed under the CC-BY-SA license --> |
|
|
32 | <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
| 28 | <license/> |
33 | <license/> |
| 29 | |
34 | |
| 30 | <version>1.6</version> |
35 | <version>2</version> |
| 31 | <date>2008-06-22</date> |
36 | <date>2010-12-06</date> |
| 32 | |
37 | |
| 33 | <chapter> |
38 | <chapter> |
| 34 | <title>Introduction</title> |
39 | <title>Introduction</title> |
| 35 | <section> |
40 | <section> |
| 36 | <title>Rationale</title> |
41 | <title>Rationale</title> |
| … | |
… | |
| 75 | <title>Installing genkernel</title> |
80 | <title>Installing genkernel</title> |
| 76 | <body> |
81 | <body> |
| 77 | |
82 | |
| 78 | <p> |
83 | <p> |
| 79 | To obtain genkernel, run <c>emerge genkernel</c> from the command line. If you |
84 | To obtain genkernel, run <c>emerge genkernel</c> from the command line. If you |
| 80 | are using the <uri |
85 | are using the <uri link="/doc/en/handbook/2008/hb-install-about.xml">Gentoo |
| 81 | link="/doc/en/handbook/2005.1/hb-install-about.xml#doc_chap2_sect1">Gentoo |
|
|
| 82 | Reference Platform</uri> (GRP), remember to install binary packages by passing |
86 | Reference Platform</uri> (GRP), remember to install binary packages by passing |
| 83 | the <c>-k</c> flag to emerge. Since the GRP is bundled with an older version of |
87 | the <c>-k</c> flag to emerge. Since the GRP is bundled with an older version |
| 84 | genkernel, the flags may be different. In any case, consult <c>genkernel |
88 | of genkernel, the flags may be different. In any case, consult <c>genkernel |
| 85 | --help</c> for help on how to use the version of genkernel installed on your |
89 | --help</c> for help on how to use the version of genkernel installed on your |
| 86 | system. |
90 | system. |
| 87 | </p> |
91 | </p> |
| 88 | |
92 | |
| 89 | </body> |
93 | </body> |
| … | |
… | |
| 257 | install</c> command, which installs your new kernel image, configuration |
261 | install</c> command, which installs your new kernel image, configuration |
| 258 | file, initrd image and system map onto your mounted boot partition. Any |
262 | file, initrd image and system map onto your mounted boot partition. Any |
| 259 | compiled modules will be installed as well. |
263 | compiled modules will be installed as well. |
| 260 | </li> |
264 | </li> |
| 261 | <li> |
265 | <li> |
| 262 | <b>--<c>no-</c>initrdmodules</b>: Refrains from copying any modules to the |
266 | <b>--<c>no-</c>ramdisk-modules</b>: Refrains from copying any modules to the |
| 263 | genkernel-created initrd image. This flag is an exception to the rule about |
267 | genkernel-created initrd image. This flag is an exception to the rule about |
| 264 | the <c>no-</c> prefix; omission of this prefix creates an invalid genkernel |
268 | the <c>no-</c> prefix; omission of this prefix creates an invalid genkernel |
| 265 | flag. |
269 | flag. |
|
|
270 | </li> |
|
|
271 | <li> |
|
|
272 | <b>--all-ramdisk-modules</b>: Copies all available modules to the |
|
|
273 | genkernel-created initrd image. |
| 266 | </li> |
274 | </li> |
| 267 | <li> |
275 | <li> |
| 268 | <b>--genzimage</b>: Creates the initrd image, prior to the kernel image. |
276 | <b>--genzimage</b>: Creates the initrd image, prior to the kernel image. |
| 269 | (This hack currently applies only to PPC Pegasos systems.) |
277 | (This hack currently applies only to PPC Pegasos systems.) |
| 270 | </li> |
278 | </li> |
| … | |
… | |
| 346 | amount of information reported, as well as the presentation of said data. |
354 | amount of information reported, as well as the presentation of said data. |
| 347 | </p> |
355 | </p> |
| 348 | |
356 | |
| 349 | <ul> |
357 | <ul> |
| 350 | <li> |
358 | <li> |
| 351 | <b>--debuglevel=<c>verblevel</c></b>: Controls the level of verbosity for |
359 | <b>--loglevel=<c>verblevel</c></b>: Controls the level of verbosity for |
| 352 | information provided by genkernel. The variable <c>verblevel</c> is an |
360 | information provided by genkernel. The variable <c>verblevel</c> is an |
| 353 | integer between 0 and 5. The level '0' represents minimal output, while '5' |
361 | integer between 0 and 5. The level '0' represents minimal output, while '5' |
| 354 | provides as much information as possible about genkernel's activities |
362 | provides as much information as possible about genkernel's activities |
| 355 | during the kernel compilation process. |
363 | during the kernel compilation process. |
| 356 | </li> |
364 | </li> |
| 357 | <li> |
365 | <li> |
| 358 | <b>--debugfile=<path>/path/to/outputfile</path></b>: Ignores the value set |
366 | <b>--logfile=<path>/path/to/outputfile</path></b>: Ignores the value set |
| 359 | by the <c>--debuglevel</c> argument, and sends <b>all</b> debugging data |
367 | by the <c>--loglevel</c> argument, and sends <b>all</b> debugging data |
| 360 | produced by genkernel to the specified output file, which is located at |
368 | produced by genkernel to the specified output file, which is located at |
| 361 | <path>/var/log/genkernel.log</path> by default. |
369 | <path>/var/log/genkernel.log</path> by default. |
| 362 | </li> |
370 | </li> |
| 363 | <li> |
371 | <li> |
| 364 | <b>--no-color</b>: Activates <e>[or deactivates]</e> colored output of |
372 | <b>--no-color</b>: Activates <e>[or deactivates]</e> colored output of |
| … | |
… | |
| 559 | Passing flags to genkernel from the command line can be cumbersome, especially |
567 | Passing flags to genkernel from the command line can be cumbersome, especially |
| 560 | if you have about a dozen flags: |
568 | if you have about a dozen flags: |
| 561 | </p> |
569 | </p> |
| 562 | |
570 | |
| 563 | <pre caption="Running genkernel (overloaded with flags)"> |
571 | <pre caption="Running genkernel (overloaded with flags)"> |
| 564 | # <i>genkernel --debuglevel=5 --no-color --no-mrproper --clean --splash \ |
572 | # <i>genkernel --loglevel=5 --no-color --no-mrproper --clean --splash \ |
| 565 | --kerneldir=/path/to/alternate/kernel/sources --install --menuconfig \ |
573 | --kerneldir=/path/to/alternate/kernel/sources --install --menuconfig \ |
| 566 | --kernel-config=/path/to/preferred/configfile --save-config --mountboot all</i> |
574 | --kernel-config=/path/to/preferred/configfile --save-config --mountboot all</i> |
| 567 | </pre> |
575 | </pre> |
| 568 | |
576 | |
| 569 | <p> |
577 | <p> |
| … | |
… | |
| 617 | <b>USECOLOR=<c>[yes|no]</c></b>: Setting this option to 'yes' is equivalent |
625 | <b>USECOLOR=<c>[yes|no]</c></b>: Setting this option to 'yes' is equivalent |
| 618 | to the <c>--color</c> flag, which colors genkernel's output to ease |
626 | to the <c>--color</c> flag, which colors genkernel's output to ease |
| 619 | debugging (when needed.) |
627 | debugging (when needed.) |
| 620 | </li> |
628 | </li> |
| 621 | <li> |
629 | <li> |
| 622 | <b>DEBUGLEVEL=<c>[0|1|2|3|4|5]</c></b>: This option is for adjusting the |
630 | <b>LOGLEVEL=<c>[0|1|2|3|4|5]</c></b>: This option is for adjusting the |
| 623 | verbosity of the output produced by genkernel — setting this option to |
631 | verbosity of the output produced by genkernel — setting this option to |
| 624 | '0' with <c>--debuglevel=0</c> will suppress all output produced by |
632 | '0' with <c>--loglevel=0</c> will suppress all output produced by |
| 625 | genkernel; setting this option to '5' with <c>--debuglevel=5</c> provides |
633 | genkernel; setting this option to '5' with <c>--loglevel=5</c> provides |
| 626 | the user with all output produced by genkernel. |
634 | the user with all output produced by genkernel. |
| 627 | </li> |
635 | </li> |
| 628 | </ul> |
636 | </ul> |
| 629 | |
637 | |
| 630 | <p> |
638 | <p> |
| … | |
… | |
| 869 | </p> |
877 | </p> |
| 870 | |
878 | |
| 871 | </body> |
879 | </body> |
| 872 | </section> |
880 | </section> |
| 873 | </chapter> |
881 | </chapter> |
| 874 | |
|
|
| 875 | </guide> |
882 | </guide> |
Parent Directory
| 
Revision Log
| 
Patch