blob: 2dff9dedd6ac8cc49c747fd049cf83e471b9980d [file] [log] [blame]
sewardjb5b87402011-03-07 16:05:35 +00001Requirements
2------------
3- You need GCC 3.4 or later to compile the s390 port.
4- A working combination of autotools is required.
5- To run valgrind a z900 machine or any later model is needed.
sewardjb5b87402011-03-07 16:05:35 +00006
7
8Limitations
9-----------
10- 31-bit client programs are not supported.
11- Hexadecimal floating point is not supported.
12- Decimal floating point is not supported yet.
13- Currently, only memcheck, massif, lackey, and none are supported
14- helgrind and drd seem to work on SLES10,11 and RHEL5,6 on z9,z10 and z196
15 but might fail on other hardware/software combinations.
16- Some gcc versions use mvc to copy 4/8 byte values. This will affect some
17 debug messages. Valgrind will complain about 4 or 8 one-byte reads/writes
18 instead of just 1 read/write.
19- exp-ptrcheck and callgrind are not supported.
20
21
22Recommendations
23---------------
24Applications should be compiled with -fno-builtin to avoid
25false positives due to builtin string operations when running memcheck.
26
27
28Reading Material
29----------------
30(1) Linux for zSeries ELF ABI Supplement
31 http://refspecs.linuxfoundation.org/ELF/zSeries/index.html
32(2) z/Architecture Principles of Operation
33 http://publibfi.boulder.ibm.com/epubs/pdf/dz9zr008.pdf
34(3) z/Architecture Reference Summary
35 http://publibfi.boulder.ibm.com/epubs/pdf/dz9zs006.pdf