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
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67

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 for Fedora Core 4:
-------------------------------------

As root use yum to install and update the following
1. yum update kernel or yum update kernel-smp
2. yum install kernel-debuginfo
3. yum install kernel-devel or yum install kernel-smp-devel
4. Update the elfutils, currently the latest elfutils is hosted at the
   sytemtap's developement server
   Add a new repository 
   vi /etc/yum.repos.d/systemtap-elfutils.repo
   and add the following
  
   [systemtap-elfutils]
   name=FOR SYSTEMTAP DEVELOPMENT ONLY
   baseurl=ftp://sources.redhat.com/pub/systemtap/elfutils/
   enabled=1
   gpgcheck=0 

5. yum update elfutils
6. yum update elfutils-devel
7. Get the systemtap src from the cvs
   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 src

8. Build and install systemtap
   cd src
  ./configure
  make
  make install (as root)


Installation steps for RHEL4 Update 2:
--------------------------------------

1. Install kernel-debuginfo rpm from CDs
2. Install kernel-smp-devel rpm from CDs
3. Install systemtap rpm from CDs


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