1 files changed, 62 insertions, 0 deletions
diff --git a/toolchain/elf2flt/elf2flt/README b/toolchain/elf2flt/elf2flt/README
new file mode 100644
index 000000000..6e8a687e1
--- /dev/null
+++ b/toolchain/elf2flt/elf2flt/README
@@ -0,0 +1,62 @@
+
+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).
+