blob: 034cc3198f52330b8a655831f4473d607badd29e [file] [log] [blame]
floriandec4a562011-11-26 04:12:01 +00001
sewardjb5b87402011-03-07 16:05:35 +00002Requirements
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.
sewardjb5b87402011-03-07 16:05:35 +00007
8
9Limitations
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- Some gcc versions use mvc to copy 4/8 byte values. This will affect some
18 debug messages. Valgrind will complain about 4 or 8 one-byte reads/writes
19 instead of just 1 read/write.
20- exp-ptrcheck and callgrind are not supported.
21
22
23Recommendations
24---------------
25Applications should be compiled with -fno-builtin to avoid
26false positives due to builtin string operations when running memcheck.
27
28
29Reading Material
30----------------
31(1) Linux for zSeries ELF ABI Supplement
32 http://refspecs.linuxfoundation.org/ELF/zSeries/index.html
33(2) z/Architecture Principles of Operation
34 http://publibfi.boulder.ibm.com/epubs/pdf/dz9zr008.pdf
35(3) z/Architecture Reference Summary
36 http://publibfi.boulder.ibm.com/epubs/pdf/dz9zs006.pdf