README

   1
   2 README - elf2flt
   3 ----------------
   4
   5 Copyright (C) 2001-2003, SnapGear (www.snapgear.com)
   6 davidm@snapgear.com
   7 gerg@snapgear.com
   8
   9
  10 Elf2flt with PIC, ZFLAT and full reloc support. Currently supported
  11 targets include: m68k/ColdFire, ARM, Sparc, NEC v850, h8300 and SuperH.
  12
  13
  14 COMPILING:
  15
  16 You need an appropriate libbfd.a and libiberty.a for your target to
  17 build this tool. They are normally part of the binutils package.
  18
  19 To compile elf2flt do:
  20
  21     ./configure --target=<ARCH> --with-libbfd=<libbfd.a> --with-libiberty=<libiberty.a>
  22     make
  23     make install
  24
  25 The <ARCH> argument to configure specifies what the target architecture is.
  26 This should be the same target as you used to build the binutils and gcc
  27 cross development tools. The --with-libbfd and --with-libiberty arguments
  28 specify where the libbfd.a and libiberty.a library files are to use.
  29
  30
  31 FILES:
  32
  33 README      - this file
  34 configure   - autoconf configuration shell script
  35 configure.in- original autoconf file
  36 config.*    - autoconf support scripts
  37 Makefile.in - Makefile template used by configure
  38 elf2flt.c   - the source
  39 flthdr.c    - flat header manipulation program
  40 flat.h      - header from uClinux kernel sources
  41 elf2flt.ld  - an example linker script that works for C/C++ and uClinux
  42 ld-elf2flt  - A linker replacement that implements a -elf2flt option for the
  43               linker and runs elf2flt automatically for you.  It auto
  44               detects PIC/non-PIC code and adjusts it's option accordingly.
  45               It uses the environment variable FLTFLAGS when running
  46               elf2flt.  It runs /.../m68k-elf-ld.real to do the actual
  47               linking.
  48
  49 TIPS:
  50
  51 The ld-elf2flt produces 2 files as output.  The binary flat file X, and
  52 X.gdb which is used for debugging and PIC purposes.
  53
  54 The '-p' option requires an elf executable linked at address 0.  The
  55 elf2flt.ld provided will generate the correct format binary when linked
  56 with the real linker with *no* '-r' option for the linker.
  57
  58 The '-r' flag can be added to PIC builds to get contiguous code/data.  This
  59 is good for loading application symbols into gdb (add-symbol-file XXX.gdb).
  60