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 1En4Oi-0003Tm-Iw for garchives@archives.gentoo.org; Fri, 16 Dec 2005 01:28:37 +0000 Received: from robin.gentoo.org (localhost [127.0.0.1]) by robin.gentoo.org (8.13.5/8.13.5) with SMTP id jBG1SNCo011446; Fri, 16 Dec 2005 01:28:23 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 jBG1SLpG028208 for <gentoo-doc-cvs@lists.gentoo.org>; Fri, 16 Dec 2005 01:28:22 GMT Message-Id: <200512160128.jBG1SLpG028208@robin.gentoo.org> Received: from lark.gentoo.osuosl.org ([140.211.166.177] helo=lark.gentoo.org) by smtp.gentoo.org with smtp (Exim 4.54) id 1En4OT-0000Iy-Dm for gentoo-doc-cvs@lists.gentoo.org; Fri, 16 Dec 2005 01:28:21 +0000 Received: by lark.gentoo.org (sSMTP sendmail emulation); Fri, 16 Dec 2005 01:28:21 +0000 From: "Joseph Jezak" <josejx@lark.gentoo.org> Date: Fri, 16 Dec 2005 01:28:21 +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: 1c84aead-c96e-427d-8968-c5109fcb6257 X-Archives-Hash: 2f5b1cc9c723cc63bdb1eab3e1a5ff8e josejx 05/12/16 01:28:20 Modified: xml/htdocs/doc/en gentoo-ppc-faq.xml Log: Updated FAQ to include an index. Revision Changes Path 1.44 +459 -371 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.44&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.44&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.43&r2=1.44&cvsroot=gentoo Index: gentoo-ppc-faq.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-ppc-faq.xml,v retrieving revision 1.43 retrieving revision 1.44 diff -u -r1.43 -r1.44 --- gentoo-ppc-faq.xml 13 Dec 2005 04:30:56 -0000 1.43 +++ gentoo-ppc-faq.xml 16 Dec 2005 01:28:20 -0000 1.44 @@ -1,10 +1,8 @@ <?xml version='1.0' encoding="UTF-8"?> -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-ppc-faq.xml,v 1.43 2005/12/13 04:30:56 rane Exp $ --> - <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-ppc-faq.xml,v 1.44 2005/12/16 01:28:20 josejx Exp $ --> <guide link="/doc/en/gentoo-ppc-faq.xml"> - <title>Gentoo Linux/PowerPC Frequently Asked Questions</title> <author title="Editor"> @@ -21,21 +19,221 @@ </author> <abstract> -This FAQ is a collection of questions and answers collected from the -gentoo-ppc-dev mailing list and from IRC -- if you have any questions (or -answers!) to add, please contact either an author or a member of the -documentation team. +The Gentoo/PPC FAQ is a collection of questions and answers collected from the +Gentoo/PPC mailing lists and from IRC. </abstract> +<!-- The content of this document is licensed under the CC-BY-SA license --> +<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> <license/> -<version>1.22</version> -<date>2005-08-22</date> +<version>1.23</version> +<date>2005-12-14</date> <chapter> +<title>Questions</title> +<section> +<title>Introduction to the Gentoo/PPC FAQ</title> +<body> + +<p> +This FAQ is a collection of questions and answers collected from the +Gentoo/PPC mailing lists and from IRC. If you have any questions (or +answers!), please contact either an author or a member of the +documentation team. +</p> + +</body> +</section> +<section> <title>Installation</title> +<body> + +<ul> + <li> + <uri link="#osxverify">How can I verify with OSX that the downloaded ISO + is not corrupted?</uri> + </li> + <li> + <uri link="#dualboot">Can I dual boot Gentoo and OSX?</uri> + </li> + <li> + <uri link="#bwof"> + I have an early NewWorld Mac such as the Blue and White G3. It should be + compatible with the LiveCD, but on boot it returns an "Unknown or corrupt + filesystem" error. + </uri> + </li> + <li> + <uri link="#bootxarchive"> + I have an OldWorld Macintosh and need to use BootX. However, I am having + trouble opening the BootX installer archive. What can I do? + </uri> + </li> + <li> + <uri link="#beigehd"> + I have a Beige G3 machine. Can I install Gentoo Linux/PPC on a second + IDE hard drive? + </uri> + </li> + <li> + <uri link="#8gblimit"> + I have a revision A or B iMac. I've replaced the hard drive with a larger + one and now I can't boot into anything! + </uri> + </li> + <li> + <uri link="#fstabboot"> + My /etc/fstab file has /dev/BOOT in it. Do I need to setup this line for + my bootstrap partition? + </uri> + </li> + <li> + <uri link="#fixit"> + When I rebooted, yaboot didn't work! Now, I'm stuck. How can I fix this? + </uri> + </li> +</ul> + +</body> +</section> +<section> +<title>Hardware Support</title> +<body> + +<ul> + <li> + <uri link="#laptoppkgs"> + I'm running Gentoo on a PowerPC laptop. What packages should I install to + enable laptop-specific functionality? + </uri> + </li> + <li> + <uri link="#onebutton"> + I only have one mouse-button. How can I make use of the second and third + one, since ctrl-button does not work? + </uri> + </li> + <li> + <uri link="#airport">How can I configure my Airport card?</uri> + </li> + <li> + <uri link="#airportextreme"> + How can I configure my Airport Extreme card? + </uri> + </li> + <li> + <uri link="#modem"> + Will the internal modem in an work? + </uri> + </li> + <li> + <uri link="#sleep">Does sleep work on my iBook/PowerBook?</uri> + </li> + <li> + <uri link="#sound">How do I get sound playback working?</uri> + <ul> + <li> + <uri link="#alsa">Sound setup with ALSA</uri> + </li> + <li> + <uri link="#oss">Sound setup with OSS</uri> + </li> + </ul> + </li> +</ul> + +</body> +</section> +<section> +<title>Applications</title> +<body> + +<ul> + <li> + <uri link="#masked"> + I can't emerge a package, and get an error about it being masked. What + should I do? + </uri> + </li> + <li> + <uri link="#flash">Does Gentoo/PPC have support for Flash?</uri> + </li> + <li> + <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> + </li> + <li> + <uri link="#drm"> + How can I enable Direct Rendering (DRM) on rage128 or radeon cards? + </uri> + </li> + <li> + <uri link="#keymap"> + 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? + </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> + </li> + <li> + <uri link="#ext">Can I access my ext2/ext3 partitions from OSX?</uri> + </li> + <li> + <uri link="#useflags"> + Which Portage USE flags do not work on PowerPC machines? + </uri> + </li> + <li> + <uri link="#distcc">How can I set up distcc with my x86 box?</uri> + </li> + <li> + <uri link="#gccsegfaults"> + Why does gcc keep segfaulting during ebuilds? + </uri> + </li> +</ul> + +</body> +</section> <section> -<title>How do I verify with Mac OS X the downloaded ISO is not corrupted?</title> +<title>Resources</title> +<body> + +<ul> + <li> + <uri link="#cd">Can I buy a CD of Gentoo Linux/PPC?</uri> + </li> + <li> + <uri link="#notanswered"> + This FAQ hasn't answered my question. What do I do now? + </uri> + </li> +</ul> + +</body> +</section> +</chapter> + +<chapter> +<title>Installation</title> +<section id="osxverify"> +<title>How can I verify with OSX that the downloaded ISO is not corrupted?</title> <body> <p> @@ -64,7 +262,7 @@ </body> </section> -<section> +<section id="dualboot"> <title>Can I dual-boot Gentoo Linux and Mac OS X?</title> <body> @@ -110,7 +308,7 @@ </body> </section> -<section> +<section id="bwof"> <title> I have an early NewWorld Mac such as the Blue and White G3. It should be compatible with the LiveCD, but on boot it returns an "Unknown or corrupt @@ -133,7 +331,7 @@ </body> </section> -<section> +<section id="bootxarchive"> <title> I have an OldWorld Macintosh and need to use BootX. However, I am having trouble opening the BootX installer archive. What can I do? @@ -148,7 +346,7 @@ </body> </section> -<section> +<section id="beigehd"> <title> I have a Beige G3 machine. Can I install Gentoo Linux/PPC on a second IDE hard drive? @@ -166,22 +364,7 @@ </body> </section> -<section> -<title> -When I try and install Gentoo on my PowerBook or iBook the internal hard drive -does not show up. What should I do? -</title> -<body> - -<p> -For a PowerBook, pass <c>hda=1,1,1</c> to the kernel at boot time. That should -solve your problems. You can do this at <e>yaboot</e> prompt by typing <c>boot -hda=1,1,1</c>. Some iBooks need <c>hda=16383,16,64</c>. -</p> - -</body> -</section> -<section> +<section id="8gblimit"> <title> I have a revision A or B iMac. I've replaced the hard drive with a larger one and now I can't boot into anything! @@ -196,7 +379,7 @@ </body> </section> -<section> +<section id="fstabboot"> <title> My /etc/fstab file has /dev/BOOT in it. Do I need to setup this line for my bootstrap partition? @@ -214,7 +397,7 @@ </body> </section> -<section> +<section id="fixit"> <title> When I rebooted, yaboot didn't work! Now, I'm stuck. How can I fix this? </title> @@ -236,54 +419,77 @@ </body> </section> -<section> +</chapter> + +<chapter> +<title>Hardware Support</title> +<section id="laptoppkgs"> <title> -Installation is now complete. However after rebooting, I am getting different -characters than the keys I press on my machine's keyboard. What should I do? +I'm running Gentoo on a PowerPC laptop. What packages should I install to +enable laptop-specific functionality? </title> <body> <p> -If this is an English keymap, you likely have a kernel config issue. You will -need to rebuild your kernel with the following options: +There are four main packages you will need to install. </p> -<pre caption="Input core support"> -<comment>(these are the defaults, but check them)</comment> -<*> Input core support -<*> Keyboard support -<*> Mouse support -(1024) Horizontal screen resolution -(768) Vertical screen resolution -< > Joystick support -<*> Event interface support -</pre> - -<pre caption="Macintosh Device Drivers"> -[*] Apple Desktop Bus (ADB) support -[*] Use input layer for ADB devices -[*] Support for mouse button 2+3 emulation -</pre> +<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. + </li> + <li> + <e>gtkpbbuttons</e> gives you a gtk front end 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). + </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. + </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>. + </li> +</ul> <p> -This way, you will still be able to use <path>/proc/sys/dev/mac_hid</path> to -emulate buttons 2 and 3 (see next question). +These packages can be installed by running the appropriate commands from the +list below: </p> -<p> -If, for some reason you do not want to recompile your kernel, append -<c>keyboard_sends_linux_keycodes=1</c> to the kernel arguments in -<path>yaboot.conf</path>. This will also correct the problem, but might -possibly introduce other problems. -</p> +<pre caption="Installing laptop-specific packages"> +# <i>emerge pbbuttonsd; rc-update add pbbuttonsd default</i> +# <i>emerge gtkpbbuttons</i> +# <i>emerge powerprefs</i> +# <i>emerge powernowd</i> +</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. +</note> <p> -Thanks to Joe McMahon for help with this answer. +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"> +# <i>rc-update add pbbuttonsd boot</i> +# <i>rc-update add powernowd boot</i> +</pre> + </body> </section> -<section> +<section id="onebutton"> <title> I only have one mouse-button. How can I make use of the second and third one, since ctrl-button does not work? @@ -295,9 +501,19 @@ any key or combination of keys to emulate the second and third mouse-button. The values can be obtained with the command line utility <c>showkey</c> from the console. Note that this program does not work as expected from X and should -only be run from the console. In addition to having the kernel configuration -settings from the previous section, you will also need to set the mouse button -values in <path>/etc/sysctl.conf</path>. Here is an example using F11 and F12: +only be run from the console. To use this feature, enable the following options +in your kernel: +</p> + +<pre caption="Macintosh Device Drivers"> +[*] Apple Desktop Bus (ADB) support +[*] Use input layer for ADB devices +[*] Support for mouse button 2+3 emulation +</pre> + +<p> +You will also need to set the keyboard to mouse button mapping values in +<path>/etc/sysctl.conf</path>. Here is an example using F11 and F12: </p> <pre caption="Mouse button emulation with F11 and F12"> @@ -309,227 +525,226 @@ dev.mac_hid.mouse_button3_keycode = 88 </pre> -<p> +<note> Other commonly used keycodes are 125 (The Apple key) and 96 (The Keypad Enter). +</note> + +<p> +To activate these settings: </p> -<note> -The easiest way to activate these settings it to reboot after changing them. -</note> +<pre caption="Applying the sysctl changes"> +# <i>sysctl -p /etc/sysctl.conf</i> +</pre> </body> </section> -<section> -<title> -Installation is now complete. However, after my machine boots into Gentoo and I -try to emerge anything, I see errors saying it cannot 'stat' a file. What is -wrong? -</title> +<section id="airport"> +<title>How can I configure my Airport card?</title> <body> <p> -Check to see that your time is set correctly. Setting your time and linking -<path>/etc/localtime</path> to your proper timezone (in -<path>/usr/share/zoneinfo</path>) will solve your problems. Also make sure that -you have <e>not</e> enabled the <e>Enhanced RTC</e> option in the <e>Character -devices</e> section of the kernel configuration (as stated in install guide). +The Airport card is based on the Lucent Orinoco chipset. To use this card in +Linux, enable these kernel options: </p> -</body> -</section> -</chapter> - -<chapter> -<title>Laptop Support</title> -<section> -<title> -How do I enable the full processor speed on my PowerBook while running Linux? -</title> -<body> - -<note> -Most (if not all) processors should now work at the correct speed with modern -kernels. If you still have this problem, you should upgrade to the latest -kernel and try again, only use this as a backup solution. -</note> +<pre caption="Wireless LAN"> +[*] Wirless LAN Drivers & Wireless Extensions +<*> Hermes chipset 802.11b support (Orinoco/Prism2/Symbol) +<*> Apple Airport support (build-in) +</pre> <p> -Some processors in PowerBooks start up at slower speed than they are designed -to run. Running at this slower speed conserves battery life with the tradeoff -of performance. The operating system on the machine must instruct the hardware -to run at its full speed. In Mac OS X this is called "Reduced processor -performance" or "CPU Scaling" in Linux. To check the current speed of your -processor while running in Linux, type <c>cat /proc/cpuinfo</c>. In Mac OS X, -you first have to turn off "Reduce processor performance" in the "Options" tab -of the <e>Energy Saver</e> system preference panel. Then run <e>Apple System -Profiler</e> (in Applications:Utilities). -</p> - -<warn> -Do not use this method to overclock your machine. Results are unpredictable if -you use an improper value. We are not responsible if you fry your machine! -</warn> - -<p> -If <e>Apple System Profiler</e> reports a higher speed than what you get when -running in Linux, you can enable the full speed of the processor with a simple -command. First, your machine needs to be running kernel <c>2.4.20-pre9-ben0</c> -or later. Earlier kernels do not have the code necessary to change the -processor speed. Second, you will need to compile the kernel with <c>CPU -Frequency scaling</c> <e>disabled</e>. Finally, run an appropriate command as -shown in the examples below. -</p> - -<pre caption="CPU Frequency scaling"> -<comment>(These are examples only. Use values appropriate for your machine.)</comment> - -<comment>(For a 1GHz PowerBook G4)</comment> -echo "0:667000:1000000:performance" > /proc/cpufreq +Once the kernel is configured, you'll also need some userland tools to +configure the wireless settings. Emerge the <c>wireless-tools</c> +for iwconfig and other wireless tools. +</p> -<comment>(For an 800MHz PowerBook G4)</comment> -echo "0:667000:800000:performance" > /proc/cpufreq +<p> +As an example of using iwconfig, to set your ESSID to home_essid: +</p> -<comment>(For 2.6.x kernels, use this path instead of /proc/cpufreq)</comment> -echo "0:667000:1000000:performance" > /sys/devices/system/cpu/cpu0/cpufreq/scaling_setspeed +<pre caption="Setting an ESSID"> +# <i>iwconfig eth1 essid home_essid</i> </pre> <p> -Many users will want to add this command to the end of -<path>/etc/conf.d/local.start</path>. This file is sourced every time your -machine starts. +For more details on iwconfig, refer to its man page. </p> </body> </section> -<section> -<title> -I'm running Gentoo on a PowerPC laptop. What packages should I install to -enable laptop-specific functionality? -</title> +<section id="airportextreme"> +<title>How can I configure my Airport Extreme card?</title> <body> <p> -There are four main packages you will need to install. +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 +<uri link="http://forums.gentoo.org/viewtopic-t-409194.html">forum post</uri> +for details. </p> -<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. - </li> - <li> - <e>gtkpbbuttons</e> gives you a gtk front end 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). - </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. - </li> - <li> - <e>cpudyn</e> allows cpu speed scaling for longer battery life. Other - packages also provide the same functionality, such as <e>powernowd</e>, - <e>cpufreqd</e> and <e>speedfreq</e>. - </li> -</ul> +<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. +</p> + +</body> +</section> +<section id="modem"> +<title>Will the internal modem work?</title> +<body> <p> -These packages can be installed by running the appropriate commands from the -list below: +On older Macs, the internal modem is a regular serial device. In addition to +ppp support and i2c support, enable this kernel option to use it: </p> -<pre caption="Installing laptop-specific packages"> -# <i>emerge pbbuttonsd; rc-update add pbbuttonsd default</i> -# <i>emerge gtkpbbuttons</i> -# <i>emerge powerprefs</i> -# <i>emerge cpudyn</i> +<pre caption="Serial Drivers"> +<*> PowerMac z85c30 ESCC support (CONFIG_SERIAL_PMACZILOG) </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. -</note> +<p> +Newer Macs use a USB device which only has a driver from Linuxant. Unless you +have purchased a key from Linuxant, this driver will only work at 14.4 and will +not support FAX. To install the driver, emerge <c>net-dialin/hcfusbmodem</c> +which will provide <path>/dev/ttySHCF0</path>. Then set up ppp like usual. +Further information about the installation can be found at +<uri>http://www.linuxant.com/drivers/hcf/install.html</uri> +</p> + +</body> +</section> +<section id="sleep"> +<title>Does sleep work on my iBook/PowerBook?</title> +<body> <p> -It is useful to add pbbuttonsd and cpudyn to your boot runlevel so that they're -started when your computer starts. To do this: +Sleep (suspend to ram) works very well on all G3 iBooks and TiBooks. Recently, +a kernel patch has been released that adds sleep support for G4 iBooks and +Radeon based AlBooks. If you have one of these laptops, use +vanilla-sources-2.6.12 or gentoo-sources 2.6.11 (or newer) for built in +support. </p> -<pre caption="Adding pbbuttonsd and cpudyn to the boot runlevel"> -# <i>rc-update add pbbuttonsd boot</i> -# <i>rc-update add cpudyn boot</i> -</pre> +<note> +Note that the 12" PowerBook is not yet supported due to its nVidia chipset. +</note> </body> </section> -<section> -<title>How can I configure my machine's Airport or other Wi-Fi card?</title> +<section id="sound"> +<title>How do I get sound playback working?</title> <body> <p> -Make sure you have support for the airport card compiled into the kernel, or -compiled as a module and loaded. Changing the wireless settings is accomplished -using iwconfig. This is part of the <c>wireless-tools</c> package. +There are two approaches to sound on modern kernels: OSS or ALSA. OSS is the +older of the two options and has been depreciated, but still functions well for +many older Macs. ALSA is the newer method and will continue to be supported in +the future. We recommend that you use ALSA unless you have problems with it. </p> +<note> +If you include the OSS driver in your kernel, the ALSA driver will not load. +</note> + <p> -As an example of using iwconfig, to set your SSID to home_ssid: +In addition to configuring the kernel, users who should have access to the +audio devices need to be added to the appropriate group with the command: </p> -<pre caption="Setting an SSID"> -# <i>iwconfig wlan0 essid home_ssid</i> +<pre caption="Adding users to the audio group"> +# <i>gpasswd -a username audio</i> </pre> <p> -Where wlan0 is your wifi card's device name. For Airport users, the wifi device -is often eth1. For more details on iwconfig, refer to its man page. +If the kernel is set up correctly, but you can't hear any sound, ensure that +the main mixer volume is turned up and that the device isn't muted! </p> <note> -Airport Extreme cards are not yet supported on Linux, but a workaround now -exists, please see this forum post for more information: -<uri>http://forums.gentoo.org/viewtopic-t-365647.html</uri> +The sound card on Macs is connected through the i2c Keywest bus, not the PCI +bus. You will not see the card listed when viewing the PCI bus. This is less +of a problem then you might imagine, because all Macs use the same driver +for sound, but you will need to insure that you have i2c Keywest support in +your kernel. </note> </body> </section> -<section> -<title>Will the internal modem in an iBook2 or PowerBook work?</title> +<section id="alsa"> +<title>Sound setup with ALSA</title> <body> +<p> +For ALSA, we'll set up both the regular ALSA drivers and the OSS emulation +layer so that we can still use legacy OSS only programs. In <c>make +menuconfig</c> you'll need to select: +</p> + +<pre caption="Kernel options for ALSA"> +Device Drivers - Sound ---> +<*> Sound card support + Advanced Linux Sound Architecture ---> + < > PowerMac DMA sound support + <*> Advanced Linux Sound Architecture + <*> Sequencer support + <*> Sequencer dummy client + <*> OSS Mixer API + <*> OSS PCM (digital audio) API + [*] OSS Sequencer API + ALSA PowerMac devices ---> + <*> PowerMac (AWACS, DACA, Burgundy, Tumbler, Keywest) +</pre> + +<p> +(or configure as modules and ensure they're loaded on boot). +</p> + <note> -Unless you have purchased a key from Linuxant, this driver will only work at -14.4 and will not support FAX. +Please make sure that <c>PowerMac DMA sound support</c> is turned off, +otherwise the ALSA module will not be able to load. </note> <p> -Emerge <c>net-dialin/hcfusbmodem</c> which will provide -<path>/dev/ttySHCF0</path>. Then set up ppp like usual. Further information -about the installation can be found at -<uri>http://www.linuxant.com/drivers/hcf/install.html</uri> +For more information on configuring ALSA, please see the +<uri link="http://www.gentoo.org/doc/en/alsa-guide.xml">Gentoo ALSA Guide</uri>. </p> +<note> +If you are using the alsa-driver package instead of building it into your +kernel, the ALSA_CARDS variable should be set to <c>powermac</c>. +</note> + </body> </section> -<section> -<title>Does sleep work on my iBook/PowerBook?</title> +<section id="oss"> +<title>Sound setup with OSS</title> <body> +<note>Again, only use this if you're not using ALSA.</note> + <p> -Sleep (suspend to ram) works very well on all G3 iBooks and TiBooks. Recently, -a kernel patch has been released that adds sleep support for G4 iBooks and -Radeon based AlBooks. If you have one of these laptops, use -vanilla-sources-2.6.12 or gentoo-sources 2.6.11 for built in support. +In <c>make menuconfig</c> you'll need to select: </p> -<note> -Note that the 12" PowerBook is not yet supported due to its nVidia chipset. -</note> +<pre caption="Kernel options for OSS"> +<*> Sound card support + <*> PowerMac DMA sound support +</pre> + +<p> +r +(or configure as modules and ensure they're loaded on boot). +</p> + +<p> +If the <c>dmasound_pmac</c> module does not load, you probably need to enable +<c>i2c-core</c> in the kernel or as a module. +</p> </body> </section> @@ -537,7 +752,7 @@ <chapter> <title>Applications</title> -<section> +<section id="masked"> <title> I can't emerge a package, and get an error about it being masked. What should I do? @@ -592,7 +807,7 @@ </body> </section> -<section> +<section id="flash"> <title>Does Gentoo/PPC have support for Flash?</title> <body> @@ -610,19 +825,17 @@ </body> </section> -<section> +<section id="java"> <title>Does Gentoo/PPC have a Java plugin?</title> <body> <p> -No, not at this time. The older java plugin is no longer compatible with the -new Mozilla plugin system and a new plugin has not yet been written. +Yes, a Java plugin is now available with IBM's Java 1.5 beta. </p> </body> </section> - -<section> +<section id="xconf"> <title>Is there an easy way to configure X?</title> <body> @@ -636,7 +849,7 @@ </body> </section> -<section> +<section id="drm"> <title> How can I enable Direct Rendering (DRM) on rage128 or radeon cards? </title> @@ -682,7 +895,7 @@ </body> </section> -<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 @@ -699,7 +912,7 @@ </body> </section> -<section> +<section id="glfreeze"> <title> When using OpenGL DRI or playing movies, the system sometimes freezes hard unexpectedly. What can I do? @@ -717,113 +930,13 @@ </pre> <p> -Also, there are some known issues with the composite and damage extensions -included with the newer X.org releases. Please disable these extensions if -you're having problems. +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. </p> </body> </section> -<section> -<title>How do I get sound playback working?</title> -<body> - -<p> -There are two approaches to sound on modern kernels: OSS or ALSA. OSS is the -older of the two options and has been depreciated, but still functions well for -many older Macs. ALSA is the newer method and will continue to be supported in -the future. We recommend that you use ALSA unless you have problems. -</p> - -<note> -If you include the OSS driver in your kernel, the ALSA driver will not load. -</note> - -<p> -In addition to configuring the kernel, users who should have access to the -audio devices need to be added to the appropriate group with the command: -</p> - -<pre caption="Adding users to the audio group"> -# <i>gpasswd -a username audio</i> -</pre> - -<p> -If the kernel is set up correctly, but you can't hear any sound, ensure that -the main mixer volume is turned up and that the device isn't muted! -</p> - -<note> -If you are using a G5 or a mac-mini, you should follow the Gentoo ALSA -configuration guide to install the latest version of the ALSA drivers instead -of the versions supplied by the kernel. -</note> - -</body> -</section> -<section> -<title>Sound setup with ALSA</title> -<body> - -<p> -For ALSA, we'll set up both the regular ALSA drivers and the OSS emulation -layer so that we can still use legacy OSS only programs. In <c>make -menuconfig</c> you'll need to select: -</p> - -<pre caption="Kernel options for ALSA"> -Device Drivers - Sound ---> -<*> Sound card support - Advanced Linux Sound Architecture ---> - < > PowerMac DMA sound support - <*> Advanced Linux Sound Architecture - <*> Sequencer support - <*> Sequencer dummy client - <*> OSS Mixer API - <*> OSS PCM (digital audio) API - [*] OSS Sequencer API - ALSA PowerMac devices ---> - <*> PowerMac (AWACS, DACA, Burgundy, Tumbler, Keywest) -</pre> - -<p> -(or configure as modules and ensure they're loaded on boot). -</p> - -<note> -Please make sure that <c>PowerMac DMA sound support</c> is turned off, -otherwise the ALSA module will not be able to load. -</note> - -</body> -</section> -<section> -<title>Sound setup with OSS</title> -<body> - -<note>Again, only use this if you're not using ALSA.</note> - -<p> -In <c>make menuconfig</c> you'll need to select: -</p> - -<pre caption="Kernel options for OSS"> -<*> Sound card support - <*> PowerMac DMA sound support -</pre> - -<p> -(or configure as modules and ensure they're loaded on boot). -</p> - -<p> -If the <c>dmasound_pmac</c> module does not load, you probably need to enable -<c>i2c-core</c> in the kernel or as a module. -</p> - -</body> -</section> -<section> +<section id="audiocd"> <title>How do I play Audio CDs?</title> <body> @@ -833,42 +946,10 @@ piped to the sound hardware. This is possible using <e>xmms</e> and the <e>xmms-cdread</e> plugin, that reads the audio off the CD over the ATA cable, decodes it in software and sends it to the sound card over the PCI bus as -digital data. If you want 'true' cd-playing, you have to do the following -steps: -</p> - -<p> -First, you will need to rebuild your kernel with the following options: -</p> - -<pre caption="Kernel options for playing audio-CDs"> -<comment>(In "ATA/IDE/MFM/RLL Support")</comment> -<comment>(In "IDE, ATA, and ATAPI Block Devices")</comment> -< > Include IDE/ATAPI CDROM support <comment>(turn this OFF)</comment> -<M> SCSI emulation support <comment>(compile this as a module)</comment> - -<comment>(In "SCSI Support")</comment> -<M> SCSI support <comment>(compile this as a module)</comment> -<M> SCSI CD-ROM support <comment>(compile this as a module)</comment> -</pre> - -<p> -Then, append <c>hdX=ide-scsi</c> to the kernel image section(s) in -<path>/etc/yaboot.conf</path> where <c>hdX</c> is the IDE device corresponding -to your CD player. This is usually <c>hdc</c>. Type <c>ybin -v</c> to install -the new yaboot.conf settings. Edit <path>/etc/group</path> add any users who -should be able to play CDs to the <c>cdrom</c> group. You will now need to -reboot your system for the kernel changes to take effect. -</p> - -<p> -Upon reboot, <c>su</c> to root and change the permissions of the cd device, -then install xmms: +digital data. </p> -<pre caption="Changing permission for cdrom and install xmms-read"> -# <i>chown root:cdrom /dev/scsi/host0/bus0/target0/lun0/cd</i> -# <i>chmod 660 /dev/scsi/host0/bus0/target0/lun0/cd</i> +<pre caption="Emerge xmms with cd reading support"> # <i>emerge xmms xmms-cdread</i> </pre> @@ -883,7 +964,7 @@ </body> </section> -<section> +<section id="mol"> <title>Can I run Mac OS 9 or Mac OS X under Gentoo Linux?</title> <body> @@ -892,8 +973,7 @@ 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 except Tiger (support is currently in progress). It can be run -from a console framebuffer or run in a window on X. +version OS X. It can be run from a console framebuffer or run in a window on X. </p> <note> @@ -908,7 +988,15 @@ </p> <p> -For the dhcp server: +For OSX Networking: +</p> + +<ul> + <li>Universal TUN/TAP device driver support (CONFIG_TUN)</li> +</ul> + +<p> +For the DHCP server: </p> <ul> @@ -931,7 +1019,7 @@ </body> </section> -<section> +<section id="ext"> <title>Can I access my ext2/ext3 partitions from OSX?</title> <body> @@ -948,7 +1036,7 @@ </body> </section> -<section> +<section id="useflags"> <title>Which Portage USE flags do not work on PowerPC machines?</title> <body> @@ -964,7 +1052,7 @@ </body> </section> -<section> +<section id="distcc"> <title>How can I set up distcc with my x86 box?</title> <body> @@ -979,7 +1067,7 @@ </body> </section> -<section> +<section id="gccsegfaults"> <title>Why does gcc keep segfaulting during ebuilds?</title> <body> @@ -1012,7 +1100,7 @@ <chapter> <title>Resources</title> -<section> +<section id="cd"> <title>Can I buy a CD of Gentoo Linux/PPC?</title> <body> @@ -1023,7 +1111,7 @@ </body> </section> -<section> +<section id="notanswered"> <title>This FAQ hasn't answered my question. What do I do now?</title> <body> -- gentoo-doc-cvs@gentoo.org mailing list