| 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> |
Parent Directory
| 
Revision Log
| 
Patch