[gentoo-doc-cvs] cvs commit: hb-install-ppc-kernel.xml

[Joseph Jezak]

josejx      05/07/28 16:53:20

  Modified:    xml/htdocs/doc/en/handbook/draft/2005.1
                        hb-install-ppc-kernel.xml
  Log:
  Yoswink, please don't stab me. (PPC 2005.1 handbook updates.)

Revision  Changes    Path
1.2       +90 -47    xml/htdocs/doc/en/handbook/draft/2005.1/hb-install-ppc-kernel.xml

file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2005.1/hb-install-ppc-kernel.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2005.1/hb-install-ppc-kernel.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2005.1/hb-install-ppc-kernel.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo

Index: hb-install-ppc-kernel.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2005.1/hb-install-ppc-kernel.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- hb-install-ppc-kernel.xml	5 Jul 2005 08:02:04 -0000	1.1
+++ hb-install-ppc-kernel.xml	28 Jul 2005 16:53:20 -0000	1.2
@@ -4,7 +4,7 @@
 <!-- The content of this document is licensed under the CC-BY-SA license -->
 <!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
 
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2005.1/hb-install-ppc-kernel.xml,v 1.1 2005/07/05 08:02:04 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2005.1/hb-install-ppc-kernel.xml,v 1.2 2005/07/28 16:53:20 josejx Exp $ -->
 
 <sections>
 
@@ -44,11 +44,10 @@
 </p>
 
 <p>
-For PPC you can choose between <c>vanilla-sources</c> and
-<c>gentoo-sources</c> (both 2.6 kernels). The latter is available when you
-perform a networkless installation.  Beside those there is a special
-kernel-2.6-patchset for the Pegasos: <c>pegasos-sources</c>.  So let's
-continue with <c>emerge</c>'ing the kernel sources:
+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:
 </p>
 
 <pre caption="Installing a kernel source">
@@ -56,32 +55,31 @@
 </pre>
 
 <note>
-The PowerPC sources are based on a 2.6.10-kernel with security patches from
-2.6.11 backported.  As the time of the release the 2.6.11 kernel produced
-several problems on different PowerPC machines.
+The suggested sources at the time of the 2005.1 release are 
+<c>gentoo-sources-2.6.12-r6</c> and <c>vanilla-sources-2.6.12.2</c>.
 </note>
 
 <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.10-r8</c>:
+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-r6</c>:
 </p>
 
 <pre caption="Viewing the kernel source symlink">
 # <i>ls -l /usr/src/linux</i>
-lrwxrwxrwx    1 root     root           22  Mar 18 16:23 /usr/src/linux -&gt; linux-2.6.10-gentoo-r8
+lrwxrwxrwx    1 root     root           22  Mar 18 16:23 /usr/src/linux -&gt; linux-2.6.12-gentoo-r6
 </pre>
 
 <p>
 If the symlink doesn't point to the kernel source of your choice (note that
-<c>linux-2.6.10-gentoo-r8</c> is merely an example) you should change it to the
-right kernel:
+<c>linux-2.6.12-gentoo-r6</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.10-gentoo-r8 linux</i>
+# <i>ln -s linux-2.6.12-gentoo-r6 linux</i>
 </pre>
 
 <p>
@@ -122,7 +120,10 @@
 /sys/bus/pci/devices) that <c>lspci</c> throws out. Alternatively, you can run 
 <c>lspci</c> from a <e>non-chrooted</e> environment. The results are the same. 
 You can also run <c>lsmod</c> to see what kernel modules the Installation CD 
-uses (it might provide you with a nice hint on what to enable).
+uses (it might provide you with a nice hint on what to enable).  Another place
+to look for clues as to what components to enable is to check the kernel
+message logs from the successful boot that got you this far.  Type <c>dmesg</c>
+to see the kernel messages.
 </p>
 
 <p>
@@ -205,36 +206,52 @@
 </p>
 
 <p>
-Disable ADB raw keycodes:
+Users of NewWorld and OldWorld machines will want HFS support as well.  OldWorld
+users require it for copying compiled kernels to the MacOS partition. NewWorld
+users require it for configuring the special Apple_Bootstrap partition:
 </p>
 
