[lfs-book] r10024 - in trunk/BOOK: chapter01 chapter06

bdubbs at linuxfromscratch.org bdubbs at linuxfromscratch.org
Mon Oct 15 12:27:25 PDT 2012


Author: bdubbs
Date: 2012-10-15 13:27:20 -0600 (Mon, 15 Oct 2012)
New Revision: 10024

Modified:
   trunk/BOOK/chapter01/changelog.xml
   trunk/BOOK/chapter06/binutils.xml
   trunk/BOOK/chapter06/gcc.xml
Log:
Add notes to the gcc and binutils sections in Chapter 6 
about "link time optimization" and the extra files built by gcc.


Modified: trunk/BOOK/chapter01/changelog.xml
===================================================================
--- trunk/BOOK/chapter01/changelog.xml	2012-10-15 18:43:10 UTC (rev 10023)
+++ trunk/BOOK/chapter01/changelog.xml	2012-10-15 19:27:20 UTC (rev 10024)
@@ -40,6 +40,12 @@
       <para>2012-10-15</para>
       <itemizedlist>
         <listitem>
+          <para>[bdubbs] - Add notes to the gcc and binutils
+           sections in Chapter 6 about "link time optimization" 
+           and the extra files built by gcc.  Fixes
+          <ulink url="&lfs-ticket-root;3200">#3200</ulink>.</para>
+        </listitem>
+        <listitem>
           <para>[bdubbs] - Upgrade to tzdata-2012f.  Fixes
           <ulink url="&lfs-ticket-root;3205">#3205</ulink>.</para>
         </listitem>

Modified: trunk/BOOK/chapter06/binutils.xml
===================================================================
--- trunk/BOOK/chapter06/binutils.xml	2012-10-15 18:43:10 UTC (rev 10023)
+++ trunk/BOOK/chapter06/binutils.xml	2012-10-15 19:27:20 UTC (rev 10024)
@@ -78,6 +78,13 @@
 
 <screen><userinput remap="configure">../binutils-&binutils-version;/configure --prefix=/usr --enable-shared</userinput></screen>
 
+    <note><para>There is an optional argument to <command>configure</command>,
+    <option>--enable-lto</option>, that can be used to allow the
+    <command>ar</command>, <command>nm</command>, and <command>ranlib</command>
+    commands to accept a <option>--plugin</option> parameter.  This is used to
+    allow <command>gcc</command> to do "link time optimization" if specified.
+    No packages in LFS or BLFS currently use this capability.</para></note>
+
     <para>Compile the package:</para>
 
 <screen><userinput remap="make">make tooldir=/usr</userinput></screen>

Modified: trunk/BOOK/chapter06/gcc.xml
===================================================================
--- trunk/BOOK/chapter06/gcc.xml	2012-10-15 18:43:10 UTC (rev 10023)
+++ trunk/BOOK/chapter06/gcc.xml	2012-10-15 19:27:20 UTC (rev 10024)
@@ -96,6 +96,16 @@
       </varlistentry>
     </variablelist>
 
+    <note>
+      <para>There is an optional argument to <command>configure</command>,
+      <option>--enable-lto</option>, that can be used to allow
+      <command>gcc</command> to do do "link time optimization" if specified.  No
+      packages in LFS or BLFS currently use this capability.</para>
+    
+      <para>To use this feature, it must also be enabled in
+      <application>binutils</application>.</para> 
+    </note>
+
     <para>Compile the package:</para>
 
 <screen><userinput remap="make">make</userinput></screen>
@@ -301,11 +311,14 @@
       <segtitle>Installed directories</segtitle>
 
       <seglistitem>
-        <seg>c++, cc (link to gcc), cpp, g++, gcc, gccbug, and gcov</seg>
+        <seg>c++, cc (link to gcc), cpp, g++, gcc, 
+        gcc-ar, gcc-nm, gcc-ranlib, gccbug, and gcov</seg>
+
         <seg>libgcc.a, libgcc_eh.a, libgcc_s.so, libgcov.a, libgomp.{a,so},
         liblto_plugin.so, libmudflap.{a,so}, libmudflapth.{a,so},
         libquadmath.{a,so}, libssp.{a,so},
         libssp_nonshared.a, libstdc++.{a,so} and libsupc++.a</seg>
+        
         <seg>/usr/include/c++, /usr/lib/gcc, /usr/share/gcc-&gcc-version;</seg>
       </seglistitem>
     </segmentedlist>
@@ -366,6 +379,45 @@
         </listitem>
       </varlistentry>
 
+      <varlistentry id="gcc-ar">
+        <term><command>gcc-ar</command></term>
+        <listitem>
+          <para>A wrapper around <command>ar</command> that adds a
+          plugin to the command line.  This program is only used
+          to add "link time optization" and is not useful with the
+          default build options.</para>
+          <indexterm zone="ch-system-gcc gcc-ar">
+            <primary sortas="b-gcc-ar">gc-ar</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="gcc-nm">
+        <term><command>gcc-nm</command></term>
+        <listitem>
+          <para>A wrapper around <command>nm</command> that adds a
+          plugin to the command line.  This program is only used
+          to add "link time optization" and is not useful with the
+          default build options.</para>
+          <indexterm zone="ch-system-gcc gcc-nm">
+            <primary sortas="b-gcc-nm">gc-nm</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="gcc-ranlib">
+        <term><command>gcc-ranlib</command></term>
+        <listitem>
+          <para>A wrapper around <command>ranlib</command> that adds a
+          plugin to the command line.  This program is only used
+          to add "link time optization" and is not useful with the
+          default build options.</para>
+          <indexterm zone="ch-system-gcc gcc-ranlib">
+            <primary sortas="b-gcc-ranlib">gc-ranlib</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
       <varlistentry id="gccbug">
         <term><command>gccbug</command></term>
         <listitem>




More information about the lfs-book mailing list