neysx 06/01/08 14:05:29
Modified: xml/htdocs/doc/en/handbook hb-install-alpha-kernel.xml
hb-install-amd64-kernel.xml
hb-install-hppa-kernel.xml
hb-install-mips-kernel.xml
hb-install-ppc-kernel.xml
hb-install-ppc64-kernel.xml
hb-install-sparc-kernel.xml
hb-install-x86-kernel.xml
Log:
#118031 hb-install-*-kernel.xml files need TLC
Revision Changes Path
1.33 +12 -30 xml/htdocs/doc/en/handbook/hb-install-alpha-kernel.xml
file :
http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-alpha-kernel.xml?rev=1.33&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain:
http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-alpha-kernel.xml?rev=1.33&content-type=text/plain&cvsroot=gentoo
diff :
http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-alpha-kernel.xml.diff?r1=1.32&r2=1.33&cvsroot=gentoo
Index: hb-install-alpha-kernel.xml
===================================================================
RCS file:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-alpha-kernel.xml,v
retrieving revision 1.32
retrieving revision 1.33
diff -u -r1.32 -r1.33
--- hb-install-alpha-kernel.xml 21 Nov 2005 15:37:12 -0000 1.32
+++ hb-install-alpha-kernel.xml 8 Jan 2006 14:05:29 -0000 1.33
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
-<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-alpha-kernel.xml,v
1.32 2005/11/21 15:37:12 neysx Exp $ -->
+<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-alpha-kernel.xml,v
1.33 2006/01/08 14:05:29 neysx Exp $ -->
<sections>
-<version>2.10</version>
-<date>2005-11-21</date>
+<version>2.11</version>
+<date>2006-01-06</date>
<section>
<title>Timezone</title>
@@ -57,16 +57,20 @@
In the next example we install the <c>vanilla-sources</c>.
Of course substitute with your choice of sources, this is merely an example.
The <c>USE="-doc"</c> is necessary to avoid installing xorg-x11 or other
-dependencies at this point:
+dependencies at this point. <c>USE="symlink"</c> is not necessary for a new
++install, but ensures proper creation of the <path>/usr/src/linux</path>
++symlink.
</p>
<pre caption="Installing a kernel source">
-# <i>USE="-doc" emerge vanilla-sources</i>
+# <i>USE="-doc symlink" emerge vanilla-sources</i>
</pre>
<p>
When you take a look in <path>/usr/src</path> you should see a symlink called
-<path>linux</path> pointing to your kernel source:
+<path>linux</path> pointing to your kernel source. In this case, the installed
+kernel source points to <c>vanilla-sources-2.6.11.2</c>. Your version may be
+different, so keep this in mind.
</p>
<pre caption="Viewing the kernel source symlink">
@@ -75,17 +79,6 @@
</pre>
<p>
-If this isn't the case (i.e. the symlink points to a different kernel source)
-change the symlink before you continue:
-</p>
-
-<pre caption="Changing the kernel source symlink">
-# <i>rm /usr/src/linux</i>
-# <i>cd /usr/src</i>
-# <i>ln -s linux-2.6.11.2 linux</i>
-</pre>
-
-<p>
Now it is time to configure and compile your kernel source. You
can use <c>genkernel</c> for this, which will build a generic kernel as used
by the Installation CD. We explain the "manual" configuration first though, as
it is
@@ -182,7 +175,6 @@
File systems --->
Pseudo Filesystems --->
[*] /proc file system support
- [ ] /dev file system support (OBSOLETE)
[*] Virtual memory file system support (former shm fs)
<comment>(Select one or more of the following options as needed by your
system)</comment>
@@ -311,9 +303,8 @@
<p>
When the kernel has finished compiling, copy the kernel image to
-<path>/boot</path>. In the next example we assume you have configured and
-compiled <c>vanilla-sources-2.6.11.2</c>; recent kernels might create
-<path>vmlinux</path> instead of <path>vmlinux.gz</path>.
+<path>/boot</path>. Recent kernels might create <path>vmlinux</path> instead of
+<path>vmlinux.gz</path>. Keep this in mind when you copy your kernel image.
</p>
<pre caption="Installing the kernel">
@@ -321,15 +312,6 @@
</pre>
<p>
-It is also wise to copy over your kernel configuration file to
-<path>/boot</path>, just in case :)
-</p>
-
-<pre caption="Backing up your kernel configuration">
-# <i>cp .config /boot/config-2.6.11.2</i>
-</pre>
-
-<p>
Now continue with <uri link="#kernel_modules">Installing Separate Kernel
Modules</uri>.
</p>
1.35 +18 -33 xml/htdocs/doc/en/handbook/hb-install-amd64-kernel.xml
file :
http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-amd64-kernel.xml?rev=1.35&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain:
http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-amd64-kernel.xml?rev=1.35&content-type=text/plain&cvsroot=gentoo
diff :
http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-amd64-kernel.xml.diff?r1=1.34&r2=1.35&cvsroot=gentoo
Index: hb-install-amd64-kernel.xml
===================================================================
RCS file:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-amd64-kernel.xml,v
retrieving revision 1.34
retrieving revision 1.35
diff -u -r1.34 -r1.35
--- hb-install-amd64-kernel.xml 27 Nov 2005 01:46:02 -0000 1.34
+++ hb-install-amd64-kernel.xml 8 Jan 2006 14:05:29 -0000 1.35
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
-<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-amd64-kernel.xml,v
1.34 2005/11/27 01:46:02 neysx Exp $ -->
+<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-amd64-kernel.xml,v
1.35 2006/01/08 14:05:29 neysx Exp $ -->
<sections>
-<version>2.11</version>
-<date>2005-11-26</date>
+<version>2.12</version>
+<date>2006-01-06</date>
<section>
<title>Timezone</title>
@@ -52,18 +52,22 @@
</p>
<p>
-Choose your kernel source and install it using <c>emerge</c>.
-The <c>USE="-doc"</c> is necessary to avoid installing xorg-x11 or other
-dependencies at this point:
+Choose your kernel source and install it using <c>emerge</c>. The
+<c>USE="-doc"</c> is necessary to avoid installing xorg-x11 or other
+dependencies at this point. <c>USE="symlink"</c> is not necessary for a new
+install, but ensures proper creation of the <path>/usr/src/linux</path>
+symlink.
</p>
<pre caption="Installing a kernel source">
-# <i>USE="-doc" emerge gentoo-sources</i>
+# <i>USE="-doc symlink" emerge gentoo-sources</i>
</pre>
<p>
When you take a look in <path>/usr/src</path> you should see a symlink called
-<path>linux</path> pointing to your kernel source:
+<path>linux</path> pointing to your kernel source. In this case, the installed
+kernel source points to <c>gentoo-sources-2.6.12-r10</c>. Your version may be
+different, so keep this in mind.
</p>
<pre caption="Viewing the kernel source symlink">
@@ -72,17 +76,6 @@
</pre>
<p>
-If this isn't the case (i.e. the symlink points to a different kernel source)
-change the symlink before you continue:
-</p>
-
-<pre caption="Changing the kernel source symlink">
-# <i>rm /usr/src/linux</i>
-# <i>cd /usr/src</i>
-# <i>ln -s linux-2.6.12-gentoo-r10 linux</i>
-</pre>
-
-<p>
Now it is time to configure and compile your kernel source.
You can use <c>genkernel</c> for this, which will build a generic kernel as
used
by the Installation CD. We explain the "manual" configuration first though, as
@@ -182,15 +175,13 @@
Now go to <c>File Systems</c> and select support for the filesystems you use.
<e>Don't</e> compile them as modules, otherwise your Gentoo system will not be
able to mount your partitions. Also select <c>Virtual memory</c> and <c>/proc
-file system</c>. Do <e>not</e> select <c>/dev file system support</c> as
-Gentoo/AMD64 now uses <c>udev</c> by default.
+file system</c>.
</p>
<pre caption="Selecting necessary file systems">
File systems --->
Pseudo Filesystems --->
[*] /proc file system support
- [ ] /dev file system support (OBSOLETE)
[*] Virtual memory file system support (former shm fs)
<comment>(Select one or more of the following options as needed by your
system)</comment>
@@ -269,20 +260,14 @@
<p>
When the kernel has finished compiling, copy the kernel image to
-<path>/boot</path>:
+<path>/boot</path>. Use whatever name you feel is appropriate for your kernel
+choice and remember it as you will need it later on when you configure your
+bootloader. Remember to replace <path><kernel-version></path> with the
name and
+version of your kernel.
</p>
<pre caption="Installing the kernel">
-# <i>cp arch/x86_64/boot/bzImage /boot/kernel-2.6.12-gentoo-r10</i>
-</pre>
-
-<p>
-It is also wise to copy over your kernel configuration file to
-<path>/boot</path>, just in case :)
-</p>
-
-<pre caption="Backing up your kernel configuration">
-# <i>cp .config /boot/config-2.6.12-gentoo-r10</i>
+# <i>cp arch/x86_64/boot/bzImage /boot/<kernel-version></i>
</pre>
<p>
1.30 +22 -38 xml/htdocs/doc/en/handbook/hb-install-hppa-kernel.xml
file :
http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-hppa-kernel.xml?rev=1.30&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain:
http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-hppa-kernel.xml?rev=1.30&content-type=text/plain&cvsroot=gentoo
diff :
http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-hppa-kernel.xml.diff?r1=1.29&r2=1.30&cvsroot=gentoo
Index: hb-install-hppa-kernel.xml
===================================================================
RCS file:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-hppa-kernel.xml,v
retrieving revision 1.29
retrieving revision 1.30
diff -u -r1.29 -r1.30
--- hb-install-hppa-kernel.xml 21 Nov 2005 15:37:12 -0000 1.29
+++ hb-install-hppa-kernel.xml 8 Jan 2006 14:05:29 -0000 1.30
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
-<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-hppa-kernel.xml,v
1.29 2005/11/21 15:37:12 neysx Exp $ -->
+<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-hppa-kernel.xml,v
1.30 2006/01/08 14:05:29 neysx Exp $ -->
<sections>
-<version>1.22</version>
-<date>2005-11-21</date>
+<version>1.23</version>
+<date>2006-01-06</date>
<section>
<title>Timezone</title>
@@ -46,21 +46,25 @@
</p>
<p>
-For HPPA we have <c>hppa-sources</c>. Default these sources are based on
-the 2.6 kernel sources. If you want to install a 2.4 kernel, you will need
-to install Gentoo from a working Internet connection as we do not supply those
-sources on our Installation CD. Continue by installing the kernel source.
-The <c>USE="-doc"</c> is necessary to avoid installing xorg-x11 or other
-dependencies at this point:
+For HPPA we have <c>hppa-sources</c>. By default, these sources are based on
+the 2.6 kernel sources. If you want to install a 2.4 kernel, you will need to
+install Gentoo from a working Internet connection as we do not supply those
+sources on our Installation CD. Continue by installing the kernel source. The
+<c>USE="-doc"</c> is necessary to avoid installing xorg-x11 or other
+dependencies at this point. <c>USE="symlink"</c> is not necessary for a new
+install, but ensures proper creation of the <path>/usr/src/linux</path>
+symlink.
</p>
<pre caption="Installing a kernel source">
-# <i>USE="-doc" emerge hppa-sources</i>
+# <i>USE="-doc symlink" emerge hppa-sources</i>
</pre>
<p>
When you take a look in <path>/usr/src</path> you should see a symlink called
-<path>linux</path> pointing to your kernel source:
+<path>linux</path> pointing to your kernel source. In this case, the installed
+kernel source points to <c>hppa-sources-2.6.12.2-pa2</c>. Your version may be
+different, so keep this in mind.
</p>
<pre caption="Viewing the kernel source symlink">
@@ -69,17 +73,6 @@
</pre>
<p>
-If this isn't the case (i.e. the symlink points to a different kernel source)
-change the symlink before you continue:
-</p>
-
-<pre caption="Changing the kernel source symlink">
-# <i>rm /usr/src/linux</i>
-# <i>cd /usr/src</i>
-# <i>ln -s linux-2.6.12.2-pa2 linux</i>
-</pre>
-
-<p>
Now it is time to configure and compile your kernel source. All architectures
can use <c>genkernel</c> for this, which will build a generic kernel as used
by the Installation CD. We explain the "manual" configuration first though, as
@@ -157,16 +150,14 @@
<p>
Now go to <c>File Systems</c> and select support for the filesystems you use.
<e>Don't</e> compile them as modules, otherwise your Gentoo system will not be
-able to mount your partitions. Also select <c>Virtual memory</c>, <c>/proc
-file system</c>, <c>/dev file system</c> + <c>Automatically mount at boot</c>:
+able to mount your partitions. Also select <c>Virtual memory</c> and <c>/proc
+file system</c>:
</p>
<pre caption="Selecting necessary file systems">
File systems --->
Pseudo Filesystems --->
[*] /proc file system support
- [*] /dev file system support (OBSOLETE)
- [*] Automatically mount at boot
[*] Virtual memory file system support (former shm fs)
<comment>(Select one or more of the following options as needed by your
system)</comment>
@@ -268,21 +259,14 @@
<p>
When the kernel has finished compiling, copy the kernel image to
-<path>/boot</path>. In the next example we assume you have configured and
-compiled <c>hppa-sources-2.6.12.2-pa2</c>.
+<path>/boot</path>. Use whatever name you feel is appropriate for your kernel
+choice and remember it as you will need it later on when you configure your
+bootloader. Remember to replace <path><kernel-version></path> with the
+name and version of your kernel.
</p>
<pre caption="Installing the kernel">
-# <i>cp vmlinux /boot/kernel-2.6.12.2-pa2</i>
-</pre>
-
-<p>
-It is also wise to copy over your kernel configuration file to
-<path>/boot</path>, just in case :)
-</p>
-
-<pre caption="Backing up your kernel configuration">
-# <i>cp .config /boot/config-2.6.12.2-pa2</i>
+# <i>cp vmlinux /boot/<kernel-version></i>
</pre>
<p>
1.19 +20 -34 xml/htdocs/doc/en/handbook/hb-install-mips-kernel.xml
file :
http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-mips-kernel.xml?rev=1.19&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain:
http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-mips-kernel.xml?rev=1.19&content-type=text/plain&cvsroot=gentoo
diff :
http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-mips-kernel.xml.diff?r1=1.18&r2=1.19&cvsroot=gentoo
Index: hb-install-mips-kernel.xml
===================================================================
RCS file:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-kernel.xml,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -r1.18 -r1.19
--- hb-install-mips-kernel.xml 21 Nov 2005 15:37:12 -0000 1.18
+++ hb-install-mips-kernel.xml 8 Jan 2006 14:05:29 -0000 1.19
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
-<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-kernel.xml,v
1.18 2005/11/21 15:37:12 neysx Exp $ -->
+<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-kernel.xml,v
1.19 2006/01/08 14:05:29 neysx Exp $ -->
<sections>
-<version>1.14</version>
-<date>2005-11-21</date>
+<version>1.15</version>
+<date>2006-01-06</date>
<section>
<title>Timezone</title>
@@ -50,10 +50,12 @@
</p>
<p>
-Choose your kernel source and install it using <c>emerge</c>.
-Of course substitute with your choice of sources, this is merely an example.
-The <c>USE="-doc"</c> is necessary to avoid installing xorg-x11 or other
-dependencies at this point:
+Choose your kernel source and install it using <c>emerge</c>. Of course
+substitute with your choice of sources, this is merely an example. The
+<c>USE="-doc"</c> is necessary to avoid installing xorg-x11 or other
+dependencies at this point. <c>USE="symlink"</c> is not necessary for a new
+install, but ensures proper creation of the <path>/usr/src/linux</path>
+symlink.
</p>
<note>
@@ -64,17 +66,19 @@
<pre caption="Installing a kernel source">
<comment>(For SGI machines)</comment>
-# <i>USE="-doc" emerge mips-sources</i>
+# <i>USE="-doc symlink" emerge mips-sources</i>
<comment>(For Cobalt machines)</comment>
# <i>mkdir -p /etc/portage</i>
# <i>echo "sys-kernel/mips-sources cobalt" >>
/etc/portage/package.use</i>
-# <i>USE="-doc" emerge mips-sources</i>
+# <i>USE="-doc symlink" emerge mips-sources</i>
</pre>
<p>
When you take a look in <path>/usr/src</path> you should see a symlink called
-<path>linux</path> pointing to your kernel source:
+<path>linux</path> pointing to your kernel source. In this case, the installed
+kernel source points to <c>mips-sources-2.4.24</c>. Your version may be
+different, so keep this in mind.
</p>
<pre caption="Viewing the kernel source symlink">
@@ -83,17 +87,6 @@
</pre>
<p>
-If this isn't the case (i.e. the symlink points to a different kernel source)
-change the symlink before you continue:
-</p>
-
-<pre caption="Changing the kernel source symlink">
-# <i>rm /usr/src/linux</i>
-# <i>cd /usr/src</i>
-# <i>ln -s linux-2.4.24 linux</i>
-</pre>
-
-<p>
Now it is time to configure and compile your kernel source.
</p>
@@ -196,23 +189,16 @@
</p>
<note>
-On Cobalt servers, the bootloader will expect to see a compressed kernelimage.
-Remember to <c>gzip -9</c> the file once it is in <path>/boot</path>.
+On Cobalt servers, the bootloader will expect to see a compressed kernel image.
+Remember to <c>gzip -9</c> the file once it is in <path>/boot</path>. In the
+following example, replace <path><kernel-version></path> with your kernel
+version.
</note>
<pre caption="Installing the kernel">
-# <i>cp vmlinux /boot/kernel-2.4.24</i>
+# <i>cp vmlinux /boot/<kernel-version<</i>
<comment>(Cobalt Servers -- Compressing the kernel image)</comment>
-# <i>gzip -9v /boot/kernel-2.4.24</i>
-</pre>
-
-<p>
-It is also wise to copy over your kernel configuration file to
-<path>/boot</path>, just in case :)
-</p>
-
-<pre caption="Backing up your kernel configuration">
-# <i>cp .config /boot/config-2.4.24</i>
+# <i>gzip -9v /boot/<kernel-version<</i>
</pre>
<!--
1.38 +23 -40 xml/htdocs/doc/en/handbook/hb-install-ppc-kernel.xml
file :
http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-ppc-kernel.xml?rev=1.38&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain:
http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-ppc-kernel.xml?rev=1.38&content-type=text/plain&cvsroot=gentoo
diff :
http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-ppc-kernel.xml.diff?r1=1.37&r2=1.38&cvsroot=gentoo
Index: hb-install-ppc-kernel.xml
===================================================================
RCS file:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-kernel.xml,v
retrieving revision 1.37
retrieving revision 1.38
diff -u -r1.37 -r1.38
--- hb-install-ppc-kernel.xml 21 Nov 2005 15:37:12 -0000 1.37
+++ hb-install-ppc-kernel.xml 8 Jan 2006 14:05:29 -0000 1.38
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
-<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-kernel.xml,v 1.37
2005/11/21 15:37:12 neysx Exp $ -->
+<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-kernel.xml,v 1.38
2006/01/08 14:05:29 neysx Exp $ -->
<sections>
-<version>2.14</version>
-<date>2005-11-21</date>
+<version>2.15</version>
+<date>2006-01-06</date>
<section>
<title>Timezone</title>
@@ -46,27 +46,32 @@
</p>
<p>
-We suggest using either <c>vanilla-sources</c> or <c>gentoo-sources</c>
-on PPC, which are both 2.6 kernels. The latter is available when you
-perform a networkless installation. So let's continue with <c>emerge</c>'ing
-the kernel sources.
-The <c>USE="-doc"</c> is necessary to avoid installing xorg-x11 or other
-dependencies at this point:
+We suggest using either <c>vanilla-sources</c> or <c>gentoo-sources</c> on PPC,
+which are both 2.6 kernels. The latter is available when you perform a
+networkless installation. So let's continue with <c>emerge</c>'ing the kernel
+sources. The <c>USE="-doc"</c> is necessary to avoid installing xorg-x11 or
+other dependencies at this point. <c>USE="symlink"</c> is not necessary for a
+new install, but ensures proper creation of the <path>/usr/src/linux</path>
+symlink.
</p>
<pre caption="Installing the kernel source">
-# <i>USE="-doc" emerge gentoo-sources</i>
+# <i>USE="-doc symlink" emerge gentoo-sources</i>
</pre>
+<!-- Removed, as we're trying to avoid specific kernel versions to improve HB
+maintainability
<note>
-The suggested sources at the time of the 2005.1 release are
+The suggested sources at the time of the 2005.1 release are
<c>gentoo-sources-2.6.12-r4</c> and <c>vanilla-sources-2.6.12.2</c>.
-</note>
+</note>
+-->
<p>
If you take a look in <path>/usr/src</path> you should see a symlink named
-<path>linux</path> pointing to your current kernel source. Here, we will assume
-that the kernel source installed is <c>gentoo-sources-2.6.12-r4</c>:
+<path>linux</path> pointing to your current kernel source. In this case, the
+installed kernel source points to <c>gentoo-sources-2.6.12-r4</c>. Your version
+may be different, so keep this in mind.
</p>
<pre caption="Viewing the kernel source symlink">
@@ -75,18 +80,6 @@
</pre>
<p>
-If the symlink doesn't point to the kernel source of your choice (note that
-<c>linux-2.6.12-gentoo-r4</c> is merely an example) you should change it to the
-desired kernel sources:
-</p>
-
-<pre caption="Changing the kernel source symlink">
-# <i>rm /usr/src/linux</i>
-# <i>cd /usr/src</i>
-# <i>ln -s linux-2.6.12-gentoo-r4 linux</i>
-</pre>
-
-<p>
It is now time to configure and compile your kernel source. You can use
<c>genkernel</c> to build a generic kernel similar to the one used by the
Installation CD, or you can perform a manual configuration to best suit your
@@ -172,14 +165,13 @@
Now go to <c>File Systems</c> and select support for the filesystems you use.
<e>Don't</e> compile them as modules, otherwise your Gentoo system will not be
able to mount your partitions. Also select <c>/proc file system</c> and
-<c>Virtual memory</c>. Do <e>not</e> select the <c>/dev file system</c>.
+<c>Virtual memory</c>.
</p>
<pre caption="Selecting necessary file systems">
File systems --->
Pseudo Filesystems --->
[*] /proc file system support
- [ ] /dev file system support (OBSOLETE)
[*] Virtual memory file system support (former shm fs)
<comment>(Select one or more of the following options as needed by your
system)</comment>
@@ -315,18 +307,9 @@
</p>
<pre caption="Installing the kernel">
-<comment>replace 2.6.12 with your kernel-version</comment>
-(Apple/IBM) # <i>cp vmlinux /boot/kernel-2.6.12</i>
-(Pegasos) # <i>cp arch/ppc/boot/images/zImage.chrp /boot/kernel-2.6.12</i>
-</pre>
-
-<p>
-It is also wise to copy over your kernel configuration file to
-<path>/boot</path>, just in case :)
-</p>
-
-<pre caption="Backing up your kernel configuration">
-# <i>cp .config /boot/config-2.6.12-gentoo-r4</i>
+<comment>replace <kernel-version> with your kernel version</comment>
+(Apple/IBM) # <i>cp vmlinux /boot/<kernel-version></i>
+(Pegasos) # <i>cp arch/ppc/boot/images/zImage.chrp
/boot/<kernel-version></i>
</pre>
<p>
1.22 +19 -39 xml/htdocs/doc/en/handbook/hb-install-ppc64-kernel.xml
file :
http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-ppc64-kernel.xml?rev=1.22&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain:
http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-ppc64-kernel.xml?rev=1.22&content-type=text/plain&cvsroot=gentoo
diff :
http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-ppc64-kernel.xml.diff?r1=1.21&r2=1.22&cvsroot=gentoo
Index: hb-install-ppc64-kernel.xml
===================================================================
RCS file:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-kernel.xml,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -r1.21 -r1.22
--- hb-install-ppc64-kernel.xml 24 Nov 2005 17:26:10 -0000 1.21
+++ hb-install-ppc64-kernel.xml 8 Jan 2006 14:05:29 -0000 1.22
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
-<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-kernel.xml,v
1.21 2005/11/24 17:26:10 neysx Exp $ -->
+<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-kernel.xml,v
1.22 2006/01/08 14:05:29 neysx Exp $ -->
<sections>
-<version>2.9</version>
-<date>2005-11-24</date>
+<version>2.10</version>
+<date>2006-01-06</date>
<section>
<title>Timezone</title>
@@ -47,18 +47,21 @@
<p>
For PPC64 you should use <c>gentoo-sources</c>. So let's continue with
-<c>emerge</c>'ing the kernel sources.
-The <c>USE="-doc"</c> is necessary to avoid installing xorg-x11 or other
-dependencies at this point:
+<c>emerge</c>'ing the kernel sources. The <c>USE="-doc"</c> is necessary to
+avoid installing xorg-x11 or other dependencies at this point.
+<c>USE="symlink"</c> is not necessary for a new install, but ensures proper
+creation of the <path>/usr/src/linux</path> symlink.
</p>
<pre caption="Installing a kernel source">
-# <i>USE="-doc" emerge gentoo-sources</i>
+# <i>USE="-doc symlink" emerge gentoo-sources</i>
</pre>
<p>
-When you take a look in <path>/usr/src</path> you should see a symlink
-called <path>linux</path> pointing to your kernel source:
+When you take a look in <path>/usr/src</path> you should see a symlink called
+<path>linux</path> pointing to your kernel source. In this case, the installed
+kernel source points to <c>gentoo-sources-2.6.12-r10</c>. Your version may be
+different, so keep this in mind.
</p>
<pre caption="Viewing the kernel source symlink">
@@ -67,17 +70,6 @@
</pre>
<p>
-If this isn't the case (i.e. the symlink points to a different kernel
-source) change the symlink before you continue:
-</p>
-
-<pre caption="Changing the kernel source symlink">
-# <i>rm /usr/src/linux</i>
-# <i>cd /usr/src</i>
-# <i>ln -s linux-2.6.12-gentoo-r10 linux</i>
-</pre>
-
-<p>
Now it is time to configure and compile your kernel source. There is the
ability to use "genkernel" which would create a generic kernel like the
ones used on the installation CDs, but it is not fully functional for PPC64 at
@@ -151,20 +143,16 @@
</pre>
<p>
-Now go to <c>File Systems</c> and select support for the filesystems you
-use. <e>Don't</e> compile them as modules, otherwise your Gentoo system
-will not be able to mount your partitions. Also select <c>Virtual
-memory</c>, <c>/proc file system</c>, <c>/dev file system</c> +
-<c>Automatically mount at boot</c> and <c>/dev/pts file system for
-Unix98 PTYs</c>:
+Now go to <c>File Systems</c> and select support for the filesystems you use.
+<e>Don't</e> compile them as modules, otherwise your Gentoo system will not be
+able to mount your partitions. Also select <c>Virtual memory</c>, <c>/proc file
+system</c>, and <c>/dev/pts file system for Unix98 PTYs</c>:
</p>
<pre caption="Selecting necessary file systems">
File systems --->
[*] Virtual memory file system support (former shm fs)
[*] /proc file system support
- [*] /dev file system support (EXPERIMENTAL)
- [*] Automatically mount at boot
[*] /dev/pts file system for Unix98 PTYs
<comment>(Select one or more of the following options as needed by your
system)</comment>
@@ -236,20 +224,12 @@
<p>
When the kernel has finished compiling, copy the kernel image to
-<path>/boot</path>.
+<path>/boot</path>. Remember to replace <path><kernel-version<</path>
+with your actual kernel version:
</p>
<pre caption="Installing the kernel">
-(Apple/IBM) # <i>cp vmlinux /boot/kernel-2.6.12-gentoo-r10</i>
-</pre>
-
-<p>
-It is also wise to copy over your kernel configuration file to
-<path>/boot</path>, just in case :)
-</p>
-
-<pre caption="Backing up your kernel configuration">
-# <i>cp .config /boot/config-2.6.12-gentoo-r10</i>
+(Apple/IBM) # <i>cp vmlinux /boot/<kernel-version></i>
</pre>
<p>
1.22 +21 -38 xml/htdocs/doc/en/handbook/hb-install-sparc-kernel.xml
file :
http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-sparc-kernel.xml?rev=1.22&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain:
http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-sparc-kernel.xml?rev=1.22&content-type=text/plain&cvsroot=gentoo
diff :
http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-sparc-kernel.xml.diff?r1=1.21&r2=1.22&cvsroot=gentoo
Index: hb-install-sparc-kernel.xml
===================================================================
RCS file:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-kernel.xml,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -r1.21 -r1.22
--- hb-install-sparc-kernel.xml 24 Nov 2005 17:26:10 -0000 1.21
+++ hb-install-sparc-kernel.xml 8 Jan 2006 14:05:29 -0000 1.22
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
-<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-kernel.xml,v
1.21 2005/11/24 17:26:10 neysx Exp $ -->
+<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-kernel.xml,v
1.22 2006/01/08 14:05:29 neysx Exp $ -->
<sections>
-<version>2.6</version>
-<date>2005-11-24</date>
+<version>2.7</version>
+<date>2006-01-06</date>
<section>
<title>Timezone</title>
@@ -56,19 +56,22 @@
</p>
<p>
-In the next example we install the <c>sparc-sources</c>.
-Of course substitute with your choice of sources, this is merely an example.
-The <c>USE="-doc"</c> is necessary to avoid installing xorg-x11 or other
-dependencies at this point:
+In the next example we install the <c>sparc-sources</c>. Of course substitute
+with your choice of sources, this is merely an example. The <c>USE="-doc"</c>
+is necessary to avoid installing xorg-x11 or other dependencies at this point.
+<c>USE="symlink"</c> is not necessary for a new install, but ensures proper
+creation of the <path>/usr/src/linux</path> symlink.
</p>
<pre caption="Installing a kernel source">
-# <i>USE="-doc" emerge sparc-sources</i>
+# <i>USE="-doc symlink" emerge sparc-sources</i>
</pre>
<p>
When you take a look in <path>/usr/src</path> you should see a symlink called
-<path>linux</path> pointing to your kernel source:
+<path>linux</path> pointing to your kernel source. In this case, the installed
+kernel source points to <c>sparc-sources-2.4.31</c>. Your version may be
+different, so keep this in mind.
</p>
<pre caption="Viewing the kernel source symlink">
@@ -77,17 +80,6 @@
</pre>
<p>
-If this isn't the case (i.e. the symlink points to a different kernel source)
-change the symlink before you continue:
-</p>
-
-<pre caption="Changing the kernel source symlink">
-# <i>rm /usr/src/linux</i>
-# <i>cd /usr/src</i>
-# <i>ln -s linux-2.4.31-sparc linux</i>
-</pre>
-
-<p>
Now it is time to configure and compile your kernel source.
</p>
@@ -153,8 +145,9 @@
<p>
Now go to <c>File Systems</c> and select support for the filesystems you use.
<e>Don't</e> compile them as modules, otherwise your Gentoo system will not be
-able to mount your partitions. Also select <c>Virtual memory</c>, <c>/proc
-file system</c>, <c>/dev file system</c> + <c>Automatically mount at boot</c>:
+able to mount your partitions. Also select <c>Virtual memory</c> and <c>/proc
+file system</c>. If you are running a 2.4 kernel, you should also select
+<c>/dev file system</c> + <c>Automatically mount at boot</c>:
</p>
<pre caption="Selecting necessary file systems">
@@ -170,8 +163,6 @@
File systems --->
Pseudo Filesystems --->
[*] /proc file system support
- [*] /dev file system support (OBSOLETE)
- [*] Automatically mount at boot
[*] Virtual memory file system support (former shm fs)
<comment>(Select one or more of the following options as needed by your
system)</comment>
@@ -324,30 +315,22 @@
<p>
When the kernel has finished compiling, copy the kernel image to
-<path>/boot</path>.
+<path>/boot</path>. Remember to replace <path><kernel-version></path>
+with your actual kernel version.
</p>
<pre caption="Installing the kernel">
<comment>(For 2.4 kernel, sparc32)</comment>
-# <i>cp vmlinux /boot/kernel-2.4.29</i>
+# <i>cp vmlinux /boot/<kernel-version></i>
<comment>(For 2.4 kernel, sparc64)</comment>
-# <i>cp arch/sparc64/boot/image /boot/kernel-2.4.31</i>
+# <i>cp arch/sparc64/boot/image /boot/<kernel-version></i>
<comment>(For 2.6 kernel, sparc32)</comment>
-# <i>cp arch/sparc/boot/image /boot/kernel-2.6.11</i>
+# <i>cp arch/sparc/boot/image /boot/<kernel-version></i>
<comment>(For 2.6 kernel, sparc64)</comment>
-# <i>cp arch/sparc64/boot/image /boot/kernel-2.6.11</i>
-</pre>
-
-<p>
-It is also wise to copy over your kernel configuration file to
-<path>/boot</path>, just in case :)
-</p>
-
-<pre caption="Backing up your kernel configuration">
-# <i>cp .config /boot/config-2.4.31</i>
+# <i>cp arch/sparc64/boot/image /boot/<kernel-version></i>
</pre>
<p>
1.60 +19 -40 xml/htdocs/doc/en/handbook/hb-install-x86-kernel.xml
file :
http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-x86-kernel.xml?rev=1.60&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain:
http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-x86-kernel.xml?rev=1.60&content-type=text/plain&cvsroot=gentoo
diff :
http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-x86-kernel.xml.diff?r1=1.59&r2=1.60&cvsroot=gentoo
Index: hb-install-x86-kernel.xml
===================================================================
RCS file:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86-kernel.xml,v
retrieving revision 1.59
retrieving revision 1.60
diff -u -r1.59 -r1.60
--- hb-install-x86-kernel.xml 12 Dec 2005 15:53:35 -0000 1.59
+++ hb-install-x86-kernel.xml 8 Jan 2006 14:05:29 -0000 1.60
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
-<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86-kernel.xml,v 1.59
2005/12/12 15:53:35 neysx Exp $ -->
+<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86-kernel.xml,v 1.60
2006/01/08 14:05:29 neysx Exp $ -->
<sections>
-<version>3.10</version>
-<date>2005-12-12</date>
+<version>3.11</version>
+<date>2006-01-06</date>
<section>
<title>Timezone</title>
@@ -53,19 +53,22 @@
</p>
<p>
-Choose your kernel source and install it using <c>emerge</c>.
-The <c>USE="-doc"</c> is necessary to avoid installing xorg-x11 or other
-dependencies at this point:
+Choose your kernel source and install it using <c>emerge</c>. The
+<c>USE="-doc"</c> is necessary to avoid installing xorg-x11 or other
+dependencies at this point. <c>USE="symlink"</c> is not necessary for a new
+install, but ensures proper creation of the <path>/usr/src/linux</path>
+symlink.
</p>
<pre caption="Installing a kernel source">
-# <i>USE="-doc" emerge gentoo-sources</i>
+# <i>USE="-doc symlink" emerge gentoo-sources</i>
</pre>
<p>
When you take a look in <path>/usr/src</path> you should see a symlink called
-<path>linux</path> pointing to your kernel source. We will assume the kernel
-source installed is <c>gentoo-sources-2.6.12-r10</c>:
+<path>linux</path> pointing to your kernel source. In this case, the installed
+kernel source points to <c>gentoo-sources-2.6.12-r10</c>. Your version may be
+different, so keep this in mind.
</p>
<pre caption="Viewing the kernel source symlink">
@@ -74,18 +77,6 @@
</pre>
<p>
-If the symlink doesn't point to the kernel source of your choice (note that
-<c>linux-2.6.12-gentoo-r10</c> is merely an example) you should change it to
the
-right kernel:
-</p>
-
-<pre caption="Changing the kernel source symlink">
-# <i>rm /usr/src/linux</i>
-# <i>cd /usr/src</i>
-# <i>ln -s linux-2.6.12-gentoo-r10 linux</i>
-</pre>
-
-<p>
Now it is time to configure and compile your kernel source. You
can use <c>genkernel</c> for this, which will build a generic kernel as used
by the Installation CD. We explain the "manual" configuration first though, as
@@ -180,10 +171,8 @@
Now go to <c>File Systems</c> and select support for the filesystems you use.
<e>Don't</e> compile them as modules, otherwise your Gentoo system will not be
able to mount your partitions. Also select <c>Virtual memory</c> and <c>/proc
-file system</c>. If you are using a 2.6 kernel (default), do <e>not</e> select
-the <c>/dev file system</c>, Gentoo/x86 uses <c>udev</c> by default now. If you
-are using a 2.4 kernel, you still need to select <c>/dev file system</c> though
-as 2.4 kernels do not support <c>udev</c>.
+file system</c>. If you are using a 2.4 kernel, you need to select <c>/dev file
+system</c> as 2.4 kernels do not support <c>udev</c>.
</p>
<pre caption="Selecting necessary file systems">
@@ -199,7 +188,6 @@
File systems --->
Pseudo Filesystems --->
[*] /proc file system support
- [ ] /dev file system support (OBSOLETE)
[*] Virtual memory file system support (former shm fs)
<comment>(Select one or more of the following options as needed by your
system)</comment>
@@ -341,23 +329,14 @@
<p>
When the kernel has finished compiling, copy the kernel image to
-<path>/boot</path>. From here onwards we assume that the kernel you are
-installing is the 2.6.12-r10 version of the <c>gentoo-sources</c>. Use
whatever
-name you feel is appropriate for your choice and remember it as you will need
it
-later on when you configure your bootloader.
+<path>/boot</path>. Use whatever name you feel is appropriate for your kernel
+choice and remember it as you will need it later on when you configure your
+bootloader. Remember to replace <path><kernel-version></path> with the
name and
+version of your kernel.
</p>
<pre caption="Installing the kernel">
-# <i>cp arch/i386/boot/bzImage /boot/kernel-2.6.12-gentoo-r10</i>
-</pre>
-
-<p>
-It is also wise to copy over your kernel configuration file to
-<path>/boot</path>, just in case :)
-</p>
-
-<pre caption="Backing up your kernel configuration">
-# <i>cp .config /boot/config-2.6.12-gentoo-r10</i>
+# <i>cp arch/i386/boot/bzImage /boot/<kernel-version></i>
</pre>
<p>
--
[email protected] mailing list
