| … | |
… | |
| 4 | <guide link="/doc/en/xml-guide.xml"> |
4 | <guide link="/doc/en/xml-guide.xml"> |
| 5 | <title>Gentoo Linux Genkernel Guide</title> |
5 | <title>Gentoo Linux Genkernel Guide</title> |
| 6 | |
6 | |
| 7 | <author title="Author"> |
7 | <author title="Author"> |
| 8 | <mail link="plasmaroo@gentoo.org">Tim Yamin</mail> |
8 | <mail link="plasmaroo@gentoo.org">Tim Yamin</mail> |
| 9 | </author> |
9 | </author> |
| 10 | |
10 | |
| 11 | <abstract> |
11 | <abstract> |
| 12 | This guide intends to provide a reference of all the functions |
12 | This guide intends to provide a reference of all the functions |
| 13 | provided by Genkernel. |
13 | provided by Genkernel. |
| 14 | </abstract> |
14 | </abstract> |
| 15 | |
15 | |
| 16 | <license/> |
16 | <license/> |
| 17 | |
17 | |
| 18 | <version>1.0</version> |
18 | <version>1.0</version> |
| 19 | <date>February 15, 2003</date> |
19 | <date>April 14, 2003</date> |
| 20 | |
20 | |
| 21 | <chapter> |
21 | <chapter> |
| 22 | <title>Introduction</title> |
22 | <title>Introduction</title> |
| 23 | <section> |
23 | <section> |
| 24 | <title>Introduction</title> |
24 | <title>Introduction</title> |
| 25 | <body> |
25 | <body> |
| 26 | |
26 | |
| 27 | <p> |
27 | <p> |
| 28 | Genkernel is designed to allow users who are not previously used to |
28 | Genkernel is designed to allow users who are not previously used to |
| 29 | compiling a kernel to use a similar setup to that one that is used on |
29 | compiling a kernel to use a similar setup to that one that is used on |
| 30 | the Gentoo LiveCDs which auto-detects your hardware. |
30 | the Gentoo LiveCDs which auto-detects your hardware. |
| 31 | </p> |
31 | </p> |
| 32 | |
32 | |
| 33 | <p> |
33 | <p> |
| 34 | Some users may also be interested in using genkernel for hardware |
34 | Some users may also be interested in using genkernel for hardware |
| … | |
… | |
| 191 | <p> |
191 | <p> |
| 192 | Genkernel supports the following flags, some of which have |
192 | Genkernel supports the following flags, some of which have |
| 193 | <c>--<b>no-</b>option</c> equivalents that influence |
193 | <c>--<b>no-</b>option</c> equivalents that influence |
| 194 | kernel compilation: |
194 | kernel compilation: |
| 195 | </p> |
195 | </p> |
| 196 | |
196 | |
| 197 | <ul> |
197 | <ul> |
| 198 | <li> |
198 | <li> |
| 199 | <b>--callback="echo Hello"</b>: This routine calls the specified |
199 | <b>--callback="echo Hello"</b>: This routine calls the specified |
| 200 | arguments after the kernel and the relevant modules have been built; but |
200 | arguments after the kernel and the relevant modules have been built; but |
| 201 | before the initrd has been built. This is useful where you might want |
201 | before the initrd has been built. This is useful where you might want |
| 202 | external modules installed to the initrd by emerging the relevant item |
202 | external modules installed to the initrd by emerging the relevant item |
| 203 | using the callback and then redefinining a Genkernel module group. |
203 | using the callback and then redefinining a Genkernel module group. |
| 204 | </li> |
204 | </li> |
| 205 | <li> |
205 | <li> |
| 206 | <b>--<c>no-</c>clean</b>: This runs a <c>make clean</c> before compiling |
206 | <b>--<c>no-</c>clean</b>: This runs <e>or does not |
|
|
207 | run</e> <c>make clean</c> before compiling your kernel. This |
| 207 | your kernel. This causes all object files and dependencies to be removed. |
208 | causes all object files and dependencies to be removed. |
| 208 | </li> |
|
|
| 209 | <li> |
209 | </li> |
| 210 | <b>--<c>no-</c>mrproper</b>: This runs a <c>make mrproper</c> before |
210 | <li> |
| 211 | compiling your kernel. This causes all object files, dependencies <b> |
211 | <b>--<c>no-</c>mrproper</b>: This runs <e>or does not |
|
|
212 | run</e> <c>make mrproper</c> before compiling your kernel. This |
|
|
213 | causes all object files, dependencies <b> and your |
| 212 | and your configuration</b> to be removed. |
214 | configuration</b> to be removed. |
| 213 | </li> |
215 | </li> |
| 214 | </ul> |
216 | </ul> |
| 215 | |
217 | |
| 216 | <ul> |
218 | <ul> |
| 217 | <li> |
219 | <li> |
| 218 | <b>--kerneldir=<path>/path/to/sources</path></b>: This specifies an |
220 | <b>--kerneldir=<path>/path/to/sources</path></b>: This specifies an |
| 219 | alternative kernel source location, instead of the default location of |
221 | alternative kernel source location, instead of the default location of |
| 220 | <path>/usr/src/linux</path>. |
222 | <path>/usr/src/linux</path>. |
| 221 | </li> |
223 | </li> |
| 222 | <li> |
224 | <li> |
| 223 | <b>--kernel-config=<path>/path/to/config-file</path></b>: This specifies an |
225 | <b>--kernel-config=<path>/path/to/config-file</path></b>: This specifies an |
| 224 | alternative kernel configuration which would be used; rather than the |
226 | alternative kernel configuration which would be used; rather than the |
| 225 | inpersistant <path>/path/to/sources/.config</path> which is used by |
227 | inpersistant <path>/path/to/sources/.config</path> which is used by |
| 226 | default. |
228 | default. |
| 227 | </li> |
229 | </li> |