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> |
13 | This guide intends to provide a reference of all the functions |
13 | This guide intends to provide a reference of all the functions |
14 | provided by Genkernel. |
14 | provided 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> |
… | |
… | |
308 | necessary flags as root. For example: |
308 | necessary 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 |
314 | to your desire, leaving alone any compiled object files, enabling |
314 | to your desire, leaving alone any compiled object files, enabling |
315 | bootsplash support but not installing anything.)</comment> |
315 | bootsplash support but not installing anything.)</comment> |
316 | </pre> |
316 | </pre> |
317 | |
317 | |
318 | <p> |
318 | <p> |
319 | If you want genkernel to install your kernel as well, you must ensure |
319 | If you want genkernel to install your kernel as well, you must ensure |
320 | that your <path>/boot</path> partition is mounted - recent Genkernels |
320 | that your <path>/boot</path> partition is mounted - recent genkernels |
321 | would automatically attempt to do this for you if MOUNTBOOT is set to |
321 | would 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> |
393 | Provided your architecture has all the required libraries and utilties |
393 | Provided your architecture has all the required libraries and utilties |
394 | which genkernel requires, which includes but it not limited to a |
394 | which genkernel requires, which includes but it is not limited to a |
395 | working kernel for your architecture, working compiler suite, GNU |
395 | working kernel for your architecture, working compiler suite, GNU |
396 | Make, and a working busybox distribution, you're all set to go! |
396 | make, and a working busybox distribution, you're all set to go! |
397 | </p> |
397 | </p> |
398 | |
398 | |
399 | <p> |
399 | <p> |
400 | For each architecture, genkernel uses |
400 | For 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 |
402 | that architecture. |
402 | that architecture. |
403 | </p> |
403 | </p> |
404 | |
404 | |
405 | </body> |
405 | </body> |
406 | </section> |
406 | </section> |