/[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.3 Revision 1.4
1<?xml version='1.0' encoding="UTF-8"?> 1<?xml version='1.0' encoding="UTF-8"?>
2<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 2<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
3 3
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>
12This guide intends to provide a reference of all the functions 12This guide intends to provide a reference of all the functions
13provided by Genkernel. 13provided by Genkernel.
14</abstract> 14</abstract>
15
16<license/>
15 17
16<version>1.0</version> 18<version>1.0</version>
17<date>February 15, 2003</date> 19<date>February 15, 2003</date>
18 20
19<chapter> 21<chapter>
20<title>Introduction</title> 22<title>Introduction</title>
21<section> 23<section>
22<title>Introduction</title> 24<title>Introduction</title>
23<body> 25<body>
24 26
25<p> 27<p>
26Genkernel is designed to allow users who are not previously used to 28Genkernel is designed to allow users who are not previously used to
27compiling a kernel to use a similar setup to that one that is used on 29compiling a kernel to use a similar setup to that one that is used on
28the Gentoo LiveCDs which auto-detects your hardware. 30the Gentoo LiveCDs which auto-detects your hardware.
29</p> 31</p>
71You can obtain genkernel by simply running <c>emerge genkernel</c>. Don't 73You can obtain genkernel by simply running <c>emerge genkernel</c>. Don't
72forget to use the <c>-k</c> flag for emerge if you are using binary packages, 74forget to use the <c>-k</c> flag for emerge if you are using binary packages,
73i.e. GRP. Due to the GRP packages having an older version of genkernel, the 75i.e. GRP. Due to the GRP packages having an older version of genkernel, the
74flags are different. As a result, you should consult the <uri 76flags are different. As a result, you should consult the <uri
75link="http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=1&amp;chap=9"> 77link="http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=1&amp;chap=9">
76Gentoo Handbook</uri> and <path>genkernel --help</path>. 78Gentoo Handbook</uri> and <path>genkernel --help</path>.
77</p> 79</p>
78 80
79</body> 81</body>
80</section> 82</section>
81<section> 83<section>
82<title>Supported platforms</title> 84<title>Supported platforms</title>
83<body> 85<body>
84 86
85<p> 87<p>
86As of genkernel 3.0.1_beta12; the following platforms should be 88As of genkernel 3.0.2; the following platforms should be
87supported: alpha, amd64, parisc, parisc64, ppc, sparc, sparc64, and x86. If 89supported: alpha, amd64, parisc, parisc64, ppc, ppc64, sparc, sparc64, and x86. If
88you believe that there is a bug with the support code, and not with 90you believe that there is a bug with the support code, and not with
89genkernel, please file a bug at the <uri 91genkernel, please file a bug at the <uri
90link="http://bugs.gentoo.org">Gentoo Bugzilla.</uri> 92link="http://bugs.gentoo.org">Gentoo Bugzilla.</uri>
91</p> 93</p>
92 94
93</body> 95</body>
94</section> 96</section>
95</chapter> 97</chapter>
96 98
97<chapter> 99<chapter>
98<title>Genkernel usage</title> 100<title>Genkernel usage</title>
99<section> 101<section>
100<title>Introduction</title> 102<title>Introduction</title>
101<body> 103<body>
102 104
182 184
183</body> 185</body>
184</section> 186</section>
185<section> 187<section>
186<title>Genkernel kernel flags</title> 188<title>Genkernel kernel flags</title>
187<body> 189<body>
188 190
189<p> 191<p>
190Genkernel supports the following flags, some of which have 192Genkernel supports the following flags, some of which have
191<c>--<b>no-</b>option</c> equivalents that influence 193<c>--<b>no-</b>option</c> equivalents that influence
192kernel compilation: 194kernel compilation:
193</p> 195</p>
194 196
195<ul> 197<ul>
196 <li> 198 <li>
199 <b>--callback="echo Hello"</b>: This routine calls the specified
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
202 external modules installed to the initrd by emerging the relevant item
203 using the callback and then redefinining a Genkernel module group.
204 </li>
205 <li>
197 <b>--clean</b>: This runs a <c>make clean</c> before compiling your 206 <b>--<c>no-</c>clean</b>: This runs a <c>make clean</c> before compiling
198 kernel. This causes all object files and dependencies to be removed. 207 your kernel. This causes all object files and dependencies to be removed.
199 </li>
200 <li> 208 </li>
209 <li>
201 <b>--mrproper</b>: This runs a <c>make mrproper</c> before compiling your 210 <b>--<c>no-</c>mrproper</b>: This runs a <c>make mrproper</c> before
202 kernel. This causes all object files, dependencies <e>and your 211 compiling your kernel. This causes all object files, dependencies <b>
203 configuration</e> to be removed. 212 and your configuration</b> to be removed.
204 </li> 213 </li>
205</ul> 214</ul>
206 215
207<ul> 216<ul>
208 <li> 217 <li>
209 <b>--kerneldir=<path>/path/to/sources</path></b>: This specifies an 218 <b>--kerneldir=<path>/path/to/sources</path></b>: This specifies an
210 alternative kernel source location, instead of the default location of 219 alternative kernel source location, instead of the default location of
211 <path>/usr/src/linux</path>. 220 <path>/usr/src/linux</path>.
212 </li> 221 </li>
213 <li> 222 <li>
214 <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
215 alternative kernel configuration which would be used; rather than the 224 alternative kernel configuration which would be used; rather than the
216 inpersistant <path>/path/to/sources/.config</path> which is used by 225 inpersistant <path>/path/to/sources/.config</path> which is used by
217 default. 226 default.
218 </li> 227 </li>
293 302
294<p> 303<p>
295All that is needed to run genkernel is just genkernel with the 304All that is needed to run genkernel is just genkernel with the
296necessary flags as root. For example: 305necessary flags as root. For example:
297</p> 306</p>
298 307
299<pre caption="Running genkernel"> 308<pre caption="Running genkernel">
300# genkernel --menuconfig --no-clean --no-install --bootsplash 309# genkernel --menuconfig --no-clean --no-install --bootsplash
301<comment>(Would produce a kernel, asking you what how to configure it 310<comment>(Would produce a kernel, asking you what how to configure it
302to your desire, leaving alone any compiled object files, enabling 311to your desire, leaving alone any compiled object files, enabling
303bootsplash support but not installing anything.)</comment> 312bootsplash support but not installing anything.)</comment>
304</pre> 313</pre>
305 314
306<p> 315<p>
307If you want genkernel to install your kernel as well, you must ensure 316If you want genkernel to install your kernel as well, you must ensure
308that your <path>/boot</path> partition is mounted: 317that your <path>/boot</path> partition is mounted - recent Genkernels
318would automatically attempt to do this for you if MOUNTBOOT is set to
319"yes" in <path>/etc/genkernel.conf</path>.
309</p> 320</p>
310 321
311<pre caption="Mounting your /boot"> 322<pre caption="Mounting your /boot manually">
312<comment>(If /boot is a valid entry in /etc/fstab:)</comment> 323<comment>(If /boot is a valid entry in /etc/fstab:)</comment>
313# mount /boot 324# mount /boot
314<comment>(... otherwise for IDE disks:)</comment> 325<comment>(... otherwise for IDE disks:)</comment>
315# mount /dev/hda1 /boot 326# mount /dev/hda1 /boot
316<comment>(... and for SCSI disks:)</comment> 327<comment>(... and for SCSI disks:)</comment>
317# mount /dev/sda1 /boot 328# mount /dev/sda1 /boot
318</pre> 329</pre>
319 330
320</body> 331</body>
321</section> 332</section>
322<section> 333<section>
323<title>Setting up genkernel to work with your bootloader</title> 334<title>Setting up genkernel to work with your bootloader</title>
324<body> 335<body>
325 336
326<p> 337<p>

Legend:
Removed from v.1.3  
changed lines
  Added in v.1.4

  ViewVC Help
Powered by ViewVC 1.1.20