Building an EGCS PowerPC/Linux Cross Compiler For SPARC/Solaris(Updated)

Grant Erickson erick205 at tc.umn.edu
Mon Aug 9 09:07:00 EST 1999


    Building an EGCS PowerPC/Linux Cross Compiler For SPARC/Solaris

There are a number of resources on the Internet serving as a guide for
building a cross compiler. However, each addresses a particular version
of the compiler as well as a particular host/target combination; which
while generally useful as a base instruction set, doesn't cover the
intricacies of performing the feat for a different version and
host/target combination. This document attempts to document the process
of building an EGCS 1.1.2 cross compiler for PowerPC/Linux 2.2.10 on
SPARC/ Solaris 2.7 (aka Solaris 7, SunOS 5.7).

Conventions

In the instructions below, the following conventions are used:

              <archive dir> Location in which you store your
                            archive (i.e. *.tar.gz) files.

              <source dir>  Location in which you unpack your
                            archive files as various source
                            directories.

              <object dir>  Location in which you will build
                            object files from the source
                            dirctories located in
                            <source dir>. This may be the same
                            as <source dir>; however, that is
                            not recommended.

              <tool dir>    Location in which you will place
                            all of the built cross-compiler
                            tools and libraries.

              gmake         GNU version of make

              gtar          GNU version of tar

Instructions

Most of the following steps should work fine with default system tools.
However, the process for building tends to make a number of assumptions
about running with a GNU tool set, in particular, a native EGCS
compiler. That said, it may be useful (I certainly found it to be) to
have /usr/local/gnu/bin or an equivalent GNU tool set in your PATH
before your normal system tools (/usr/bin, /usr/xpg4/bin, /usr/ucb,
etc.). I used these tools:

	Package   Version   Package   Version
	=======   =======   =======   =======
	autoconf    2.13    gzip       1.2.4a
	automake    1.4	    id-utils    3.2  
	bash        2.03    indent     1.10.0
	binutils   2.9.1    less        340  
	bison       1.28    libtool     1.3  
	cpio       2.4.2    m4          1.4  
	cvs        1.10.6   make        3.77 
	diffutils   2.7	    patch       2.5  
	ed          0.2	    readline    4.0  
	egcs       1.1.2    regex       0.12 
	enscript   1.6.1    sed         3.02 
	fileutils   4.0	    sh-utils    1.16 
	findutils   4.1	    sharutils   4.2  
	flex       2.5.4a   tar         1.12 
	gawk       3.0.4    termcap     1.3  
	gdb         4.18    termutils   2.0  
	gdbm       1.8.0    texinfo     3.12 
	gettext     0.10    textutils   1.22 
	grep        2.3	    time        1.7  
	groff      1.11a    which       2.6  

It is also highly encouraged that all the below commands be run while
using bash (preferrably) or ksh as your shell. You will likely even have
better luck if you set the environment variable SHELL to bash or
ksh. All the subsequent examples will assume that this is the
case. Adjust accordingly if you are using csh, tcsh or some other shell.

It is also highly encouraged that all the below commands be run while
using bash (preferrably) or ksh as your shell. You will likely even have
better luck if you set the environment variable SHELL to bash or
ksh. All the subsequent examples will assume that this is the
case. Adjust accordingly if you are using csh, tcsh or some other shell.

