Changes in / [7afc252:7003296] in clfs-embedded


Ignore:
Location:
BOOK/cross-tools
Files:
4 deleted
7 edited

Legend:

Unmodified
Added
Removed
  • BOOK/cross-tools/arm-chapter.xml

    r7afc252 r7003296  
    2121  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/mpc.xml"/>
    2222  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/binutils.xml"/>
    23   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="arm/gcc-static.xml"/>
     23  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/gcc-static.xml"/>
    2424  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/uclibc.xml"/>
    25   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="arm/gcc-final.xml"/>
     25  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/gcc-final.xml"/>
    2626
    2727</chapter>
  • BOOK/cross-tools/common/gcc-final.xml

    r7afc252 r7003296  
    55  %general-entities;
    66]>
    7 
    8 <!-- Common GCC-Final -->
    97
    108<sect1 id="ch-cross-tools-gcc-final" role="wrap">
     
    1816  </indexterm>
    1917
    20   <xi:include role="package" xmlns:xi="http://www.w3.org/2003/XInclude"
     18  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    2119  href="gcc-static.xml"
    2220  xpointer="xpointer(//*[@role='package'])"/>
     
    2523    <title>Installation of GCC Cross Compiler</title>
    2624
    27     <xi:include os="c" xmlns:xi="http://www.w3.org/2003/XInclude"
     25    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    2826    href="gcc-static.xml"
    2927    xpointer="xpointer(//*[@os='c'])"/>
    3028
    31     <xi:include os="d" xmlns:xi="http://www.w3.org/2003/XInclude"
     29    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    3230    href="gcc-static.xml"
    3331    xpointer="xpointer(//*[@os='d'])"/>
    3432
    35     <xi:include os="e" xmlns:xi="http://www.w3.org/2003/XInclude"
     33    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    3634    href="gcc-static.xml"
    3735    xpointer="xpointer(//*[@os='e'])"/>
    3836
    39 <!-- This is the common configure line for GCC-Final -->
    40 <!-- It's not actually used by any arch but is here for reference. -->
    4137<screen os="ae"><userinput>AR=ar LDFLAGS="-Wl,-rpath,${CLFS}/cross-tools/lib" \
    4238  ../gcc-&gcc-version;/configure --prefix=${CLFS}/cross-tools \
     
    4541  --enable-languages=c --enable-c99 --enable-long-long \
    4642  --with-mpfr=${CLFS}/cross-tools --with-gmp=${CLFS}/cross-tools \
    47   --with-mpc=${CLFS}/cross-tools</userinput></screen>
     43  --with-mpc=${CLFS}/cross-tools --with-abi=${CLFS_ABI}</userinput></screen>
    4844
    4945    <variablelist os="af">
     
    7369    </variablelist>
    7470
    75     <xi:include os="ah" xmlns:xi="http://www.w3.org/2003/XInclude"
     71    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    7672    href="gcc-static.xml"
    77     xpointer="xpointer(//*[@os='ah'])"/>
     73    xpointer="xpointer(//*[@os='ag'])"/>
    7874
    79 <screen os="ai"><userinput>make</userinput></screen>
     75<screen os="ah"><userinput>make</userinput></screen>
    8076
    81     <xi:include os="aj" xmlns:xi="http://www.w3.org/2003/XInclude"
     77    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    8278    href="gcc-static.xml"
    83     xpointer="xpointer(//*[@os='aj'])"/>
     79    xpointer="xpointer(//*[@os='ai'])"/>
    8480
    85 <screen os="ak"><userinput>make install</userinput></screen>
     81<screen os="aj"><userinput>make install</userinput></screen>
    8682
    8783  </sect2>
  • BOOK/cross-tools/common/gcc-static.xml

    r7afc252 r7003296  
    66]>
    77
    8 <!-- Common GCC-Static -->
    9 
    108<sect1 id="ch-cross-tools-gcc-static" role="wrap">
    119  <?dbhtml filename="gcc-static.html"?>
     
    2725
    2826  <sect2 role="installation">
    29     <title os="a">Installation of Cross GCC Compiler with Static libgcc
     27    <title>Installation of Cross GCC Compiler with Static libgcc
    3028    and no Threads</title>
    3129
     
    3836    <para os="e">Prepare GCC for compilation:</para>
    3937
    40 <!-- This is the common configure line for GCC-Static. -->
    41 <!-- It's not actually used by any arch but is here for reference. -->
    4238<screen os="ae"><userinput>AR=ar LDFLAGS="-Wl,-rpath,${CLFS}/cross-tools/lib" \
    4339  ../gcc-&gcc-version;/configure --prefix=${CLFS}/cross-tools \
     
    4743  --with-mpc=${CLFS}/cross-tools --without-headers --with-newlib \
    4844  --disable-decimal-float --disable-libgomp --disable-libmudflap \
    49   --disable-libssp --disable-threads --enable-languages=c</userinput></screen>
     45  --disable-libssp --disable-threads --enable-languages=c \
     46  --with-abi=${CLFS_ABI}</userinput></screen>
    5047
    5148    <variablelist os="af">
     
    210207      </varlistentry>
    211208
     209      <varlistentry os="af19">
     210        <term><parameter>--with-abi=${CLFS_ABI}</parameter></term>
     211        <listitem>
     212          <para>This option sets the ABI selected earlier.</para>
     213        </listitem>
     214      </varlistentry>
     215
    212216    </variablelist>
    213217
    214     <para os="ah">Continue with compiling the package:</para>
    215 
    216 <screen os="ai"><userinput>make all-gcc all-target-libgcc</userinput></screen>
    217 
    218     <para os="aj">Install the package:</para>
    219 
    220 <screen os="ak"><userinput>make install-gcc install-target-libgcc</userinput></screen>
     218    <para os="ag">Continue with compiling the package:</para>
     219
     220<screen os="ah"><userinput>make all-gcc all-target-libgcc</userinput></screen>
     221
     222    <para os="ai">Install the package:</para>
     223
     224<screen os="aj"><userinput>make install-gcc install-target-libgcc</userinput></screen>
    221225
    222226  </sect2>
  • BOOK/cross-tools/mips-chapter.xml

    r7afc252 r7003296  
    2121  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/mpc.xml"/>
    2222  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/binutils.xml"/>
    23   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="mips/gcc-static.xml"/>
     23  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/gcc-static.xml"/>
    2424  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/uclibc.xml"/>
    25   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="mips/gcc-final.xml"/>
     25  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/gcc-final.xml"/>
    2626
    2727</chapter>
  • BOOK/cross-tools/wrt-chapter.xml

    r7afc252 r7003296  
    2121  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/mpc.xml"/>
    2222  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/binutils.xml"/>
    23   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="mips/gcc-static.xml"/>
     23  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/gcc-static.xml"/>
    2424  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/uclibc.xml"/>
    25   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="mips/gcc-final.xml"/>
     25  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="common/gcc-final.xml"/>
    2626
    2727</chapter>
  • BOOK/cross-tools/x86/gcc-final.xml

    r7afc252 r7003296  
    55  %general-entities;
    66]>
    7 
    8 <!-- x86 GCC-Final -->
    97
    108<sect1 id="ch-cross-tools-gcc-final" role="wrap">
     
    1917
    2018  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    21   href="../common/gcc-final.xml"
     19  href="../common/gcc-static.xml"
    2220  xpointer="xpointer(//*[@role='package'])"/>
    2321
     
    2624
    2725    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    28     href="../common/gcc-final.xml"
     26    href="../common/gcc-static.xml"
    2927    xpointer="xpointer(//*[@os='c'])"/>
    3028
    3129    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    32     href="../common/gcc-final.xml"
     30    href="../common/gcc-static.xml"
    3331    xpointer="xpointer(//*[@os='d'])"/>
    3432
    3533    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    36     href="../common/gcc-final.xml"
     34    href="../common/gcc-static.xml"
    3735    xpointer="xpointer(//*[@os='e'])"/>
    3836
     
    7371
    7472    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    75     href="../common/gcc-final.xml"
    76     xpointer="xpointer(//*[@os='ah'])"/>
     73    href="gcc-static.xml"
     74    xpointer="xpointer(//*[@os='ag'])"/>
     75
     76<screen os="ah"><userinput>make</userinput></screen>
    7777
    7878    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    79     href="../common/gcc-final.xml"
     79    href="../common/gcc-static.xml"
    8080    xpointer="xpointer(//*[@os='ai'])"/>
    8181
    82     <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    83     href="../common/gcc-final.xml"
    84     xpointer="xpointer(//*[@os='aj'])"/>
    85 
    86     <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    87     href="../common/gcc-final.xml"
    88     xpointer="xpointer(//*[@os='ak'])"/>
     82<screen os="aj"><userinput>make install</userinput></screen>
    8983
    9084  </sect2>
    9185
    92     <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    93     href="../common/gcc-final.xml"
    94     xpointer="xpointer(//*[@role='content'])"/>
     86  <sect2 id="contents-gcc" role="content">
     87    <title>Contents of GCC</title>
     88
     89    <segmentedlist>
     90      <segtitle>Installed programs</segtitle>
     91      <segtitle>Installed libraries</segtitle>
     92
     93      <seglistitem>
     94        <seg>cc (link to gcc), gcc, gccbug, and gcov</seg>
     95        <seg>libgcc.a, libgcc_eh.a, libgcc_s.so, libmudflap.[a,so],
     96        and libmudflapth.[a,so]</seg>
     97      </seglistitem>
     98    </segmentedlist>
     99
     100    <variablelist>
     101      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
     102      <?dbfo list-presentation="list"?>
     103      <?dbhtml list-presentation="table"?>
     104
     105      <varlistentry id="cc">
     106        <term><command>cc</command></term>
     107        <listitem>
     108          <para>The C compiler</para>
     109          <indexterm zone="ch-cross-tools-gcc-final cc">
     110            <primary sortas="b-cc">cc</primary>
     111          </indexterm>
     112        </listitem>
     113      </varlistentry>
     114
     115      <varlistentry id="gcc">
     116        <term><command>gcc</command></term>
     117        <listitem>
     118          <para>The C compiler</para>
     119          <indexterm zone="ch-cross-tools-gcc-final gcc">
     120            <primary sortas="b-gcc">gcc</primary>
     121          </indexterm>
     122        </listitem>
     123      </varlistentry>
     124
     125      <varlistentry id="gccbug">
     126        <term><command>gccbug</command></term>
     127        <listitem>
     128          <para>A shell script used to help create useful bug reports</para>
     129          <indexterm zone="ch-cross-tools-gcc-final gccbug">
     130            <primary sortas="b-gccbug">gccbug</primary>
     131          </indexterm>
     132        </listitem>
     133      </varlistentry>
     134
     135      <varlistentry id="gcov">
     136        <term><command>gcov</command></term>
     137        <listitem>
     138          <para>A coverage testing tool; it is used to analyze programs to
     139          determine where optimizations will have the most effect</para>
     140          <indexterm zone="ch-cross-tools-gcc-final gcov">
     141            <primary sortas="b-gcov">gcov</primary>
     142          </indexterm>
     143        </listitem>
     144      </varlistentry>
     145
     146      <varlistentry id="libgcc">
     147        <term><filename class="libraryfile">libgcc</filename></term>
     148        <listitem>
     149          <para>Contains run-time support for <command>gcc</command></para>
     150          <indexterm zone="ch-cross-tools-gcc-final libgcc">
     151            <primary sortas="c-libgcc*">libgcc*</primary>
     152          </indexterm>
     153        </listitem>
     154      </varlistentry>
     155
     156      <varlistentry id="libmudflap">
     157        <term><filename class="libraryfile">libmudflap</filename></term>
     158        <listitem>
     159          <para>The libmudflap libraries are used by GCC for instrumenting
     160          pointer and array dereferencing operations.</para>
     161          <indexterm zone="ch-cross-tools-gcc-final libmudflap">
     162            <primary sortas="c-libmudflap*">libmudflap*</primary>
     163          </indexterm>
     164        </listitem>
     165      </varlistentry>
     166
     167    </variablelist>
     168
     169  </sect2>
    95170
    96171</sect1>
  • BOOK/cross-tools/x86/gcc-static.xml

    r7afc252 r7003296  
    66]>
    77
    8 <!-- x86 GCC-Static -->
    9 
    108<sect1 id="ch-cross-tools-gcc-static" role="wrap">
    119  <?dbhtml filename="gcc-static.html"?>
     
    1816  </indexterm>
    1917
    20   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    21   href="../common/gcc-static.xml"
    22   xpointer="xpointer(//*[@role='package'])"/>
     18  <sect2 role="package">
     19    <title/>
     20
     21    <para>The GCC package contains the GNU compiler collection, which includes
     22    the C and C++ compilers.</para>
     23
     24  </sect2>
    2325
    2426  <sect2 role="installation">
    25 
    26   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    27   href="../common/gcc-static.xml"
    28   xpointer="xpointer(//*[@os='a'])"/>
     27    <title>Installation of Cross GCC Compiler with Static libgcc
     28    and no Threads</title>
    2929
    3030  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
     
    5050  --with-arch=${CLFS_CPU} --disable-multilib</userinput></screen>
    5151
    52 <!-- Common configure switches for all archs -->
    53   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    54   href="../common/gcc-static.xml"
    55   xpointer="xpointer(//*[@os='af'])"/>
    56 
    57 <!-- Specific configure switches for x86 -->
    58   <variablelist os="ag">
    59 
    60     <varlistentry os="ag1">
    61       <term><parameter>--with-arch=${CLFS_CPU}</parameter></term>
    62       <listitem>
    63         <para>This option configures the cross compiler to only output
    64         instructions for our previously selected CPU.</para>
    65       </listitem>
    66     </varlistentry>
    67 
    68     <varlistentry os="ag2">
    69       <term><parameter>--disable-multilib</parameter></term>
    70       <listitem>
    71         <para>This option specifies that multiple target libraries should
    72         not be built.</para>
    73       </listitem>
    74     </varlistentry>
    75 
    76   </variablelist>
     52    <variablelist os="af">
     53      <title>The meaning of the configure options:</title>
     54
     55      <varlistentry os="af1">
     56        <term><parameter>--prefix=${CLFS}/cross-tools</parameter></term>
     57        <listitem>
     58          <para>This tells the configure script to prepare to install the
     59          package in the <filename class="directory">${CLFS}/cross-tools</filename>
     60          directory.</para>
     61        </listitem>
     62      </varlistentry>
     63
     64      <varlistentry os="af2">
     65        <term><parameter>--build=${CLFS_HOST}</parameter></term>
     66        <listitem>
     67          <para>This tells the configure script the triplet to use to build GCC.
     68          It will use ${CLFS_HOST} as that's where it's being built.</para>
     69        </listitem>
     70      </varlistentry>
     71
     72      <varlistentry os="af3">
     73        <term><parameter>--host=${CLFS_HOST}</parameter></term>
     74        <listitem>
     75          <para>This tells the configure script the triplet of the machine GCC
     76          will be executed on when actually cross compiling.  It will use
     77          ${CLFS_HOST} as that's where GCC will execute when cross compiling
     78          software later.</para>
     79        </listitem>
     80      </varlistentry>
     81
     82      <varlistentry os="af4">
     83        <term><parameter>--target=${CLFS_TARGET}</parameter></term>
     84        <listitem>
     85          <para>This tells the configure script the triplet of the machine GCC
     86          will build executables for.  It will use ${CLFS_TARGET} so that software
     87          compiled with this version of GCC can be executed on the embedded machine
     88          target.</para>
     89        </listitem>
     90      </varlistentry>
     91
     92      <varlistentry os="af5">
     93        <term><parameter>--with-sysroot=${CLFS}</parameter></term>
     94        <listitem>
     95          <para>This tells configure that ${CLFS} is going to be the root
     96          of our system. It will now use the specified sysroot, ${CLFS}, as
     97          a prefix of the default search paths.</para>
     98        </listitem>
     99      </varlistentry>
     100
     101      <varlistentry os="af6">
     102        <term><parameter>--disable-nls</parameter></term>
     103        <listitem>
     104          <para>This disables internationalization as i18n is not needed for the
     105          cross-compile tools.</para>
     106        </listitem>
     107      </varlistentry>
     108
     109      <varlistentry os="af7">
     110        <term><parameter>--disable-shared</parameter></term>
     111        <listitem>
     112          <para>Disables the creation of the shared libraries.</para>
     113        </listitem>
     114      </varlistentry>
     115
     116      <varlistentry os="af8">
     117        <term><parameter>--with-mpfr=${CLFS}/cross-tools</parameter></term>
     118        <listitem>
     119          <para>Tells configure where to find the
     120          <filename class="directory">lib</filename> and
     121          <filename class="directory">include</filename> directories
     122          that contain MPFR which was built earlier.</para>
     123        </listitem>
     124      </varlistentry>
     125
     126      <varlistentry os="af9">
     127        <term><parameter>--with-gmp=${CLFS}/cross-tools</parameter></term>
     128        <listitem>
     129          <para>Tells configure where to find the
     130          <filename class="directory">lib</filename> and
     131          <filename class="directory">include</filename> directories
     132          that contain GMP which was built earlier.</para>
     133        </listitem>
     134      </varlistentry>
     135
     136      <varlistentry os="af10">
     137        <term><parameter>--with-mpc=${CLFS}/cross-tools</parameter></term>
     138        <listitem>
     139          <para>Tells configure where to find the
     140          <filename class="directory">lib</filename> and
     141          <filename class="directory">include</filename> directories
     142          that contain MPC which was built earlier.</para>
     143        </listitem>
     144      </varlistentry>
     145
     146      <varlistentry os="af11">
     147        <term><parameter>--without-headers</parameter></term>
     148        <listitem>
     149          <para>Tells configure to not use any headers from any C libraries.
     150          This is needed as we haven't yet built the C library and to prevent
     151          influence from the host environment.</para>
     152        </listitem>
     153      </varlistentry>
     154
     155      <varlistentry os="af12">
     156        <term><parameter>--with-newlib</parameter></term>
     157        <listitem>
     158          <para>Tells configure to build libgcc without needing any C
     159          libraries.</para>
     160        </listitem>
     161      </varlistentry>
     162
     163      <varlistentry os="af13">
     164        <term><parameter>--disable-decimal-float</parameter></term>
     165        <listitem>
     166          <para>Tells configure to disable IEEE 754-2008 decimal floating
     167          point support.  Decimal floating point support isn't needed yet.</para>
     168        </listitem>
     169      </varlistentry>
     170
     171      <varlistentry os="af14">
     172        <term><parameter>--disable-libgomp</parameter></term>
     173        <listitem>
     174          <para>Tells configure to not build the GOMP run-time libraries.
     175          GOMP is the GNU implementation of OpenMP, a API for shared-memory
     176          parallel programming.</para>
     177        </listitem>
     178      </varlistentry>
     179
     180      <varlistentry os="af15">
     181        <term><parameter>--disable-libmudflap</parameter></term>
     182        <listitem>
     183          <para>Tells configure to not build libmudflap.  Mudflap is a
     184          library that can be used to help check for proper pointer usage.</para>
     185        </listitem>
     186      </varlistentry>
     187
     188      <varlistentry os="af16">
     189        <term><parameter>--disable-libssp</parameter></term>
     190        <listitem>
     191          <para>Tells configure not to build run-time libraries for stack
     192          smashing detection.</para>
     193        </listitem>
     194      </varlistentry>
     195
     196      <varlistentry os="af17">
     197        <term><parameter>--disable-threads</parameter></term>
     198        <listitem>
     199          <para>This will prevent GCC from looking for the multi-thread
     200          include files, since they haven't been created for this architecture
     201          yet. GCC will be able to find the multi-thread information after
     202          the glib headers are created.</para>
     203        </listitem>
     204      </varlistentry>
     205
     206      <varlistentry os="af18">
     207        <term><parameter>--enable-languages=c</parameter></term>
     208        <listitem>
     209          <para>This option ensures that only the C compiler is built.</para>
     210        </listitem>
     211      </varlistentry>
     212
     213      <varlistentry os="af19">
     214        <term><parameter>--with-arch=${CLFS_CPU}</parameter></term>
     215        <listitem>
     216          <para>This option configures the cross compiler to only output
     217          instructions for our previously selected CPU.</para>
     218        </listitem>
     219      </varlistentry>
     220
     221      <varlistentry os="af20">
     222        <term><parameter>--disable-multilib</parameter></term>
     223        <listitem>
     224          <para>This option specifies that multiple target libraries should
     225          not be built.</para>
     226        </listitem>
     227      </varlistentry>
     228
     229    </variablelist>
     230
     231  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
     232  href="../common/gcc-static.xml"
     233  xpointer="xpointer(//*[@os='ag'])"/>
    77234
    78235  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
     
    88245  xpointer="xpointer(//*[@os='aj'])"/>
    89246
    90   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    91   href="../common/gcc-static.xml"
    92   xpointer="xpointer(//*[@os='ak'])"/>
    93 
    94247  </sect2>
    95248
    96   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    97   href="../common/gcc-static.xml"
    98   xpointer="xpointer(//*[@role='content'])"/>
     249  <sect2 role="content">
     250    <title/>
     251
     252    <para>Details on this package are located in <xref
     253    linkend="contents-gcc" role="."/></para>
     254
     255  </sect2>
    99256
    100257</sect1>
Note: See TracChangeset for help on using the changeset viewer.