diff options
| author | fche <fche> | 2014-12-22 17:13:57 +0000 |
|---|---|---|
| committer | fche <fche> | 2014-12-22 17:13:57 +0000 |
| commit | c6ea4356d8b77cb69577a80cd81ee8d3163dca7f (patch) | |
| tree | 7f3b5ea68519f26e80d9731bc5a68541f9e10953 /SystemTap_Beginners_Guide/using-systemtap.html | |
| parent | add new langref/*.html (diff) | |
removed man pages
Diffstat (limited to 'SystemTap_Beginners_Guide/using-systemtap.html')
| -rw-r--r-- | SystemTap_Beginners_Guide/using-systemtap.html | 14 |
1 files changed, 7 insertions, 7 deletions
diff --git a/SystemTap_Beginners_Guide/using-systemtap.html b/SystemTap_Beginners_Guide/using-systemtap.html index 0aa880df..975b3385 100644 --- a/SystemTap_Beginners_Guide/using-systemtap.html +++ b/SystemTap_Beginners_Guide/using-systemtap.html | |||
| @@ -1,9 +1,9 @@ | |||
| 1 | <?xml version="1.0" encoding="UTF-8" standalone="no"?> | 1 | <?xml version="1.0" encoding="UTF-8" standalone="no"?> |
| 2 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">Chapter 2. Using SystemTap</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.1.3" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="index.html" title="SystemTap Beginners Guide" /><link rel="prev" href="intro-systemtap-limitations.html" title="1.3. Limitations of SystemTap" /><link rel="next" href="cross-compiling.html" title="2.2. Generating Instrumentation for Other Computers" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="intro-systemtap-limitations.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="cross-compiling.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="chapter" lang="en-US"><div class="titlepage"><div><div><h1 class="title"><a id="using-systemtap"> | 2 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">Chapter 2. Using SystemTap</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.1.3" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.7-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="index.html" title="SystemTap Beginners Guide" /><link rel="prev" href="intro-systemtap-limitations.html" title="1.3. Limitations of SystemTap" /><link rel="next" href="cross-compiling.html" title="2.2. Generating Instrumentation for Other Computers" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="intro-systemtap-limitations.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="cross-compiling.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="chapter" lang="en-US"><div class="titlepage"><div><div><h1 class="title"><a id="using-systemtap"> |
| 3 | </a>Chapter 2. Using SystemTap</h1></div></div></div><div class="toc"><dl class="toc"><dt><span class="section"><a href="using-systemtap.html#using-setup">2.1. Installation and Setup</a></span></dt><dd><dl><dt><span class="section"><a href="using-systemtap.html#installproper">2.1.1. Installing SystemTap</a></span></dt><dt><span class="section"><a href="using-systemtap.html#install-kinfo">2.1.2. Installing Required Kernel Information Packages Manually</a></span></dt><dt><span class="section"><a href="using-systemtap.html#testing">2.1.3. Initial Testing</a></span></dt></dl></dd><dt><span class="section"><a href="cross-compiling.html">2.2. Generating Instrumentation for Other Computers</a></span></dt><dt><span class="section"><a href="using-usage.html">2.3. Running SystemTap Scripts</a></span></dt><dd><dl><dt><span class="section"><a href="using-usage.html#flight-recorder">2.3.1. SystemTap Flight Recorder Mode</a></span></dt></dl></dd></dl></div><a id="idm214007235856" class="indexterm"></a><div class="para"> | 3 | </a>Chapter 2. Using SystemTap</h1></div></div></div><div class="toc"><dl class="toc"><dt><span class="section"><a href="using-systemtap.html#using-setup">2.1. Installation and Setup</a></span></dt><dd><dl><dt><span class="section"><a href="using-systemtap.html#installproper">2.1.1. Installing SystemTap</a></span></dt><dt><span class="section"><a href="using-systemtap.html#install-kinfo">2.1.2. Installing Required Kernel Information Packages Manually</a></span></dt><dt><span class="section"><a href="using-systemtap.html#testing">2.1.3. Initial Testing</a></span></dt></dl></dd><dt><span class="section"><a href="cross-compiling.html">2.2. Generating Instrumentation for Other Computers</a></span></dt><dt><span class="section"><a href="using-usage.html">2.3. Running SystemTap Scripts</a></span></dt><dd><dl><dt><span class="section"><a href="using-usage.html#flight-recorder">2.3.1. SystemTap Flight Recorder Mode</a></span></dt></dl></dd></dl></div><a id="idm47722952742112" class="indexterm"></a><div class="para"> |
| 4 | This chapter documents how to install SystemTap in the system and explains how to use the <code class="command">stap</code> utility to run SystemTap scripts. | 4 | This chapter documents how to install SystemTap in the system and explains how to use the <code class="command">stap</code> utility to run SystemTap scripts. |
| 5 | </div><div xml:lang="en-US" class="section" lang="en-US"><div class="titlepage"><div><div><h2 class="title"><a id="using-setup"> | 5 | </div><div xml:lang="en-US" class="section" lang="en-US"><div class="titlepage"><div><div><h2 class="title"><a id="using-setup"> |
| 6 | </a>2.1. Installation and Setup</h2></div></div></div><a id="idm214007241088" class="indexterm"></a><a id="idm214007242320" class="indexterm"></a><div class="para"> | 6 | </a>2.1. Installation and Setup</h2></div></div></div><a id="idm47722952747344" class="indexterm"></a><a id="idm47722952748576" class="indexterm"></a><div class="para"> |
| 7 | To deploy SystemTap, install the SystemTap packages along with the corresponding set of <span class="package">-devel</span>, <span class="package">-debuginfo</span>, and <span class="package">-debuginfo-common</span> packages for your kernel. If your system has multiple kernels installed and you intend to use SystemTap on more than one of them, also install the <span class="package">-devel</span> and <span class="package">-debuginfo</span> packages for <span class="emphasis"><em>each</em></span> of those kernel versions. | 7 | To deploy SystemTap, install the SystemTap packages along with the corresponding set of <span class="package">-devel</span>, <span class="package">-debuginfo</span>, and <span class="package">-debuginfo-common</span> packages for your kernel. If your system has multiple kernels installed and you intend to use SystemTap on more than one of them, also install the <span class="package">-devel</span> and <span class="package">-debuginfo</span> packages for <span class="emphasis"><em>each</em></span> of those kernel versions. |
| 8 | </div><div class="para"> | 8 | </div><div class="para"> |
| 9 | The following sections discuss the installation procedures in greater detail. | 9 | The following sections discuss the installation procedures in greater detail. |
| @@ -12,7 +12,7 @@ | |||
| 12 | </div></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="installproper"> | 12 | </div></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="installproper"> |
| 13 | </a>2.1.1. Installing SystemTap</h3></div></div></div><div class="para"> | 13 | </a>2.1.1. Installing SystemTap</h3></div></div></div><div class="para"> |
| 14 | To deploy SystemTap, install the following RPM packages: | 14 | To deploy SystemTap, install the following RPM packages: |
| 15 | </div><a id="idm214007252256" class="indexterm"></a><a id="idm214007253712" class="indexterm"></a><a id="idm214007254816" class="indexterm"></a><a id="idm214007257712" class="indexterm"></a><div xmlns:d="http://docbook.org/ns/docbook" class="itemizedlist"><ul><li class="listitem"><div class="para"> | 15 | </div><a id="idm47722952758512" class="indexterm"></a><a id="idm47722952759968" class="indexterm"></a><a id="idm47722952761072" class="indexterm"></a><a id="idm47722952763968" class="indexterm"></a><div xmlns:d="http://docbook.org/ns/docbook" class="itemizedlist"><ul><li class="listitem"><div class="para"> |
| 16 | <span class="package">systemtap</span> | 16 | <span class="package">systemtap</span> |
| 17 | </div></li><li class="listitem"><div class="para"> | 17 | </div></li><li class="listitem"><div class="para"> |
| 18 | <span class="package">systemtap-runtime</span> | 18 | <span class="package">systemtap-runtime</span> |
| @@ -23,7 +23,7 @@ | |||
| 23 | </div><pre class="screen"><code class="command">stap-prep</code></pre><div class="para"> | 23 | </div><pre class="screen"><code class="command">stap-prep</code></pre><div class="para"> |
| 24 | If this command does not work, try manual installation as described below. | 24 | If this command does not work, try manual installation as described below. |
| 25 | </div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="install-kinfo"> | 25 | </div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="install-kinfo"> |
| 26 | </a>2.1.2. Installing Required Kernel Information Packages Manually</h3></div></div></div><a id="idm214007264384" class="indexterm"></a><a id="idm214007265808" class="indexterm"></a><a id="idm214007267120" class="indexterm"></a><a id="idm214007268048" class="indexterm"></a><a id="idm214007269024" class="indexterm"></a><a id="idm214007270496" class="indexterm"></a><div class="para"> | 26 | </a>2.1.2. Installing Required Kernel Information Packages Manually</h3></div></div></div><a id="idm47722952770640" class="indexterm"></a><a id="idm47722952772064" class="indexterm"></a><a id="idm47722952773376" class="indexterm"></a><a id="idm47722952774304" class="indexterm"></a><a id="idm47722952775280" class="indexterm"></a><a id="idm47722952776752" class="indexterm"></a><div class="para"> |
| 27 | SystemTap needs information about the kernel in order to place instrumentation in it (in other words, probe it). This information also allows SystemTap to generate the code for the instrumentation. | 27 | SystemTap needs information about the kernel in order to place instrumentation in it (in other words, probe it). This information also allows SystemTap to generate the code for the instrumentation. |
| 28 | </div><div class="para"> | 28 | </div><div class="para"> |
| 29 | The required information is contained in the matching <span class="package">-devel</span>, <span class="package">-debuginfo</span>, and <span class="package">-debuginfo-common</span> packages for your kernel. The necessary <span class="package">-devel</span> and <span class="package">-debuginfo</span> packages for the ordinary "vanilla" kernel are as follows: | 29 | The required information is contained in the matching <span class="package">-devel</span>, <span class="package">-debuginfo</span>, and <span class="package">-debuginfo-common</span> packages for your kernel. The necessary <span class="package">-devel</span> and <span class="package">-debuginfo</span> packages for the ordinary "vanilla" kernel are as follows: |
| @@ -35,7 +35,7 @@ | |||
| 35 | <span class="package">kernel-devel</span> | 35 | <span class="package">kernel-devel</span> |
| 36 | </div></li></ul></div><div class="para"> | 36 | </div></li></ul></div><div class="para"> |
| 37 | Likewise, the necessary packages for the PAE kernel are <span class="package">kernel-PAE-debuginfo</span>, <span class="package">kernel-PAE-debuginfo-common</span>, and <span class="package">kernel-PAE-devel</span>. | 37 | Likewise, the necessary packages for the PAE kernel are <span class="package">kernel-PAE-debuginfo</span>, <span class="package">kernel-PAE-debuginfo-common</span>, and <span class="package">kernel-PAE-devel</span>. |
| 38 | </div><a id="idm214018386736" class="indexterm"></a><a id="idm214018387856" class="indexterm"></a><a id="idm214018388816" class="indexterm"></a><a id="idm214018436288" class="indexterm"></a><div class="para"> | 38 | </div><a id="idm47722989138656" class="indexterm"></a><a id="idm47722989139936" class="indexterm"></a><a id="idm47722989140896" class="indexterm"></a><a id="idm47722989145312" class="indexterm"></a><div class="para"> |
| 39 | To determine what kernel your system is currently using, use: | 39 | To determine what kernel your system is currently using, use: |
| 40 | </div><pre class="screen">uname -r</pre><div class="para"> | 40 | </div><pre class="screen">uname -r</pre><div class="para"> |
| 41 | For example, if you intend to use SystemTap on kernel version <span class="emphasis"><em>2.6.18-53.el5</em></span> on an <span class="emphasis"><em>i686</em></span> machine, download and install the following RPM packages: | 41 | For example, if you intend to use SystemTap on kernel version <span class="emphasis"><em>2.6.18-53.el5</em></span> on an <span class="emphasis"><em>i686</em></span> machine, download and install the following RPM packages: |
| @@ -58,7 +58,7 @@ | |||
| 58 | <code class="command">debuginfo-install kernel-PAE-2.6.18-53.1.13.el5</code></pre><div class="para"> | 58 | <code class="command">debuginfo-install kernel-PAE-2.6.18-53.1.13.el5</code></pre><div class="para"> |
| 59 | Once you have manually downloaded the required packages to the machine, run the following command as root to install them: | 59 | Once you have manually downloaded the required packages to the machine, run the following command as root to install them: |
| 60 | </div><pre class="screen"><code class="command">rpm --force -ivh <em class="replaceable">package_names</em></code></pre></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="testing"> | 60 | </div><pre class="screen"><code class="command">rpm --force -ivh <em class="replaceable">package_names</em></code></pre></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="testing"> |
| 61 | </a>2.1.3. Initial Testing</h3></div></div></div><a id="idm214010617504" class="indexterm"></a><a id="idm214026486640" class="indexterm"></a><a id="idm214026487568" class="indexterm"></a><div class="para"> | 61 | </a>2.1.3. Initial Testing</h3></div></div></div><a id="idm47722987369712" class="indexterm"></a><a id="idm47722987370160" class="indexterm"></a><a id="idm47722987371088" class="indexterm"></a><div class="para"> |
| 62 | If you are currently using the kernel you intend to probe with SystemTap, you can immediately test whether the deployment was successful. If not, you restart the system and load the appropriate kernel. | 62 | If you are currently using the kernel you intend to probe with SystemTap, you can immediately test whether the deployment was successful. If not, you restart the system and load the appropriate kernel. |
| 63 | </div><div class="para"> | 63 | </div><div class="para"> |
| 64 | To start the test, run the following command: | 64 | To start the test, run the following command: |