HOWTO build arm-linux toolchain for ARM/XSCALE

　　These instrUCtions document how to build an arm-Linux tool chain
that contains both little-endian and big-endian target libraries.

1. Packages used:

    binutils-2.14.tar.gz
    gcc-3.3.2.tar.gz
    glibc-2.2.5.tar.gz
    glibc-linuxthreads-2.2.5.tar.gz

2. binutils-2.14

   tar xvzf binutils-2.14.tar.gz
   cd binutils-2.14
   mkdir arm-linux
   cd arm-linux
   ../configure --target=arm-linux

   vi ld/earmelf_linux.c
     - add a new SERACH_DIR line for every current SERACH_DIR line in file
SEARCH_DIR(\"/usr/local/arm-linux/lib/be\");\n\

   make
   make install
   chmod 777 /usr/local/arm-linux

3. gcc-3.3.2

   tar xvzf gcc-3.3.2.tar.gz
   cd gcc-3.3.2
   cp $(ATTACHED t-linux file) gcc/config/arm/
   mkdir arm-linux
   cd arm-linux
   ../configure --target=arm-linux --disable-shared --disable-threads \
--with-headers=linux-2.4.x/include \
--with-gnu-as --with-gnu-ld --enable-multilib --enable-languages=c
   make install

4. glibc-2.2.5 (big-endian)

   tar xvzf glibc-2.2.5.tar.gz
   cd glibc-2.2.5
   tar xvzf glibc-linuxthreads-2.2.5.tar.gz

   perl -pi -e 's/i386/arm*)\n\tlibc_cv_gcc_unwind_find_fde=yes\n\tarch_minimum_kernel=2.0.10\n\t;;\n   i386/' sysdeps/unix/sysv/linux/configure
   perl -pi -e 's/weak_alias \(__old_sys_nerr/\/\/ $&/' sysdeps/unix/sysv/linux/arm/errlist.c
   vi linuxthreads/sysdeps/pthread/pthread.h
      - change line 163, "__thread" -> "__thr"
      - change line 591, "__thread" -> "__thr"
   vi linuxthreads/internals.h
      - change line 555, "__thread" -> "__thr"
   vi linuxthreads/sysdeps/unix/sysv/linux/bits/sigthread.h
      - change line 36, "__thread" -> "__thr"
   vi stdio-common/sprintf.c
      - line 30, change to "sprintf(char *s, const char *format, ...)"
   vi stdio-common/sscanf.c
      - line 30, change to "sscanf(const char *s, const char *format, ...)"
   vi sysdeps/unix/sysv/linux/arm/sysdep.h
      - line 134, remove "a1" from clobber list
   vi sysdeps/arm/dl-machine.h
      - add '\n\' to end of all macro asm lines (there is a _lot_ of them)

   vi config.make.in
      - change "slibdir=@...@" to "slibdir=@libdir@"

   mkdir arm-linux
   cd arm-linux
   CC="arm-linux-gcc -mbig-endian -finline-limit=10000" \
   AS="arm-linux-as -mbig-endian" \
   LD="arm-linux-ld -EB" \
   ../configure --host=arm-linux --build=i686-pc-linux-gnu \
--with-headers=linux-2.4.x/include \
--enable-add-ons --enable-shared --prefix=/usr/local/arm-linux \
--libdir=/usr/local/arm-linux/lib/be
   make
   make install

5. glibc-2.2.5 (little-endian)

   tar xvzf glibc-2.2.5.tar.gz
   cd glibc-2.2.5
   tar xvzf glibc-linuxthreads-2.2.5.tar.gz

   [ Apply same fixes as above ]

   mkdir arm-linux
   cd arm-linux
   CC="arm-linux-gcc -finline-limit=10000" \
   AS="arm-linux-as" \
   LD="arm-linux-ld" \
   ../configure --host=arm-linux --build=i686-pc-linux-gnu \
--with-headers=linux-2.4.x/include \
--enable-add-ons --enable-shared --prefix=/usr/local/arm-linux
   make
   make install

6. gcc-3.3.2 (c++, etc)

   tar xvzf gcc-3.3.2.tar.gz
   cd gcc-3.3.2

   cp $(ATTACHED t-linux file) gcc/config/arm/
   vi gcc/config/arm/t-linux
      - remove all "-Dinhibit_libc" occruances

   mkdir arm-linux
   cd arm-linux
   ../configure --target=arm-linux --disable-shared \
--with-headers=linux-2.4.x/include \
--with-gnu-as --with-gnu-ld --enable-multilib
   perl -pi -e 's/int namelen/unsigned int namelen/' ../libJava/java/net/natInetAddress.cc
   make
   make install

7. cd /
   tar cvzf /tmp/arm-linux-tools-xxxxxxxx.tar.gz /usr/local/arm-linux \
/usr/local/lib/gcc-lib/arm-linux /usr/local/include/c++/3.3.2 \
/usr/local/bin/arm-linux-* /usr/local/bin/genext2fs

------------------------------------------------------------------------------

APPENDIX A -- modified t-linux for gcc-3.3.2

------------------------------------------------------------------------------
# Just for these, we omit the frame pointer since it makes such a big
# difference. It is then pointless adding debugging.
TARGET_LIBGCC2_CFLAGS = -fomit-frame-pointer -fPIC -Dinhibit_libc -D__gthr_posix
LIBGCC2_DEBUG_CFLAGS = -g0

# Don't build enquire
ENQUIRE=

LIB1ASMSRC = arm/lib1funcs.asm
LIB1ASMFUNCS = _udivsi3 _divsi3 _umodsi3 _modsi3 _dvmd_lnx

# MULTILIB_OPTIONS = mhard-float/msoft-float
# MULTILIB_DIRNAMES = hard-float soft-float
MULTILIB_OPTIONS = mlittle-endian/mbig-endian
MULTILIB_DIRNAMES = le be

# If you want to build both APCS variants as multilib options this is how
# to do it.
# MULTILIB_OPTIONS += mapcs-32/mapcs-26
# MULTILIB_DIRNAMES += apcs-32 apcs-26

EXTRA_MULTILIB_PARTS = crtbegin.o crtbeginS.o crtend.o crtendS.o crti.o crtn.o

LIBGCC = stmp-multilib
INSTALL_LIBGCC = install-multilib
T_CFLAGS = -Dinhibit_libc -D__gthr_posix_h

# Assemble startup files.
$(T)crti.o: $(srcdir)/config/arm/crti.asm $(GCC_PASSES)
$(GCC_FOR_TARGET) $(GCC_CFLAGS) $(MULTILIB_CFLAGS) $(INCLUDES) \
-c -o $(T)crti.o -x assembler-with-cpp $(srcdir)/config/arm/crti.asm

$(T)crtn.o: $(srcdir)/config/arm/crtn.asm $(GCC_PASSES)
$(GCC_FOR_TARGET) $(GCC_CFLAGS) $(MULTILIB_CFLAGS) $(INCLUDES) \
-c -o $(T)crtn.o -x assembler-with-cpp $(srcdir)/config/arm/crtn.asm
------------------------------------------------------------------------------