Changeset 7afc252 in clfs-embedded for BOOK/cross-tools/x86


Ignore:
Timestamp:
Feb 12, 2011, 3:08:06 PM (14 years ago)
Author:
Joe Ciccone <jciccone@…>
Branches:
master
Children:
f45393b
Parents:
7003296 (diff), bd0ad10 (diff)
Note: this is a merge changeset, the changes displayed below correspond to the merge itself.
Use the (diff) links above to see all the changes relative to each parent.
Message:

Merge remote branch 'remotes/abradford/master'

Location:
BOOK/cross-tools/x86
Files:
2 edited

Legend:

Unmodified
Added
Removed
  • BOOK/cross-tools/x86/gcc-final.xml

    r7003296 r7afc252  
    55  %general-entities;
    66]>
     7
     8<!-- x86 GCC-Final -->
    79
    810<sect1 id="ch-cross-tools-gcc-final" role="wrap">
     
    1719
    1820  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    19   href="../common/gcc-static.xml"
     21  href="../common/gcc-final.xml"
    2022  xpointer="xpointer(//*[@role='package'])"/>
    2123
     
    2426
    2527    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    26     href="../common/gcc-static.xml"
     28    href="../common/gcc-final.xml"
    2729    xpointer="xpointer(//*[@os='c'])"/>
    2830
    2931    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    30     href="../common/gcc-static.xml"
     32    href="../common/gcc-final.xml"
    3133    xpointer="xpointer(//*[@os='d'])"/>
    3234
    3335    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    34     href="../common/gcc-static.xml"
     36    href="../common/gcc-final.xml"
    3537    xpointer="xpointer(//*[@os='e'])"/>
    3638
     
    7173
    7274    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    73     href="gcc-static.xml"
    74     xpointer="xpointer(//*[@os='ag'])"/>
    75 
    76 <screen os="ah"><userinput>make</userinput></screen>
     75    href="../common/gcc-final.xml"
     76    xpointer="xpointer(//*[@os='ah'])"/>
    7777
    7878    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    79     href="../common/gcc-static.xml"
     79    href="../common/gcc-final.xml"
    8080    xpointer="xpointer(//*[@os='ai'])"/>
    8181
    82 <screen os="aj"><userinput>make install</userinput></screen>
     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'])"/>
    8389
    8490  </sect2>
    8591
    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>
     92    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
     93    href="../common/gcc-final.xml"
     94    xpointer="xpointer(//*[@role='content'])"/>
    17095
    17196</sect1>
  • BOOK/cross-tools/x86/gcc-static.xml

    r7003296 r7afc252  
    55  %general-entities;
    66]>
     7
     8<!-- x86 GCC-Static -->
    79
    810<sect1 id="ch-cross-tools-gcc-static" role="wrap">
     
    1618  </indexterm>
    1719
    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>
     20  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
     21  href="../common/gcc-static.xml"
     22  xpointer="xpointer(//*[@role='package'])"/>
    2523
    2624  <sect2 role="installation">
    27     <title>Installation of Cross GCC Compiler with Static libgcc
    28     and no Threads</title>
     25
     26  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
     27  href="../common/gcc-static.xml"
     28  xpointer="xpointer(//*[@os='a'])"/>
    2929
    3030  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
     
    5050  --with-arch=${CLFS_CPU} --disable-multilib</userinput></screen>
    5151
    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 
     52<!-- Common configure switches for all archs -->
    23153  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
    23254  href="../common/gcc-static.xml"
    233   xpointer="xpointer(//*[@os='ag'])"/>
     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>
    23477
    23578  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
     
    24588  xpointer="xpointer(//*[@os='aj'])"/>
    24689
    247   </sect2>
    248 
    249   <sect2 role="content">
    250     <title/>
    251 
    252     <para>Details on this package are located in <xref
    253     linkend="contents-gcc" role="."/></para>
     90  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
     91  href="../common/gcc-static.xml"
     92  xpointer="xpointer(//*[@os='ak'])"/>
    25493
    25594  </sect2>
    25695
     96  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
     97  href="../common/gcc-static.xml"
     98  xpointer="xpointer(//*[@role='content'])"/>
     99
    257100</sect1>
Note: See TracChangeset for help on using the changeset viewer.