Gentoo Archives: gentoo-doc-cvs

From: Joseph Jezak <josejx@×××××××××××.org>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] cvs commit: gentoo-ppc-faq.xml
Date: Fri, 16 Dec 2005 01:28:37
Message-Id: 200512160128.jBG1SLpG028208@robin.gentoo.org
1 josejx 05/12/16 01:28:20
2
3 Modified: xml/htdocs/doc/en gentoo-ppc-faq.xml
4 Log:
5 Updated FAQ to include an index.
6
7 Revision Changes Path
8 1.44 +459 -371 xml/htdocs/doc/en/gentoo-ppc-faq.xml
9
10 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
11 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
12 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
13
14 Index: gentoo-ppc-faq.xml
15 ===================================================================
16 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-ppc-faq.xml,v
17 retrieving revision 1.43
18 retrieving revision 1.44
19 diff -u -r1.43 -r1.44
20 --- gentoo-ppc-faq.xml 13 Dec 2005 04:30:56 -0000 1.43
21 +++ gentoo-ppc-faq.xml 16 Dec 2005 01:28:20 -0000 1.44
22 @@ -1,10 +1,8 @@
23 <?xml version='1.0' encoding="UTF-8"?>
24 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-ppc-faq.xml,v 1.43 2005/12/13 04:30:56 rane Exp $ -->
25 -
26 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
27 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-ppc-faq.xml,v 1.44 2005/12/16 01:28:20 josejx Exp $ -->
28
29 <guide link="/doc/en/gentoo-ppc-faq.xml">
30 -
31 <title>Gentoo Linux/PowerPC Frequently Asked Questions</title>
32
33 <author title="Editor">
34 @@ -21,21 +19,221 @@
35 </author>
36
37 <abstract>
38 -This FAQ is a collection of questions and answers collected from the
39 -gentoo-ppc-dev mailing list and from IRC -- if you have any questions (or
40 -answers!) to add, please contact either an author or a member of the
41 -documentation team.
42 +The Gentoo/PPC FAQ is a collection of questions and answers collected from the
43 +Gentoo/PPC mailing lists and from IRC.
44 </abstract>
45
46 +<!-- The content of this document is licensed under the CC-BY-SA license -->
47 +<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
48 <license/>
49
50 -<version>1.22</version>
51 -<date>2005-08-22</date>
52 +<version>1.23</version>
53 +<date>2005-12-14</date>
54
55 <chapter>
56 +<title>Questions</title>
57 +<section>
58 +<title>Introduction to the Gentoo/PPC FAQ</title>
59 +<body>
60 +
61 +<p>
62 +This FAQ is a collection of questions and answers collected from the
63 +Gentoo/PPC mailing lists and from IRC. If you have any questions (or
64 +answers!), please contact either an author or a member of the
65 +documentation team.
66 +</p>
67 +
68 +</body>
69 +</section>
70 +<section>
71 <title>Installation</title>
72 +<body>
73 +
74 +<ul>
75 + <li>
76 + <uri link="#osxverify">How can I verify with OSX that the downloaded ISO
77 + is not corrupted?</uri>
78 + </li>
79 + <li>
80 + <uri link="#dualboot">Can I dual boot Gentoo and OSX?</uri>
81 + </li>
82 + <li>
83 + <uri link="#bwof">
84 + I have an early NewWorld Mac such as the Blue and White G3. It should be
85 + compatible with the LiveCD, but on boot it returns an "Unknown or corrupt
86 + filesystem" error.
87 + </uri>
88 + </li>
89 + <li>
90 + <uri link="#bootxarchive">
91 + I have an OldWorld Macintosh and need to use BootX. However, I am having
92 + trouble opening the BootX installer archive. What can I do?
93 + </uri>
94 + </li>
95 + <li>
96 + <uri link="#beigehd">
97 + I have a Beige G3 machine. Can I install Gentoo Linux/PPC on a second
98 + IDE hard drive?
99 + </uri>
100 + </li>
101 + <li>
102 + <uri link="#8gblimit">
103 + I have a revision A or B iMac. I've replaced the hard drive with a larger
104 + one and now I can't boot into anything!
105 + </uri>
106 + </li>
107 + <li>
108 + <uri link="#fstabboot">
109 + My /etc/fstab file has /dev/BOOT in it. Do I need to setup this line for
110 + my bootstrap partition?
111 + </uri>
112 + </li>
113 + <li>
114 + <uri link="#fixit">
115 + When I rebooted, yaboot didn't work! Now, I'm stuck. How can I fix this?
116 + </uri>
117 + </li>
118 +</ul>
119 +
120 +</body>
121 +</section>
122 +<section>
123 +<title>Hardware Support</title>
124 +<body>
125 +
126 +<ul>
127 + <li>
128 + <uri link="#laptoppkgs">
129 + I'm running Gentoo on a PowerPC laptop. What packages should I install to
130 + enable laptop-specific functionality?
131 + </uri>
132 + </li>
133 + <li>
134 + <uri link="#onebutton">
135 + I only have one mouse-button. How can I make use of the second and third
136 + one, since ctrl-button does not work?
137 + </uri>
138 + </li>
139 + <li>
140 + <uri link="#airport">How can I configure my Airport card?</uri>
141 + </li>
142 + <li>
143 + <uri link="#airportextreme">
144 + How can I configure my Airport Extreme card?
145 + </uri>
146 + </li>
147 + <li>
148 + <uri link="#modem">
149 + Will the internal modem in an work?
150 + </uri>
151 + </li>
152 + <li>
153 + <uri link="#sleep">Does sleep work on my iBook/PowerBook?</uri>
154 + </li>
155 + <li>
156 + <uri link="#sound">How do I get sound playback working?</uri>
157 + <ul>
158 + <li>
159 + <uri link="#alsa">Sound setup with ALSA</uri>
160 + </li>
161 + <li>
162 + <uri link="#oss">Sound setup with OSS</uri>
163 + </li>
164 + </ul>
165 + </li>
166 +</ul>
167 +
168 +</body>
169 +</section>
170 +<section>
171 +<title>Applications</title>
172 +<body>
173 +
174 +<ul>
175 + <li>
176 + <uri link="#masked">
177 + I can't emerge a package, and get an error about it being masked. What
178 + should I do?
179 + </uri>
180 + </li>
181 + <li>
182 + <uri link="#flash">Does Gentoo/PPC have support for Flash?</uri>
183 + </li>
184 + <li>
185 + <uri link="#java">Does Gentoo/PPC have a Java plugin?</uri>
186 + </li>
187 + <li>
188 + <uri link="#xconf">Is there an easy way to configure X?</uri>
189 + </li>
190 + <li>
191 + <uri link="#drm">
192 + How can I enable Direct Rendering (DRM) on rage128 or radeon cards?
193 + </uri>
194 + </li>
195 + <li>
196 + <uri link="#keymap">
197 + I recently emerged Xorg, but when using it, my international keyboard
198 + layout does not work correctly. The main keys work fine but I am unable
199 + to compose special characters like the "at" sign. The startx output says
200 + something like "could not load keymap, falling back to default keymap".
201 + What is wrong?
202 + </uri>
203 + </li>
204 + <li>
205 + <uri link="#glfreeze">
206 + When using OpenGL DRI or playing movies, the system sometimes locks up
207 + unexpectedly. What can I do?
208 + </uri>
209 + </li>
210 + <li>
211 + <uri link="#audiocd">How do I play Audio CDs?</uri>
212 + </li>
213 + <li>
214 + <uri link="#mol">Can I run Mac OS 9 or Mac OS X under Gentoo Linux?</uri>
215 + </li>
216 + <li>
217 + <uri link="#ext">Can I access my ext2/ext3 partitions from OSX?</uri>
218 + </li>
219 + <li>
220 + <uri link="#useflags">
221 + Which Portage USE flags do not work on PowerPC machines?
222 + </uri>
223 + </li>
224 + <li>
225 + <uri link="#distcc">How can I set up distcc with my x86 box?</uri>
226 + </li>
227 + <li>
228 + <uri link="#gccsegfaults">
229 + Why does gcc keep segfaulting during ebuilds?
230 + </uri>
231 + </li>
232 +</ul>
233 +
234 +</body>
235 +</section>
236 <section>
237 -<title>How do I verify with Mac OS X the downloaded ISO is not corrupted?</title>
238 +<title>Resources</title>
239 +<body>
240 +
241 +<ul>
242 + <li>
243 + <uri link="#cd">Can I buy a CD of Gentoo Linux/PPC?</uri>
244 + </li>
245 + <li>
246 + <uri link="#notanswered">
247 + This FAQ hasn't answered my question. What do I do now?
248 + </uri>
249 + </li>
250 +</ul>
251 +
252 +</body>
253 +</section>
254 +</chapter>
255 +
256 +<chapter>
257 +<title>Installation</title>
258 +<section id="osxverify">
259 +<title>How can I verify with OSX that the downloaded ISO is not corrupted?</title>
260 <body>
261
262 <p>
263 @@ -64,7 +262,7 @@
264
265 </body>
266 </section>
267 -<section>
268 +<section id="dualboot">
269 <title>Can I dual-boot Gentoo Linux and Mac OS X?</title>
270 <body>
271
272 @@ -110,7 +308,7 @@
273
274 </body>
275 </section>
276 -<section>
277 +<section id="bwof">
278 <title>
279 I have an early NewWorld Mac such as the Blue and White G3. It should be
280 compatible with the LiveCD, but on boot it returns an "Unknown or corrupt
281 @@ -133,7 +331,7 @@
282
283 </body>
284 </section>
285 -<section>
286 +<section id="bootxarchive">
287 <title>
288 I have an OldWorld Macintosh and need to use BootX. However, I am having trouble
289 opening the BootX installer archive. What can I do?
290 @@ -148,7 +346,7 @@
291
292 </body>
293 </section>
294 -<section>
295 +<section id="beigehd">
296 <title>
297 I have a Beige G3 machine. Can I install Gentoo Linux/PPC on a second IDE hard
298 drive?
299 @@ -166,22 +364,7 @@
300
301 </body>
302 </section>
303 -<section>
304 -<title>
305 -When I try and install Gentoo on my PowerBook or iBook the internal hard drive
306 -does not show up. What should I do?
307 -</title>
308 -<body>
309 -
310 -<p>
311 -For a PowerBook, pass <c>hda=1,1,1</c> to the kernel at boot time. That should
312 -solve your problems. You can do this at <e>yaboot</e> prompt by typing <c>boot
313 -hda=1,1,1</c>. Some iBooks need <c>hda=16383,16,64</c>.
314 -</p>
315 -
316 -</body>
317 -</section>
318 -<section>
319 +<section id="8gblimit">
320 <title>
321 I have a revision A or B iMac. I've replaced the hard drive with a larger one
322 and now I can't boot into anything!
323 @@ -196,7 +379,7 @@
324
325 </body>
326 </section>
327 -<section>
328 +<section id="fstabboot">
329 <title>
330 My /etc/fstab file has /dev/BOOT in it. Do I need to setup this line for my
331 bootstrap partition?
332 @@ -214,7 +397,7 @@
333
334 </body>
335 </section>
336 -<section>
337 +<section id="fixit">
338 <title>
339 When I rebooted, yaboot didn't work! Now, I'm stuck. How can I fix this?
340 </title>
341 @@ -236,54 +419,77 @@
342
343 </body>
344 </section>
345 -<section>
346 +</chapter>
347 +
348 +<chapter>
349 +<title>Hardware Support</title>
350 +<section id="laptoppkgs">
351 <title>
352 -Installation is now complete. However after rebooting, I am getting different
353 -characters than the keys I press on my machine's keyboard. What should I do?
354 +I'm running Gentoo on a PowerPC laptop. What packages should I install to
355 +enable laptop-specific functionality?
356 </title>
357 <body>
358
359 <p>
360 -If this is an English keymap, you likely have a kernel config issue. You will
361 -need to rebuild your kernel with the following options:
362 +There are four main packages you will need to install.
363 </p>
364
365 -<pre caption="Input core support">
366 -<comment>(these are the defaults, but check them)</comment>
367 -&lt;*&gt; Input core support
368 -&lt;*&gt; Keyboard support
369 -&lt;*&gt; Mouse support
370 -(1024) Horizontal screen resolution
371 -(768) Vertical screen resolution
372 -&lt; &gt; Joystick support
373 -&lt;*&gt; Event interface support
374 -</pre>
375 -
376 -<pre caption="Macintosh Device Drivers">
377 -[*] Apple Desktop Bus (ADB) support
378 -[*] Use input layer for ADB devices
379 -[*] Support for mouse button 2+3 emulation
380 -</pre>
381 +<ul>
382 + <li>
383 + <e>pbbuttonsd</e> is a tool that enables the brightness and volume keys on
384 + most ppc laptops. The current versions also work as a powermanager.
385 + </li>
386 + <li>
387 + <e>gtkpbbuttons</e> gives you a gtk front end for pbbuttonsd (visual
388 + feedback on button presses in X). <e>gtkpbbuttons</e> requires gtk and
389 + should be added to your X session file (<path>~/.Xsession</path>) for best
390 + results (so that it is always running while in X).
391 + </li>
392 + <li>
393 + <e>powerprefs</e> ties together with pbbuttonsd, and gives you the ability
394 + to edit settings such as power-management, trackpad options and various
395 + other preferences.
396 + </li>
397 + <li>
398 + <e>powernowd</e> allows cpu speed scaling for longer battery life. Other
399 + packages also provide the same functionality, such as <e>cpudyn</e>,
400 + <e>cpufreqd</e> and <e>speedfreq</e>.
401 + </li>
402 +</ul>
403
404 <p>
405 -This way, you will still be able to use <path>/proc/sys/dev/mac_hid</path> to
406 -emulate buttons 2 and 3 (see next question).
407 +These packages can be installed by running the appropriate commands from the
408 +list below:
409 </p>
410
411 -<p>
412 -If, for some reason you do not want to recompile your kernel, append
413 -<c>keyboard_sends_linux_keycodes=1</c> to the kernel arguments in
414 -<path>yaboot.conf</path>. This will also correct the problem, but might
415 -possibly introduce other problems.
416 -</p>
417 +<pre caption="Installing laptop-specific packages">
418 +# <i>emerge pbbuttonsd; rc-update add pbbuttonsd default</i>
419 +# <i>emerge gtkpbbuttons</i>
420 +# <i>emerge powerprefs</i>
421 +# <i>emerge powernowd</i>
422 +</pre>
423 +
424 +<note>
425 +You should edit <path>/etc/pbbuttonsd.conf</path> to better suit your needs.
426 +The behaviour of the Fx-keys can be controlled here as well as many sleep
427 +options. To switch the Fx-keys to the OSX behaviour, set KBDMode to fkeyslast.
428 +You can turn off touchpad tapping by setting TPMode to notap. Many other
429 +options are available, see man pbbuttonsd.conf for details.
430 +</note>
431
432 <p>
433 -Thanks to Joe McMahon for help with this answer.
434 +It is useful to add pbbuttonsd and powernowd to your boot runlevel so that they're
435 +started when your computer starts. To do this:
436 </p>
437
438 +<pre caption="Adding pbbuttonsd and cpudyn to the boot runlevel">
439 +# <i>rc-update add pbbuttonsd boot</i>
440 +# <i>rc-update add powernowd boot</i>
441 +</pre>
442 +
443 </body>
444 </section>
445 -<section>
446 +<section id="onebutton">
447 <title>
448 I only have one mouse-button. How can I make use of the second and third one,
449 since ctrl-button does not work?
450 @@ -295,9 +501,19 @@
451 any key or combination of keys to emulate the second and third mouse-button.
452 The values can be obtained with the command line utility <c>showkey</c> from
453 the console. Note that this program does not work as expected from X and should
454 -only be run from the console. In addition to having the kernel configuration
455 -settings from the previous section, you will also need to set the mouse button
456 -values in <path>/etc/sysctl.conf</path>. Here is an example using F11 and F12:
457 +only be run from the console. To use this feature, enable the following options
458 +in your kernel:
459 +</p>
460 +
461 +<pre caption="Macintosh Device Drivers">
462 +[*] Apple Desktop Bus (ADB) support
463 +[*] Use input layer for ADB devices
464 +[*] Support for mouse button 2+3 emulation
465 +</pre>
466 +
467 +<p>
468 +You will also need to set the keyboard to mouse button mapping values in
469 +<path>/etc/sysctl.conf</path>. Here is an example using F11 and F12:
470 </p>
471
472 <pre caption="Mouse button emulation with F11 and F12">
473 @@ -309,227 +525,226 @@
474 dev.mac_hid.mouse_button3_keycode = 88
475 </pre>
476
477 -<p>
478 +<note>
479 Other commonly used keycodes are 125 (The Apple key) and 96 (The Keypad Enter).
480 +</note>
481 +
482 +<p>
483 +To activate these settings:
484 </p>
485
486 -<note>
487 -The easiest way to activate these settings it to reboot after changing them.
488 -</note>
489 +<pre caption="Applying the sysctl changes">
490 +# <i>sysctl -p /etc/sysctl.conf</i>
491 +</pre>
492
493 </body>
494 </section>
495 -<section>
496 -<title>
497 -Installation is now complete. However, after my machine boots into Gentoo and I
498 -try to emerge anything, I see errors saying it cannot 'stat' a file. What is
499 -wrong?
500 -</title>
501 +<section id="airport">
502 +<title>How can I configure my Airport card?</title>
503 <body>
504
505 <p>
506 -Check to see that your time is set correctly. Setting your time and linking
507 -<path>/etc/localtime</path> to your proper timezone (in
508 -<path>/usr/share/zoneinfo</path>) will solve your problems. Also make sure that
509 -you have <e>not</e> enabled the <e>Enhanced RTC</e> option in the <e>Character
510 -devices</e> section of the kernel configuration (as stated in install guide).
511 +The Airport card is based on the Lucent Orinoco chipset. To use this card in
512 +Linux, enable these kernel options:
513 </p>
514
515 -</body>
516 -</section>
517 -</chapter>
518 -
519 -<chapter>
520 -<title>Laptop Support</title>
521 -<section>
522 -<title>
523 -How do I enable the full processor speed on my PowerBook while running Linux?
524 -</title>
525 -<body>
526 -
527 -<note>
528 -Most (if not all) processors should now work at the correct speed with modern
529 -kernels. If you still have this problem, you should upgrade to the latest
530 -kernel and try again, only use this as a backup solution.
531 -</note>
532 +<pre caption="Wireless LAN">
533 +[*] Wirless LAN Drivers &amp; Wireless Extensions
534 +&lt;*&gt; Hermes chipset 802.11b support (Orinoco/Prism2/Symbol)
535 +&lt;*&gt; Apple Airport support (build-in)
536 +</pre>
537
538 <p>
539 -Some processors in PowerBooks start up at slower speed than they are designed
540 -to run. Running at this slower speed conserves battery life with the tradeoff
541 -of performance. The operating system on the machine must instruct the hardware
542 -to run at its full speed. In Mac OS X this is called "Reduced processor
543 -performance" or "CPU Scaling" in Linux. To check the current speed of your
544 -processor while running in Linux, type <c>cat /proc/cpuinfo</c>. In Mac OS X,
545 -you first have to turn off "Reduce processor performance" in the "Options" tab
546 -of the <e>Energy Saver</e> system preference panel. Then run <e>Apple System
547 -Profiler</e> (in Applications:Utilities).
548 -</p>
549 -
550 -<warn>
551 -Do not use this method to overclock your machine. Results are unpredictable if
552 -you use an improper value. We are not responsible if you fry your machine!
553 -</warn>
554 -
555 -<p>
556 -If <e>Apple System Profiler</e> reports a higher speed than what you get when
557 -running in Linux, you can enable the full speed of the processor with a simple
558 -command. First, your machine needs to be running kernel <c>2.4.20-pre9-ben0</c>
559 -or later. Earlier kernels do not have the code necessary to change the
560 -processor speed. Second, you will need to compile the kernel with <c>CPU
561 -Frequency scaling</c> <e>disabled</e>. Finally, run an appropriate command as
562 -shown in the examples below.
563 -</p>
564 -
565 -<pre caption="CPU Frequency scaling">
566 -<comment>(These are examples only. Use values appropriate for your machine.)</comment>
567 -
568 -<comment>(For a 1GHz PowerBook G4)</comment>
569 -echo "0:667000:1000000:performance" > /proc/cpufreq
570 +Once the kernel is configured, you'll also need some userland tools to
571 +configure the wireless settings. Emerge the <c>wireless-tools</c>
572 +for iwconfig and other wireless tools.
573 +</p>
574
575 -<comment>(For an 800MHz PowerBook G4)</comment>
576 -echo "0:667000:800000:performance" > /proc/cpufreq
577 +<p>
578 +As an example of using iwconfig, to set your ESSID to home_essid:
579 +</p>
580
581 -<comment>(For 2.6.x kernels, use this path instead of /proc/cpufreq)</comment>
582 -echo "0:667000:1000000:performance" > /sys/devices/system/cpu/cpu0/cpufreq/scaling_setspeed
583 +<pre caption="Setting an ESSID">
584 +# <i>iwconfig eth1 essid home_essid</i>
585 </pre>
586
587 <p>
588 -Many users will want to add this command to the end of
589 -<path>/etc/conf.d/local.start</path>. This file is sourced every time your
590 -machine starts.
591 +For more details on iwconfig, refer to its man page.
592 </p>
593
594 </body>
595 </section>
596 -<section>
597 -<title>
598 -I'm running Gentoo on a PowerPC laptop. What packages should I install to
599 -enable laptop-specific functionality?
600 -</title>
601 +<section id="airportextreme">
602 +<title>How can I configure my Airport Extreme card?</title>
603 <body>
604
605 <p>
606 -There are four main packages you will need to install.
607 +With the release of the native <uri link="http://bcm43xx.berlios.de">bcm43xx
608 +driver</uri>, using the Airport Extreme in Linux is now possible! Until the
609 +driver is added to the kernel, please see this
610 +<uri link="http://forums.gentoo.org/viewtopic-t-409194.html">forum post</uri>
611 +for details.
612 </p>
613
614 -<ul>
615 - <li>
616 - <e>pbbuttonsd</e> is a tool that enables the brightness and volume keys on
617 - most ppc laptops. The current versions also work as a powermanager.
618 - </li>
619 - <li>
620 - <e>gtkpbbuttons</e> gives you a gtk front end for pbbuttonsd (visual
621 - feedback on button presses in X). <e>gtkpbbuttons</e> requires gtk and
622 - should be added to your X session file (<path>~/.Xsession</path>) for best
623 - results (so that it is always running while in X).
624 - </li>
625 - <li>
626 - <e>powerprefs</e> ties together with pbbuttonsd, and gives you the ability
627 - to edit settings such as power-management, trackpad options and various
628 - other preferences.
629 - </li>
630 - <li>
631 - <e>cpudyn</e> allows cpu speed scaling for longer battery life. Other
632 - packages also provide the same functionality, such as <e>powernowd</e>,
633 - <e>cpufreqd</e> and <e>speedfreq</e>.
634 - </li>
635 -</ul>
636 +<p>
637 +You can also use MOL and OSX to give Linux access to your Airport Extreme card,
638 +please see this <uri link="http://forums.gentoo.org/viewtopic-t-365647.html">
639 +forum post</uri> for details.
640 +</p>
641 +
642 +</body>
643 +</section>
644 +<section id="modem">
645 +<title>Will the internal modem work?</title>
646 +<body>
647
648 <p>
649 -These packages can be installed by running the appropriate commands from the
650 -list below:
651 +On older Macs, the internal modem is a regular serial device. In addition to
652 +ppp support and i2c support, enable this kernel option to use it:
653 </p>
654
655 -<pre caption="Installing laptop-specific packages">
656 -# <i>emerge pbbuttonsd; rc-update add pbbuttonsd default</i>
657 -# <i>emerge gtkpbbuttons</i>
658 -# <i>emerge powerprefs</i>
659 -# <i>emerge cpudyn</i>
660 +<pre caption="Serial Drivers">
661 +&lt;*&gt; PowerMac z85c30 ESCC support (CONFIG_SERIAL_PMACZILOG)
662 </pre>
663
664 -<note>
665 -You should edit <path>/etc/pbbuttonsd.conf</path> to better suit your needs.
666 -The behaviour of the Fx-keys can be controlled here as well as many sleep
667 -options. To switch the Fx-keys to the OSX behaviour, set KBDMode to fkeyslast.
668 -You can turn off touchpad tapping by setting TPMode to notap. Many other
669 -options are available, see man pbbuttonsd.conf for details.
670 -</note>
671 +<p>
672 +Newer Macs use a USB device which only has a driver from Linuxant. Unless you
673 +have purchased a key from Linuxant, this driver will only work at 14.4 and will
674 +not support FAX. To install the driver, emerge <c>net-dialin/hcfusbmodem</c>
675 +which will provide <path>/dev/ttySHCF0</path>. Then set up ppp like usual.
676 +Further information about the installation can be found at
677 +<uri>http://www.linuxant.com/drivers/hcf/install.html</uri>
678 +</p>
679 +
680 +</body>
681 +</section>
682 +<section id="sleep">
683 +<title>Does sleep work on my iBook/PowerBook?</title>
684 +<body>
685
686 <p>
687 -It is useful to add pbbuttonsd and cpudyn to your boot runlevel so that they're
688 -started when your computer starts. To do this:
689 +Sleep (suspend to ram) works very well on all G3 iBooks and TiBooks. Recently,
690 +a kernel patch has been released that adds sleep support for G4 iBooks and
691 +Radeon based AlBooks. If you have one of these laptops, use
692 +vanilla-sources-2.6.12 or gentoo-sources 2.6.11 (or newer) for built in
693 +support.
694 </p>
695
696 -<pre caption="Adding pbbuttonsd and cpudyn to the boot runlevel">
697 -# <i>rc-update add pbbuttonsd boot</i>
698 -# <i>rc-update add cpudyn boot</i>
699 -</pre>
700 +<note>
701 +Note that the 12" PowerBook is not yet supported due to its nVidia chipset.
702 +</note>
703
704 </body>
705 </section>
706 -<section>
707 -<title>How can I configure my machine's Airport or other Wi-Fi card?</title>
708 +<section id="sound">
709 +<title>How do I get sound playback working?</title>
710 <body>
711
712 <p>
713 -Make sure you have support for the airport card compiled into the kernel, or
714 -compiled as a module and loaded. Changing the wireless settings is accomplished
715 -using iwconfig. This is part of the <c>wireless-tools</c> package.
716 +There are two approaches to sound on modern kernels: OSS or ALSA. OSS is the
717 +older of the two options and has been depreciated, but still functions well for
718 +many older Macs. ALSA is the newer method and will continue to be supported in
719 +the future. We recommend that you use ALSA unless you have problems with it.
720 </p>
721
722 +<note>
723 +If you include the OSS driver in your kernel, the ALSA driver will not load.
724 +</note>
725 +
726 <p>
727 -As an example of using iwconfig, to set your SSID to home_ssid:
728 +In addition to configuring the kernel, users who should have access to the
729 +audio devices need to be added to the appropriate group with the command:
730 </p>
731
732 -<pre caption="Setting an SSID">
733 -# <i>iwconfig wlan0 essid home_ssid</i>
734 +<pre caption="Adding users to the audio group">
735 +# <i>gpasswd -a username audio</i>
736 </pre>
737
738 <p>
739 -Where wlan0 is your wifi card's device name. For Airport users, the wifi device
740 -is often eth1. For more details on iwconfig, refer to its man page.
741 +If the kernel is set up correctly, but you can't hear any sound, ensure that
742 +the main mixer volume is turned up and that the device isn't muted!
743 </p>
744
745 <note>
746 -Airport Extreme cards are not yet supported on Linux, but a workaround now
747 -exists, please see this forum post for more information:
748 -<uri>http://forums.gentoo.org/viewtopic-t-365647.html</uri>
749 +The sound card on Macs is connected through the i2c Keywest bus, not the PCI
750 +bus. You will not see the card listed when viewing the PCI bus. This is less
751 +of a problem then you might imagine, because all Macs use the same driver
752 +for sound, but you will need to insure that you have i2c Keywest support in
753 +your kernel.
754 </note>
755
756 </body>
757 </section>
758 -<section>
759 -<title>Will the internal modem in an iBook2 or PowerBook work?</title>
760 +<section id="alsa">
761 +<title>Sound setup with ALSA</title>
762 <body>
763
764 +<p>
765 +For ALSA, we'll set up both the regular ALSA drivers and the OSS emulation
766 +layer so that we can still use legacy OSS only programs. In <c>make
767 +menuconfig</c> you'll need to select:
768 +</p>
769 +
770 +<pre caption="Kernel options for ALSA">
771 +Device Drivers - Sound ---&gt;
772 +&lt;*&gt; Sound card support
773 + Advanced Linux Sound Architecture ---&gt;
774 + &lt; &gt; PowerMac DMA sound support
775 + &lt;*&gt; Advanced Linux Sound Architecture
776 + &lt;*&gt; Sequencer support
777 + &lt;*&gt; Sequencer dummy client
778 + &lt;*&gt; OSS Mixer API
779 + &lt;*&gt; OSS PCM (digital audio) API
780 + [*] OSS Sequencer API
781 + ALSA PowerMac devices ---&gt;
782 + &lt;*&gt; PowerMac (AWACS, DACA, Burgundy, Tumbler, Keywest)
783 +</pre>
784 +
785 +<p>
786 +(or configure as modules and ensure they're loaded on boot).
787 +</p>
788 +
789 <note>
790 -Unless you have purchased a key from Linuxant, this driver will only work at
791 -14.4 and will not support FAX.
792 +Please make sure that <c>PowerMac DMA sound support</c> is turned off,
793 +otherwise the ALSA module will not be able to load.
794 </note>
795
796 <p>
797 -Emerge <c>net-dialin/hcfusbmodem</c> which will provide
798 -<path>/dev/ttySHCF0</path>. Then set up ppp like usual. Further information
799 -about the installation can be found at
800 -<uri>http://www.linuxant.com/drivers/hcf/install.html</uri>
801 +For more information on configuring ALSA, please see the
802 +<uri link="http://www.gentoo.org/doc/en/alsa-guide.xml">Gentoo ALSA Guide</uri>.
803 </p>
804
805 +<note>
806 +If you are using the alsa-driver package instead of building it into your
807 +kernel, the ALSA_CARDS variable should be set to <c>powermac</c>.
808 +</note>
809 +
810 </body>
811 </section>
812 -<section>
813 -<title>Does sleep work on my iBook/PowerBook?</title>
814 +<section id="oss">
815 +<title>Sound setup with OSS</title>
816 <body>
817
818 +<note>Again, only use this if you're not using ALSA.</note>
819 +
820 <p>
821 -Sleep (suspend to ram) works very well on all G3 iBooks and TiBooks. Recently,
822 -a kernel patch has been released that adds sleep support for G4 iBooks and
823 -Radeon based AlBooks. If you have one of these laptops, use
824 -vanilla-sources-2.6.12 or gentoo-sources 2.6.11 for built in support.
825 +In <c>make menuconfig</c> you'll need to select:
826 </p>
827
828 -<note>
829 -Note that the 12" PowerBook is not yet supported due to its nVidia chipset.
830 -</note>
831 +<pre caption="Kernel options for OSS">
832 +&lt;*&gt; Sound card support
833 + &lt;*&gt; PowerMac DMA sound support
834 +</pre>
835 +
836 +<p>
837 +r
838 +(or configure as modules and ensure they're loaded on boot).
839 +</p>
840 +
841 +<p>
842 +If the <c>dmasound_pmac</c> module does not load, you probably need to enable
843 +<c>i2c-core</c> in the kernel or as a module.
844 +</p>
845
846 </body>
847 </section>
848 @@ -537,7 +752,7 @@
849
850 <chapter>
851 <title>Applications</title>
852 -<section>
853 +<section id="masked">
854 <title>
855 I can't emerge a package, and get an error about it being masked. What should I
856 do?
857 @@ -592,7 +807,7 @@
858
859 </body>
860 </section>
861 -<section>
862 +<section id="flash">
863 <title>Does Gentoo/PPC have support for Flash?</title>
864 <body>
865
866 @@ -610,19 +825,17 @@
867
868 </body>
869 </section>
870 -<section>
871 +<section id="java">
872 <title>Does Gentoo/PPC have a Java plugin?</title>
873 <body>
874
875 <p>
876 -No, not at this time. The older java plugin is no longer compatible with the
877 -new Mozilla plugin system and a new plugin has not yet been written.
878 +Yes, a Java plugin is now available with IBM's Java 1.5 beta.
879 </p>
880
881 </body>
882 </section>
883 -
884 -<section>
885 +<section id="xconf">
886 <title>Is there an easy way to configure X?</title>
887 <body>
888
889 @@ -636,7 +849,7 @@
890
891 </body>
892 </section>
893 -<section>
894 +<section id="drm">
895 <title>
896 How can I enable Direct Rendering (DRM) on rage128 or radeon cards?
897 </title>
898 @@ -682,7 +895,7 @@
899
900 </body>
901 </section>
902 -<section>
903 +<section id="keymap">
904 <title>
905 I recently emerged Xorg, but when using it, my international keyboard layout
906 does not work correctly. The main keys work fine but I am unable to compose
907 @@ -699,7 +912,7 @@
908
909 </body>
910 </section>
911 -<section>
912 +<section id="glfreeze">
913 <title>
914 When using OpenGL DRI or playing movies, the system sometimes freezes hard
915 unexpectedly. What can I do?
916 @@ -717,113 +930,13 @@
917 </pre>
918
919 <p>
920 -Also, there are some known issues with the composite and damage extensions
921 -included with the newer X.org releases. Please disable these extensions if
922 -you're having problems.
923 +Also, there are some known issues with the composite extensions included with the
924 +newer X.org releases. Please disable this extension if you're having problems.
925 </p>
926
927 </body>
928 </section>
929 -<section>
930 -<title>How do I get sound playback working?</title>
931 -<body>
932 -
933 -<p>
934 -There are two approaches to sound on modern kernels: OSS or ALSA. OSS is the
935 -older of the two options and has been depreciated, but still functions well for
936 -many older Macs. ALSA is the newer method and will continue to be supported in
937 -the future. We recommend that you use ALSA unless you have problems.
938 -</p>
939 -
940 -<note>
941 -If you include the OSS driver in your kernel, the ALSA driver will not load.
942 -</note>
943 -
944 -<p>
945 -In addition to configuring the kernel, users who should have access to the
946 -audio devices need to be added to the appropriate group with the command:
947 -</p>
948 -
949 -<pre caption="Adding users to the audio group">
950 -# <i>gpasswd -a username audio</i>
951 -</pre>
952 -
953 -<p>
954 -If the kernel is set up correctly, but you can't hear any sound, ensure that
955 -the main mixer volume is turned up and that the device isn't muted!
956 -</p>
957 -
958 -<note>
959 -If you are using a G5 or a mac-mini, you should follow the Gentoo ALSA
960 -configuration guide to install the latest version of the ALSA drivers instead
961 -of the versions supplied by the kernel.
962 -</note>
963 -
964 -</body>
965 -</section>
966 -<section>
967 -<title>Sound setup with ALSA</title>
968 -<body>
969 -
970 -<p>
971 -For ALSA, we'll set up both the regular ALSA drivers and the OSS emulation
972 -layer so that we can still use legacy OSS only programs. In <c>make
973 -menuconfig</c> you'll need to select:
974 -</p>
975 -
976 -<pre caption="Kernel options for ALSA">
977 -Device Drivers - Sound ---&gt;
978 -&lt;*&gt; Sound card support
979 - Advanced Linux Sound Architecture ---&gt;
980 - &lt;&nbsp;&gt; PowerMac DMA sound support
981 - &lt;*&gt; Advanced Linux Sound Architecture
982 - &lt;*&gt; Sequencer support
983 - &lt;*&gt; Sequencer dummy client
984 - &lt;*&gt; OSS Mixer API
985 - &lt;*&gt; OSS PCM (digital audio) API
986 - [*] OSS Sequencer API
987 - ALSA PowerMac devices ---&gt;
988 - &lt;*&gt; PowerMac (AWACS, DACA, Burgundy, Tumbler, Keywest)
989 -</pre>
990 -
991 -<p>
992 -(or configure as modules and ensure they're loaded on boot).
993 -</p>
994 -
995 -<note>
996 -Please make sure that <c>PowerMac DMA sound support</c> is turned off,
997 -otherwise the ALSA module will not be able to load.
998 -</note>
999 -
1000 -</body>
1001 -</section>
1002 -<section>
1003 -<title>Sound setup with OSS</title>
1004 -<body>
1005 -
1006 -<note>Again, only use this if you're not using ALSA.</note>
1007 -
1008 -<p>
1009 -In <c>make menuconfig</c> you'll need to select:
1010 -</p>
1011 -
1012 -<pre caption="Kernel options for OSS">
1013 -&lt;*&gt; Sound card support
1014 - &lt;*&gt; PowerMac DMA sound support
1015 -</pre>
1016 -
1017 -<p>
1018 -(or configure as modules and ensure they're loaded on boot).
1019 -</p>
1020 -
1021 -<p>
1022 -If the <c>dmasound_pmac</c> module does not load, you probably need to enable
1023 -<c>i2c-core</c> in the kernel or as a module.
1024 -</p>
1025 -
1026 -</body>
1027 -</section>
1028 -<section>
1029 +<section id="audiocd">
1030 <title>How do I play Audio CDs?</title>
1031 <body>
1032
1033 @@ -833,42 +946,10 @@
1034 piped to the sound hardware. This is possible using <e>xmms</e> and the
1035 <e>xmms-cdread</e> plugin, that reads the audio off the CD over the ATA cable,
1036 decodes it in software and sends it to the sound card over the PCI bus as
1037 -digital data. If you want 'true' cd-playing, you have to do the following
1038 -steps:
1039 -</p>
1040 -
1041 -<p>
1042 -First, you will need to rebuild your kernel with the following options:
1043 -</p>
1044 -
1045 -<pre caption="Kernel options for playing audio-CDs">
1046 -<comment>(In "ATA/IDE/MFM/RLL Support")</comment>
1047 -<comment>(In "IDE, ATA, and ATAPI Block Devices")</comment>
1048 -&lt; &gt; Include IDE/ATAPI CDROM support <comment>(turn this OFF)</comment>
1049 -&lt;M&gt; SCSI emulation support <comment>(compile this as a module)</comment>
1050 -
1051 -<comment>(In "SCSI Support")</comment>
1052 -&lt;M&gt; SCSI support <comment>(compile this as a module)</comment>
1053 -&lt;M&gt; SCSI CD-ROM support <comment>(compile this as a module)</comment>
1054 -</pre>
1055 -
1056 -<p>
1057 -Then, append <c>hdX=ide-scsi</c> to the kernel image section(s) in
1058 -<path>/etc/yaboot.conf</path> where <c>hdX</c> is the IDE device corresponding
1059 -to your CD player. This is usually <c>hdc</c>. Type <c>ybin -v</c> to install
1060 -the new yaboot.conf settings. Edit <path>/etc/group</path> add any users who
1061 -should be able to play CDs to the <c>cdrom</c> group. You will now need to
1062 -reboot your system for the kernel changes to take effect.
1063 -</p>
1064 -
1065 -<p>
1066 -Upon reboot, <c>su</c> to root and change the permissions of the cd device,
1067 -then install xmms:
1068 +digital data.
1069 </p>
1070
1071 -<pre caption="Changing permission for cdrom and install xmms-read">
1072 -# <i>chown root:cdrom /dev/scsi/host0/bus0/target0/lun0/cd</i>
1073 -# <i>chmod 660 /dev/scsi/host0/bus0/target0/lun0/cd</i>
1074 +<pre caption="Emerge xmms with cd reading support">
1075 # <i>emerge xmms xmms-cdread</i>
1076 </pre>
1077
1078 @@ -883,7 +964,7 @@
1079
1080 </body>
1081 </section>
1082 -<section>
1083 +<section id="mol">
1084 <title>Can I run Mac OS 9 or Mac OS X under Gentoo Linux?</title>
1085 <body>
1086
1087 @@ -892,8 +973,7 @@
1088 link="http://www.maconlinux.org/">Mac-on-Linux</uri> which allows you to run an
1089 instance of OS 9, OS X or Linux as a process on Linux. Simply <c>emerge mol</c>
1090 to install this package. MOL supports Mac OS 7.5.2 to 9.2.2, as well as any
1091 -version OS X except Tiger (support is currently in progress). It can be run
1092 -from a console framebuffer or run in a window on X.
1093 +version OS X. It can be run from a console framebuffer or run in a window on X.
1094 </p>
1095
1096 <note>
1097 @@ -908,7 +988,15 @@
1098 </p>
1099
1100 <p>
1101 -For the dhcp server:
1102 +For OSX Networking:
1103 +</p>
1104 +
1105 +<ul>
1106 + <li>Universal TUN/TAP device driver support (CONFIG_TUN)</li>
1107 +</ul>
1108 +
1109 +<p>
1110 +For the DHCP server:
1111 </p>
1112
1113 <ul>
1114 @@ -931,7 +1019,7 @@
1115
1116 </body>
1117 </section>
1118 -<section>
1119 +<section id="ext">
1120 <title>Can I access my ext2/ext3 partitions from OSX?</title>
1121 <body>
1122
1123 @@ -948,7 +1036,7 @@
1124
1125 </body>
1126 </section>
1127 -<section>
1128 +<section id="useflags">
1129 <title>Which Portage USE flags do not work on PowerPC machines?</title>
1130 <body>
1131
1132 @@ -964,7 +1052,7 @@
1133
1134 </body>
1135 </section>
1136 -<section>
1137 +<section id="distcc">
1138 <title>How can I set up distcc with my x86 box?</title>
1139 <body>
1140
1141 @@ -979,7 +1067,7 @@
1142
1143 </body>
1144 </section>
1145 -<section>
1146 +<section id="gccsegfaults">
1147 <title>Why does gcc keep segfaulting during ebuilds?</title>
1148 <body>
1149
1150 @@ -1012,7 +1100,7 @@
1151
1152 <chapter>
1153 <title>Resources</title>
1154 -<section>
1155 +<section id="cd">
1156 <title>Can I buy a CD of Gentoo Linux/PPC?</title>
1157 <body>
1158
1159 @@ -1023,7 +1111,7 @@
1160
1161 </body>
1162 </section>
1163 -<section>
1164 +<section id="notanswered">
1165 <title>This FAQ hasn't answered my question. What do I do now?</title>
1166 <body>
1167
1168
1169
1170
1171 --
1172 gentoo-doc-cvs@g.o mailing list