Changeset 8ac7bce6


Ignore:
Timestamp:
03/03/2022 04:49:27 PM (7 months ago)
Author:
William Harrington <kb0iic@…>
Branches:
arm
Children:
9e1ce87
Parents:
b6d0e2b
git-author:
Xi Ruoyao <xry111@…> (03/01/2022 10:09:30 AM)
git-committer:
William Harrington <kb0iic@…> (03/03/2022 04:49:27 PM)
Message:

gcc-pass2: document *_FOR_TARGET parameters

File:
1 edited

Legend:

Unmodified
Added
Removed
  • chapter06/gcc-pass2.xml

    rb6d0e2b r8ac7bce6  
    112112
    113113      <varlistentry>
    114         <term><parameter>-with-build-sysroot=$LFS</parameter></term>
     114        <term><parameter>--with-build-sysroot=$LFS</parameter></term>
    115115        <listitem>
    116116          <para>Normally, using <parameter>--host</parameter> ensures that
     
    121121          needed to have them find the needed files in <filename
    122122          class="directory">$LFS</filename>, and not on the host.</para>
     123        </listitem>
     124      </varlistentry>
     125
     126      <varlistentry>
     127        <term><parameter>--target=$LFS_TGT</parameter></term>
     128        <listitem>
     129          <para>As we are cross-compiling GCC, it's impossible to build
     130          target libraries (<filename class="libraryfile">libgcc</filename>
     131          and <filename class="libraryfile">libstdc++</filename>) with the
     132          compiled GCC binaries because these binaries won't run on the
     133          host distro.  GCC building system will attempt to use the
     134          C and C++ compilers on the host distro as a workaround by default.
     135          It's not supported to build GCC target libraries with a different
     136          version of GCC, so using host compilers may cause building
     137          failure.  This parameter ensures to build the libraries with GCC
     138          pass 1 and prevent the issue.</para>
     139        </listitem>
     140      </varlistentry>
     141
     142      <varlistentry>
     143        <term><parameter>LDFLAGS_FOR_TARGET=...</parameter></term>
     144        <listitem>
     145          <para>Allow <filename class="libraryfile">libstdc++</filename> to
     146          use shared <filename class="libraryfile">libgcc</filename> being
     147          built in this pass, instead of the static version built in GCC
     148          pass 1. This is needed for supporting C++ exception
     149          handling.</para>
    123150        </listitem>
    124151      </varlistentry>
Note: See TracChangeset for help on using the changeset viewer.