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

Diff of /xml/htdocs/doc/en/gentoo-sparc-faq.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.14 Revision 1.19
1<?xml version='1.0' encoding="UTF-8"?> 1<?xml version='1.0' encoding="UTF-8"?>
2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-sparc-faq.xml,v 1.14 2007/07/01 03:03:39 nightmorph Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-sparc-faq.xml,v 1.19 2010/03/03 03:16:37 nightmorph Exp $ -->
3 3
4<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 4<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
5<guide link="/doc/en/gentoo-sparc-faq.xml"> 5<guide>
6<title>Gentoo Linux/SPARC Frequently Asked Questions</title> 6<title>Gentoo Linux/SPARC Frequently Asked Questions</title>
7 7
8<author title="SPARC Developer"> 8<author title="SPARC Developer">
9 <mail link="weeve@gentoo.org">Jason Wever</mail> 9 <mail link="weeve"/>
10</author>
11<author title="Editor">
12 <mail link="nightmorph"/>
10</author> 13</author>
11 14
12<abstract> 15<abstract>
13This FAQ is designed to help answer the most commonly asked questions about 16This FAQ is designed to help answer the most commonly asked questions about
14Gentoo Linux/SPARC and Linux on SPARC architecture. Feel free to send 17Gentoo/SPARC and Linux on SPARC architecture. Feel free to send revisions and
15revisions and corrections to the sparc team or the doc team. 18corrections to the Gentoo/SPARC team or the doc team.
16</abstract> 19</abstract>
17 20
18<!-- The content of this document is licensed under the CC-BY-SA license --> 21<!-- The content of this document is licensed under the CC-BY-SA license -->
19<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> 22<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
20<license/> 23<license/>
21 24
22<version>1.9</version> 25<version>1.12</version>
23<date>2007-06-30</date> 26<date>2010-03-02</date>
24 27
25<chapter> 28<faqindex>
29<title>Questions</title>
30<section>
26<title>Documentation Notes</title> 31<title>Documentation Notes</title>
27<section>
28<body> 32<body>
29 33
30<p> 34<p>
31These are some notes to elaborate on acronyms and terms used in this document. 35These are some notes to elaborate on acronyms and terms used in this document.
32</p> 36</p>
42Acronyms: <c>OBP</c> = OpenBoot PROM, <c>SS</c> = SPARCstation. 46Acronyms: <c>OBP</c> = OpenBoot PROM, <c>SS</c> = SPARCstation.
43</p> 47</p>
44 48
45</body> 49</body>
46</section> 50</section>
47</chapter> 51</faqindex>
48 52
49<chapter> 53<chapter>
50<title>Installation</title> 54<title>Installation</title>
51<section> 55<section>
52<title>How do I install/use my SPARC over a serial console?</title> 56<title>How do I install/use my SPARC over a serial console?</title>
100</tr> 104</tr>
101</table> 105</table>
102 106
103</body> 107</body>
104</section> 108</section>
105<!-- sparc32 is no longer supported
106<section>
107<title>How do I network boot my SPARC system for installation?</title>
108<body>
109 109
110<p>
111Currently, Gentoo has experimental network boot/tftpboot images available on a
112local Gentoo mirror in experimental/sparc/tftpboot. Get the appropriate image
113for your SPARC computer and then proceed to the Netboot HOWTO for further
114instructions.
115</p>
116
117</body>
118</section> 110<section>
119-->
120<section>
121<title>I have a CRT/LCD monitor attached to my SPARC that selects a resolution 111<title>I have a CRT/LCD monitor attached to my SPARC that selects a resolution
122my monitor can't handle when the kernel boots. How do I get a visible and/or 112my monitor can't handle when the kernel boots. How do I get a visible and/or
123non-distorted display on my monitor?</title> 113non-distorted display on my monitor?</title>
124<body> 114<body>
125 115
126<p> 116<p>
186</pre> 176</pre>
187 177
188</body> 178</body>
189</section> 179</section>
190<section> 180<section>
191<title>I'm new to SPARC and am not sure what kernel options to use, 181<title>I'm new to SPARC and am not sure what kernel options to use,
192HELP!</title> 182HELP!</title>
193<body> 183<body>
194 184
195<p> 185<p>
196Most of the time, the default kernel options will be acceptable for hardware 186Most of the time, the default kernel options will be acceptable for hardware
204<section> 194<section>
205<title>How do I dual boot Gentoo Linux/SPARC with Solaris?</title> 195<title>How do I dual boot Gentoo Linux/SPARC with Solaris?</title>
206<body> 196<body>
207 197
208<p> 198<p>
209Dual booting Gentoo Linux/SPARC and Solaris can be done one of two ways. The 199Dual booting Gentoo/SPARC and Solaris can be done one of two ways. The two ways
210two ways are: having both Gentoo Linux/SPARC and Solaris on the same drive, or 200are: having both Gentoo/SPARC and Solaris on the same drive, or having them on
211having them on separate drives. Below are example SILO configurations for each 201separate drives. Below are example SILO configurations for each scenario. In the
212scenario. In the example configs, the following things are assumed: 202example configs, the following things are assumed:
213</p> 203</p>
214 204
215<p> 205<p>
216Single Drive Setup: 206Single Drive Setup:
217</p> 207</p>
237<pre caption="Sample silo.conf for a single drive installation"> 227<pre caption="Sample silo.conf for a single drive installation">
238<comment># Generic config options</comment> 228<comment># Generic config options</comment>
239partition = 1 229partition = 1
240timeout = 50 230timeout = 50
241 231
242<comment># Gentoo Linux/SPARC options</comment> 232<comment># Gentoo/SPARC options</comment>
243image = /boot/vmlinux 233image = /boot/vmlinux
244 label = linux 234 label = linux
245 root=/dev/sda4 235 root=/dev/sda4
246 236
247<comment># Solaris options</comment> 237<comment># Solaris options</comment>
252<pre caption="Sample silo.conf for separate disk installation"> 242<pre caption="Sample silo.conf for separate disk installation">
253<comment># Generic config options</comment> 243<comment># Generic config options</comment>
254parition = 1 244parition = 1
255timeout = 50 245timeout = 50
256 246
257<comment># Gentoo Linux/SPARC options</comment> 247<comment># Gentoo/SPARC options</comment>
258image = /boot/vmlinux 248image = /boot/vmlinux
259 label = linux 249 label = linux
260 root=/dev/sda4 250 root=/dev/sda4
261 251
262<comment># Solaris options</comment> 252<comment># Solaris options</comment>
264 label = solaris 254 label = solaris
265</pre> 255</pre>
266 256
267</body> 257</body>
268</section> 258</section>
269<!-- sparc32 is no longer supported
270<section>
271<title>I just booted my SPARCstation after installing Gentoo but it won't boot.
272Why isn't it booting?</title>
273<body>
274
275<p>
276One possibility has to do with the way the that the SCSI IDs are assigned.
277Gentoo/SPARC developer Keith Wesolowski provides us with the following:
278</p>
279
280<p>
281Linux, normally, orders devices by SCSI ID. The lowest-numbered disk is
282<c>sda</c>, the next-lowest is <c>sdb</c>, and so on. Note that <c>devfs</c>
283allows you to specify devices by SCSI ID, so that adding a new device doesn't
284cause your existing devices to be renamed, unless of course you use the
285compatibility names. There are additional ways to solve this.
286</p>
287
288<p>
289The OBP in most or all sun4c and sun4m systems aliases "disk" to the device with
290SCSI ID 3, and "disk0" through "disk3" to the device with the corresponding SCSI
291ID, if it happens to be a disk rather than a tape, CDROM, etc.
292</p>
293
294<p>
295In the desktop systems of this era that support two SCA disks (the Aurora
296chassis systems), the lower slot is assigned SCSI ID 3, and the upper slot is
297assigned SCSI ID 1.
298</p>
299
300<p>
301If you like, you can change the PROM alias "disk" to match that of "disk1" so
302that the <c>boot disk</c> command causes the system to boot from the same
303device Linux calls <c>sda</c>. This feels more consistent and normal,
304especially for users with a PC background. Alternatively, you can simply place
305the filesystem containing <path>/boot</path> (which could be the root
306filesystem or a separate boot filesystem) on device ID 3 (Linux <c>sdb</c>) and
307boot from it, using a root filesystem on either <c>sda</c> or <c>sdb</c>, or in
308fact any other disk attached to the system.
309</p>
310
311</body>
312</section>
313-->
314</chapter> 259</chapter>
315 260
316<chapter> 261<chapter>
317<title>Hardware</title> 262<title>Hardware</title>
318<section> 263<section>
331link="/proj/en/base/sparc/sunhw.xml">hardware compatibility list</uri> for 276link="/proj/en/base/sparc/sunhw.xml">hardware compatibility list</uri> for
332SPARC64 systems. In general, support for SPARC64 systems is good enough to 277SPARC64 systems. In general, support for SPARC64 systems is good enough to
333allow some users to run it successfully in production environments. 278allow some users to run it successfully in production environments.
334</p> 279</p>
335 280
336<p>
33732-bit SPARC systems are no longer supported by the Gentoo/SPARC team.
338</p>
339
340<!-- 32bit is no longer supported
341<p>
34232-bit SPARC systems vary. Systems with the sun4m architecture have been
343reported to work fine (SS4-SS20) including SMP configurations with the later
3442.4 series kernels. sun4m systems using HyperSPARC or Ross processors in a SMP
345configuration will have a lot of kernel related trouble. Additionally the
346author hasn't heard of any user reports in regards to the JavaStations so its
347status is unknown. sun4d based systems currently do not work in the 2.4 kernel
348series, and sun4c has been unstable as well.
349</p>
350
351<p>
352Often, the problems encountered in trying to run Gentoo on a 32-bit SPARC
353system stem from the kernel. Rob Radez (not related to Gentoo) maintains a
354webpage <uri>http://osinvestor.com/sparc/</uri> with the status of SPARC system
355support for various versions of the Linux kernel. This can help indicate how
356usable your SPARC system would be under SPARC/Linux.
357</p>
358-->
359
360</body> 281</body>
361</section> 282</section>
362<section> 283<section>
363<title>What additional hardware is supported under Gentoo/SPARC?</title> 284<title>What additional hardware is supported under Gentoo/SPARC?</title>
364<body> 285<body>
365 286
366<p> 287<p>
367For a list of additionally supported Sun hardware, consult the following list 288For a list of additionally supported Sun hardware, consult the following list
368from the UltraLinux homepage - 289from the <uri link="http://www.ultralinux.org/faq.html#q_2_2.">UltraLinux
369<uri>http://www.ultralinux.org/faq.html#q_2_2.</uri> 290homepage</uri>.
370</p> 291</p>
371 292
372<p> 293<p>
373A partial list of Sun devices which do NOT currently have support under 294A partial list of Sun devices which do NOT currently have support under
374Gentoo/SPARC or SPARC/Linux in general are: 295Gentoo/SPARC or SPARC/Linux in general are:
390</p> 311</p>
391 312
392</body> 313</body>
393</section> 314</section>
394<section> 315<section>
395<title>How do I know which Sparc I have?</title> 316<title>How do I know which SPARC I have?</title>
396<body> 317<body>
397 318
398<p> 319<p>
399The <uri link="http://www.ultralinux.org/faq.html#q_2_1">UltraLinux FAQ</uri> 320The <uri link="http://www.ultralinux.org/faq.html#q_2_1">UltraLinux FAQ</uri>
400has the answer. 321has the answer.
452Note that you may need to reboot to see the changes take affect. 373Note that you may need to reboot to see the changes take affect.
453</p> 374</p>
454 375
455</body> 376</body>
456</section> 377</section>
378<section>
379<title>Is SPARC big-endian or little-endian?</title>
380<body>
381
382<p>
383The version supported by Gentoo/SPARC (v9) is bi-endian. It uses big-endian
384instructions, but can access data in little-endian byte-order, such as PCI
385devices, which are little-endian by nature.
386</p>
387
388</body>
389</section>
457</chapter> 390</chapter>
458 391
459<chapter> 392<chapter>
460<title>Applications</title> 393<title>Applications</title>
461<section> 394<section>
486</p> 419</p>
487 420
488</body> 421</body>
489</section> 422</section>
490<section> 423<section>
491<title>How come package foo is masked on Sparc?</title> 424<title>How come package foo is masked on SPARC?</title>
492<body> 425<body>
493 426
494<p> 427<p>
495Chances are this is due to the fact that none of the Gentoo/SPARC developers 428Chances are this is due to the fact that none of the Gentoo/SPARC developers
496have gotten around to testing this yet, and/or the package is currently marked 429have gotten around to testing this yet, and/or the package is currently marked
511 444
512<p> 445<p>
513If you want to help ensure a package gets marked stable in a timely fashion, 446If you want to help ensure a package gets marked stable in a timely fashion,
514particularly if it's an application with a small userbase (i.e. 447particularly if it's an application with a small userbase (i.e.
515net-im/bitlbee), install the package and test to make sure it works. If it 448net-im/bitlbee), install the package and test to make sure it works. If it
516appears to be working well, feel free to file a bug at 449appears to be working well, feel free to file a bug via the
517<uri>http://bugs.gentoo.org</uri> and assign it to the Gentoo/SPARC team. 450<uri link="http://bugs.gentoo.org">Gentoo Bugzilla</uri> and assign it to the
451Gentoo/SPARC team.
518</p> 452</p>
519 453
520</body> 454</body>
521</section> 455</section>
522<section> 456<section>
523<title>I tried to emerge a package, but emerge failed complaining that a 457<title>I tried to emerge a package, but emerge failed complaining that a
524dependency is masked. How can I fix this?</title> 458dependency is masked. How can I fix this?</title>
525<body> 459<body>
526 460
527<p> 461<p>
528This is a bug. Please file a bug report at <uri>http://bugs.gentoo.org</uri> 462This is a bug. Please file a bug report via the <uri
529for the Gentoo/SPARC team indicating what package you tried to emerge, the 463link="http://bugs.gentoo.org">Gentoo Bugzilla</uri> for the Gentoo/SPARC team
530error message emerge gave you, and the output of <c>emerge --info</c>. 464indicating what package you tried to emerge, the error message emerge gave you,
465and the output of <c>emerge --info</c>.
466</p>
467
468</body>
469</section>
470<section>
471<title>Why am I getting an error related to 32/64-bit when compiling a
472kernel?</title>
473<body>
474
531</p> 475<p>
476The way SPARC/Linux handles the cross-compiler has changed with 2.6.25 (<uri
477link="http://git.kernel.org/?p=linux/kernel/git/torvalds/linux-2.6.git;a=commitdiff;h=54cd6ddec77b75e6926d73d263aec72255b24030">commit</uri>),
478thus when building a recent kernel you'd get the following error message:
479</p>
480
481<pre caption="SPARC/Linux compile error message">
482CHK include/linux/version.h
483CHK include/linux/utsrelease.h
484CC arch/sparc64/kernel/asm-offsets.s
485arch/sparc64/kernel/asm-offsets.c:1: error: -m64 is not supported by this configuration
486arch/sparc64/kernel/asm-offsets.c:1: error: -mlong-double-64 not allowed with -m64
487arch/sparc64/kernel/asm-offsets.c:1: error: -mcmodel= is not supported on 32 bit systems
488make[1]: *** [arch/sparc64/kernel/asm-offsets.s] Error 1
489make: *** [prepare0] Error 2
490</pre>
491
492<p>
493Because, for the moment (there's an <b>experimental</b> <uri
494link="/proj/en/base/sparc/multilib.xml">multilib</uri> profile),
495Gentoo/SPARC native compiler can't generate 64-bit code (that's what
496sys-devel/kgcc64 is for).
497</p>
498
499<p>
500What you need to do is to tell the SPARC/Linux Makefile what is your
501cross-compiler's binary, by issuing the following commands:
502</p>
503
504<pre caption="Gentoo/SPARC kernel >=2.6.25 kernel compilation">
505# <i>cd /usr/src/linux</i>
506# <i>make CROSS_COMPILE=sparc64-unknown-linux-gnu-</i>
507# <i>make CROSS_COMPILE=sparc64-unknown-linux-gnu- image modules_install</i>
508</pre>
532 509
533</body> 510</body>
534</section> 511</section>
535</chapter> 512</chapter>
536 513
537<chapter> 514<chapter>
538<title>Miscellaneous</title> 515<title>Miscellaneous</title>
539<section> 516<section>
540<title>I'm interested in becoming more involved with Gentoo/SPARC. How do I go about 517<title>I'm interested in becoming more involved with Gentoo/SPARC. How do I go
541doing that?</title> 518about doing that?</title>
542<body> 519<body>
543 520
544<p>
545The best way is to join the <c>#gentoo-sparc</c> IRC channel on Freenode IRC
546network <c>irc.freenode.net</c>. This is where all of the developers hang out
547and talk SPARC (amongst other things). Short of email, this is the best way to
548get our attention.
549</p> 521<p>
550 522There are various ways to improve the project:
551<p> 523</p>
552Also, many users and developers make use of the <uri 524
525<ul>
526 <li>The best way is to become an <uri
527 link="/proj/en/base/sparc/at/index.xml">Arch Tester</uri>, and aid the
528 developers with package testing.
529 </li>
530 <li>File bug reports such as <uri
531 link="http://dev.gentoo.org/~tcunha/reports/imlate-sparc.txt">stable, and
532 keyword</uri> requests.
533 </li>
534 <li>Join the <uri
535 link="irc://irc.gentoo.org/gentoo-sparc">#gentoo-sparc</uri> IRC channel
536 on the FreeNode IRC network.
537 </li>
538 <li>Make use of the <uri
553link="http://forums.gentoo.org/viewforum.php?f=27">Gentoo/SPARC forum</uri>. 539 link="http://forums.gentoo.org/viewforum.php?f=27">Gentoo/SPARC forum</uri>.
554This is a good place to ask questions and see what problems have come up 540 </li>
555before, as well as talk shop about Gentoo/SPARC. 541 <li>Propose solutions for Gentoo/SPARC related bugs via the <uri
556</p>
557
558<p>
559Additionally, you can view the bugs for Gentoo/SPARC via the <uri
560link="http://bugs.gentoo.org">Gentoo Bugzilla</uri>. The bugs will be assigned 542 link="http://bugs.gentoo.org">Gentoo Bugzilla</uri>. The bugs will be
561or CCed to sparc@gentoo.org. 543 assigned, or CCed to sparc@gentoo.org.
562</p> 544 </li>
563 545</ul>
564</body>
565</section>
566<section>
567<title>Are there any currently known bugs/issues with software packages on
568Gentoo/SPARC?</title>
569<body>
570
571<p>
572A list of problematic packages can be found at
573<uri>http://dev.gentoo.org/~weeve/problems.html</uri>.
574</p>
575 546
576</body> 547</body>
577</section> 548</section>
578</chapter> 549</chapter>
579 550
580<chapter> 551<chapter>
581<title>Additional Resources</title> 552<title>Additional Resources</title>
582<section> 553<section>
554<title>Where can I get more help or information about SPARC/Linux?</title>
583<body> 555<body>
584
585<p>
586Here is some info on the Gentoo/SPARC project itself:
587</p>
588 556
589<ul> 557<ul>
590 <li><uri link="http://sparc.gentoo.org">Gentoo/SPARC Project Page</uri></li>
591 <li>#gentoo-sparc - Official IRC channel on irc.freenode.net</li>
592 <li> 558 <li>
593 <uri link="http://forums.gentoo.org/viewforum.php?f=27">Gentoo/SPARC 559 <uri link="http://docs.sun.com/app/docs/coll/216.2">OBP Reference
594 Forum</uri> 560 Guide</uri> - Sun's guide to the OpenBoot PROM
561 </li>
595 </li> 562 <li>
596 <li><mail>sparc@gentoo.org</mail> - Gentoo/SPARC team email address</li> 563 <uri link="http://www.sunstuff.org">OSIAH</uri> - Online Sun Information
597</ul> 564 Archive
598 565 </li>
599<p> 566 <li>
600Here are links to additional information about SPARC/Linux or SPARCs in general: 567 <uri link="http://www.obsolyte.com">Obsolyte</uri> - Information on older
601</p> 568 SPARC systems and links to a lot of other great SPARC related sites
602 569 </li>
603<ul> 570 <li>
571 <uri link="http://docs.sun.com">Sun Microsystems Documentation</uri> -
572 Additional hardware and software information for SPARC systems, including
573 instructions for flashing OBP
574 </li>
575 <li>
576 <uri link="http://sunsolve.sun.com">Sunsolve</uri> - Great resource for Sun
577 hardware documentation
578 </li>
604 <li> 579 <li>
605 <uri link="http://www.ultralinux.org">UltraLinux Homepage</uri> - Homepage 580 <uri link="http://www.ultralinux.org">UltraLinux Homepage</uri> - Homepage
606 of the SPARC/Linux port 581 of the SPARC/Linux port
607 </li> 582 </li>
608 <li>
609 <uri link="http://sunsolve.sun.com">Sunsolve</uri> - Great resource for Sun
610 hardware documentation
611 </li>
612 <li>
613 <uri>http://docs.sun.com</uri> - Additional hardware and software
614 information for SPARC systems, including instructions for flashing OBP
615 </li>
616 <li>
617 <uri link="http://www.obsolyte.com">Obsolyte</uri> - Information on older
618 SPARC systems and links to a lot of other great SPARC related sites
619 </li>
620 <li>
621 <uri
622 link="http://040.digital-bless.com/texts/Unofficial_Sun_Blade_100_FAQ.htm">Unofficial
623 Sun Blade 100 FAQ</uri> - Answers a lot of hardware related questions on
624 the Blade 100
625 </li>
626 <li>
627 <uri link="http://docs.sun.com/app/docs/coll/216.2">OBP Reference Guide</uri> -
628 Sun's guide to the OpenBoot PROM
629 </li>
630</ul> 583</ul>
631 584
632</body> 585</body>
633</section> 586</section>
634</chapter> 587</chapter>

Legend:
Removed from v.1.14  
changed lines
  Added in v.1.19

  ViewVC Help
Powered by ViewVC 1.1.20