diff options
| -rw-r--r-- | appendixa/gcc-dep.xml | 2 | ||||
| -rw-r--r-- | appendixa/gcc-desc.xml | 16 | ||||
| -rw-r--r-- | appendixa/gcc-shortdesc.xml | 19 | ||||
| -rw-r--r-- | appendixa/gcc.xml | 1 | ||||
| -rw-r--r-- | chapter05/gcc-exp.xml | 38 | ||||
| -rw-r--r-- | chapter05/gcc-inst.xml | 93 | ||||
| -rw-r--r-- | chapter05/gcc.xml | 5 | ||||
| -rw-r--r-- | entities/gcc.ent | 2 |
8 files changed, 115 insertions, 61 deletions
diff --git a/appendixa/gcc-dep.xml b/appendixa/gcc-dep.xml index 6a25150f2..32028936d 100644 --- a/appendixa/gcc-dep.xml +++ b/appendixa/gcc-dep.xml @@ -1,3 +1,5 @@ +<sect2><title> </title><para> </para></sect2> + <sect2> <title>GCC Installation Dependencies</title> diff --git a/appendixa/gcc-desc.xml b/appendixa/gcc-desc.xml index 8848a5120..3193fd7a2 100644 --- a/appendixa/gcc-desc.xml +++ b/appendixa/gcc-desc.xml @@ -1,12 +1,10 @@ -<sect2><title>Contents of GCC</title> +<sect2><title> </title><para> </para></sect2> -<para>Last checked against version &gcc-contversion;.</para> +<sect2><title>Descriptions</title> -<sect3><title>Program Files</title> -<para>c++, c++filt, cc (link to gcc), cc1, cc1plus, collect2, cpp, cpp0, -g++, gcc, gccbug, gcov and tradcpp0</para></sect3> +<para>Last checked against version &gcc-contversion;.</para> -<sect3><title>Descriptions</title> +<sect3><title>Program files descriptions</title> <sect4><title>cc, cc1, cc1plus, gcc</title> <para>These are the C compiler. A compiler translates source code in @@ -49,11 +47,7 @@ code through optimization.</para></sect4> </sect3> -<sect3><title>Library Files</title> -<para>libgcc.a, libgcc_eh.a, libgcc_s.so, libiberty.a, libstdc++.[a,so], -libsupc++.a</para></sect3> - -<sect3><title>Descriptions</title> +<sect3><title>Library files descriptions</title> <sect4><title>libgcc, libgcc_eh, libgcc_s</title> <para>Run-time support files for gcc.</para></sect4> diff --git a/appendixa/gcc-shortdesc.xml b/appendixa/gcc-shortdesc.xml new file mode 100644 index 000000000..7379d26e3 --- /dev/null +++ b/appendixa/gcc-shortdesc.xml @@ -0,0 +1,19 @@ +<sect2><title>Contents of GCC</title> + +<para>Last checked against version &gcc-contversion;.</para> + +<para>The GCC package contains the GNU compiler collecting, including the C +and C++ compilers.</para> + +<para>GCC installs the following files:</para> + +<sect3><title>Program Files</title> +<para>c++, c++filt, cc (link to gcc), cc1, cc1plus, collect2, cpp, cpp0, +g++, gcc, gccbug, gcov and tradcpp0</para></sect3> + +<sect3><title>Library Files</title> +<para>libgcc.a, libgcc_eh.a, libgcc_s.so, libiberty.a, libstdc++.[a,so], +libsupc++.a</para></sect3> + +</sect2> + diff --git a/appendixa/gcc.xml b/appendixa/gcc.xml index 784506a88..a25571bc1 100644 --- a/appendixa/gcc.xml +++ b/appendixa/gcc.xml @@ -3,6 +3,7 @@ <?dbhtml filename="gcc.html" dir="appendixa"?> &aa-gcc-down; +&aa-gcc-shortdesc; &aa-gcc-desc; &aa-gcc-dep; diff --git a/chapter05/gcc-exp.xml b/chapter05/gcc-exp.xml deleted file mode 100644 index 051d13d14..000000000 --- a/chapter05/gcc-exp.xml +++ /dev/null @@ -1,38 +0,0 @@ -<sect2> -<title>Command explanations</title> - -<para><userinput>--prefix=/static:</userinput> This is NOT a typo. GCC hard -codes some paths while compiling and so we need to pass /static as the -prefix during ./configure. We pass the real install prefix during the -make install command later.</para> - -<para><userinput>--with-as and --with-ld:</userinput> GCC can be -miscompiled if your host distribution's Binutils package is quite old. We -need a good working static GCC until we reinstall GCC later in chapter 6. -So by using <filename>as</filename> and <filename>ld</filename> from the -Binutils package we just compiled we ensure that GCC will work -correctly.</para> - -<para><userinput>make BOOT_LDFLAGS="-static":</userinput> -This is the equivalent to make LDFLAGS="-static" as we use with other -packages to compile them statically.</para> - -<para><userinput>make install-no-fixedincludes:</userinput> -This prevents the fixincludes script from running. Preventing this is -necessary because under normal circumstances the GCC installation will run -the fixincludes script which scans your system for header files that need to -be fixed. It might find that the Glibc header files of your host system need -to be fixed. If so, it will fix them and put them in -<filename>$LFS/static/lib/gcc-lib/i686-pc-linux-gnu/3.2</filename>. -Later on in chapter 6 you will install Glibc which will put its header -files in <filename>/usr/include</filename>. Next you will install other -programs that use the Glibc headers. GCC will look in -<filename>/static/lib/gcc-lib</filename> before looking in -<filename>/usr/include</filename>, with the result of finding and using -the fixed Glibc header files from your host distribution, which are probably -incompatible with the Glibc version actually used on the LFS system.</para> - -<para><userinput>ln -s gcc $LFS/static/bin/cc:</userinput> This -creates the $LFS/static/bin/gcc symlink, which some packages need.</para> - -</sect2> diff --git a/chapter05/gcc-inst.xml b/chapter05/gcc-inst.xml index cc3d011f7..1de7f2a99 100644 --- a/chapter05/gcc-inst.xml +++ b/chapter05/gcc-inst.xml @@ -1,3 +1,5 @@ +<sect2><title> </title><para> </para></sect2> + <sect2> <title>Installation of GCC</title> @@ -11,17 +13,92 @@ that override default optimizations, such as CFLAGS and CXXFLAGS, we recommend unsetting or modifying them when building GCC. You have been warned.</para> -<para>Install GCC by running the following commands:</para> +<para>It is recommended by the GCC installation documentation to build +GCC outside of the source directory in a dedicated directory:</para> + +<para><screen><userinput>mkdir ../gcc-build +cd ../gcc-build</userinput></screen></para> + +<para>Prepare GCC to be compiled:</para> -<para><screen><userinput>mkdir ../gcc-build && -cd ../gcc-build && -../gcc-&gcc-version;/configure --prefix=/static \ +<para><screen><userinput>../gcc-&gcc-version;/configure --prefix=/static \ --disable-nls --disable-shared \ --with-as=$LFS/static/bin/as \ - --with-ld=$LFS/static/bin/ld && -make BOOT_LDFLAGS="-static" bootstrap && -make prefix=$LFS/static install-no-fixedincludes && -ln -s gcc $LFS/static/bin/cc</userinput></screen></para> + --with-ld=$LFS/static/bin/ld</userinput></screen></para> + +<para>The meaning of the configure options are:</para> + +<itemizedlist> +<listitem><para><userinput>--prefix=/static:</userinput> This is NOT a +typo. GCC hard codes some paths while compiling and so we need to pass +<filename class="directory">/static</filename> as the prefix during the +configure stage. We pass the real install prefix during the installation +stage later on.</para></listitem> + +<listitem><para><userinput>--disable-shared:</userinput> This prevents the +build of dynamic libraries. They are useless to us at the moment. We'll +create them when we reinstall GCC in chapter 6.</para></listitem> + +<listitem><para><userinput>--with-as=$LFS/static/bin/as and +--with-ld=$LFS/static/bin/ld:</userinput> GCC can be miscompiled if your +host distribution's Binutils package is quite old. We need a good working +static GCC until we reinstall GCC later in chapter 6. So by using +<filename>as</filename> and <filename>ld</filename> from the Binutils +package we compiled earlier in this chapter we ensure that GCC will work +correctly.</para></listitem> +</itemizedlist> + +<para>Continue with compiling the package:</para> + +<para><screen><userinput>make BOOT_LDFLAGS="-static" bootstrap</userinput></screen></para> + +<para>The meaning of the make options are:</para> + +<itemizedlist> +<listitem><para><userinput>BOOT_LDFLAGS="-static":</userinput> This is +GCC's equivalent to make LDFLAGS="-static" as we use with other packages to +compile them statically.</para></listitem> + +<listitem><para><userinput>bootstrap:</userinput> The +<emphasis>bootstrap</emphasis> target doesn't just compile GCC, but it +compiles GCC a second time. It uses the first compiled programs to compile +itself a second and third time to make sure the compiler compiled properly +and can compile itself properly.</para></listitem> +</itemizedlist> + +<para>And finish off installing the package:</para> + +<para><screen><userinput>make prefix=$LFS/static install-no-fixedincludes</userinput></screen></para> + +<para>The meaning of the make option is:</para> + +<itemizedlist> +<listitem><para><userinput>install-no-fixedincludes:</userinput> This prevents +the fixincludes script from running. Preventing this is necessary because +under normal circumstances the GCC installation will run the fixincludes +script which scans your system for header files that need to be fixed. It +might find that the Glibc header files of your host system need to be fixed. +If so, it will fix them and put them in +<filename>$LFS/static/lib/gcc-lib/i686-pc-linux-gnu/3.2</filename>. Later on +in chapter 6 you will install Glibc which will put its header files in +<filename>/usr/include</filename>. Next you will install other programs that +use the Glibc headers. GCC will look in +<filename>/static/lib/gcc-lib</filename> before looking in +<filename>/usr/include</filename>, with the result of finding and using the +fixed Glibc header files from your host distribution, which are probably +incompatible with the Glibc version actually used on the LFS +system.</para></listitem> +</itemizedlist> + +<para>As the finishing touch we'll create the <filename +class="symlink">$LFS/static/bin/cc</filename> symlink. A lot of programs +and scripts try to run <userinput>cc</userinput> instead of +<userinput>gcc</userinput> This is to keep programs generic and usable on +all kinds of Unix systems. Not everybody has GNU CC installed. Just running +cc (C Compiler) leaves the user free to decide which C compiler to install. +The symlink will point to the system's default compiler.</para> + +<para><screen><userinput>ln -s gcc $LFS/static/bin/cc</userinput></screen></para> </sect2> diff --git a/chapter05/gcc.xml b/chapter05/gcc.xml index 559009c74..b9b7d52ea 100644 --- a/chapter05/gcc.xml +++ b/chapter05/gcc.xml @@ -5,10 +5,9 @@ <screen>Estimated build time: &gcc-time-static; Estimated required disk space: &gcc-compsize-static;</screen> -&c5-gcc-inst; -&c5-gcc-exp; -&aa-gcc-desc; +&aa-gcc-shortdesc; &aa-gcc-dep; +&c5-gcc-inst; </sect1> diff --git a/entities/gcc.ent b/entities/gcc.ent index ca64fadf5..5a43b097e 100644 --- a/entities/gcc.ent +++ b/entities/gcc.ent @@ -3,13 +3,13 @@ <!ENTITY c5-gcc SYSTEM "../chapter05/gcc.xml"> <!ENTITY c5-gcc-inst SYSTEM "../chapter05/gcc-inst.xml"> -<!ENTITY c5-gcc-exp SYSTEM "../chapter05/gcc-exp.xml"> <!ENTITY c6-gcc SYSTEM "../chapter06/gcc.xml"> <!ENTITY c6-gcc-inst SYSTEM "../chapter06/gcc-inst.xml"> <!ENTITY c6-gcc-exp SYSTEM "../chapter06/gcc-exp.xml"> <!ENTITY aa-gcc SYSTEM "../appendixa/gcc.xml"> +<!ENTITY aa-gcc-shortdesc SYSTEM "../appendixa/gcc-shortdesc.xml"> <!ENTITY aa-gcc-desc SYSTEM "../appendixa/gcc-desc.xml"> <!ENTITY aa-gcc-dep SYSTEM "../appendixa/gcc-dep.xml"> <!ENTITY aa-gcc-down SYSTEM "../appendixa/gcc-down.xml"> |