Changing the optimization level of the compiler (e.g. -O3), either via
CFLAGS or by another means, is not recommened. Doing so will likely
result in either a failed build step in glibc or a broken
cross-compilation environment.

  1. Packages

     The following packages are required for this endeavor:

      Package              Version   Location

      binutils           2.9.1.0.25  Download

      egcs-core             1.1.2    Download

      egcs                  1.1.2    Download

      glibc                 2.1.1    Download

      glibc-crypt          2.0.111   Download

      glibc-linuxthreads    2.1.1    Download

      linux                2.2.10    Download

  2. Binutils

       1. Extract

            1. cd <source dir>
            2. gtar zxvf <archive dir>/binutils-2.9.1.0.25.tar.gz

       2. Build

            1. mkdir <tool dir>/host
            2. mkdir <tool dir>/host/sparc-sun-solaris
            3. mkdir <object dir>/binutils-2.9.1.0.25
            4. cd <object dir>/binutils-2.9.1.0.25
            5. <source dir>/binutils-2.9.1.0.25/configure
               --target=powerpc-linux
               --prefix=<tool dir>/host/sparc-sun-solaris
            6. gmake

       3. Install

            1. gmake install

       4. Access

          Subsequent build steps will need to use the tools created by
          this step. As such, the path to these tools will need to be 
          added to your environment's PATH variable:

            1. PATH=${PATH}":<tool dir>/host/sparc-sun-solaris/bin"
            2. export PATH

  3. Egcs (Core)

       1. Extract

            1. cd <source dir>
            2. gtar zxvf <archive dir>/egcs-core-1.1.2.tar.gz

       2. Build

            1. mkdir <object dir>/egcs-1.1.2
            2. cd <object dir>/egcs-1.1.2
            3. <source dir>/egcs-1.1.2/configure --target=powerpc-linux
               --prefix=<tool dir>/host/sparc-sun-solaris --with-newlib
            4. gmake

       3. Install

            1. gmake install

  4. Linux Headers

     The 2.2.10 kernel contains PowerPC support; however, it may not
     contain the absolute latest bleeding-edge changes to accomodate
     various PowerPC architectures. Such changes are maintained in the
     "vger" source tree. This is the code repository for the development
     work on non-x86 architectures.

       1. Extract

            1. cd <source dir>
            2. gtar zxvf <archive dir>/linux-2.2.10.tar.gz

          If you want to use the vger source instead of the 2.2.10 version
          source, do so.

            1. cd <source dir>
            2. set CVSROOT=":pserver:anonymous at cvs.on.openprojects.net:\
               /cvs/linux"
            3. export CVSROOT
            4. cvs login
            5. cvs -z 3 checkout -r linux_2_2 linux
            6. cvs logout

       2. Build

            1. cd <source dir>/linux
            2. Edit the Makefile
                 1. Comment out the existing "ARCH :=" line and add a new
                    line with "ARCH := ppc". line.
                 2. Find the "CROSS_COMPILE =" line and append
                    'powerpc-linux-' so that it reads "CROSS_COMPILE =
                    powerpc-linux-"

            3. If you have the GNU ncurses library installed, then "gmake
               menuconfig", otherwise "gmake config".
            4. gmake dep
            5. gmake clean
            6. gmake zImage

          The zImage build process does not have to complete successfully;
          only the headers are required.

       3. Verify

          Verify that the headers were created.

            1. find ./include/. -name "version.h"

          You should see output similar to: "./include/./linux/version.h".

          If you do not have the appropriate headers, use the "gmake
          distclean" command and repeat the steps for this section again.

  5. Glibc

       1. Link

            1. ln -sf <linux source dir>/include/asm
               <tool dir>/host/sparc-sun-solaris/powerpc-linux/include/asm
            2. ln -sf <linux source dir>/include/linux
               <tool dir>/host/sparc-sun-solaris/powerpc-linux/include/linux
            3. ls -la
               <tool dir>/host/sparc-sun-solaris/powerpc-linux/include/asm/*
            4. ls -la
               <tool dir>/host/sparc-sun-solaris/powerpc-linux/include/linux/*

       2. Extract

            1. cd <source dir>
            2. gtar zxvf <archive dir>/glibc-2.1.1.tar.gz
            3. cd <source dir>/glibc-2.1.1
            4. gtar zxvf <archive dir>/glibc-crypt-2.1.1.tar.gz
            5. gtar zxvf <archive dir>/glibc-linuxthreads-2.1.1.tar.gz

       3. Build

          First, Create a separate subdirectory, such as <tool dir>
          /target/powerpc-linux-gnu in which to install the glibc libraries.
          This will be the target of the --prefix configure switch.

          The configure script is quite specific about what versions (and
          flavors) of various build tools it requires. If it doesn't find
          what it's looking for, chance are that things won't build. Try to
          appease it.

            1. mkdir <tool dir>target
            2. mkdir <tool dir>target/powerpc-linux-gnu
            3. mkdir <object dir>/glibc-2.1.1
            4. cd <object dir>/glibc-2.1.1
            5. CC=powerpc-linux-gcc AR=powerpc-linux-ar
               RANLIB=powerpc-linux-ranlib
               <source dir>/glibc-2.1.1/configure --host=powerpc-linux
               --with-headers=<linux source dir>/include
               --enable-add-ons=crypt,linuxthreads
               --prefix=<tool dir>/target/powerpc-linux-gnu
            6. gmake

               There are a few likely pitfalls here. First, depending on
               which echo the make process finds (SVR4, BSD, GNU, shell
               built-in, etc.) there will be an error in csu/version-info.h
               if it picks the wrong one. Picking the wrong one results in
               '-n Version...' rather than the intended 'Version...' in
               csu/version-info.h.

               You will also probably notice in the csu/version-info.h file
               that it reports that it was compiled "on a Linux 5.7 system".
               I am not certain whether or not this should report "on a
               Solaris 2.7 system", on a "SunOS 5.7 system", or "on a Linux
               2.2.10 system". The first or second seem most reasonable. The
               choice you make here will in no may impact the success of
               your build.

            7. Edit and fix the csu/version-info.h file as necessary.
            8. gmake

               The second pitfall when building on a stock Solaris 2.7
               machine, is that there is a limit of 64 open file
               descriptors. This will result in an error building in the
               iconvdata/ subdirectory. This can be remedied by ratcheting
               up the limit to 1024:

            9. /usr/sbin/ulimit -n 1024
           10. gmake

          The overall build process should take several hours to complete,
          even on the brawniest of hardware.

       4. Install

            1. gmake install

               If your build process has completed successfully, the install
               process should go fairly smoothly. One tangle may occur when
               the install process attempts to run in the locale/ directory.
               There are either missing rules for, or the rules don't work
               quite correctly for, the i18n/locales/ and
               i18n/repertoiremaps/ targets.

               If you encounter this problem, to work around it, simply
               create the following directories yourself:

                 1. cd <tool dir>/target/powerpc-linux-gnu/share/
                 2. mkdir i18n
                 3. cd i18n
                 4. mkdir locales
                 5. mkdir repertoiremaps
                 6. cd <object dir>/glibc-2.1.1
                 7. gmake install

          The install process should take about 15 or so minutes, assuming
          that no errors are encountered.

  6. EGCS

     Provided that glibc compiled successfully, you are ready to go back 
     and rebuild the C compiler and, if you wish, build the Objective C, 
     C++ and F77 compilers.

       1. Extract

            1. cd <source dir>
            2. mv egcs-1.1.2 egcs-core-1.1.2
            3. gtar zxvf <archive dir>/egcs-1.1.2.tar.gz

       2. Build

            1. cd <object dir>
            2. mv egcs-1.1.2 egcs-core-1.1.2
            3. mkdir egcs-1.1.2
            4. cd egcs-1.1.2
            5. <source dir>/egcs-1.1.2/configure --target=powerpc-linux
               --prefix=<tool dir>/host/sparc-sun-solaris
               --with-headers=<tool dir>/target/powerpc-linux-gnu/include
               --with-libs=<tool dir>/target/powerpc-linux-gnu/lib
               --enable-shared --enable-languages="c,c++,f77"
            6. gmake

       3. Install

            1. gmake install

  7. Test

     user at ultraSPARC% pwd
     /home/user

     user at ultraSPARC% uname -a
     SunOS ultraSPARC 5.7 Generic sun4u sparc

     user at ultraSPARC% cat > hello.c
     #include <stdio.h>

     int main (void)
     {
             printf("Hello, %s!\n", argc >= 2 ? argv[1] : "world");

             return (0);
     }

     user at ultraSPARC% cat > hello.C
     #include <iostream.h>

     int main (void)
     {
             cout << "Hello, " << ((argc >= 2) ? argv[1] : "world") << "!" << endl;

             return (0);
     }

     user at ultraSPARC% cat > hello.f
             program hello

             print*,'Hello, world!'
             end

     user at ultraSPARC% ~/linuxppc/dev/bin/powerpc-linux-gcc -dumpmachine
     powerpc-linux

     user at ultraSPARC% ~/linuxppc/dev/bin/powerpc-linux-gcc -o helloc -s hello.c

     user at ultraSPARC% file helloc
     hello-c:        ELF 32-bit MSB executable PowerPC Version 1, dynamically linked, stripped

     user at ultraSPARC% ~/linuxppc/dev/bin/powerpc-linux-g++ -dumpmachine
     powerpc-linux

     user at ultraSPARC% ~/linuxppc/dev/bin/powerpc-linux-g++ -o helloC -s hello.C

     user at ultraSPARC% file helloC
     hello-c:        ELF 32-bit MSB executable PowerPC Version 1, dynamically linked, stripped

     user at ultraSPARC% ~/linuxppc/dev/bin/powerpc-linux-g77 -dumpmachine
     powerpc-linux

     user at ultraSPARC% ~/linuxppc/dev/bin/powerpc-linux-g77 -o hellof -s hello.f

     user at ultraSPARC% file hellof
     hello-c:        ELF 32-bit MSB executable PowerPC Version 1, dynamically linked, stripped

     user at ultraSPARC% ssh PowerMac

     user at PowerMac% pwd
     /home/user

     user at PowerMac% uname -a
     Linux PowerMac 2.2.6-15apmac #1 Mon May 31 03:54:09 EDT 1999 ppc unknown

     user at PowerMac% file helloc
     hello: ELF 32-bit MSB executable, PowerPC or cisco 4500, version 1, dynamically linked, stripped

     user at PowerMac% file helloC
     hello: ELF 32-bit MSB executable, PowerPC or cisco 4500, version 1, dynamically linked, stripped

     user at PowerMac% file hellof
     hello: ELF 32-bit MSB executable, PowerPC or cisco 4500, version 1, dynamically linked, stripped

     user at PowerMac% ldd ./helloc
             libc.so.6 => /lib/libc.so.6 (0x016be000)
             /lib/ld.so.1 => /lib/ld.so.1 (0x30000000)

     user at PowerMac% ldd ./helloC
             libstdc++.so.2.9 => /usr/lib/libstdc++.so.2.9 (0x0175b000)
             libm.so.6 => /lib/libm.so.6 (0x01783000)
             libc.so.6 => /lib/libc.so.6 (0x01641000)
             /lib/ld.so.1 => /lib/ld.so.1 (0x30000000)

     user at PowerMac% ldd ./hellof
             libm.so.6 => /lib/libm.so.6 (0x01783000)
             libc.so.6 => /lib/libc.so.6 (0x01641000)
             /lib/ld.so.1 => /lib/ld.so.1 (0x30000000)

     user at PowerMac% ./helloc
     Hello, world!

     user at PowerMac% ./helloC
     Hello, world!

     user at PowerMac% ./hellof
     Hello, world!

Parting Notes

Building all of the above requires a significant amount of space, on the
order of 150 MB for the powerpc-linux cross-development system hosted on
Sun Solaris 2.7. None of the above tools are stripped by default, so
doing so after installation will save an appreciable amount of space.

Useful Resources

   * http://egcs.cygnus.com/install/index.html
   * http://members.home.com/mmporter/cross.html
   * http://developer.intel.com/design/strong/applnots/sa1100lx/sa1100lx.htm
   * http://www.objsw.com/CrossGCC/


[[ This message was sent via the linuxppc-dev mailing list.  Replies are ]]
[[ not  forced  back  to the list, so be sure to Cc linuxppc-dev if your ]]
[[ reply is of general interest. Please check http://lists.linuxppc.org/ ]]
[[ and http://www.linuxppc.org/ for useful information before posting.   ]]





More information about the Linuxppc-dev mailing list