1
2Requirements
3------------
4- You need GCC 3.4 or later to compile the s390 port.
5- To run valgrind a z10 machine or any later model is recommended.
6  Older machine models down to and including z990 may work but have
7  not been tested extensively.
8
9
10Limitations
11-----------
12- 31-bit client programs are not supported.
13- Hexadecimal floating point is not supported.
14- Transactional memory is not supported.
15- Instructions operating on vector registers are not supported.
16- memcheck, cachegrind, drd, helgrind, massif, lackey, and none are
17  supported.
18- On machine models predating z10, cachegrind will assume a z10 cache
19  architecture. Otherwise, cachegrind will query the hosts cache system
20  and use those parameters.
21- callgrind and all experimental tools are currently not supported.
22- Some gcc versions use mvc to copy 4/8 byte values. This will affect
23  certain debug messages. For example, memcheck will complain about
24  4 one-byte reads/writes instead of just a single read/write.
25
26
27Hardware facilities
28-------------------
29Valgrind does not require that the host machine has the same hardware
30facilities as the machine for which the client program was compiled.
31This is convenient. If possible, the JIT compiler will translate the
32client instructions according to the facilities available on the host.
33This means, though, that probing for hardware facilities by issuing
34instructions from that facility and observing whether SIGILL is thrown
35may not work. As a consequence, programs that attempt to do so may
36behave differently. It is believed that this is a rare use case.
37
38
39Recommendations
40---------------
41Applications should be compiled with -fno-builtin to avoid
42false positives due to builtin string operations when running memcheck.
43
44
45Reading Material
46----------------
47(1) Linux for zSeries ELF ABI Supplement
48    http://refspecs.linuxfoundation.org/ELF/zSeries/index.html
49(2) z/Architecture Principles of Operation
50    http://publibfi.boulder.ibm.com/epubs/pdf/dz9zr010.pdf
51(3) z/Architecture Reference Summary
52    http://publibfi.boulder.ibm.com/epubs/pdf/dz9zs008.pdf
53