X-Git-Url: http://git.sourceforge.jp/view?p=pf3gnuchains%2Fgcc-fork.git;a=blobdiff_plain;f=gcc%2Fdoc%2Finstall.texi;h=f93413fb7b8af96f96c1bac388de6cd9ed51b8e6;hp=1312203dc5d243ef9624121010ec39a5cfc229e5;hb=14f27bc62d31edd462a7fc10cfb684a36b9e124e;hpb=5b91c59ca06d073eb90e1a86a9d2264e16ab9dd3 diff --git a/gcc/doc/install.texi b/gcc/doc/install.texi index 1312203dc5d..f93413fb7b8 100644 --- a/gcc/doc/install.texi +++ b/gcc/doc/install.texi @@ -45,8 +45,8 @@ @end ifset @c Copyright (C) 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998, -@c 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, -@c 2010 Free Software Foundation, Inc. +@c 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, +@c 2010, 2011 Free Software Foundation, Inc. @c *** Converted to texinfo by Dean Wakerley, dean@wakerley.com @c IMPORTANT: whenever you modify this file, run `install.texi2html' to @@ -303,6 +303,34 @@ Necessary (only on some platforms) to untar the source code. Many systems' @command{tar} programs will also work, only try GNU @command{tar} if you have problems. +@item Perl version 5.6.1 (or later) + +Necessary when targetting Darwin, building @samp{libstdc++}, +and not using @option{--disable-symvers}. +Necessary when targetting Solaris 2 with Sun @command{ld} and not using +@option{--disable-symvers}. The bundled @command{perl} in Solaris@tie{}8 +and up works. + +Necessary when regenerating @file{Makefile} dependencies in libiberty. +Necessary when regenerating @file{libiberty/functions.texi}. +Necessary when generating manpages from Texinfo manuals. +Used by various scripts to generate some files included in SVN (mainly +Unicode-related and rarely changing) from source tables. + +@item @command{jar}, or InfoZIP (@command{zip} and @command{unzip}) + +Necessary to build libgcj, the GCJ runtime. + +@end table + +Several support libraries are necessary to build GCC, some are required, +others optional. While any sufficiently new version of required tools +usually work, library requirements are generally stricter. Newer +versions may work in some cases, but it's safer to use the exact +versions documented. We appreciate bug reports about problems with +newer versions, though. + +@table @asis @item GNU Multiple Precision Library (GMP) version 4.3.2 (or later) Necessary to build GCC@. If you do not have it installed in your @@ -358,10 +386,6 @@ does not use PPL, PPL is still required for Graphite. In both cases @option{--with-cloog} configure option should be used if CLooG is not installed in your default library search path. -@item @command{jar}, or InfoZIP (@command{zip} and @command{unzip}) - -Necessary to build libgcj, the GCJ runtime. - @end table @heading Tools/packages necessary for modifying GCC @@ -437,7 +461,7 @@ included in releases. @item @TeX{} (any working version) -Necessary for running @command{texi2dvi} and @command{texi2pdf}, which +Necessary for running @command{texi2dvi} and @command{texi2pdf}, which are used when running @command{make dvi} or @command{make pdf} to create DVI or PDF files, respectively. @@ -447,21 +471,6 @@ DVI or PDF files, respectively. Necessary to access the SVN repository. Public releases and weekly snapshots of the development sources are also available via FTP@. -@item Perl version 5.6.1 (or later) - -Necessary when regenerating @file{Makefile} dependencies in libiberty. -Necessary when regenerating @file{libiberty/functions.texi}. -Necessary when generating manpages from Texinfo manuals. -Necessary when targetting Darwin, building @samp{libstdc++}, -and not using @option{--disable-symvers}. -Necessary when targetting Solaris 2 with Sun @command{ld}, building -@samp{libstdc++}, and not using @option{--disable-symvers}. A helper -scripts needs @samp{Glob.pm}, which is missing from @command{perl} 5.005 -included in Solaris@tie{}8. The bundled @command{perl} in Solaris@tie{}9 and up -works. -Used by various scripts to generate some files included in SVN (mainly -Unicode-related and rarely changing) from source tables. - @item GNU diffutils version 2.7 (or later) Useful when submitting patches for the GCC source code. @@ -762,6 +771,19 @@ the installation directory for G++ header files. The default depends on other configuration options, and differs between cross and native configurations. +@item --with-specs=@var{specs} +Specify additional command line driver SPECS. +This can be useful if you need to turn on a non-standard feature by +default without modifying the compiler's source code, for instance +@option{--with-specs=%@{!fcommon:%@{!fno-common:-fno-common@}@}}. +@ifnothtml +@xref{Spec Files,, Specifying subprocesses and the switches to pass to them, +gcc, Using the GNU Compiler Collection (GCC)}, +@end ifnothtml +@ifhtml +See ``Spec Files'' in the main manual +@end ifhtml + @end table @item --program-prefix=@var{prefix} @@ -994,6 +1016,12 @@ 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. +@item --with-tls=@var{dialect} +Specify the default TLS dialect, for systems were there is a choice. +For ARM targets, possible values for @var{dialect} are @code{gnu} or +@code{gnu2}, which select between the original GNU dialect and the GNU TLS +descriptor-based dialect. + @item --disable-multilib Specify that multiple target libraries to support different target variants, calling @@ -1003,9 +1031,6 @@ predefined set of them. Some targets provide finer-grained control over which multilibs are built (e.g., @option{--disable-softfloat}): @table @code -@item arc-*-elf* -biendian. - @item arm-*-* fpu, 26bit, underscore, interwork, biendian, nofmult. @@ -1100,16 +1125,12 @@ like C++ and Java. The possibilities for @var{lib} are: AIX thread support. @item dce DCE thread support. -@item gnat -Ada tasking support. For non-Ada programs, this setting is equivalent -to @samp{single}. 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. -@item mach -Generic MACH thread support, known to work on NeXTSTEP@. (Please note -that the file needed to support this configuration, @file{gthr-mach.h}, is -missing and thus this setting will cause a known bootstrap failure.) +@item lynx +LynxOS thread support. +@item mipssde +MIPS SDE thread support. +@item nks +Novell Kernel Services thread support. @item no This is an alias for @samp{single}. @item posix @@ -1120,15 +1141,12 @@ Generic POSIX/Unix95 thread support. RTEMS thread support. @item single Disable thread support, should work for all platforms. -@item solaris -Sun Solaris 2/Unix International thread support. Only use this if you -really need to use this legacy API instead of the default, @samp{posix}. +@item tpf +TPF thread support. @item vxworks VxWorks thread support. @item win32 Microsoft Win32 API thread support. -@item nks -Novell Kernel Services thread support. @end table @item --enable-tls @@ -1209,7 +1227,7 @@ On MIPS targets, make @option{-mno-llsc} the default when no On MIPS targets, make @option{-msynci} the default when no @option{-mno-synci} option is passed. -@item --without-synci +@item --without-synci On MIPS targets, make @option{-mno-synci} the default when no @option{-msynci} option is passed. This is the default. @@ -1227,7 +1245,7 @@ destructors, but requires __cxa_atexit in libc. This option is currently only available on systems with GNU libc. When enabled, this will cause @option{-fuse-cxa-atexit} to be passed by default. -@item --enable-indirect-function +@item --enable-gnu-indirect-function Define if you want to enable the @code{ifunc} attribute. This option is currently only available on systems with GNU libc on certain targets. @@ -1654,6 +1672,11 @@ option), if the linker supports it. If you specify support @option{--build-id} option, a warning is issued and the @option{--enable-linker-build-id} option is ignored. The default is off. +@item --with-linker-hash-style=@var{choice} +Tells GCC to pass @option{--hash-style=@var{choice}} option to the +linker for all final links. @var{choice} can be one of +@samp{sysv}, @samp{gnu}, and @samp{both} where @samp{sysv} is the default. + @item --enable-gnu-unique-object @itemx --disable-gnu-unique-object Tells GCC to use the gnu_unique_object relocation for C++ template @@ -1706,7 +1729,7 @@ the directory specified with @option{--with-sysroot}. This option is only useful when you are already using @option{--with-sysroot}. You can use @option{--with-build-sysroot} when you are configuring with @option{--prefix} set to a directory that is different from the one in -which you are installing GCC and your target libraries. +which you are installing GCC and your target libraries. This option affects the system root for the compiler used to build target libraries (which runs on the build system); it does not affect @@ -1898,8 +1921,8 @@ Note that if --enable-java-home is used, --with-arch-directory=ARCH must also be specified. @item --with-arch-directory=ARCH -Specifies the name to use for the @file{jre/lib/ARCH} directory in the SDK -environment created when --enable-java-home is passed. Typical names for this +Specifies the name to use for the @file{jre/lib/ARCH} directory in the SDK +environment created when --enable-java-home is passed. Typical names for this directory include i386, amd64, ia64, etc. @item --with-os-directory=DIR @@ -1911,7 +1934,7 @@ Specifies the JPackage origin name. This defaults to the 'gcj' in java-1.5.0-gcj. @item --with-arch-suffix=SUFFIX -Specifies the suffix for the sdk directory. Defaults to the empty string. +Specifies the suffix for the sdk directory. Defaults to the empty string. Examples include '.x86_64' in 'java-1.5.0-gcj-1.5.0.0.x86_64'. @item --with-jvm-root-dir=DIR @@ -1923,7 +1946,7 @@ Specifies where to install jars. Default is $(prefix)/lib/jvm-exports. @item --with-python-dir=DIR Specifies where to install the Python modules used for aot-compile. DIR should not include the prefix used in installation. For example, if the Python modules -are to be installed in /usr/lib/python2.5/site-packages, then +are to be installed in /usr/lib/python2.5/site-packages, then --with-python-dir=/lib/python2.5/site-packages should be passed. If this is not specified, then the Python modules are installed in $(prefix)/share/python. @@ -2339,7 +2362,7 @@ compilation options. Check your target's definition of GNU Make 3.80 and above, which is necessary to build GCC, support building in parallel. To activate this, you can use @samp{make -j 2} -instead of @samp{make}. You can also specify a bigger number, and +instead of @samp{make}. 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 @@ -2934,7 +2957,7 @@ information are. @item @uref{#alpha-dec-osf51,,alpha*-dec-osf5.1} @item -@uref{#arc-x-elf,,arc-*-elf} +@uref{#amd64-x-solaris210,,amd64-*-solaris2.10} @item @uref{#arm-x-elf,,arm-*-elf} @item @@ -2978,10 +3001,6 @@ information are. @item @uref{#m32r-x-elf,,m32r-*-elf} @item -@uref{#m6811-elf,,m6811-elf} -@item -@uref{#m6812-elf,,m6812-elf} -@item @uref{#m68k-x-x,,m68k-*-*} @item @uref{#m68k-uclinux,,m68k-uclinux} @@ -3040,6 +3059,8 @@ information are. @item @uref{#x86-64-x-x,,x86_64-*-*, amd64-*-*} @item +@uref{#x86-64-x-solaris210,,x86_64-*-solaris2.1[0-9]*} +@item @uref{#xtensa-x-elf,,xtensa*-*-elf} @item @uref{#xtensa-x-linux,,xtensa*-*-linux*} @@ -3088,10 +3109,12 @@ Systems using processors that implement the DEC Alpha architecture and are running the DEC/Compaq/HP Unix (DEC OSF/1, Digital UNIX, or Compaq/HP Tru64 UNIX) operating system, for example the DEC Alpha AXP systems. -As of GCC 3.2, versions before @code{alpha*-dec-osf4} are no longer -supported. (These are the versions which identify themselves as DEC -OSF/1.) As of GCC 4.6, support for Tru64 UNIX V4.0 and V5.0 has been -removed. +Support for Tru64 UNIX V5.1 has been obsoleted in GCC 4.7, but can still +be enabled by configuring with @option{--enable-obsolete}. Support will +be removed in GCC 4.8. As of GCC 4.6, support for Tru64 UNIX V4.0 and +V5.0 has been removed. As of GCC 3.2, versions before +@code{alpha*-dec-osf4} are no longer supported. (These are the versions +which identify themselves as DEC OSF/1.) On Tru64 UNIX, virtual memory exhausted bootstrap failures may be fixed by reconfiguring Kernel Virtual Memory and Swap parameters @@ -3101,10 +3124,14 @@ or applying the patch in the OS version used, you need a data segment size between 512 MB and 1 GB, so simply use @command{ulimit -Sd unlimited}. -As of GNU binutils 2.20.1, neither GNU @command{as} nor GNU @command{ld} +As of GNU binutils 2.21, neither GNU @command{as} nor GNU @command{ld} are supported on Tru64 UNIX, so you must not configure GCC with @option{--with-gnu-as} or @option{--with-gnu-ld}. +Cross-compilers for the Tru64 UNIX target currently do not work because +the auxiliary programs @command{mips-tdump} and @command{mips-tfile} can't +be compiled on anything but Tru64 UNIX. + GCC writes a @samp{.verstamp} 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 @file{/usr/include/stamp.h}. If you install a @@ -3134,9 +3161,9 @@ provide a fix shortly. @html