/[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.15 Revision 1.16
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.15 2005/06/11 21:07:38 fox2mike Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/genkernel.xml,v 1.16 2005/06/26 23:50:57 vanquirius 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
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 11
12<abstract> 12<abstract>
13This guide intends to provide a reference of all the functions 13This guide intends to provide a reference of all the functions
14provided by genkernel. 14provided by genkernel.
15</abstract> 15</abstract>
16 16
17<license/> 17<license/>
18 18
19<version>1.1.2.2</version> 19<version>1.1.2.3</version>
20<date>2005-06-11</date> 20<date>2005-06-26</date>
21 21
22<chapter> 22<chapter>
23<title>Introduction</title> 23<title>Introduction</title>
24<section> 24<section>
25<title>Introduction</title> 25<title>Introduction</title>
26<body> 26<body>
27 27
28<p> 28<p>
29Genkernel is designed to allow users who are not previously used to 29Genkernel is designed to allow users who are not previously used to
30compiling 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
31the Gentoo LiveCDs which auto-detects your hardware. 31the Gentoo Installation CDs which auto-detects your hardware.
32</p> 32</p>
33 33
34<p> 34<p>
35Some users may also be interested in using genkernel for hardware 35Some users may also be interested in using genkernel for hardware
36which requires initialization and a working kernel before it can be 36which requires initialization and a working kernel before it can be
37booted. Because genkernel also automatically compiles your kernel modules, 37booted. Because genkernel also automatically compiles your kernel modules,
38thus allowing hardware which needs to be loaded with module parameters 38thus allowing hardware which needs to be loaded with module parameters
39to be used. 39to be used.
40</p> 40</p>
41 41
42</body> 42</body>
43</section> 43</section>
44<section> 44<section>
45<title>Is genkernel for me?</title> 45<title>Is genkernel for me?</title>
46<body> 46<body>
186<title>Genkernel kernel flags</title> 186<title>Genkernel kernel flags</title>
187<body> 187<body>
188 188
189<p> 189<p>
190Genkernel supports the following flags, some of which have 190Genkernel supports the following flags, some of which have
191<c>--<b>no-</b>option</c> equivalents that influence 191<c>--<b>no-</b>option</c> equivalents that influence
192kernel compilation: 192kernel compilation:
193</p> 193</p>
194 194
195<ul> 195<ul>
196 <li> 196 <li>
197 <b>--callback="echo Hello"</b>: This routine calls the specified 197 <b>--callback="echo Hello"</b>: This routine calls the specified
198 arguments after the kernel and the relevant modules have been built; but 198 arguments after the kernel and the relevant modules have been built; but
199 before the initrd has been built. This is useful where you might want 199 before the initrd has been built. This is useful where you might want
200 external modules installed to the initrd by emerging the relevant item 200 external modules installed to the initrd by emerging the relevant item
201 using the callback and then redefinining a genkernel module group. 201 using the callback and then redefining a genkernel module group.
202 </li> 202 </li>
203 <li> 203 <li>
204 <b>--<c>no-</c>clean</b>: This runs <e>or does not 204 <b>--<c>no-</c>clean</b>: This runs <e>or does not
205 run</e> <c>make clean</c> before compiling your kernel. This 205 run</e> <c>make clean</c> before compiling your kernel. This
206 causes all object files and dependencies to be removed. 206 causes all object files and dependencies to be removed.
207 </li> 207 </li>
208 <li> 208 <li>
209 <b>--<c>no-</c>mrproper</b>: This runs <e>or does not 209 <b>--<c>no-</c>mrproper</b>: This runs <e>or does not
210 run</e> <c>make mrproper</c> before compiling your kernel. This 210 run</e> <c>make mrproper</c> before compiling your kernel. This
211 causes all object files, dependencies <b>and your 211 causes all object files, dependencies <b>and your
212 configuration</b> to be removed. 212 configuration</b> to be removed.
213 </li> 213 </li>
214</ul> 214</ul>
215 215
216<ul> 216<ul>
217 <li> 217 <li>
218 <b>--kerneldir=<path>/path/to/sources</path></b>: This specifies an 218 <b>--kerneldir=<path>/path/to/sources</path></b>: This specifies an
219 alternative kernel source location, instead of the default location of 219 alternative kernel source location, instead of the default location of
220 <path>/usr/src/linux</path>. 220 <path>/usr/src/linux</path>.
221 </li> 221 </li>
222 <li> 222 <li>
223 <b>--kernel-config=<path>/path/to/config-file</path></b>: This specifies an 223 <b>--kernel-config=<path>/path/to/config-file</path></b>: This specifies an
224 alternative kernel configuration which would be used; rather than the 224 alternative kernel configuration which would be used; rather than the
225 inpersistant <path>/path/to/sources/.config</path> which is used by 225 non-persistent <path>/path/to/sources/.config</path> which is used by
226 default. 226 default.
227 </li> 227 </li>
228</ul> 228</ul>
229 229
230<ul> 230<ul>
231 <li> 231 <li>
232 <b>--<c>no-</c>bootsplash</b>: This adds <e>or does not add</e> bootsplash 232 <b>--<c>no-</c>bootsplash</b>: This adds <e>or does not add</e> bootsplash
233 support in the initrd which genkernel builds. Not all architectures 233 support in the initrd which genkernel builds. Not all architectures
234 currently support bootsplash, and a kernel that supports bootsplash is 234 currently support bootsplash, and a kernel that supports bootsplash is
235 also required. 235 also required.
236 </li> 236 </li>
237 <li> 237 <li>
238 <b>--<c>no-</c>menuconfig</b>: This runs <e>or does not run</e> the kernel 238 <b>--<c>no-</c>menuconfig</b>: This runs <e>or does not run</e> the kernel
239 menu-based configurator before building your kernel, after <c>make 239 menu-based configurator before building your kernel, after <c>make
240 oldconfig</c> has run. 240 oldconfig</c> has run.

Legend:
Removed from v.1.15  
changed lines
  Added in v.1.16

  ViewVC Help
Powered by ViewVC 1.1.20