diff options
| author | Lorry Tar Creator <lorry-tar-importer@baserock.org> | 2015-04-22 10:21:45 +0000 |
|---|---|---|
| committer | <> | 2015-04-25 21:44:09 +0000 |
| commit | f80b5ea1605c9f9408c5aa386ba71c16d918ebbf (patch) | |
| tree | bb7eafaa81fc4b8c5c215bc08d517fd158db234a /INSTALL | |
| parent | c27a97d04853380f1e80525391b3f0d156ed4c84 (diff) | |
| download | gcc-tarball-f80b5ea1605c9f9408c5aa386ba71c16d918ebbf.tar.gz | |
Imported from /home/lorry/working-area/delta_gcc-tarball/gcc-5.1.0.tar.bz2.gcc-5.1.0
Diffstat (limited to 'INSTALL')
| -rw-r--r-- | INSTALL/README | 2 | ||||
| -rw-r--r-- | INSTALL/binaries.html | 2 | ||||
| -rw-r--r-- | INSTALL/build.html | 14 | ||||
| -rw-r--r-- | INSTALL/configure.html | 211 | ||||
| -rw-r--r-- | INSTALL/download.html | 2 | ||||
| -rw-r--r-- | INSTALL/finalinstall.html | 2 | ||||
| -rw-r--r-- | INSTALL/gfdl.html | 2 | ||||
| -rw-r--r-- | INSTALL/index.html | 4 | ||||
| -rw-r--r-- | INSTALL/old.html | 2 | ||||
| -rw-r--r-- | INSTALL/prerequisites.html | 28 | ||||
| -rw-r--r-- | INSTALL/specific.html | 113 | ||||
| -rw-r--r-- | INSTALL/test.html | 2 |
12 files changed, 277 insertions, 107 deletions
diff --git a/INSTALL/README b/INSTALL/README index 6d19791057..38574d3b76 100644 --- a/INSTALL/README +++ b/INSTALL/README @@ -1,4 +1,4 @@ -This directory has been obsoleted for GCC snapshots and CVS access. +This directory has been obsoleted for GCC snapshots and SVN access. For releases the installation documentation is generated from gcc/doc/install.texi and copied into this directory. diff --git a/INSTALL/binaries.html b/INSTALL/binaries.html index fb6c15abca..2f305f9b63 100644 --- a/INSTALL/binaries.html +++ b/INSTALL/binaries.html @@ -1,6 +1,6 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> -<!-- Copyright (C) 1988-2014 Free Software Foundation, Inc. +<!-- Copyright (C) 1988-2015 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.3 or diff --git a/INSTALL/build.html b/INSTALL/build.html index 1f7f22f046..3bc7d842a2 100644 --- a/INSTALL/build.html +++ b/INSTALL/build.html @@ -1,6 +1,6 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> -<!-- Copyright (C) 1988-2014 Free Software Foundation, Inc. +<!-- Copyright (C) 1988-2015 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.3 or @@ -238,7 +238,17 @@ examples of supported build configurations are: <dt>‘<samp>bootstrap-lto</samp>’</dt> <dd><p>Enables Link-Time Optimization for host tools during bootstrapping. ‘<samp>BUILD_CONFIG=bootstrap-lto</samp>’ is equivalent to adding -<samp>-flto</samp> to ‘<samp>BOOT_CFLAGS</samp>’. +<samp>-flto</samp> to ‘<samp>BOOT_CFLAGS</samp>’. This option assumes that the host +supports the linker plugin (e.g. GNU ld version 2.21 or later or GNU gold +version 2.21 or later). +</p> +</dd> +<dt>‘<samp>bootstrap-lto-noplugin</samp>’</dt> +<dd><p>This option is similar to <code>bootstrap-lto</code>, but is intended for +hosts that do not support the linker plugin. Without the linker plugin +static libraries are not compiled with link-time optimizations. Since +the GCC middle end and back end are in <samp>libbackend.a</samp> this means +that only the front end is actually LTO optimized. </p> </dd> <dt>‘<samp>bootstrap-debug</samp>’</dt> diff --git a/INSTALL/configure.html b/INSTALL/configure.html index e1c858775d..6ab1395a82 100644 --- a/INSTALL/configure.html +++ b/INSTALL/configure.html @@ -1,6 +1,6 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> -<!-- Copyright (C) 1988-2014 Free Software Foundation, Inc. +<!-- Copyright (C) 1988-2015 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.3 or @@ -443,7 +443,7 @@ code. machine code (with -fPIC), allowing it to be used within shared libraries, but yielding a slightly slower compiler. </p> -<p>Currently this option is only of use to people developing GCC itself. +<p>This option is required when building the libgccjit.so library. </p> <p>Contrast with <samp>--enable-shared</samp>, which affects <em>target</em> libraries. @@ -799,6 +799,38 @@ enables <samp>-msse2</samp> or ‘<samp>avx</samp>’ which enables <sam This option is only supported on i386 and x86-64 targets. </p> </dd> +<dt><code>--with-fp-32=<var>mode</var></code></dt> +<dd><p>On MIPS targets, set the default value for the <samp>-mfp</samp> option when using +the o32 ABI. The possibilities for <var>mode</var> are: +</p><dl compact="compact"> +<dt><code>32</code></dt> +<dd><p>Use the o32 FP32 ABI extension, as with the <samp>-mfp32</samp> command-line +option. +</p></dd> +<dt><code>xx</code></dt> +<dd><p>Use the o32 FPXX ABI extension, as with the <samp>-mfpxx</samp> command-line +option. +</p></dd> +<dt><code>64</code></dt> +<dd><p>Use the o32 FP64 ABI extension, as with the <samp>-mfp64</samp> command-line +option. +</p></dd> +</dl> +<p>In the absence of this configuration option the default is to use the o32 +FP32 ABI extension. +</p> +</dd> +<dt><code>--with-odd-spreg-32</code></dt> +<dd><p>On MIPS targets, set the <samp>-modd-spreg</samp> option by default when using +the o32 ABI. +</p> +</dd> +<dt><code>--without-odd-spreg-32</code></dt> +<dd><p>On MIPS targets, set the <samp>-mno-odd-spreg</samp> option by default when using +the o32 ABI. This is normally used in conjunction with +<samp>--with-fp-32=64</samp> in order to target the o32 FP64A ABI extension. +</p> +</dd> <dt><code>--with-nan=<var>encoding</var></code></dt> <dd><p>On MIPS targets, set the default encoding convention to use for the special not-a-number (NaN) IEEE 754 floating-point data. The @@ -963,6 +995,112 @@ parallel. This is currently supported by ‘<samp>libgfortran</samp>’ ‘<samp>libjava</samp>’, ‘<samp>libstdc++</samp>’, and ‘<samp>libobjc</samp>’. </p> </dd> +<dt><code><a name="WithAixSoname"></a>--with-aix-soname=‘<samp>aix</samp>’, ‘<samp>svr4</samp>’ or ‘<samp>both</samp>’</code></dt> +<dd><p>Traditional AIX shared library versioning (versioned <code>Shared Object</code> +files as members of unversioned <code>Archive Library</code> files named +‘<samp>lib.a</samp>’) causes numerous headaches for package managers. However, +<code>Import Files</code> as members of <code>Archive Library</code> files allow for +<strong>filename-based versioning</strong> of shared libraries as seen on Linux/SVR4, +where this is called the "SONAME". But as they prevent static linking, +<code>Import Files</code> may be used with <code>Runtime Linking</code> only, where the +linker does search for ‘<samp>libNAME.so</samp>’ before ‘<samp>libNAME.a</samp>’ library +filenames with the ‘<samp>-lNAME</samp>’ linker flag. +</p> +<a name="AixLdCommand"></a><p>For detailed information please refer to the AIX +<a href="http://www-01.ibm.com/support/knowledgecenter/search/%22the%20ld%20command%2C%20also%20called%20the%20linkage%20editor%20or%20binder%22">ld +Command</a> reference. +</p> +<p>As long as shared library creation is enabled, upon: +</p><dl compact="compact"> +<dt><code>--with-aix-soname=aix</code></dt> +<dt><code>--with-aix-soname=both</code></dt> +<dd><p>A (traditional AIX) <code>Shared Archive Library</code> file is created: + </p><ul> +<li> using the ‘<samp>libNAME.a</samp>’ filename scheme + </li><li> with the <code>Shared Object</code> file as archive member named + ‘<samp>libNAME.so.V</samp>’ (except for ‘<samp>libgcc_s</samp>’, where the <code>Shared + Object</code> file is named ‘<samp>shr.o</samp>’ for backwards compatibility), which + <ul class="no-bullet"> +<li>- is used for runtime loading from inside the ‘<samp>libNAME.a</samp>’ file + </li><li>- is used for dynamic loading via + <code>dlopen("libNAME.a(libNAME.so.V)", RTLD_MEMBER)</code> + </li><li>- is used for shared linking + </li><li>- is used for static linking, so no separate <code>Static Archive + Library</code> file is needed + </li></ul> +</li></ul> +</dd> +<dt><code>--with-aix-soname=both</code></dt> +<dt><code>--with-aix-soname=svr4</code></dt> +<dd><p>A (second) <code>Shared Archive Library</code> file is created: + </p><ul> +<li> using the ‘<samp>libNAME.so.V</samp>’ filename scheme + </li><li> with the <code>Shared Object</code> file as archive member named + ‘<samp>shr.o</samp>’, which + <ul class="no-bullet"> +<li>- is created with the <code>-G linker flag</code> + </li><li>- has the <code>F_LOADONLY</code> flag set + </li><li>- is used for runtime loading from inside the ‘<samp>libNAME.so.V</samp>’ file + </li><li>- is used for dynamic loading via <code>dlopen("libNAME.so.V(shr.o)", + RTLD_MEMBER)</code> + </li></ul> +</li><li> with the <code>Import File</code> as archive member named ‘<samp>shr.imp</samp>’, + which + <ul class="no-bullet"> +<li>- refers to ‘<samp>libNAME.so.V(shr.o)</samp>’ as the "SONAME", to be recorded + in the <code>Loader Section</code> of subsequent binaries + </li><li>- indicates whether ‘<samp>libNAME.so.V(shr.o)</samp>’ is 32 or 64 bit + </li><li>- lists all the public symbols exported by ‘<samp>lib.so.V(shr.o)</samp>’, + eventually decorated with the <code>‘<samp>weak</samp>’ Keyword</code> + </li><li>- is necessary for shared linking against ‘<samp>lib.so.V(shr.o)</samp>’ + </li></ul> +</li></ul> +<p>A symbolic link using the ‘<samp>libNAME.so</samp>’ filename scheme is created: + </p><ul> +<li> pointing to the ‘<samp>libNAME.so.V</samp>’ <code>Shared Archive Library</code> file + </li><li> to permit the <code>ld Command</code> to find ‘<samp>lib.so.V(shr.imp)</samp>’ via + the ‘<samp>-lNAME</samp>’ argument (requires <code>Runtime Linking</code> to be enabled) + </li><li> to permit dynamic loading of ‘<samp>lib.so.V(shr.o)</samp>’ without the need + to specify the version number via <code>dlopen("libNAME.so(shr.o)", + RTLD_MEMBER)</code> + </li></ul> +</dd> +</dl> + +<p>As long as static library creation is enabled, upon: +</p><dl compact="compact"> +<dt><code>--with-aix-soname=svr4</code></dt> +<dd><p>A <code>Static Archive Library</code> is created: + </p><ul> +<li> using the ‘<samp>libNAME.a</samp>’ filename scheme + </li><li> with all the <code>Static Object</code> files as archive members, which + <ul class="no-bullet"> +<li>- are used for static linking + </li></ul> +</li></ul> +</dd> +</dl> + +<p>While the aix-soname=‘<samp>svr4</samp>’ option does not create <code>Shared Object</code> +files as members of unversioned <code>Archive Library</code> files any more, package +managers still are responsible to +<a href="./specific.html#TransferAixShobj">transfer</a> <code>Shared Object</code> files +found as member of a previously installed unversioned <code>Archive Library</code> +file into the newly installed <code>Archive Library</code> file with the same +filename. +</p> +<p><em>WARNING:</em> Creating <code>Shared Object</code> files with <code>Runtime Linking</code> +enabled may bloat the TOC, eventually leading to <code>TOC overflow</code> errors, +requiring the use of either the <samp>-Wl,-bbigtoc</samp> linker flag (seen to +break with the <code>GDB</code> debugger) or some of the TOC-related compiler flags, +see “RS/6000 and PowerPC Options” in the main manual. +</p> +<p><samp>--with-aix-soname</samp> is currently supported by ‘<samp>libgcc_s</samp>’ only, so +this option is still experimental and not for normal use yet. +</p> +<p>Default is the traditional behaviour <samp>--with-aix-soname=‘<samp>aix</samp>’</samp>. +</p> +</dd> <dt><code>--enable-languages=<var>lang1</var>,<var>lang2</var>,…</code></dt> <dd><p>Specify that only a particular subset of compilers and their runtime libraries should be built. For a list of valid values for @@ -1026,7 +1164,8 @@ support for <code>libquadmath</code> on systems supporting it. </p> </dd> <dt><code>--disable-libgomp</code></dt> -<dd><p>Specify that the run-time libraries used by GOMP should not be built. +<dd><p>Specify that the GNU Offloading and Multi Processing Runtime Library +should not be built. </p> </dd> <dt><code>--disable-libvtv</code></dt> @@ -1269,21 +1408,13 @@ a cross compiler, they will not be used to configure target libraries. <dt><code>--with-isl=<var>pathname</var></code></dt> <dt><code>--with-isl-include=<var>pathname</var></code></dt> <dt><code>--with-isl-lib=<var>pathname</var></code></dt> -<dt><code>--with-cloog=<var>pathname</var></code></dt> -<dt><code>--with-cloog-include=<var>pathname</var></code></dt> -<dt><code>--with-cloog-lib=<var>pathname</var></code></dt> -<dd><p>If you do not have ISL and the CLooG -libraries installed in a standard location and you want to build GCC, -you can explicitly specify the directory where they are installed -(‘<samp>--with-isl=<var>islinstalldir</var></samp>’, -‘<samp>--with-cloog=<var>clooginstalldir</var></samp>’). The +<dd><p>If you do not have the ISL library installed in a standard location and you +want to build GCC, you can explicitly specify the directory where it is +installed (‘<samp>--with-isl=<var>islinstalldir</var></samp>’). The <samp>--with-isl=<var>islinstalldir</var></samp> option is shorthand for <samp>--with-isl-lib=<var>islinstalldir</var>/lib</samp> and -<samp>--with-isl-include=<var>islinstalldir</var>/include</samp>. Likewise the -<samp>--with-cloog=<var>clooginstalldir</var></samp> option is shorthand for -<samp>--with-cloog-lib=<var>clooginstalldir</var>/lib</samp> and -<samp>--with-cloog-include=<var>clooginstalldir</var>/include</samp>. If these -shorthand assumptions are not correct, you can use the explicit +<samp>--with-isl-include=<var>islinstalldir</var>/include</samp>. If this +shorthand assumption is not correct, you can use the explicit include and lib options directly. </p> <p>These flags are applicable to the host platform only. When building @@ -1355,12 +1486,42 @@ default for a toolchain with an assembler that accepts it and GLIBC 2.11 or above, otherwise disabled. </p> </dd> +<dt><code>--with-diagnostics-color=<var>choice</var></code></dt> +<dd><p>Tells GCC to use <var>choice</var> as the default for <samp>-fdiagnostics-color=</samp> +option (if not used explicitly on the command line). <var>choice</var> +can be one of ‘<samp>never</samp>’, ‘<samp>auto</samp>’, ‘<samp>always</samp>’, and ‘<samp>auto-if-env</samp>’ +where ‘<samp>auto</samp>’ is the default. ‘<samp>auto-if-env</samp>’ means that +<samp>-fdiagnostics-color=auto</samp> will be the default if <code>GCC_COLORS</code> +is present and non-empty in the environment, and +<samp>-fdiagnostics-color=never</samp> otherwise. +</p> +</dd> <dt><code>--enable-lto</code></dt> <dt><code>--disable-lto</code></dt> <dd><p>Enable support for link-time optimization (LTO). This is enabled by default, and may be disabled using <samp>--disable-lto</samp>. </p> </dd> +<dt><code>--enable-linker-plugin-configure-flags=FLAGS</code></dt> +<dt><code>--enable-linker-plugin-flags=FLAGS</code></dt> +<dd><p>By default, linker plugins (such as the LTO plugin) are built for the +host system architecture. For the case that the linker has a +different (but run-time compatible) architecture, these flags can be +specified to build plugins that are compatible to the linker. For +example, if you are building GCC for a 64-bit x86_64 +(‘<samp>x86_64-unknown-linux-gnu</samp>’) host system, but have a 32-bit x86 +GNU/Linux (‘<samp>i686-pc-linux-gnu</samp>’) linker executable (which is +executable on the former system), you can configure GCC as follows for +getting compatible linker plugins: +</p> +<div class="smallexample"> +<pre class="smallexample">% <var>srcdir</var>/configure \ + --host=x86_64-unknown-linux-gnu \ + --enable-linker-plugin-configure-flags=--host=i686-pc-linux-gnu \ + --enable-linker-plugin-flags='CC=gcc\ -m32\ -Wl,-rpath,[...]/i686-pc-linux-gnu/lib' +</pre></div> + +</dd> <dt><code>--with-plugin-ld=<var>pathname</var></code></dt> <dd><p>Enable an alternate linker to be used at link-time optimization (LTO) link time when <samp>-fuse-linker-plugin</samp> is enabled. @@ -1389,7 +1550,23 @@ available for building the initial bootstrap compiler. do not, this option applies only to the multilibs that use glibc. However, such configurations may not work well as not all the relevant configuration in GCC is on a per-multilib basis. -</p></dd> +</p> +</dd> +<dt><code>--enable-as-accelerator-for=<var>target</var></code></dt> +<dd><p>Build as offload target compiler. Specify offload host triple by <var>target</var>. +</p> +</dd> +<dt><code>--enable-offload-targets=<var>target1</var>[=<var>path1</var>],…,<var>targetN</var>[=<var>pathN</var>]</code></dt> +<dd><p>Enable offloading to targets <var>target1</var>, …, <var>targetN</var>. +Offload compilers are expected to be already installed. Default search +path for them is <samp><var>exec-prefix</var></samp>, but it can be changed by +specifying paths <var>path1</var>, …, <var>pathN</var>. +</p> +<div class="smallexample"> +<pre class="smallexample">% <var>srcdir</var>/configure \ + --enable-offload-target=i686-unknown-linux-gnu=/path/to/i686/compiler,x86_64-pc-linux-gnu +</pre></div> +</dd> </dl> <a name="Cross_002dCompiler_002dSpecific-Options"></a> diff --git a/INSTALL/download.html b/INSTALL/download.html index 40847edff1..650929cf50 100644 --- a/INSTALL/download.html +++ b/INSTALL/download.html @@ -1,6 +1,6 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> -<!-- Copyright (C) 1988-2014 Free Software Foundation, Inc. +<!-- Copyright (C) 1988-2015 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.3 or diff --git a/INSTALL/finalinstall.html b/INSTALL/finalinstall.html index 9f592e4d5d..d5b7f80a38 100644 --- a/INSTALL/finalinstall.html +++ b/INSTALL/finalinstall.html @@ -1,6 +1,6 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> -<!-- Copyright (C) 1988-2014 Free Software Foundation, Inc. +<!-- Copyright (C) 1988-2015 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.3 or diff --git a/INSTALL/gfdl.html b/INSTALL/gfdl.html index d87a789112..02477a0a6a 100644 --- a/INSTALL/gfdl.html +++ b/INSTALL/gfdl.html @@ -1,6 +1,6 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> -<!-- Copyright (C) 1988-2014 Free Software Foundation, Inc. +<!-- Copyright (C) 1988-2015 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.3 or diff --git a/INSTALL/index.html b/INSTALL/index.html index 2812c77e18..85c96d3d34 100644 --- a/INSTALL/index.html +++ b/INSTALL/index.html @@ -1,6 +1,6 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> -<!-- Copyright (C) 1988-2014 Free Software Foundation, Inc. +<!-- Copyright (C) 1988-2015 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.3 or @@ -126,7 +126,7 @@ not yet been merged into the main part of this manual. <hr /> <p><p><a href="./index.html">Return to the GCC Installation page</a> </p> -<p>Copyright © 1988-2014 Free Software Foundation, Inc. +<p>Copyright © 1988-2015 Free Software Foundation, Inc. </p><br> <p>Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or diff --git a/INSTALL/old.html b/INSTALL/old.html index 9891930ada..bf73bac62b 100644 --- a/INSTALL/old.html +++ b/INSTALL/old.html @@ -1,6 +1,6 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> -<!-- Copyright (C) 1988-2014 Free Software Foundation, Inc. +<!-- Copyright (C) 1988-2015 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.3 or diff --git a/INSTALL/prerequisites.html b/INSTALL/prerequisites.html index 3b9cf58c94..baa373a91b 100644 --- a/INSTALL/prerequisites.html +++ b/INSTALL/prerequisites.html @@ -1,6 +1,6 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> -<!-- Copyright (C) 1988-2014 Free Software Foundation, Inc. +<!-- Copyright (C) 1988-2015 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.3 or @@ -247,7 +247,7 @@ installed but it is not in your default library search path, the <samp>--with-mpc-lib</samp> and <samp>--with-mpc-include</samp>. </p> </dd> -<dt>ISL Library version 0.12.2</dt> +<dt>ISL Library version 0.14 (or 0.12.2)</dt> <dd> <p>Necessary to build GCC with the Graphite loop optimizations. It can be downloaded from <a href="ftp://gcc.gnu.org/pub/gcc/infrastructure/">ftp://gcc.gnu.org/pub/gcc/infrastructure/</a> @@ -258,22 +258,6 @@ option should be used if ISL is not installed in your default library search path. </p> </dd> -<dt>CLooG 0.18.1</dt> -<dd> -<p>Necessary to build GCC with the Graphite loop optimizations. It can be -downloaded from <a href="ftp://gcc.gnu.org/pub/gcc/infrastructure/">ftp://gcc.gnu.org/pub/gcc/infrastructure/</a> as -<samp>cloog-0.18.1.tar.gz</samp>. If a CLooG source distribution is found -in a subdirectory of your GCC sources named <samp>cloog</samp>, it will be -built together with GCC. Alternatively, the <samp>--with-cloog</samp> configure -option should be used if CLooG is not installed in your default library search -path. -</p> -<p>If you want to install CLooG separately it needs to be built against -ISL 0.12.2 by using the <samp>--with-isl=system</samp> to direct CLooG to pick -up an already installed ISL. Using the ISL library as bundled with CLooG -is not supported. -</p> -</dd> </dl> <a name="Tools_002fpackages-necessary-for-modifying-GCC"></a> @@ -322,7 +306,7 @@ to the latest released version. details. Tcl 8.6 has a known regression in RE pattern handling that make parts of the testsuite fail. See <a href="http://core.tcl.tk/tcl/tktview/267b7e2334ee2e9de34c4b00d6e72e2f1997085f">http://core.tcl.tk/tcl/tktview/267b7e2334ee2e9de34c4b00d6e72e2f1997085f</a> -for more information. +for more information. This bug has been fixed in 8.6.1. </p> </dd> <dt>autogen version 5.5.4 (or later) and</dt> @@ -367,6 +351,12 @@ are used when running <code>make dvi</code> or <code>make pdf</code> to create DVI or PDF files, respectively. </p> </dd> +<dt>Sphinx version 1.0 (or later)</dt> +<dd> +<p>Necessary to regenerate <samp>jit/docs/_build/texinfo</samp> from the <samp>.rst</samp> +files in the directories below <samp>jit/docs</samp>. +</p> +</dd> <dt>SVN (any version)</dt> <dt>SSH (any version)</dt> <dd> diff --git a/INSTALL/specific.html b/INSTALL/specific.html index f85373a52a..eb407cda47 100644 --- a/INSTALL/specific.html +++ b/INSTALL/specific.html @@ -1,6 +1,6 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> -<!-- Copyright (C) 1988-2014 Free Software Foundation, Inc. +<!-- Copyright (C) 1988-2015 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.3 or @@ -102,7 +102,8 @@ here, only the ones that require host-specific or target-specific information have to. </p> <ul> -<li> <a href="#alpha-x-x">alpha*-*-*</a> +<li> <a href="#aarch64-x-x">aarch64*-*-*</a> +</li><li> <a href="#alpha-x-x">alpha*-*-*</a> </li><li> <a href="#alpha-dec-osf51">alpha*-dec-osf5.1</a> </li><li> <a href="#amd64-x-solaris210">amd64-*-solaris2.10</a> </li><li> <a href="#arm-x-eabi">arm-*-eabi</a> @@ -116,7 +117,6 @@ information have to. </li><li> <a href="#hppa-hp-hpux11">hppa*-hp-hpux11</a> </li><li> <a href="#x-x-linux-gnu">*-*-linux-gnu</a> </li><li> <a href="#ix86-x-linux">i?86-*-linux*</a> -</li><li> <a href="#ix86-x-solaris289">i?86-*-solaris2.9</a> </li><li> <a href="#ix86-x-solaris210">i?86-*-solaris2.10</a> </li><li> <a href="#ia64-x-linux">ia64-*-linux</a> </li><li> <a href="#ia64-x-hpux">ia64-*-hpux*</a> @@ -135,6 +135,7 @@ information have to. </li><li> <a href="#mips-sgi-irix6">mips-sgi-irix6</a> </li><li> <a href="#nds32le-x-elf">nds32le-*-elf</a> </li><li> <a href="#nds32be-x-elf">nds32be-*-elf</a> +</li><li> <a href="#nvptx-x-none">nvptx-*-none</a> </li><li> <a href="#powerpc-x-x">powerpc*-*-*</a> </li><li> <a href="#powerpc-x-darwin">powerpc-*-darwin*</a> </li><li> <a href="#powerpc-x-elf">powerpc-*-elf</a> @@ -159,6 +160,7 @@ information have to. </li><li> <a href="#tilegx-x-linux">tilegx-*-linux*</a> </li><li> <a href="#tilegxbe-x-linux">tilegxbe-*-linux*</a> </li><li> <a href="#tilepro-x-linux">tilepro-*-linux*</a> +</li><li> <a href="#visium-x-elf">visium-*-elf</a> </li><li> <a href="#x-x-vxworks">*-*-vxworks*</a> </li><li> <a href="#x86-64-x-x">x86_64-*-*, amd64-*-*</a> </li><li> <a href="#x86-64-x-solaris210">x86_64-*-solaris2.1[0-9]*</a> @@ -178,6 +180,22 @@ information have to. <!-- -------- host/target specific issues start here ---------------- --> +<hr /><a name="aarch64_002dx_002dx"></a><a name="aarch64_002a_002d_002a_002d_002a"></a> +<h3 class="heading">aarch64*-*-*</h3> +<p>Binutils pre 2.24 does not have support for selecting <samp>-mabi</samp> and +does not support ILP32. If it is used to build GCC 4.9 or later, GCC will +not support option <samp>-mabi=ilp32</samp>. +</p> +<p>To enable a workaround for the Cortex-A53 erratum number 835769 by default +(for all CPUs regardless of -mcpu option given) at configure time use the +<samp>--enable-fix-cortex-a53-835769</samp> option. This will enable the fix by +default and can be explicitly disabled during during compilation by passing the +<samp>-mno-fix-cortex-a53-835769</samp> option. Conversely, +<samp>--disable-fix-cortex-a53-835769</samp> will disable the workaround by +default. The workaround is disabled by default if neither of +<samp>--enable-fix-cortex-a53-835769</samp> or +<samp>--disable-fix-cortex-a53-835769</samp> is given at configure time. +</p> <hr /><a name="alpha_002dx_002dx"></a><a name="alpha_002a_002d_002a_002d_002a"></a> <h3 class="heading">alpha*-*-*</h3> <p>This section contains general configuration information for all @@ -542,23 +560,6 @@ See <a href="http://gcc.gnu.org/PR10877">bug 10877</a> for more information. 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 /><a name="ix86_002dx_002dsolaris29"></a><a name="i_003f86_002d_002a_002dsolaris2_002e9"></a> -<h3 class="heading">i?86-*-solaris2.9</h3> -<p>The Sun assembler in Solaris 9 has several bugs and limitations. -While GCC works around them, several features are missing, so it is -recommended to use the GNU assembler instead. There is no bundled -version, but the current version, from GNU binutils 2.22, is known to -work. -</p> -<p>Solaris 2/x86 doesn’t support the execution of SSE/SSE2 instructions -before Solaris 9 4/04, even if the CPU supports them. Programs will -receive <code>SIGILL</code> if they try. The fix is available both in -Solaris 9 Update 6 and kernel patch 112234-12 or newer. To -avoid this problem, -<samp>-march</samp> defaults to ‘<samp>pentiumpro</samp>’ on Solaris 9. If -you have the patch installed, you can configure GCC with an appropriate -<samp>--with-arch</samp> option, but need GNU <code>as</code> for SSE2 support. -</p> <hr /><a name="ix86_002dx_002dsolaris210"></a><a name="i_003f86_002d_002a_002dsolaris2_002e10"></a> <h3 class="heading">i?86-*-solaris2.10</h3> <p>Use this for Solaris 10 or later on x86 and x86-64 systems. Starting @@ -614,22 +615,6 @@ is required to build GCC. For GCC 3.3 and later, this is the default. For gcc 3.4.3 and later, <samp>--enable-libunwind-exceptions</samp> is removed and the system libunwind library will always be used. </p> -<hr /><a name="aarch64_002dx_002dx"></a><a name="aarch64_002a_002d_002a_002d_002a"></a> -<h3 class="heading">aarch64*-*-*</h3> -<p>Binutils pre 2.24 does not have support for selecting <samp>-mabi</samp> and -does not support ILP32. If it is used to build GCC 4.9 or later, GCC will -not support option <samp>-mabi=ilp32</samp>. -</p> -<p>To enable a workaround for the Cortex-A53 erratum number 835769 by default -(for all CPUs regardless of -mcpu option given) at configure time use the -<samp>--enable-fix-cortex-a53-835769</samp> option. This will enable the fix by -default and can be explicitly disabled during during compilation by passing the -<samp>-mno-fix-cortex-a53-835769</samp> option. Conversely, -<samp>--disable-fix-cortex-a53-835769</samp> will disable the workaround by -default. The workaround is disabled by default if neither of -<samp>--enable-fix-cortex-a53-835769</samp> or -<samp>--disable-fix-cortex-a53-835769</samp> is given at configure time. -</p> <hr /> <!-- rs6000-ibm-aix*, powerpc-ibm-aix* --><a name="x_002dibm_002daix"></a><a name="g_t_002a_002dibm_002daix_002a"></a> <h3 class="heading">*-ibm-aix*</h3> @@ -702,7 +687,7 @@ 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 as APAR IY54774 (AIX 5.1) </p> -<p>‘<samp>libstdc++</samp>’ in GCC 3.4 increments the major version number of the +<a name="TransferAixShobj"></a><p>‘<samp>libstdc++</samp>’ in GCC 3.4 increments the major version number of the shared object and GCC installation places the <samp>libstdc++.a</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 @@ -732,6 +717,11 @@ available for runtime dynamic loading, but not linking: <pre class="smallexample">% ar -q libstdc++.a libstdc++.so.4 libstdc++.so.5 </pre></div> +<p>Eventually, the +<a href="./configure.html#WithAixSoname"><samp>--with-aix-soname=svr4</samp></a> +configure option may drop the need for this procedure for libraries that +support it. +</p> <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 @@ -923,6 +913,24 @@ This configuration is intended for embedded systems. <h3 class="heading">nds32be-*-elf</h3> <p>Andes NDS32 target in big endian mode. </p> +<hr /><a name="nvptx_002dx_002dnone"></a><a name="nvptx_002d_002a_002dnone"></a> +<h3 class="heading">nvptx-*-none</h3> +<p>Nvidia PTX target. +</p> +<p>Instead of GNU binutils, you will need to install +<a href="https://github.com/MentorEmbedded/nvptx-tools/">nvptx-tools</a>. +Tell GCC where to find it: +<samp>--with-build-time-tools=[install-nvptx-tools]/nvptx-none/bin</samp>. +</p> +<p>A nvptx port of newlib is available at +<a href="https://github.com/MentorEmbedded/nvptx-newlib/">nvptx-newlib</a>. +It can be automatically built together with GCC. For this, add a +symbolic link to nvptx-newlib’s <samp>newlib</samp> directory to the +directory containing the GCC sources. +</p> +<p>Use the <samp>--disable-sjlj-exceptions</samp> and +<samp>--enable-newlib-io-long-long</samp> options when configuring. +</p> <hr /><a name="powerpc_002dx_002dx"></a><a name="powerpc_002d_002a_002d_002a"></a> <h3 class="heading">powerpc-*-*</h3> <p>You can specify a default version for the <samp>-mcpu=<var>cpu_type</var></samp> @@ -1006,10 +1014,9 @@ supported as cross-compilation target only. </p> <hr /><a name="x_002dx_002dsolaris2"></a><a name="g_t_002a_002d_002a_002dsolaris2_002a"></a> <h3 class="heading">*-*-solaris2*</h3> -<p>Support for Solaris 9 has been obsoleted in GCC 4.9, but can still be -enabled by configuring with <samp>--enable-obsolete</samp>. Support will be -removed in GCC 4.10. Support for Solaris 8 has removed in GCC 4.8. -Support for Solaris 7 has been removed in GCC 4.6. +<p>Support for Solaris 9 has been removed in GCC 4.10. Support for Solaris +8 has been removed in GCC 4.8. Support for Solaris 7 has been removed +in GCC 4.6. </p> <p>Sun does not ship a C compiler with Solaris 2 before Solaris 10, though you can download the Sun Studio compilers for free. In Solaris 10 and @@ -1087,25 +1094,6 @@ program which is used only by the GCC testsuite driver. When the bug causes the <code>expect</code> program to miss anticipated output, extra testsuite failures appear. </p> -<p>There are patches for Solaris 9 (117171-11 or newer for -SPARC, 117172-11 or newer for Intel) that address this problem. -</p> -<p>Thread-local storage (TLS) is supported in Solaris 9, but requires -some patches. The ‘<samp>libthread</samp>’ patches provide the -<code>__tls_get_addr</code> (SPARC, 64-bit x86) resp. <code>___tls_get_addr</code> -(32-bit x86) functions. On Solaris 9, the necessary support -on SPARC is present since FCS, while 114432-05 or newer is required on -Intel. Additionally, on Solaris 9/x86, patch 113986-02 or newer is -required for the Sun <code>ld</code> and runtime linker (<code>ld.so.1</code>) -support, while Solaris 9/SPARC works since FCS. The linker -patches must be installed even if GNU <code>ld</code> is used. Sun -<code>as</code> in Solaris 9 doesn’t support the necessary -relocations, so GNU <code>as</code> must be used. The <code>configure</code> -script checks for those prerequisites and automatically enables TLS -support if they are met. Although those minimal patch versions should -work, it is recommended to use the latest patch versions which include -additional bug fixes. -</p> <hr /><a name="sparc_002dx_002dx"></a><a name="sparc_002a_002d_002a_002d_002a"></a> <h3 class="heading">sparc*-*-*</h3> <p>This section contains general configuration information for all @@ -1240,6 +1228,11 @@ port requires binutils-2.23 or newer. <p>The TILEPro processor running GNU/Linux. This port requires binutils-2.22 or newer. </p> +<hr /><a name="visium_002dx_002delf"></a><a name="visium_002d_002a_002delf"></a> +<h3 class="heading">visium-*-elf</h3> +<p>CDS VISIUMcore processor. +This configuration is intended for embedded systems. +</p> <hr /><a name="x_002dx_002dvxworks"></a><a name="g_t_002a_002d_002a_002dvxworks_002a"></a> <h3 class="heading">*-*-vxworks*</h3> <p>Support for VxWorks is in flux. At present GCC supports <em>only</em> the diff --git a/INSTALL/test.html b/INSTALL/test.html index 3cd3ad5741..b9a49cf1b1 100644 --- a/INSTALL/test.html +++ b/INSTALL/test.html @@ -1,6 +1,6 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> -<!-- Copyright (C) 1988-2014 Free Software Foundation, Inc. +<!-- Copyright (C) 1988-2015 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.3 or |