sewardj | 8eb8bab | 2015-07-21 14:44:28 +0000 | [diff] [blame] | 1 | Requirements |
| 2 | ------------ |
| 3 | - You need a recent Solaris-like OS to compile this port. Solaris 11 or |
| 4 | any illumos-based distribution should work, Solaris 10 is not supported. |
| 5 | Running `uname -r` has to print '5.11'. |
| 6 | - Recent GCC tools are required, GCC 3 will probably not work. GCC version |
| 7 | 4.5 (or higher) is recommended. |
| 8 | - Solaris ld has to be the first linker in the PATH. GNU ld cannot be used. |
| 9 | There is currently no linker check in the configure script but the linking |
| 10 | phase fails if GNU ld is used. Recent Solaris/illumos distributions are ok. |
| 11 | - A working combination of autotools is required: aclocal, autoheader, |
| 12 | automake and autoconf have to be found in the PATH. You should be able to |
| 13 | install pkg:/developer/build/automake and pkg:/developer/build/autoconf |
| 14 | packages to fullfil this requirement. |
iraisr | aeed80f | 2015-10-21 12:02:04 +0000 | [diff] [blame] | 15 | - System header files are required. On Solaris, these can be installed with: |
| 16 | # pkg install system/header |
| 17 | - GNU make is also required. On Solaris, this can be quickly achieved with: |
| 18 | $ PATH=/usr/gnu/bin:$PATH; export PATH |
sewardj | 8eb8bab | 2015-07-21 14:44:28 +0000 | [diff] [blame] | 19 | - For remote debugging support, working GDB is required (see below). |
| 20 | |
| 21 | |
| 22 | Compilation |
| 23 | ----------- |
| 24 | Please follow the generic instructions in the README file. |
| 25 | |
| 26 | The configure script detects a canonical host to determine which version of |
| 27 | Valgrind should be built. If the system compiler by default produces 32-bit |
| 28 | binaries then only a 32-bit version of Valgrind will be built. To enable |
| 29 | compilation of both 64-bit and 32-bit versions on such a system, issue the |
| 30 | configure script as follows: |
| 31 | ./configure CC='gcc -m64' CXX='g++ -m64' |
| 32 | |
| 33 | |
| 34 | Oracle Solaris and illumos support |
| 35 | ---------------------------------- |
| 36 | One of the main goal of this port is to support both Oracle Solaris and |
| 37 | illumos kernels. This is a very hard task because Solaris kernel traditionally |
| 38 | does not provide a stable syscall interface and because Valgrind contains |
| 39 | several parts that are closely tied to the underlying kernel. For these |
| 40 | reasons, the port needs to detect which syscall interfaces are present. This |
| 41 | detection cannot be done easily at run time and is currently implemented as |
| 42 | a set of configure tests. This means that a binary version of this port can be |
| 43 | executed only on a kernel that is compatible with a kernel that was used |
| 44 | during the configure and compilation time. |
| 45 | |
| 46 | Main currently-known incompatibilities: |
| 47 | - Solaris 11 (released in November 2011) removed a large set of syscalls where |
| 48 | *at variant of the syscall was also present, for example, open() versus |
| 49 | openat(AT_FDCWD) [1] |
| 50 | - syscall number for unlinkat() is 76 on Solaris 11, but 65 on illumos [2] |
| 51 | - illumos (in April 2013) changed interface of the accept() and pipe() |
| 52 | syscalls [3] |
| 53 | |
| 54 | [1] http://docs.oracle.com/cd/E26502_01/html/E28556/gkzlf.html#gkzip |
| 55 | [2] https://www.illumos.org/issues/521 |
| 56 | [3] https://github.com/illumos/illumos-gate/commit/5dbfd19ad5fcc2b779f40f80fa05c1bd28fd0b4e |
| 57 | |
| 58 | |
| 59 | Limitations |
| 60 | ----------- |
| 61 | - The port is Work-In-Progress, many things may not work or they can be subtly |
| 62 | broken. |
| 63 | - Coredumps produced by Valgrind do not contain all information available, |
| 64 | especially microstate accounting and processor bindings. |
| 65 | - Accessing contents of /proc/self/psinfo is not thread-safe. That is because |
| 66 | Valgrind emulates this file on behalf of the client programs. Entire |
| 67 | open() - read() - close() sequence on this file needs to be performed |
| 68 | atomically. |
| 69 | - Fork limitations: vfork() is translated to fork(), forkall() is not |
| 70 | supported. |
| 71 | - Valgrind does not track definedness of some eflags (OF, SF, ZF, AF, CF, PF) |
| 72 | individually for each flag. After a syscall is finished, when a carry flag |
| 73 | is set and defined, all other mentioned flags will be also defined even |
| 74 | though they might be undefined before making the syscall. |
| 75 | - System call "execve" with a file descriptor which points to a hardlink |
| 76 | is currently not supported. That is because from the opened file descriptor |
| 77 | itself it is not possible to reverse map the intended pathname. |
| 78 | Examples are fexecve(3C) and isaexec(3C). |
iraisr | fa0a7f4 | 2015-08-01 21:53:08 +0000 | [diff] [blame] | 79 | - Program headers PT_SUNW_SYSSTAT and PT_SUNW_SYSSTAT_ZONE are not supported. |
iraisr | 9223db9 | 2015-08-03 10:48:16 +0000 | [diff] [blame] | 80 | That is, programs linked with mapfile directive RESERVE_SEGMENT and attribute |
iraisr | fa0a7f4 | 2015-08-01 21:53:08 +0000 | [diff] [blame] | 81 | TYPE equal to SYSSTAT or SYSSTAT_ZONE will cause Valgrind exit. It is not |
| 82 | possible for Valgrind to arrange mapping of a kernel shared page at the |
| 83 | address specified in the mapfile for the guest application. There is currently |
iraisr | 9223db9 | 2015-08-03 10:48:16 +0000 | [diff] [blame] | 84 | no such mechanism in Solaris. Hacky workarounds are possible, though. |
sewardj | 8eb8bab | 2015-07-21 14:44:28 +0000 | [diff] [blame] | 85 | - When a thread has no stack then all system calls will result in Valgrind |
| 86 | crash, even though such system calls use just parameters passed in registers. |
| 87 | This should happen only in pathological situations when a thread is created |
| 88 | with custom mmap'ed stack and this stack is then unmap'ed during thread |
| 89 | execution. |
| 90 | |
| 91 | |
| 92 | Remote debugging support |
| 93 | ------------------------ |
| 94 | Solaris port of GDB has a major flaw which prevents remote debugging from |
| 95 | working correctly. Fortunately this flaw has an easy fix [4]. Unfortunately |
| 96 | it is not present in the current GDB 7.6.2. This boils down to several |
| 97 | options: |
| 98 | - Use GDB shipped with Solaris 11.2 which has this flaw fixed. |
| 99 | - Wait until GDB 7.7 becomes available (there won't be other 7.6.x releases). |
| 100 | - Build GDB 7.6.2 with the fix by yourself using the following steps: |
| 101 | # pkg install developer/gnu-binutils |
| 102 | $ wget http://ftp.gnu.org/gnu/gdb/gdb-7.6.2.tar.gz |
| 103 | $ gzip -dc gdb-7.6.2.tar.gz | tar xf - |
| 104 | $ cd gdb-7.6.2 |
| 105 | $ patch -p1 -i /path/to/valgrind-solaris/solaris/gdb-sol-thread.patch |
| 106 | $ export LIBS="-lncurses" |
| 107 | $ export CC="gcc -m64" |
| 108 | $ ./configure --with-x=no --with-curses --with-libexpat-prefix=/usr/lib |
| 109 | $ gmake && gmake install |
| 110 | |
| 111 | [4] https://sourceware.org/ml/gdb-patches/2013-12/msg00573.html |
| 112 | |
| 113 | |
| 114 | TODO list |
| 115 | --------- |
| 116 | - Fix few remaining failing tests. |
| 117 | - Add more Solaris-specific tests (especially for the door and spawn |
| 118 | syscalls). |
| 119 | - Provide better error reporting for various subsyscalls. |
| 120 | - Implement storing of extra register state in signal frame. |
| 121 | - Performance comparison against other platforms. |
| 122 | |
| 123 | - Prevent SIGPIPE when writing to a socket (coregrind/m_libcfile.c). |
sewardj | 8eb8bab | 2015-07-21 14:44:28 +0000 | [diff] [blame] | 124 | - Implement ticket locking for fair scheduling (--fair-sched=yes). |
| 125 | - Implement support in DRD and Helgrind tools for thr_join() with thread == 0. |
| 126 | - Add support for accessing thread-local variables via gdb (auxprogs/getoff.c). |
| 127 | Requires research on internal libc TLS representation. |
| 128 | - VEX supports AVX, BMI and AVX2. Investigate if they can be enabled on |
| 129 | Solaris/illumos. |
| 130 | - Investigate support for more flags in AT_SUN_AUXFLAGS. |
| 131 | - Fix Valgrind crash when a thread has no stack and syswrap-main.c accesses |
| 132 | all possible syscall parameters. Enable helgrind/tests/stackteardown.c |
| 133 | to see this in effect. Would require awareness of syscall parameter semantics. |
| 134 | - Correctly print arguments of DW_CFA_ORCL_arg_loc in show_CF_instruction() when |
| 135 | it is implemented in libdwarf. |
sewardj | 8eb8bab | 2015-07-21 14:44:28 +0000 | [diff] [blame] | 136 | |
| 137 | |
| 138 | Contacts |
| 139 | -------- |
| 140 | Please send bug reports and any questions about the port to: |
| 141 | Ivo Raisr <ivosh@ivosh.net> |
| 142 | Petr Pavlu <setup@dagobah.cz> |