| 1 |
=== SystemTap pure userspace backend, using Dyninst === |
| 2 |
|
| 3 |
** This is still a work in progress, quite experimental! ** |
| 4 |
|
| 5 |
The goal of stapdyn is to create a backend of SystemTap that can operate |
| 6 |
entirely in userspace. Users should be able to run scripts on their own |
| 7 |
processes without any special privilege on the system. |
| 8 |
|
| 9 |
The set of available probes is of course limited from what a traditional |
| 10 |
kernel-mode SystemTap can access. So far there are the plain begin/end/error, |
| 11 |
timers, uprobes-like process probes, and utrace-like process/thread begin/end. |
| 12 |
|
| 13 |
Because Dyninst operates on top of ptrace, the usual systemwide mode of |
| 14 |
operation is not really feasible, even on just one's own processes. Instead, |
| 15 |
stapdyn operates more like other ptracers (gdb, strace), where target apps |
| 16 |
are launched directly, or attached to specific PIDs. |
| 17 |
|
| 18 |
This code requires Dyninst 8.0 or later, including their development head. |
| 19 |
More information about Dyninst can be found here: |
| 20 |
|
| 21 |
- website: http://www.dyninst.org/ and http://www.paradyn.org/ |
| 22 |
|
| 23 |
- discussion: https://lists.cs.wisc.edu/mailman/options/dyninst-api/ |
| 24 |
|
| 25 |
- source: http://git.dyninst.org/?p=dyninst.git;a=summary |
| 26 |
or: git clone http://git.dyninst.org/dyninst.git |
| 27 |
|
| 28 |
- bug tracker: https://bugs.dyninst.org/ |
| 29 |
|
| 30 |
Note that Dyninst uses the environment variable DYNINSTAPI_RT_LIB pointing to |
| 31 |
your build of libdyninstAPI_RT.so. We try to calculate it at runtime relative |
| 32 |
to the dynamic libdyninstAPI.so location, but you can set this manually if |
| 33 |
needed. You may also need LD_LIBRARY_PATH to include the other libraries if |
| 34 |
they're not installed in the system paths. |
| 35 |
|
| 36 |
Major stapdyn known issues: |
| 37 |
- PR14702 - dyninst breaks exception handling |
| 38 |
- PR15049 - stapdyn mishandling interrupts |
| 39 |
- PR15136 - stapdyn doesn't fill registers on 32-bit x86 |
| 40 |
- PR15614 - stapdyn only partially fills registers on ppc |
| 41 |
See also sourceware.org/bugzilla product:systemtap component:dyninst. |
| 42 |
|
| 43 |
For some more background on this project, see the presentations: |
| 44 |
|
| 45 |
- PD Week 2012: Josh Stone |
| 46 |
Scripted Introspection with Dyninst |
| 47 |
http://www.dyninst.org/meetings/2012/monday |
| 48 |
|
| 49 |
- LF Collab Summit 2012: Josh Stone |
| 50 |
SystemTap Sans Kernel |
| 51 |
https://events.linuxfoundation.org/events/collaboration-summit/slides-and-video |
| 52 |
|
| 53 |
- Tracing Summit 2012: David Smith & Josh Stone |
| 54 |
Systemtap and new connections: dyninst, pcp, uprobes |
| 55 |
http://www.tracingsummit.org/wiki/TracingSummit2012 |
| 56 |
|
| 57 |
- PD Week 2013: Josh Stone & David Smith |
| 58 |
stapdyn: Porting SystemTap onto Dyninst |
| 59 |
http://research.cs.wisc.edu/htcondor/HTCondorWeek2013/monday_paradyn.html |