/[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.7 Revision 1.8
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.8 2004/08/06 22:09:59 neysx Exp $ -->
2<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 3<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
3 4
4<guide link="/doc/en/xml-guide.xml"> 5<guide link="/doc/en/xml-guide.xml">
5<title>Gentoo Linux Genkernel Guide</title> 6<title>Gentoo Linux Genkernel Guide</title>
6 7
7<author title="Author"> 8<author title="Author">
8 <mail link="plasmaroo@gentoo.org">Tim Yamin</mail> 9 <mail link="plasmaroo@gentoo.org">Tim Yamin</mail>
9</author> 10</author>
10 11
11<abstract> 12<abstract>
12This guide intends to provide a reference of all the functions 13This guide intends to provide a reference of all the functions
13provided by Genkernel. 14provided by Genkernel.
14</abstract> 15</abstract>
15 16
16<license/> 17<license/>
17 18
18<version>1.0.0.1</version> 19<version>1.0.0.2</version>
19<date>April 22, 2003</date> 20<date>August 7, 2004</date>
20 21
21<chapter> 22<chapter>
22<title>Introduction</title> 23<title>Introduction</title>
23<section> 24<section>
24<title>Introduction</title> 25<title>Introduction</title>
25<body> 26<body>
26 27
27<p> 28<p>
28Genkernel is designed to allow users who are not previously used to 29Genkernel is designed to allow users who are not previously used to
29compiling a kernel to use a similar setup to that one that is used on 30compiling a kernel to use a similar setup to that one that is used on
30the Gentoo LiveCDs which auto-detects your hardware. 31the Gentoo LiveCDs which auto-detects your hardware.
31</p> 32</p>
32 33
33<p> 34<p>
34Some users may also be interested in using genkernel for hardware 35Some users may also be interested in using genkernel for hardware
62LVM2/EVMS2 partitions. Users are recommended to use a manually compiled 63LVM2/EVMS2 partitions. Users are recommended to use a manually compiled
63kernel for the time being. 64kernel for the time being.
64</p> 65</p>
65 66
66</body> 67</body>
67</section> 68</section>
68<section> 69<section>
69<title>Getting genkernel</title> 70<title>Getting genkernel</title>
70<body> 71<body>
71 72
72<p> 73<p>
73You can obtain genkernel by simply running <c>emerge genkernel</c>. Don't 74You can obtain genkernel by simply running <c>emerge genkernel</c>. Don't
74forget to use the <c>-k</c> flag for emerge if you are using binary packages, 75forget to use the <c>-k</c> flag for emerge if you are using binary packages,
75i.e. GRP. Due to the GRP packages having an older version of genkernel, the 76i.e. GRP. Due to the GRP packages having an older version of genkernel, the
76flags are different. As a result, you should consult the <uri 77flags are different. As a result, you should consult the <uri
77link="http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=1&amp;chap=9"> 78link="/doc/en/handbook/handbook-x86.xml?part=1&amp;chap=10">
78Gentoo Handbook</uri> and <path>genkernel --help</path>. 79Gentoo Handbook</uri> and <path>genkernel --help</path>.
79</p> 80</p>
80 81
81</body> 82</body>
82</section> 83</section>
83<section> 84<section>
84<title>Supported platforms</title> 85<title>Supported platforms</title>
85<body> 86<body>
86 87
87<p> 88<p>
88As of genkernel 3.0.2; the following platforms should be 89As of genkernel 3.0.2; the following platforms should be
89supported: alpha, amd64, parisc, parisc64, ppc, ppc64, sparc, sparc64, and x86. If 90supported: alpha, amd64, parisc, parisc64, ppc, ppc64, sparc, sparc64, and x86. If
90you believe that there is a bug with the support code, and not with 91you believe that there is a bug with the support code, and not with
91genkernel, please file a bug at the <uri 92genkernel, please file a bug at the <uri
92link="http://bugs.gentoo.org">Gentoo Bugzilla.</uri> 93link="http://bugs.gentoo.org">Gentoo Bugzilla.</uri>
245 246
246<ul> 247<ul>
247 <li> 248 <li>
248 <b>--no-initrdmodules</b>: This doesn't copy any modules to the initrd 249 <b>--no-initrdmodules</b>: This doesn't copy any modules to the initrd
249 which genkernel creates. 250 which genkernel creates.
250 </li> 251 </li>
251 <li> 252 <li>
252 <b>--<c>no-</c>install</b>: This installs <e>or does not install</e> your 253 <b>--<c>no-</c>install</b>: This installs <e>or does not install</e> your
253 kernel, modules, and initrd once the compilation has finished. 254 kernel, modules, and initrd once the compilation has finished.
254 </li> 255 </li>
255</ul> 256</ul>
256 257
257</body> 258</body>
258</section> 259</section>
259<section> 260<section>
260<title>Genkernel miscellaenous flags</title> 261<title>Genkernel miscellaneous flags</title>
261<body> 262<body>
262 263
263<p> 264<p>
264Genkernel also supports some miscellaneous flags which do not fit into 265Genkernel also supports some miscellaneous flags which do not fit into
265the other two categories: 266the other two categories:
266</p> 267</p>
267 268
268<ul> 269<ul>
269 <li> 270 <li>
270 <b>--arch-override=<c>someArch</c></b>: This flag can be used to override 271 <b>--arch-override=<c>someArch</c></b>: This flag can be used to override
271 what architecture genkernel thinks you're on, if the auto-detection 272 what architecture genkernel thinks you're on, if the auto-detection
272 mechanism fails (please file a bug if it does!) or if you wish to 273 mechanism fails (please file a bug if it does!) or if you wish to
273 cross-compile a kernel. 274 cross-compile a kernel.
274 </li> 275 </li>
275</ul> 276</ul>
347 kernel parameters passed to the kernel image. 348 kernel parameters passed to the kernel image.
348 </li> 349 </li>
349 <li> 350 <li>
350 Add <c>real_root=/dev/hda3</c>, for example, to the kernel parameters 351 Add <c>real_root=/dev/hda3</c>, for example, to the kernel parameters
351 passed to the kernel image if <path>/dev/hda3</path> contains your root 352 passed to the kernel image if <path>/dev/hda3</path> contains your root
352 partition. 353 partition.
353 </li> 354 </li>
354 <li> 355 <li>
355 If you are using bootsplash, add a suitable modeline such as 356 If you are using bootsplash, add a suitable modeline such as
356 <c>vga=0x317</c> to the parameters passed to the kernel and also add 357 <c>vga=0x317</c> to the parameters passed to the kernel and also add
357 <c>splash=verbose</c> or <c>splash=silent</c> depending on the verboseness 358 <c>splash=verbose</c> or <c>splash=silent</c> depending on the verboseness
358 you require from your bootsplash. 359 you require from your bootsplash.
359 </li> 360 </li>
360 <li> 361 <li>
361 Add the initrd according to how your bootloader requires it: see the <uri 362 Add the initrd according to how your bootloader requires it: see the <uri
362 link="http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=1&amp;chap=9">Gentoo 363 link="/doc/en/handbook/handbook-x86.xml?part=1&amp;chap=10">Gentoo
363 Handbook</uri> for details on how you would do it for your bootloader. 364 Handbook</uri> for details on how you would do it for your bootloader.
364 </li> 365 </li>
365</ol> 366</ol>
366 367
367</body> 368</body>
368</section> 369</section>
369</chapter> 370</chapter>
370 371
371<chapter> 372<chapter>
372<title>Porting genkernel</title> 373<title>Porting genkernel</title>
373<section> 374<section>
374<title>Introduction</title> 375<title>Introduction</title>
375<body> 376<body>
376 377
377<p> 378<p>

Legend:
Removed from v.1.7  
changed lines
  Added in v.1.8

  ViewVC Help
Powered by ViewVC 1.1.20