Changeset 3bb463d

Timestamp:

03/02/2022 10:02:07 AM (2 years ago)

Author:

Xi Ruoyao <xry111@…>

Branches:

11.2, 11.2-rc1, 11.3, 11.3-rc1, 12.0, 12.0-rc1, 12.1, 12.1-rc1, bdubbs/gcc13, multilib, renodr/libudev-from-systemd, s6-init, trunk, xry111/arm64, xry111/arm64-12.0, xry111/clfs-ng, xry111/lfs-next, xry111/loongarch, xry111/loongarch-12.0, xry111/loongarch-12.1, xry111/mips64el, xry111/pip3, xry111/rust-wip-20221008, xry111/update-glibc

Children:

259b8e0

Parents:

8e0f8a9

git-author:

Xi Ruoyao <xry111@…> (03/01/2022 10:09:30 AM)

git-committer:

Xi Ruoyao <xry111@…> (03/02/2022 10:02:07 AM)

Message:

gcc-pass2: document *_FOR_TARGET parameters

File:

• chapter06/gcc-pass2.xml (modified) (2 diffs)

chapter06/gcc-pass2.xml

@@ -108 +108 @@
 
       <varlistentry>
-        <term><parameter>-with-build-sysroot=$LFS</parameter></term>
+        <term><parameter>--with-build-sysroot=$LFS</parameter></term>
         <listitem>
           <para>Normally, using <parameter>--host</parameter> ensures that
@@ -117 +117 @@
           needed to have them find the needed files in <filename
           class="directory">$LFS</filename>, and not on the host.</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><parameter>--target=$LFS_TGT</parameter></term>
+        <listitem>
+          <para>As we are cross-compiling GCC, it's impossible to build
+          target libraries (<filename class="libraryfile">libgcc</filename>
+          and <filename class="libraryfile">libstdc++</filename>) with the
+          compiled GCC binaries because these binaries won't run on the
+          host distro.  GCC building system will attempt to use the
+          C and C++ compilers on the host distro as a workaround by default.
+          It's not supported to build GCC target libraries with a different
+          version of GCC, so using host compilers may cause building
+          failure.  This parameter ensures to build the libraries with GCC
+          pass 1 and prevent the issue.</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><parameter>LDFLAGS_FOR_TARGET=...</parameter></term>
+        <listitem>
+          <para>Allow <filename class="libraryfile">libstdc++</filename> to
+          use shared <filename class="libraryfile">libgcc</filename> being
+          built in this pass, instead of the static version built in GCC
+          pass 1. This is needed for supporting C++ exception
+          handling.</para>
         </listitem>
       </varlistentry>