From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: by sourceware.org (Postfix, from userid 1147) id 3D3D33858D28; Mon, 24 Apr 2023 11:39:48 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 3D3D33858D28 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gcc.gnu.org; s=default; t=1682336388; bh=pTO6A3GGz1JM7+5FAhikr7AFhXSgtbCMaEoPvDg+3nY=; h=From:To:Subject:Date:From; b=ck91Hk6mPyjbrRU1veh8CDWx1cCUYlxCQXgl3EUpdebvvsGZEHiiLPLEwjmvXaZdG suZiHsPq46qnMfW9bIjtGpSD17kdlSz2dEz8rKm+jinBX/kl1BNq2jsTTOHqxGkRxW JpnufCAOzI6Gl7QtcWfFHHoXnsmoFsUxWpwXdhCk= MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset="utf-8" From: Rainer Orth To: gcc-cvs@gcc.gnu.org Subject: [gcc r13-7237] doc: Update install.texi for GCC 13 X-Act-Checkin: gcc X-Git-Author: Rainer Orth X-Git-Refname: refs/heads/releases/gcc-13 X-Git-Oldrev: f743863e09ad788b044dd01696b073581116843b X-Git-Newrev: 1cf9c91e9fe6d3e24b24adace56e2568677d4fd7 Message-Id: <20230424113948.3D3D33858D28@sourceware.org> Date: Mon, 24 Apr 2023 11:39:48 +0000 (GMT) List-Id: https://gcc.gnu.org/g:1cf9c91e9fe6d3e24b24adace56e2568677d4fd7 commit r13-7237-g1cf9c91e9fe6d3e24b24adace56e2568677d4fd7 Author: Rainer Orth Date: Mon Apr 24 11:56:37 2023 +0200 doc: Update install.texi for GCC 13 install.texi needs some updates for GCC 13 and trunk: * We used a mixture of Solaris 2 and Solaris references. Since Solaris 1/SunOS 4 is ancient history by now, consistently use Solaris everywhere. Likewise, explicit references to Solaris 11 can go in many places since Solaris 11.3 and 11.4 is all GCC supports. * Some caveats apply to both Solaris/SPARC and x86, like the difference between as and gas. * Some specifics are obsolete, like the /usr/ccs/bin path whose contents was merged into /usr/bin in Solaris 11.0 already. Likewise, /bin/sh is ksh93 since Solaris 11.0, so there's no need to explicitly use /bin/ksh. * I've removed the reference to OpenCSW: there's barely a need for external sites to get additional packages. OpenCSW is mostly unmaintained these days and has been found to be rather harmful then helping. * The section on assembler and linker to use was partially duplicated. Better keep the info in one place. * GNAT is bundled in recent Solaris 11.4 updates, so recommend that. Tested on i386-pc-solaris2.11 with make doc/gccinstall.{info,pdf} and inspection of the latter. 2023-04-21 Rainer Orth gcc: * doc/install.texi: Consistently use Solaris rather than Solaris 2. Remove explicit Solaris 11 references. Markup fixes. (Options specification, --with-gnu-as): as and gas always differ on Solaris. Remove /usr/ccs/bin reference. (Installing GCC: Binaries, Solaris (SPARC, Intel)): Remove. (i?86-*-solaris2*): Merge assembler, linker recommendations ... (*-*-solaris2*): ... here. Update bundled GCC versions. Don't refer to pre-built binaries. Remove /bin/sh warning. Update assembler, linker recommendations. Document GNAT bootstrap compiler. (sparc-sun-solaris2*): Remove non-UltraSPARC reference. (sparc64-*-solaris2*): Move content... (sparcv9-*-solaris2*): ...here. Add GDC for 64-bit bootstrap compilers. Diff: --- gcc/doc/install.texi | 187 +++++++++++++++++++++------------------------------ 1 file changed, 78 insertions(+), 109 deletions(-) diff --git a/gcc/doc/install.texi b/gcc/doc/install.texi index b13bc122513..928fc6b6d4b 100644 --- a/gcc/doc/install.texi +++ b/gcc/doc/install.texi @@ -370,7 +370,7 @@ systems' @command{tar} programs will also work, only try GNU Necessary when targeting Darwin, building @samp{libstdc++}, and not using @option{--disable-symvers}. -Necessary when targeting Solaris 2 with Solaris @command{ld} and not using +Necessary when targeting Solaris with Solaris @command{ld} and not using @option{--disable-symvers}. Necessary when regenerating @file{Makefile} dependencies in libiberty. @@ -1098,8 +1098,7 @@ whether you use the GNU assembler. On any other system, @itemize @bullet @item @samp{hppa1.0-@var{any}-@var{any}} @item @samp{hppa1.1-@var{any}-@var{any}} -@item @samp{sparc-sun-solaris2.@var{any}} -@item @samp{sparc64-@var{any}-solaris2.@var{any}} +@item @samp{*-*-solaris2.11} @end itemize @item @anchor{with-as}--with-as=@var{pathname} @@ -1114,13 +1113,12 @@ Unless GCC is being built with a cross compiler, check the @var{exec-prefix} defaults to @var{prefix}, which defaults to @file{/usr/local} unless overridden by the @option{--prefix=@var{pathname}} switch described above. @var{target} -is the target system triple, such as @samp{sparc-sun-solaris2.7}, and +is the target system triple, such as @samp{sparc-sun-solaris2.11}, and @var{version} denotes the GCC version, such as 3.0. @item If the target system is the same that you are building on, check -operating system specific directories (e.g.@: @file{/usr/ccs/bin} on -Solaris 2). +operating system specific directories. @item Check in the @env{PATH} for a tool whose name is prefixed by the @@ -3570,13 +3568,6 @@ HP-UX: @uref{http://hpux.connect.org.uk/,,HP-UX Porting Center}; @end itemize -@item -Solaris 2 (SPARC, Intel): -@itemize -@item -@uref{https://www.opencsw.org/,,OpenCSW} -@end itemize - @item macOS: @itemize @@ -3799,7 +3790,7 @@ information have to. @itemize @item -@uref{#elf,,all ELF targets} (SVR4, Solaris 2, etc.) +@uref{#elf,,all ELF targets} (SVR4, Solaris, etc.) @end itemize @end ifhtml @@ -4263,24 +4254,6 @@ with GCC 4.7, there is also a 64-bit @samp{amd64-*-solaris2*} or @samp{x86_64-*-solaris2*} configuration that corresponds to @samp{sparcv9-sun-solaris2*}. -It is recommended that you configure GCC to use the GNU assembler. The -versions included in Solaris 11.3, from GNU binutils 2.23.1 or -newer (available as @file{/usr/bin/gas} and -@file{/usr/gnu/bin/as}), work fine. The current version, from GNU -binutils 2.34, is known to work. Recent versions of the Solaris assembler in -@file{/usr/bin/as} work almost as well, though. - -For linking, the Solaris linker is preferred. If you want to use the GNU -linker instead, the version in Solaris 11.3, from GNU binutils 2.23.1 or -newer (in @file{/usr/gnu/bin/ld} and @file{/usr/bin/gld}), works, -as does the latest version, from GNU binutils 2.34. - -To use GNU @command{as}, configure with the options -@option{--with-gnu-as --with-as=@//usr/@/gnu/@/bin/@/as}. It may be necessary -to configure with @option{--without-gnu-ld --with-ld=@//usr/@/ccs/@/bin/@/ld} to -guarantee use of Solaris @command{ld}. -@c FIXME: why --without-gnu-ld --with-ld? - @html
@end html @@ -4883,10 +4856,6 @@ supported as cross-compilation target only. @html
@end html -@c Please use Solaris 2 to refer to all release of Solaris, starting -@c with 2.0 until 2.6, 7, 8, etc. Solaris 1 was a marketing name for -@c SunOS 4 releases which we don't use to avoid confusion. Solaris -@c alone is too unspecific and must be avoided. @anchor{x-x-solaris2} @heading *-*-solaris2* Support for Solaris 11.3 and earlier has been obsoleted in GCC 13, but @@ -4896,60 +4865,63 @@ Support for Solaris 10 has been removed in GCC 10. Support for Solaris GCC 4.8. Support for Solaris 7 has been removed in GCC 4.6. Solaris 11.3 provides GCC 4.5.2, 4.7.3, and 4.8.2 as -@command{/usr/gcc/4.5/bin/gcc} or similar. Newer Solaris versions -provide one or more of GCC 5, 7, and 9. Alternatively, -you can install a pre-built GCC to bootstrap and install GCC. See the -@uref{binaries.html,,binaries page} for details. - -The Solaris 2 @command{/bin/sh} will often fail to configure -@samp{libstdc++-v3}. We therefore recommend using the -following initial sequence of commands - -@smallexample -% CONFIG_SHELL=/bin/ksh -% export CONFIG_SHELL -@end smallexample - -@noindent -and proceed as described in @uref{configure.html,,the configure instructions}. -In addition we strongly recommend specifying an absolute path to invoke -@command{@var{srcdir}/configure}. +@command{/usr/gcc/4.5/bin/gcc} or similar. Solaris 11.4 +provides one or more of GCC 5, 7, 9, 10, 11, and 12. -In Solaris 11, you need to check for @code{system/header}, -@code{system/linker}, and @code{developer/assembler} packages. +You need to install the @code{system/header}, @code{system/linker}, and +@code{developer/assembler} packages. -Trying to use the linker and other tools in -@file{/usr/ucb} to install GCC has been observed to cause trouble. -For example, the linker may hang indefinitely. The fix is to remove -@file{/usr/ucb} from your @env{PATH}. +Trying to use the compatibility tools in @file{/usr/ucb}, from the +@code{compatibility/ucb} package, to install GCC has been observed to +cause trouble. The fix is to remove @file{/usr/ucb} from your +@env{PATH}. -The build process works more smoothly with the legacy Solaris tools so, if you -have @file{/usr/xpg4/bin} in your @env{PATH}, we recommend that you place -@file{/usr/bin} before @file{/usr/xpg4/bin} for the duration of the build. +@c FIXME: Still? Prefer /usr/gnu/bin instead? +The build process works more smoothly with the legacy Solaris tools so, +if you have @file{/usr/xpg4/bin} in your @env{PATH}, we recommend that +you place @file{/usr/bin} before @file{/usr/xpg4/bin} for the duration +of the build. We recommend the use of the Solaris assembler or the GNU assembler, in -conjunction with the Solaris linker. The GNU @command{as} -versions included in Solaris 11.3, -from GNU binutils 2.23.1 or newer (in @file{/usr/bin/gas} and -@file{/usr/gnu/bin/as}), are known to work. -The current version, from GNU binutils 2.34, -is known to work as well. Note that your mileage may vary -if you use a combination of the GNU tools and the Solaris tools: while the -combination GNU @command{as} + Solaris @command{ld} should reasonably work, -the reverse combination Solaris @command{as} + GNU @command{ld} may fail to -build or cause memory corruption at runtime in some cases for C++ programs. +conjunction with the Solaris linker. + +The GNU @command{as} versions included in Solaris 11.3, from GNU +binutils 2.23.1 or newer (in @file{/usr/bin/gas} and +@file{/usr/gnu/bin/as}), are known to work. The version from GNU +binutils 2.40 is known to work as well. Recent versions of the Solaris +assembler in @file{/usr/bin/as} work almost as well, though. To use GNU +@command{as}, configure with the options @option{--with-gnu-as +--with-as=@//usr/@/gnu/@/bin/@/as}. + +For linking, the Solaris linker is preferred. If you want to use the +GNU linker instead, the version in Solaris 11.3, from GNU binutils +2.23.1 or newer (in @file{/usr/gnu/bin/ld} and @file{/usr/bin/gld}), +works, as does the version from GNU binutils 2.40. However, it +generally lacks platform specific features, so better stay with Solaris +@command{ld}. To use the LTO linker plugin +(@option{-fuse-linker-plugin}) with GNU @command{ld}, GNU binutils +@emph{must} be configured with @option{--enable-largefile}. To use +Solaris @command{ld}, we recommend to configure with +@option{--without-gnu-ld --with-ld=@//usr/@/bin/@/ld} to guarantee the +right linker is found irrespective of the user's @env{PATH}. + +Note that your mileage may vary if you use a combination of the GNU +tools and the Solaris tools: while the combination GNU @command{as} and +Solaris @command{ld} works well, the reverse combination Solaris +@command{as} with GNU @command{ld} may fail to build or cause memory +corruption at runtime in some cases for C++ programs. @c FIXME: still? -GNU @command{ld} usually works as well. Again, the current -version (2.34) is known to work, but generally lacks platform specific -features, so better stay with Solaris @command{ld}. To use the LTO linker -plugin (@option{-fuse-linker-plugin}) with GNU @command{ld}, GNU -binutils @emph{must} be configured with @option{--enable-largefile}. - -To enable symbol versioning in @samp{libstdc++} with the Solaris linker, -you need to have any version of GNU @command{c++filt}, which is part of -GNU binutils. @samp{libstdc++} symbol versioning will be disabled if no -appropriate version is found. Solaris @command{c++filt} from the Solaris -Studio compilers does @emph{not} work. + +To enable symbol versioning in @samp{libstdc++} and other runtime +libraries with the Solaris linker, you need to have any version of GNU +@command{c++filt}, which is part of GNU binutils. Symbol versioning +will be disabled if no appropriate version is found. Solaris +@command{c++filt} from the Solaris Studio compilers does @emph{not} +work. + +In order to build the GNU Ada compiler, GNAT, a working GNAT is needed. +Since Solaris 11.4 SRU 39, GNAT 11 or 12 is bundled in the +@code{developer/gcc/gcc-gnat} package. In order to build the GNU D compiler, GDC, a working @samp{libphobos} is needed. That library wasn't built by default in GCC 9--11 on SPARC, or @@ -5001,19 +4973,16 @@ information. 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 @option{-m64} option enables 64-bit code generation. -However, if all you want is code tuned for the UltraSPARC CPU, you -should try the @option{-mtune=ultrasparc} option instead, which produces -code that, unlike full 64-bit code, can still run on non-UltraSPARC -machines. When configuring the GNU Multiple Precision Library (GMP), the MPFR -library or the MPC library on a Solaris 7 or later system, the canonical -target triplet must be specified as the @command{build} parameter on the -configure line. This target triplet can be obtained by invoking @command{./config.guess} in the toplevel source directory of GCC (and -not that of GMP or MPFR or MPC). For example on a Solaris 11 system: +library or the MPC library on Solaris, the canonical target triplet must +be specified as the @command{build} parameter on the @command{configure} +line. This target triplet can be obtained by invoking +@command{./config.guess} in the toplevel source directory of GCC (and +not that of GMP or MPFR or MPC). For example: @smallexample -% ./configure --build=sparc-sun-solaris2.11 --prefix=xxx +% @var{srcdir}/configure --build=sparc-sun-solaris2.11 --prefix=@var{dirname} @end smallexample @html @@ -5027,29 +4996,29 @@ not that of GMP or MPFR or MPC). For example on a Solaris 11 system: @end html @anchor{sparc64-x-solaris2} @heading sparc64-*-solaris2* +This is a synonym for @samp{sparcv9-*-solaris2*}. + +@html +
+@end html +@anchor{sparcv9-x-solaris2} +@heading sparcv9-*-solaris2* + When configuring a 64-bit-default GCC on Solaris/SPARC, you must use a build compiler that generates 64-bit code, either by default or by -specifying @samp{CC='gcc -m64' CXX='gcc-m64'} to @command{configure}. -Additionally, you @emph{must} pass @option{--build=sparc64-sun-solaris2.11} -or @option{--build=sparcv9-sun-solaris2.11} because @file{config.guess} +specifying @samp{CC='gcc -m64' CXX='g++ -m64' GDC='gdc -m64'} to @command{configure}. +Additionally, you @emph{must} pass @option{--build=sparcv9-sun-solaris2.11} +or @option{--build=sparc64-sun-solaris2.11} because @file{config.guess} misdetects this situation, which can cause build failures. When configuring the GNU Multiple Precision Library (GMP), the MPFR library or the MPC library, the canonical target triplet must be specified -as the @command{build} parameter on the configure line. For example -on a Solaris 11 system: +as the @command{build} parameter on the @command{configure} line. For example: @smallexample -% ./configure --build=sparc64-sun-solaris2.11 --prefix=xxx +% @var{srcdir}/configure --build=sparcv9-sun-solaris2.11 --prefix=@var{dirname} @end smallexample -@html -
-@end html -@anchor{sparcv9-x-solaris2} -@heading sparcv9-*-solaris2* -This is a synonym for @samp{sparc64-*-solaris2*}. - @html
@end html @@ -5117,8 +5086,8 @@ both 64-bit x86-64 and 32-bit x86 code (via the @option{-m32} switch). @anchor{x86-64-x-solaris2} @heading x86_64-*-solaris2* GCC also supports the x86-64 architecture implemented by the AMD64 -processor (@samp{amd64-*-*} is an alias for @samp{x86_64-*-*}) on -Solaris 10 or later. Unlike other systems, without special options a +processor (@samp{amd64-*-*} is an alias for @samp{x86_64-*-*}). +Unlike other systems, without special options a bi-arch compiler is built which generates 32-bit code by default, but can generate 64-bit x86-64 code with the @option{-m64} switch. Since GCC 4.7, there is also a configuration that defaults to 64-bit code, but @@ -5284,7 +5253,7 @@ current GCC) is to be found in the GCC texinfo manual.
@end html @anchor{elf} -@heading all ELF targets (SVR4, Solaris 2, etc.) +@heading all ELF targets (SVR4, Solaris, etc.) C++ support is significantly better on ELF targets if you use the @uref{./configure.html#with-gnu-ld,,GNU linker}; duplicate copies of inlines, vtables and template instantiations will be discarded