From mboxrd@z Thu Jan 1 00:00:00 1970
Received: from lists.gentoo.org ([140.105.134.102] helo=robin.gentoo.org)
by nuthatch.gentoo.org with esmtp (Exim 4.54)
id 1FAWW1-0000VF-4w
for garchives@archives.gentoo.org; Sat, 18 Feb 2006 18:09:06 +0000
Received: from robin.gentoo.org (localhost [127.0.0.1])
by robin.gentoo.org (8.13.5/8.13.5) with SMTP id k1II8nrm017215;
Sat, 18 Feb 2006 18:08:49 GMT
Received: from smtp.gentoo.org (smtp.gentoo.org [134.68.220.30])
by robin.gentoo.org (8.13.5/8.13.5) with ESMTP id k1II8lOs025847
for <gentoo-doc-cvs@lists.gentoo.org>; Sat, 18 Feb 2006 18:08:48 GMT
Message-Id: <200602181808.k1II8lOs025847@robin.gentoo.org>
Received: from lark.gentoo.osuosl.org ([140.211.166.177] helo=lark)
by smtp.gentoo.org with smtp (Exim 4.54)
id 1FAWVi-0000Ef-Pd
for gentoo-doc-cvs@lists.gentoo.org; Sat, 18 Feb 2006 18:08:47 +0000
Received: by lark (sSMTP sendmail emulation); Sat, 18 Feb 2006 18:08:46 +0000
From: "Joseph Jezak" <josejx@lark.gentoo.org>
Date: Sat, 18 Feb 2006 18:08:46 +0000
To: gentoo-doc-cvs@lists.gentoo.org
Subject: [gentoo-doc-cvs] cvs commit: gentoo-ppc-faq.xml
Precedence: bulk
List-Post: <mailto:gentoo-doc-cvs@lists.gentoo.org>
List-Help: <mailto:gentoo-doc-cvs+help@gentoo.org>
List-Unsubscribe: <mailto:gentoo-doc-cvs+unsubscribe@gentoo.org>
List-Subscribe: <mailto:gentoo-doc-cvs+subscribe@gentoo.org>
List-Id: Gentoo Linux mail <gentoo-doc-cvs.gentoo.org>
X-BeenThere: gentoo-doc-cvs@gentoo.org
Reply-to: docs-team@lists.gentoo.org
X-Archives-Salt: a225bfc2-080f-4118-955e-e9253015cf5a
X-Archives-Hash: 5209d30f72209c4d30cba7d84b9a024f
josejx 06/02/18 18:08:46
Modified: xml/htdocs/doc/en gentoo-ppc-faq.xml
Log:
PPC FAQ Update.
Revision Changes Path
1.46 +210 -89 xml/htdocs/doc/en/gentoo-ppc-faq.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-ppc-faq.xml?rev=1.46&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-ppc-faq.xml?rev=1.46&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-ppc-faq.xml.diff?r1=1.45&r2=1.46&cvsroot=gentoo
Index: gentoo-ppc-faq.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-ppc-faq.xml,v
retrieving revision 1.45
retrieving revision 1.46
diff -u -r1.45 -r1.46
--- gentoo-ppc-faq.xml 4 Jan 2006 22:51:33 -0000 1.45
+++ gentoo-ppc-faq.xml 18 Feb 2006 18:08:45 -0000 1.46
@@ -1,6 +1,6 @@
<?xml version='1.0' encoding="UTF-8"?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-ppc-faq.xml,v 1.45 2006/01/04 22:51:33 josejx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-ppc-faq.xml,v 1.46 2006/02/18 18:08:45 josejx Exp $ -->
<guide link="/doc/en/gentoo-ppc-faq.xml">
<title>Gentoo Linux/PowerPC Frequently Asked Questions</title>
@@ -27,8 +27,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>1.24</version>
-<date>2006-01-04</date>
+<version>1.25</version>
+<date>2006-02-18</date>
<chapter>
<title>Questions</title>
@@ -51,6 +51,12 @@
<ul>
<li>
+ <uri link="#powerpc">
+ What kind of PPC computer do I have and where can I find more information
+ about it?
+ </uri>
+ </li>
+ <li>
<uri link="#osxverify">How can I verify with OSX that the downloaded ISO
is not corrupted?</uri>
</li>
@@ -123,9 +129,7 @@
</uri>
</li>
<li>
- <uri link="#modem">
- Will the internal modem in an work?
- </uri>
+ <uri link="#modem">Will the internal modem work?</uri>
</li>
<li>
<uri link="#sleep">Does sleep work on my iBook/PowerBook?</uri>
@@ -168,11 +172,17 @@
<uri link="#java">Does Gentoo/PPC have a Java plugin?</uri>
</li>
<li>
- <uri link="#xconf">Is there an easy way to configure X?</uri>
+ <uri link="#xorg">
+ Is there an easy way to configure X?
+ </uri>
+ </li>
+ <li>
+ <uri link="#drm">How do I configure DRM and OpenGL acceleration?</uri>
</li>
<li>
- <uri link="#drm">
- How can I enable Direct Rendering (DRM) on rage128 or radeon cards?
+ <uri link="#glfreeze">
+ When using OpenGL DRI or playing movies, the system sometimes locks up
+ unexpectedly. What can I do?
</uri>
</li>
<li>
@@ -185,16 +195,10 @@
</uri>
</li>
<li>
- <uri link="#glfreeze">
- When using OpenGL DRI or playing movies, the system sometimes locks up
- unexpectedly. What can I do?
- </uri>
- </li>
- <li>
<uri link="#audiocd">How do I play Audio CDs?</uri>
</li>
<li>
- <uri link="#mol">Can I run Mac OS 9 or Mac OS X under Gentoo Linux?</uri>
+ <uri link="#mol">Can I run Mac OS 9 or Mac OS X while running Linux?</uri>
</li>
<li>
<uri link="#ext">Can I access my ext2/ext3 partitions from OSX?</uri>
@@ -237,6 +241,52 @@
<chapter>
<title>Installation</title>
+<section id="powerpc">
+<title>
+What kind of PowerPC computer do I have and where can I find more information
+about it?
+</title>
+<body>
+
+<p>
+Welcome to Gentoo PPC! The PowerPC processor has been used in a number of
+popular computing devices, here are some links to help you figure out what
+type of hardware is in the machine on your desk.
+</p>
+
+<ul>
+ <li>
+ <uri link="http://www.info.apple.com/support/applespec.html">
+ Apple Product Pages
+ </uri>
+ </li>
+ <li>
+ <uri link="http://lowendmac.com/profiles.htm">
+ Apple Product History and Details
+ </uri>
+ </li>
+ <li>
+ <uri link="http://www.pegasosppc.com/products.php">
+ Genesi Model Information
+ </uri>
+ </li>
+ <li>
+ <uri link="http://publib.boulder.ibm.com/infocenter/pseries/v5r3/index.jsp?topic=/com.ibm.pseries.doc/hardware_docs/selectbysystem.htm">
+ IBM Documentation by Model
+ </uri>
+ </li>
+ <li>
+ <uri link="http://kurobox.com/">KuroBox</uri>
+ </li>
+ <li>
+ <uri link="http://penguinppc.org/">
+ PenguinPPC - Linux on PowerPC Information
+ </uri>
+ </li>
+</ul>
+
+</body>
+</section>
<section id="osxverify">
<title>How can I verify with OSX that the downloaded ISO is not corrupted?</title>
<body>
@@ -275,7 +325,7 @@
Yes you can! In fact, <e>yabootconfig</e> will automatically detect and setup
<path>/etc/yaboot.conf</path> with Linux, Mac OS X and even classic Mac OS (see
the <uri link="/doc/en/handbook/handbook-ppc.xml?part=1&chap=10">Gentoo
-Handbook </uri> for details on yabootconfig). The trick is in how you partition
+Handbook</uri> for details on yabootconfig). The trick is in how you partition
your hard drive. Before installing Gentoo, startup with the Mac OS X Install
CD. Use the <c>Disk Utility</c> to partition the drive in your machine into two
or three partitions. Alternatively, use <c>parted</c> from a recent Gentoo
@@ -387,17 +437,17 @@
<section id="fstabboot">
<title>
My /etc/fstab file has /dev/BOOT in it. Do I need to setup this line for my
-bootstrap partition?
+Apple bootstrap partition?
</title>
<body>
<p>
-No. If you are not running a separate boot partition (<path>/boot</path>) then
+No. If you are not using a separate boot partition (<path>/boot</path>) then
you do not need this line and can safely just delete it from
-<path>/etc/fstab</path>. The bootstrap partition is <e>not</e>
-<path>/boot</path> and is not related in anyway. In general, PowerPC machines
-do not need a separate <path>/boot</path> partition, and the bootstrap
-partition should not be mounted.
+<path>/etc/fstab</path>. The Apple bootstrap partition is <e>not</e>
+<path>/boot</path> and is not related in any way. In general, Apple PowerPC
+machines do not need a separate <path>/boot</path> partition, and the bootstrap
+partition should not be mounted or referred to in your fstab.
</p>
</body>
@@ -442,23 +492,25 @@
<ul>
<li>
<e>pbbuttonsd</e> is a tool that enables the brightness and volume keys on
- most ppc laptops. The current versions also work as a powermanager.
+ most ppc laptops as well as other apple laptop specific functionality. The
+ current versions also work as a power manager and replace <e>pmud</e>.
</li>
<li>
- <e>gtkpbbuttons</e> gives you a gtk front end for pbbuttonsd (visual
+ <e>gtkpbbuttons</e> provides a gtk frontend for pbbuttonsd (visual
feedback on button presses in X). <e>gtkpbbuttons</e> requires gtk and
- should be added to your X session file (<path>~/.Xsession</path>) for best
- results (so that it is always running while in X).
+ should be started when X is started.
</li>
<li>
- <e>powerprefs</e> ties together with pbbuttonsd, and gives you the ability
- to edit settings such as power-management, trackpad options and various
- other preferences.
+ <e>powerprefs</e> provides a graphical configuration editing tool for
+ configuring pbbuttonsd including settings such as power-management, trackpad
+ options and various other preferences.
</li>
<li>
<e>powernowd</e> allows cpu speed scaling for longer battery life. Other
packages also provide the same functionality, such as <e>cpudyn</e>,
- <e>cpufreqd</e> and <e>speedfreq</e>.
+ <e>cpufreqd</e> and <e>speedfreq</e>. It doesn't really matter which you
+ chose, just ensure that you have the <e>userspace</e> cpu frequency
+ scaling governor enabled in your kernel.
</li>
</ul>
@@ -475,16 +527,16 @@
</pre>
<note>
-You should edit <path>/etc/pbbuttonsd.conf</path> to better suit your needs.
-The behaviour of the Fx-keys can be controlled here as well as many sleep
-options. To switch the Fx-keys to the OSX behaviour, set KBDMode to fkeyslast.
-You can turn off touchpad tapping by setting TPMode to notap. Many other
-options are available, see man pbbuttonsd.conf for details.
+You should edit <path>/etc/pbbuttonsd.conf</path> or use <e>powerprefs</e> to
+better suit your needs. The behaviour of the Fx-keys can be controlled here as
+well as many sleep options. To switch the Fx-keys to the OSX behaviour, set
+KBDMode to fkeyslast. You can turn off touchpad tapping by setting TPMode to
+notap. Many other options are available, see man pbbuttonsd.conf for details.
</note>
<p>
-It is useful to add pbbuttonsd and powernowd to your boot runlevel so that they're
-started when your computer starts. To do this:
+It is useful to add pbbuttonsd and powernowd to your boot runlevel so that
+they're started when your computer starts. To do this:
</p>
<pre caption="Adding pbbuttonsd and cpudyn to the boot runlevel">
@@ -549,8 +601,8 @@
<body>
<p>
-The Airport card is based on the Lucent Orinoco chipset. To use this card in
-Linux, enable these kernel options:
+The Airport card is an 802.11b device based on the Lucent Orinoco chipset. To
+use this card in Linux, enable these kernel options:
</p>
<pre caption="Wireless LAN">
@@ -574,7 +626,8 @@
</pre>
<p>
-For more details on iwconfig, refer to its man page.
+For a generic guide to setting up wireless with Gentoo, please see the
+<uri link="http://www.gentoo.org/doc/en/handbook/handbook-ppc.xml?part=4&chap=4">Gentoo Wireless Guide</uri>.
</p>
</body>
@@ -584,17 +637,26 @@
<body>
<p>
-With the release of the native <uri link="http://bcm43xx.berlios.de">bcm43xx
-driver</uri>, using the Airport Extreme in Linux is now possible! Until the
-driver is added to the kernel, please see this
+The Airport Extreme is an 802.11b/g card that is included with modern Apple
+portable computers. It is based on the Broadcom 43xx chipset which is supported
+by the native <uri link="http://bcm43xx.berlios.de">bcm43xx driver</uri>
+project. Until this driver is added to the kernel, you can use the ebuild in
+portage.
+</p>
+
+<pre caption="Emerge the bcm43xx driver">
+# <i>emerge bcm43xx</i>
+</pre>
+
+<p>
+For additional information, please see this
<uri link="http://forums.gentoo.org/viewtopic-t-409194.html">forum post</uri>
for details.
</p>
<p>
-You can also use MOL and OSX to give Linux access to your Airport Extreme card,
-please see this <uri link="http://forums.gentoo.org/viewtopic-t-365647.html">
-forum post</uri> for details.
+For a generic guide to setting up wireless with Gentoo, please see the
+<uri link="http://www.gentoo.org/doc/en/handbook/handbook-ppc.xml?part=4&chap=4">Gentoo Wireless Guide</uri>.
</p>
</body>
@@ -678,6 +740,11 @@
your kernel.
</note>
+<impo>
+If you compile in ALSA support, you need to also compile in i2c Keywest support.
+Failure to do this will result in kernel panics on boot!
+</impo>
+
</body>
</section>
<section id="alsa">
@@ -791,14 +858,22 @@
been tested on PPC or it has been tested, but hasn't yet been marked stable.
</p>
+<pre caption="The Package Hasn't Been Tested on PPC">
+!!! All ebuilds that could satisfy "bar" have been masked.
+!!! One of the following masked packages is required to complete your request:
+- app-foo/bar-1.0 (masked by: missing keyword)
+</pre>
+
<p>
If your package hasn't yet been tested on PPC, you'll need to first mark the
ebuild with the ppc keyword. This is done using the ekeyword tool which is part
-of the gentoolkit-dev package. To mark the ebuild ppc:
+of the gentoolkit-dev package. To mark the ebuild ppc and re-digest it to
+reflect the changes:
</p>
<pre caption="Adding the ppc keyword to app-foo/bar">
-$ <i>ekeyword ppc /usr/portage/app-foo/bar/bar-1.0.ebuild</i>
+# <i>ekeyword ppc /usr/portage/app-foo/bar/bar-1.0.ebuild</i>
+# <i>ebuild /usr/portage/app-foo/bar/bar-1.0.ebuild digest</i>
</pre>
<p>
@@ -810,13 +885,20 @@
<note>
This change will only last until the next sync. If you need a more permanent
fix, you can maintain a portage overlay. See the portage documentation for more
-information.
+information on maintaining an overlay.
</note>
+<pre caption="The Package Hasn't Been Marked Stable on PPC">
+!!! All ebuilds that could satisfy "bar" have been masked.
+!!! One of the following masked packages is required to complete your request:
+- app-foo/bar-1.0 (masked by: ~ppc keyword)
+</pre>
+
<p>
If your package already has the ~ppc keyword, you have two options. Either
follow the above instructions and replace the ~ppc keyword with ppc, or you can
-use /etc/portage to unmask the specific package.
+use /etc/portage to unmask the specific package. The second option is
+preferred simply because it won't be undone by an emerge sync.
</p>
<pre caption="Using /etc/portage to unmask app-foo/bar">
@@ -828,8 +910,8 @@
</note>
<p>
-Now emerge the package as normal. Once you're sure the app is stable, <b>please
-</b> report this as a bug so the developers can add the keyword.
+Now emerge the package as normal. Once you're sure the app is stable, i
+<b>please</b> report this as a bug so the developers can add the keyword.
</p>
</body>
@@ -840,14 +922,26 @@
<p>
Well, not really. Macromedia has not supplied a linux/ppc binary and open
-source implementations are incomplete and buggy at this time. Two projects that
-are working on this problem are <uri
-link="http://gplflash.sf.net">gplflash2</uri> and <uri
-link="http://swfdec.sf.net">swfdec</uri>, so check with these projects for more
-information. A possible workaround for now is to use qemu (an x86 emulator) to
-run the Macromedia Flash Player 6 stand alone player. This process was
-described on the forums:
-<uri>http://forums.gentoo.org/viewtopic.php?t=117774</uri>
+source implementations are incomplete and buggy at this time. Three projects
+that are working on this problem are:
+</p>
+
+<ul>
+ <li>
+ <uri link="http://www.gnu.org/software/gnash/">gnash</uri>
+ </li>
+ <li>
+ <uri link="http://gplflash.sf.net">gplflash2</uri>
+ </li>
+ <li>
+ <uri link="http://swfdec.sf.net">swfdec</uri>
+ </li>
+</ul>
+
+<p>
+Another possible workaround for now is to use qemu (an x86 emulator) to run the
+Macromedia Flash Player 6 stand alone player. This process was described in the
+forums: <uri>http://forums.gentoo.org/viewtopic.php?t=117774</uri>
</p>
</body>
@@ -857,12 +951,13 @@
<body>
<p>
-Yes, a Java plugin is now available with IBM's Java 1.5 beta.
+Yes, a Java plugin is now available with IBM's Java 1.5. Note that not all
+Java applications work with Java 1.5 yet.
</p>
</body>
</section>
-<section id="xconf">
+<section id="xorg">
<title>Is there an easy way to configure X?</title>
<body>
@@ -877,30 +972,46 @@
</body>
</section>
<section id="drm">
-<title>
-How can I enable Direct Rendering (DRM) on rage128 or radeon cards?
-</title>
+<title>What kernel options are required for DRM?</title>
<body>
<p>
Make sure in your kernel config you have the following options set:
</p>
-<pre caption="DRM kernel configuration">
+<pre caption="Rage128 DRM kernel configuration">
Device Drivers - Character devices --->
<*> /dev/agpgart (AGP Support)
[*] Apple UniNorth support
[*] Direct Rendering Manager (DRI support)
<*> ATI Rage 128
- <*> ATI Radeon
Device Drivers - Graphics Support --->
<*> ATI Rage 128 display support
+</pre>
+
+<pre caption="Radeon DRM kernel configuration">
+Device Drivers - Character devices --->
+ <*> /dev/agpgart (AGP Support)
+ [*] Apple UniNorth support
+ [*] Direct Rendering Manager (DRI support)
+ <*> ATI Radeon
+Device Drivers - Graphics Support --->
<*> ATI Radeon display support
</pre>
+<pre caption="nVidia kernel configuration">
+Device Drivers - Graphics Support --->
+ <*> nVidia Framebuffer Support
+</pre>
+
+<note>
+There is currently no support for DRM on nVidia cards since nVidia has not
+released any drivers for PPC and there are no open drivers for 3D acceleration.
+</note>
+
<p>
Rebuild and install the kernel if necessary. After this, make sure you
-have booted to the native framebuffer (i.e. radeonfb or atyfb and
+have booted to the native framebuffer (i.e. radeonfb or atyfb128 and
<e>not</e> from offb or ofonly video), and run <c>Xorgautoconfig</c>.
</p>
@@ -922,23 +1033,6 @@
</body>
</section>
-<section id="keymap">
-<title>
-I recently emerged Xorg, but when using it, my international keyboard layout
-does not work correctly. The main keys work fine but I am unable to compose
-special characters like the "at" sign. The startx output says something like
-"could not load keymap, falling back to default keymap". What is wrong?
-</title>
-<body>
-
-<p>
-Check that the permissions on <path>/var/tmp</path> are set to
-<path>drwxrwxrwx</path>. If not, change them by typing <c>chmod a+rwx
-/var/tmp</c>. This will allow Xorg to load keymaps properly again.
-</p>
-
-</body>
-</section>
<section id="glfreeze">
<title>
When using OpenGL DRI or playing movies, the system sometimes freezes hard
@@ -957,8 +1051,30 @@
</pre>
<p>
-Also, there are some known issues with the composite extensions included with the
-newer X.org releases. Please disable this extension if you're having problems.
+Also, there are some known issues with the composite extension, please disable
+this extension if you're having problems.
+</p>
+
+<p>
+Finally, if you are still having trouble, please try disabling dri in your
+xorg.conf and see if the problems go away.
+</p>
+
+</body>
+</section>
+<section id="keymap">
+<title>
+I recently emerged Xorg, but when using it, my international keyboard layout
+does not work correctly. The main keys work fine but I am unable to compose
+special characters like the "at" sign. The startx output says something like
+"could not load keymap, falling back to default keymap". What is wrong?
+</title>
+<body>
+
+<p>
+Check that the permissions on <path>/var/tmp</path> are set to
+<path>drwxrwxrwx</path>. If not, change them by typing <c>chmod a+rwx
+/var/tmp</c>. This will allow Xorg to load keymaps properly again.
</p>
</body>
@@ -1000,10 +1116,15 @@
link="http://www.maconlinux.org/">Mac-on-Linux</uri> which allows you to run an
instance of OS 9, OS X or Linux as a process on Linux. Simply <c>emerge mol</c>
to install this package. MOL supports Mac OS 7.5.2 to 9.2.2, as well as any
-version OS X. It can be run from a console framebuffer or run in a window on X.
+version of OS X. It can be run from a console framebuffer or run in a window on
+X.
</p>
<note>
+Currently, there is no support for running MOL on 64 bit PowerPC Processors.
+</note>
+
+<note>
To run MOL fullscreen, you'll need to compile MOL with the fbcon use flag
enabled and run it in a console framebuffer.
</note>
--
gentoo-doc-cvs@gentoo.org mailing list