INSTALL/finalinstall.html

   1 <html lang="en">
   2 <head>
   3 <title>Installing GCC: Final installation</title>
   4 <meta http-equiv="Content-Type" content="text/html">
   5 <meta name="description" content="Installing GCC: Final installation">
   6 <meta name="generator" content="makeinfo 4.12">
   7 <link title="Top" rel="top" href="#Top">
   8 <link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
   9 <!--
  10 Copyright (C) 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997,
  11 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009,
  12 2010 Free Software Foundation, Inc.
  13
  14    Permission is granted to copy, distribute and/or modify this document
  15 under the terms of the GNU Free Documentation License, Version 1.3 or
  16 any later version published by the Free Software Foundation; with no
  17 Invariant Sections, the Front-Cover texts being (a) (see below), and
  18 with the Back-Cover Texts being (b) (see below).  A copy of the
  19 license is included in the section entitled "GNU Free Documentation License".
  20
  21 (a) The FSF's Front-Cover Text is:
  22
  23      A GNU Manual
  24
  25 (b) The FSF's Back-Cover Text is:
  26
  27      You have freedom to copy and modify this GNU Manual, like GNU
  28      software.  Copies published by the Free Software Foundation raise
  29      funds for GNU development.-->
  30 <meta http-equiv="Content-Style-Type" content="text/css">
  31 <style type="text/css"><!--
  32   pre.display { font-family:inherit }
  33   pre.format  { font-family:inherit }
  34   pre.smalldisplay { font-family:inherit; font-size:smaller }
  35   pre.smallformat  { font-family:inherit; font-size:smaller }
  36   pre.smallexample { font-size:smaller }
  37   pre.smalllisp    { font-size:smaller }
  38   span.sc    { font-variant:small-caps }
  39   span.roman { font-family:serif; font-weight:normal; }
  40   span.sansserif { font-family:sans-serif; font-weight:normal; }
  41 --></style>
  42 </head>
  43 <body>
  44 <h1 class="settitle">Installing GCC: Final installation</h1>
  45 Now that GCC has been built (and optionally tested), you can install it with
  46 <pre class="smallexample">     cd <var>objdir</var> &amp;&amp; make install
  47 </pre>
  48    <p>We strongly recommend to install into a target directory where there is
  49 no previous version of GCC present.  Also, the GNAT runtime should not
  50 be stripped, as this would break certain features of the debugger that
  51 depend on this debugging information (catching Ada exceptions for
  52 instance).
  53
  54    <p>That step completes the installation of GCC; user level binaries can
  55 be found in <samp><var>prefix</var><span class="file">/bin</span></samp> where <var>prefix</var> is the value
  56 you specified with the <samp><span class="option">--prefix</span></samp> to configure (or
  57 <samp><span class="file">/usr/local</span></samp> by default).  (If you specified <samp><span class="option">--bindir</span></samp>,
  58 that directory will be used instead; otherwise, if you specified
  59 <samp><span class="option">--exec-prefix</span></samp>, <samp><var>exec-prefix</var><span class="file">/bin</span></samp> will be used.)
  60 Headers for the C++ and Java libraries are installed in
  61 <samp><var>prefix</var><span class="file">/include</span></samp>; libraries in <samp><var>libdir</var></samp>
  62 (normally <samp><var>prefix</var><span class="file">/lib</span></samp>); internal parts of the compiler in
  63 <samp><var>libdir</var><span class="file">/gcc</span></samp> and <samp><var>libexecdir</var><span class="file">/gcc</span></samp>; documentation
  64 in info format in <samp><var>infodir</var></samp> (normally
  65 <samp><var>prefix</var><span class="file">/info</span></samp>).
  66
  67    <p>When installing cross-compilers, GCC's executables
  68 are not only installed into <samp><var>bindir</var></samp>, that
  69 is, <samp><var>exec-prefix</var><span class="file">/bin</span></samp>, but additionally into
  70 <samp><var>exec-prefix</var><span class="file">/</span><var>target-alias</var><span class="file">/bin</span></samp>, if that directory
  71 exists.  Typically, such <dfn>tooldirs</dfn> hold target-specific
  72 binutils, including assembler and linker.
  73
  74    <p>Installation into a temporary staging area or into a <samp><span class="command">chroot</span></samp>
  75 jail can be achieved with the command
  76
  77 <pre class="smallexample">     make DESTDIR=<var>path-to-rootdir</var> install
  78 </pre>
  79    <p class="noindent">where <var>path-to-rootdir</var> is the absolute path of
  80 a directory relative to which all installation paths will be
  81 interpreted.  Note that the directory specified by <code>DESTDIR</code>
  82 need not exist yet; it will be created if necessary.
  83
  84    <p>There is a subtle point with tooldirs and <code>DESTDIR</code>:
  85 If you relocate a cross-compiler installation with
  86 e.g. &lsquo;<samp><span class="samp">DESTDIR=</span><var>rootdir</var></samp>&rsquo;, then the directory
  87 <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
  88 be filled with duplicated GCC executables only if it already exists,
  89 it will not be created otherwise.  This is regarded as a feature,
  90 not as a bug, because it gives slightly more control to the packagers
  91 using the <code>DESTDIR</code> feature.
  92
  93    <p>You can install stripped programs and libraries with
  94
  95 <pre class="smallexample">     make install-strip
  96 </pre>
  97    <p>If you are bootstrapping a released version of GCC then please
  98 quickly review the build status page for your release, available from
  99 <a href="http://gcc.gnu.org/buildstat.html">http://gcc.gnu.org/buildstat.html</a>.
 100 If your system is not listed for the version of GCC that you built,
 101 send a note to
 102 <a href="mailto:gcc@gcc.gnu.org">gcc@gcc.gnu.org</a> indicating
 103 that you successfully built and installed GCC.
 104 Include the following information:
 105
 106      <ul>
 107 <li>Output from running <samp><var>srcdir</var><span class="file">/config.guess</span></samp>.  Do not send
 108 that file itself, just the one-line output from running it.
 109
 110      <li>The output of &lsquo;<samp><span class="samp">gcc -v</span></samp>&rsquo; for your newly installed <samp><span class="command">gcc</span></samp>.
 111 This tells us which version of GCC you built and the options you passed to
 112 configure.
 113
 114      <li>Whether you enabled all languages or a subset of them.  If you used a
 115 full distribution then this information is part of the configure
 116 options in the output of &lsquo;<samp><span class="samp">gcc -v</span></samp>&rsquo;, but if you downloaded the
 117 &ldquo;core&rdquo; compiler plus additional front ends then it isn't apparent
 118 which ones you built unless you tell us about it.
 119
 120      <li>If the build was for GNU/Linux, also include:
 121           <ul>
 122 <li>The distribution name and version (e.g., Red Hat 7.1 or Debian 2.2.3);
 123 this information should be available from <samp><span class="file">/etc/issue</span></samp>.
 124
 125           <li>The version of the Linux kernel, available from &lsquo;<samp><span class="samp">uname --version</span></samp>&rsquo;
 126 or &lsquo;<samp><span class="samp">uname -a</span></samp>&rsquo;.
 127
 128           <li>The version of glibc you used; for RPM-based systems like Red Hat,
 129 Mandrake, and SuSE type &lsquo;<samp><span class="samp">rpm -q glibc</span></samp>&rsquo; to get the glibc version,
 130 and on systems like Debian and Progeny use &lsquo;<samp><span class="samp">dpkg -l libc6</span></samp>&rsquo;.
 131 </ul>
 132      For other systems, you can include similar information if you think it is
 133 relevant.
 134
 135      <li>Any other information that you think would be useful to people building
 136 GCC on the same configuration.  The new entry in the build status list
 137 will include a link to the archived copy of your message.
 138 </ul>
 139
 140    <p>We'd also like to know if the
 141 <a href="specific.html">host/target specific installation notes</a>
 142 didn't include your host/target information or if that information is
 143 incomplete or out of date.  Send a note to
 144 <a href="mailto:gcc@gcc.gnu.org">gcc@gcc.gnu.org</a> detailing how the information should be changed.
 145
 146    <p>If you find a bug, please report it following the
 147 <a href="../bugs/">bug reporting guidelines</a>.
 148
 149    <p>If you want to print the GCC manuals, do &lsquo;<samp><span class="samp">cd </span><var>objdir</var><span class="samp">; make
 150 dvi</span></samp>&rsquo;.  You will need to have <samp><span class="command">texi2dvi</span></samp> (version at least 4.7)
 151 and TeX installed.  This creates a number of <samp><span class="file">.dvi</span></samp> files in
 152 subdirectories of <samp><var>objdir</var></samp>; these may be converted for
 153 printing with programs such as <samp><span class="command">dvips</span></samp>.  Alternately, by using
 154 &lsquo;<samp><span class="samp">make pdf</span></samp>&rsquo; in place of &lsquo;<samp><span class="samp">make dvi</span></samp>&rsquo;, you can create documentation
 155 in the form of <samp><span class="file">.pdf</span></samp> files; this requires <samp><span class="command">texi2pdf</span></samp>, which
 156 is included with Texinfo version 4.8 and later.  You can also
 157 <a href="http://shop.fsf.org/">buy printed manuals from the Free Software Foundation</a>, though such manuals may not be for the most
 158 recent version of GCC.
 159
 160    <p>If you would like to generate online HTML documentation, do &lsquo;<samp><span class="samp">cd
 161 </span><var>objdir</var><span class="samp">; make html</span></samp>&rsquo; and HTML will be generated for the gcc manuals in
 162 <samp><var>objdir</var><span class="file">/gcc/HTML</span></samp>.
 163
 164    <p><hr />
 165 <p><a href="./index.html">Return to the GCC Installation page</a>
 166
 167 <!-- ***Binaries**************************************************************** -->
 168 <!-- ***Specific**************************************************************** -->
 169 <!-- ***Old documentation****************************************************** -->
 170 <!-- ***GFDL******************************************************************** -->
 171 <!-- *************************************************************************** -->
 172 <!-- Part 6 The End of the Document -->
 173 </body></html>
 174