diff options
| author | Jing Yu <jingyu@google.com> | 2009-11-05 15:11:04 -0800 |
|---|---|---|
| committer | Jing Yu <jingyu@google.com> | 2009-11-05 15:11:04 -0800 |
| commit | df62c1c110e8532b995b23540b7e3695729c0779 (patch) | |
| tree | dbbd4cbdb50ac38011e058a2533ee4c3168b0205 /gcc-4.3.1/INSTALL | |
| parent | 8d401cf711539af5a2f78d12447341d774892618 (diff) | |
| download | toolchain_gcc-df62c1c110e8532b995b23540b7e3695729c0779.tar.gz toolchain_gcc-df62c1c110e8532b995b23540b7e3695729c0779.tar.bz2 toolchain_gcc-df62c1c110e8532b995b23540b7e3695729c0779.zip | |
Check in gcc sources for prebuilt toolchains in Eclair.
Diffstat (limited to 'gcc-4.3.1/INSTALL')
| -rw-r--r-- | gcc-4.3.1/INSTALL/README | 6 | ||||
| -rw-r--r-- | gcc-4.3.1/INSTALL/binaries.html | 120 | ||||
| -rw-r--r-- | gcc-4.3.1/INSTALL/build.html | 314 | ||||
| -rw-r--r-- | gcc-4.3.1/INSTALL/configure.html | 1009 | ||||
| -rw-r--r-- | gcc-4.3.1/INSTALL/download.html | 90 | ||||
| -rw-r--r-- | gcc-4.3.1/INSTALL/finalinstall.html | 169 | ||||
| -rw-r--r-- | gcc-4.3.1/INSTALL/gfdl.html | 462 | ||||
| -rw-r--r-- | gcc-4.3.1/INSTALL/index.html | 123 | ||||
| -rw-r--r-- | gcc-4.3.1/INSTALL/old.html | 212 | ||||
| -rw-r--r-- | gcc-4.3.1/INSTALL/prerequisites.html | 243 | ||||
| -rw-r--r-- | gcc-4.3.1/INSTALL/specific.html | 1717 | ||||
| -rw-r--r-- | gcc-4.3.1/INSTALL/test.html | 232 |
12 files changed, 4697 insertions, 0 deletions
diff --git a/gcc-4.3.1/INSTALL/README b/gcc-4.3.1/INSTALL/README new file mode 100644 index 000000000..27bd1738b --- /dev/null +++ b/gcc-4.3.1/INSTALL/README @@ -0,0 +1,6 @@ +This directory has been obsoleted for GCC snapshots and CVS access. + +For releases the installation documentation is generated from +gcc/doc/install.texi and copied into this directory. + +To read this documentation, please point your HTML browser to "index.html". diff --git a/gcc-4.3.1/INSTALL/binaries.html b/gcc-4.3.1/INSTALL/binaries.html new file mode 100644 index 000000000..0abcbbb31 --- /dev/null +++ b/gcc-4.3.1/INSTALL/binaries.html @@ -0,0 +1,120 @@ +<html lang="en"> +<head> +<title>Installing GCC: Binaries</title> +<meta http-equiv="Content-Type" content="text/html"> +<meta name="description" content="Installing GCC: Binaries"> +<meta name="generator" content="makeinfo 4.11"> +<link title="Top" rel="top" href="#Top"> +<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage"> +<!-- +Copyright (C) 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998, +1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc. + + Permission is granted to copy, distribute and/or modify this document +under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no +Invariant Sections, the Front-Cover texts being (a) (see below), and +with the Back-Cover Texts being (b) (see below). A copy of the +license is included in the section entitled "GNU Free Documentation License". + +(a) The FSF's Front-Cover Text is: + + A GNU Manual + +(b) The FSF's Back-Cover Text is: + + You have freedom to copy and modify this GNU Manual, like GNU + software. Copies published by the Free Software Foundation raise + funds for GNU development.--> +<meta http-equiv="Content-Style-Type" content="text/css"> +<style type="text/css"><!-- + pre.display { font-family:inherit } + pre.format { font-family:inherit } + pre.smalldisplay { font-family:inherit; font-size:smaller } + pre.smallformat { font-family:inherit; font-size:smaller } + pre.smallexample { font-size:smaller } + pre.smalllisp { font-size:smaller } + span.sc { font-variant:small-caps } + span.roman { font-family:serif; font-weight:normal; } + span.sansserif { font-family:sans-serif; font-weight:normal; } +--></style> +</head> +<body> +<h1 class="settitle">Installing GCC: Binaries</h1> +<a name="index-Binaries-1"></a><a name="index-Installing-GCC_003a-Binaries-2"></a> +We are often asked about pre-compiled versions of GCC. While we cannot +provide these for all platforms, below you'll find links to binaries for +various platforms where creating them by yourself is not easy due to various +reasons. + + <p>Please note that we did not create these binaries, nor do we +support them. If you have any problems installing them, please +contact their makers. + + <ul> +<li>AIX: + <ul> +<li><a href="http://www.bullfreeware.com">Bull's Freeware and Shareware Archive for AIX</a>; + + <li><a href="http://aixpdslib.seas.ucla.edu">UCLA Software Library for AIX</a>. +</ul> + + <li>DOS—<a href="http://www.delorie.com/djgpp/">DJGPP</a>. + + <li>Renesas H8/300[HS]—<a href="http://h8300-hms.sourceforge.net/">GNU Development Tools for the Renesas H8/300[HS] Series</a>. + + <li>HP-UX: + <ul> +<li><a href="http://hpux.cs.utah.edu/">HP-UX Porting Center</a>; + + <li><a href="ftp://sunsite.informatik.rwth-aachen.de/pub/packages/gcc_hpux/">Binaries for HP-UX 11.00 at Aachen University of Technology</a>. +</ul> + + <li>Motorola 68HC11/68HC12—<a href="http://www.gnu-m68hc11.org">GNU Development Tools for the Motorola 68HC11/68HC12</a>. + + <li><a href="http://www.sco.com/skunkware/devtools/index.html#gcc">SCO OpenServer/Unixware</a>. + + <li>Solaris 2 (SPARC, Intel)—<a href="http://www.sunfreeware.com/">Sunfreeware</a>. + + <li>SGI—<a href="http://freeware.sgi.com/">SGI Freeware</a>. + + <li>Microsoft Windows: + <ul> +<li>The <a href="http://sourceware.org/cygwin/">Cygwin</a> project; +<li>The <a href="http://www.mingw.org/">MinGW</a> project. +</ul> + + <li><a href="ftp://ftp.thewrittenword.com/packages/by-name/">The Written Word</a> offers binaries for +AIX 4.3.2. +IRIX 6.5, +Digital UNIX 4.0D and 5.1, +GNU/Linux (i386), +HP-UX 10.20, 11.00, and 11.11, and +Solaris/SPARC 2.5.1, 2.6, 7, 8, and 9. + + <li><a href="http://www.openpkg.org/">OpenPKG</a> offers binaries for quite a +number of platforms. + + <li>The <a href="http://gcc.gnu.org/wiki/GFortranBinaries">GFortran Wiki</a> has +links to GNU Fortran binaries for several platforms. +</ul> + + <p>In addition to those specific offerings, you can get a binary +distribution CD-ROM from the +<a href="http://www.gnu.org/order/order.html">Free Software Foundation</a>. +It contains binaries for a number of platforms, and +includes not only GCC, but other stuff as well. The current CD does +not contain the latest version of GCC, but it should allow +bootstrapping the compiler. An updated version of that disk is in the +works. + + <p><hr /> +<p><a href="./index.html">Return to the GCC Installation page</a> + +<!-- ***Specific**************************************************************** --> +<!-- ***Old documentation****************************************************** --> +<!-- ***GFDL******************************************************************** --> +<!-- *************************************************************************** --> +<!-- Part 6 The End of the Document --> +</body></html> + diff --git a/gcc-4.3.1/INSTALL/build.html b/gcc-4.3.1/INSTALL/build.html new file mode 100644 index 000000000..c654aa1ca --- /dev/null +++ b/gcc-4.3.1/INSTALL/build.html @@ -0,0 +1,314 @@ +<html lang="en"> +<head> +<title>Installing GCC: Building</title> +<meta http-equiv="Content-Type" content="text/html"> +<meta name="description" content="Installing GCC: Building"> +<meta name="generator" content="makeinfo 4.11"> +<link title="Top" rel="top" href="#Top"> +<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage"> +<!-- +Copyright (C) 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998, +1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc. + + Permission is granted to copy, distribute and/or modify this document +under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no +Invariant Sections, the Front-Cover texts being (a) (see below), and +with the Back-Cover Texts being (b) (see below). A copy of the +license is included in the section entitled "GNU Free Documentation License". + +(a) The FSF's Front-Cover Text is: + + A GNU Manual + +(b) The FSF's Back-Cover Text is: + + You have freedom to copy and modify this GNU Manual, like GNU + software. Copies published by the Free Software Foundation raise + funds for GNU development.--> +<meta http-equiv="Content-Style-Type" content="text/css"> +<style type="text/css"><!-- + pre.display { font-family:inherit } + pre.format { font-family:inherit } + pre.smalldisplay { font-family:inherit; font-size:smaller } + pre.smallformat { font-family:inherit; font-size:smaller } + pre.smallexample { font-size:smaller } + pre.smalllisp { font-size:smaller } + span.sc { font-variant:small-caps } + span.roman { font-family:serif; font-weight:normal; } + span.sansserif { font-family:sans-serif; font-weight:normal; } +--></style> +</head> +<body> +<h1 class="settitle">Installing GCC: Building</h1> +<a name="index-Installing-GCC_003a-Building-1"></a> +Now that GCC is configured, you are ready to build the compiler and +runtime libraries. + + <p>Some commands executed when making the compiler may fail (return a +nonzero status) and be ignored by <samp><span class="command">make</span></samp>. These failures, which +are often due to files that were not found, are expected, and can safely +be ignored. + + <p>It is normal to have compiler warnings when compiling certain files. +Unless you are a GCC developer, you can generally ignore these warnings +unless they cause compilation to fail. Developers should attempt to fix +any warnings encountered, however they can temporarily continue past +warnings-as-errors by specifying the configure flag +<samp><span class="option">--disable-werror</span></samp>. + + <p>On certain old systems, defining certain environment variables such as +<samp><span class="env">CC</span></samp> can interfere with the functioning of <samp><span class="command">make</span></samp>. + + <p>If you encounter seemingly strange errors when trying to build the +compiler in a directory other than the source directory, it could be +because you have previously configured the compiler in the source +directory. Make sure you have done all the necessary preparations. + + <p>If you build GCC on a BSD system using a directory stored in an old System +V file system, problems may occur in running <samp><span class="command">fixincludes</span></samp> if the +System V file system doesn't support symbolic links. These problems +result in a failure to fix the declaration of <code>size_t</code> in +<samp><span class="file">sys/types.h</span></samp>. If you find that <code>size_t</code> is a signed type and +that type mismatches occur, this could be the cause. + + <p>The solution is not to use such a directory for building GCC. + + <p>When building from SVN or snapshots and enabling the <code>treelang</code> +front end, or if you modify <samp><span class="file">*.y</span></samp> files, you need the Bison parser +generator installed. If you do not modify <samp><span class="file">*.y</span></samp> files, releases +contain the Bison-generated files and you do not need Bison installed +to build them. Note that most front ends now use hand-written parsers, +which can be modified with no need for Bison. + + <p>Similarly, when building from SVN or snapshots, or if you modify +<samp><span class="file">*.l</span></samp> files, you need the Flex lexical analyzer generator installed. +There is still one Flex-based lexical analyzer (part of the build +machinery, not of GCC itself) that is used even if you only build the +C front end. + + <p>When building from SVN or snapshots, or if you modify Texinfo +documentation, you need version 4.4 or later of Texinfo installed if you +want Info documentation to be regenerated. Releases contain Info +documentation pre-built for the unmodified documentation in the release. + +<h3 class="section"><a name="TOC0"></a>0.1 Building a native compiler</h3> + +<p>For a native build, the default configuration is to perform +a 3-stage bootstrap of the compiler when ‘<samp><span class="samp">make</span></samp>’ is invoked. +This will build the entire GCC system and ensure that it compiles +itself correctly. It can be disabled with the <samp><span class="option">--disable-bootstrap</span></samp> +parameter to ‘<samp><span class="samp">configure</span></samp>’, but bootstrapping is suggested because +the compiler will be tested more completely and could also have +better performance. + + <p>The bootstrapping process will complete the following steps: + + <ul> +<li>Build tools necessary to build the compiler. + + <li>Perform a 3-stage bootstrap of the compiler. This includes building +three times the target tools for use by the compiler such as binutils +(bfd, binutils, gas, gprof, ld, and opcodes) if they have been +individually linked or moved into the top level GCC source tree before +configuring. + + <li>Perform a comparison test of the stage2 and stage3 compilers. + + <li>Build runtime libraries using the stage3 compiler from the previous step. + + </ul> + + <p>If you are short on disk space you might consider ‘<samp><span class="samp">make +bootstrap-lean</span></samp>’ instead. The sequence of compilation is the +same described above, but object files from the stage1 and +stage2 of the 3-stage bootstrap of the compiler are deleted as +soon as they are no longer needed. + + <p>If you want to save additional space during the bootstrap and in +the final installation as well, you can build the compiler binaries +without debugging information as in the following example. This will save +roughly 40% of disk space both for the bootstrap and the final installation. +(Libraries will still contain debugging information.) + +<pre class="smallexample"> make CFLAGS='-O' LIBCFLAGS='-g -O2' \ + LIBCXXFLAGS='-g -O2 -fno-implicit-templates' bootstrap +</pre> + <p>If you wish to use non-default GCC flags when compiling the stage2 and +stage3 compilers, set <code>BOOT_CFLAGS</code> on the command line when doing +‘<samp><span class="samp">make</span></samp>’. Non-default optimization flags are less well +tested here than the default of ‘<samp><span class="samp">-g -O2</span></samp>’, but should still work. +In a few cases, you may find that you need to specify special flags such +as <samp><span class="option">-msoft-float</span></samp> here to complete the bootstrap; or, if the +native compiler miscompiles the stage1 compiler, you may need to work +around this, by choosing <code>BOOT_CFLAGS</code> to avoid the parts of the +stage1 compiler that were miscompiled, or by using ‘<samp><span class="samp">make +bootstrap4</span></samp>’ to increase the number of stages of bootstrap. + + <p>Note that using non-standard <code>CFLAGS</code> can cause bootstrap to fail +if these trigger a warning with the new compiler. For example using +‘<samp><span class="samp">-O2 -g -mcpu=i686</span></samp>’ on <code>i686-pc-linux-gnu</code> will cause bootstrap +failure as <samp><span class="option">-mcpu=</span></samp> is deprecated in 3.4.0 and above. + + <p>If you used the flag <samp><span class="option">--enable-languages=...</span></samp> to restrict +the compilers to be built, only those you've actually enabled will be +built. This will of course only build those runtime libraries, for +which the particular compiler has been built. Please note, +that re-defining <samp><span class="env">LANGUAGES</span></samp> when calling ‘<samp><span class="samp">make</span></samp>’ +<strong>does not</strong> work anymore! + + <p>If the comparison of stage2 and stage3 fails, this normally indicates +that the stage2 compiler has compiled GCC incorrectly, and is therefore +a potentially serious bug which you should investigate and report. (On +a few systems, meaningful comparison of object files is impossible; they +always appear “different”. If you encounter this problem, you will +need to disable comparison in the <samp><span class="file">Makefile</span></samp>.) + + <p>If you do not want to bootstrap your compiler, you can configure with +<samp><span class="option">--disable-bootstrap</span></samp>. In particular cases, you may want to +bootstrap your compiler even if the target system is not the same as +the one you are building on: for example, you could build a +<code>powerpc-unknown-linux-gnu</code> toolchain on a +<code>powerpc64-unknown-linux-gnu</code> host. In this case, pass +<samp><span class="option">--enable-bootstrap</span></samp> to the configure script. + +<h3 class="section"><a name="TOC1"></a>0.2 Building a cross compiler</h3> + +<p>When building a cross compiler, it is not generally possible to do a +3-stage bootstrap of the compiler. This makes for an interesting problem +as parts of GCC can only be built with GCC. + + <p>To build a cross compiler, we first recommend building and installing a +native compiler. You can then use the native GCC compiler to build the +cross compiler. The installed native compiler needs to be GCC version +2.95 or later. + + <p>If the cross compiler is to be built with support for the Java +programming language and the ability to compile .java source files is +desired, the installed native compiler used to build the cross +compiler needs to be the same GCC version as the cross compiler. In +addition the cross compiler needs to be configured with +<samp><span class="option">--with-ecj-jar=...</span></samp>. + + <p>Assuming you have already installed a native copy of GCC and configured +your cross compiler, issue the command <samp><span class="command">make</span></samp>, which performs the +following steps: + + <ul> +<li>Build host tools necessary to build the compiler. + + <li>Build target tools for use by the compiler such as binutils (bfd, +binutils, gas, gprof, ld, and opcodes) +if they have been individually linked or moved into the top level GCC source +tree before configuring. + + <li>Build the compiler (single stage only). + + <li>Build runtime libraries using the compiler from the previous step. +</ul> + + <p>Note that if an error occurs in any step the make process will exit. + + <p>If you are not building GNU binutils in the same source tree as GCC, +you will need a cross-assembler and cross-linker installed before +configuring GCC. Put them in the directory +<samp><var>prefix</var><span class="file">/</span><var>target</var><span class="file">/bin</span></samp>. Here is a table of the tools +you should put in this directory: + + <dl> +<dt><samp><span class="file">as</span></samp><dd>This should be the cross-assembler. + + <br><dt><samp><span class="file">ld</span></samp><dd>This should be the cross-linker. + + <br><dt><samp><span class="file">ar</span></samp><dd>This should be the cross-archiver: a program which can manipulate +archive files (linker libraries) in the target machine's format. + + <br><dt><samp><span class="file">ranlib</span></samp><dd>This should be a program to construct a symbol table in an archive file. +</dl> + + <p>The installation of GCC will find these programs in that directory, +and copy or link them to the proper place to for the cross-compiler to +find them when run later. + + <p>The easiest way to provide these files is to build the Binutils package. +Configure it with the same <samp><span class="option">--host</span></samp> and <samp><span class="option">--target</span></samp> +options that you use for configuring GCC, then build and install +them. They install their executables automatically into the proper +directory. Alas, they do not support all the targets that GCC +supports. + + <p>If you are not building a C library in the same source tree as GCC, +you should also provide the target libraries and headers before +configuring GCC, specifying the directories with +<samp><span class="option">--with-sysroot</span></samp> or <samp><span class="option">--with-headers</span></samp> and +<samp><span class="option">--with-libs</span></samp>. Many targets also require “start files” such +as <samp><span class="file">crt0.o</span></samp> and +<samp><span class="file">crtn.o</span></samp> which are linked into each executable. There may be several +alternatives for <samp><span class="file">crt0.o</span></samp>, for use with profiling or other +compilation options. Check your target's definition of +<code>STARTFILE_SPEC</code> to find out what start files it uses. + +<h3 class="section"><a name="TOC2"></a>0.3 Building in parallel</h3> + +<p>GNU Make 3.79 and above, which is necessary to build GCC, support +building in parallel. To activate this, you can use ‘<samp><span class="samp">make -j 2</span></samp>’ +instead of ‘<samp><span class="samp">make</span></samp>’. You can also specify a bigger number, and +in most cases using a value greater than the number of processors in +your machine will result in fewer and shorter I/O latency hits, thus +improving overall throughput; this is especially true for slow drives +and network filesystems. + +<h3 class="section"><a name="TOC3"></a>0.4 Building the Ada compiler</h3> + +<p>In order to build GNAT, the Ada compiler, you need a working GNAT +compiler (GNAT version 3.14 or later, or GCC version 3.1 or later). +This includes GNAT tools such as <samp><span class="command">gnatmake</span></samp> and +<samp><span class="command">gnatlink</span></samp>, since the Ada front end is written in Ada and +uses some GNAT-specific extensions. + + <p>In order to build a cross compiler, it is suggested to install +the new compiler as native first, and then use it to build the cross +compiler. + + <p><samp><span class="command">configure</span></samp> does not test whether the GNAT installation works +and has a sufficiently recent version; if too old a GNAT version is +installed, the build will fail unless <samp><span class="option">--enable-languages</span></samp> is +used to disable building the Ada front end. + + <p><samp><span class="env">ADA_INCLUDE_PATH</span></samp> and <samp><span class="env">ADA_OBJECT_PATH</span></samp> environment variables +must not be set when building the Ada compiler, the Ada tools, or the +Ada runtime libraries. You can check that your build environment is clean +by verifying that ‘<samp><span class="samp">gnatls -v</span></samp>’ lists only one explicit path in each +section. + +<h3 class="section"><a name="TOC4"></a>0.5 Building with profile feedback</h3> + +<p>It is possible to use profile feedback to optimize the compiler itself. This +should result in a faster compiler binary. Experiments done on x86 using gcc +3.3 showed approximately 7 percent speedup on compiling C programs. To +bootstrap the compiler with profile feedback, use <code>make profiledbootstrap</code>. + + <p>When ‘<samp><span class="samp">make profiledbootstrap</span></samp>’ is run, it will first build a <code>stage1</code> +compiler. This compiler is used to build a <code>stageprofile</code> compiler +instrumented to collect execution counts of instruction and branch +probabilities. Then runtime libraries are compiled with profile collected. +Finally a <code>stagefeedback</code> compiler is built using the information collected. + + <p>Unlike standard bootstrap, several additional restrictions apply. The +compiler used to build <code>stage1</code> needs to support a 64-bit integral type. +It is recommended to only use GCC for this. Also parallel make is currently +not supported since collisions in profile collecting may occur. + + <p><hr /> +<p><a href="./index.html">Return to the GCC Installation page</a> + +<!-- ***Testing***************************************************************** --> +<!-- ***Final install*********************************************************** --> +<!-- ***Binaries**************************************************************** --> +<!-- ***Specific**************************************************************** --> +<!-- ***Old documentation****************************************************** --> +<!-- ***GFDL******************************************************************** --> +<!-- *************************************************************************** --> +<!-- Part 6 The End of the Document --> +</body></html> + diff --git a/gcc-4.3.1/INSTALL/configure.html b/gcc-4.3.1/INSTALL/configure.html new file mode 100644 index 000000000..f37005c51 --- /dev/null +++ b/gcc-4.3.1/INSTALL/configure.html @@ -0,0 +1,1009 @@ +<html lang="en"> +<head> +<title>Installing GCC: Configuration</title> +<meta http-equiv="Content-Type" content="text/html"> +<meta name="description" content="Installing GCC: Configuration"> +<meta name="generator" content="makeinfo 4.11"> +<link title="Top" rel="top" href="#Top"> +<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage"> +<!-- +Copyright (C) 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998, +1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc. + + Permission is granted to copy, distribute and/or modify this document +under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no +Invariant Sections, the Front-Cover texts being (a) (see below), and +with the Back-Cover Texts being (b) (see below). A copy of the +license is included in the section entitled "GNU Free Documentation License". + +(a) The FSF's Front-Cover Text is: + + A GNU Manual + +(b) The FSF's Back-Cover Text is: + + You have freedom to copy and modify this GNU Manual, like GNU + software. Copies published by the Free Software Foundation raise + funds for GNU development.--> +<meta http-equiv="Content-Style-Type" content="text/css"> +<style type="text/css"><!-- + pre.display { font-family:inherit } + pre.format { font-family:inherit } + pre.smalldisplay { font-family:inherit; font-size:smaller } + pre.smallformat { font-family:inherit; font-size:smaller } + pre.smallexample { font-size:smaller } + pre.smalllisp { font-size:smaller } + span.sc { font-variant:small-caps } + span.roman { font-family:serif; font-weight:normal; } + span.sansserif { font-family:sans-serif; font-weight:normal; } +--></style> +</head> +<body> +<h1 class="settitle">Installing GCC: Configuration</h1> +<a name="index-Configuration-1"></a><a name="index-Installing-GCC_003a-Configuration-2"></a> +Like most GNU software, GCC must be configured before it can be built. +This document describes the recommended configuration procedure +for both native and cross targets. + + <p>We use <var>srcdir</var> to refer to the toplevel source directory for +GCC; we use <var>objdir</var> to refer to the toplevel build/object directory. + + <p>If you obtained the sources via SVN, <var>srcdir</var> must refer to the top +<samp><span class="file">gcc</span></samp> directory, the one where the <samp><span class="file">MAINTAINERS</span></samp> can be found, +and not its <samp><span class="file">gcc</span></samp> subdirectory, otherwise the build will fail. + + <p>If either <var>srcdir</var> or <var>objdir</var> is located on an automounted NFS +file system, the shell's built-in <samp><span class="command">pwd</span></samp> command will return +temporary pathnames. Using these can lead to various sorts of build +problems. To avoid this issue, set the <samp><span class="env">PWDCMD</span></samp> environment +variable to an automounter-aware <samp><span class="command">pwd</span></samp> command, e.g., +<samp><span class="command">pawd</span></samp> or ‘<samp><span class="samp">amq -w</span></samp>’, during the configuration and build +phases. + + <p>First, we <strong>highly</strong> recommend that GCC be built into a +separate directory than the sources which does <strong>not</strong> reside +within the source tree. This is how we generally build GCC; building +where <var>srcdir</var> == <var>objdir</var> should still work, but doesn't +get extensive testing; building where <var>objdir</var> is a subdirectory +of <var>srcdir</var> is unsupported. + + <p>If you have previously built GCC in the same directory for a +different target machine, do ‘<samp><span class="samp">make distclean</span></samp>’ to delete all files +that might be invalid. One of the files this deletes is <samp><span class="file">Makefile</span></samp>; +if ‘<samp><span class="samp">make distclean</span></samp>’ complains that <samp><span class="file">Makefile</span></samp> does not exist +or issues a message like “don't know how to make distclean” it probably +means that the directory is already suitably clean. However, with the +recommended method of building in a separate <var>objdir</var>, you should +simply use a different <var>objdir</var> for each target. + + <p>Second, when configuring a native system, either <samp><span class="command">cc</span></samp> or +<samp><span class="command">gcc</span></samp> must be in your path or you must set <samp><span class="env">CC</span></samp> in +your environment before running configure. Otherwise the configuration +scripts may fail. + + <p>To configure GCC: + +<pre class="smallexample"> % mkdir <var>objdir</var> + % cd <var>objdir</var> + % <var>srcdir</var>/configure [<var>options</var>] [<var>target</var>] +</pre> + <h3 class="heading"><a name="TOC0"></a>Distributor options</h3> + +<p>If you will be distributing binary versions of GCC, with modifications +to the source code, you should use the options described in this +section to make clear that your version contains modifications. + + <dl> +<dt><code>--with-pkgversion=</code><var>version</var><dd>Specify a string that identifies your package. You may wish +to include a build number or build date. This version string will be +included in the output of <samp><span class="command">gcc --version</span></samp>. This suffix does +not replace the default version string, only the ‘<samp><span class="samp">GCC</span></samp>’ part. + + <p>The default value is ‘<samp><span class="samp">GCC</span></samp>’. + + <br><dt><code>--with-bugurl=</code><var>url</var><dd>Specify the URL that users should visit if they wish to report a bug. +You are of course welcome to forward bugs reported to you to the FSF, +if you determine that they are not bugs in your modifications. + + <p>The default value refers to the FSF's GCC bug tracker. + + </dl> + +<h3 class="heading"><a name="TOC1"></a>Target specification</h3> + + <ul> +<li>GCC has code to correctly determine the correct value for <var>target</var> +for nearly all native systems. Therefore, we highly recommend you not +provide a configure target when configuring a native compiler. + + <li><var>target</var> must be specified as <samp><span class="option">--target=</span><var>target</var></samp> +when configuring a cross compiler; examples of valid targets would be +m68k-coff, sh-elf, etc. + + <li>Specifying just <var>target</var> instead of <samp><span class="option">--target=</span><var>target</var></samp> +implies that the host defaults to <var>target</var>. +</ul> + +<h3 class="heading"><a name="TOC2"></a>Options specification</h3> + +<p>Use <var>options</var> to override several configure time options for +GCC. A list of supported <var>options</var> follows; ‘<samp><span class="samp">configure +--help</span></samp>’ may list other options, but those not listed below may not +work and should not normally be used. + + <p>Note that each <samp><span class="option">--enable</span></samp> option has a corresponding +<samp><span class="option">--disable</span></samp> option and that each <samp><span class="option">--with</span></samp> option has a +corresponding <samp><span class="option">--without</span></samp> option. + + <dl> +<dt><code>--prefix=</code><var>dirname</var><dd>Specify the toplevel installation +directory. This is the recommended way to install the tools into a directory +other than the default. The toplevel installation directory defaults to +<samp><span class="file">/usr/local</span></samp>. + + <p>We <strong>highly</strong> recommend against <var>dirname</var> being the same or a +subdirectory of <var>objdir</var> or vice versa. If specifying a directory +beneath a user's home directory tree, some shells will not expand +<var>dirname</var> correctly if it contains the ‘<samp><span class="samp">~</span></samp>’ metacharacter; use +<samp><span class="env">$HOME</span></samp> instead. + + <p>The following standard <samp><span class="command">autoconf</span></samp> options are supported. Normally you +should not need to use these options. + <dl> +<dt><code>--exec-prefix=</code><var>dirname</var><dd>Specify the toplevel installation directory for architecture-dependent +files. The default is <samp><var>prefix</var></samp>. + + <br><dt><code>--bindir=</code><var>dirname</var><dd>Specify the installation directory for the executables called by users +(such as <samp><span class="command">gcc</span></samp> and <samp><span class="command">g++</span></samp>). The default is +<samp><var>exec-prefix</var><span class="file">/bin</span></samp>. + + <br><dt><code>--libdir=</code><var>dirname</var><dd>Specify the installation directory for object code libraries and +internal data files of GCC. The default is <samp><var>exec-prefix</var><span class="file">/lib</span></samp>. + + <br><dt><code>--libexecdir=</code><var>dirname</var><dd>Specify the installation directory for internal executables of GCC. + The default is <samp><var>exec-prefix</var><span class="file">/libexec</span></samp>. + + <br><dt><code>--with-slibdir=</code><var>dirname</var><dd>Specify the installation directory for the shared libgcc library. The +default is <samp><var>libdir</var></samp>. + + <br><dt><code>--infodir=</code><var>dirname</var><dd>Specify the installation directory for documentation in info format. +The default is <samp><var>prefix</var><span class="file">/info</span></samp>. + + <br><dt><code>--datadir=</code><var>dirname</var><dd>Specify the installation directory for some architecture-independent +data files referenced by GCC. The default is <samp><var>prefix</var><span class="file">/share</span></samp>. + + <br><dt><code>--mandir=</code><var>dirname</var><dd>Specify the installation directory for manual pages. The default is +<samp><var>prefix</var><span class="file">/man</span></samp>. (Note that the manual pages are only extracts from +the full GCC manuals, which are provided in Texinfo format. The manpages +are derived by an automatic conversion process from parts of the full +manual.) + + <br><dt><code>--with-gxx-include-dir=</code><var>dirname</var><dd>Specify +the installation directory for G++ header files. The default is +<samp><var>prefix</var><span class="file">/include/c++/</span><var>version</var></samp>. + + </dl> + + <br><dt><code>--program-prefix=</code><var>prefix</var><dd>GCC supports some transformations of the names of its programs when +installing them. This option prepends <var>prefix</var> to the names of +programs to install in <var>bindir</var> (see above). For example, specifying +<samp><span class="option">--program-prefix=foo-</span></samp> would result in ‘<samp><span class="samp">gcc</span></samp>’ +being installed as <samp><span class="file">/usr/local/bin/foo-gcc</span></samp>. + + <br><dt><code>--program-suffix=</code><var>suffix</var><dd>Appends <var>suffix</var> to the names of programs to install in <var>bindir</var> +(see above). For example, specifying <samp><span class="option">--program-suffix=-3.1</span></samp> +would result in ‘<samp><span class="samp">gcc</span></samp>’ being installed as +<samp><span class="file">/usr/local/bin/gcc-3.1</span></samp>. + + <br><dt><code>--program-transform-name=</code><var>pattern</var><dd>Applies the ‘<samp><span class="samp">sed</span></samp>’ script <var>pattern</var> to be applied to the names +of programs to install in <var>bindir</var> (see above). <var>pattern</var> has to +consist of one or more basic ‘<samp><span class="samp">sed</span></samp>’ editing commands, separated by +semicolons. For example, if you want the ‘<samp><span class="samp">gcc</span></samp>’ program name to be +transformed to the installed program <samp><span class="file">/usr/local/bin/myowngcc</span></samp> and +the ‘<samp><span class="samp">g++</span></samp>’ program name to be transformed to +<samp><span class="file">/usr/local/bin/gspecial++</span></samp> without changing other program names, +you could use the pattern +<samp><span class="option">--program-transform-name='s/^gcc$/myowngcc/; s/^g++$/gspecial++/'</span></samp> +to achieve this effect. + + <p>All three options can be combined and used together, resulting in more +complex conversion patterns. As a basic rule, <var>prefix</var> (and +<var>suffix</var>) are prepended (appended) before further transformations +can happen with a special transformation script <var>pattern</var>. + + <p>As currently implemented, this option only takes effect for native +builds; cross compiler binaries' names are not transformed even when a +transformation is explicitly asked for by one of these options. + + <p>For native builds, some of the installed programs are also installed +with the target alias in front of their name, as in +‘<samp><span class="samp">i686-pc-linux-gnu-gcc</span></samp>’. All of the above transformations happen +before the target alias is prepended to the name—so, specifying +<samp><span class="option">--program-prefix=foo-</span></samp> and <samp><span class="option">program-suffix=-3.1</span></samp>, the +resulting binary would be installed as +<samp><span class="file">/usr/local/bin/i686-pc-linux-gnu-foo-gcc-3.1</span></samp>. + + <p>As a last shortcoming, none of the installed Ada programs are +transformed yet, which will be fixed in some time. + + <br><dt><code>--with-local-prefix=</code><var>dirname</var><dd>Specify the +installation directory for local include files. The default is +<samp><span class="file">/usr/local</span></samp>. Specify this option if you want the compiler to +search directory <samp><var>dirname</var><span class="file">/include</span></samp> for locally installed +header files <em>instead</em> of <samp><span class="file">/usr/local/include</span></samp>. + + <p>You should specify <samp><span class="option">--with-local-prefix</span></samp> <strong>only</strong> if your +site has a different convention (not <samp><span class="file">/usr/local</span></samp>) for where to put +site-specific files. + + <p>The default value for <samp><span class="option">--with-local-prefix</span></samp> is <samp><span class="file">/usr/local</span></samp> +regardless of the value of <samp><span class="option">--prefix</span></samp>. Specifying +<samp><span class="option">--prefix</span></samp> has no effect on which directory GCC searches for +local header files. This may seem counterintuitive, but actually it is +logical. + + <p>The purpose of <samp><span class="option">--prefix</span></samp> is to specify where to <em>install +GCC</em>. The local header files in <samp><span class="file">/usr/local/include</span></samp>—if you put +any in that directory—are not part of GCC. They are part of other +programs—perhaps many others. (GCC installs its own header files in +another directory which is based on the <samp><span class="option">--prefix</span></samp> value.) + + <p>Both the local-prefix include directory and the GCC-prefix include +directory are part of GCC's “system include” directories. Although these +two directories are not fixed, they need to be searched in the proper +order for the correct processing of the include_next directive. The +local-prefix include directory is searched before the GCC-prefix +include directory. Another characteristic of system include directories +is that pedantic warnings are turned off for headers in these directories. + + <p>Some autoconf macros add <samp><span class="option">-I </span><var>directory</var></samp> options to the +compiler command line, to ensure that directories containing installed +packages' headers are searched. When <var>directory</var> is one of GCC's +system include directories, GCC will ignore the option so that system +directories continue to be processed in the correct order. This +may result in a search order different from what was specified but the +directory will still be searched. + + <p>GCC automatically searches for ordinary libraries using +<samp><span class="env">GCC_EXEC_PREFIX</span></samp>. Thus, when the same installation prefix is +used for both GCC and packages, GCC will automatically search for +both headers and libraries. This provides a configuration that is +easy to use. GCC behaves in a manner similar to that when it is +installed as a system compiler in <samp><span class="file">/usr</span></samp>. + + <p>Sites that need to install multiple versions of GCC may not want to +use the above simple configuration. It is possible to use the +<samp><span class="option">--program-prefix</span></samp>, <samp><span class="option">--program-suffix</span></samp> and +<samp><span class="option">--program-transform-name</span></samp> options to install multiple versions +into a single directory, but it may be simpler to use different prefixes +and the <samp><span class="option">--with-local-prefix</span></samp> option to specify the location of the +site-specific files for each version. It will then be necessary for +users to specify explicitly the location of local site libraries +(e.g., with <samp><span class="env">LIBRARY_PATH</span></samp>). + + <p>The same value can be used for both <samp><span class="option">--with-local-prefix</span></samp> and +<samp><span class="option">--prefix</span></samp> provided it is not <samp><span class="file">/usr</span></samp>. This can be used +to avoid the default search of <samp><span class="file">/usr/local/include</span></samp>. + + <p><strong>Do not</strong> specify <samp><span class="file">/usr</span></samp> as the <samp><span class="option">--with-local-prefix</span></samp>! +The directory you use for <samp><span class="option">--with-local-prefix</span></samp> <strong>must not</strong> +contain any of the system's standard header files. If it did contain +them, certain programs would be miscompiled (including GNU Emacs, on +certain targets), because this would override and nullify the header +file corrections made by the <samp><span class="command">fixincludes</span></samp> script. + + <p>Indications are that people who use this option use it based on mistaken +ideas of what it is for. People use it as if it specified where to +install part of GCC. Perhaps they make this assumption because +installing GCC creates the directory. + + <br><dt><code>--enable-shared[=</code><var>package</var><code>[,...]]</code><dd>Build shared versions of libraries, if shared libraries are supported on +the target platform. Unlike GCC 2.95.x and earlier, shared libraries +are enabled by default on all platforms that support shared libraries. + + <p>If a list of packages is given as an argument, build shared libraries +only for the listed packages. For other packages, only static libraries +will be built. Package names currently recognized in the GCC tree are +‘<samp><span class="samp">libgcc</span></samp>’ (also known as ‘<samp><span class="samp">gcc</span></samp>’), ‘<samp><span class="samp">libstdc++</span></samp>’ (not +‘<samp><span class="samp">libstdc++-v3</span></samp>’), ‘<samp><span class="samp">libffi</span></samp>’, ‘<samp><span class="samp">zlib</span></samp>’, ‘<samp><span class="samp">boehm-gc</span></samp>’, +‘<samp><span class="samp">ada</span></samp>’, ‘<samp><span class="samp">libada</span></samp>’, ‘<samp><span class="samp">libjava</span></samp>’ and ‘<samp><span class="samp">libobjc</span></samp>’. +Note ‘<samp><span class="samp">libiberty</span></samp>’ does not support shared libraries at all. + + <p>Use <samp><span class="option">--disable-shared</span></samp> to build only static libraries. Note that +<samp><span class="option">--disable-shared</span></samp> does not accept a list of package names as +argument, only <samp><span class="option">--enable-shared</span></samp> does. + + <br><dt><code><a name="with_002dgnu_002das"></a>--with-gnu-as</code><dd>Specify that the compiler should assume that the +assembler it finds is the GNU assembler. However, this does not modify +the rules to find an assembler and will result in confusion if the +assembler found is not actually the GNU assembler. (Confusion may also +result if the compiler finds the GNU assembler but has not been +configured with <samp><span class="option">--with-gnu-as</span></samp>.) If you have more than one +assembler installed on your system, you may want to use this option in +connection with <samp><span class="option">--with-as=</span><var>pathname</var></samp> or +<samp><span class="option">--with-build-time-tools=</span><var>pathname</var></samp>. + + <p>The following systems are the only ones where it makes a difference +whether you use the GNU assembler. On any other system, +<samp><span class="option">--with-gnu-as</span></samp> has no effect. + + <ul> +<li>‘<samp><span class="samp">hppa1.0-</span><var>any</var><span class="samp">-</span><var>any</var></samp>’ +<li>‘<samp><span class="samp">hppa1.1-</span><var>any</var><span class="samp">-</span><var>any</var></samp>’ +<li>‘<samp><span class="samp">i386-</span><var>any</var><span class="samp">-sysv</span></samp>’ +<li>‘<samp><span class="samp">m68k-bull-sysv</span></samp>’ +<li>‘<samp><span class="samp">m68k-hp-hpux</span></samp>’ +<li>‘<samp><span class="samp">m68000-hp-hpux</span></samp>’ +<li>‘<samp><span class="samp">m68000-att-sysv</span></samp>’ +<li>‘<samp><span class="samp">sparc-sun-solaris2.</span><var>any</var></samp>’ +<li>‘<samp><span class="samp">sparc64-</span><var>any</var><span class="samp">-solaris2.</span><var>any</var></samp>’ +</ul> + + <p>On the systems listed above (except for the HP-PA, the SPARC, for ISC on +the 386, if you use the GNU assembler, you should also use the GNU linker +(and specify <samp><span class="option">--with-gnu-ld</span></samp>). + + <br><dt><code><a name="with_002das"></a>--with-as=</code><var>pathname</var><dd>Specify that the compiler should use the assembler pointed to by +<var>pathname</var>, rather than the one found by the standard rules to find +an assembler, which are: + <ul> +<li>Unless GCC is being built with a cross compiler, check the +<samp><var>libexec</var><span class="file">/gcc/</span><var>target</var><span class="file">/</span><var>version</var></samp> directory. +<var>libexec</var> defaults to <samp><var>exec-prefix</var><span class="file">/libexec</span></samp>; +<var>exec-prefix</var> defaults to <var>prefix</var>, which +defaults to <samp><span class="file">/usr/local</span></samp> unless overridden by the +<samp><span class="option">--prefix=</span><var>pathname</var></samp> switch described above. <var>target</var> +is the target system triple, such as ‘<samp><span class="samp">sparc-sun-solaris2.7</span></samp>’, and +<var>version</var> denotes the GCC version, such as 3.0. + + <li>If the target system is the same that you are building on, check +operating system specific directories (e.g. <samp><span class="file">/usr/ccs/bin</span></samp> on +Sun Solaris 2). + + <li>Check in the <samp><span class="env">PATH</span></samp> for a tool whose name is prefixed by the +target system triple. + + <li>Check in the <samp><span class="env">PATH</span></samp> for a tool whose name is not prefixed by the +target system triple, if the host and target system triple are +the same (in other words, we use a host tool if it can be used for +the target as well). +</ul> + + <p>You may want to use <samp><span class="option">--with-as</span></samp> if no assembler +is installed in the directories listed above, or if you have multiple +assemblers installed and want to choose one that is not found by the +above rules. + + <br><dt><code><a name="with_002dgnu_002dld"></a>--with-gnu-ld</code><dd>Same as <a href="#with-gnu-as"><samp><span class="option">--with-gnu-as</span></samp></a> +but for the linker. + + <br><dt><code>--with-ld=</code><var>pathname</var><dd>Same as <a href="#with-as"><samp><span class="option">--with-as</span></samp></a> +but for the linker. + + <br><dt><code>--with-stabs</code><dd>Specify that stabs debugging +information should be used instead of whatever format the host normally +uses. Normally GCC uses the same debug format as the host system. + + <p>On MIPS based systems and on Alphas, you must specify whether you want +GCC to create the normal ECOFF debugging format, or to use BSD-style +stabs passed through the ECOFF symbol table. The normal ECOFF debug +format cannot fully handle languages other than C. BSD stabs format can +handle other languages, but it only works with the GNU debugger GDB. + + <p>Normally, GCC uses the ECOFF debugging format by default; if you +prefer BSD stabs, specify <samp><span class="option">--with-stabs</span></samp> when you configure GCC. + + <p>No matter which default you choose when you configure GCC, the user +can use the <samp><span class="option">-gcoff</span></samp> and <samp><span class="option">-gstabs+</span></samp> options to specify explicitly +the debug format for a particular compilation. + + <p><samp><span class="option">--with-stabs</span></samp> is meaningful on the ISC system on the 386, also, if +<samp><span class="option">--with-gas</span></samp> is used. It selects use of stabs debugging +information embedded in COFF output. This kind of debugging information +supports C++ well; ordinary COFF debugging information does not. + + <p><samp><span class="option">--with-stabs</span></samp> is also meaningful on 386 systems running SVR4. It +selects use of stabs debugging information embedded in ELF output. The +C++ compiler currently (2.6.0) does not support the DWARF debugging +information normally used on 386 SVR4 platforms; stabs provide a +workable alternative. This requires gas and gdb, as the normal SVR4 +tools can not generate or interpret stabs. + + <br><dt><code>--disable-multilib</code><dd>Specify that multiple target +libraries to support different target variants, calling +conventions, etc. should not be built. The default is to build a +predefined set of them. + + <p>Some targets provide finer-grained control over which multilibs are built +(e.g., <samp><span class="option">--disable-softfloat</span></samp>): + <dl> +<dt><code>arc-*-elf*</code><dd>biendian. + + <br><dt><code>arm-*-*</code><dd>fpu, 26bit, underscore, interwork, biendian, nofmult. + + <br><dt><code>m68*-*-*</code><dd>softfloat, m68881, m68000, m68020. + + <br><dt><code>mips*-*-*</code><dd>single-float, biendian, softfloat. + + <br><dt><code>powerpc*-*-*, rs6000*-*-*</code><dd>aix64, pthread, softfloat, powercpu, powerpccpu, powerpcos, biendian, +sysv, aix. + + </dl> + + <br><dt><code>--enable-threads</code><dd>Specify that the target +supports threads. This affects the Objective-C compiler and runtime +library, and exception handling for other languages like C++ and Java. +On some systems, this is the default. + + <p>In general, the best (and, in many cases, the only known) threading +model available will be configured for use. Beware that on some +systems, GCC has not been taught what threading models are generally +available for the system. In this case, <samp><span class="option">--enable-threads</span></samp> is an +alias for <samp><span class="option">--enable-threads=single</span></samp>. + + <br><dt><code>--disable-threads</code><dd>Specify that threading support should be disabled for the system. +This is an alias for <samp><span class="option">--enable-threads=single</span></samp>. + + <br><dt><code>--enable-threads=</code><var>lib</var><dd>Specify that +<var>lib</var> is the thread support library. This affects the Objective-C +compiler and runtime library, and exception handling for other languages +like C++ and Java. The possibilities for <var>lib</var> are: + + <dl> +<dt><code>aix</code><dd>AIX thread support. +<br><dt><code>dce</code><dd>DCE thread support. +<br><dt><code>gnat</code><dd>Ada tasking support. For non-Ada programs, this setting is equivalent +to ‘<samp><span class="samp">single</span></samp>’. When used in conjunction with the Ada run time, it +causes GCC to use the same thread primitives as Ada uses. This option +is necessary when using both Ada and the back end exception handling, +which is the default for most Ada targets. +<br><dt><code>mach</code><dd>Generic MACH thread support, known to work on NeXTSTEP. (Please note +that the file needed to support this configuration, <samp><span class="file">gthr-mach.h</span></samp>, is +missing and thus this setting will cause a known bootstrap failure.) +<br><dt><code>no</code><dd>This is an alias for ‘<samp><span class="samp">single</span></samp>’. +<br><dt><code>posix</code><dd>Generic POSIX/Unix98 thread support. +<br><dt><code>posix95</code><dd>Generic POSIX/Unix95 thread support. +<br><dt><code>rtems</code><dd>RTEMS thread support. +<br><dt><code>single</code><dd>Disable thread support, should work for all platforms. +<br><dt><code>solaris</code><dd>Sun Solaris 2 thread support. +<br><dt><code>vxworks</code><dd>VxWorks thread support. +<br><dt><code>win32</code><dd>Microsoft Win32 API thread support. +<br><dt><code>nks</code><dd>Novell Kernel Services thread support. +</dl> + + <br><dt><code>--enable-tls</code><dd>Specify that the target supports TLS (Thread Local Storage). Usually +configure can correctly determine if TLS is supported. In cases where +it guesses incorrectly, TLS can be explicitly enabled or disabled with +<samp><span class="option">--enable-tls</span></samp> or <samp><span class="option">--disable-tls</span></samp>. This can happen if +the assembler supports TLS but the C library does not, or if the +assumptions made by the configure test are incorrect. + + <br><dt><code>--disable-tls</code><dd>Specify that the target does not support TLS. +This is an alias for <samp><span class="option">--enable-tls=no</span></samp>. + + <br><dt><code>--with-cpu=</code><var>cpu</var><dd>Specify which cpu variant the compiler should generate code for by default. +<var>cpu</var> will be used as the default value of the <samp><span class="option">-mcpu=</span></samp> switch. +This option is only supported on some targets, including ARM, i386, M68k, +PowerPC, and SPARC. + + <br><dt><code>--with-schedule=</code><var>cpu</var><dt><code>--with-arch=</code><var>cpu</var><dt><code>--with-tune=</code><var>cpu</var><dt><code>--with-abi=</code><var>abi</var><dt><code>--with-fpu=</code><var>type</var><dt><code>--with-float=</code><var>type</var><dd>These configure options provide default values for the <samp><span class="option">-mschedule=</span></samp>, +<samp><span class="option">-march=</span></samp>, <samp><span class="option">-mtune=</span></samp>, <samp><span class="option">-mabi=</span></samp>, and <samp><span class="option">-mfpu=</span></samp> +options and for <samp><span class="option">-mhard-float</span></samp> or <samp><span class="option">-msoft-float</span></samp>. As with +<samp><span class="option">--with-cpu</span></samp>, which switches will be accepted and acceptable values +of the arguments depend on the target. + + <br><dt><code>--with-mode=</code><var>mode</var><dd>Specify if the compiler should default to <samp><span class="option">-marm</span></samp> or <samp><span class="option">-mthumb</span></samp>. +This option is only supported on ARM targets. + + <br><dt><code>--with-divide=</code><var>type</var><dd>Specify how the compiler should generate code for checking for +division by zero. This option is only supported on the MIPS target. +The possibilities for <var>type</var> are: + <dl> +<dt><code>traps</code><dd>Division by zero checks use conditional traps (this is the default on +systems that support conditional traps). +<br><dt><code>breaks</code><dd>Division by zero checks use the break instruction. +</dl> + + <!-- If you make -with-llsc the default for additional targets, --> + <!-- update the -with-llsc description in the MIPS section below. --> + <br><dt><code>--with-llsc</code><dd>On MIPS targets, make <samp><span class="option">-mllsc</span></samp> the default when no +<samp><span class="option">-mno-lsc</span></samp> option is passed. This is the default for +Linux-based targets, as the kernel will emulate them if the ISA does +not provide them. + + <br><dt><code>--without-llsc</code><dd>On MIPS targets, make <samp><span class="option">-mno-llsc</span></samp> the default when no +<samp><span class="option">-mllsc</span></samp> option is passed. + + <br><dt><code>--enable-__cxa_atexit</code><dd>Define if you want to use __cxa_atexit, rather than atexit, to +register C++ destructors for local statics and global objects. +This is essential for fully standards-compliant handling of +destructors, but requires __cxa_atexit in libc. This option is currently +only available on systems with GNU libc. When enabled, this will cause +<samp><span class="option">-fuse-cxa-atexit</span></samp> to be passed by default. + + <br><dt><code>--enable-target-optspace</code><dd>Specify that target +libraries should be optimized for code space instead of code speed. +This is the default for the m32r platform. + + <br><dt><code>--disable-cpp</code><dd>Specify that a user visible <samp><span class="command">cpp</span></samp> program should not be installed. + + <br><dt><code>--with-cpp-install-dir=</code><var>dirname</var><dd>Specify that the user visible <samp><span class="command">cpp</span></samp> program should be installed +in <samp><var>prefix</var><span class="file">/</span><var>dirname</var><span class="file">/cpp</span></samp>, in addition to <var>bindir</var>. + + <br><dt><code>--enable-initfini-array</code><dd>Force the use of sections <code>.init_array</code> and <code>.fini_array</code> +(instead of <code>.init</code> and <code>.fini</code>) for constructors and +destructors. Option <samp><span class="option">--disable-initfini-array</span></samp> has the +opposite effect. If neither option is specified, the configure script +will try to guess whether the <code>.init_array</code> and +<code>.fini_array</code> sections are supported and, if they are, use them. + + <br><dt><code>--enable-maintainer-mode</code><dd>The build rules that +regenerate the GCC master message catalog <samp><span class="file">gcc.pot</span></samp> are normally +disabled. This is because it can only be rebuilt if the complete source +tree is present. If you have changed the sources and want to rebuild the +catalog, configuring with <samp><span class="option">--enable-maintainer-mode</span></samp> will enable +this. Note that you need a recent version of the <code>gettext</code> tools +to do so. + + <br><dt><code>--disable-bootstrap</code><dd>For a native build, the default configuration is to perform +a 3-stage bootstrap of the compiler when ‘<samp><span class="samp">make</span></samp>’ is invoked, +testing that GCC can compile itself correctly. If you want to disable +this process, you can configure with <samp><span class="option">--disable-bootstrap</span></samp>. + + <br><dt><code>--enable-bootstrap</code><dd>In special cases, you may want to perform a 3-stage build +even if the target and host triplets are different. +This could happen when the host can run code compiled for +the target (e.g. host is i686-linux, target is i486-linux). +Starting from GCC 4.2, to do this you have to configure explicitly +with <samp><span class="option">--enable-bootstrap</span></samp>. + + <br><dt><code>--enable-generated-files-in-srcdir</code><dd>Neither the .c and .h files that are generated from Bison and flex nor the +info manuals and man pages that are built from the .texi files are present +in the SVN development tree. When building GCC from that development tree, +or from one of our snapshots, those generated files are placed in your +build directory, which allows for the source to be in a readonly +directory. + + <p>If you configure with <samp><span class="option">--enable-generated-files-in-srcdir</span></samp> then those +generated files will go into the source directory. This is mainly intended +for generating release or prerelease tarballs of the GCC sources, since it +is not a requirement that the users of source releases to have flex, Bison, +or makeinfo. + + <br><dt><code>--enable-version-specific-runtime-libs</code><dd>Specify +that runtime libraries should be installed in the compiler specific +subdirectory (<samp><var>libdir</var><span class="file">/gcc</span></samp>) rather than the usual places. In +addition, ‘<samp><span class="samp">libstdc++</span></samp>’'s include files will be installed into +<samp><var>libdir</var></samp> unless you overruled it by using +<samp><span class="option">--with-gxx-include-dir=</span><var>dirname</var></samp>. Using this option is +particularly useful if you intend to use several versions of GCC in +parallel. This is currently supported by ‘<samp><span class="samp">libgfortran</span></samp>’, +‘<samp><span class="samp">libjava</span></samp>’, ‘<samp><span class="samp">libmudflap</span></samp>’, ‘<samp><span class="samp">libstdc++</span></samp>’, and ‘<samp><span class="samp">libobjc</span></samp>’. + + <br><dt><code>--enable-languages=</code><var>lang1</var><code>,</code><var>lang2</var><code>,...</code><dd>Specify that only a particular subset of compilers and +their runtime libraries should be built. For a list of valid values for +<var>langN</var> you can issue the following command in the +<samp><span class="file">gcc</span></samp> directory of your GCC source tree:<br> + <pre class="smallexample"> grep language= */config-lang.in +</pre> + <p>Currently, you can use any of the following: +<code>all</code>, <code>ada</code>, <code>c</code>, <code>c++</code>, <code>fortran</code>, <code>java</code>, +<code>objc</code>, <code>obj-c++</code>, <code>treelang</code>. +Building the Ada compiler has special requirements, see below. +If you do not pass this flag, or specify the option <code>all</code>, then all +default languages available in the <samp><span class="file">gcc</span></samp> sub-tree will be configured. +Ada, Objective-C++, and treelang are not default languages; the rest are. +Re-defining <code>LANGUAGES</code> when calling ‘<samp><span class="samp">make</span></samp>’ <strong>does not</strong> +work anymore, as those language sub-directories might not have been +configured! + + <br><dt><code>--enable-stage1-languages=</code><var>lang1</var><code>,</code><var>lang2</var><code>,...</code><dd>Specify that a particular subset of compilers and their runtime +libraries should be built with the system C compiler during stage 1 of +the bootstrap process, rather than only in later stages with the +bootstrapped C compiler. The list of valid values is the same as for +<samp><span class="option">--enable-languages</span></samp>, and the option <code>all</code> will select all +of the languages enabled by <samp><span class="option">--enable-languages</span></samp>. This option is +primarily useful for GCC development; for instance, when a development +version of the compiler cannot bootstrap due to compiler bugs, or when +one is debugging front ends other than the C front end. When this +option is used, one can then build the target libraries for the +specified languages with the stage-1 compiler by using <samp><span class="command">make +stage1-bubble all-target</span></samp>, or run the testsuite on the stage-1 compiler +for the specified languages using <samp><span class="command">make stage1-start check-gcc</span></samp>. + + <br><dt><code>--disable-libada</code><dd>Specify that the run-time libraries and tools used by GNAT should not +be built. This can be useful for debugging, or for compatibility with +previous Ada build procedures, when it was required to explicitly +do a ‘<samp><span class="samp">make -C gcc gnatlib_and_tools</span></samp>’. + + <br><dt><code>--disable-libssp</code><dd>Specify that the run-time libraries for stack smashing protection +should not be built. + + <br><dt><code>--disable-libgomp</code><dd>Specify that the run-time libraries used by GOMP should not be built. + + <br><dt><code>--with-dwarf2</code><dd>Specify that the compiler should +use DWARF 2 debugging information as the default. + + <br><dt><code>--enable-targets=all</code><dt><code>--enable-targets=</code><var>target_list</var><dd>Some GCC targets, e.g. powerpc64-linux, build bi-arch compilers. +These are compilers that are able to generate either 64-bit or 32-bit +code. Typically, the corresponding 32-bit target, e.g. +powerpc-linux for powerpc64-linux, only generates 32-bit code. This +option enables the 32-bit target to be a bi-arch compiler, which is +useful when you want a bi-arch compiler that defaults to 32-bit, and +you are building a bi-arch or multi-arch binutils in a combined tree. +Currently, this option only affects powerpc-linux and x86-linux. + + <br><dt><code>--enable-secureplt</code><dd>This option enables <samp><span class="option">-msecure-plt</span></samp> by default for powerpc-linux. +See “RS/6000 and PowerPC Options” in the main manual + + <br><dt><code>--enable-cld</code><dd>This option enables <samp><span class="option">-mcld</span></samp> by default for 32-bit x86 targets. +See “i386 and x86-64 Options” in the main manual + + <br><dt><code>--enable-win32-registry</code><dt><code>--enable-win32-registry=</code><var>key</var><dt><code>--disable-win32-registry</code><dd>The <samp><span class="option">--enable-win32-registry</span></samp> option enables Microsoft Windows-hosted GCC +to look up installations paths in the registry using the following key: + + <pre class="smallexample"> <code>HKEY_LOCAL_MACHINE\SOFTWARE\Free Software Foundation\</code><var>key</var> +</pre> + <p><var>key</var> defaults to GCC version number, and can be overridden by the +<samp><span class="option">--enable-win32-registry=</span><var>key</var></samp> option. Vendors and distributors +who use custom installers are encouraged to provide a different key, +perhaps one comprised of vendor name and GCC version number, to +avoid conflict with existing installations. This feature is enabled +by default, and can be disabled by <samp><span class="option">--disable-win32-registry</span></samp> +option. This option has no effect on the other hosts. + + <br><dt><code>--nfp</code><dd>Specify that the machine does not have a floating point unit. This +option only applies to ‘<samp><span class="samp">m68k-sun-sunos</span><var>n</var></samp>’. On any other +system, <samp><span class="option">--nfp</span></samp> has no effect. + + <br><dt><code>--enable-werror</code><dt><code>--disable-werror</code><dt><code>--enable-werror=yes</code><dt><code>--enable-werror=no</code><dd>When you specify this option, it controls whether certain files in the +compiler are built with <samp><span class="option">-Werror</span></samp> in bootstrap stage2 and later. +If you don't specify it, <samp><span class="option">-Werror</span></samp> is turned on for the main +development trunk. However it defaults to off for release branches and +final releases. The specific files which get <samp><span class="option">-Werror</span></samp> are +controlled by the Makefiles. + + <br><dt><code>--enable-checking</code><dt><code>--enable-checking=</code><var>list</var><dd>When you specify this option, the compiler is built to perform internal +consistency checks of the requested complexity. This does not change the +generated code, but adds error checking within the compiler. This will +slow down the compiler and may only work properly if you are building +the compiler with GCC. This is ‘<samp><span class="samp">yes</span></samp>’ by default when building +from SVN or snapshots, but ‘<samp><span class="samp">release</span></samp>’ for releases. More control +over the checks may be had by specifying <var>list</var>. The categories of +checks available are ‘<samp><span class="samp">yes</span></samp>’ (most common checks +‘<samp><span class="samp">assert,misc,tree,gc,rtlflag,runtime</span></samp>’), ‘<samp><span class="samp">no</span></samp>’ (no checks at +all), ‘<samp><span class="samp">all</span></samp>’ (all but ‘<samp><span class="samp">valgrind</span></samp>’), ‘<samp><span class="samp">release</span></samp>’ (cheapest +checks ‘<samp><span class="samp">assert,runtime</span></samp>’) or ‘<samp><span class="samp">none</span></samp>’ (same as ‘<samp><span class="samp">no</span></samp>’). +Individual checks can be enabled with these flags ‘<samp><span class="samp">assert</span></samp>’, +‘<samp><span class="samp">df</span></samp>’, ‘<samp><span class="samp">fold</span></samp>’, ‘<samp><span class="samp">gc</span></samp>’, ‘<samp><span class="samp">gcac</span></samp>’ ‘<samp><span class="samp">misc</span></samp>’, ‘<samp><span class="samp">rtl</span></samp>’, +‘<samp><span class="samp">rtlflag</span></samp>’, ‘<samp><span class="samp">runtime</span></samp>’, ‘<samp><span class="samp">tree</span></samp>’, and ‘<samp><span class="samp">valgrind</span></samp>’. + + <p>The ‘<samp><span class="samp">valgrind</span></samp>’ check requires the external <samp><span class="command">valgrind</span></samp> +simulator, available from <a href="http://valgrind.org/">http://valgrind.org/</a>. The +‘<samp><span class="samp">df</span></samp>’, ‘<samp><span class="samp">rtl</span></samp>’, ‘<samp><span class="samp">gcac</span></samp>’ and ‘<samp><span class="samp">valgrind</span></samp>’ checks are very expensive. +To disable all checking, ‘<samp><span class="samp">--disable-checking</span></samp>’ or +‘<samp><span class="samp">--enable-checking=none</span></samp>’ must be explicitly requested. Disabling +assertions will make the compiler and runtime slightly faster but +increase the risk of undetected internal errors causing wrong code to be +generated. + + <br><dt><code>--enable-coverage</code><dt><code>--enable-coverage=</code><var>level</var><dd>With this option, the compiler is built to collect self coverage +information, every time it is run. This is for internal development +purposes, and only works when the compiler is being built with gcc. The +<var>level</var> argument controls whether the compiler is built optimized or +not, values are ‘<samp><span class="samp">opt</span></samp>’ and ‘<samp><span class="samp">noopt</span></samp>’. For coverage analysis you +want to disable optimization, for performance analysis you want to +enable optimization. When coverage is enabled, the default level is +without optimization. + + <br><dt><code>--enable-gather-detailed-mem-stats</code><dd>When this option is specified more detailed information on memory +allocation is gathered. This information is printed when using +<samp><span class="option">-fmem-report</span></samp>. + + <br><dt><code>--with-gc</code><dt><code>--with-gc=</code><var>choice</var><dd>With this option you can specify the garbage collector implementation +used during the compilation process. <var>choice</var> can be one of +‘<samp><span class="samp">page</span></samp>’ and ‘<samp><span class="samp">zone</span></samp>’, where ‘<samp><span class="samp">page</span></samp>’ is the default. + + <br><dt><code>--enable-nls</code><dt><code>--disable-nls</code><dd>The <samp><span class="option">--enable-nls</span></samp> option enables Native Language Support (NLS), +which lets GCC output diagnostics in languages other than American +English. Native Language Support is enabled by default if not doing a +canadian cross build. The <samp><span class="option">--disable-nls</span></samp> option disables NLS. + + <br><dt><code>--with-included-gettext</code><dd>If NLS is enabled, the <samp><span class="option">--with-included-gettext</span></samp> option causes the build +procedure to prefer its copy of GNU <samp><span class="command">gettext</span></samp>. + + <br><dt><code>--with-catgets</code><dd>If NLS is enabled, and if the host lacks <code>gettext</code> but has the +inferior <code>catgets</code> interface, the GCC build procedure normally +ignores <code>catgets</code> and instead uses GCC's copy of the GNU +<code>gettext</code> library. The <samp><span class="option">--with-catgets</span></samp> option causes the +build procedure to use the host's <code>catgets</code> in this situation. + + <br><dt><code>--with-libiconv-prefix=</code><var>dir</var><dd>Search for libiconv header files in <samp><var>dir</var><span class="file">/include</span></samp> and +libiconv library files in <samp><var>dir</var><span class="file">/lib</span></samp>. + + <br><dt><code>--enable-obsolete</code><dd>Enable configuration for an obsoleted system. If you attempt to +configure GCC for a system (build, host, or target) which has been +obsoleted, and you do not specify this flag, configure will halt with an +error message. + + <p>All support for systems which have been obsoleted in one release of GCC +is removed entirely in the next major release, unless someone steps +forward to maintain the port. + + <br><dt><code>--enable-decimal-float</code><dt><code>--enable-decimal-float=yes</code><dt><code>--enable-decimal-float=no</code><dt><code>--enable-decimal-float=bid</code><dt><code>--enable-decimal-float=dpd</code><dt><code>--disable-decimal-float</code><dd>Enable (or disable) support for the C decimal floating point extension +that is in the IEEE 754R extension to the IEEE754 floating point +standard. This is enabled by default only on PowerPC, i386, and +x86_64 GNU/Linux systems. Other systems may also support it, but +require the user to specifically enable it. You can optionally +control which decimal floating point format is used (either ‘<samp><span class="samp">bid</span></samp>’ +or ‘<samp><span class="samp">dpd</span></samp>’). The ‘<samp><span class="samp">bid</span></samp>’ (binary integer decimal) format is +default on i386 and x86_64 systems, and the ‘<samp><span class="samp">dpd</span></samp>’ (densely packed +decimal) format is default on PowerPC systems. + + <br><dt><code>--enable-fixed-point</code><dt><code>--disable-fixed-point</code><dd>Enable (or disable) support for C fixed-point arithmetic. +This option is enabled by default for some targets (such as MIPS) which +have hardware-support for fixed-point operations. On other targets, you +may enable this option manually. + + <br><dt><code>--with-long-double-128</code><dd>Specify if <code>long double</code> type should be 128-bit by default on selected +GNU/Linux architectures. If using <code>--without-long-double-128</code>, +<code>long double</code> will be by default 64-bit, the same as <code>double</code> type. +When neither of these configure options are used, the default will be +128-bit <code>long double</code> when built against GNU C Library 2.4 and later, +64-bit <code>long double</code> otherwise. + + <br><dt><code>--with-gmp=</code><var>pathname</var><dt><code>--with-gmp-include=</code><var>pathname</var><dt><code>--with-gmp-lib=</code><var>pathname</var><dt><code>--with-mpfr=</code><var>pathname</var><dt><code>--with-mpfr-include=</code><var>pathname</var><dt><code>--with-mpfr-lib=</code><var>pathname</var><dd>If you do not have GMP (the GNU Multiple Precision library) and the +MPFR Libraries installed in a standard location and you want to build +GCC, you can explicitly specify the directory where they are installed +(‘<samp><span class="samp">--with-gmp=</span><var>gmpinstalldir</var></samp>’, +‘<samp><span class="samp">--with-mpfr=</span><var>mpfrinstalldir</var></samp>’). The +<samp><span class="option">--with-gmp=</span><var>gmpinstalldir</var></samp> option is shorthand for +<samp><span class="option">--with-gmp-lib=</span><var>gmpinstalldir</var><span class="option">/lib</span></samp> and +<samp><span class="option">--with-gmp-include=</span><var>gmpinstalldir</var><span class="option">/include</span></samp>. Likewise the +<samp><span class="option">--with-mpfr=</span><var>mpfrinstalldir</var></samp> option is shorthand for +<samp><span class="option">--with-mpfr-lib=</span><var>mpfrinstalldir</var><span class="option">/lib</span></samp> and +<samp><span class="option">--with-mpfr-include=</span><var>mpfrinstalldir</var><span class="option">/include</span></samp>. If these +shorthand assumptions are not correct, you can use the explicit +include and lib options directly. + + <br><dt><code>--with-debug-prefix-map=</code><var>map</var><dd>Convert source directory names using <samp><span class="option">-fdebug-prefix-map</span></samp> when +building runtime libraries. ‘<samp><var>map</var></samp>’ is a space-separated +list of maps of the form ‘<samp><var>old</var><span class="samp">=</span><var>new</var></samp>’. + + </dl> + +<h4 class="subheading"><a name="TOC3"></a>Cross-Compiler-Specific Options</h4> + +<p>The following options only apply to building cross compilers. + <dl> +<dt><code>--with-sysroot</code><dt><code>--with-sysroot=</code><var>dir</var><dd>Tells GCC to consider <var>dir</var> as the root of a tree that contains a +(subset of) the root filesystem of the target operating system. +Target system headers, libraries and run-time object files will be +searched in there. The specified directory is not copied into the +install tree, unlike the options <samp><span class="option">--with-headers</span></samp> and +<samp><span class="option">--with-libs</span></samp> that this option obsoletes. The default value, +in case <samp><span class="option">--with-sysroot</span></samp> is not given an argument, is +<samp><span class="option">${gcc_tooldir}/sys-root</span></samp>. If the specified directory is a +subdirectory of <samp><span class="option">${exec_prefix}</span></samp>, then it will be found relative to +the GCC binaries if the installation tree is moved. + + <br><dt><code>--with-build-sysroot</code><dt><code>--with-build-sysroot=</code><var>dir</var><dd>Tells GCC to consider <var>dir</var> as the system root (see +<samp><span class="option">--with-sysroot</span></samp>) while building target libraries, instead of +the directory specified with <samp><span class="option">--with-sysroot</span></samp>. This option is +only useful when you are already using <samp><span class="option">--with-sysroot</span></samp>. You +can use <samp><span class="option">--with-build-sysroot</span></samp> when you are configuring with +<samp><span class="option">--prefix</span></samp> set to a directory that is different from the one in +which you are installing GCC and your target libraries. + + <p>This option affects the system root for the compiler used to build +target libraries (which runs on the build system); it does not affect +the compiler which is used to build GCC itself. + + <br><dt><code>--with-headers</code><dt><code>--with-headers=</code><var>dir</var><dd>Deprecated in favor of <samp><span class="option">--with-sysroot</span></samp>. +Specifies that target headers are available when building a cross compiler. +The <var>dir</var> argument specifies a directory which has the target include +files. These include files will be copied into the <samp><span class="file">gcc</span></samp> install +directory. <em>This option with the </em><var>dir</var><em> argument is required</em> when +building a cross compiler, if <samp><var>prefix</var><span class="file">/</span><var>target</var><span class="file">/sys-include</span></samp> +doesn't pre-exist. If <samp><var>prefix</var><span class="file">/</span><var>target</var><span class="file">/sys-include</span></samp> does +pre-exist, the <var>dir</var> argument may be omitted. <samp><span class="command">fixincludes</span></samp> +will be run on these files to make them compatible with GCC. + + <br><dt><code>--without-headers</code><dd>Tells GCC not use any target headers from a libc when building a cross +compiler. When crossing to GNU/Linux, you need the headers so GCC +can build the exception handling for libgcc. + + <br><dt><code>--with-libs</code><dt><code>--with-libs=``</code><var>dir1</var> <var>dir2</var><code> ... </code><var>dirN</var><code>''</code><dd>Deprecated in favor of <samp><span class="option">--with-sysroot</span></samp>. +Specifies a list of directories which contain the target runtime +libraries. These libraries will be copied into the <samp><span class="file">gcc</span></samp> install +directory. If the directory list is omitted, this option has no +effect. + + <br><dt><code>--with-newlib</code><dd>Specifies that ‘<samp><span class="samp">newlib</span></samp>’ is +being used as the target C library. This causes <code>__eprintf</code> to be +omitted from <samp><span class="file">libgcc.a</span></samp> on the assumption that it will be provided by +‘<samp><span class="samp">newlib</span></samp>’. + + <br><dt><code>--with-build-time-tools=</code><var>dir</var><dd>Specifies where to find the set of target tools (assembler, linker, etc.) +that will be used while building GCC itself. This option can be useful +if the directory layouts are different between the system you are building +GCC on, and the system where you will deploy it. + + <p>For example, on a <samp><span class="option">ia64-hp-hpux</span></samp> system, you may have the GNU +assembler and linker in <samp><span class="file">/usr/bin</span></samp>, and the native tools in a +different path, and build a toolchain that expects to find the +native tools in <samp><span class="file">/usr/bin</span></samp>. + + <p>When you use this option, you should ensure that <var>dir</var> includes +<samp><span class="command">ar</span></samp>, <samp><span class="command">as</span></samp>, <samp><span class="command">ld</span></samp>, <samp><span class="command">nm</span></samp>, +<samp><span class="command">ranlib</span></samp> and <samp><span class="command">strip</span></samp> if necessary, and possibly +<samp><span class="command">objdump</span></samp>. Otherwise, GCC may use an inconsistent set of +tools. +</dl> + +<h4 class="subheading"><a name="TOC4"></a>Java-Specific Options</h4> + +<p>The following option applies to the build of the Java front end. + + <dl> +<dt><code>--disable-libgcj</code><dd>Specify that the run-time libraries +used by GCJ should not be built. This is useful in case you intend +to use GCJ with some other run-time, or you're going to install it +separately, or it just happens not to build on your particular +machine. In general, if the Java front end is enabled, the GCJ +libraries will be enabled too, unless they're known to not work on +the target platform. If GCJ is enabled but ‘<samp><span class="samp">libgcj</span></samp>’ isn't built, you +may need to port it; in this case, before modifying the top-level +<samp><span class="file">configure.in</span></samp> so that ‘<samp><span class="samp">libgcj</span></samp>’ is enabled by default on this platform, +you may use <samp><span class="option">--enable-libgcj</span></samp> to override the default. + + </dl> + + <p>The following options apply to building ‘<samp><span class="samp">libgcj</span></samp>’. + +<h5 class="subsubheading"><a name="TOC5"></a>General Options</h5> + + <dl> +<dt><code>--enable-java-maintainer-mode</code><dd>By default the ‘<samp><span class="samp">libjava</span></samp>’ build will not attempt to compile the +<samp><span class="file">.java</span></samp> source files to <samp><span class="file">.class</span></samp>. Instead, it will use the +<samp><span class="file">.class</span></samp> files from the source tree. If you use this option you +must have executables named <samp><span class="command">ecj1</span></samp> and <samp><span class="command">gjavah</span></samp> in your path +for use by the build. You must use this option if you intend to +modify any <samp><span class="file">.java</span></samp> files in <samp><span class="file">libjava</span></samp>. + + <br><dt><code>--with-java-home=</code><var>dirname</var><dd>This ‘<samp><span class="samp">libjava</span></samp>’ option overrides the default value of the +‘<samp><span class="samp">java.home</span></samp>’ system property. It is also used to set +‘<samp><span class="samp">sun.boot.class.path</span></samp>’ to <samp><var>dirname</var><span class="file">/lib/rt.jar</span></samp>. By +default ‘<samp><span class="samp">java.home</span></samp>’ is set to <samp><var>prefix</var></samp> and +‘<samp><span class="samp">sun.boot.class.path</span></samp>’ to +<samp><var>datadir</var><span class="file">/java/libgcj-</span><var>version</var><span class="file">.jar</span></samp>. + + <br><dt><code>--with-ecj-jar=</code><var>filename</var><dd>This option can be used to specify the location of an external jar +file containing the Eclipse Java compiler. A specially modified +version of this compiler is used by <samp><span class="command">gcj</span></samp> to parse +<samp><span class="file">.java</span></samp> source files. If this option is given, the +‘<samp><span class="samp">libjava</span></samp>’ build will create and install an <samp><span class="file">ecj1</span></samp> executable +which uses this jar file at runtime. + + <p>If this option is not given, but an <samp><span class="file">ecj.jar</span></samp> file is found in +the topmost source tree at configure time, then the ‘<samp><span class="samp">libgcj</span></samp>’ +build will create and install <samp><span class="file">ecj1</span></samp>, and will also install the +discovered <samp><span class="file">ecj.jar</span></samp> into a suitable place in the install tree. + + <p>If <samp><span class="file">ecj1</span></samp> is not installed, then the user will have to supply one +on his path in order for <samp><span class="command">gcj</span></samp> to properly parse <samp><span class="file">.java</span></samp> +source files. A suitable jar is available from +<a href="ftp://sourceware.org/pub/java/">ftp://sourceware.org/pub/java/</a>. + + <br><dt><code>--disable-getenv-properties</code><dd>Don't set system properties from <samp><span class="env">GCJ_PROPERTIES</span></samp>. + + <br><dt><code>--enable-hash-synchronization</code><dd>Use a global hash table for monitor locks. Ordinarily, +‘<samp><span class="samp">libgcj</span></samp>’'s ‘<samp><span class="samp">configure</span></samp>’ script automatically makes +the correct choice for this option for your platform. Only use +this if you know you need the library to be configured differently. + + <br><dt><code>--enable-interpreter</code><dd>Enable the Java interpreter. The interpreter is automatically +enabled by default on all platforms that support it. This option +is really only useful if you want to disable the interpreter +(using <samp><span class="option">--disable-interpreter</span></samp>). + + <br><dt><code>--disable-java-net</code><dd>Disable java.net. This disables the native part of java.net only, +using non-functional stubs for native method implementations. + + <br><dt><code>--disable-jvmpi</code><dd>Disable JVMPI support. + + <br><dt><code>--disable-libgcj-bc</code><dd>Disable BC ABI compilation of certain parts of libgcj. By default, +some portions of libgcj are compiled with <samp><span class="option">-findirect-dispatch</span></samp> +and <samp><span class="option">-fno-indirect-classes</span></samp>, allowing them to be overridden at +run-time. + + <p>If <samp><span class="option">--disable-libgcj-bc</span></samp> is specified, libgcj is built without +these options. This allows the compile-time linker to resolve +dependencies when statically linking to libgcj. However it makes it +impossible to override the affected portions of libgcj at run-time. + + <br><dt><code>--with-ecos</code><dd>Enable runtime eCos target support. + + <br><dt><code>--without-libffi</code><dd>Don't use ‘<samp><span class="samp">libffi</span></samp>’. This will disable the interpreter and JNI +support as well, as these require ‘<samp><span class="samp">libffi</span></samp>’ to work. + + <br><dt><code>--enable-libgcj-debug</code><dd>Enable runtime debugging code. + + <br><dt><code>--enable-libgcj-multifile</code><dd>If specified, causes all <samp><span class="file">.java</span></samp> source files to be +compiled into <samp><span class="file">.class</span></samp> files in one invocation of +‘<samp><span class="samp">gcj</span></samp>’. This can speed up build time, but is more +resource-intensive. If this option is unspecified or +disabled, ‘<samp><span class="samp">gcj</span></samp>’ is invoked once for each <samp><span class="file">.java</span></samp> +file to compile into a <samp><span class="file">.class</span></samp> file. + + <br><dt><code>--with-libiconv-prefix=DIR</code><dd>Search for libiconv in <samp><span class="file">DIR/include</span></samp> and <samp><span class="file">DIR/lib</span></samp>. + + <br><dt><code>--enable-sjlj-exceptions</code><dd>Force use of the <code>setjmp</code>/<code>longjmp</code>-based scheme for exceptions. +‘<samp><span class="samp">configure</span></samp>’ ordinarily picks the correct value based on the platform. +Only use this option if you are sure you need a different setting. + + <br><dt><code>--with-system-zlib</code><dd>Use installed ‘<samp><span class="samp">zlib</span></samp>’ rather than that included with GCC. + + <br><dt><code>--with-win32-nlsapi=ansi, unicows or unicode</code><dd>Indicates how MinGW ‘<samp><span class="samp">libgcj</span></samp>’ translates between UNICODE +characters and the Win32 API. + <dl> +<dt><code>ansi</code><dd>Use the single-byte <code>char</code> and the Win32 A functions natively, +translating to and from UNICODE when using these functions. If +unspecified, this is the default. + + <br><dt><code>unicows</code><dd>Use the <code>WCHAR</code> and Win32 W functions natively. Adds +<code>-lunicows</code> to <samp><span class="file">libgcj.spec</span></samp> to link with ‘<samp><span class="samp">libunicows</span></samp>’. +<samp><span class="file">unicows.dll</span></samp> needs to be deployed on Microsoft Windows 9X machines +running built executables. <samp><span class="file">libunicows.a</span></samp>, an open-source +import library around Microsoft's <code>unicows.dll</code>, is obtained from +<a href="http://libunicows.sourceforge.net/">http://libunicows.sourceforge.net/</a>, which also gives details +on getting <samp><span class="file">unicows.dll</span></samp> from Microsoft. + + <br><dt><code>unicode</code><dd>Use the <code>WCHAR</code> and Win32 W functions natively. Does <em>not</em> +add <code>-lunicows</code> to <samp><span class="file">libgcj.spec</span></samp>. The built executables will +only run on Microsoft Windows NT and above. +</dl> + </dl> + +<h5 class="subsubheading"><a name="TOC6"></a>AWT-Specific Options</h5> + + <dl> +<dt><code>--with-x</code><dd>Use the X Window System. + + <br><dt><code>--enable-java-awt=PEER(S)</code><dd>Specifies the AWT peer library or libraries to build alongside +‘<samp><span class="samp">libgcj</span></samp>’. If this option is unspecified or disabled, AWT +will be non-functional. Current valid values are <samp><span class="option">gtk</span></samp> and +<samp><span class="option">xlib</span></samp>. Multiple libraries should be separated by a +comma (i.e. <samp><span class="option">--enable-java-awt=gtk,xlib</span></samp>). + + <br><dt><code>--enable-gtk-cairo</code><dd>Build the cairo Graphics2D implementation on GTK. + + <br><dt><code>--enable-java-gc=TYPE</code><dd>Choose garbage collector. Defaults to <samp><span class="option">boehm</span></samp> if unspecified. + + <br><dt><code>--disable-gtktest</code><dd>Do not try to compile and run a test GTK+ program. + + <br><dt><code>--disable-glibtest</code><dd>Do not try to compile and run a test GLIB program. + + <br><dt><code>--with-libart-prefix=PFX</code><dd>Prefix where libart is installed (optional). + + <br><dt><code>--with-libart-exec-prefix=PFX</code><dd>Exec prefix where libart is installed (optional). + + <br><dt><code>--disable-libarttest</code><dd>Do not try to compile and run a test libart program. + +</dl> + + <p><hr /> +<p><a href="./index.html">Return to the GCC Installation page</a> + +<!-- ***Building**************************************************************** --> +<!-- ***Testing***************************************************************** --> +<!-- ***Final install*********************************************************** --> +<!-- ***Binaries**************************************************************** --> +<!-- ***Specific**************************************************************** --> +<!-- ***Old documentation****************************************************** --> +<!-- ***GFDL******************************************************************** --> +<!-- *************************************************************************** --> +<!-- Part 6 The End of the Document --> +</body></html> + diff --git a/gcc-4.3.1/INSTALL/download.html b/gcc-4.3.1/INSTALL/download.html new file mode 100644 index 000000000..a2c9f8a4e --- /dev/null +++ b/gcc-4.3.1/INSTALL/download.html @@ -0,0 +1,90 @@ +<html lang="en"> +<head> +<title>Downloading GCC</title> +<meta http-equiv="Content-Type" content="text/html"> +<meta name="description" content="Downloading GCC"> +<meta name="generator" content="makeinfo 4.11"> +<link title="Top" rel="top" href="#Top"> +<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage"> +<!-- +Copyright (C) 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998, +1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc. + + Permission is granted to copy, distribute and/or modify this document +under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no +Invariant Sections, the Front-Cover texts being (a) (see below), and +with the Back-Cover Texts being (b) (see below). A copy of the +license is included in the section entitled "GNU Free Documentation License". + +(a) The FSF's Front-Cover Text is: + + A GNU Manual + +(b) The FSF's Back-Cover Text is: + + You have freedom to copy and modify this GNU Manual, like GNU + software. Copies published by the Free Software Foundation raise + funds for GNU development.--> +<meta http-equiv="Content-Style-Type" content="text/css"> +<style type="text/css"><!-- + pre.display { font-family:inherit } + pre.format { font-family:inherit } + pre.smalldisplay { font-family:inherit; font-size:smaller } + pre.smallformat { font-family:inherit; font-size:smaller } + pre.smallexample { font-size:smaller } + pre.smalllisp { font-size:smaller } + span.sc { font-variant:small-caps } + span.roman { font-family:serif; font-weight:normal; } + span.sansserif { font-family:sans-serif; font-weight:normal; } +--></style> +</head> +<body> +<h1 class="settitle">Downloading GCC</h1> +<a name="index-Downloading-GCC-1"></a><a name="index-Downloading-the-Source-2"></a> +GCC is distributed via <a href="http://gcc.gnu.org/svn.html">SVN</a> and FTP +tarballs compressed with <samp><span class="command">gzip</span></samp> or +<samp><span class="command">bzip2</span></samp>. It is possible to download a full distribution or specific +components. + + <p>Please refer to the <a href="http://gcc.gnu.org/releases.html">releases web page</a> +for information on how to obtain GCC. + + <p>The full distribution includes the C, C++, Objective-C, Fortran, Java, +and Ada (in the case of GCC 3.1 and later) compilers. The full +distribution also includes runtime libraries for C++, Objective-C, +Fortran, and Java. In GCC 3.0 and later versions, the GNU compiler +testsuites are also included in the full distribution. + + <p>If you choose to download specific components, you must download the core +GCC distribution plus any language specific distributions you wish to +use. The core distribution includes the C language front end as well as the +shared components. Each language has a tarball which includes the language +front end as well as the language runtime (when appropriate). + + <p>Unpack the core distribution as well as any language specific +distributions in the same directory. + + <p>If you also intend to build binutils (either to upgrade an existing +installation or for use in place of the corresponding tools of your +OS), unpack the binutils distribution either in the same directory or +a separate one. In the latter case, add symbolic links to any +components of the binutils you intend to build alongside the compiler +(<samp><span class="file">bfd</span></samp>, <samp><span class="file">binutils</span></samp>, <samp><span class="file">gas</span></samp>, <samp><span class="file">gprof</span></samp>, <samp><span class="file">ld</span></samp>, +<samp><span class="file">opcodes</span></samp>, <small class="dots">...</small>) to the directory containing the GCC sources. + + <p><hr /> +<p><a href="./index.html">Return to the GCC Installation page</a> + +<!-- ***Configuration*********************************************************** --> +<!-- ***Building**************************************************************** --> +<!-- ***Testing***************************************************************** --> +<!-- ***Final install*********************************************************** --> +<!-- ***Binaries**************************************************************** --> +<!-- ***Specific**************************************************************** --> +<!-- ***Old documentation****************************************************** --> +<!-- ***GFDL******************************************************************** --> +<!-- *************************************************************************** --> +<!-- Part 6 The End of the Document --> +</body></html> + diff --git a/gcc-4.3.1/INSTALL/finalinstall.html b/gcc-4.3.1/INSTALL/finalinstall.html new file mode 100644 index 000000000..79fa9cb7e --- /dev/null +++ b/gcc-4.3.1/INSTALL/finalinstall.html @@ -0,0 +1,169 @@ +<html lang="en"> +<head> +<title>Installing GCC: Final installation</title> +<meta http-equiv="Content-Type" content="text/html"> +<meta name="description" content="Installing GCC: Final installation"> +<meta name="generator" content="makeinfo 4.11"> +<link title="Top" rel="top" href="#Top"> +<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage"> +<!-- +Copyright (C) 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998, +1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc. + + Permission is granted to copy, distribute and/or modify this document +under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no +Invariant Sections, the Front-Cover texts being (a) (see below), and +with the Back-Cover Texts being (b) (see below). A copy of the +license is included in the section entitled "GNU Free Documentation License". + +(a) The FSF's Front-Cover Text is: + + A GNU Manual + +(b) The FSF's Back-Cover Text is: + + You have freedom to copy and modify this GNU Manual, like GNU + software. Copies published by the Free Software Foundation raise + funds for GNU development.--> +<meta http-equiv="Content-Style-Type" content="text/css"> +<style type="text/css"><!-- + pre.display { font-family:inherit } + pre.format { font-family:inherit } + pre.smalldisplay { font-family:inherit; font-size:smaller } + pre.smallformat { font-family:inherit; font-size:smaller } + pre.smallexample { font-size:smaller } + pre.smalllisp { font-size:smaller } + span.sc { font-variant:small-caps } + span.roman { font-family:serif; font-weight:normal; } + span.sansserif { font-family:sans-serif; font-weight:normal; } +--></style> +</head> +<body> +<h1 class="settitle">Installing GCC: Final installation</h1> +Now that GCC has been built (and optionally tested), you can install it with +<pre class="smallexample"> cd <var>objdir</var>; make install +</pre> + <p>We strongly recommend to install into a target directory where there is +no previous version of GCC present. Also, the GNAT runtime should not +be stripped, as this would break certain features of the debugger that +depend on this debugging information (catching Ada exceptions for +instance). + + <p>That step completes the installation of GCC; user level binaries can +be found in <samp><var>prefix</var><span class="file">/bin</span></samp> where <var>prefix</var> is the value +you specified with the <samp><span class="option">--prefix</span></samp> to configure (or +<samp><span class="file">/usr/local</span></samp> by default). (If you specified <samp><span class="option">--bindir</span></samp>, +that directory will be used instead; otherwise, if you specified +<samp><span class="option">--exec-prefix</span></samp>, <samp><var>exec-prefix</var><span class="file">/bin</span></samp> will be used.) +Headers for the C++ and Java libraries are installed in +<samp><var>prefix</var><span class="file">/include</span></samp>; libraries in <samp><var>libdir</var></samp> +(normally <samp><var>prefix</var><span class="file">/lib</span></samp>); internal parts of the compiler in +<samp><var>libdir</var><span class="file">/gcc</span></samp> and <samp><var>libexecdir</var><span class="file">/gcc</span></samp>; documentation +in info format in <samp><var>infodir</var></samp> (normally +<samp><var>prefix</var><span class="file">/info</span></samp>). + + <p>When installing cross-compilers, GCC's executables +are not only installed into <samp><var>bindir</var></samp>, that +is, <samp><var>exec-prefix</var><span class="file">/bin</span></samp>, but additionally into +<samp><var>exec-prefix</var><span class="file">/</span><var>target-alias</var><span class="file">/bin</span></samp>, if that directory +exists. Typically, such <dfn>tooldirs</dfn> hold target-specific +binutils, including assembler and linker. + + <p>Installation into a temporary staging area or into a <samp><span class="command">chroot</span></samp> +jail can be achieved with the command + +<pre class="smallexample"> make DESTDIR=<var>path-to-rootdir</var> install +</pre> + <p class="noindent">where <var>path-to-rootdir</var> is the absolute path of +a directory relative to which all installation paths will be +interpreted. Note that the directory specified by <code>DESTDIR</code> +need not exist yet; it will be created if necessary. + + <p>There is a subtle point with tooldirs and <code>DESTDIR</code>: +If you relocate a cross-compiler installation with +e.g. ‘<samp><span class="samp">DESTDIR=</span><var>rootdir</var></samp>’, then the directory +<samp><var>rootdir</var><span class="file">/</span><var>exec-prefix</var><span class="file">/</span><var>target-alias</var><span class="file">/bin</span></samp> will +be filled with duplicated GCC executables only if it already exists, +it will not be created otherwise. This is regarded as a feature, +not as a bug, because it gives slightly more control to the packagers +using the <code>DESTDIR</code> feature. + + <p>If you are bootstrapping a released version of GCC then please +quickly review the build status page for your release, available from +<a href="http://gcc.gnu.org/buildstat.html">http://gcc.gnu.org/buildstat.html</a>. +If your system is not listed for the version of GCC that you built, +send a note to +<a href="mailto:gcc@gcc.gnu.org">gcc@gcc.gnu.org</a> indicating +that you successfully built and installed GCC. +Include the following information: + + <ul> +<li>Output from running <samp><var>srcdir</var><span class="file">/config.guess</span></samp>. Do not send +that file itself, just the one-line output from running it. + + <li>The output of ‘<samp><span class="samp">gcc -v</span></samp>’ for your newly installed <samp><span class="command">gcc</span></samp>. +This tells us which version of GCC you built and the options you passed to +configure. + + <li>Whether you enabled all languages or a subset of them. If you used a +full distribution then this information is part of the configure +options in the output of ‘<samp><span class="samp">gcc -v</span></samp>’, but if you downloaded the +“core” compiler plus additional front ends then it isn't apparent +which ones you built unless you tell us about it. + + <li>If the build was for GNU/Linux, also include: + <ul> +<li>The distribution name and version (e.g., Red Hat 7.1 or Debian 2.2.3); +this information should be available from <samp><span class="file">/etc/issue</span></samp>. + + <li>The version of the Linux kernel, available from ‘<samp><span class="samp">uname --version</span></samp>’ +or ‘<samp><span class="samp">uname -a</span></samp>’. + + <li>The version of glibc you used; for RPM-based systems like Red Hat, +Mandrake, and SuSE type ‘<samp><span class="samp">rpm -q glibc</span></samp>’ to get the glibc version, +and on systems like Debian and Progeny use ‘<samp><span class="samp">dpkg -l libc6</span></samp>’. +</ul> + For other systems, you can include similar information if you think it is +relevant. + + <li>Any other information that you think would be useful to people building +GCC on the same configuration. The new entry in the build status list +will include a link to the archived copy of your message. +</ul> + + <p>We'd also like to know if the +<a href="specific.html">host/target specific installation notes</a> +didn't include your host/target information or if that information is +incomplete or out of date. Send a note to +<a href="mailto:gcc@gcc.gnu.org">gcc@gcc.gnu.org</a> detailing how the information should be changed. + + <p>If you find a bug, please report it following the +<a href="../bugs.html">bug reporting guidelines</a>. + + <p>If you want to print the GCC manuals, do ‘<samp><span class="samp">cd </span><var>objdir</var><span class="samp">; make +dvi</span></samp>’. You will need to have <samp><span class="command">texi2dvi</span></samp> (version at least 4.4) +and TeX installed. This creates a number of <samp><span class="file">.dvi</span></samp> files in +subdirectories of <samp><var>objdir</var></samp>; these may be converted for +printing with programs such as <samp><span class="command">dvips</span></samp>. Alternately, by using +‘<samp><span class="samp">make pdf</span></samp>’ in place of ‘<samp><span class="samp">make dvi</span></samp>’, you can create documentation +in the form of <samp><span class="file">.pdf</span></samp> files; this requires <samp><span class="command">texi2pdf</span></samp>, which +is included with Texinfo version 4.8 and later. You can also +<a href="http://www.gnu.org/order/order.html">buy printed manuals from the Free Software Foundation</a>, though such manuals may not be for the most +recent version of GCC. + + <p>If you would like to generate online HTML documentation, do ‘<samp><span class="samp">cd +</span><var>objdir</var><span class="samp">; make html</span></samp>’ and HTML will be generated for the gcc manuals in +<samp><var>objdir</var><span class="file">/gcc/HTML</span></samp>. + + <p><hr /> +<p><a href="./index.html">Return to the GCC Installation page</a> + +<!-- ***Binaries**************************************************************** --> +<!-- ***Specific**************************************************************** --> +<!-- ***Old documentation****************************************************** --> +<!-- ***GFDL******************************************************************** --> +<!-- *************************************************************************** --> +<!-- Part 6 The End of the Document --> +</body></html> + diff --git a/gcc-4.3.1/INSTALL/gfdl.html b/gcc-4.3.1/INSTALL/gfdl.html new file mode 100644 index 000000000..4e1cf4bc7 --- /dev/null +++ b/gcc-4.3.1/INSTALL/gfdl.html @@ -0,0 +1,462 @@ +<html lang="en"> +<head> +<title>Installing GCC: GNU Free Documentation License</title> +<meta http-equiv="Content-Type" content="text/html"> +<meta name="description" content="Installing GCC: GNU Free Documentation License"> +<meta name="generator" content="makeinfo 4.11"> +<link title="Top" rel="top" href="#Top"> +<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage"> +<!-- +Copyright (C) 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998, +1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc. + + Permission is granted to copy, distribute and/or modify this document +under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no +Invariant Sections, the Front-Cover texts being (a) (see below), and +with the Back-Cover Texts being (b) (see below). A copy of the +license is included in the section entitled "GNU Free Documentation License". + +(a) The FSF's Front-Cover Text is: + + A GNU Manual + +(b) The FSF's Back-Cover Text is: + + You have freedom to copy and modify this GNU Manual, like GNU + software. Copies published by the Free Software Foundation raise + funds for GNU development.--> +<meta http-equiv="Content-Style-Type" content="text/css"> +<style type="text/css"><!-- + pre.display { font-family:inherit } + pre.format { font-family:inherit } + pre.smalldisplay { font-family:inherit; font-size:smaller } + pre.smallformat { font-family:inherit; font-size:smaller } + pre.smallexample { font-size:smaller } + pre.smalllisp { font-size:smaller } + span.sc { font-variant:small-caps } + span.roman { font-family:serif; font-weight:normal; } + span.sansserif { font-family:sans-serif; font-weight:normal; } +--></style> +</head> +<body> +<h1 class="settitle">Installing GCC: GNU Free Documentation License</h1> +<h1 align="center">Installing GCC: GNU Free Documentation License</h1><!-- man begin DESCRIPTION --> + + <p><a name="index-FDL_002c-GNU-Free-Documentation-License-1"></a><div align="center">Version 1.2, November 2002</div> + +<pre class="display"> Copyright © 2000,2001,2002 Free Software Foundation, Inc. + 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA + + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. +</pre> + <ol type=1 start=0> +<li>PREAMBLE + + <p>The purpose of this License is to make a manual, textbook, or other +functional and useful document <dfn>free</dfn> in the sense of freedom: to +assure everyone the effective freedom to copy and redistribute it, +with or without modifying it, either commercially or noncommercially. +Secondarily, this License preserves for the author and publisher a way +to get credit for their work, while not being considered responsible +for modifications made by others. + + <p>This License is a kind of “copyleft”, which means that derivative +works of the document must themselves be free in the same sense. It +complements the GNU General Public License, which is a copyleft +license designed for free software. + + <p>We have designed this License in order to use it for manuals for free +software, because free software needs free documentation: a free +program should come with manuals providing the same freedoms that the +software does. But this License is not limited to software manuals; +it can be used for any textual work, regardless of subject matter or +whether it is published as a printed book. We recommend this License +principally for works whose purpose is instruction or reference. + + <li>APPLICABILITY AND DEFINITIONS + + <p>This License applies to any manual or other work, in any medium, that +contains a notice placed by the copyright holder saying it can be +distributed under the terms of this License. Such a notice grants a +world-wide, royalty-free license, unlimited in duration, to use that +work under the conditions stated herein. The “Document”, below, +refers to any such manual or work. Any member of the public is a +licensee, and is addressed as “you”. You accept the license if you +copy, modify or distribute the work in a way requiring permission +under copyright law. + + <p>A “Modified Version” of the Document means any work containing the +Document or a portion of it, either copied verbatim, or with +modifications and/or translated into another language. + + <p>A “Secondary Section” is a named appendix or a front-matter section +of the Document that deals exclusively with the relationship of the +publishers or authors of the Document to the Document's overall +subject (or to related matters) and contains nothing that could fall +directly within that overall subject. (Thus, if the Document is in +part a textbook of mathematics, a Secondary Section may not explain +any mathematics.) The relationship could be a matter of historical +connection with the subject or with related matters, or of legal, +commercial, philosophical, ethical or political position regarding +them. + + <p>The “Invariant Sections” are certain Secondary Sections whose titles +are designated, as being those of Invariant Sections, in the notice +that says that the Document is released under this License. If a +section does not fit the above definition of Secondary then it is not +allowed to be designated as Invariant. The Document may contain zero +Invariant Sections. If the Document does not identify any Invariant +Sections then there are none. + + <p>The “Cover Texts” are certain short passages of text that are listed, +as Front-Cover Texts or Back-Cover Texts, in the notice that says that +the Document is released under this License. A Front-Cover Text may +be at most 5 words, and a Back-Cover Text may be at most 25 words. + + <p>A “Transparent” copy of the Document means a machine-readable copy, +represented in a format whose specification is available to the +general public, that is suitable for revising the document +straightforwardly with generic text editors or (for images composed of +pixels) generic paint programs or (for drawings) some widely available +drawing editor, and that is suitable for input to text formatters or +for automatic translation to a variety of formats suitable for input +to text formatters. A copy made in an otherwise Transparent file +format whose markup, or absence of markup, has been arranged to thwart +or discourage subsequent modification by readers is not Transparent. +An image format is not Transparent if used for any substantial amount +of text. A copy that is not “Transparent” is called “Opaque”. + + <p>Examples of suitable formats for Transparent copies include plain +<span class="sc">ascii</span> without markup, Texinfo input format, LaTeX input +format, <acronym>SGML</acronym> or <acronym>XML</acronym> using a publicly available +<acronym>DTD</acronym>, and standard-conforming simple <acronym>HTML</acronym>, +PostScript or <acronym>PDF</acronym> designed for human modification. Examples +of transparent image formats include <acronym>PNG</acronym>, <acronym>XCF</acronym> and +<acronym>JPG</acronym>. Opaque formats include proprietary formats that can be +read and edited only by proprietary word processors, <acronym>SGML</acronym> or +<acronym>XML</acronym> for which the <acronym>DTD</acronym> and/or processing tools are +not generally available, and the machine-generated <acronym>HTML</acronym>, +PostScript or <acronym>PDF</acronym> produced by some word processors for +output purposes only. + + <p>The “Title Page” means, for a printed book, the title page itself, +plus such following pages as are needed to hold, legibly, the material +this License requires to appear in the title page. For works in +formats which do not have any title page as such, “Title Page” means +the text near the most prominent appearance of the work's title, +preceding the beginning of the body of the text. + + <p>A section “Entitled XYZ” means a named subunit of the Document whose +title either is precisely XYZ or contains XYZ in parentheses following +text that translates XYZ in another language. (Here XYZ stands for a +specific section name mentioned below, such as “Acknowledgements”, +“Dedications”, “Endorsements”, or “History”.) To “Preserve the Title” +of such a section when you modify the Document means that it remains a +section “Entitled XYZ” according to this definition. + + <p>The Document may include Warranty Disclaimers next to the notice which +states that this License applies to the Document. These Warranty +Disclaimers are considered to be included by reference in this +License, but only as regards disclaiming warranties: any other +implication that these Warranty Disclaimers may have is void and has +no effect on the meaning of this License. + + <li>VERBATIM COPYING + + <p>You may copy and distribute the Document in any medium, either +commercially or noncommercially, provided that this License, the +copyright notices, and the license notice saying this License applies +to the Document are reproduced in all copies, and that you add no other +conditions whatsoever to those of this License. You may not use +technical measures to obstruct or control the reading or further +copying of the copies you make or distribute. However, you may accept +compensation in exchange for copies. If you distribute a large enough +number of copies you must also follow the conditions in section 3. + + <p>You may also lend copies, under the same conditions stated above, and +you may publicly display copies. + + <li>COPYING IN QUANTITY + + <p>If you publish printed copies (or copies in media that commonly have +printed covers) of the Document, numbering more than 100, and the +Document's license notice requires Cover Texts, you must enclose the +copies in covers that carry, clearly and legibly, all these Cover +Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on +the back cover. Both covers must also clearly and legibly identify +you as the publisher of these copies. The front cover must present +the full title with all words of the title equally prominent and +visible. You may add other material on the covers in addition. +Copying with changes limited to the covers, as long as they preserve +the title of the Document and satisfy these conditions, can be treated +as verbatim copying in other respects. + + <p>If the required texts for either cover are too voluminous to fit +legibly, you should put the first ones listed (as many as fit +reasonably) on the actual cover, and continue the rest onto adjacent +pages. + + <p>If you publish or distribute Opaque copies of the Document numbering +more than 100, you must either include a machine-readable Transparent +copy along with each Opaque copy, or state in or with each Opaque copy +a computer-network location from which the general network-using +public has access to download using public-standard network protocols +a complete Transparent copy of the Document, free of added material. +If you use the latter option, you must take reasonably prudent steps, +when you begin distribution of Opaque copies in quantity, to ensure +that this Transparent copy will remain thus accessible at the stated +location until at least one year after the last time you distribute an +Opaque copy (directly or through your agents or retailers) of that +edition to the public. + + <p>It is requested, but not required, that you contact the authors of the +Document well before redistributing any large number of copies, to give +them a chance to provide you with an updated version of the Document. + + <li>MODIFICATIONS + + <p>You may copy and distribute a Modified Version of the Document under +the conditions of sections 2 and 3 above, provided that you release +the Modified Version under precisely this License, with the Modified +Version filling the role of the Document, thus licensing distribution +and modification of the Modified Version to whoever possesses a copy +of it. In addition, you must do these things in the Modified Version: + + <ol type=A start=1> +<li>Use in the Title Page (and on the covers, if any) a title distinct +from that of the Document, and from those of previous versions +(which should, if there were any, be listed in the History section +of the Document). You may use the same title as a previous version +if the original publisher of that version gives permission. + + <li>List on the Title Page, as authors, one or more persons or entities +responsible for authorship of the modifications in the Modified +Version, together with at least five of the principal authors of the +Document (all of its principal authors, if it has fewer than five), +unless they release you from this requirement. + + <li>State on the Title page the name of the publisher of the +Modified Version, as the publisher. + + <li>Preserve all the copyright notices of the Document. + + <li>Add an appropriate copyright notice for your modifications +adjacent to the other copyright notices. + + <li>Include, immediately after the copyright notices, a license notice +giving the public permission to use the Modified Version under the +terms of this License, in the form shown in the Addendum below. + + <li>Preserve in that license notice the full lists of Invariant Sections +and required Cover Texts given in the Document's license notice. + + <li>Include an unaltered copy of this License. + + <li>Preserve the section Entitled “History”, Preserve its Title, and add +to it an item stating at least the title, year, new authors, and +publisher of the Modified Version as given on the Title Page. If +there is no section Entitled “History” in the Document, create one +stating the title, year, authors, and publisher of the Document as +given on its Title Page, then add an item describing the Modified +Version as stated in the previous sentence. + + <li>Preserve the network location, if any, given in the Document for +public access to a Transparent copy of the Document, and likewise +the network locations given in the Document for previous versions +it was based on. These may be placed in the “History” section. +You may omit a network location for a work that was published at +least four years before the Document itself, or if the original +publisher of the version it refers to gives permission. + + <li>For any section Entitled “Acknowledgements” or “Dedications”, Preserve +the Title of the section, and preserve in the section all the +substance and tone of each of the contributor acknowledgements and/or +dedications given therein. + + <li>Preserve all the Invariant Sections of the Document, +unaltered in their text and in their titles. Section numbers +or the equivalent are not considered part of the section titles. + + <li>Delete any section Entitled “Endorsements”. Such a section +may not be included in the Modified Version. + + <li>Do not retitle any existing section to be Entitled “Endorsements” or +to conflict in title with any Invariant Section. + + <li>Preserve any Warranty Disclaimers. + </ol> + + <p>If the Modified Version includes new front-matter sections or +appendices that qualify as Secondary Sections and contain no material +copied from the Document, you may at your option designate some or all +of these sections as invariant. To do this, add their titles to the +list of Invariant Sections in the Modified Version's license notice. +These titles must be distinct from any other section titles. + + <p>You may add a section Entitled “Endorsements”, provided it contains +nothing but endorsements of your Modified Version by various +parties—for example, statements of peer review or that the text has +been approved by an organization as the authoritative definition of a +standard. + + <p>You may add a passage of up to five words as a Front-Cover Text, and a +passage of up to 25 words as a Back-Cover Text, to the end of the list +of Cover Texts in the Modified Version. Only one passage of +Front-Cover Text and one of Back-Cover Text may be added by (or +through arrangements made by) any one entity. If the Document already +includes a cover text for the same cover, previously added by you or +by arrangement made by the same entity you are acting on behalf of, +you may not add another; but you may replace the old one, on explicit +permission from the previous publisher that added the old one. + + <p>The author(s) and publisher(s) of the Document do not by this License +give permission to use their names for publicity for or to assert or +imply endorsement of any Modified Version. + + <li>COMBINING DOCUMENTS + + <p>You may combine the Document with other documents released under this +License, under the terms defined in section 4 above for modified +versions, provided that you include in the combination all of the +Invariant Sections of all of the original documents, unmodified, and +list them all as Invariant Sections of your combined work in its +license notice, and that you preserve all their Warranty Disclaimers. + + <p>The combined work need only contain one copy of this License, and +multiple identical Invariant Sections may be replaced with a single +copy. If there are multiple Invariant Sections with the same name but +different contents, make the title of each such section unique by +adding at the end of it, in parentheses, the name of the original +author or publisher of that section if known, or else a unique number. +Make the same adjustment to the section titles in the list of +Invariant Sections in the license notice of the combined work. + + <p>In the combination, you must combine any sections Entitled “History” +in the various original documents, forming one section Entitled +“History”; likewise combine any sections Entitled “Acknowledgements”, +and any sections Entitled “Dedications”. You must delete all +sections Entitled “Endorsements.” + + <li>COLLECTIONS OF DOCUMENTS + + <p>You may make a collection consisting of the Document and other documents +released under this License, and replace the individual copies of this +License in the various documents with a single copy that is included in +the collection, provided that you follow the rules of this License for +verbatim copying of each of the documents in all other respects. + + <p>You may extract a single document from such a collection, and distribute +it individually under this License, provided you insert a copy of this +License into the extracted document, and follow this License in all +other respects regarding verbatim copying of that document. + + <li>AGGREGATION WITH INDEPENDENT WORKS + + <p>A compilation of the Document or its derivatives with other separate +and independent documents or works, in or on a volume of a storage or +distribution medium, is called an “aggregate” if the copyright +resulting from the compilation is not used to limit the legal rights +of the compilation's users beyond what the individual works permit. +When the Document is included in an aggregate, this License does not +apply to the other works in the aggregate which are not themselves +derivative works of the Document. + + <p>If the Cover Text requirement of section 3 is applicable to these +copies of the Document, then if the Document is less than one half of +the entire aggregate, the Document's Cover Texts may be placed on +covers that bracket the Document within the aggregate, or the +electronic equivalent of covers if the Document is in electronic form. +Otherwise they must appear on printed covers that bracket the whole +aggregate. + + <li>TRANSLATION + + <p>Translation is considered a kind of modification, so you may +distribute translations of the Document under the terms of section 4. +Replacing Invariant Sections with translations requires special +permission from their copyright holders, but you may include +translations of some or all Invariant Sections in addition to the +original versions of these Invariant Sections. You may include a +translation of this License, and all the license notices in the +Document, and any Warranty Disclaimers, provided that you also include +the original English version of this License and the original versions +of those notices and disclaimers. In case of a disagreement between +the translation and the original version of this License or a notice +or disclaimer, the original version will prevail. + + <p>If a section in the Document is Entitled “Acknowledgements”, +“Dedications”, or “History”, the requirement (section 4) to Preserve +its Title (section 1) will typically require changing the actual +title. + + <li>TERMINATION + + <p>You may not copy, modify, sublicense, or distribute the Document except +as expressly provided for under this License. Any other attempt to +copy, modify, sublicense or distribute the Document is void, and will +automatically terminate your rights under this License. However, +parties who have received copies, or rights, from you under this +License will not have their licenses terminated so long as such +parties remain in full compliance. + + <li>FUTURE REVISIONS OF THIS LICENSE + + <p>The Free Software Foundation may publish new, revised versions +of the GNU Free Documentation License from time to time. Such new +versions will be similar in spirit to the present version, but may +differ in detail to address new problems or concerns. See +<a href="http://www.gnu.org/copyleft/">http://www.gnu.org/copyleft/</a>. + + <p>Each version of the License is given a distinguishing version number. +If the Document specifies that a particular numbered version of this +License “or any later version” applies to it, you have the option of +following the terms and conditions either of that specified version or +of any later version that has been published (not as a draft) by the +Free Software Foundation. If the Document does not specify a version +number of this License, you may choose any version ever published (not +as a draft) by the Free Software Foundation. + </ol> + +<h3 class="unnumberedsec"><a name="TOC0"></a>ADDENDUM: How to use this License for your documents</h3> + +<p>To use this License in a document you have written, include a copy of +the License in the document and put the following copyright and +license notices just after the title page: + +<pre class="smallexample"> Copyright (C) <var>year</var> <var>your name</var>. + Permission is granted to copy, distribute and/or modify this document + under the terms of the GNU Free Documentation License, Version 1.2 + or any later version published by the Free Software Foundation; + with no Invariant Sections, no Front-Cover Texts, and no Back-Cover + Texts. A copy of the license is included in the section entitled ``GNU + Free Documentation License''. +</pre> + <p>If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts, +replace the “with...Texts.” line with this: + +<pre class="smallexample"> with the Invariant Sections being <var>list their titles</var>, with + the Front-Cover Texts being <var>list</var>, and with the Back-Cover Texts + being <var>list</var>. +</pre> + <p>If you have Invariant Sections without Cover Texts, or some other +combination of the three, merge those two alternatives to suit the +situation. + + <p>If your document contains nontrivial examples of program code, we +recommend releasing these examples in parallel under your choice of +free software license, such as the GNU General Public License, +to permit their use in free software. + +<!-- Local Variables: --> +<!-- ispell-local-pdict: "ispell-dict" --> +<!-- End: --> +<!-- man end --> + <p><hr /> +<p><a href="./index.html">Return to the GCC Installation page</a> + +<!-- *************************************************************************** --> +<!-- Part 6 The End of the Document --> +</body></html> + diff --git a/gcc-4.3.1/INSTALL/index.html b/gcc-4.3.1/INSTALL/index.html new file mode 100644 index 000000000..6e1193109 --- /dev/null +++ b/gcc-4.3.1/INSTALL/index.html @@ -0,0 +1,123 @@ +<html lang="en"> +<head> +<title>Installing GCC</title> +<meta http-equiv="Content-Type" content="text/html"> +<meta name="description" content="Installing GCC"> +<meta name="generator" content="makeinfo 4.11"> +<link title="Top" rel="top" href="#Top"> +<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage"> +<!-- +Copyright (C) 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998, +1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc. + + Permission is granted to copy, distribute and/or modify this document +under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no +Invariant Sections, the Front-Cover texts being (a) (see below), and +with the Back-Cover Texts being (b) (see below). A copy of the +license is included in the section entitled "GNU Free Documentation License". + +(a) The FSF's Front-Cover Text is: + + A GNU Manual + +(b) The FSF's Back-Cover Text is: + + You have freedom to copy and modify this GNU Manual, like GNU + software. Copies published by the Free Software Foundation raise + funds for GNU development.--> +<meta http-equiv="Content-Style-Type" content="text/css"> +<style type="text/css"><!-- + pre.display { font-family:inherit } + pre.format { font-family:inherit } + pre.smalldisplay { font-family:inherit; font-size:smaller } + pre.smallformat { font-family:inherit; font-size:smaller } + pre.smallexample { font-size:smaller } + pre.smalllisp { font-size:smaller } + span.sc { font-variant:small-caps } + span.roman { font-family:serif; font-weight:normal; } + span.sansserif { font-family:sans-serif; font-weight:normal; } +--></style> +</head> +<body> +<h1 class="settitle">Installing GCC</h1> +The latest version of this document is always available at +<a href="http://gcc.gnu.org/install/">http://gcc.gnu.org/install/</a>. + + <p>This document describes the generic installation procedure for GCC as well +as detailing some target specific installation instructions. + + <p>GCC includes several components that previously were separate distributions +with their own installation instructions. This document supersedes all +package specific installation instructions. + + <p><em>Before</em> starting the build/install procedure please check the +<a href="specific.html">host/target specific installation notes</a>. +We recommend you browse the entire generic installation instructions before +you proceed. + + <p>Lists of successful builds for released versions of GCC are +available at <a href="http://gcc.gnu.org/buildstat.html">http://gcc.gnu.org/buildstat.html</a>. +These lists are updated as new information becomes available. + + <p>The installation procedure itself is broken into five steps. + + <ol type=1 start=1> +<li><a href="prerequisites.html">Prerequisites</a> +<li><a href="download.html">Downloading the source</a> +<li><a href="configure.html">Configuration</a> +<li><a href="build.html">Building</a> +<li><a href="test.html">Testing</a> (optional) +<li><a href="finalinstall.html">Final install</a> + </ol> + + <p>Please note that GCC does not support ‘<samp><span class="samp">make uninstall</span></samp>’ and probably +won't do so in the near future as this would open a can of worms. Instead, +we suggest that you install GCC into a directory of its own and simply +remove that directory when you do not need that specific version of GCC +any longer, and, if shared libraries are installed there as well, no +more binaries exist that use them. + + <p>There are also some <a href="old.html">old installation instructions</a>, +which are mostly obsolete but still contain some information which has +not yet been merged into the main part of this manual. + + <p><hr /> +<p><a href="./index.html">Return to the GCC Installation page</a> + + <p>Copyright © 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998, +1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc. + <pre class="sp"> + +</pre> +Permission is granted to copy, distribute and/or modify this document +under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no +Invariant Sections, the Front-Cover texts being (a) (see below), and +with the Back-Cover Texts being (b) (see below). A copy of the +license is included in the section entitled “<a href="./gfdl.html">GNU Free Documentation License</a>”. + + <p>(a) The FSF's Front-Cover Text is: + + <p>A GNU Manual + + <p>(b) The FSF's Back-Cover Text is: + + <p>You have freedom to copy and modify this GNU Manual, like GNU + software. Copies published by the Free Software Foundation raise + funds for GNU development. + +<!-- ***Prerequisites************************************************** --> +<!-- ***Downloading the source************************************************** --> +<!-- ***Configuration*********************************************************** --> +<!-- ***Building**************************************************************** --> +<!-- ***Testing***************************************************************** --> +<!-- ***Final install*********************************************************** --> +<!-- ***Binaries**************************************************************** --> +<!-- ***Specific**************************************************************** --> +<!-- ***Old documentation****************************************************** --> +<!-- ***GFDL******************************************************************** --> +<!-- *************************************************************************** --> +<!-- Part 6 The End of the Document --> +</body></html> + diff --git a/gcc-4.3.1/INSTALL/old.html b/gcc-4.3.1/INSTALL/old.html new file mode 100644 index 000000000..fde039401 --- /dev/null +++ b/gcc-4.3.1/INSTALL/old.html @@ -0,0 +1,212 @@ +<html lang="en"> +<head> +<title>Installing GCC: Old documentation</title> +<meta http-equiv="Content-Type" content="text/html"> +<meta name="description" content="Installing GCC: Old documentation"> +<meta name="generator" content="makeinfo 4.11"> +<link title="Top" rel="top" href="#Top"> +<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage"> +<!-- +Copyright (C) 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998, +1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc. + + Permission is granted to copy, distribute and/or modify this document +under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no +Invariant Sections, the Front-Cover texts being (a) (see below), and +with the Back-Cover Texts being (b) (see below). A copy of the +license is included in the section entitled "GNU Free Documentation License". + +(a) The FSF's Front-Cover Text is: + + A GNU Manual + +(b) The FSF's Back-Cover Text is: + + You have freedom to copy and modify this GNU Manual, like GNU + software. Copies published by the Free Software Foundation raise + funds for GNU development.--> +<meta http-equiv="Content-Style-Type" content="text/css"> +<style type="text/css"><!-- + pre.display { font-family:inherit } + pre.format { font-family:inherit } + pre.smalldisplay { font-family:inherit; font-size:smaller } + pre.smallformat { font-family:inherit; font-size:smaller } + pre.smallexample { font-size:smaller } + pre.smalllisp { font-size:smaller } + span.sc { font-variant:small-caps } + span.roman { font-family:serif; font-weight:normal; } + span.sansserif { font-family:sans-serif; font-weight:normal; } +--></style> +</head> +<body> +<h1 class="settitle">Installing GCC: Old documentation</h1> +<h1 align="center">Old installation documentation</h1> + + <p>Note most of this information is out of date and superseded by the +previous chapters of this manual. It is provided for historical +reference only, because of a lack of volunteers to merge it into the +main manual. + + <p>Here is the procedure for installing GCC on a GNU or Unix system. + + <ol type=1 start=1> +<li>If you have chosen a configuration for GCC which requires other GNU +tools (such as GAS or the GNU linker) instead of the standard system +tools, install the required tools in the build directory under the names +<samp><span class="file">as</span></samp>, <samp><span class="file">ld</span></samp> or whatever is appropriate. + + <p>Alternatively, you can do subsequent compilation using a value of the +<code>PATH</code> environment variable such that the necessary GNU tools come +before the standard system tools. + + <li>Specify the host, build and target machine configurations. You do this +when you run the <samp><span class="file">configure</span></samp> script. + + <p>The <dfn>build</dfn> machine is the system which you are using, the +<dfn>host</dfn> machine is the system where you want to run the resulting +compiler (normally the build machine), and the <dfn>target</dfn> machine is +the system for which you want the compiler to generate code. + + <p>If you are building a compiler to produce code for the machine it runs +on (a native compiler), you normally do not need to specify any operands +to <samp><span class="file">configure</span></samp>; it will try to guess the type of machine you are on +and use that as the build, host and target machines. So you don't need +to specify a configuration when building a native compiler unless +<samp><span class="file">configure</span></samp> cannot figure out what your configuration is or guesses +wrong. + + <p>In those cases, specify the build machine's <dfn>configuration name</dfn> +with the <samp><span class="option">--host</span></samp> option; the host and target will default to be +the same as the host machine. + + <p>Here is an example: + + <pre class="smallexample"> ./configure --host=sparc-sun-sunos4.1 +</pre> + <p>A configuration name may be canonical or it may be more or less +abbreviated. + + <p>A canonical configuration name has three parts, separated by dashes. +It looks like this: ‘<samp><var>cpu</var><span class="samp">-</span><var>company</var><span class="samp">-</span><var>system</var></samp>’. +(The three parts may themselves contain dashes; <samp><span class="file">configure</span></samp> +can figure out which dashes serve which purpose.) For example, +‘<samp><span class="samp">m68k-sun-sunos4.1</span></samp>’ specifies a Sun 3. + + <p>You can also replace parts of the configuration by nicknames or aliases. +For example, ‘<samp><span class="samp">sun3</span></samp>’ stands for ‘<samp><span class="samp">m68k-sun</span></samp>’, so +‘<samp><span class="samp">sun3-sunos4.1</span></samp>’ is another way to specify a Sun 3. + + <p>You can specify a version number after any of the system types, and some +of the CPU types. In most cases, the version is irrelevant, and will be +ignored. So you might as well specify the version if you know it. + + <p>See <a href="#Configurations">Configurations</a>, for a list of supported configuration names and +notes on many of the configurations. You should check the notes in that +section before proceeding any further with the installation of GCC. + + </ol> + + <p><h2><a name="Configurations"></a>Configurations Supported by GCC</h2><a name="index-configurations-supported-by-GCC-1"></a> +Here are the possible CPU types: + + <blockquote> +<!-- gmicro, fx80, spur and tahoe omitted since they don't work. --> +1750a, a29k, alpha, arm, avr, c<var>n</var>, clipper, dsp16xx, elxsi, fr30, h8300, +hppa1.0, hppa1.1, i370, i386, i486, i586, i686, i786, i860, i960, ip2k, m32r, +m68000, m68k, m6811, m6812, m88k, mcore, mips, mipsel, mips64, mips64el, +mn10200, mn10300, ns32k, pdp11, powerpc, powerpcle, romp, rs6000, sh, sparc, +sparclite, sparc64, v850, vax, we32k. +</blockquote> + + <p>Here are the recognized company names. As you can see, customary +abbreviations are used rather than the longer official names. + +<!-- What should be done about merlin, tek*, dolphin? --> + <blockquote> +acorn, alliant, altos, apollo, apple, att, bull, +cbm, convergent, convex, crds, dec, dg, dolphin, +elxsi, encore, harris, hitachi, hp, ibm, intergraph, isi, +mips, motorola, ncr, next, ns, omron, plexus, +sequent, sgi, sony, sun, tti, unicom, wrs. +</blockquote> + + <p>The company name is meaningful only to disambiguate when the rest of +the information supplied is insufficient. You can omit it, writing +just ‘<samp><var>cpu</var><span class="samp">-</span><var>system</var></samp>’, if it is not needed. For example, +‘<samp><span class="samp">vax-ultrix4.2</span></samp>’ is equivalent to ‘<samp><span class="samp">vax-dec-ultrix4.2</span></samp>’. + + <p>Here is a list of system types: + + <blockquote> +386bsd, aix, acis, amigaos, aos, aout, aux, bosx, bsd, clix, coff, ctix, cxux, +dgux, dynix, ebmon, ecoff, elf, esix, freebsd, hms, genix, gnu, linux, +linux-gnu, hiux, hpux, iris, irix, isc, luna, lynxos, mach, minix, msdos, mvs, +netbsd, newsos, nindy, ns, osf, osfrose, ptx, riscix, riscos, rtu, sco, sim, +solaris, sunos, sym, sysv, udi, ultrix, unicos, uniplus, unos, vms, vsta, +vxworks, winnt, xenix. +</blockquote> + +<p class="noindent">You can omit the system type; then <samp><span class="file">configure</span></samp> guesses the +operating system from the CPU and company. + + <p>You can add a version number to the system type; this may or may not +make a difference. For example, you can write ‘<samp><span class="samp">bsd4.3</span></samp>’ or +‘<samp><span class="samp">bsd4.4</span></samp>’ to distinguish versions of BSD. In practice, the version +number is most needed for ‘<samp><span class="samp">sysv3</span></samp>’ and ‘<samp><span class="samp">sysv4</span></samp>’, which are often +treated differently. + + <p>‘<samp><span class="samp">linux-gnu</span></samp>’ is the canonical name for the GNU/Linux target; however +GCC will also accept ‘<samp><span class="samp">linux</span></samp>’. The version of the kernel in use is +not relevant on these systems. A suffix such as ‘<samp><span class="samp">libc1</span></samp>’ or ‘<samp><span class="samp">aout</span></samp>’ +distinguishes major versions of the C library; all of the suffixed versions +are obsolete. + + <p>If you specify an impossible combination such as ‘<samp><span class="samp">i860-dg-vms</span></samp>’, +then you may get an error message from <samp><span class="file">configure</span></samp>, or it may +ignore part of the information and do the best it can with the rest. +<samp><span class="file">configure</span></samp> always prints the canonical name for the alternative +that it used. GCC does not support all possible alternatives. + + <p>Often a particular model of machine has a name. Many machine names are +recognized as aliases for CPU/company combinations. Thus, the machine +name ‘<samp><span class="samp">sun3</span></samp>’, mentioned above, is an alias for ‘<samp><span class="samp">m68k-sun</span></samp>’. +Sometimes we accept a company name as a machine name, when the name is +popularly used for a particular machine. Here is a table of the known +machine names: + + <blockquote> +3300, 3b1, 3b<var>n</var>, 7300, altos3068, altos, +apollo68, att-7300, balance, +convex-c<var>n</var>, crds, decstation-3100, +decstation, delta, encore, +fx2800, gmicro, hp7<var>nn</var>, hp8<var>nn</var>, +hp9k2<var>nn</var>, hp9k3<var>nn</var>, hp9k7<var>nn</var>, +hp9k8<var>nn</var>, iris4d, iris, isi68, +m3230, magnum, merlin, miniframe, +mmax, news-3600, news800, news, next, +pbd, pc532, pmax, powerpc, powerpcle, ps2, risc-news, +rtpc, sun2, sun386i, sun386, sun3, +sun4, symmetry, tower-32, tower. +</blockquote> + +<p class="noindent">Remember that a machine name specifies both the cpu type and the company +name. +If you want to install your own homemade configuration files, you can +use ‘<samp><span class="samp">local</span></samp>’ as the company name to access them. If you use +configuration ‘<samp><var>cpu</var><span class="samp">-local</span></samp>’, the configuration name +without the cpu prefix +is used to form the configuration file names. + + <p>Thus, if you specify ‘<samp><span class="samp">m68k-local</span></samp>’, configuration uses +files <samp><span class="file">m68k.md</span></samp>, <samp><span class="file">local.h</span></samp>, <samp><span class="file">m68k.c</span></samp>, +<samp><span class="file">xm-local.h</span></samp>, <samp><span class="file">t-local</span></samp>, and <samp><span class="file">x-local</span></samp>, all in the +directory <samp><span class="file">config/m68k</span></samp>. +<hr /> +<p><a href="./index.html">Return to the GCC Installation page</a> + +<!-- ***GFDL******************************************************************** --> +<!-- *************************************************************************** --> +<!-- Part 6 The End of the Document --> +</body></html> + diff --git a/gcc-4.3.1/INSTALL/prerequisites.html b/gcc-4.3.1/INSTALL/prerequisites.html new file mode 100644 index 000000000..7abd3e2e8 --- /dev/null +++ b/gcc-4.3.1/INSTALL/prerequisites.html @@ -0,0 +1,243 @@ +<html lang="en"> +<head> +<title>Prerequisites for GCC</title> +<meta http-equiv="Content-Type" content="text/html"> +<meta name="description" content="Prerequisites for GCC"> +<meta name="generator" content="makeinfo 4.11"> +<link title="Top" rel="top" href="#Top"> +<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage"> +<!-- +Copyright (C) 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998, +1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc. + + Permission is granted to copy, distribute and/or modify this document +under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no +Invariant Sections, the Front-Cover texts being (a) (see below), and +with the Back-Cover Texts being (b) (see below). A copy of the +license is included in the section entitled "GNU Free Documentation License". + +(a) The FSF's Front-Cover Text is: + + A GNU Manual + +(b) The FSF's Back-Cover Text is: + + You have freedom to copy and modify this GNU Manual, like GNU + software. Copies published by the Free Software Foundation raise + funds for GNU development.--> +<meta http-equiv="Content-Style-Type" content="text/css"> +<style type="text/css"><!-- + pre.display { font-family:inherit } + pre.format { font-family:inherit } + pre.smalldisplay { font-family:inherit; font-size:smaller } + pre.smallformat { font-family:inherit; font-size:smaller } + pre.smallexample { font-size:smaller } + pre.smalllisp { font-size:smaller } + span.sc { font-variant:small-caps } + span.roman { font-family:serif; font-weight:normal; } + span.sansserif { font-family:sans-serif; font-weight:normal; } +--></style> +</head> +<body> +<h1 class="settitle">Prerequisites for GCC</h1> +<a name="index-Prerequisites-1"></a> +GCC requires that various tools and packages be available for use in the +build procedure. Modifying GCC sources requires additional tools +described below. + +<h3 class="heading"><a name="TOC0"></a>Tools/packages necessary for building GCC</h3> + + <dl> +<dt>ISO C90 compiler<dd>Necessary to bootstrap GCC, although versions of GCC prior +to 3.4 also allow bootstrapping with a traditional (K&R) C compiler. + + <p>To build all languages in a cross-compiler or other configuration where +3-stage bootstrap is not performed, you need to start with an existing +GCC binary (version 2.95 or later) because source code for language +frontends other than C might use GCC extensions. + + <br><dt>GNAT<dd> +In order to build the Ada compiler (GNAT) you must already have GNAT +installed because portions of the Ada frontend are written in Ada (with +GNAT extensions.) Refer to the Ada installation instructions for more +specific information. + + <br><dt>A “working” POSIX compatible shell, or GNU bash<dd> +Necessary when running <samp><span class="command">configure</span></samp> because some +<samp><span class="command">/bin/sh</span></samp> shells have bugs and may crash when configuring the +target libraries. In other cases, <samp><span class="command">/bin/sh</span></samp> or <samp><span class="command">ksh</span></samp> +have disastrous corner-case performance problems. This +can cause target <samp><span class="command">configure</span></samp> runs to literally take days to +complete in some cases. + + <p>So on some platforms <samp><span class="command">/bin/ksh</span></samp> is sufficient, on others it +isn't. See the host/target specific instructions for your platform, or +use <samp><span class="command">bash</span></samp> to be sure. Then set <samp><span class="env">CONFIG_SHELL</span></samp> in your +environment to your “good” shell prior to running +<samp><span class="command">configure</span></samp>/<samp><span class="command">make</span></samp>. + + <p><samp><span class="command">zsh</span></samp> is not a fully compliant POSIX shell and will not +work when configuring GCC. + + <br><dt>GNU binutils<dd> +Necessary in some circumstances, optional in others. See the +host/target specific instructions for your platform for the exact +requirements. + + <br><dt>gzip version 1.2.4 (or later) or<dt>bzip2 version 1.0.2 (or later)<dd> +Necessary to uncompress GCC <samp><span class="command">tar</span></samp> files when source code is +obtained via FTP mirror sites. + + <br><dt>GNU make version 3.79.1 (or later)<dd> +You must have GNU make installed to build GCC. + + <br><dt>GNU tar version 1.14 (or later)<dd> +Necessary (only on some platforms) to untar the source code. Many +systems' <samp><span class="command">tar</span></samp> programs will also work, only try GNU +<samp><span class="command">tar</span></samp> if you have problems. + + <br><dt>GNU Multiple Precision Library (GMP) version 4.1 (or later)<dd> +Necessary to build GCC. If you do not have it installed in your +library search path, you will have to configure with the +<samp><span class="option">--with-gmp</span></samp> configure option. See also +<samp><span class="option">--with-gmp-lib</span></samp> and <samp><span class="option">--with-gmp-include</span></samp>. + + <br><dt>MPFR Library version 2.3.0 (or later)<dd> +Necessary to build GCC. It can be downloaded from +<a href="http://www.mpfr.org/">http://www.mpfr.org/</a>. The version of MPFR that is bundled with +GMP 4.1.x contains numerous bugs. Although GCC may appear to function +with the buggy versions of MPFR, there are a few bugs that will not be +fixed when using this version. It is strongly recommended to upgrade +to the recommended version of MPFR. + + <p>The <samp><span class="option">--with-mpfr</span></samp> configure option should be used if your MPFR +Library is not installed in your default library search path. See +also <samp><span class="option">--with-mpfr-lib</span></samp> and <samp><span class="option">--with-mpfr-include</span></samp>. + + <br><dt><samp><span class="command">jar</span></samp>, or InfoZIP (<samp><span class="command">zip</span></samp> and <samp><span class="command">unzip</span></samp>)<dd> +Necessary to build libgcj, the GCJ runtime. + +</dl> + +<h3 class="heading"><a name="TOC1"></a>Tools/packages necessary for modifying GCC</h3> + + <dl> +<dt>autoconf version 2.59<dt>GNU m4 version 1.4 (or later)<dd> +Necessary when modifying <samp><span class="file">configure.ac</span></samp>, <samp><span class="file">aclocal.m4</span></samp>, etc. +to regenerate <samp><span class="file">configure</span></samp> and <samp><span class="file">config.in</span></samp> files. + + <br><dt>automake version 1.9.6<dd> +Necessary when modifying a <samp><span class="file">Makefile.am</span></samp> file to regenerate its +associated <samp><span class="file">Makefile.in</span></samp>. + + <p>Much of GCC does not use automake, so directly edit the <samp><span class="file">Makefile.in</span></samp> +file. Specifically this applies to the <samp><span class="file">gcc</span></samp>, <samp><span class="file">intl</span></samp>, +<samp><span class="file">libcpp</span></samp>, <samp><span class="file">libiberty</span></samp>, <samp><span class="file">libobjc</span></samp> directories as well +as any of their subdirectories. + + <p>For directories that use automake, GCC requires the latest release in +the 1.9.x series, which is currently 1.9.6. When regenerating a directory +to a newer version, please update all the directories using an older 1.9.x +to the latest released version. + + <br><dt>gettext version 0.14.5 (or later)<dd> +Needed to regenerate <samp><span class="file">gcc.pot</span></samp>. + + <br><dt>gperf version 2.7.2 (or later)<dd> +Necessary when modifying <samp><span class="command">gperf</span></samp> input files, e.g. +<samp><span class="file">gcc/cp/cfns.gperf</span></samp> to regenerate its associated header file, e.g. +<samp><span class="file">gcc/cp/cfns.h</span></samp>. + + <br><dt>DejaGnu 1.4.4<dt>Expect<dt>Tcl<dd> +Necessary to run the GCC testsuite; see the section on testing for details. + + <br><dt>autogen version 5.5.4 (or later) and<dt>guile version 1.4.1 (or later)<dd> +Necessary to regenerate <samp><span class="file">fixinc/fixincl.x</span></samp> from +<samp><span class="file">fixinc/inclhack.def</span></samp> and <samp><span class="file">fixinc/*.tpl</span></samp>. + + <p>Necessary to run ‘<samp><span class="samp">make check</span></samp>’ for <samp><span class="file">fixinc</span></samp>. + + <p>Necessary to regenerate the top level <samp><span class="file">Makefile.in</span></samp> file from +<samp><span class="file">Makefile.tpl</span></samp> and <samp><span class="file">Makefile.def</span></samp>. + + <br><dt>GNU Bison version 1.28 (or later)<dd> +Necessary when modifying <samp><span class="file">*.y</span></samp> files. Necessary to build the +<code>treelang</code> front end (which is not enabled by default) from a +checkout of the SVN repository; the generated files are not in the +repository. They are included in releases. + + <p>Berkeley <samp><span class="command">yacc</span></samp> (<samp><span class="command">byacc</span></samp>) has been reported to work +as well. + + <br><dt>Flex version 2.5.4 (or later)<dd> +Necessary when modifying <samp><span class="file">*.l</span></samp> files. + + <p>Necessary to build GCC during development because the generated output +files are not included in the SVN repository. They are included in +releases. + + <br><dt>Texinfo version 4.4 (or later)<dd> +Necessary for running <samp><span class="command">makeinfo</span></samp> when modifying <samp><span class="file">*.texi</span></samp> +files to test your changes. + + <p>Necessary for running <samp><span class="command">make dvi</span></samp> or <samp><span class="command">make pdf</span></samp> to +create printable documentation in DVI or PDF format. Texinfo version +4.8 or later is required for <samp><span class="command">make pdf</span></samp>. + + <p>Necessary to build GCC documentation during development because the +generated output files are not included in the SVN repository. They are +included in releases. + + <br><dt>TeX (any working version)<dd> +Necessary for running <samp><span class="command">texi2dvi</span></samp> and <samp><span class="command">texi2pdf</span></samp>, which +are used when running <samp><span class="command">make dvi</span></samp> or <samp><span class="command">make pdf</span></samp> to create +DVI or PDF files, respectively. + + <br><dt>SVN (any version)<dt>SSH (any version)<dd> +Necessary to access the SVN repository. Public releases and weekly +snapshots of the development sources are also available via FTP. + + <br><dt>Perl version 5.6.1 (or later)<dd> +Necessary when regenerating <samp><span class="file">Makefile</span></samp> dependencies in libiberty. +Necessary when regenerating <samp><span class="file">libiberty/functions.texi</span></samp>. +Necessary when generating manpages from Texinfo manuals. +Necessary when targetting Darwin, building libstdc++, +and not using <samp><span class="option">--disable-symvers</span></samp>. +Used by various scripts to generate some files included in SVN (mainly +Unicode-related and rarely changing) from source tables. + + <br><dt>GNU diffutils version 2.7 (or later)<dd> +Useful when submitting patches for the GCC source code. + + <br><dt>patch version 2.5.4 (or later)<dd> +Necessary when applying patches, created with <samp><span class="command">diff</span></samp>, to one's +own sources. + + <br><dt>ecj1<dt>gjavah<dd> +If you wish to modify <samp><span class="file">.java</span></samp> files in libjava, you will need to +configure with <samp><span class="option">--enable-java-maintainer-mode</span></samp>, and you will need +to have executables named <samp><span class="command">ecj1</span></samp> and <samp><span class="command">gjavah</span></samp> in your path. +The <samp><span class="command">ecj1</span></samp> executable should run the Eclipse Java compiler via +the GCC-specific entry point. You can download a suitable jar from +<a href="ftp://sourceware.org/pub/java/">ftp://sourceware.org/pub/java/</a>, or by running the script +<samp><span class="command">contrib/download_ecj</span></samp>. + +</dl> + + <p><hr /> +<p><a href="./index.html">Return to the GCC Installation page</a> + +<!-- ***Downloading the source************************************************** --> +<!-- ***Configuration*********************************************************** --> +<!-- ***Building**************************************************************** --> +<!-- ***Testing***************************************************************** --> +<!-- ***Final install*********************************************************** --> +<!-- ***Binaries**************************************************************** --> +<!-- ***Specific**************************************************************** --> +<!-- ***Old documentation****************************************************** --> +<!-- ***GFDL******************************************************************** --> +<!-- *************************************************************************** --> +<!-- Part 6 The End of the Document --> +</body></html> + diff --git a/gcc-4.3.1/INSTALL/specific.html b/gcc-4.3.1/INSTALL/specific.html new file mode 100644 index 000000000..38511241b --- /dev/null +++ b/gcc-4.3.1/INSTALL/specific.html @@ -0,0 +1,1717 @@ +<html lang="en"> +<head> +<title>Host/Target specific installation notes for GCC</title> +<meta http-equiv="Content-Type" content="text/html"> +<meta name="description" content="Host/Target specific installation notes for GCC"> +<meta name="generator" content="makeinfo 4.11"> +<link title="Top" rel="top" href="#Top"> +<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage"> +<!-- +Copyright (C) 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998, +1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc. + + Permission is granted to copy, distribute and/or modify this document +under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no +Invariant Sections, the Front-Cover texts being (a) (see below), and +with the Back-Cover Texts being (b) (see below). A copy of the +license is included in the section entitled "GNU Free Documentation License". + +(a) The FSF's Front-Cover Text is: + + A GNU Manual + +(b) The FSF's Back-Cover Text is: + + You have freedom to copy and modify this GNU Manual, like GNU + software. Copies published by the Free Software Foundation raise + funds for GNU development.--> +<meta http-equiv="Content-Style-Type" content="text/css"> +<style type="text/css"><!-- + pre.display { font-family:inherit } + pre.format { font-family:inherit } + pre.smalldisplay { font-family:inherit; font-size:smaller } + pre.smallformat { font-family:inherit; font-size:smaller } + pre.smallexample { font-size:smaller } + pre.smalllisp { font-size:smaller } + span.sc { font-variant:small-caps } + span.roman { font-family:serif; font-weight:normal; } + span.sansserif { font-family:sans-serif; font-weight:normal; } +--></style> +</head> +<body> +<h1 class="settitle">Host/Target specific installation notes for GCC</h1> +<a name="index-Specific-1"></a><a name="index-Specific-installation-notes-2"></a><a name="index-Target-specific-installation-3"></a><a name="index-Host-specific-installation-4"></a><a name="index-Target-specific-installation-notes-5"></a> +Please read this document carefully <em>before</em> installing the +GNU Compiler Collection on your machine. + + <p>Note that this list of install notes is <em>not</em> a list of supported +hosts or targets. Not all supported hosts and targets are listed +here, only the ones that require host-specific or target-specific +information are. + + <ul> +<li><a href="#alpha-x-x">alpha*-*-*</a> +<li><a href="#alpha-dec-osf">alpha*-dec-osf*</a> +<li><a href="#alphaev5-cray-unicosmk">alphaev5-cray-unicosmk*</a> +<li><a href="#arc-x-elf">arc-*-elf</a> +<li><a href="#arm-x-elf">arm-*-elf</a> +<a href="#arm-x-coff">arm-*-coff</a> +<a href="#arm-x-aout">arm-*-aout</a> +<li><a href="#xscale-x-x">xscale-*-*</a> +<li><a href="#avr">avr</a> +<li><a href="#bfin">Blackfin</a> +<li><a href="#dos">DOS</a> +<li><a href="#x-x-freebsd">*-*-freebsd*</a> +<li><a href="#h8300-hms">h8300-hms</a> +<li><a href="#hppa-hp-hpux">hppa*-hp-hpux*</a> +<li><a href="#hppa-hp-hpux10">hppa*-hp-hpux10</a> +<li><a href="#hppa-hp-hpux11">hppa*-hp-hpux11</a> +<li><a href="#x-x-linux-gnu">*-*-linux-gnu</a> +<li><a href="#ix86-x-linuxaout">i?86-*-linux*aout</a> +<li><a href="#ix86-x-linux">i?86-*-linux*</a> +<li><a href="#ix86-x-sco32v5">i?86-*-sco3.2v5*</a> +<li><a href="#ix86-x-solaris210">i?86-*-solaris2.10</a> +<li><a href="#ix86-x-udk">i?86-*-udk</a> +<li><a href="#ia64-x-linux">ia64-*-linux</a> +<li><a href="#ia64-x-hpux">ia64-*-hpux*</a> +<li><a href="#x-ibm-aix">*-ibm-aix*</a> +<li><a href="#iq2000-x-elf">iq2000-*-elf</a> +<li><a href="#m32c-x-elf">m32c-*-elf</a> +<li><a href="#m32r-x-elf">m32r-*-elf</a> +<li><a href="#m6811-elf">m6811-elf</a> +<li><a href="#m6812-elf">m6812-elf</a> +<li><a href="#m68k-x-x">m68k-*-*</a> +<li><a href="#m68k-hp-hpux">m68k-hp-hpux</a> +<li><a href="#m68k-uclinux">m68k-uclinux</a> +<li><a href="#mips-x-x">mips-*-*</a> +<li><a href="#mips-sgi-irix5">mips-sgi-irix5</a> +<li><a href="#mips-sgi-irix6">mips-sgi-irix6</a> +<li><a href="#powerpc-x-x">powerpc*-*-*</a> powerpc-*-sysv4 +<li><a href="#powerpc-x-darwin">powerpc-*-darwin*</a> +<li><a href="#powerpc-x-elf">powerpc-*-elf</a> powerpc-*-sysv4 +<li><a href="#powerpc-x-linux-gnu">powerpc*-*-linux-gnu*</a> +<li><a href="#powerpc-x-netbsd">powerpc-*-netbsd*</a> +<li><a href="#powerpc-x-eabisim">powerpc-*-eabisim</a> +<li><a href="#powerpc-x-eabi">powerpc-*-eabi</a> +<li><a href="#powerpcle-x-elf">powerpcle-*-elf</a> powerpcle-*-sysv4 +<li><a href="#powerpcle-x-eabisim">powerpcle-*-eabisim</a> +<li><a href="#powerpcle-x-eabi">powerpcle-*-eabi</a> +<li><a href="#s390-x-linux">s390-*-linux*</a> +<li><a href="#s390x-x-linux">s390x-*-linux*</a> +<li><a href="#s390x-ibm-tpf">s390x-ibm-tpf*</a> +<li><a href="#x-x-solaris2">*-*-solaris2*</a> +<li><a href="#sparc-sun-solaris2">sparc-sun-solaris2*</a> +<li><a href="#sparc-sun-solaris27">sparc-sun-solaris2.7</a> +<li><a href="#sparc-x-linux">sparc-*-linux*</a> +<li><a href="#sparc64-x-solaris2">sparc64-*-solaris2*</a> +<li><a href="#sparcv9-x-solaris2">sparcv9-*-solaris2*</a> +<li><a href="#x-x-sysv">*-*-sysv*</a> +<li><a href="#vax-dec-ultrix">vax-dec-ultrix</a> +<li><a href="#x-x-vxworks">*-*-vxworks*</a> +<li><a href="#x86-64-x-x">x86_64-*-*</a> amd64-*-* +<li><a href="#xtensa-x-elf">xtensa-*-elf</a> +<li><a href="#xtensa-x-linux">xtensa-*-linux*</a> +<li><a href="#windows">Microsoft Windows</a> +<li><a href="#os2">OS/2</a> +<li><a href="#older">Older systems</a> +</ul> + + <ul> +<li><a href="#elf">all ELF targets</a> (SVR4, Solaris 2, etc.) +</ul> + + <p><!-- -------- host/target specific issues start here ---------------- --> +<hr /> + +<h3 class="heading"><a name="TOC0"></a><a name="alpha_002dx_002dx"></a>alpha*-*-*</h3> + +<p>This section contains general configuration information for all +alpha-based platforms using ELF (in particular, ignore this section for +DEC OSF/1, Digital UNIX and Tru64 UNIX). In addition to reading this +section, please read all other sections that match your target. + + <p>We require binutils 2.11.2 or newer. +Previous binutils releases had a number of problems with DWARF 2 +debugging information, not the least of which is incorrect linking of +shared libraries. + + <p><hr /> + +<h3 class="heading"><a name="TOC1"></a><a name="alpha_002ddec_002dosf"></a>alpha*-dec-osf*</h3> + +<p>Systems using processors that implement the DEC Alpha architecture and +are running the DEC/Compaq Unix (DEC OSF/1, Digital UNIX, or Compaq +Tru64 UNIX) operating system, for example the DEC Alpha AXP systems. + + <p>As of GCC 3.2, versions before <code>alpha*-dec-osf4</code> are no longer +supported. (These are the versions which identify themselves as DEC +OSF/1.) + + <p>In Digital Unix V4.0, virtual memory exhausted bootstrap failures +may be fixed by configuring with <samp><span class="option">--with-gc=simple</span></samp>, +reconfiguring Kernel Virtual Memory and Swap parameters +per the <samp><span class="command">/usr/sbin/sys_check</span></samp> Tuning Suggestions, +or applying the patch in +<a href="http://gcc.gnu.org/ml/gcc/2002-08/msg00822.html">http://gcc.gnu.org/ml/gcc/2002-08/msg00822.html</a>. + + <p>In Tru64 UNIX V5.1, Compaq introduced a new assembler that does not +currently (2001-06-13) work with <samp><span class="command">mips-tfile</span></samp>. As a workaround, +we need to use the old assembler, invoked via the barely documented +<samp><span class="option">-oldas</span></samp> option. To bootstrap GCC, you either need to use the +Compaq C Compiler: + +<pre class="smallexample"> % CC=cc <var>srcdir</var>/configure [<var>options</var>] [<var>target</var>] +</pre> + <p>or you can use a copy of GCC 2.95.3 or higher built on Tru64 UNIX V4.0: + +<pre class="smallexample"> % CC=gcc -Wa,-oldas <var>srcdir</var>/configure [<var>options</var>] [<var>target</var>] +</pre> + <p>As of GNU binutils 2.11.2, neither GNU <samp><span class="command">as</span></samp> nor GNU <samp><span class="command">ld</span></samp> +are supported on Tru64 UNIX, so you must not configure GCC with +<samp><span class="option">--with-gnu-as</span></samp> or <samp><span class="option">--with-gnu-ld</span></samp>. + + <p>GCC writes a ‘<samp><span class="samp">.verstamp</span></samp>’ directive to the assembler output file +unless it is built as a cross-compiler. It gets the version to use from +the system header file <samp><span class="file">/usr/include/stamp.h</span></samp>. If you install a +new version of DEC Unix, you should rebuild GCC to pick up the new version +stamp. + + <p>Note that since the Alpha is a 64-bit architecture, cross-compilers from +32-bit machines will not generate code as efficient as that generated +when the compiler is running on a 64-bit machine because many +optimizations that depend on being able to represent a word on the +target in an integral value on the host cannot be performed. Building +cross-compilers on the Alpha for 32-bit machines has only been tested in +a few cases and may not work properly. + + <p>‘<samp><span class="samp">make compare</span></samp>’ may fail on old versions of DEC Unix unless you add +<samp><span class="option">-save-temps</span></samp> to <code>CFLAGS</code>. On these systems, the name of the +assembler input file is stored in the object file, and that makes +comparison fail if it differs between the <code>stage1</code> and +<code>stage2</code> compilations. The option <samp><span class="option">-save-temps</span></samp> forces a +fixed name to be used for the assembler input file, instead of a +randomly chosen name in <samp><span class="file">/tmp</span></samp>. Do not add <samp><span class="option">-save-temps</span></samp> +unless the comparisons fail without that option. If you add +<samp><span class="option">-save-temps</span></samp>, you will have to manually delete the ‘<samp><span class="samp">.i</span></samp>’ and +‘<samp><span class="samp">.s</span></samp>’ files after each series of compilations. + + <p>GCC now supports both the native (ECOFF) debugging format used by DBX +and GDB and an encapsulated STABS format for use only with GDB. See the +discussion of the <samp><span class="option">--with-stabs</span></samp> option of <samp><span class="file">configure</span></samp> above +for more information on these formats and how to select them. + + <p>There is a bug in DEC's assembler that produces incorrect line numbers +for ECOFF format when the ‘<samp><span class="samp">.align</span></samp>’ directive is used. To work +around this problem, GCC will not emit such alignment directives +while writing ECOFF format debugging information even if optimization is +being performed. Unfortunately, this has the very undesirable +side-effect that code addresses when <samp><span class="option">-O</span></samp> is specified are +different depending on whether or not <samp><span class="option">-g</span></samp> is also specified. + + <p>To avoid this behavior, specify <samp><span class="option">-gstabs+</span></samp> and use GDB instead of +DBX. DEC is now aware of this problem with the assembler and hopes to +provide a fix shortly. + + <p><hr /> + +<h3 class="heading"><a name="TOC2"></a><a name="alphaev5_002dcray_002dunicosmk"></a>alphaev5-cray-unicosmk*</h3> + +<p>Cray T3E systems running Unicos/Mk. + + <p>This port is incomplete and has many known bugs. We hope to improve the +support for this target soon. Currently, only the C front end is supported, +and it is not possible to build parallel applications. Cray modules are not +supported; in particular, Craylibs are assumed to be in +<samp><span class="file">/opt/ctl/craylibs/craylibs</span></samp>. + + <p>On this platform, you need to tell GCC where to find the assembler and +the linker. The simplest way to do so is by providing <samp><span class="option">--with-as</span></samp> +and <samp><span class="option">--with-ld</span></samp> to <samp><span class="file">configure</span></samp>, e.g. + +<pre class="smallexample"> configure --with-as=/opt/ctl/bin/cam --with-ld=/opt/ctl/bin/cld \ + --enable-languages=c +</pre> + <p>The comparison test at the end of the bootstrapping process fails on Unicos/Mk +because the assembler inserts timestamps into object files. You should +be able to work around this by doing ‘<samp><span class="samp">make all</span></samp>’ after getting this +failure. + + <p><hr /> + +<h3 class="heading"><a name="TOC3"></a><a name="arc_002dx_002delf"></a>arc-*-elf</h3> + +<p>Argonaut ARC processor. +This configuration is intended for embedded systems. + + <p><hr /> + +<h3 class="heading"><a name="TOC4"></a><a name="arm_002dx_002delf"></a>arm-*-elf</h3> + +<h3 class="heading"><a name="TOC5"></a><a name="xscale_002dx_002dx"></a>xscale-*-*</h3> + +<p>ARM-family processors. Subtargets that use the ELF object format +require GNU binutils 2.13 or newer. Such subtargets include: +<code>arm-*-freebsd</code>, <code>arm-*-netbsdelf</code>, <code>arm-*-*linux</code>, +<code>arm-*-rtems</code> and <code>arm-*-kaos</code>. + + <p><hr /> + +<h3 class="heading"><a name="TOC6"></a><a name="arm_002dx_002dcoff"></a>arm-*-coff</h3> + +<p>ARM-family processors. Note that there are two different varieties +of PE format subtarget supported: <code>arm-wince-pe</code> and +<code>arm-pe</code> as well as a standard COFF target <code>arm-*-coff</code>. + + <p><hr /> + +<h3 class="heading"><a name="TOC7"></a><a name="arm_002dx_002daout"></a>arm-*-aout</h3> + +<p>ARM-family processors. These targets support the AOUT file format: +<code>arm-*-aout</code>, <code>arm-*-netbsd</code>. + + <p><hr /> + +<h3 class="heading"><a name="TOC8"></a><a name="avr"></a>avr</h3> + +<p>ATMEL AVR-family micro controllers. These are used in embedded +applications. There are no standard Unix configurations. +See “AVR Options” in the main manual +for the list of supported MCU types. + + <p>Use ‘<samp><span class="samp">configure --target=avr --enable-languages="c"</span></samp>’ to configure GCC. + + <p>Further installation notes and other useful information about AVR tools +can also be obtained from: + + <ul> +<li><a href="http://www.nongnu.org/avr/">http://www.nongnu.org/avr/</a> +<li><a href="http://home.overta.ru/users/denisc/">http://home.overta.ru/users/denisc/</a> +<li><a href="http://www.amelek.gda.pl/avr/">http://www.amelek.gda.pl/avr/</a> +</ul> + + <p>We <em>strongly</em> recommend using binutils 2.13 or newer. + + <p>The following error: +<pre class="smallexample"> Error: register required +</pre> + <p>indicates that you should upgrade to a newer version of the binutils. + + <p><hr /> + +<h3 class="heading"><a name="TOC9"></a><a name="bfin"></a>Blackfin</h3> + +<p>The Blackfin processor, an Analog Devices DSP. +See “Blackfin Options” in the main manual + + <p>More information, and a version of binutils with support for this processor, +is available at <a href="http://blackfin.uclinux.org">http://blackfin.uclinux.org</a> + + <p><hr /> + +<h3 class="heading"><a name="TOC10"></a><a name="cris"></a>CRIS</h3> + +<p>CRIS is the CPU architecture in Axis Communications ETRAX system-on-a-chip +series. These are used in embedded applications. + + <p>See “CRIS Options” in the main manual +for a list of CRIS-specific options. + + <p>There are a few different CRIS targets: + <dl> +<dt><code>cris-axis-aout</code><dd>Old target. Includes a multilib for the ‘<samp><span class="samp">elinux</span></samp>’ a.out-based +target. No multilibs for newer architecture variants. +<br><dt><code>cris-axis-elf</code><dd>Mainly for monolithic embedded systems. Includes a multilib for the +‘<samp><span class="samp">v10</span></samp>’ core used in ‘<samp><span class="samp">ETRAX 100 LX</span></samp>’. +<br><dt><code>cris-axis-linux-gnu</code><dd>A GNU/Linux port for the CRIS architecture, currently targeting +‘<samp><span class="samp">ETRAX 100 LX</span></samp>’ by default. +</dl> + + <p>For <code>cris-axis-aout</code> and <code>cris-axis-elf</code> you need binutils 2.11 +or newer. For <code>cris-axis-linux-gnu</code> you need binutils 2.12 or newer. + + <p>Pre-packaged tools can be obtained from +<a href="ftp://ftp.axis.com/pub/axis/tools/cris/compiler-kit/">ftp://ftp.axis.com/pub/axis/tools/cris/compiler-kit/</a>. More +information about this platform is available at +<a href="http://developer.axis.com/">http://developer.axis.com/</a>. + + <p><hr /> + +<h3 class="heading"><a name="TOC11"></a><a name="crx"></a>CRX</h3> + +<p>The CRX CompactRISC architecture is a low-power 32-bit architecture with +fast context switching and architectural extensibility features. + + <p>See “CRX Options” in the main manual for a list of CRX-specific options. + + <p>Use ‘<samp><span class="samp">configure --target=crx-elf --enable-languages=c,c++</span></samp>’ to configure +GCC for building a CRX cross-compiler. The option ‘<samp><span class="samp">--target=crx-elf</span></samp>’ +is also used to build the ‘<samp><span class="samp">newlib</span></samp>’ C library for CRX. + + <p>It is also possible to build libstdc++-v3 for the CRX architecture. This +needs to be done in a separate step with the following configure settings: +‘<samp><span class="samp">gcc/libstdc++-v3/configure --host=crx-elf --with-newlib +--enable-sjlj-exceptions --enable-cxx-flags='-fexceptions -frtti'</span></samp>’ + + <p><hr /> + +<h3 class="heading"><a name="TOC12"></a><a name="dos"></a>DOS</h3> + +<p>Please have a look at the <a href="binaries.html">binaries page</a>. + + <p>You cannot install GCC by itself on MSDOS; it will not compile under +any MSDOS compiler except itself. You need to get the complete +compilation package DJGPP, which includes binaries as well as sources, +and includes all the necessary compilation tools and libraries. + + <p><hr /> + +<h3 class="heading"><a name="TOC13"></a><a name="x_002dx_002dfreebsd"></a>*-*-freebsd*</h3> + +<p>The version of binutils installed in <samp><span class="file">/usr/bin</span></samp> probably works with +this release of GCC. However, on FreeBSD 4, bootstrapping against the +latest FSF binutils is known to improve overall testsuite results; and, +on FreeBSD/alpha, using binutils 2.14 or later is required to build libjava. + + <p>Support for FreeBSD 1 was discontinued in GCC 3.2. + + <p>Support for FreeBSD 2 will be discontinued after GCC 3.4. The +following was true for GCC 3.1 but the current status is unknown. +For FreeBSD 2 or any mutant a.out versions of FreeBSD 3: All +configuration support and files as shipped with GCC 2.95 are still in +place. FreeBSD 2.2.7 has been known to bootstrap completely; however, +it is unknown which version of binutils was used (it is assumed that it +was the system copy in <samp><span class="file">/usr/bin</span></samp>) and C++ EH failures were noted. + + <p>For FreeBSD using the ELF file format: DWARF 2 debugging is now the +default for all CPU architectures. It had been the default on +FreeBSD/alpha since its inception. You may use <samp><span class="option">-gstabs</span></samp> instead +of <samp><span class="option">-g</span></samp>, if you really want the old debugging format. There are +no known issues with mixing object files and libraries with different +debugging formats. Otherwise, this release of GCC should now match more +of the configuration used in the stock FreeBSD configuration of GCC. In +particular, <samp><span class="option">--enable-threads</span></samp> is now configured by default. +However, as a general user, do not attempt to replace the system +compiler with this release. Known to bootstrap and check with good +results on FreeBSD 4.9-STABLE and 5-CURRENT. In the past, known to +bootstrap and check with good results on FreeBSD 3.0, 3.4, 4.0, 4.2, +4.3, 4.4, 4.5, 4.8-STABLE. + + <p>In principle, <samp><span class="option">--enable-threads</span></samp> is now compatible with +<samp><span class="option">--enable-libgcj</span></samp> on FreeBSD. However, it has only been built +and tested on ‘<samp><span class="samp">i386-*-freebsd[45]</span></samp>’ and ‘<samp><span class="samp">alpha-*-freebsd[45]</span></samp>’. +The static +library may be incorrectly built (symbols are missing at link time). +There is a rare timing-based startup hang (probably involves an +assumption about the thread library). Multi-threaded boehm-gc (required for +libjava) exposes severe threaded signal-handling bugs on FreeBSD before +4.5-RELEASE. Other CPU architectures +supported by FreeBSD will require additional configuration tuning in, at +the very least, both boehm-gc and libffi. + + <p>Shared <samp><span class="file">libgcc_s.so</span></samp> is now built and installed by default. + + <p><hr /> + +<h3 class="heading"><a name="TOC14"></a><a name="h8300_002dhms"></a>h8300-hms</h3> + +<p>Renesas H8/300 series of processors. + + <p>Please have a look at the <a href="binaries.html">binaries page</a>. + + <p>The calling convention and structure layout has changed in release 2.6. +All code must be recompiled. The calling convention now passes the +first three arguments in function calls in registers. Structures are no +longer a multiple of 2 bytes. + + <p><hr /> + +<h3 class="heading"><a name="TOC15"></a><a name="hppa_002dhp_002dhpux"></a>hppa*-hp-hpux*</h3> + +<p>Support for HP-UX version 9 and older was discontinued in GCC 3.4. + + <p>We require using gas/binutils on all hppa platforms; +you may encounter a variety of problems if you try to use the HP assembler. + + <p>Specifically, <samp><span class="option">-g</span></samp> does not work on HP-UX (since that system +uses a peculiar debugging format which GCC does not know about), unless +you use GAS and GDB. It may be helpful to configure GCC with the +<a href="./configure.html#with-gnu-as"><samp><span class="option">--with-gnu-as</span></samp></a> and +<samp><span class="option">--with-as=...</span></samp> options to ensure that GCC can find GAS. + + <p>If you wish to use the pa-risc 2.0 architecture support with a 32-bit +runtime, you must use gas/binutils 2.11 or newer. + + <p>There are two default scheduling models for instructions. These are +PROCESSOR_7100LC and PROCESSOR_8000. They are selected from the pa-risc +architecture specified for the target machine when configuring. +PROCESSOR_8000 is the default. PROCESSOR_7100LC is selected when +the target is a ‘<samp><span class="samp">hppa1*</span></samp>’ machine. + + <p>The PROCESSOR_8000 model is not well suited to older processors. Thus, +it is important to completely specify the machine architecture when +configuring if you want a model other than PROCESSOR_8000. The macro +TARGET_SCHED_DEFAULT can be defined in BOOT_CFLAGS if a different +default scheduling model is desired. + + <p>As of GCC 4.0, GCC uses the UNIX 95 namespace for HP-UX 10.10 +through 11.00, and the UNIX 98 namespace for HP-UX 11.11 and later. +This namespace change might cause problems when bootstrapping with +an earlier version of GCC or the HP compiler as essentially the same +namespace is required for an entire build. This problem can be avoided +in a number of ways. With HP cc, <samp><span class="env">UNIX_STD</span></samp> can be set to ‘<samp><span class="samp">95</span></samp>’ +or ‘<samp><span class="samp">98</span></samp>’. Another way is to add an appropriate set of predefines +to <samp><span class="env">CC</span></samp>. The description for the <samp><span class="option">munix=</span></samp> option contains +a list of the predefines used with each standard. + + <p>As of GCC 4.1, <samp><span class="env">DWARF2</span></samp> exception handling is available on HP-UX. +It is now the default. This exposed a bug in the handling of data +relocations in the GAS assembler. The handling of 64-bit data relocations +was seriously broken, affecting debugging and exception support on all +‘<samp><span class="samp">hppa64-*-*</span></samp>’ targets. Under some circumstances, 32-bit data relocations +could also be handled incorrectly. This problem is fixed in GAS version +2.16.91 20051125. + + <p>GCC versions prior to 4.1 incorrectly passed and returned complex +values. They are now passed in the same manner as aggregates. + + <p>More specific information to ‘<samp><span class="samp">hppa*-hp-hpux*</span></samp>’ targets follows. + + <p><hr /> + +<h3 class="heading"><a name="TOC16"></a><a name="hppa_002dhp_002dhpux10"></a>hppa*-hp-hpux10</h3> + +<p>For hpux10.20, we <em>highly</em> recommend you pick up the latest sed patch +<code>PHCO_19798</code> from HP. HP has two sites which provide patches free of +charge: + + <ul> +<li><a href="http://us.itrc.hp.com/service/home/home.do">US, Canada, Asia-Pacific, and +Latin-America</a><li><a href="http://europe.itrc.hp.com/service/home/home.do">http://europe.itrc.hp.com/service/home/home.do</a> Europe. +</ul> + + <p>The HP assembler on these systems has some problems. Most notably the +assembler inserts timestamps into each object file it creates, causing +the 3-stage comparison test to fail during a bootstrap. +You should be able to continue by saying ‘<samp><span class="samp">make all-host all-target</span></samp>’ +after getting the failure from ‘<samp><span class="samp">make</span></samp>’. + + <p>GCC 4.0 requires CVS binutils as of April 28, 2004 or later. Earlier +versions require binutils 2.8 or later. + + <p>The C++ ABI has changed incompatibly in GCC 4.0. COMDAT subspaces are +used for one-only code and data. This resolves many of the previous +problems in using C++ on this target. However, the ABI is not compatible +with the one implemented under HP-UX 11 using secondary definitions. + + <p><hr /> + +<h3 class="heading"><a name="TOC17"></a><a name="hppa_002dhp_002dhpux11"></a>hppa*-hp-hpux11</h3> + +<p>GCC 3.0 and up support HP-UX 11. GCC 2.95.x is not supported and cannot +be used to compile GCC 3.0 and up. + + <p>Refer to <a href="binaries.html">binaries</a> for information about obtaining +precompiled GCC binaries for HP-UX. Precompiled binaries must be obtained +to build the Ada language as it can't be bootstrapped using C. Ada is +only available for the 32-bit PA-RISC runtime. The libffi and libjava +haven't been ported to HP-UX and don't build. + + <p>Starting with GCC 3.4 an ISO C compiler is required to bootstrap. The +bundled compiler supports only traditional C; you will need either HP's +unbundled compiler, or a binary distribution of GCC. + + <p>It is possible to build GCC 3.3 starting with the bundled HP compiler, +but the process requires several steps. GCC 3.3 can then be used to +build later versions. The fastjar program contains ISO C code and +can't be built with the HP bundled compiler. This problem can be +avoided by not building the Java language. For example, use the +<samp><span class="option">--enable-languages="c,c++,f77,objc"</span></samp> option in your configure +command. + + <p>There are several possible approaches to building the distribution. +Binutils can be built first using the HP tools. Then, the GCC +distribution can be built. The second approach is to build GCC +first using the HP tools, then build binutils, then rebuild GCC. +There have been problems with various binary distributions, so it +is best not to start from a binary distribution. + + <p>On 64-bit capable systems, there are two distinct targets. Different +installation prefixes must be used if both are to be installed on +the same system. The ‘<samp><span class="samp">hppa[1-2]*-hp-hpux11*</span></samp>’ target generates code +for the 32-bit PA-RISC runtime architecture and uses the HP linker. +The ‘<samp><span class="samp">hppa64-hp-hpux11*</span></samp>’ target generates 64-bit code for the +PA-RISC 2.0 architecture. The HP and GNU linkers are both supported +for this target. + + <p>The script config.guess now selects the target type based on the compiler +detected during configuration. You must define <samp><span class="env">PATH</span></samp> or <samp><span class="env">CC</span></samp> so +that configure finds an appropriate compiler for the initial bootstrap. +When <samp><span class="env">CC</span></samp> is used, the definition should contain the options that are +needed whenever <samp><span class="env">CC</span></samp> is used. + + <p>Specifically, options that determine the runtime architecture must be +in <samp><span class="env">CC</span></samp> to correctly select the target for the build. It is also +convenient to place many other compiler options in <samp><span class="env">CC</span></samp>. For example, +<samp><span class="env">CC="cc -Ac +DA2.0W -Wp,-H16376 -D_CLASSIC_TYPES -D_HPUX_SOURCE"</span></samp> +can be used to bootstrap the GCC 3.3 branch with the HP compiler in +64-bit K&R/bundled mode. The <samp><span class="option">+DA2.0W</span></samp> option will result in +the automatic selection of the ‘<samp><span class="samp">hppa64-hp-hpux11*</span></samp>’ target. The +macro definition table of cpp needs to be increased for a successful +build with the HP compiler. _CLASSIC_TYPES and _HPUX_SOURCE need to +be defined when building with the bundled compiler, or when using the +<samp><span class="option">-Ac</span></samp> option. These defines aren't necessary with <samp><span class="option">-Ae</span></samp>. + + <p>It is best to explicitly configure the ‘<samp><span class="samp">hppa64-hp-hpux11*</span></samp>’ target +with the <samp><span class="option">--with-ld=...</span></samp> option. This overrides the standard +search for ld. The two linkers supported on this target require different +commands. The default linker is determined during configuration. As a +result, it's not possible to switch linkers in the middle of a GCC build. +This has been been reported to sometimes occur in unified builds of +binutils and GCC. + + <p>GCC 3.0 through 3.2 require binutils 2.11 or above. GCC 3.3 through +GCC 4.0 require binutils 2.14 or later. + + <p>Although the HP assembler can be used for an initial build, it shouldn't +be used with any languages other than C and perhaps Fortran due to its +many limitations. For example, it does not support weak symbols or alias +definitions. As a result, explicit template instantiations are required +when using C++. This makes it difficult if not impossible to build many +C++ applications. You can't generate debugging information when using +the HP assembler. Finally, bootstrapping fails in the final +comparison of object modules due to the time stamps that it inserts into +the modules. The bootstrap can be continued from this point with +‘<samp><span class="samp">make all-host all-target</span></samp>’. + + <p>A recent linker patch must be installed for the correct operation of +GCC 3.3 and later. <code>PHSS_26559</code> and <code>PHSS_24304</code> are the +oldest linker patches that are known to work. They are for HP-UX +11.00 and 11.11, respectively. <code>PHSS_24303</code>, the companion to +<code>PHSS_24304</code>, might be usable but it hasn't been tested. These +patches have been superseded. Consult the HP patch database to obtain +the currently recommended linker patch for your system. + + <p>The patches are necessary for the support of weak symbols on the +32-bit port, and for the running of initializers and finalizers. Weak +symbols are implemented using SOM secondary definition symbols. Prior +to HP-UX 11, there are bugs in the linker support for secondary symbols. +The patches correct a problem of linker core dumps creating shared +libraries containing secondary symbols, as well as various other +linking issues involving secondary symbols. + + <p>GCC 3.3 uses the ELF DT_INIT_ARRAY and DT_FINI_ARRAY capabilities to +run initializers and finalizers on the 64-bit port. The 32-bit port +uses the linker <samp><span class="option">+init</span></samp> and <samp><span class="option">+fini</span></samp> options for the same +purpose. The patches correct various problems with the +init/+fini +options, including program core dumps. Binutils 2.14 corrects a +problem on the 64-bit port resulting from HP's non-standard use of +the .init and .fini sections for array initializers and finalizers. + + <p>There are a number of issues to consider in selecting which linker to +use with the 64-bit port. The GNU 64-bit linker can only create dynamic +binaries. The <samp><span class="option">-static</span></samp> option causes linking with archive +libraries but doesn't produce a truly static binary. Dynamic binaries +still require final binding by the dynamic loader to resolve a set of +dynamic-loader-defined symbols. The default behavior of the HP linker +is the same as the GNU linker. However, it can generate true 64-bit +static binaries using the <samp><span class="option">+compat</span></samp> option. + + <p>The HP 64-bit linker doesn't support linkonce semantics. As a +result, C++ programs have many more sections than they should. + + <p>The GNU 64-bit linker has some issues with shared library support +and exceptions. As a result, we only support libgcc in archive +format. For similar reasons, dwarf2 unwind and exception support +are disabled. The GNU linker also has problems creating binaries +with <samp><span class="option">-static</span></samp>. It doesn't provide stubs for internal +calls to global functions in shared libraries, so these calls +can't be overloaded. + + <p>Thread support is not implemented in GCC 3.0 through 3.2, so the +<samp><span class="option">--enable-threads</span></samp> configure option does not work. In 3.3 +and later, POSIX threads are supported. The optional DCE thread +library is not supported. + + <p>This port still is undergoing significant development. + + <p><hr /> + +<h3 class="heading"><a name="TOC18"></a><a name="x_002dx_002dlinux_002dgnu"></a>*-*-linux-gnu</h3> + +<p>Versions of libstdc++-v3 starting with 3.2.1 require bug fixes present +in glibc 2.2.5 and later. More information is available in the +libstdc++-v3 documentation. + + <p><hr /> + +<h3 class="heading"><a name="TOC19"></a><a name="ix86_002dx_002dlinuxaout"></a>i?86-*-linux*aout</h3> + +<p>Use this configuration to generate <samp><span class="file">a.out</span></samp> binaries on Linux-based +GNU systems. This configuration is being superseded. + + <p><hr /> + +<h3 class="heading"><a name="TOC20"></a><a name="ix86_002dx_002dlinux"></a>i?86-*-linux*</h3> + +<p>As of GCC 3.3, binutils 2.13.1 or later is required for this platform. +See <a href="http://gcc.gnu.org/PR10877">bug 10877</a> for more information. + + <p>If you receive Signal 11 errors when building on GNU/Linux, then it is +possible you have a hardware problem. Further information on this can be +found on <a href="http://www.bitwizard.nl/sig11/">www.bitwizard.nl</a>. + + <p><hr /> + +<h3 class="heading"><a name="TOC21"></a><a name="ix86_002dx_002dsco32v5"></a>i?86-*-sco3.2v5*</h3> + +<p>Use this for the SCO OpenServer Release 5 family of operating systems. + + <p>Unlike earlier versions of GCC, the ability to generate COFF with this +target is no longer provided. + + <p>Earlier versions of GCC emitted DWARF 1 when generating ELF to allow +the system debugger to be used. That support was too burdensome to +maintain. GCC now emits only DWARF 2 for this target. This means you +may use either the UDK debugger or GDB to debug programs built by this +version of GCC. + + <p>GCC is now only supported on releases 5.0.4 and later, and requires that +you install Support Level Supplement OSS646B or later, and Support Level +Supplement OSS631C or later. If you are using release 5.0.7 of +OpenServer, you must have at least the first maintenance pack installed +(this includes the relevant portions of OSS646). OSS646, also known as +the “Execution Environment Update”, provides updated link editors and +assemblers, as well as updated standard C and math libraries. The C +startup modules are also updated to support the System V gABI draft, and +GCC relies on that behavior. OSS631 provides a collection of commonly +used open source libraries, some of which GCC depends on (such as GNU +gettext and zlib). SCO OpenServer Release 5.0.7 has all of this built +in by default, but OSS631C and later also apply to that release. Please +visit +<a href="ftp://ftp.sco.com/pub/openserver5">ftp://ftp.sco.com/pub/openserver5</a> +for the latest versions of these (and other potentially useful) +supplements. + + <p>Although there is support for using the native assembler, it is +recommended that you configure GCC to use the GNU assembler. You do +this by using the flags +<a href="./configure.html#with-gnu-as"><samp><span class="option">--with-gnu-as</span></samp></a>. You should +use a modern version of GNU binutils. Version 2.13.2.1 was used for all +testing. In general, only the <samp><span class="option">--with-gnu-as</span></samp> option is tested. +A modern bintuils (as well as a plethora of other development related +GNU utilities) can be found in Support Level Supplement OSS658A, the +“GNU Development Tools” package. See the SCO web and ftp sites for details. +That package also contains the currently “officially supported” version of +GCC, version 2.95.3. It is useful for bootstrapping this version. + + <p><hr /> + +<h3 class="heading"><a name="TOC22"></a><a name="ix86_002dx_002dsolaris210"></a>i?86-*-solaris2.10</h3> + +<p>Use this for Solaris 10 or later on x86 and x86-64 systems. This +configuration is supported by GCC 4.0 and later versions only. + + <p>It is recommended that you configure GCC to use the GNU assembler in +<samp><span class="file">/usr/sfw/bin/gas</span></samp> but the Sun linker, using the options +<samp><span class="option">--with-gnu-as --with-as=/usr/sfw/bin/gas --without-gnu-ld +--with-ld=/usr/ccs/bin/ld</span></samp>. + + <p><hr /> + +<h3 class="heading"><a name="TOC23"></a><a name="ix86_002dx_002dudk"></a>i?86-*-udk</h3> + +<p>This target emulates the SCO Universal Development Kit and requires that +package be installed. (If it is installed, you will have a +<samp><span class="file">/udk/usr/ccs/bin/cc</span></samp> file present.) It's very much like the +‘<samp><span class="samp">i?86-*-unixware7*</span></samp>’ target +but is meant to be used when hosting on a system where UDK isn't the +default compiler such as OpenServer 5 or Unixware 2. This target will +generate binaries that will run on OpenServer, Unixware 2, or Unixware 7, +with the same warnings and caveats as the SCO UDK. + + <p>This target is a little tricky to build because we have to distinguish +it from the native tools (so it gets headers, startups, and libraries +from the right place) while making the tools not think we're actually +building a cross compiler. The easiest way to do this is with a configure +command like this: + +<pre class="smallexample"> CC=/udk/usr/ccs/bin/cc <var>/your/path/to</var>/gcc/configure \ + --host=i686-pc-udk --target=i686-pc-udk --program-prefix=udk- +</pre> + <p><em>You should substitute ‘</em><samp><span class="samp">i686</span></samp><em>’ in the above command with the appropriate +processor for your host.</em> + + <p>After the usual ‘<samp><span class="samp">make</span></samp>’ and +‘<samp><span class="samp">make install</span></samp>’, you can then access the UDK-targeted GCC +tools by adding <samp><span class="command">udk-</span></samp> before the commonly known name. For +example, to invoke the C compiler, you would use <samp><span class="command">udk-gcc</span></samp>. +They will coexist peacefully with any native-target GCC tools you may +have installed. + + <p><hr /> + +<h3 class="heading"><a name="TOC24"></a><a name="ia64_002dx_002dlinux"></a>ia64-*-linux</h3> + +<p>IA-64 processor (also known as IPF, or Itanium Processor Family) +running GNU/Linux. + + <p>If you are using the installed system libunwind library with +<samp><span class="option">--with-system-libunwind</span></samp>, then you must use libunwind 0.98 or +later. + + <p>None of the following versions of GCC has an ABI that is compatible +with any of the other versions in this list, with the exception that +Red Hat 2.96 and Trillian 000171 are compatible with each other: +3.1, 3.0.2, 3.0.1, 3.0, Red Hat 2.96, and Trillian 000717. +This primarily affects C++ programs and programs that create shared libraries. +GCC 3.1 or later is recommended for compiling linux, the kernel. +As of version 3.1 GCC is believed to be fully ABI compliant, and hence no +more major ABI changes are expected. + + <p><hr /> + +<h3 class="heading"><a name="TOC25"></a><a name="ia64_002dx_002dhpux"></a>ia64-*-hpux*</h3> + +<p>Building GCC on this target requires the GNU Assembler. The bundled HP +assembler will not work. To prevent GCC from using the wrong assembler, +the option <samp><span class="option">--with-gnu-as</span></samp> may be necessary. + + <p>The GCC libunwind library has not been ported to HPUX. This means that for +GCC versions 3.2.3 and earlier, <samp><span class="option">--enable-libunwind-exceptions</span></samp> +is required to build GCC. For GCC 3.3 and later, this is the default. +For gcc 3.4.3 and later, <samp><span class="option">--enable-libunwind-exceptions</span></samp> is +removed and the system libunwind library will always be used. + + <p><hr /> +<!-- rs6000-ibm-aix*, powerpc-ibm-aix* --> + +<h3 class="heading"><a name="TOC26"></a><a name="x_002dibm_002daix"></a>*-ibm-aix*</h3> + +<p>Support for AIX version 3 and older was discontinued in GCC 3.4. + + <p>“out of memory” bootstrap failures may indicate a problem with +process resource limits (ulimit). Hard limits are configured in the +<samp><span class="file">/etc/security/limits</span></samp> system configuration file. + + <p>To speed up the configuration phases of bootstrapping and installing GCC, +one may use GNU Bash instead of AIX <samp><span class="command">/bin/sh</span></samp>, e.g., + +<pre class="smallexample"> % CONFIG_SHELL=/opt/freeware/bin/bash + % export CONFIG_SHELL +</pre> + <p>and then proceed as described in <a href="build.html">the build instructions</a>, where we strongly recommend specifying an absolute path +to invoke <var>srcdir</var>/configure. + + <p>Because GCC on AIX is built as a 32-bit executable by default, +(although it can generate 64-bit programs) the GMP and MPFR libraries +required by gfortran must be 32-bit libraries. Building GMP and MPFR +as static archive libraries works better than shared libraries. + + <p>Errors involving <code>alloca</code> when building GCC generally are due +to an incorrect definition of <code>CC</code> in the Makefile or mixing files +compiled with the native C compiler and GCC. During the stage1 phase of +the build, the native AIX compiler <strong>must</strong> be invoked as <samp><span class="command">cc</span></samp> +(not <samp><span class="command">xlc</span></samp>). Once <samp><span class="command">configure</span></samp> has been informed of +<samp><span class="command">xlc</span></samp>, one needs to use ‘<samp><span class="samp">make distclean</span></samp>’ to remove the +configure cache files and ensure that <samp><span class="env">CC</span></samp> environment variable +does not provide a definition that will confuse <samp><span class="command">configure</span></samp>. +If this error occurs during stage2 or later, then the problem most likely +is the version of Make (see above). + + <p>The native <samp><span class="command">as</span></samp> and <samp><span class="command">ld</span></samp> are recommended for bootstrapping +on AIX 4 and required for bootstrapping on AIX 5L. The GNU Assembler +reports that it supports WEAK symbols on AIX 4, which causes GCC to try to +utilize weak symbol functionality although it is not supported. The GNU +Assembler and Linker do not support AIX 5L sufficiently to bootstrap GCC. +The native AIX tools do interoperate with GCC. + + <p>Building <samp><span class="file">libstdc++.a</span></samp> requires a fix for an AIX Assembler bug +APAR IY26685 (AIX 4.3) or APAR IY25528 (AIX 5.1). It also requires a +fix for another AIX Assembler bug and a co-dependent AIX Archiver fix +referenced as APAR IY53606 (AIX 5.2) or a APAR IY54774 (AIX 5.1) + + <p>‘<samp><span class="samp">libstdc++</span></samp>’ in GCC 3.4 increments the major version number of the +shared object and GCC installation places the <samp><span class="file">libstdc++.a</span></samp> +shared library in a common location which will overwrite the and GCC +3.3 version of the shared library. Applications either need to be +re-linked against the new shared library or the GCC 3.1 and GCC 3.3 +versions of the ‘<samp><span class="samp">libstdc++</span></samp>’ shared object needs to be available +to the AIX runtime loader. The GCC 3.1 ‘<samp><span class="samp">libstdc++.so.4</span></samp>’, if +present, and GCC 3.3 ‘<samp><span class="samp">libstdc++.so.5</span></samp>’ shared objects can be +installed for runtime dynamic loading using the following steps to set +the ‘<samp><span class="samp">F_LOADONLY</span></samp>’ flag in the shared object for <em>each</em> +multilib <samp><span class="file">libstdc++.a</span></samp> installed: + + <p>Extract the shared objects from the currently installed +<samp><span class="file">libstdc++.a</span></samp> archive: +<pre class="smallexample"> % ar -x libstdc++.a libstdc++.so.4 libstdc++.so.5 +</pre> + <p>Enable the ‘<samp><span class="samp">F_LOADONLY</span></samp>’ flag so that the shared object will be +available for runtime dynamic loading, but not linking: +<pre class="smallexample"> % strip -e libstdc++.so.4 libstdc++.so.5 +</pre> + <p>Archive the runtime-only shared object in the GCC 3.4 +<samp><span class="file">libstdc++.a</span></samp> archive: +<pre class="smallexample"> % ar -q libstdc++.a libstdc++.so.4 libstdc++.so.5 +</pre> + <p>Linking executables and shared libraries may produce warnings of +duplicate symbols. The assembly files generated by GCC for AIX always +have included multiple symbol definitions for certain global variable +and function declarations in the original program. The warnings should +not prevent the linker from producing a correct library or runnable +executable. + + <p>AIX 4.3 utilizes a “large format” archive to support both 32-bit and +64-bit object modules. The routines provided in AIX 4.3.0 and AIX 4.3.1 +to parse archive libraries did not handle the new format correctly. +These routines are used by GCC and result in error messages during +linking such as “not a COFF file”. The version of the routines shipped +with AIX 4.3.1 should work for a 32-bit environment. The <samp><span class="option">-g</span></samp> +option of the archive command may be used to create archives of 32-bit +objects using the original “small format”. A correct version of the +routines is shipped with AIX 4.3.2 and above. + + <p>Some versions of the AIX binder (linker) can fail with a relocation +overflow severe error when the <samp><span class="option">-bbigtoc</span></samp> option is used to link +GCC-produced object files into an executable that overflows the TOC. A fix +for APAR IX75823 (OVERFLOW DURING LINK WHEN USING GCC AND -BBIGTOC) is +available from IBM Customer Support and from its +<a href="http://techsupport.services.ibm.com/">techsupport.services.ibm.com</a> +website as PTF U455193. + + <p>The AIX 4.3.2.1 linker (bos.rte.bind_cmds Level 4.3.2.1) will dump core +with a segmentation fault when invoked by any version of GCC. A fix for +APAR IX87327 is available from IBM Customer Support and from its +<a href="http://techsupport.services.ibm.com/">techsupport.services.ibm.com</a> +website as PTF U461879. This fix is incorporated in AIX 4.3.3 and above. + + <p>The initial assembler shipped with AIX 4.3.0 generates incorrect object +files. A fix for APAR IX74254 (64BIT DISASSEMBLED OUTPUT FROM COMPILER FAILS +TO ASSEMBLE/BIND) is available from IBM Customer Support and from its +<a href="http://techsupport.services.ibm.com/">techsupport.services.ibm.com</a> +website as PTF U453956. This fix is incorporated in AIX 4.3.1 and above. + + <p>AIX provides National Language Support (NLS). Compilers and assemblers +use NLS to support locale-specific representations of various data +formats including floating-point numbers (e.g., ‘<samp><span class="samp">.</span></samp>’ vs ‘<samp><span class="samp">,</span></samp>’ for +separating decimal fractions). There have been problems reported where +GCC does not produce the same floating-point formats that the assembler +expects. If one encounters this problem, set the <samp><span class="env">LANG</span></samp> +environment variable to ‘<samp><span class="samp">C</span></samp>’ or ‘<samp><span class="samp">En_US</span></samp>’. + + <p>By default, GCC for AIX 4.1 and above produces code that can be used on +both Power or PowerPC processors. + + <p>A default can be specified with the <samp><span class="option">-mcpu=</span><var>cpu_type</var></samp> +switch and using the configure option <samp><span class="option">--with-cpu-</span><var>cpu_type</var></samp>. + + <p><hr /> + +<h3 class="heading"><a name="TOC27"></a><a name="iq2000_002dx_002delf"></a>iq2000-*-elf</h3> + +<p>Vitesse IQ2000 processors. These are used in embedded +applications. There are no standard Unix configurations. + + <p><hr /> + +<h3 class="heading"><a name="TOC28"></a><a name="m32c_002dx_002delf"></a>m32c-*-elf</h3> + +<p>Renesas M32C processor. +This configuration is intended for embedded systems. + + <p><hr /> + +<h3 class="heading"><a name="TOC29"></a><a name="m32r_002dx_002delf"></a>m32r-*-elf</h3> + +<p>Renesas M32R processor. +This configuration is intended for embedded systems. + + <p><hr /> + +<h3 class="heading"><a name="TOC30"></a><a name="m6811_002delf"></a>m6811-elf</h3> + +<p>Motorola 68HC11 family micro controllers. These are used in embedded +applications. There are no standard Unix configurations. + + <p><hr /> + +<h3 class="heading"><a name="TOC31"></a><a name="m6812_002delf"></a>m6812-elf</h3> + +<p>Motorola 68HC12 family micro controllers. These are used in embedded +applications. There are no standard Unix configurations. + + <p><hr /> + +<h3 class="heading"><a name="TOC32"></a><a name="m68k_002dx_002dx"></a>m68k-*-*</h3> + +<p>By default, ‘<samp><span class="samp">m68k-*-aout</span></samp>’, ‘<samp><span class="samp">m68k-*-coff*</span></samp>’, +‘<samp><span class="samp">m68k-*-elf*</span></samp>’, ‘<samp><span class="samp">m68k-*-rtems</span></samp>’ and ‘<samp><span class="samp">m68k-*-uclinux</span></samp>’ +build libraries for both M680x0 and ColdFire processors. If you only +need the M680x0 libraries, you can omit the ColdFire ones by passing +<samp><span class="option">--with-arch=m68k</span></samp> to <samp><span class="command">configure</span></samp>. Alternatively, you +can omit the M680x0 libraries by passing <samp><span class="option">--with-arch=cf</span></samp> to +<samp><span class="command">configure</span></samp>. These targets default to 5206 code when +configured with <samp><span class="option">--with-arch=cf</span></samp> and 68020 code otherwise. + + <p>The ‘<samp><span class="samp">m68k-*-linux-gnu</span></samp>’, ‘<samp><span class="samp">m68k-*-netbsd</span></samp>’ and +‘<samp><span class="samp">m68k-*-openbsd</span></samp>’ targets also support the <samp><span class="option">--with-arch</span></samp> +option. They will generate ColdFire CFV4e code when configured with +<samp><span class="option">--with-arch=cf</span></samp> and 68020 code otherwise. + + <p>You can override the default processors listed above by configuring +with <samp><span class="option">--with-cpu=</span><var>target</var></samp>. This <var>target</var> can either +be a <samp><span class="option">-mcpu</span></samp> argument or one of the following values: +‘<samp><span class="samp">m68000</span></samp>’, ‘<samp><span class="samp">m68010</span></samp>’, ‘<samp><span class="samp">m68020</span></samp>’, ‘<samp><span class="samp">m68030</span></samp>’, +‘<samp><span class="samp">m68040</span></samp>’, ‘<samp><span class="samp">m68060</span></samp>’, ‘<samp><span class="samp">m68020-40</span></samp>’ and ‘<samp><span class="samp">m68020-60</span></samp>’. + + <p><hr /> + +<h3 class="heading"><a name="TOC33"></a><a name="m68k_002dhp_002dhpux"></a>m68k-hp-hpux</h3> + +<p>HP 9000 series 300 or 400 running HP-UX. HP-UX version 8.0 has a bug in +the assembler that prevents compilation of GCC. This +bug manifests itself during the first stage of compilation, while +building <samp><span class="file">libgcc2.a</span></samp>: + +<pre class="smallexample"> _floatdisf + cc1: warning: `-g' option not supported on this version of GCC + cc1: warning: `-g1' option not supported on this version of GCC + ./xgcc: Internal compiler error: program as got fatal signal 11 +</pre> + <p>A patched version of the assembler is available as the file +<a href="ftp://altdorf.ai.mit.edu/archive/cph/hpux-8.0-assembler">ftp://altdorf.ai.mit.edu/archive/cph/hpux-8.0-assembler</a>. If you +have HP software support, the patch can also be obtained directly from +HP, as described in the following note: + + <blockquote> +This is the patched assembler, to patch SR#1653-010439, where the +assembler aborts on floating point constants. + + <p>The bug is not really in the assembler, but in the shared library +version of the function “cvtnum(3c)”. The bug on “cvtnum(3c)” is +SR#4701-078451. Anyway, the attached assembler uses the archive +library version of “cvtnum(3c)” and thus does not exhibit the bug. +</blockquote> + + <p>This patch is also known as PHCO_4484. + + <p>In addition gdb does not understand that native HP-UX format, so +you must use gas if you wish to use gdb. + + <p>On HP-UX version 8.05, but not on 8.07 or more recent versions, the +<samp><span class="command">fixproto</span></samp> shell script triggers a bug in the system shell. If you +encounter this problem, upgrade your operating system or use BASH (the +GNU shell) to run <samp><span class="command">fixproto</span></samp>. This bug will cause the fixproto +program to report an error of the form: + +<pre class="smallexample"> ./fixproto: sh internal 1K buffer overflow +</pre> + <p>To fix this, you can also change the first line of the fixproto script +to look like: + +<pre class="smallexample"> #!/bin/ksh +</pre> + <p><hr /> + +<h3 class="heading"><a name="TOC34"></a><a name="m68k_002dx_002duclinux"></a>m68k-*-uclinux</h3> + +<p>GCC 4.3 changed the uClinux configuration so that it uses the +‘<samp><span class="samp">m68k-linux-gnu</span></samp>’ ABI rather than the ‘<samp><span class="samp">m68k-elf</span></samp>’ ABI. +It also added improved support for C++ and flat shared libraries, +both of which were ABI changes. However, you can still use the +original ABI by configuring for ‘<samp><span class="samp">m68k-uclinuxoldabi</span></samp>’ or +‘<samp><span class="samp">m68k-</span><var>vendor</var><span class="samp">-uclinuxoldabi</span></samp>’. + + <p><hr /> + +<h3 class="heading"><a name="TOC35"></a><a name="mips_002dx_002dx"></a>mips-*-*</h3> + +<p>If on a MIPS system you get an error message saying “does not have gp +sections for all it's [sic] sectons [sic]”, don't worry about it. This +happens whenever you use GAS with the MIPS linker, but there is not +really anything wrong, and it is okay to use the output file. You can +stop such warnings by installing the GNU linker. + + <p>It would be nice to extend GAS to produce the gp tables, but they are +optional, and there should not be a warning about their absence. + + <p>The libstdc++ atomic locking routines for MIPS targets requires MIPS II +and later. A patch went in just after the GCC 3.3 release to +make ‘<samp><span class="samp">mips*-*-*</span></samp>’ use the generic implementation instead. You can also +configure for ‘<samp><span class="samp">mipsel-elf</span></samp>’ as a workaround. The +‘<samp><span class="samp">mips*-*-linux*</span></samp>’ target continues to use the MIPS II routines. More +work on this is expected in future releases. + +<!-- If you make -with-llsc the default for another target, please also --> +<!-- update the description of the -with-llsc option. --> + <p>The built-in <code>__sync_*</code> functions are available on MIPS II and +later systems and others that support the ‘<samp><span class="samp">ll</span></samp>’, ‘<samp><span class="samp">sc</span></samp>’ and +‘<samp><span class="samp">sync</span></samp>’ instructions. This can be overridden by passing +<samp><span class="option">--with-llsc</span></samp> or <samp><span class="option">--without-llsc</span></samp> when configuring GCC. +Since the Linux kernel emulates these instructions if they are +missing, the default for ‘<samp><span class="samp">mips*-*-linux*</span></samp>’ targets is +<samp><span class="option">--with-llsc</span></samp>. The <samp><span class="option">--with-llsc</span></samp> and +<samp><span class="option">--without-llsc</span></samp> configure options may be overridden at compile +time by passing the <samp><span class="option">-mllsc</span></samp> or <samp><span class="option">-mno-llsc</span></samp> options to +the compiler. + + <p>MIPS systems check for division by zero (unless +<samp><span class="option">-mno-check-zero-division</span></samp> is passed to the compiler) by +generating either a conditional trap or a break instruction. Using +trap results in smaller code, but is only supported on MIPS II and +later. Also, some versions of the Linux kernel have a bug that +prevents trap from generating the proper signal (<code>SIGFPE</code>). To enable +the use of break, use the <samp><span class="option">--with-divide=breaks</span></samp> +<samp><span class="command">configure</span></samp> option when configuring GCC. The default is to +use traps on systems that support them. + + <p>Cross-compilers for the MIPS as target using the MIPS assembler +currently do not work, because the auxiliary programs +<samp><span class="file">mips-tdump.c</span></samp> and <samp><span class="file">mips-tfile.c</span></samp> can't be compiled on +anything but a MIPS. It does work to cross compile for a MIPS +if you use the GNU assembler and linker. + + <p>The assembler from GNU binutils 2.17 and earlier has a bug in the way +it sorts relocations for REL targets (o32, o64, EABI). This can cause +bad code to be generated for simple C++ programs. Also the linker +from GNU binutils versions prior to 2.17 has a bug which causes the +runtime linker stubs in very large programs, like <samp><span class="file">libgcj.so</span></samp>, to +be incorrectly generated. GNU Binutils 2.18 and later (and snapshots +made after Nov. 9, 2006) should be free from both of these problems. + + <p><hr /> + +<h3 class="heading"><a name="TOC36"></a><a name="mips_002dsgi_002dirix5"></a>mips-sgi-irix5</h3> + +<p>In order to compile GCC on an SGI running IRIX 5, the ‘<samp><span class="samp">compiler_dev.hdr</span></samp>’ +subsystem must be installed from the IDO CD-ROM supplied by SGI. +It is also available for download from +<a href="ftp://ftp.sgi.com/sgi/IRIX5.3/iris-development-option-5.3.tardist">ftp://ftp.sgi.com/sgi/IRIX5.3/iris-development-option-5.3.tardist</a>. + + <p>If you use the MIPS C compiler to bootstrap, it may be necessary +to increase its table size for switch statements with the +<samp><span class="option">-Wf,-XNg1500</span></samp> option. If you use the <samp><span class="option">-O2</span></samp> +optimization option, you also need to use <samp><span class="option">-Olimit 3000</span></samp>. + + <p>To enable debugging under IRIX 5, you must use GNU binutils 2.15 or +later, and use the <samp><span class="option">--with-gnu-ld</span></samp> <samp><span class="command">configure</span></samp> option +when configuring GCC. You need to use GNU <samp><span class="command">ar</span></samp> and <samp><span class="command">nm</span></samp>, +also distributed with GNU binutils. + + <p>Some users have reported that <samp><span class="command">/bin/sh</span></samp> will hang during bootstrap. +This problem can be avoided by running the commands: + +<pre class="smallexample"> % CONFIG_SHELL=/bin/ksh + % export CONFIG_SHELL +</pre> + <p>before starting the build. + + <p><hr /> + +<h3 class="heading"><a name="TOC37"></a><a name="mips_002dsgi_002dirix6"></a>mips-sgi-irix6</h3> + +<p>If you are using SGI's MIPSpro <samp><span class="command">cc</span></samp> as your bootstrap compiler, you must +ensure that the N32 ABI is in use. To test this, compile a simple C +file with <samp><span class="command">cc</span></samp> and then run <samp><span class="command">file</span></samp> on the +resulting object file. The output should look like: + +<pre class="smallexample"> test.o: ELF N32 MSB ... +</pre> + <p>If you see: + +<pre class="smallexample"> test.o: ELF 32-bit MSB ... +</pre> + <p>or + +<pre class="smallexample"> test.o: ELF 64-bit MSB ... +</pre> + <p>then your version of <samp><span class="command">cc</span></samp> uses the O32 or N64 ABI by default. You +should set the environment variable <samp><span class="env">CC</span></samp> to ‘<samp><span class="samp">cc -n32</span></samp>’ +before configuring GCC. + + <p>If you want the resulting <samp><span class="command">gcc</span></samp> to run on old 32-bit systems +with the MIPS R4400 CPU, you need to ensure that only code for the ‘<samp><span class="samp">mips3</span></samp>’ +instruction set architecture (ISA) is generated. While GCC 3.x does +this correctly, both GCC 2.95 and SGI's MIPSpro <samp><span class="command">cc</span></samp> may change +the ISA depending on the machine where GCC is built. Using one of them +as the bootstrap compiler may result in ‘<samp><span class="samp">mips4</span></samp>’ code, which won't run at +all on ‘<samp><span class="samp">mips3</span></samp>’-only systems. For the test program above, you should see: + +<pre class="smallexample"> test.o: ELF N32 MSB mips-3 ... +</pre> + <p>If you get: + +<pre class="smallexample"> test.o: ELF N32 MSB mips-4 ... +</pre> + <p>instead, you should set the environment variable <samp><span class="env">CC</span></samp> to ‘<samp><span class="samp">cc +-n32 -mips3</span></samp>’ or ‘<samp><span class="samp">gcc -mips3</span></samp>’ respectively before configuring GCC. + + <p>MIPSpro C 7.4 may cause bootstrap failures, due to a bug when inlining +<code>memcmp</code>. Either add <code>-U__INLINE_INTRINSICS</code> to the <samp><span class="env">CC</span></samp> +environment variable as a workaround or upgrade to MIPSpro C 7.4.1m. + + <p>GCC on IRIX 6 is usually built to support the N32, O32 and N64 ABIs. If +you build GCC on a system that doesn't have the N64 libraries installed +or cannot run 64-bit binaries, +you need to configure with <samp><span class="option">--disable-multilib</span></samp> so GCC doesn't +try to use them. This will disable building the O32 libraries, too. +Look for <samp><span class="file">/usr/lib64/libc.so.1</span></samp> to see if you +have the 64-bit libraries installed. + + <p>To enable debugging for the O32 ABI, you must use GNU <samp><span class="command">as</span></samp> from +GNU binutils 2.15 or later. You may also use GNU <samp><span class="command">ld</span></samp>, but +this is not required and currently causes some problems with Ada. + + <p>The <samp><span class="option">--enable-libgcj</span></samp> +option is disabled by default: IRIX 6 uses a very low default limit +(20480) for the command line length. Although <samp><span class="command">libtool</span></samp> contains a +workaround for this problem, at least the N64 ‘<samp><span class="samp">libgcj</span></samp>’ is known not +to build despite this, running into an internal error of the native +<samp><span class="command">ld</span></samp>. A sure fix is to increase this limit (‘<samp><span class="samp">ncargs</span></samp>’) to +its maximum of 262144 bytes. If you have root access, you can use the +<samp><span class="command">systune</span></samp> command to do this. + + <p><code>wchar_t</code> support in ‘<samp><span class="samp">libstdc++</span></samp>’ is not available for old +IRIX 6.5.x releases, x < 19. The problem cannot be autodetected +and in order to build GCC for such targets you need to configure with +<samp><span class="option">--disable-wchar_t</span></samp>. + + <p>See <a href="http://freeware.sgi.com/">http://freeware.sgi.com/</a> for more +information about using GCC on IRIX platforms. + + <p><hr /> + +<h3 class="heading"><a name="TOC38"></a><a name="powerpc_002dx_002dx"></a>powerpc-*-*</h3> + +<p>You can specify a default version for the <samp><span class="option">-mcpu=</span><var>cpu_type</var></samp> +switch by using the configure option <samp><span class="option">--with-cpu-</span><var>cpu_type</var></samp>. + + <p><hr /> + +<h3 class="heading"><a name="TOC39"></a><a name="powerpc_002dx_002ddarwin"></a>powerpc-*-darwin*</h3> + +<p>PowerPC running Darwin (Mac OS X kernel). + + <p>Pre-installed versions of Mac OS X may not include any developer tools, +meaning that you will not be able to build GCC from source. Tool +binaries are available at +<a href="http://developer.apple.com/darwin/projects/compiler/">http://developer.apple.com/darwin/projects/compiler/</a> (free +registration required). + + <p>This version of GCC requires at least cctools-590.36. The +cctools-590.36 package referenced from +<a href="http://gcc.gnu.org/ml/gcc/2006-03/msg00507.html">http://gcc.gnu.org/ml/gcc/2006-03/msg00507.html</a> will not work +on systems older than 10.3.9 (aka darwin7.9.0). + + <p><hr /> + +<h3 class="heading"><a name="TOC40"></a><a name="powerpc_002dx_002delf"></a>powerpc-*-elf, powerpc-*-sysv4</h3> + +<p>PowerPC system in big endian mode, running System V.4. + + <p><hr /> + +<h3 class="heading"><a name="TOC41"></a><a name="powerpc_002dx_002dlinux_002dgnu"></a>powerpc*-*-linux-gnu*</h3> + +<p>You will need +<a href="ftp://ftp.kernel.org/pub/linux/devel/binutils">binutils 2.15</a> +or newer for a working GCC. + + <p><hr /> + +<h3 class="heading"><a name="TOC42"></a><a name="powerpc_002dx_002dnetbsd"></a>powerpc-*-netbsd*</h3> + +<p>PowerPC system in big endian mode running NetBSD. To build the +documentation you will need Texinfo version 4.4 (NetBSD 1.5.1 included +Texinfo version 3.12). + + <p><hr /> + +<h3 class="heading"><a name="TOC43"></a><a name="powerpc_002dx_002deabisim"></a>powerpc-*-eabisim</h3> + +<p>Embedded PowerPC system in big endian mode for use in running under the +PSIM simulator. + + <p><hr /> + +<h3 class="heading"><a name="TOC44"></a><a name="powerpc_002dx_002deabi"></a>powerpc-*-eabi</h3> + +<p>Embedded PowerPC system in big endian mode. + + <p><hr /> + +<h3 class="heading"><a name="TOC45"></a><a name="powerpcle_002dx_002delf"></a>powerpcle-*-elf, powerpcle-*-sysv4</h3> + +<p>PowerPC system in little endian mode, running System V.4. + + <p><hr /> + +<h3 class="heading"><a name="TOC46"></a><a name="powerpcle_002dx_002deabisim"></a>powerpcle-*-eabisim</h3> + +<p>Embedded PowerPC system in little endian mode for use in running under +the PSIM simulator. + + <p><hr /> + +<h3 class="heading"><a name="TOC47"></a><a name="powerpcle_002dx_002deabi"></a>powerpcle-*-eabi</h3> + +<p>Embedded PowerPC system in little endian mode. + + <p><hr /> + +<h3 class="heading"><a name="TOC48"></a><a name="s390_002dx_002dlinux"></a>s390-*-linux*</h3> + +<p>S/390 system running GNU/Linux for S/390. + + <p><hr /> + +<h3 class="heading"><a name="TOC49"></a><a name="s390x_002dx_002dlinux"></a>s390x-*-linux*</h3> + +<p>zSeries system (64-bit) running GNU/Linux for zSeries. + + <p><hr /> + +<h3 class="heading"><a name="TOC50"></a><a name="s390x_002dibm_002dtpf"></a>s390x-ibm-tpf*</h3> + +<p>zSeries system (64-bit) running TPF. This platform is +supported as cross-compilation target only. + + <p><hr /><!-- Please use Solaris 2 to refer to all release of Solaris, starting --> +<!-- with 2.0 until 2.6, 7, 8, etc. Solaris 1 was a marketing name for --> +<!-- SunOS 4 releases which we don't use to avoid confusion. Solaris --> +<!-- alone is too unspecific and must be avoided. --> + +<h3 class="heading"><a name="TOC51"></a><a name="x_002dx_002dsolaris2"></a>*-*-solaris2*</h3> + +<p>Sun does not ship a C compiler with Solaris 2. To bootstrap and install +GCC you first have to install a pre-built compiler, see the +<a href="binaries.html">binaries page</a> for details. + + <p>The Solaris 2 <samp><span class="command">/bin/sh</span></samp> will often fail to configure +<samp><span class="file">libstdc++-v3</span></samp>, <samp><span class="file">boehm-gc</span></samp> or <samp><span class="file">libjava</span></samp>. We therefore +recommend using the following initial sequence of commands + +<pre class="smallexample"> % CONFIG_SHELL=/bin/ksh + % export CONFIG_SHELL +</pre> + <p>and proceed as described in <a href="configure.html">the configure instructions</a>. +In addition we strongly recommend specifying an absolute path to invoke +<var>srcdir</var>/configure. + + <p>Solaris 2 comes with a number of optional OS packages. Some of these +are needed to use GCC fully, namely <code>SUNWarc</code>, +<code>SUNWbtool</code>, <code>SUNWesu</code>, <code>SUNWhea</code>, <code>SUNWlibm</code>, +<code>SUNWsprot</code>, and <code>SUNWtoo</code>. If you did not install all +optional packages when installing Solaris 2, you will need to verify that +the packages that GCC needs are installed. + + <p>To check whether an optional package is installed, use +the <samp><span class="command">pkginfo</span></samp> command. To add an optional package, use the +<samp><span class="command">pkgadd</span></samp> command. For further details, see the Solaris 2 +documentation. + + <p>Trying to use the linker and other tools in +<samp><span class="file">/usr/ucb</span></samp> to install GCC has been observed to cause trouble. +For example, the linker may hang indefinitely. The fix is to remove +<samp><span class="file">/usr/ucb</span></samp> from your <samp><span class="env">PATH</span></samp>. + + <p>The build process works more smoothly with the legacy Sun tools so, if you +have <samp><span class="file">/usr/xpg4/bin</span></samp> in your <samp><span class="env">PATH</span></samp>, we recommend that you place +<samp><span class="file">/usr/bin</span></samp> before <samp><span class="file">/usr/xpg4/bin</span></samp> for the duration of the build. + + <p>All releases of GNU binutils prior to 2.11.2 have known bugs on this +platform. We recommend the use of GNU binutils 2.11.2 or later, or the +vendor tools (Sun <samp><span class="command">as</span></samp>, Sun <samp><span class="command">ld</span></samp>). Note that your mileage +may vary if you use a combination of the GNU tools and the Sun tools: while +the combination GNU <samp><span class="command">as</span></samp> + Sun <samp><span class="command">ld</span></samp> should reasonably work, +the reverse combination Sun <samp><span class="command">as</span></samp> + GNU <samp><span class="command">ld</span></samp> is known to +cause memory corruption at runtime in some cases for C++ programs. + + <p>The stock GNU binutils 2.15 release is broken on this platform because of a +single bug. It has been fixed on the 2.15 branch in the CVS repository. +You can obtain a working version by checking out the binutils-2_15-branch +from the CVS repository or applying the patch +<a href="http://sourceware.org/ml/binutils-cvs/2004-09/msg00036.html">http://sourceware.org/ml/binutils-cvs/2004-09/msg00036.html</a> to the +release. + + <p>We recommend using GNU binutils 2.16 or later in conjunction with GCC 4.x, +or the vendor tools (Sun <samp><span class="command">as</span></samp>, Sun <samp><span class="command">ld</span></samp>). However, for +Solaris 10 and above, an additional patch is required in order for the GNU +linker to be able to cope with a new flavor of shared libraries. You +can obtain a working version by checking out the binutils-2_16-branch from +the CVS repository or applying the patch +<a href="http://sourceware.org/ml/binutils-cvs/2005-07/msg00122.html">http://sourceware.org/ml/binutils-cvs/2005-07/msg00122.html</a> to the +release. + + <p>Sun bug 4296832 turns up when compiling X11 headers with GCC 2.95 or +newer: <samp><span class="command">g++</span></samp> will complain that types are missing. These headers assume +that omitting the type means <code>int</code>; this assumption worked for C89 but +is wrong for C++, and is now wrong for C99 also. + + <p><samp><span class="command">g++</span></samp> accepts such (invalid) constructs with the option +<samp><span class="option">-fpermissive</span></samp>; it +will assume that any missing type is <code>int</code> (as defined by C89). + + <p>There are patches for Solaris 2.6 (105633-56 or newer for SPARC, +106248-42 or newer for Intel), Solaris 7 (108376-21 or newer for SPARC, +108377-20 for Intel), and Solaris 8 (108652-24 or newer for SPARC, +108653-22 for Intel) that fix this bug. + + <p>Sun bug 4927647 sometimes causes random spurious testsuite failures +related to missing diagnostic output. This bug doesn't affect GCC +itself, rather it is a kernel bug triggered by the <samp><span class="command">expect</span></samp> +program which is used only by the GCC testsuite driver. When the bug +causes the <samp><span class="command">expect</span></samp> program to miss anticipated output, extra +testsuite failures appear. + + <p>There are patches for Solaris 8 (117350-12 or newer for SPARC, +117351-12 or newer for Intel) and Solaris 9 (117171-11 or newer for +SPARC, 117172-11 or newer for Intel) that address this problem. + + <p><hr /> + +<h3 class="heading"><a name="TOC52"></a><a name="sparc_002dsun_002dsolaris2"></a>sparc-sun-solaris2*</h3> + +<p>When GCC is configured to use binutils 2.11.2 or later the binaries +produced are smaller than the ones produced using Sun's native tools; +this difference is quite significant for binaries containing debugging +information. + + <p>Sun <samp><span class="command">as</span></samp> 4.x is broken in that it cannot cope with long symbol names. +A typical error message might look similar to the following: + +<pre class="smallexample"> /usr/ccs/bin/as: "/var/tmp/ccMsw135.s", line 11041: error: + can't compute value of an expression involving an external symbol. +</pre> + <p>This is Sun bug 4237974. This is fixed with patch 108908-02 for Solaris +2.6 and has been fixed in later (5.x) versions of the assembler, +starting with Solaris 7. + + <p>Starting with Solaris 7, the operating system is capable of executing +64-bit SPARC V9 binaries. GCC 3.1 and later properly supports +this; the <samp><span class="option">-m64</span></samp> option enables 64-bit code generation. +However, if all you want is code tuned for the UltraSPARC CPU, you +should try the <samp><span class="option">-mtune=ultrasparc</span></samp> option instead, which produces +code that, unlike full 64-bit code, can still run on non-UltraSPARC +machines. + + <p>When configuring on a Solaris 7 or later system that is running a kernel +that supports only 32-bit binaries, one must configure with +<samp><span class="option">--disable-multilib</span></samp>, since we will not be able to build the +64-bit target libraries. + + <p>GCC 3.3 and GCC 3.4 trigger code generation bugs in earlier versions of +the GNU compiler (especially GCC 3.0.x versions), which lead to the +miscompilation of the stage1 compiler and the subsequent failure of the +bootstrap process. A workaround is to use GCC 3.2.3 as an intermediary +stage, i.e. to bootstrap that compiler with the base compiler and then +use it to bootstrap the final compiler. + + <p>GCC 3.4 triggers a code generation bug in versions 5.4 (Sun ONE Studio 7) +and 5.5 (Sun ONE Studio 8) of the Sun compiler, which causes a bootstrap +failure in form of a miscompilation of the stage1 compiler by the Sun +compiler. This is Sun bug 4974440. This is fixed with patch 112760-07. + + <p>GCC 3.4 changed the default debugging format from STABS to DWARF-2 for +32-bit code on Solaris 7 and later. If you use the Sun assembler, this +change apparently runs afoul of Sun bug 4910101 (which is referenced as +a x86-only problem by Sun, probably because they do not use DWARF-2). +A symptom of the problem is that you cannot compile C++ programs like +<samp><span class="command">groff</span></samp> 1.19.1 without getting messages similar to the following: + +<pre class="smallexample"> ld: warning: relocation error: R_SPARC_UA32: ... + external symbolic relocation against non-allocatable section + .debug_info cannot be processed at runtime: relocation ignored. +</pre> + <p>To work around this problem, compile with <samp><span class="option">-gstabs+</span></samp> instead of +plain <samp><span class="option">-g</span></samp>. + + <p>When configuring the GNU Multiple Precision Library (GMP) or the MPFR +library on a Solaris 7 or later system, the canonical target triplet +must be specified as the <samp><span class="command">build</span></samp> parameter on the configure +line. This triplet can be obtained by invoking ./config.guess in +the toplevel source directory of GCC (and not that of GMP or MPFR). +For example on a Solaris 7 system: + +<pre class="smallexample"> % ./configure --build=sparc-sun-solaris2.7 --prefix=xxx +</pre> + <p><hr /> + +<h3 class="heading"><a name="TOC53"></a><a name="sparc_002dsun_002dsolaris27"></a>sparc-sun-solaris2.7</h3> + +<p>Sun patch 107058-01 (1999-01-13) for Solaris 7/SPARC triggers a bug in +the dynamic linker. This problem (Sun bug 4210064) affects GCC 2.8 +and later, including all EGCS releases. Sun formerly recommended +107058-01 for all Solaris 7 users, but around 1999-09-01 it started to +recommend it only for people who use Sun's compilers. + + <p>Here are some workarounds to this problem: + <ul> +<li>Do not install Sun patch 107058-01 until after Sun releases a +complete patch for bug 4210064. This is the simplest course to take, +unless you must also use Sun's C compiler. Unfortunately 107058-01 +is preinstalled on some new Solaris 7-based hosts, so you may have to +back it out. + + <li>Copy the original, unpatched Solaris 7 +<samp><span class="command">/usr/ccs/bin/as</span></samp> into +<samp><span class="command">/usr/local/libexec/gcc/sparc-sun-solaris2.7/3.4/as</span></samp>, +adjusting the latter name to fit your local conventions and software +version numbers. + + <li>Install Sun patch 106950-03 (1999-05-25) or later. Nobody with +both 107058-01 and 106950-03 installed has reported the bug with GCC +and Sun's dynamic linker. This last course of action is riskiest, +for two reasons. First, you must install 106950 on all hosts that +run code generated by GCC; it doesn't suffice to install it only on +the hosts that run GCC itself. Second, Sun says that 106950-03 is +only a partial fix for bug 4210064, but Sun doesn't know whether the +partial fix is adequate for GCC. Revision -08 or later should fix +the bug. The current (as of 2004-05-23) revision is -24, and is included in +the Solaris 7 Recommended Patch Cluster. +</ul> + + <p>GCC 3.3 triggers a bug in version 5.0 Alpha 03/27/98 of the Sun assembler, +which causes a bootstrap failure when linking the 64-bit shared version of +libgcc. A typical error message is: + +<pre class="smallexample"> ld: fatal: relocation error: R_SPARC_32: file libgcc/sparcv9/_muldi3.o: + symbol <unknown>: offset 0xffffffff7ec133e7 is non-aligned. +</pre> + <p>This bug has been fixed in the final 5.0 version of the assembler. + + <p>A similar problem was reported for version Sun WorkShop 6 99/08/18 of the +Sun assembler, which causes a bootstrap failure with GCC 4.0.0: + +<pre class="smallexample"> ld: fatal: relocation error: R_SPARC_DISP32: + file .libs/libstdc++.lax/libsupc++convenience.a/vterminate.o: + symbol <unknown>: offset 0xfccd33ad is non-aligned +</pre> + <p>This bug has been fixed in more recent revisions of the assembler. + + <p><hr /> + +<h3 class="heading"><a name="TOC54"></a><a name="sparc_002dx_002dlinux"></a>sparc-*-linux*</h3> + +<p>GCC versions 3.0 and higher require binutils 2.11.2 and glibc 2.2.4 +or newer on this platform. All earlier binutils and glibc +releases mishandled unaligned relocations on <code>sparc-*-*</code> targets. + + <p><hr /> + +<h3 class="heading"><a name="TOC55"></a><a name="sparc64_002dx_002dsolaris2"></a>sparc64-*-solaris2*</h3> + +<p>When configuring the GNU Multiple Precision Library (GMP) or the +MPFR library, the canonical target triplet must be specified as +the <samp><span class="command">build</span></samp> parameter on the configure line. For example +on a Solaris 7 system: + +<pre class="smallexample"> % ./configure --build=sparc64-sun-solaris2.7 --prefix=xxx +</pre> + <p>The following compiler flags must be specified in the configure +step in order to bootstrap this target with the Sun compiler: + +<pre class="smallexample"> % CC="cc -xarch=v9 -xildoff" <var>srcdir</var>/configure [<var>options</var>] [<var>target</var>] +</pre> + <p><samp><span class="option">-xarch=v9</span></samp> specifies the SPARC-V9 architecture to the Sun toolchain +and <samp><span class="option">-xildoff</span></samp> turns off the incremental linker. + + <p><hr /> + +<h3 class="heading"><a name="TOC56"></a><a name="sparcv9_002dx_002dsolaris2"></a>sparcv9-*-solaris2*</h3> + +<p>This is a synonym for sparc64-*-solaris2*. + + <p><hr /> + +<h3 class="heading"><a name="TOC57"></a><a name="x_002dx_002dsysv"></a>*-*-sysv*</h3> + +<p>On System V release 3, you may get this error message +while linking: + +<pre class="smallexample"> ld fatal: failed to write symbol name <var>something</var> + in strings table for file <var>whatever</var> +</pre> + <p>This probably indicates that the disk is full or your ulimit won't allow +the file to be as large as it needs to be. + + <p>This problem can also result because the kernel parameter <code>MAXUMEM</code> +is too small. If so, you must regenerate the kernel and make the value +much larger. The default value is reported to be 1024; a value of 32768 +is said to work. Smaller values may also work. + + <p>On System V, if you get an error like this, + +<pre class="smallexample"> /usr/local/lib/bison.simple: In function `yyparse': + /usr/local/lib/bison.simple:625: virtual memory exhausted +</pre> + <p class="noindent">that too indicates a problem with disk space, ulimit, or <code>MAXUMEM</code>. + + <p>On a System V release 4 system, make sure <samp><span class="file">/usr/bin</span></samp> precedes +<samp><span class="file">/usr/ucb</span></samp> in <code>PATH</code>. The <samp><span class="command">cc</span></samp> command in +<samp><span class="file">/usr/ucb</span></samp> uses libraries which have bugs. + + <p><hr /> + +<h3 class="heading"><a name="TOC58"></a><a name="vax_002ddec_002dultrix"></a>vax-dec-ultrix</h3> + +<p>Don't try compiling with VAX C (<samp><span class="command">vcc</span></samp>). It produces incorrect code +in some cases (for example, when <code>alloca</code> is used). + + <p><hr /> + +<h3 class="heading"><a name="TOC59"></a><a name="x_002dx_002dvxworks"></a>*-*-vxworks*</h3> + +<p>Support for VxWorks is in flux. At present GCC supports <em>only</em> the +very recent VxWorks 5.5 (aka Tornado 2.2) release, and only on PowerPC. +We welcome patches for other architectures supported by VxWorks 5.5. +Support for VxWorks AE would also be welcome; we believe this is merely +a matter of writing an appropriate “configlette” (see below). We are +not interested in supporting older, a.out or COFF-based, versions of +VxWorks in GCC 3. + + <p>VxWorks comes with an older version of GCC installed in +<samp><var>$WIND_BASE</var><span class="file">/host</span></samp>; we recommend you do not overwrite it. +Choose an installation <var>prefix</var> entirely outside <var>$WIND_BASE</var>. +Before running <samp><span class="command">configure</span></samp>, create the directories <samp><var>prefix</var></samp> +and <samp><var>prefix</var><span class="file">/bin</span></samp>. Link or copy the appropriate assembler, +linker, etc. into <samp><var>prefix</var><span class="file">/bin</span></samp>, and set your <var>PATH</var> to +include that directory while running both <samp><span class="command">configure</span></samp> and +<samp><span class="command">make</span></samp>. + + <p>You must give <samp><span class="command">configure</span></samp> the +<samp><span class="option">--with-headers=</span><var>$WIND_BASE</var><span class="option">/target/h</span></samp> switch so that it can +find the VxWorks system headers. Since VxWorks is a cross compilation +target only, you must also specify <samp><span class="option">--target=</span><var>target</var></samp>. +<samp><span class="command">configure</span></samp> will attempt to create the directory +<samp><var>prefix</var><span class="file">/</span><var>target</var><span class="file">/sys-include</span></samp> and copy files into it; +make sure the user running <samp><span class="command">configure</span></samp> has sufficient privilege +to do so. + + <p>GCC's exception handling runtime requires a special “configlette” +module, <samp><span class="file">contrib/gthr_supp_vxw_5x.c</span></samp>. Follow the instructions in +that file to add the module to your kernel build. (Future versions of +VxWorks will incorporate this module.) + + <p><hr /> + +<h3 class="heading"><a name="TOC60"></a><a name="x86_002d64_002dx_002dx"></a>x86_64-*-*, amd64-*-*</h3> + +<p>GCC supports the x86-64 architecture implemented by the AMD64 processor +(amd64-*-* is an alias for x86_64-*-*) on GNU/Linux, FreeBSD and NetBSD. +On GNU/Linux the default is a bi-arch compiler which is able to generate +both 64-bit x86-64 and 32-bit x86 code (via the <samp><span class="option">-m32</span></samp> switch). + + <p><hr /> + +<h3 class="heading"><a name="TOC61"></a><a name="xtensa_002dx_002delf"></a>xtensa-*-elf</h3> + +<p>This target is intended for embedded Xtensa systems using the +‘<samp><span class="samp">newlib</span></samp>’ C library. It uses ELF but does not support shared +objects. Designed-defined instructions specified via the +Tensilica Instruction Extension (TIE) language are only supported +through inline assembly. + + <p>The Xtensa configuration information must be specified prior to +building GCC. The <samp><span class="file">include/xtensa-config.h</span></samp> header +file contains the configuration information. If you created your +own Xtensa configuration with the Xtensa Processor Generator, the +downloaded files include a customized copy of this header file, +which you can use to replace the default header file. + + <p><hr /> + +<h3 class="heading"><a name="TOC62"></a><a name="xtensa_002dx_002dlinux"></a>xtensa-*-linux*</h3> + +<p>This target is for Xtensa systems running GNU/Linux. It supports ELF +shared objects and the GNU C library (glibc). It also generates +position-independent code (PIC) regardless of whether the +<samp><span class="option">-fpic</span></samp> or <samp><span class="option">-fPIC</span></samp> options are used. In other +respects, this target is the same as the +<a href="#xtensa-*-elf">‘<samp><span class="samp">xtensa-*-elf</span></samp>’</a> target. + + <p><hr /> + +<h3 class="heading"><a name="TOC63"></a><a name="windows"></a>Microsoft Windows (32-bit)</h3> + +<p>Ports of GCC are included with the +<a href="http://www.cygwin.com/">Cygwin environment</a>. + + <p>GCC will build under Cygwin without modification; it does not build +with Microsoft's C++ compiler and there are no plans to make it do so. + + <p>For MinGW, GCC will build with and support only MinGW runtime 3.12 and later. +Earlier versions of headers are incompatible with the new default semantics +of <code>extern inline</code> in <code>-std=c99</code> and <code>-std=gnu99</code> modes. + + <p><hr /> + +<h3 class="heading"><a name="TOC64"></a><a name="os2"></a>OS/2</h3> + +<p>GCC does not currently support OS/2. However, Andrew Zabolotny has been +working on a generic OS/2 port with pgcc. The current code can be found +at <a href="http://www.goof.com/pcg/os2/">http://www.goof.com/pcg/os2/</a>. + + <p><hr /> + +<h3 class="heading"><a name="TOC65"></a><a name="older"></a>Older systems</h3> + +<p>GCC contains support files for many older (1980s and early +1990s) Unix variants. For the most part, support for these systems +has not been deliberately removed, but it has not been maintained for +several years and may suffer from bitrot. + + <p>Starting with GCC 3.1, each release has a list of “obsoleted” systems. +Support for these systems is still present in that release, but +<samp><span class="command">configure</span></samp> will fail unless the <samp><span class="option">--enable-obsolete</span></samp> +option is given. Unless a maintainer steps forward, support for these +systems will be removed from the next release of GCC. + + <p>Support for old systems as hosts for GCC can cause problems if the +workarounds for compiler, library and operating system bugs affect the +cleanliness or maintainability of the rest of GCC. In some cases, to +bring GCC up on such a system, if still possible with current GCC, may +require first installing an old version of GCC which did work on that +system, and using it to compile a more recent GCC, to avoid bugs in the +vendor compiler. Old releases of GCC 1 and GCC 2 are available in the +<samp><span class="file">old-releases</span></samp> directory on the <a href="../mirrors.html">GCC mirror sites</a>. Header bugs may generally be avoided using +<samp><span class="command">fixincludes</span></samp>, but bugs or deficiencies in libraries and the +operating system may still cause problems. + + <p>Support for older systems as targets for cross-compilation is less +problematic than support for them as hosts for GCC; if an enthusiast +wishes to make such a target work again (including resurrecting any of +the targets that never worked with GCC 2, starting from the last +version before they were removed), patches +<a href="../contribute.html">following the usual requirements</a> would be +likely to be accepted, since they should not affect the support for more +modern targets. + + <p>For some systems, old versions of GNU binutils may also be useful, +and are available from <samp><span class="file">pub/binutils/old-releases</span></samp> on +<a href="http://sourceware.org/mirrors.html">sourceware.org mirror sites</a>. + + <p>Some of the information on specific systems above relates to +such older systems, but much of the information +about GCC on such systems (which may no longer be applicable to +current GCC) is to be found in the GCC texinfo manual. + + <p><hr /> + +<h3 class="heading"><a name="TOC66"></a><a name="elf"></a>all ELF targets (SVR4, Solaris 2, etc.)</h3> + +<p>C++ support is significantly better on ELF targets if you use the +<a href="./configure.html#with-gnu-ld">GNU linker</a>; duplicate copies of +inlines, vtables and template instantiations will be discarded +automatically. + + <p><hr /> +<p><a href="./index.html">Return to the GCC Installation page</a> + +<!-- ***Old documentation****************************************************** --> +<!-- ***GFDL******************************************************************** --> +<!-- *************************************************************************** --> +<!-- Part 6 The End of the Document --> +</body></html> + diff --git a/gcc-4.3.1/INSTALL/test.html b/gcc-4.3.1/INSTALL/test.html new file mode 100644 index 000000000..0c5278de6 --- /dev/null +++ b/gcc-4.3.1/INSTALL/test.html @@ -0,0 +1,232 @@ +<html lang="en"> +<head> +<title>Installing GCC: Testing</title> +<meta http-equiv="Content-Type" content="text/html"> +<meta name="description" content="Installing GCC: Testing"> +<meta name="generator" content="makeinfo 4.11"> +<link title="Top" rel="top" href="#Top"> +<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage"> +<!-- +Copyright (C) 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998, +1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc. + + Permission is granted to copy, distribute and/or modify this document +under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no +Invariant Sections, the Front-Cover texts being (a) (see below), and +with the Back-Cover Texts being (b) (see below). A copy of the +license is included in the section entitled "GNU Free Documentation License". + +(a) The FSF's Front-Cover Text is: + + A GNU Manual + +(b) The FSF's Back-Cover Text is: + + You have freedom to copy and modify this GNU Manual, like GNU + software. Copies published by the Free Software Foundation raise + funds for GNU development.--> +<meta http-equiv="Content-Style-Type" content="text/css"> +<style type="text/css"><!-- + pre.display { font-family:inherit } + pre.format { font-family:inherit } + pre.smalldisplay { font-family:inherit; font-size:smaller } + pre.smallformat { font-family:inherit; font-size:smaller } + pre.smallexample { font-size:smaller } + pre.smalllisp { font-size:smaller } + span.sc { font-variant:small-caps } + span.roman { font-family:serif; font-weight:normal; } + span.sansserif { font-family:sans-serif; font-weight:normal; } +--></style> +</head> +<body> +<h1 class="settitle">Installing GCC: Testing</h1> +<a name="index-Testing-1"></a><a name="index-Installing-GCC_003a-Testing-2"></a><a name="index-Testsuite-3"></a> +Before you install GCC, we encourage you to run the testsuites and to +compare your results with results from a similar configuration that have +been submitted to the +<a href="http://gcc.gnu.org/ml/gcc-testresults/">gcc-testresults mailing list</a>. +Some of these archived results are linked from the build status lists +at <a href="http://gcc.gnu.org/buildstat.html">http://gcc.gnu.org/buildstat.html</a>, although not everyone who +reports a successful build runs the testsuites and submits the results. +This step is optional and may require you to download additional software, +but it can give you confidence in your new GCC installation or point out +problems before you install and start using your new GCC. + + <p>First, you must have <a href="download.html">downloaded the testsuites</a>. +These are part of the full distribution, but if you downloaded the +“core” compiler plus any front ends, you must download the testsuites +separately. + + <p>Second, you must have the testing tools installed. This includes +<a href="http://www.gnu.org/software/dejagnu/">DejaGnu</a>, Tcl, and Expect; +the DejaGnu site has links to these. + + <p>If the directories where <samp><span class="command">runtest</span></samp> and <samp><span class="command">expect</span></samp> were +installed are not in the <samp><span class="env">PATH</span></samp>, you may need to set the following +environment variables appropriately, as in the following example (which +assumes that DejaGnu has been installed under <samp><span class="file">/usr/local</span></samp>): + +<pre class="smallexample"> TCL_LIBRARY = /usr/local/share/tcl8.0 + DEJAGNULIBS = /usr/local/share/dejagnu +</pre> + <p>(On systems such as Cygwin, these paths are required to be actual +paths, not mounts or links; presumably this is due to some lack of +portability in the DejaGnu code.) + + <p>Finally, you can run the testsuite (which may take a long time): +<pre class="smallexample"> cd <var>objdir</var>; make -k check +</pre> + <p>This will test various components of GCC, such as compiler +front ends and runtime libraries. While running the testsuite, DejaGnu +might emit some harmless messages resembling +‘<samp><span class="samp">WARNING: Couldn't find the global config file.</span></samp>’ or +‘<samp><span class="samp">WARNING: Couldn't find tool init file</span></samp>’ that can be ignored. + + <p>If you are testing a cross-compiler, you may want to run the testsuite +on a simulator as described at <a href="http://gcc.gnu.org/simtest-howto.html">http://gcc.gnu.org/simtest-howto.html</a>. + +<h3 class="section"><a name="TOC0"></a>0.1 How can you run the testsuite on selected tests?</h3> + +<p>In order to run sets of tests selectively, there are targets +‘<samp><span class="samp">make check-gcc</span></samp>’ and ‘<samp><span class="samp">make check-g++</span></samp>’ +in the <samp><span class="file">gcc</span></samp> subdirectory of the object directory. You can also +just run ‘<samp><span class="samp">make check</span></samp>’ in a subdirectory of the object directory. + + <p>A more selective way to just run all <samp><span class="command">gcc</span></samp> execute tests in the +testsuite is to use + +<pre class="smallexample"> make check-gcc RUNTESTFLAGS="execute.exp <var>other-options</var>" +</pre> + <p>Likewise, in order to run only the <samp><span class="command">g++</span></samp> “old-deja” tests in +the testsuite with filenames matching ‘<samp><span class="samp">9805*</span></samp>’, you would use + +<pre class="smallexample"> make check-g++ RUNTESTFLAGS="old-deja.exp=9805* <var>other-options</var>" +</pre> + <p>The <samp><span class="file">*.exp</span></samp> files are located in the testsuite directories of the GCC +source, the most important ones being <samp><span class="file">compile.exp</span></samp>, +<samp><span class="file">execute.exp</span></samp>, <samp><span class="file">dg.exp</span></samp> and <samp><span class="file">old-deja.exp</span></samp>. +To get a list of the possible <samp><span class="file">*.exp</span></samp> files, pipe the +output of ‘<samp><span class="samp">make check</span></samp>’ into a file and look at the +‘<samp><span class="samp">Running ... .exp</span></samp>’ lines. + +<h3 class="section"><a name="TOC1"></a>0.2 Passing options and running multiple testsuites</h3> + +<p>You can pass multiple options to the testsuite using the +‘<samp><span class="samp">--target_board</span></samp>’ option of DejaGNU, either passed as part of +‘<samp><span class="samp">RUNTESTFLAGS</span></samp>’, or directly to <samp><span class="command">runtest</span></samp> if you prefer to +work outside the makefiles. For example, + +<pre class="smallexample"> make check-g++ RUNTESTFLAGS="--target_board=unix/-O3/-fmerge-constants" +</pre> + <p>will run the standard <samp><span class="command">g++</span></samp> testsuites (“unix” is the target name +for a standard native testsuite situation), passing +‘<samp><span class="samp">-O3 -fmerge-constants</span></samp>’ to the compiler on every test, i.e., +slashes separate options. + + <p>You can run the testsuites multiple times using combinations of options +with a syntax similar to the brace expansion of popular shells: + +<pre class="smallexample"> ..."--target_board=arm-sim\{-mhard-float,-msoft-float\}\{-O1,-O2,-O3,\}" +</pre> + <p>(Note the empty option caused by the trailing comma in the final group.) +The following will run each testsuite eight times using the ‘<samp><span class="samp">arm-sim</span></samp>’ +target, as if you had specified all possible combinations yourself: + +<pre class="smallexample"> --target_board=arm-sim/-mhard-float/-O1 + --target_board=arm-sim/-mhard-float/-O2 + --target_board=arm-sim/-mhard-float/-O3 + --target_board=arm-sim/-mhard-float + --target_board=arm-sim/-msoft-float/-O1 + --target_board=arm-sim/-msoft-float/-O2 + --target_board=arm-sim/-msoft-float/-O3 + --target_board=arm-sim/-msoft-float +</pre> + <p>They can be combined as many times as you wish, in arbitrary ways. This +list: + +<pre class="smallexample"> ..."--target_board=unix/-Wextra\{-O3,-fno-strength\}\{-fomit-frame,\}" +</pre> + <p>will generate four combinations, all involving ‘<samp><span class="samp">-Wextra</span></samp>’. + + <p>The disadvantage to this method is that the testsuites are run in serial, +which is a waste on multiprocessor systems. For users with GNU Make and +a shell which performs brace expansion, you can run the testsuites in +parallel by having the shell perform the combinations and <samp><span class="command">make</span></samp> +do the parallel runs. Instead of using ‘<samp><span class="samp">--target_board</span></samp>’, use a +special makefile target: + +<pre class="smallexample"> make -j<var>N</var> check-<var>testsuite</var>//<var>test-target</var>/<var>option1</var>/<var>option2</var>/... +</pre> + <p>For example, + +<pre class="smallexample"> make -j3 check-gcc//sh-hms-sim/{-m1,-m2,-m3,-m3e,-m4}/{,-nofpu} +</pre> + <p>will run three concurrent “make-gcc” testsuites, eventually testing all +ten combinations as described above. Note that this is currently only +supported in the <samp><span class="file">gcc</span></samp> subdirectory. (To see how this works, try +typing <samp><span class="command">echo</span></samp> before the example given here.) + +<h3 class="section"><a name="TOC2"></a>0.3 Additional testing for Java Class Libraries</h3> + +<p>The Java runtime tests can be executed via ‘<samp><span class="samp">make check</span></samp>’ +in the <samp><var>target</var><span class="file">/libjava/testsuite</span></samp> directory in +the build tree. + + <p>The <a href="http://sourceware.org/mauve/">Mauve Project</a> provides +a suite of tests for the Java Class Libraries. This suite can be run +as part of libgcj testing by placing the Mauve tree within the libjava +testsuite at <samp><span class="file">libjava/testsuite/libjava.mauve/mauve</span></samp>, or by +specifying the location of that tree when invoking ‘<samp><span class="samp">make</span></samp>’, as in +‘<samp><span class="samp">make MAUVEDIR=~/mauve check</span></samp>’. + +<h3 class="section"><a name="TOC3"></a>0.4 How to interpret test results</h3> + +<p>The result of running the testsuite are various <samp><span class="file">*.sum</span></samp> and <samp><span class="file">*.log</span></samp> +files in the testsuite subdirectories. The <samp><span class="file">*.log</span></samp> files contain a +detailed log of the compiler invocations and the corresponding +results, the <samp><span class="file">*.sum</span></samp> files summarize the results. These summaries +contain status codes for all tests: + + <ul> +<li>PASS: the test passed as expected +<li>XPASS: the test unexpectedly passed +<li>FAIL: the test unexpectedly failed +<li>XFAIL: the test failed as expected +<li>UNSUPPORTED: the test is not supported on this platform +<li>ERROR: the testsuite detected an error +<li>WARNING: the testsuite detected a possible problem +</ul> + + <p>It is normal for some tests to report unexpected failures. At the +current time the testing harness does not allow fine grained control +over whether or not a test is expected to fail. This problem should +be fixed in future releases. + +<h3 class="section"><a name="TOC4"></a>0.5 Submitting test results</h3> + +<p>If you want to report the results to the GCC project, use the +<samp><span class="file">contrib/test_summary</span></samp> shell script. Start it in the <var>objdir</var> with + +<pre class="smallexample"> <var>srcdir</var>/contrib/test_summary -p your_commentary.txt \ + -m gcc-testresults@gcc.gnu.org |sh +</pre> + <p>This script uses the <samp><span class="command">Mail</span></samp> program to send the results, so +make sure it is in your <samp><span class="env">PATH</span></samp>. The file <samp><span class="file">your_commentary.txt</span></samp> is +prepended to the testsuite summary and should contain any special +remarks you have on your results or your build environment. Please +do not edit the testsuite result block or the subject line, as these +messages may be automatically processed. + + <p><hr /> +<p><a href="./index.html">Return to the GCC Installation page</a> + +<!-- ***Final install*********************************************************** --> +<!-- ***Binaries**************************************************************** --> +<!-- ***Specific**************************************************************** --> +<!-- ***Old documentation****************************************************** --> +<!-- ***GFDL******************************************************************** --> +<!-- *************************************************************************** --> +<!-- Part 6 The End of the Document --> +</body></html> + |