/[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.10 Revision 1.11
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.10 2004/09/21 09:16:23 neysx Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/genkernel.xml,v 1.11 2004/11/05 16:39:05 plasmaroo 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
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</version> 19<version>1.1.1</version>
20<date>August 19, 2004</date> 20<date>November 05, 2004</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>
150 <li> 150 <li>
151 <b>--kernel-ld=<c>someLinker</c></b>: This specifies a linker which would 151 <b>--kernel-ld=<c>someLinker</c></b>: This specifies a linker which would
152 be used for compiling your kernel. 152 be used for compiling your kernel.
153 </li> 153 </li>
154 <li> 154 <li>
155 <b>--kernel-make=<c>someMake</c></b>: This specifies an alternate GNU Make 155 <b>--kernel-make=<c>someMake</c></b>: This specifies an alternate GNU make
156 which would be used for compiling your kernel. 156 which would be used for compiling your kernel.
157 </li> 157 </li>
158</ul> 158</ul>
159 159
160<ul> 160<ul>
169 <li> 169 <li>
170 <b>--utils-ld=<c>someLinker</c></b>: This specifies a linker which would be 170 <b>--utils-ld=<c>someLinker</c></b>: This specifies a linker which would be
171 used for compiling the support utilities. 171 used for compiling the support utilities.
172 </li> 172 </li>
173 <li> 173 <li>
174 <b>--utils-make=<c>someMake</c></b>: This specifies an alternate GNU Make 174 <b>--utils-make=<c>someMake</c></b>: This specifies an alternate GNU make
175 which would be used for compiling the support utilities. 175 which would be used for compiling the support utilities.
176 </li> 176 </li>
177</ul> 177</ul>
178 178
179<ul> 179<ul>
180 <li> 180 <li>
181 <b>--makeopts=<c>-jJobs</c></b>: This specifies the flags which would be 181 <b>--makeopts=<c>-jJobs</c></b>: This specifies the flags which would be
182 passed to GNU Make when the kernel and utilities are being compiled. 182 passed to GNU make when the kernel and utilities are being compiled.
183 </li> 183 </li>
184</ul> 184</ul>
185 185
186</body> 186</body>
187</section> 187</section>
199 <li> 199 <li>
200 <b>--callback="echo Hello"</b>: This routine calls the specified 200 <b>--callback="echo Hello"</b>: This routine calls the specified
201 arguments after the kernel and the relevant modules have been built; but 201 arguments after the kernel and the relevant modules have been built; but
202 before the initrd has been built. This is useful where you might want 202 before the initrd has been built. This is useful where you might want
203 external modules installed to the initrd by emerging the relevant item 203 external modules installed to the initrd by emerging the relevant item
204 using the callback and then redefinining a Genkernel module group. 204 using the callback and then redefinining a genkernel module group.
205 </li> 205 </li>
206 <li> 206 <li>
207 <b>--<c>no-</c>clean</b>: This runs <e>or does not 207 <b>--<c>no-</c>clean</b>: This runs <e>or does not
208 run</e> <c>make clean</c> before compiling your kernel. This 208 run</e> <c>make clean</c> before compiling your kernel. This
209 causes all object files and dependencies to be removed. 209 causes all object files and dependencies to be removed.
238 also required. 238 also required.
239 </li> 239 </li>
240 <li> 240 <li>
241 <b>--<c>no-</c>menuconfig</b>: This runs <e>or does not run</e> the kernel 241 <b>--<c>no-</c>menuconfig</b>: This runs <e>or does not run</e> the kernel
242 menu-based configurator before building your kernel, after <c>make 242 menu-based configurator before building your kernel, after <c>make
243 oldconfig</c> has ran. 243 oldconfig</c> has run.
244 </li> 244 </li>
245</ul> 245</ul>
246 246
247<ul> 247<ul>
248 <li> 248 <li>
291<ul> 291<ul>
292 <li> 292 <li>
293 <b>--minkernpackage=<path>/output/to/yourkernel.tar.bz2</path></b>: This 293 <b>--minkernpackage=<path>/output/to/yourkernel.tar.bz2</path></b>: This
294 flag outputs a tarball of the kernel, named as <path>kernel</path> and the 294 flag outputs a tarball of the kernel, named as <path>kernel</path> and the
295 initrd named as <path>initrd</path> to the specified file. No path 295 initrd named as <path>initrd</path> to the specified file. No path
296 information or modules will be includes in the tarball. 296 information or modules will be included in the tarball.
297 </li> 297 </li>
298</ul> 298</ul>
299 299
300</body> 300</body>
301</section> 301</section>
308necessary flags as root. For example: 308necessary flags as root. For example:
309</p> 309</p>
310 310
311<pre caption="Running genkernel"> 311<pre caption="Running genkernel">
312# genkernel --menuconfig --no-clean --no-install --bootsplash all 312# genkernel --menuconfig --no-clean --no-install --bootsplash all
313<comment>(Would produce a kernel, asking you what how to configure it 313<comment>(Would produce a kernel, asking you how to configure it
314to your desire, leaving alone any compiled object files, enabling 314to your desire, leaving alone any compiled object files, enabling
315bootsplash support but not installing anything.)</comment> 315bootsplash support but not installing anything.)</comment>
316</pre> 316</pre>
317 317
318<p> 318<p>
319If you want genkernel to install your kernel as well, you must ensure 319If you want genkernel to install your kernel as well, you must ensure
320that your <path>/boot</path> partition is mounted - recent Genkernels 320that your <path>/boot</path> partition is mounted - recent genkernels
321would automatically attempt to do this for you if MOUNTBOOT is set to 321would automatically attempt to do this for you if MOUNTBOOT is set to
322"yes" in <path>/etc/genkernel.conf</path>. 322"yes" in <path>/etc/genkernel.conf</path>.
323</p> 323</p>
324 324
325<pre caption="Mounting your /boot manually"> 325<pre caption="Mounting your /boot manually">
347 Add <c>root=/dev/ram0</c> and <c>init=/linuxrc</c> to the 347 Add <c>root=/dev/ram0</c> and <c>init=/linuxrc</c> to the
348 kernel parameters passed to the kernel image. 348 kernel parameters passed to the kernel image.
349 </li> 349 </li>
350 <li> 350 <li>
351 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
352 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
353 partition. 353 partition.
354 </li> 354 </li>
355 <li> 355 <li>
356 If you are using bootsplash, add a suitable modeline such as 356 If you are using bootsplash, add a suitable modeline such as
357 <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
389<title>Introduction</title> 389<title>Introduction</title>
390<body> 390<body>
391 391
392<p> 392<p>
393Provided your architecture has all the required libraries and utilties 393Provided your architecture has all the required libraries and utilties
394which genkernel requires, which includes but it not limited to a 394which genkernel requires, which includes but it is not limited to a
395working kernel for your architecture, working compiler suite, GNU 395working kernel for your architecture, working compiler suite, GNU
396Make, and a working busybox distribution, you're all set to go! 396make, and a working busybox distribution, you're all set to go!
397</p> 397</p>
398 398
399<p> 399<p>
400For each architecture, genkernel uses 400For each architecture, genkernel uses
401<path>/usr/share/genkernel/archName</path> for configuration files for 401<path>/usr/share/genkernel/$archName</path> for configuration files for
402that architecture. 402that architecture.
403</p> 403</p>
404 404
405</body> 405</body>
406</section> 406</section>

Legend:
Removed from v.1.10  
changed lines
  Added in v.1.11

  ViewVC Help
Powered by ViewVC 1.1.20