mirror of
https://github.com/ioacademy-jikim/debugging
synced 2025-06-08 08:26:14 +00:00
189 lines
10 KiB
HTML
189 lines
10 KiB
HTML
<html>
|
||
<head>
|
||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||
<title>12. README.solaris</title>
|
||
<link rel="stylesheet" type="text/css" href="vg_basic.css">
|
||
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
|
||
<link rel="home" href="index.html" title="Valgrind Documentation">
|
||
<link rel="up" href="dist.html" title="Valgrind Distribution Documents">
|
||
<link rel="prev" href="dist.readme-mips.html" title="11. README.mips">
|
||
<link rel="next" href="licenses.html" title="GNU Licenses">
|
||
</head>
|
||
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
||
<div><table class="nav" width="100%" cellspacing="3" cellpadding="3" border="0" summary="Navigation header"><tr>
|
||
<td width="22px" align="center" valign="middle"><a accesskey="p" href="dist.readme-mips.html"><img src="images/prev.png" width="18" height="21" border="0" alt="Prev"></a></td>
|
||
<td width="25px" align="center" valign="middle"><a accesskey="u" href="dist.html"><img src="images/up.png" width="21" height="18" border="0" alt="Up"></a></td>
|
||
<td width="31px" align="center" valign="middle"><a accesskey="h" href="index.html"><img src="images/home.png" width="27" height="20" border="0" alt="Up"></a></td>
|
||
<th align="center" valign="middle">Valgrind Distribution Documents</th>
|
||
<td width="22px" align="center" valign="middle"><a accesskey="n" href="licenses.html"><img src="images/next.png" width="18" height="21" border="0" alt="Next"></a></td>
|
||
</tr></table></div>
|
||
<div class="chapter">
|
||
<div class="titlepage"><div><div><h1 class="title">
|
||
<a name="dist.readme-solaris"></a>12. README.solaris</h1></div></div></div>
|
||
<div class="literallayout"><p><br>
|
||
Requirements<br>
|
||
------------<br>
|
||
- You need a recent Solaris-like OS to compile this port. Solaris 11 or<br>
|
||
any illumos-based distribution should work, Solaris 10 is not supported.<br>
|
||
Running `uname -r` has to print '5.11'.<br>
|
||
- Recent GCC tools are required, GCC 3 will probably not work. GCC version<br>
|
||
4.5 (or higher) is recommended.<br>
|
||
- Solaris ld has to be the first linker in the PATH. GNU ld cannot be used.<br>
|
||
There is currently no linker check in the configure script but the linking<br>
|
||
phase fails if GNU ld is used. Recent Solaris/illumos distributions are ok.<br>
|
||
- A working combination of autotools is required: aclocal, autoheader,<br>
|
||
automake and autoconf have to be found in the PATH. You should be able to<br>
|
||
install pkg:/developer/build/automake and pkg:/developer/build/autoconf<br>
|
||
packages to fullfil this requirement.<br>
|
||
- System header files and GNU make is also required.<br>
|
||
- For remote debugging support, working GDB is required (see below).<br>
|
||
<br>
|
||
<br>
|
||
Compilation<br>
|
||
-----------<br>
|
||
Please follow the generic instructions in the README file.<br>
|
||
<br>
|
||
The configure script detects a canonical host to determine which version of<br>
|
||
Valgrind should be built. If the system compiler by default produces 32-bit<br>
|
||
binaries then only a 32-bit version of Valgrind will be built. To enable<br>
|
||
compilation of both 64-bit and 32-bit versions on such a system, issue the<br>
|
||
configure script as follows:<br>
|
||
./configure CC='gcc -m64' CXX='g++ -m64'<br>
|
||
<br>
|
||
<br>
|
||
Oracle Solaris and illumos support<br>
|
||
----------------------------------<br>
|
||
One of the main goal of this port is to support both Oracle Solaris and<br>
|
||
illumos kernels. This is a very hard task because Solaris kernel traditionally<br>
|
||
does not provide a stable syscall interface and because Valgrind contains<br>
|
||
several parts that are closely tied to the underlying kernel. For these<br>
|
||
reasons, the port needs to detect which syscall interfaces are present. This<br>
|
||
detection cannot be done easily at run time and is currently implemented as<br>
|
||
a set of configure tests. This means that a binary version of this port can be<br>
|
||
executed only on a kernel that is compatible with a kernel that was used<br>
|
||
during the configure and compilation time.<br>
|
||
<br>
|
||
Main currently-known incompatibilities:<br>
|
||
- Solaris 11 (released in November 2011) removed a large set of syscalls where<br>
|
||
*at variant of the syscall was also present, for example, open() versus<br>
|
||
openat(AT_FDCWD) [1]<br>
|
||
- syscall number for unlinkat() is 76 on Solaris 11, but 65 on illumos [2]<br>
|
||
- illumos (in April 2013) changed interface of the accept() and pipe()<br>
|
||
syscalls [3]<br>
|
||
<br>
|
||
[1] http://docs.oracle.com/cd/E26502_01/html/E28556/gkzlf.html#gkzip<br>
|
||
[2] https://www.illumos.org/issues/521<br>
|
||
[3] https://github.com/illumos/illumos-gate/commit/5dbfd19ad5fcc2b779f40f80fa05c1bd28fd0b4e<br>
|
||
<br>
|
||
<br>
|
||
Limitations<br>
|
||
-----------<br>
|
||
- The port is Work-In-Progress, many things may not work or they can be subtly<br>
|
||
broken.<br>
|
||
- Coredumps produced by Valgrind do not contain all information available,<br>
|
||
especially microstate accounting and processor bindings.<br>
|
||
- Accessing contents of /proc/self/psinfo is not thread-safe. That is because<br>
|
||
Valgrind emulates this file on behalf of the client programs. Entire<br>
|
||
open() - read() - close() sequence on this file needs to be performed<br>
|
||
atomically.<br>
|
||
- Fork limitations: vfork() is translated to fork(), forkall() is not<br>
|
||
supported.<br>
|
||
- Valgrind does not track definedness of some eflags (OF, SF, ZF, AF, CF, PF)<br>
|
||
individually for each flag. After a syscall is finished, when a carry flag<br>
|
||
is set and defined, all other mentioned flags will be also defined even<br>
|
||
though they might be undefined before making the syscall.<br>
|
||
- System call "execve" with a file descriptor which points to a hardlink<br>
|
||
is currently not supported. That is because from the opened file descriptor<br>
|
||
itself it is not possible to reverse map the intended pathname.<br>
|
||
Examples are fexecve(3C) and isaexec(3C).<br>
|
||
- Program headers PT_SUNW_SYSSTAT and PT_SUNW_SYSSTAT_ZONE are not supported.<br>
|
||
That is, programs linked with mapfile directive RESERVE_SEGMENT and attribute<br>
|
||
TYPE equal to SYSSTAT or SYSSTAT_ZONE will cause Valgrind exit. It is not<br>
|
||
possible for Valgrind to arrange mapping of a kernel shared page at the<br>
|
||
address specified in the mapfile for the guest application. There is currently<br>
|
||
no such mechanism in Solaris. Hacky workarounds are possible, though.<br>
|
||
- Guest programs do not contain entries for AT_SUN_SYSSTAT_ADDR and<br>
|
||
AT_SUN_SYSSTAT_ZONE_ADDR in their auxilliary vectors. There is no direct way<br>
|
||
how to obtain addresses of these pages shared with the kernel as they are<br>
|
||
passed in auxv and kernel does not create auxv for statically linked binaries<br>
|
||
(such as Valgrind analysis tools).<br>
|
||
Indirect methods, such as scanning 1-page mappings found at Valgrind<br>
|
||
startup surrounded by reservations, could be possible. But it is hard to tell<br>
|
||
which page is which because their contents are filled only when a system<br>
|
||
cyclic is started. See get_hrusec() for reference.<br>
|
||
- When a thread has no stack then all system calls will result in Valgrind<br>
|
||
crash, even though such system calls use just parameters passed in registers.<br>
|
||
This should happen only in pathological situations when a thread is created<br>
|
||
with custom mmap'ed stack and this stack is then unmap'ed during thread<br>
|
||
execution.<br>
|
||
<br>
|
||
<br>
|
||
Remote debugging support<br>
|
||
------------------------<br>
|
||
Solaris port of GDB has a major flaw which prevents remote debugging from<br>
|
||
working correctly. Fortunately this flaw has an easy fix [4]. Unfortunately<br>
|
||
it is not present in the current GDB 7.6.2. This boils down to several<br>
|
||
options:<br>
|
||
- Use GDB shipped with Solaris 11.2 which has this flaw fixed.<br>
|
||
- Wait until GDB 7.7 becomes available (there won't be other 7.6.x releases).<br>
|
||
- Build GDB 7.6.2 with the fix by yourself using the following steps:<br>
|
||
# pkg install developer/gnu-binutils<br>
|
||
$ wget http://ftp.gnu.org/gnu/gdb/gdb-7.6.2.tar.gz<br>
|
||
$ gzip -dc gdb-7.6.2.tar.gz | tar xf -<br>
|
||
$ cd gdb-7.6.2<br>
|
||
$ patch -p1 -i /path/to/valgrind-solaris/solaris/gdb-sol-thread.patch<br>
|
||
$ export LIBS="-lncurses"<br>
|
||
$ export CC="gcc -m64"<br>
|
||
$ ./configure --with-x=no --with-curses --with-libexpat-prefix=/usr/lib<br>
|
||
$ gmake && gmake install<br>
|
||
<br>
|
||
[4] https://sourceware.org/ml/gdb-patches/2013-12/msg00573.html<br>
|
||
<br>
|
||
<br>
|
||
TODO list<br>
|
||
---------<br>
|
||
- Fix few remaining failing tests.<br>
|
||
- Add more Solaris-specific tests (especially for the door and spawn<br>
|
||
syscalls).<br>
|
||
- Provide better error reporting for various subsyscalls.<br>
|
||
- Implement storing of extra register state in signal frame.<br>
|
||
- Performance comparison against other platforms.<br>
|
||
<br>
|
||
- Prevent SIGPIPE when writing to a socket (coregrind/m_libcfile.c).<br>
|
||
- Implement ticket locking for fair scheduling (--fair-sched=yes).<br>
|
||
- Implement support in DRD and Helgrind tools for thr_join() with thread == 0.<br>
|
||
- Add support for accessing thread-local variables via gdb (auxprogs/getoff.c).<br>
|
||
Requires research on internal libc TLS representation.<br>
|
||
- VEX supports AVX, BMI and AVX2. Investigate if they can be enabled on<br>
|
||
Solaris/illumos.<br>
|
||
- Investigate support for more flags in AT_SUN_AUXFLAGS.<br>
|
||
- Fix Valgrind crash when a thread has no stack and syswrap-main.c accesses<br>
|
||
all possible syscall parameters. Enable helgrind/tests/stackteardown.c<br>
|
||
to see this in effect. Would require awareness of syscall parameter semantics.<br>
|
||
- Correctly print arguments of DW_CFA_ORCL_arg_loc in show_CF_instruction() when<br>
|
||
it is implemented in libdwarf.<br>
|
||
<br>
|
||
<br>
|
||
Contacts<br>
|
||
--------<br>
|
||
Please send bug reports and any questions about the port to:<br>
|
||
Ivo Raisr <ivosh@ivosh.net><br>
|
||
Petr Pavlu <setup@dagobah.cz><br>
|
||
<br>
|
||
</p></div>
|
||
</div>
|
||
<div>
|
||
<br><table class="nav" width="100%" cellspacing="3" cellpadding="2" border="0" summary="Navigation footer">
|
||
<tr>
|
||
<td rowspan="2" width="40%" align="left">
|
||
<a accesskey="p" href="dist.readme-mips.html"><< 11. README.mips</a> </td>
|
||
<td width="20%" align="center"><a accesskey="u" href="dist.html">Up</a></td>
|
||
<td rowspan="2" width="40%" align="right"> <a accesskey="n" href="licenses.html">GNU Licenses >></a>
|
||
</td>
|
||
</tr>
|
||
<tr><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td></tr>
|
||
</table>
|
||
</div>
|
||
</body>
|
||
</html>
|