Changeset f704d3f in clfs-embedded for BOOK/cross-tools/common


Ignore:
Timestamp:
Jan 29, 2011, 7:29:03 AM (14 years ago)
Author:
Andrew Bradford <bradfa@…>
Branches:
master
Children:
f6137b6
Parents:
e63fb04
Message:

Added info to each of GCC's configure switches

File:
1 edited

Legend:

Unmodified
Added
Removed

  • BOOK/cross-tools/common/gcc-static.xml

    re63fb04 rf704d3f  
    4848      <title>The meaning of the configure options:</title>
    4949
    50       <varlistentry>
     50      <varlistentry os="af1">
     51        <term><parameter>--prefix=${CLFS}/cross-tools</parameter></term>
     52        <listitem>
     53          <para>This tells the configure script to prepare to install the
     54          package in the <filename class="directory">${CLFS}/cross-tools</filename>
     55          directory.</para>
     56        </listitem>
     57      </varlistentry>
     58
     59      <varlistentry os="af2">
     60        <term><parameter>--build=${CLFS_HOST}</parameter></term>
     61        <listitem>
     62          <para>This tells the configure script the triplet to use to build GCC.
     63          It will use ${CLFS_HOST} as that's where it's being built.</para>
     64        </listitem>
     65      </varlistentry>
     66
     67      <varlistentry os="af3">
     68        <term><parameter>--host=${CLFS_HOST}</parameter></term>
     69        <listitem>
     70          <para>This tells the configure script the triplet of the machine GCC
     71          will be executed on when actually cross compiling.  It will use
     72          ${CLFS_HOST} as that's where GCC will execute when cross compiling
     73          software later.</para>
     74        </listitem>
     75      </varlistentry>
     76
     77      <varlistentry os="af4">
     78        <term><parameter>--target=${CLFS_TARGET}</parameter></term>
     79        <listitem>
     80          <para>This tells the configure script the triplet of the machine GCC
     81          will build executables for.  It will use ${CLFS_TARGET} so that software
     82          compiled with this version of GCC can be executed on the embedded machine
     83          target.</para>
     84        </listitem>
     85      </varlistentry>
     86
     87      <varlistentry os="af5">
     88        <term><parameter>--with-sysroot=${CLFS}</parameter></term>
     89        <listitem>
     90          <para>This tells configure that ${CLFS} is going to be the root
     91          of our system. It will now use the specified sysroot, ${CLFS}, as
     92          a prefix of the default search paths.</para>
     93        </listitem>
     94      </varlistentry>
     95
     96      <varlistentry os="af6">
     97        <term><parameter>--disable-nls</parameter></term>
     98        <listitem>
     99          <para>This disables internationalization as i18n is not needed for the
     100          cross-compile tools.</para>
     101        </listitem>
     102      </varlistentry>
     103
     104      <varlistentry os="af7">
    51105        <term><parameter>--disable-shared</parameter></term>
    52106        <listitem>
    … …  
    55109      </varlistentry>
    56110
    57       <varlistentry>
     111      <varlistentry os="af8">
     112        <term><parameter>--with-mpfr=${CLFS}/cross-tools</parameter></term>
     113        <listitem>
     114          <para>Tells configure where to find the
     115          <filename class="directory">lib</filename> and
     116          <filename class="directory">include</filename> directories
     117          that contain MPFR which was built earlier.</para>
     118        </listitem>
     119      </varlistentry>
     120
     121      <varlistentry os="af9">
     122        <term><parameter>--with-gmp=${CLFS}/cross-tools</parameter></term>
     123        <listitem>
     124          <para>Tells configure where to find the
     125          <filename class="directory">lib</filename> and
     126          <filename class="directory">include</filename> directories
     127          that contain GMP which was built earlier.</para>
     128        </listitem>
     129      </varlistentry>
     130
     131      <varlistentry os="af11">
     132        <term><parameter>--without-headers</parameter></term>
     133        <listitem>
     134          <para>Tells configure to not use any headers from any C libraries.
     135          This is needed as we haven't yet built the C library and to prevent
     136          influence from the host environment.</para>
     137        </listitem>
     138      </varlistentry>
     139
     140      <varlistentry os="af12">
     141        <term><parameter>--with-newlib</parameter></term>
     142        <listitem>
     143          <para>Tells configure to build libgcc without needing any C
     144          libraries.</para>
     145        </listitem>
     146      </varlistentry>
     147
     148      <varlistentry os="af13">
     149        <term><parameter>--disable-decimal-float</parameter></term>
     150        <listitem>
     151          <para>Tells configure to disable IEEE 754-2008 decimal floating
     152          point support.  Decimal floating point support isn't needed yet.</para>
     153        </listitem>
     154      </varlistentry>
     155
     156      <varlistentry os="af14">
     157        <term><parameter>--disable-libgomp</parameter></term>
     158        <listitem>
     159          <para>Tells configure to not build the GOMP run-time libraries.
     160          GOMP is the GNU implementation of OpenMP, a API for shared-memory
     161          parallel programming.</para>
     162        </listitem>
     163      </varlistentry>
     164
     165      <varlistentry os="af15">
     166        <term><parameter>--disable-libmudflap</parameter></term>
     167        <listitem>
     168          <para>Tells configure to not build libmudflap.  Mudflap is a
     169          library that can be used to help check for proper pointer usage.</para>
     170        </listitem>
     171      </varlistentry>
     172
     173      <varlistentry os="af16">
     174        <term><parameter>--disable-libssp</parameter></term>
     175        <listitem>
     176          <para>Tells configure not to build run-time libraries for stack
     177          smashing detection.</para>
     178        </listitem>
     179      </varlistentry>
     180
     181      <varlistentry os="af17">
    58182        <term><parameter>--disable-threads</parameter></term>
    59183        <listitem>
    … …  
    61185          include files, since they haven't been created for this architecture
    62186          yet. GCC will be able to find the multi-thread information after
    63           the Glibc headers are created.</para>
    64         </listitem>
    65       </varlistentry>
    66 
    67       <varlistentry>
     187          the glib headers are created.</para>
     188        </listitem>
     189      </varlistentry>
     190
     191      <varlistentry os="af18">
    68192        <term><parameter>--enable-languages=c</parameter></term>
    69193        <listitem>
Note: See TracChangeset for help on using the changeset viewer.