Debian Codegraph @

stapdyn/README

raw
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