README


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48

systemtap: a linux trace/probe tool

Visit the project web site at <http://sources.redhat.com/systemtap>,
for documentation and mailing lists for developers and users.

This is free software.
See the COPYING file for redistribution/modification terms.
See the INSTALL file for generic build instructions.

Prerequisites:

- linux kernel 2.6.11+ with kprobes
- kernel module build environment (kernel-devel or kernel-smp-devel rpm)
- kernel debugging information (kernel-debuginfo rpm)
- C compiler (same as what kernel was compiled with)
- elfutils with libdwfl (from fedora rawhide; include -devel and -libelf-)
- root privileges

Installation steps:

- Install the kernel-debuginfo, kernel-[smp-]devel, gcc packages
- Install the systemtap package, if one already exists.

Build steps:

- Install the kernel-debuginfo, kernel-[smp-]devel, gcc packages.
- Download the latest elfutils snapshot
  ftp://sources.redhat.com/pub/systemtap/elfutils/elfutils-NNNN.tar.gz
  ftp://sources.redhat.com/pub/systemtap/elfutils/elfutils-portability.patch
- Untar the snapshot in some new directory; apply patch (don't ask, long story)
- Download systemtap sources snapshot or from CVS
  ftp://sources.redhat.com/pub/systemtap/snapshots/ 
  (or)
  cvs -d :pserver:anoncvs@sources.redhat.com:/cvs/systemtap login
  # enter "anoncvs" as the password
  cvs -d :pserver:anoncvs@sources.redhat.com:/cvs/systemtap co -c
- Build it
  cd src
  ./configure --with-elfutils=PATCHED-ELFUTILS-DIR [other autoconf options]
  make all check
  make install

Tips :

- systemtap looks for the debug info in these locations:
  /boot/vmlinux-`uname -r`
  /usr/lib/debug/lib/modules/`uname -r`/vmlinux
  /lib/modules/`uname -r`/vmlinux