Various egcs-1.0.1 related changes.
[official-gcc.git] / INSTALL / SPECIFIC
blob5cddc5c7c60325a5ceb6636992b687fe13345d4a
2            Host/Target specific installation notes for egcs-1.0.1
3                                       
4    alpha*-*-*
5    No specific installation needs/instructions.
6    
7    i?86-*-linux*
8    You will need binutils-2.8.1.0.15 or newer for exception handling to
9    work.
10    
11    i?86-*-sco3.2v5*
12    The SCO assembler is currently required. The GNU assembler is not up
13    to the task of switching between ELF and COFF at runtime.
14    Unlike various prereleases of GCC, that used '-belf' and defaulted to
15    COFF, you must now use the '-melf' and '-mcoff' flags to toggle
16    between the two object file formats. ELF is now the default.
17    Look in gcc/config/i386/sco5.h (search for "messy") for additional
18    OpenServer-specific flags.
19    
20    i?86-pc-solaris*
21    You'll need a patch to fix an egcs bug on this platform. [1]x86
22    solaris patch
23    
24    hppa*-hp-hpux*
25    We highly recommend using gas/binutils-2.8 on all hppa platforms; you
26    may encounter a variety of problems when using the HP assembler.
27    
28    hppa*-hp-hpux9
29    The HP assembler has major problems on this platform. We've tried to
30    work around the worst of the problems. However, those workarounds may
31    be causing linker crashes in some circumstances; the workarounds also
32    probably prevent shared libraries from working. Use the GNU assembler
33    to avoid these problems.
34    The configuration scripts for egcs will also trigger a bug in the
35    hpux9 shell. To avoid this problem set CONFIG_SHELL to /bin/ksh and
36    SHELL to /bin/ksh in your environment.
37    
38    hppa*-hp-hpux10
39    For hpux10.20, we highly recommend you pick up the latest sed patch
40    from HP. HP has two sites which provide patches free of charge.
41    [2]US, Canada, Asia-Pacific, and Latin-America
42    [3]Europe
43    
44    Retrieve patch PHCO_12862.
45    
46    The HP assembler on these systems is much better than the hpux9
47    assembler, but still has some problems. Most notably the assembler
48    inserts timestamps into each object file it creates, causing the
49    3-stage comparison test to fail during a "make bootstrap". You should
50    be able to continue by saying "make all" after getting the failure
51    from "make bootstrap".
52    
53    m68k-*-nextstep*
54    You absolutely must use GNU sed and GNU make on this platform.
55    
56    If you try to build the integrated C++ & C++ runtime libraries on this
57    system you will run into trouble with include files. The way to get
58    around this is to use the following sequence. Note you must have write
59    permission to prefix for this sequence to work.
60    
61    cd objdir
62    make all-texinfo all-bison all-byacc all-binutils all-gas all-ld
63    cd gcc
64    make bootstrap
65    make install-headers-tar
66    cd ..
67    make bootstrap3
68    
69    m68k-sun-sunos4.1.1
70    It is reported that you may need the GNU assembler on this platform.
71    
72    mips*-sgi-irix4
73    mips*-sgi-irix5
74    You must use GAS on these platforms, the native assembler can not
75    handle the code for exception handling support on this platform.
76    
77    These systems don't have ranlib, which various components in egcs
78    need; you should be able to avoid this problem by installing GNU
79    binutils, which includes a functional ranlib for this system.
80    
81    You may get the following warning on irix4 platforms, it can be safely
82    ignored.
84     warning: foo.o does not have gp tables for all its sections.
86    mips*-sgi-irix6
87    You must not use GAS on irix6 platforms; doing so will only cause
88    problems.
89    
90    These systems don't have ranlib, which various components in egcs
91    need; you should be able to avoid this problem by making a dummy
92    script called ranlib which just exits with zero status and placing it
93    in your path.
94    
95    rs6000-ibm-aix*
96    powerpc-ibm-aix*
97    At least one person as reported problems with older versions of
98    gnu-make on this platform. make-3.76 is reported to work correctly.
99    
100    powerpc-*-linux-gnu*
101    You will need [4]binutils-2.8.1.0.17 for a working egcs. It is
102    strongly recommended to recompile binutils with egcs if you initially
103    built it with gcc-2.7.2.*.
104    
105    sparc-unkonwn-linux-gnulibc1
106    It has been reported that you might need binutils-2.8.1.0.17 for this
107    platform too. [5]binutils-2.8.1.0.17
108    
109    exception handling
110    
111    XXX Linux stuff -k encaps stuff
112      _________________________________________________________________
113                                       
114    Last modified on Jan 2, 1998.
116 References
118    1. http://www.cygnus.com/egcs/faq.html#x86solaris
119    2. http://us-support.external.hp.com/
120    3. http://europe-support.external.hp.com/
121    4. ftp://ftp.yggdrasil.com/private/hjl
122    5. ftp://ftp.yggdrasil.com/private/hjl