-<pre caption="Disabling ADB raw keycodes">
-Macintosh Device Drivers ---&gt;
-  [ ] Support for ADB raw keycodes
+<pre caption="Activating HFS support">
+File Systems ---&gt;
+  [*] HFS Support
 </pre>
 
 <p>
-Also choose the correct RTC support (<e>disable</e> the <c>Enhanced RTC</c> 
-option):
+At this time, kernel preemption is still unstable on PPC and may cause 
+compilation failures and random segfaults.  It is <e>strongly</e> suggested
+that you do not use this feature.
 </p>
 
-<pre caption="Activating the correct RTC option">
-Character devices ---&gt;
-  [ ] Enhanced RTC
+<pre caption="Ensure the Preemptible Kernel Option is Off">
+Platform options ---&gt;
+  [ ] Preemptible Kernel
+</pre>
+
+<p>
+If you're booting from Firewire, you'll need to enable these options.  If you donot want to compile in support, you'll need to include these modules and their
+dependencies in an initrd.
+</p>
 
-General setup ---&gt;
-  [*] Support for /dev/rtc
+<pre caption="Enable support for firewire devices on boot">
+Device Drivers ---&gt;
+  IEEE 1394 (FireWire) support ---&gt;
+    &lt;*&gt; IEEE 1394 (FireWire) support
+    &lt;*&gt;   OHCI-1394 support
+    &lt;*&gt;   SBP-2 support (Harddisks etc.)
 </pre>
 
 <p>
-Users of OldWorld machines will want HFS support so they can copy compiled
-kernels to the MacOS partition.  This applies also to NewWorld machines as it is
-needed for the special Apple_Bootstrap partition:
+If you're booting from USB, you'll need to enable these options.  If you do not
+want to compile in support, you'll need to include these modules and their
+dependencies in an initrd.
 </p>
 
-<pre caption="Activating HFS support">
-File Systems ---&gt;
-  [*] HFS Support
+<pre caption="Enable support for USB devices on boot">
+Device Drivers ---&gt;
+  USB support ---&gt;
+    &lt;*&gt; Support for Host-side USB
+    &lt;*&gt;   OHCI HCD support
+    &lt;*&gt;   USB Mass Storage support
 </pre>
 
 <p>
@@ -254,7 +271,7 @@
 </p>
 
 <pre caption="Compiling the kernel">
-# <i>make all &amp;&amp; make modules_install</i>
+# <i>make &amp;&amp; make modules_install</i>
 </pre>
 
 <p>
@@ -263,9 +280,9 @@
 </p>
 
 <pre caption="Installing the kernel">
-<comment>replace 2.6.10 with your kernel-version</comment>
-(Apple/IBM)  # <i>cp vmlinux /boot/kernel-2.6.10</i>
-(Pegasos)    # <i>cp arch/ppc/boot/images/zImage.chrp /boot/kernel-2.6.10</i>
+<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>
@@ -274,7 +291,7 @@
 </p>
 
 <pre caption="Backing up your kernel configuration">
-# <i>cp .config /boot/config-2.6.10-gentoo-r8</i>
+# <i>cp .config /boot/config-2.6.12-gentoo-r6</i>
 </pre>
 
 <p>
@@ -367,21 +384,36 @@
 </pre>
 
 <p>
-Now, compile your kernel sources by running <c>genkernel --udev all</c>.
-Be aware though, as <c>genkernel</c> compiles a kernel that supports almost all 
-hardware, this compilation will take quite a while to finish!
+If you are using firewire or USB to boot, you'll need to add modules to the 
+initrd.  Edit <path>/usr/share/genkernel/ppc/modules_load</path> and change
+<c>MODULES_FIREWIRE="ieee1394 ohci1394 sbp2"</c> for firewire support or
+<c>MODULES_USB="usbcore ohci-hcd ehci-hcd usb-storage"</c> for USB support.



-- 
gentoo-doc-cvs@g.o mailing list