Changeset 81fd230 for chapter05/gcc-pass2.xml
- Timestamp:
- 02/19/2005 10:16:42 PM (19 years ago)
- Branches:
- 10.0, 10.0-rc1, 10.1, 10.1-rc1, 11.0, 11.0-rc1, 11.0-rc2, 11.0-rc3, 11.1, 11.1-rc1, 11.2, 11.2-rc1, 11.3, 11.3-rc1, 12.0, 12.0-rc1, 12.1, 12.1-rc1, 6.1, 6.1.1, 6.3, 6.4, 6.5, 6.6, 6.7, 6.8, 7.0, 7.1, 7.2, 7.3, 7.4, 7.5, 7.5-systemd, 7.6, 7.6-systemd, 7.7, 7.7-systemd, 7.8, 7.8-systemd, 7.9, 7.9-systemd, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, arm, bdubbs/gcc13, ml-11.0, 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:
- 3d31fc4
- Parents:
- 2f9131f
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
chapter05/gcc-pass2.xml
r2f9131f r81fd230 8 8 <?dbhtml filename="gcc-pass2.html"?> 9 9 10 <indexterm zone="ch-tools-gcc-pass2"> 11 <primary sortas="a-GCC">GCC</primary> 12 <secondary>tools, pass 2</secondary></indexterm> 13 10 14 <sect2 role="package"><title/> 11 15 … … 16 20 </segmentedlist> 17 21 22 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/gcc.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/> 23 18 24 </sect2> 19 25 … … 21 27 <title>Re-installation of GCC</title> 22 28 23 <para>Check if there is PTYs for the test suites:</para> 29 <para>This package is known to have issues when its default 30 optimization flags (including the <parameter>-march</parameter> and 31 <parameter>-mcpu</parameter> options) are changed. If any environment 32 variables that override default optimizations have been defined, such 33 as <envar>CFLAGS</envar> and <envar>CXXFLAGS</envar>, 34 unset them when building GCC.</para> 35 36 <para>The tools required to test GCC and Binutils—Tcl, Expect 37 and DejaGNU—are installed now. GCC and Binutils can now be 38 rebuilt, linking them against the new Glibc and testing them properly 39 (if running the test suites in this chapter). Please note that these 40 test suites are highly dependent on properly functioning PTYs which 41 are provided by the host. PTYs are most commonly implemented via the 42 <systemitem class="filesystem">devpts</systemitem> file system. Check 43 to see if the host system is set up correctly in this regard by 44 performing a quick test:</para> 24 45 25 46 <screen><userinput>expect -c "spawn ls"</userinput></screen> 26 47 27 <para>Apply two patches:</para> 48 <para>The response might be:</para> 49 50 <screen><computeroutput>The system has no more ptys. 51 Ask your system administrator to create more.</computeroutput></screen> 52 53 <para>If the above message is received, the host does not have its 54 PTYs set up properly. In this case, there is no point in running the 55 test suites for GCC and Binutils until this issue is resolved. Please 56 consult the LFS Wiki at <ulink url="&wiki-root;"/> for more 57 information on how to get PTYs working.</para> 58 59 <para>Because the C and the C++ compilers will be built, unpack both 60 the core and the g++ tarballs (as well as test suite, if you want to 61 run the tests). By unpacking them in the working directory, they will 62 all unfold into a single <filename 63 class="directory">gcc-&gcc-version;/</filename> subdirectory.</para> 64 65 <para>First correct a known problem and make an essential adjustment:</para> 28 66 29 67 <screen><userinput>patch -Np1 -i ../gcc-&gcc-version;-no_fixincludes-1.patch 30 68 patch -Np1 -i ../gcc-&gcc-version;-specs-2.patch</userinput></screen> 31 69 70 <para>The first patch disables the GCC <command>fixincludes</command> 71 script. This was briefly mentioned earlier, but a more in-depth 72 explanation of the fixincludes process is warranted here. Under normal 73 circumstances, the GCC <command>fixincludes</command> script scans the 74 system for header files that need to be fixed. It might find that some 75 Glibc header files on the host system need to be fixed, and will fix 76 them and put them in the GCC private include directory. In <xref 77 linkend="chapter-building-system"/>, after the newer Glibc has been 78 installed, this private include directory will be searched before the 79 system include directory. This may result in GCC finding the fixed 80 headers from the host system, which most likely will not match the 81 Glibc version used for the LFS system.</para> 82 83 <para>The second patch changes GCC's default location of the dynamic 84 linker (typically <filename class="libraryfile">ld-linux.so.2</filename>). It also removes 85 <filename class="directory">/usr/include</filename> from GCC's include 86 search path. Patching now rather than adjusting the specs file after 87 installation ensures that the new dynamic linker is used during the 88 actual build of GCC. That is, all of the final (and temporary) 89 binaries created during the build will link against the new 90 Glibc.</para> 91 92 <important><para>The above patches are critical in ensuring a 93 successful overall build. Do not forget to apply 94 them.</para></important> 95 32 96 <para>Create a separate build directory again:</para> 33 97 34 98 <screen><userinput>mkdir ../gcc-build 35 99 cd ../gcc-build</userinput></screen> 100 101 <para>Before starting to build GCC, remember to unset any environment 102 variables that override the default optimization flags.</para> 36 103 37 104 <para>Now prepare GCC for compilation:</para> … … 43 110 --enable-languages=c,c++ --disable-libstdcxx-pch</userinput></screen> 44 111 112 <para>The meaning of the new configure options:</para> 113 114 <variablelist> 115 <varlistentry> 116 <term><parameter>--enable-clocale=gnu</parameter></term> 117 <listitem><para>This option ensures the correct locale model is 118 selected for the C++ libraries under all circumstances. If the 119 configure script finds the <emphasis>de_DE</emphasis> locale installed, it will select the 120 correct gnu locale model. However, if the <emphasis>de_DE</emphasis> locale is not 121 installed, there is the risk of building Application Binary Interface 122 (ABI)-incompatible C++ libraries because the incorrect generic locale 123 model may be selected.</para></listitem> 124 </varlistentry> 125 126 <varlistentry> 127 <term><parameter>--enable-threads=posix</parameter></term> 128 <listitem><para>This enables C++ exception handling for multi-threaded 129 code.</para></listitem> 130 </varlistentry> 131 132 <varlistentry> 133 <term><parameter>--enable-__cxa_atexit</parameter></term> 134 <listitem><para>This option allows use of 135 <emphasis>__cxa_atexit</emphasis>, rather than 136 <emphasis>atexit</emphasis>, to register C++ destructors for local 137 statics and global objects. This option is essential for fully 138 standards-compliant handling of destructors. It also effects the C++ 139 ABI, and therefore results in C++ shared libraries and C++ programs 140 that are interoperable with other Linux 141 distributions.</para></listitem> 142 </varlistentry> 143 144 <varlistentry> 145 <term><parameter>--enable-languages=c,c++</parameter></term> 146 <listitem><para>This option 147 ensures that both the C and C++ compilers are built.</para></listitem> 148 </varlistentry> 149 150 <varlistentry> 151 <term><parameter>--disable-libstdcxx-pch</parameter></term> 152 <listitem><para>Do not build the pre-compiled header (PCH) for 153 <filename class="libraryfile">libstdc++</filename>. It takes up a lot of space, 154 and we have no use for it.</para></listitem> 155 </varlistentry> 156 </variablelist> 157 45 158 <para>Compile the package:</para> 46 159 47 160 <screen><userinput>make</userinput></screen> 48 161 49 <para>Test the results</para> 162 <para>There is no need to use the <parameter>bootstrap</parameter> 163 target now because the compiler being used to compile this GCC was 164 built from the exact same version of the GCC sources used 165 earlier.</para> 166 167 <para>Compilation is now complete. As previously mentioned, running 168 the test suites for the temporary tools compiled in this chapter is 169 not mandatory. To run the GCC test suite anyway, use the following 170 command:</para> 50 171 51 172 <screen><userinput>make -k check</userinput></screen> 52 173 53 <para>To get a summary of the test suite results, run this:</para> 174 <para>The <parameter>-k</parameter> flag is used to make the test suite run 175 through to completion and not stop at the first failure. The GCC test 176 suite is very comprehensive and is almost guaranteed to generate a few 177 failures. To receive a summary of the test suite results, run:</para> 54 178 55 179 <screen><userinput>../gcc-&gcc-version;/contrib/test_summary</userinput></screen> 56 180 57 181 <para>For only the summaries, pipe the output through 58 <userinput>grep -A7 Summ</userinput> </para>182 <userinput>grep -A7 Summ</userinput>.</para> 59 183 60 184 <para>Results can be compared to those posted to the gcc-testresults 61 mailing list to see similar configurations to the one being built. For an example of how 62 current GCC-&gcc-version; should look on i686-pc-linux-gnu, see 63 <ulink url="http://gcc.gnu.org/ml/gcc-testresults/2004-11/msg00569.html"/>.</para> 64 65 <para>And finally install the package:</para> 185 mailing list to see similar configurations to the one being built. For 186 an example of how current GCC-&gcc-version; should look on 187 i686-pc-linux-gnu, see <ulink 188 url="http://gcc.gnu.org/ml/gcc-testresults/2004-07/msg00179.html"/>.</para> 189 190 <para>A few unexpected failures cannot always be avoided. The 191 GCC developers are usually aware of these issues, but have not 192 resolved them yet. Unless the test results are vastly different from 193 those at the above URL, it is safe to continue.</para> 194 195 <para>Install the package:</para> 66 196 67 197 <screen><userinput>make install</userinput></screen> 68 198 69 <note><para>At this point it is strongly recommended to repeat the sanity check70 we performed earlier in this chapter. Refer back to 71 <xref linkend="ch-tools-adjusting"/> and repeat the little test compilation.If72 the result is wrong, the n most likely you forgot to apply the above mentioned73 GCC Specs patch.</para></note>199 <note><para>At this point it is strongly recommended to repeat the 200 sanity check we performed earlier in this chapter. Refer back to <xref 201 linkend="ch-tools-adjusting" role=","/> and repeat the test compilation. If 202 the result is wrong, the most likely reason is that the GCC Specs 203 patch was not properly applied.</para></note> 74 204 75 205 </sect2> 76 206 207 <sect2 role="content"><title/> 208 <para>Details on this package are located in <xref 209 linkend="contents-gcc" role="."/></para> 210 </sect2> 211 77 212 </sect1> 213
Note:
See TracChangeset
for help on using the changeset viewer.