libc/sysdeps/linux/i960/README

   1 Overview
   2 ---------------------------------------------------------------------------
   3
   4 This is the README file for the i960 support in uClibc.
   5
   6 This has been tested with gcc 2.95.3 and i960-intel-coff target.
   7
   8 There is no support at all to compile with the intel CTOOLS, as this would
   9 have required too many changes to uClibc.  So you won't see any support
  10 in the asm files for position independent data or code.
  11
  12 Quirks needed
  13 ---------------------------------------------------------------------------
  14
  15 prepended underscore
  16 --------------------
  17
  18 As the i960 compiler prepends an underscore to symbols, it is critical that
  19 bits/uClibc_arch_features.h undefines __UCLIBC_NO_UNDERSCORES__
  20 to make sure that underscores are applied to symbol names when needed.
  21
  22
  23 __va_copy in va-i960.h
  24 ----------------------
  25
  26 When compiled with gcc-2.95, the __va_copy macro in va-i960.h seems to be broken
  27 and it has to be modified in order for uClibc to compile correctly.
  28
  29 Change:
  30
  31 #define __va_copy(dest, src) (dest) = (src)
  32
  33 To:
  34
  35 #define __va_copy(dest, src)  dest[0] = src[0]; dest[1] = src[1]
  36
  37
  38 gcc integration
  39 ---------------------------------------------------------------------------
  40
  41 I've preferred modifying the specs file so that the i960-intel-coff compiler
  42 directly compiles with uClibc.
  43
  44 First, compile and install the standard i960-intel-coff compiler, which is meant
  45 to be used with newlib.
  46
  47 Then, compile uClibc, installing over the newlib include files and libraries.
  48
  49 Update the specs file with the included specs.uclinux.gcc-2.95.i960-intel-coff
  50
  51 This specs file always build relocatable objects, which has the disadvantage
  52 of not letting you know if the link is missing any symbols.
  53
  54 coff2flt
  55 ---------------------------------------------------------------------------
  56
  57 In order to run the executables under uClinux, fully relocatable binaries
  58 need to be built using coff2flt.
  59
  60 We have built a working coff2flt that works with the i960 and the current version
  61 of binfmt_flat with uClinux.
  62
  63 Contact Martin Proulx <mproulx at okiok.com> for further informations.
  64
  65
  66
  67
  68
  69 Check:
  70     _mmap.S: besoin???