Attachment 28022 Details for Bug 44807 – Final fix to document

[patch] Final fix to document

2.6-koutput-user.xml.patch (text/plain), 3.66 KB, created by Benny Chuang (RETIRED) on 2004-03-25 16:27:02 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Benny Chuang (RETIRED)

Created: 2004-03-25 16:27:02 UTC

Size: 3.66 KB

patch

obsolete

>--- 2.6-koutput-user.xml	2004-03-25 16:09:08.000000000 +0000
>+++ 2.6-koutput-user.xml.benny	2004-03-25 16:24:20.000000000 +0000
>@@ -7,19 +7,26 @@
> <author title="Developer">
>     <mail link="latexer@gentoo.org">Peter Johanson</mail>
> </author>
>-
>-<license/>
>+<author title="Editor">
>+  <mail link="antifa@gentoo.org">Ken Nowack</mail>
>+</author>
>+<author title="Editor">
>+  <mail link="bennyc@gentoo.org">Benny Chuang</mail>
>+</author>
> 
> <abstract>
> This guide covers how to use Gentoo's new "koutput" method to handle 2.6
> kernels and kernel modules.
> </abstract>
> 
>+<license/>
>+
> <version>1.0</version>
> <date>March 14, 2004</date>
> 
> <chapter>
> <title>Overview</title>
>+<section>
> <body>
> 
> <p>
>@@ -30,7 +37,7 @@
> old method:
> </p>
> 
>-<ol>
>+<ul>
>   <li>
>   Arbitrary users can all use the same sources to build kernels, outputting
>   to some location in their home directory.
>@@ -47,7 +54,7 @@
>   External modules can be built without requiring write access to
>   <path>/usr/src/linux</path>
>   </li>
>-</ol>
>+</ul>
> 
> <p>
> This last fact is important, as previously portage would need to be given
>@@ -58,8 +65,10 @@
> kernel module emerges, you can use config-kernel:
> </p>
> 
>-<note>Not all of config-kernel's features are discussed in this guide. For the
>-rest of the information see <b>man config-kernel</b></note>
>+<note>
>+Not all of config-kernel's features are discussed in this guide. For the
>+rest of the information see <b>man config-kernel</b>
>+</note>
> 
> <pre caption="Enabling writing to /usr/src/linux">
> # <i>config-kernel --allow-writable yes</i>
>@@ -74,16 +83,18 @@
> </pre>
> 
> </body>
>+</section>
> </chapter>
> <chapter>
> <title>Enabling koutput</title>
>+<section>
> <body>
> 
> <p>
> 2.6 kernels determine where to output their files based on two environmental
>-variables, <i>KBUILD_OUTPUT</i> and <i>O</i>. <i>KBUILD_OUTPUT</i> should be set
>+variables, <c>KBUILD_OUTPUT</c> and <c>O</c>. <c>KBUILD_OUTPUT</c> should be set
> environmentally, and can then be overriden on the command line by specifying a
>-new <i>O</i> value. e.g.:
>+new <c>O</c> value. e.g.:
> </p>
> 
> <pre caption="Setting an output by hand">
>@@ -133,19 +144,27 @@
> <p>
> The above command converts the kernel found in <path>/usr/src/linux-2.6.3</path>
> to outputting to a different directory. If the output directory has been set
>-previously with <i>--output-dir=foo</i>, then that prefix will be used.
>+previously with <c>--output-dir=foo</c>, then that prefix will be used.
> Otherwise, the Gentoo default of <path>/var/tmp/kernel-output/KV</path> will be
> used.
> </p>
> 
> </body>
>+</section>
> </chapter>
> <chapter>
> <title>Repercussions</title>
>+<section>
> <body>
> 
> <p>
>-After configuring a kernel to use a different output directory, the changes go largly unnoticed when configuring and isntalling a kernel. A few key files change locations that you should be aware of though. The main files to be concered with are .config, and the generated bzImage after compiling a kernel. Below is a table showing the original and new locations for some key files. We assume the kernel is a 2.6.4 kernel outputting to the Gentoo default of <path>/var/tmp/kernel-output/2.6.4</path>.
>+After configuring to use a different output directory, the changes go largly
>+unnoticed when configuring and installing a kernel. There are a few key file
>+location changes that you should be aware of though. The main files to be
>+concered with are .config, and the generated bzImage after compiling a kernel.
>+Below is a table showing the original and new locations for these key files. The
>+table assumes a 2.6.4 kernel outputting to the Gentoo default of
>+<path>/var/tmp/kernel-output/2.6.4</path>.
> </p>
> 
> <table>
>@@ -164,6 +183,6 @@
> </table>
> 
> </body>
>+</section>
> </chapter>
>-
> </guide>

Actions: View | Diff

Attachments on bug 44807: 27435 | 28021 | 28022 | 28125 | 28193