/[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.31 Revision 1.32
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>
24This 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
25genkernel. 28genkernel.
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>
79To obtain genkernel, run <c>emerge genkernel</c> from the command line. If you 84To obtain genkernel, run <c>emerge genkernel</c> from the command line. If you
80are using the <uri 85are using the <uri link="/doc/en/handbook/2008/hb-install-about.xml">Gentoo
81link="/doc/en/handbook/2005.1/hb-install-about.xml#doc_chap2_sect1">Gentoo
82Reference Platform</uri> (GRP), remember to install binary packages by passing 86Reference Platform</uri> (GRP), remember to install binary packages by passing
83the <c>-k</c> flag to emerge. Since the GRP is bundled with an older version of 87the <c>-k</c> flag to emerge. Since the GRP is bundled with an older version
84genkernel, the flags may be different. In any case, consult <c>genkernel 88of 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
86system. 90system.
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>
346amount of information reported, as well as the presentation of said data. 354amount 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
559Passing flags to genkernel from the command line can be cumbersome, especially 567Passing flags to genkernel from the command line can be cumbersome, especially
560if you have about a dozen flags: 568if 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 &mdash; setting this option to 631 verbosity of the output produced by genkernel &mdash; 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>

Legend:
Removed from v.1.31  
changed lines
  Added in v.1.32

  ViewVC Help
Powered by ViewVC 1.1.20