README - elf2flt
----------------
Copyright (C) 2001-2003, SnapGear (www.snapgear.com)
davidm@snapgear.com
gerg@snapgear.com
This is Free Software, under the GNU Public Licence v2 or greater. See
LICENSE.TXT for more details.
Elf2flt with PIC, ZFLAT and full reloc support. Currently supported
targets include: m68k/ColdFire, ARM, Sparc, NEC v850, MicroBlaze,
h8300 and SuperH.
COMPILING:
You need an appropriate libbfd.a and libiberty.a for your target to
build this tool. They are normally part of the binutils package.
To compile elf2flt do:
./configure --target=<ARCH> --with-libbfd=<libbfd.a> --with-libiberty=<libiberty.a>
make
make install
The <ARCH> argument to configure specifies what the target architecture is.
This should be the same target as you used to build the binutils and gcc
cross development tools. The --with-libbfd and --with-libiberty arguments
specify where the libbfd.a and libiberty.a library files are to use.
FILES:
README - this file
configure - autoconf configuration shell script
configure.in- original autoconf file
config.* - autoconf support scripts
Makefile.in - Makefile template used by configure
elf2flt.c - the source
flthdr.c - flat header manipulation program
flat.h - header from uClinux kernel sources
elf2flt.ld - an example linker script that works for C/C++ and uClinux
ld-elf2flt - A linker replacement that implements a -elf2flt option for the
linker and runs elf2flt automatically for you. It auto
detects PIC/non-PIC code and adjusts its option accordingly.
It uses the environment variable FLTFLAGS when running
elf2flt. It runs /.../m68k-elf-ld.real to do the actual
linking.
TIPS:
The ld-elf2flt produces 2 files as output. The binary flat file X, and
X.gdb which is used for debugging and PIC purposes.
The '-p' option requires an elf executable linked at address 0. The
elf2flt.ld provided will generate the correct format binary when linked
with the real linker with *no* '-r' option for the linker.
The '-r' flag can be added to PIC builds to get contiguous code/data. This
is good for loading application symbols into gdb (add-symbol-file XXX.gdb).