/[gentoo]/xml/htdocs/doc/en/gentoo-amd64-faq.xml
Gentoo

Contents of /xml/htdocs/doc/en/gentoo-amd64-faq.xml

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.25 - (hide annotations) (download) (as text)
Sun Jul 22 07:32:28 2007 UTC (7 years, 5 months ago) by nightmorph
Branch: MAIN
Changes since 1.24: +7 -7 lines
File MIME type: application/xml
update nvidia references as nvidia-legacy-drivers is deprecated and will be removed. nvidia-drivers now contains every available version. see Cardoe's message to gentoo-dev for more information.

1 neysx 1.1 <?xml version="1.0" encoding="UTF-8"?>
2     <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
3 nightmorph 1.25 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-amd64-faq.xml,v 1.24 2006/11/24 14:47:22 nightmorph Exp $ -->
4 neysx 1.1
5     <guide link="/doc/en/gentoo-amd64-faq.xml">
6     <title>Gentoo Linux/AMD64 Frequently Asked Questions</title>
7    
8     <author title="Editor">
9 neysx 1.22 <mail link="blubb@gentoo.org">Simon Stelling</mail>
10     </author>
11     <author title="Editor">
12 fox2mike 1.12 <mail link="metalgod@gentoo.org">Luis Medinas</mail>
13 neysx 1.1 </author>
14     <author title="Editor">
15     <mail link="gerrynjr@gentoo.org">Gerald J. Normandin Jr.</mail>
16     </author>
17     <author title="Editor">
18     <mail link="neysx@gentoo.org">Xavier Neys</mail>
19     </author>
20    
21     <abstract>
22     This is the Gentoo Linux/AMD64 Frequently Asked Questions
23     </abstract>
24    
25     <!-- The content of this document is licensed under the CC-BY-SA license -->
26     <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
27     <license/>
28    
29 nightmorph 1.25 <version>1.18</version>
30     <date>2007-07-22</date>
31 neysx 1.1
32     <chapter>
33     <title>Questions</title>
34     <section>
35     <title>Introduction to Gentoo/AMD64 FAQ</title>
36     <body>
37    
38     <p>
39     This document contains the most commonly asked questions about Gentoo/AMD64. We
40     intend to help and provide useful information about Gentoo/AMD64. Some of these
41 neysx 1.22 questions can be found in forums, IRC, or mailing lists. If you have
42     suggestions or questions about this FAQ, you are welcome to send an e-mail to
43     <mail>amd64@gentoo.org</mail>.
44 neysx 1.1 </p>
45    
46     </body>
47     </section>
48     <section>
49     <title>Installation</title>
50     <body>
51    
52     <ul>
53     <li><uri link="#cflags">What CFLAGS should I use for AMD64/EM64T?</uri></li>
54     <li><uri link="#kernel">What kernel should I use?</uri></li>
55     <li>
56 neysx 1.23 <uri link="#perfup">Will I have a performance upgrade if I use a 64bit
57     system instead of 32bit?</uri>
58 neysx 1.1 </li>
59     <li><uri link="#multilib">What is multilib and how can I use it?</uri></li>
60 neysx 1.23 <li><uri link="#chroot32">How do I create a 32bit chroot?</uri></li>
61 neysx 1.1 <li>
62     <uri link="#upgradex86">Can I upgrade from my x86 system to amd64 by doing
63     emerge -e world?</uri>
64     </li>
65 jkt 1.14 <li><uri link="#reiser4">Can I use Reiser4?</uri></li>
66 neysx 1.1 </ul>
67    
68     </body>
69     </section>
70     <section>
71     <title>Hardware</title>
72     <body>
73    
74     <ul>
75     <li>
76     <uri link="#videobindrivers">Will my binary NVIDIA/ATI drivers work?</uri>
77     </li>
78     <li>
79 nightmorph 1.17 <uri link="#coolnquiet">How do I use Cool'n'Quiet/PowerNow features?</uri>
80 neysx 1.1 </li>
81     </ul>
82    
83     </body>
84     </section>
85     <section>
86     <title>Applications</title>
87     <body>
88    
89     <ul>
90     <li><uri link="#flash">Can I get Macromedia Flash working?</uri></li>
91     <li><uri link="#OOo">Can I get OpenOffice.org working?</uri></li>
92     <li>
93     <uri link="#masked">I want to install package foo, but emerge says: (masked
94     by: ~amd64 keyword)</uri>
95     </li>
96     <li>
97     <uri link="#keyword">I want to install package foo, but emerge says:
98     (masked by: missing keyword)</uri>
99     </li>
100     </ul>
101    
102     </body>
103     </section>
104     <section>
105 alin 1.4 <title>How can I help the Gentoo/AMD64 project?</title>
106 neysx 1.1 <body>
107    
108     <ul>
109     <li><uri link="#project">How can I help?</uri></li>
110     </ul>
111    
112     </body>
113     </section>
114     <section>
115     <title>Other Resources</title>
116     <body>
117    
118     <ul>
119     <li>
120     <uri link="#other">Where can I get more help or information about
121     Gentoo/AMD64?</uri>
122     </li>
123     </ul>
124    
125     </body>
126     </section>
127     </chapter>
128    
129     <chapter>
130     <title>Installation</title>
131     <section id="cflags">
132     <title>What CFLAGS should I use for AMD64/EM64T?</title>
133     <body>
134    
135     <p>
136     You should use simple <c>CFLAGS</c> to avoid future problems with your system.
137 neysx 1.22 Supported <c>CFLAGS</c> are <c>-O2 -march=k8 -pipe</c> for non-EM64T systems and
138     <c>-O2 -march=nocona -pipe</c> for EM64T systems.
139 neysx 1.1 </p>
140    
141     </body>
142     </section>
143     <section id="kernel">
144     <title>What kernel should I use for AMD64?</title>
145     <body>
146    
147     <p>
148 smithj 1.2 You can use almost all kernel sources available in Portage. We recommend using
149     <c>gentoo-sources</c> because it is a special kernel designed for Gentoo Linux.
150     It contains lots of AMD64-specific patches and therefore is the only kernel
151 neysx 1.22 officially supported by Gentoo/AMD64.
152 neysx 1.1 </p>
153    
154     <warn>
155 smithj 1.2 You should watch out for some kernel features which are not well tested, such
156 neysx 1.1 as <c>PREEMPT</c>.
157     </warn>
158    
159 neysx 1.22 <p>
160     Make sure you have the <c>IA32_EMULATION</c> option activated in the kernel.
161     </p>
162    
163     <pre caption="Activating IA32 Emulation in Kernel source">
164     # <i>cd /usr/src/linux</i>
165     # <i>make menuconfig</i>
166    
167     Executable file formats / Emulations ---&gt;
168     [*] IA32 Emulation
169     </pre>
170    
171     <warn>
172     You may experience build failures on multilib-systems if you deactivate this
173     option.
174     </warn>
175    
176 neysx 1.1 </body>
177     </section>
178     <section id="perfup">
179 neysx 1.23 <title>Will I have a performance upgrade if I use a 64bit system instead of 32bit?</title>
180 neysx 1.1 <body>
181    
182     <p>
183     That is a difficult question to answer. In some cases, you will experience a
184     performance improvement, in other cases you will not. For everyday use, there
185 neysx 1.23 is nearly no difference between 64bit and 32bit. 64bit is generally faster
186 neysx 1.1 when it comes to floating point computing which is normally the case in
187     multimedia applications and 3D rendering. This <uri
188     link="http://enterprise.linux.com/enterprise/05/06/09/1413209.shtml?tid=121">article</uri>
189     may interest you. There's also a nice <uri
190     link="http://forums.gentoo.org/viewtopic-t-349691.html">thread</uri> in our
191     <uri link="http://forums.gentoo.org">forums</uri>.
192     </p>
193    
194     </body>
195     </section>
196     <section id="multilib">
197     <title>What is multilib and how can I use it?</title>
198     <body>
199    
200     <p>
201 neysx 1.23 Every AMD64 processor is able to run 32bit code as well as 64bit code.
202     However, when you have a 32bit application, you are unable to mix it with
203     64bit libraries or vice versa. You can, however, natively run 32bit
204     applications if all shared libraries it needs are available as 32bit objects.
205 smithj 1.2 You can choose whether you want multilib support or not by selecting the
206 neysx 1.1 according profile. The default is a multilib-enabled profile.
207     </p>
208    
209 neysx 1.22 <warn>
210     Currently you cannot switch from a no-multilib to a multilib-enabled profile,
211     so think over your decision twice before you use the no-multilib profile.
212     </warn>
213    
214 neysx 1.1 </body>
215     </section>
216     <section id="chroot32">
217 neysx 1.23 <title>How do I create a 32bit chroot?</title>
218 neysx 1.1 <body>
219    
220     <p>
221 neysx 1.23 Please read the <uri link="/proj/en/base/amd64/howtos/chroot.xml">32bit chroot
222 neysx 1.1 guide</uri>.
223     </p>
224    
225     </body>
226     </section>
227     <section id="upgradex86">
228     <title>Can I upgrade from my x86 system to amd64 by doing emerge -e world?</title>
229     <body>
230    
231     <p>
232     Due to several differences between an <c>x86</c> and an <c>amd64</c>
233     installation, it is impossible to upgrade. Please perform a fresh install. The
234 smithj 1.2 installation is slightly different than an x86 one, so please use the
235 neysx 1.1 <uri link="/doc/en/handbook/handbook-amd64.xml">AMD64 Handbook</uri>.
236     </p>
237    
238     </body>
239     </section>
240 jkt 1.14 <section id="reiser4">
241     <title>Can I use Reiser4?</title>
242     <body>
243    
244     <p>
245     Reiser4 is not available from any kernel offered by the Gentoo Kernel project,
246     thus neither AMD64 team supports it. The answer is no.
247     </p>
248 nightmorph 1.17
249 jkt 1.14 </body>
250     </section>
251 neysx 1.1 </chapter>
252    
253     <chapter>
254     <title>Hardware</title>
255     <section id="videobindrivers">
256     <title>Will my binary NVIDIA/ATI drivers work?</title>
257     <body>
258    
259     <p>
260     Yes, NVIDIA and ATI provide drivers that work on AMD64. You can install them by
261 nightmorph 1.25 executing <c>emerge nvidia-drivers</c> or <c>emerge ati-drivers</c>. If you have
262     more questions about these drivers, you should read the <uri
263     link="/doc/en/nvidia-guide.xml">Nvidia guide</uri> or the <uri
264     link="/doc/en/ati-faq.xml">ATI FAQ</uri>.
265 neysx 1.1 </p>
266    
267     </body>
268     </section>
269     <section id="coolnquiet">
270 nightmorph 1.17 <title>How do I use Cool'n'Quiet/PowerNow features?</title>
271 neysx 1.1 <body>
272    
273     <p>
274     You have to compile your kernel with support for these features. You just need
275 smithj 1.2 to enable the features below:
276 neysx 1.1 </p>
277    
278 nightmorph 1.17 <pre caption="Kernel options for Cool'n'Quiet/PowerNow">
279 neysx 1.1 Power management options ---&gt;
280     [*] Power Management support
281     CPU Frequency scaling ---&gt;
282     [*] CPU Frequency scaling
283     [*] CPU frequency table helpers
284     [*] AMD Opteron/Athlon64 PowerNow!
285     </pre>
286    
287     <p>
288     Then <c>emerge cpudyn</c> and edit <path>/etc/conf.d/cpudyn</path> with your
289     favorite editor.
290     </p>
291    
292     <pre caption="Example of /etc/conf.d/cpudyn">
293     INTERVAL=1
294     CPU_UP=0.5
295     CPU_DOWN=0.9
296     THROTTLING_LOW=7
297     CPUFREQ_25="/sys/devices/system/cpu/cpu0/cpufreq /sysfs/devices/system/cpu/cpu0/cpufreq"
298     CPUFREQ_ACPI="/proc/acpi/processor/CPU0/throttling"
299     </pre>
300    
301     <p>
302 smithj 1.2 Now you only have to run <c>rc-update add cpudyn default</c> to make sure it is
303     started every time you boot.
304 neysx 1.1 </p>
305    
306 nightmorph 1.24 <note>
307     You may want to read the <uri
308     link="/doc/en/power-management-guide.xml#doc_chap3">Power Management Guide</uri>
309     for more tips on CPU power management.
310     </note>
311    
312 neysx 1.1 </body>
313     </section>
314     </chapter>
315    
316     <chapter>
317     <title>Applications</title>
318     <section id="flash">
319     <title>Can I get Macromedia Flash working?</title>
320     <body>
321    
322     <p>
323 neysx 1.23 Yes. To get Flash working, you need a 32bit browser like
324 neysx 1.1 <c>mozilla-firefox-bin</c> or <c>opera</c> because Macromedia doesn't provide a
325 neysx 1.23 64bit version. After emerging the -bin package of your favorite browser,
326 nightmorph 1.17 install Flash by doing <c>emerge netscape-flash</c>.
327 neysx 1.1 </p>
328    
329     </body>
330     </section>
331     <section id="OOo">
332     <title>Can I get OpenOffice.org working?</title>
333     <body>
334    
335     <p>
336 neysx 1.23 OpenOffice versions prior to 2.0.4 do not build on 64bit systems, so you have to use the
337     32bit binary version, available in Portage as <c>app-office/openoffice-bin</c>.
338     If you feel brave you can <c>emerge openoffice</c>, but be aware that the 64bit version
339 neysx 1.22 is not yet tested out enough to be considered stable.
340 neysx 1.1 </p>
341    
342     </body>
343     </section>
344     <section id="masked">
345     <title>I want to install package foo, but emerge says: (masked by: ~amd64 keyword)</title>
346     <body>
347    
348     <p>
349     This means that the package is still in the 'testing' tree. Please read <c>man
350     portage</c> or the <uri
351     link="/doc/en/handbook/handbook-amd64.xml?part=3&amp;chap=3">Mixing Software
352     Branches</uri> chapter of the <uri
353     link="/doc/en/handbook/handbook-amd64.xml">AMD64 Handbook</uri> for more
354     information.
355     </p>
356    
357     </body>
358     </section>
359     <section id="keyword">
360     <title>I want to install package foo, but emerge says: (masked by: missing keyword)</title>
361     <body>
362    
363     <p>
364     This means that the package has not been tested yet. It does <e>not
365     necessarily</e> mean that the package does not work. You can unmask it by
366 neysx 1.9 accepting another architecture for the package. The following example shows you
367 neysx 1.22 can tell Portage to accept any keyword for a given package.
368 neysx 1.1 </p>
369    
370     <pre caption="Example of adding package keywords">
371 neysx 1.22 # <i>echo "category/packagename ~* *" >> /etc/portage/package.keywords</i>
372 nightmorph 1.21 # <i>emerge packagename</i>
373 neysx 1.1 </pre>
374    
375     <p>
376     If it works fine for you, please let us know and file a bug on <uri
377 neysx 1.9 link="http://bugs.gentoo.org/">Gentoo's Bugzilla</uri>, so that the AMD64 team
378     can keyword the package and other users can benefit from your test.
379 neysx 1.1 </p>
380    
381     <warn>
382 neysx 1.22 Do not try commands like <c>ACCEPT_KEYWORDS="~x86" emerge packagename</c>. It
383 nightmorph 1.21 will most certainly break your tree.
384 neysx 1.1 </warn>
385    
386     </body>
387     </section>
388     </chapter>
389    
390     <chapter>
391 fox2mike 1.16 <title>How can I help the Gentoo/AMD64 project?</title>
392 neysx 1.1 <section id="project">
393     <title>How can I help?</title>
394     <body>
395    
396     <p>
397     With a growing popularity of the amd64 architecture, we also increasingly need
398     more help. There's still much work to be done to improve the quality of
399     Gentoo/AMD64. An average user can help us by:
400     </p>
401    
402     <ul>
403     <li>Filing general bug reports</li>
404     <li>Testing software that does not yet have the <c>~amd64</c> keyword</li>
405     <li>
406 neysx 1.22 Participating in the <uri link="/proj/en/base/amd64/at/">Arch Testers
407 neysx 1.1 project</uri>
408     </li>
409     <li>
410     Help answering questions on the mailing lists, forums and IRC channels
411     </li>
412     <li>Sending patches</li>
413     </ul>
414    
415     </body>
416     </section>
417     </chapter>
418    
419     <chapter>
420     <title>Other Resources</title>
421     <section id="other">
422     <title>Where can I get more help or information about Gentoo/AMD64?</title>
423     <body>
424    
425     <p>
426 neysx 1.22 If any of your questions wasn't answered here, you can try other resources
427     listed on <uri link="/proj/en/base/amd64/">our project homepage</uri>. You can
428 neysx 1.1 also ask us at <c>#gentoo-amd64</c> on <c>irc.freenode.net</c>, <uri
429     link="http://forums.gentoo.org/viewforum-f-46.html">Gentoo/AMD64 Forums</uri>,
430     or on the <c>gentoo-amd64@lists.gentoo.org</c> mailing list.
431     </p>
432    
433     </body>
434     </section>
435     </chapter>
436    
437     </guide>

  ViewVC Help
Powered by ViewVC 1.1.20