florian | dec4a56 | 2011-11-26 04:12:01 +0000 | [diff] [blame] | 1 | |
sewardj | b5b8740 | 2011-03-07 16:05:35 +0000 | [diff] [blame] | 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. |
sewardj | b5b8740 | 2011-03-07 16:05:35 +0000 | [diff] [blame] | 7 | |
| 8 | |
| 9 | Limitations |
| 10 | ----------- |
| 11 | - 31-bit client programs are not supported. |
| 12 | - Hexadecimal floating point is not supported. |
florian | fb11d97 | 2012-11-02 22:00:59 +0000 | [diff] [blame] | 13 | - memcheck, massif, lackey, and none are supported. |
| 14 | - cachegrind is supported on z10 and newer models. On older models, |
| 15 | a z10 cache architecture will be assumed. |
| 16 | - callgrind and all experimental tools are currently not supported. |
sewardj | b5b8740 | 2011-03-07 16:05:35 +0000 | [diff] [blame] | 17 | - helgrind and drd seem to work on SLES10,11 and RHEL5,6 on z9,z10 and z196 |
| 18 | but might fail on other hardware/software combinations. |
| 19 | - Some gcc versions use mvc to copy 4/8 byte values. This will affect some |
| 20 | debug messages. Valgrind will complain about 4 or 8 one-byte reads/writes |
| 21 | instead of just 1 read/write. |
sewardj | b5b8740 | 2011-03-07 16:05:35 +0000 | [diff] [blame] | 22 | |
| 23 | |
florian | 8f36de0 | 2012-08-23 00:44:22 +0000 | [diff] [blame] | 24 | Hardware facilities |
| 25 | ------------------- |
| 26 | Valgrind does not require that the host machine has the same hardware |
| 27 | facilities as the machine for which the client program was compiled. |
| 28 | This is convenient. The JIT compiler will translate the client instructions |
| 29 | according to the facilities available on the host. |
| 30 | This means, though, that probing for hardware facilities by issuing |
| 31 | instructions from that facility and observing whether SIGILL is thrown |
| 32 | may not work. As a consequence, programs that attempt to do so may |
| 33 | behave differently. It is believed that this is a rare use case. |
| 34 | |
| 35 | |
sewardj | b5b8740 | 2011-03-07 16:05:35 +0000 | [diff] [blame] | 36 | Recommendations |
| 37 | --------------- |
| 38 | Applications should be compiled with -fno-builtin to avoid |
| 39 | false positives due to builtin string operations when running memcheck. |
| 40 | |
| 41 | |
| 42 | Reading Material |
| 43 | ---------------- |
| 44 | (1) Linux for zSeries ELF ABI Supplement |
| 45 | http://refspecs.linuxfoundation.org/ELF/zSeries/index.html |
| 46 | (2) z/Architecture Principles of Operation |
florian | 46ac11b | 2012-09-19 16:43:30 +0000 | [diff] [blame] | 47 | http://publibfi.boulder.ibm.com/epubs/pdf/dz9zr009.pdf |
sewardj | b5b8740 | 2011-03-07 16:05:35 +0000 | [diff] [blame] | 48 | (3) z/Architecture Reference Summary |
florian | 46ac11b | 2012-09-19 16:43:30 +0000 | [diff] [blame] | 49 | http://publibfi.boulder.ibm.com/epubs/pdf/dz9zs007.pdf |