README.s390

   1
   2 Requirements
   3 ------------
   4 - You need GCC 3.4 or later to compile the s390 port.
   5 - A working combination of autotools is required.
   6 - To run valgrind a z900 machine or any later model is needed.
   7
   8
   9 Limitations
  10 -----------
  11 - 31-bit client programs are not supported.
  12 - Hexadecimal floating point is not supported.
  13 - Decimal floating point is not supported yet.
  14 - Currently, only memcheck, massif, lackey, and none are supported
  15 - helgrind and drd seem to work on SLES10,11 and RHEL5,6 on z9,z10 and z196
  16   but might fail on other hardware/software combinations.
  17 - exp-sgcheck, cachegrind, and callgrind are currently not supported.
  18 - Some gcc versions use mvc to copy 4/8 byte values. This will affect some
  19   debug messages. Valgrind will complain about 4 or 8 one-byte reads/writes
  20   instead of just 1 read/write.
  21
  22
  23 Hardware facilities
  24 -------------------
  25 Valgrind does not require that the host machine has the same hardware
  26 facilities as the machine for which the client program was compiled.
  27 This is convenient. The JIT compiler will translate the client instructions
  28 according to the facilities available on the host.
  29 This means, though, that probing for hardware facilities by issuing
  30 instructions from that facility and observing whether SIGILL is thrown
  31 may not work. As a consequence, programs that attempt to do so may
  32 behave differently. It is believed that this is a rare use case.
  33
  34
  35 Recommendations
  36 ---------------
  37 Applications should be compiled with -fno-builtin to avoid
  38 false positives due to builtin string operations when running memcheck.
  39
  40
  41 Reading Material
  42 ----------------
  43 (1) Linux for zSeries ELF ABI Supplement
  44     http://refspecs.linuxfoundation.org/ELF/zSeries/index.html
  45 (2) z/Architecture Principles of Operation
  46     http://publibfi.boulder.ibm.com/epubs/pdf/dz9zr009.pdf
  47 (3) z/Architecture Reference Summary
  48     http://publibfi.boulder.ibm.com/epubs/pdf/dz9zs007.pdf