To build SnapGear or RedBoot a different toolchain is needed for each. If you have your own arm-linux- 
toolchain capable of generating MSB/Big Endian binaries, you may find it to work fine building SnapGear 
and/or RedBoot, however we have only tested and verified the two toolchains listed below to work with 
SnapGear and RedBoot.




SnapGear Toolchain
----------------------------------------

The SnapGear specific arm-linux toolchain date version is 20031127, the complete filename is 
arm-linux-tools-20031127.tar.bz2. This toolchain is included on this CDROM but alternately can be downloaded directly from 
SnapGear at the following address:

  http://ftp.snapgear.org/pub/snapgear/tools/arm-linux/arm-linux-tools-20031127.tar.gz


This toolchain MUST be installed into /usr/local on your build host and WILL NOT function correctly if installed anywhere 
else.


To check and see if you have this toolchain already installed, perform the following commands at a shell prompt and verify 
your output to match:

# arm-linux-gcc -v

Reading specs from /usr/local/lib/gcc-lib/arm-linux/3.3.2/specs
Configured with: ../configure --target=arm-linux --disable-shared
--with-headers=/home/gerg/new-wave.xscale/linux-2.4.x/include --with-gnu-as --with-gnu-ld --enable-multilib
Thread model: posix
gcc version 3.3.2

# arm-linux-ld -v

GNU ld version 2.14 20030612


If the above version information matches your toolchain you can skip installing the SnapGear toolchain below.



Extracting/Installing SnapGear Toolchain
----------------------------------------

Before installing the SnapGear specific toolchain you should make sure you will not overwrite anything of importance in 
your /usr/local directory on your build host. Installing (extracting) the SnapGear toolchain will place the toolchain under 
/usr/local and occupy the following directories:

/usr/local/arm-linux
/usr/local/bin
/usr/local/include
/usr/local/lib


Assuming the SnapGear toolchain tarball is located in /cdrom/Source, perform the following:

# cd /
# tar -xfj /cdrom/Source/arm-linux-tools-20031127.tar.bz2


Note: If you have downloaded the arm-linux-tools tarball from the web address above it will be gzipped and contain a .gz 
extension, not .bz2. Replace the tar arguments with -xfz.


As long as /usr/local/bin is in your $PATH, you are ready to use the SnapGear toolchain. To verify /usr/local/bin
is in your $PATH:

# arm-linux-gcc -v
# arm-linux-ld -v

should report the version information shown above.










RedBoot Toolchain
----------------------------------------

The RedBoot specific xscale-elf- toolchain filename is i686-pc-linux-gnulibc2.2-x-xscale-elf.tar.bz2. This toolchain is 
included on this CDROM but alternately can be downloaded directly from RedHat at the following address:


	ftp://ftp.ges.redhat.com/private/gnupro-xscale-030422/i686-pc-linux-gnulibc2.2-x-xscale-elf.tar.Z


This toolchain can be installed anywhere but the H-i686-pc-linux-gnulibc2.2/bin directory MUST be in your path.


To check and see if you have this toolchain already installed, perform the following and verify your output 
to match:

# xscale-elf-gcc -v

Reading specs from /usr/local/redhat/H-i686-pc-linux-gnulibc2.2/bin/../lib/gcc-lib/xscale-elf/RedHat-3.3/specs
Configured with: /es/build/intel-xscale/xscale-030422/i686-pc-linux-gnulibc2.2/src/configure -v 
--host=i686-pc-linux-gnulibc2.2 --build=i686-pc-linux-gnulibc2.2 --prefix=/opt/redhat/xscale-030422 
--exec-prefix=/opt/redhat/xscale-030422/H-i686-pc-linux-gnulibc2.2 --target=xscale-elf --enable-languages=c,c++
Thread model: single
gcc version RedHat-3.3 20021213

# xscale-elf-ld -v 

GNU ld version 2.13-xscale-030422 20021214


If the above version information matches your toolchain you can skip installing the RedBoot toolchain below.

Note: Your xscale-elf-gcc -v output may differ slightly if it is not installed in /usr/local/redhat.





Extracting/Installing RedBoot Toolchain
----------------------------------------

Find a convenient location to extract the RedBoot toolchain such as /usr/local/redhat. Assuming the RedBoot toolchain 
tarball is located in /cdrom/Source, perform the following:

# mkdir -p /usr/local/redhat
# cd /usr/local/redhat
# tar -xfj /cdrom/Source/i686-pc-linux-gnulibc2.2-x-xscale-elf.tar.bz2

Note: If you have downloaded the RedBoot toolchain tarball from the web address above it will be compressed with a .Z 
extension and not .bz2. Uncompress it first with the uncompress command then untar it with tar -xf.



Once extraction is complete make sure to add the H-i686-pc-linux-gnulibc2.2/bin directory to your path:


Temporarily

# export PATH=<path to toolchain>/H-i686-pc-linux-gnulibc2.2/bin:$PATH


Permanently

Add to your home .bashrc, profile or other startup environment file.




# xscale-elf-gcc -v
# xscale-elf-ld -v

should now report similar to the output above.