Chapter 2.
Using SystemTap
This chapter instructs users how to install SystemTap, and provides an introduction on how to run
SystemTap scripts.
2.1. Installation and Setup
To deploy SystemTap, you need to install the SystemTap packages along with the corresponding set
of -devel, -debuginfo and -debuginfo-common packages for your kernel. If your system has
multiple kernels installed, and you wish to use SystemTap on more than one kernel kernel, you will
need to install the -devel and -debuginfo packages for each of those kernel versions.
These procedures will be discussed in detail in the following sections.
Important
Many users confuse -debuginfo with -debug. Remember that the deployment of
SystemTap requires the installation of the -debuginfo package of the kernel, not the -
debug version of the kernel.
2.1.1. Installing SystemTap
To deploy Systemtap, you will need to to install the following RPMs:
• systemtap
• systemtap-runtime
Assuming that yum is installed in the system, these two rpms can be installed with yum install
systemtap systemtap-runtime. Note that before you can use SystemTap, you will still need to
install the required kernel information RPMs.
2.1.2. Installing Required Kernel Information RPMs
SystemTap needs information about the kernel in order to place instrumentation in it (i.e. probe it).
This information also allows SystemTap to generate the code for the instrumentation. This information
is contained in the matching -devel, -debuginfo, and -debuginfo-common packages for your
kernel. The necessary -devel and -debuginfo packages for the ordinary "vanilla" kernel are as
follows:
• kernel-debuginfo
• kernel-debuginfo-common
• kernel-devel
Likewise, the necessary packages for the PAE kernel would be kernel-PAE-debuginfo, kernel-
PAE-debuginfo-common, and kernel-PAE-devel.
To determine what kernel your system is currently using, use:
3