Debian Codegraph @

doc/SystemTap_Beginners_Guide/en-US/Useful_SystemTap_Scripts.xml

raw
1 <?xml version='1.0'?>
2 <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
3 ]>
4
5 <chapter id="useful-systemtap-scripts">
6 <title>Useful SystemTap Scripts</title>
7 <indexterm>
8 <primary>SystemTap scripts</primary>
9 <secondary>useful examples</secondary>
10 </indexterm>
11
12 <indexterm>
13 <primary>examples of SystemTap scripts</primary>
14 </indexterm>
15
16 <indexterm>
17 <primary>useful examples of SystemTap scripts</primary>
18 </indexterm>
19
20 <indexterm>
21 <primary>systemtap-testsuite package</primary>
22 <secondary>sample scripts</secondary>
23 </indexterm>
24
25 <para>This chapter enumerates several SystemTap scripts you can use to monitor and investigate different subsystems. All of these scripts are available at <filename>/usr/share/systemtap/testsuite/systemtap.examples/</filename> once you install the <filename>systemtap-testsuite</filename> RPM.</para>
26 <!--
27 <para><ulink url="http://sourceware.org/systemtap/examples/subsystem-index.html">http://sourceware.org/systemtap/examples/subsystem-index.html</ulink></para>
28
29 -->
30 <remark>
31 short intro, reference to online source (http://sourceware.org/systemtap/examples/subsystem-index.html); "always updated"
32 </remark>
33
34 <remark>short description of gnuplot (?) for better GUI of results</remark>
35
36 <remark>case studies and more info on some scripts here - http://sourceware.org/systemtap/wiki/WarStories</remark>
37
38 <!-- <xi:include href="Useful_Scripts-Disk.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> -->
39 <section id="mainsect-network">
40 <title>Network</title>
41 <para>The following sections showcase scripts that trace network-related functions and build a profile of network activity.</para>
42 <xi:include href="Useful_Scripts-nettop.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
43 <xi:include href="Useful_Scripts-sockettrace.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
44 <xi:include href="Useful_Scripts-tcp_connections.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
45 <xi:include href="Useful_Scripts-tcpdumplike.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
46 <xi:include href="Useful_Scripts-dropwatch.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
47 </section>
48 <section id="mainsect-disk">
49 <title>Disk</title>
50 <para>The following sections showcase scripts that monitor disk and I/O activity.</para>
51
52 <xi:include href="Useful_Scripts-disktop.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
53 <!-- <xi:include href="Useful_Scripts-IO.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> -->
54 <xi:include href="Useful_Scripts-iotime.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
55 <xi:include href="Useful_Scripts-traceio.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
56 <xi:include href="Useful_Scripts-traceio2.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
57 <!-- <xi:include href="Useful_Scripts-Kernel.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> -->
58 <xi:include href="Useful_Scripts-inodewatch.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
59 <xi:include href="Useful_Scripts-inodewatch2.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
60 <xi:include href="Useful_Scripts-ioblktime.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
61 </section>
62
63 <section id="mainsect-profiling">
64 <title>Profiling</title>
65 <para>The following sections showcase scripts that profile kernel activity by monitoring function calls.</para>
66 <xi:include href="Useful_Scripts-functioncalls.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
67 <xi:include href="Useful_Scripts-paracallgraph.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
68 <xi:include href="Useful_Scripts-threadtimes.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
69 <xi:include href="Useful_Scripts-timeout.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
70 <xi:include href="Useful_Scripts-topsys.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
71 <xi:include href="Useful_Scripts-syscallsbyprocpid.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
72 </section>
73 <!-- removed; handler function no longer working as expected
74 <xi:include href="Useful_Scripts-kernelprofiling.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> -->
75
76
77 <xi:include href="Useful_Scripts-futexes.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
78
79 <!-- <xi:include href="Useful_Scripts-Network.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
80 <xi:include href="Useful_Scripts-Signals.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
81 <xi:include href="Useful_Scripts-Syscalls.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
82 <xi:include href="Useful_Scripts-Others.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />-->
83 <!--
84 <xi:include href="" xmlns:xi="http://www.w3.org/2001/XInclude" />
85 -->
86 </chapter>
87