newxml/chapter05/gcc-pass1.xml

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3CR2//EN" "http://www.docbook.org/xml/4.3CR2/docbookx.dtd" [
   3   <!ENTITY % gcc-entities SYSTEM "../ent/gcc.ent">
   4   %gcc-entities;
   5 ]>
   6 <sect1 id="ch05-gcc-pass1">
   7 <title>Installing GCC-&gcc-version; - Pass 1</title>
   8 <?dbhtml filename="gcc-pass1.html"?>
   9
  10 <screen>Estimated build time:           4.4 SBU
  11 Estimated required disk space:  300 MB</screen>
  12
  13 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../appendixa/gcc-contents.xml"/>
  14
  15
  16
  17 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../appendixa/gcc-deps.xml"/>
  18
  19
  20
  21 <sect2>
  22 <title>Installation of GCC</title>
  23
  24 <para>Unpack only the GCC-core tarball, as we won't be needing a C++ compiler
  25 for the moment.</para>
  26
  27 <note><para>Even though GCC is an important toolchain package, we are not
  28 going to run the test suite at this early stage. First, the test suite framework
  29 is not yet in place and second, the programs from this first pass will soon be
  30 overwritten by those installed in the second pass.</para></note>
  31
  32 <para>This package is known to behave badly when you have changed its
  33 default optimization flags (including the -march and -mcpu options).
  34 Therefore, if you have defined any environment variables that override
  35 default optimizations, such as CFLAGS and CXXFLAGS, we recommend unsetting
  36 or modifying them when building GCC.</para>
  37
  38 <para>The GCC documentation recommends building GCC outside of the source
  39 directory in a dedicated build directory:</para>
  40
  41 <screen><userinput>mkdir ../gcc-build
  42 cd ../gcc-build</userinput></screen>
  43
  44 <para>Prepare GCC for compilation:</para>
  45
  46 <screen><userinput>../gcc-&gcc-version;/configure --prefix=/tools \
  47     --with-local-prefix=/tools \
  48     --disable-nls --enable-shared \
  49     --enable-languages=c</userinput></screen>
  50
  51 <para>The meaning of the configure options:</para>
  52
  53 <itemizedlist>
  54 <listitem><para><userinput>--with-local-prefix=/tools</userinput>:  The
  55 purpose of this switch is to remove <filename>/usr/local/include</filename>
  56 from <userinput>gcc</userinput>'s include search path. This is not absolutely
  57 essential; however, we want to try to minimize the influence of the host
  58 system, thus making this a sensible thing to do.</para></listitem>
  59
  60 <listitem><para><userinput>--enable-shared</userinput>: This switch may
  61 seem counter-intuitive at first. But using it allows the building of
  62 <filename>libgcc_s.so.1</filename> and <filename>libgcc_eh.a</filename>, and
  63 having <filename>libgcc_eh.a</filename> available ensures that the configure
  64 script for Glibc (the next package we compile) produces the proper results.
  65 Note that the <userinput>gcc</userinput> binaries will still be linked
  66 statically, as this is controlled by the <userinput>-static</userinput>
  67 value of BOOT_LDFLAGS further on.</para></listitem>
  68
  69 <listitem><para><userinput>--enable-languages=c</userinput>: This option
  70 ensures that only the C compiler is built. The option is only needed when you
  71 have downloaded and unpacked the full GCC tarball.</para></listitem>
  72 </itemizedlist>
  73
  74 <para>Continue with compiling the package:</para>
  75
  76 <screen><userinput>make BOOT_LDFLAGS="-static" bootstrap</userinput></screen>
  77
  78 <para>The meaning of the make parameters:</para>
  79
  80 <itemizedlist>
  81 <listitem><para><userinput>BOOT_LDFLAGS="-static"</userinput>: This tells
  82 GCC to link its programs statically.</para></listitem>
  83
  84 <listitem><para><userinput>bootstrap</userinput>: This target doesn't just
  85 compile GCC, but compiles it several times. It uses the programs compiled in
  86 a first round to compile itself a second time, and then again a third time.
  87 It then compares these second and third compiles to make sure it can
  88 reproduce itself flawlessly, which most probably means that it was
  89 compiled correctly.</para></listitem>
  90 </itemizedlist>
  91
  92 <para>And install the package:</para>
  93
  94 <screen><userinput>make install</userinput></screen>
  95
  96 <para>As a finishing touch we'll create the <filename class="symlink">/tools/bin/cc</filename> symlink. Many programs and
  97 scripts run <userinput>cc</userinput> instead of <userinput>gcc</userinput>,
  98 a thing meant to keep programs generic and therefore usable on all kinds of
  99 Unix systems. Not everybody has the GNU C compiler installed. Simply running
 100 <userinput>cc</userinput> leaves the system administrator free to decide what
 101 C compiler to install, as long as there's a symlink pointing to it:</para>
 102
 103 <screen><userinput>ln -sf gcc /tools/bin/cc</userinput></screen>
 104
 105 </sect2>
 106
 107 </sect1>