summaryrefslogtreecommitdiffstats
path: root/doc/SystemTap_Beginners_Guide/en-US
diff options
context:
space:
mode:
authorWilliam Cohen <wcohen@redhat.com>2008-12-10 14:49:46 -0500
committerWilliam Cohen <wcohen@redhat.com>2008-12-10 14:49:46 -0500
commit1c0f18a9730f1fa5990c79debfc1960b08c8b7cf (patch)
tree8edd722db8a39e4964f3ad2101355732c8e62896 /doc/SystemTap_Beginners_Guide/en-US
parente557e9564abe26495b516332fec90016bc4760ac (diff)
downloadsystemtap-steved-1c0f18a9730f1fa5990c79debfc1960b08c8b7cf.tar.gz
systemtap-steved-1c0f18a9730f1fa5990c79debfc1960b08c8b7cf.tar.xz
systemtap-steved-1c0f18a9730f1fa5990c79debfc1960b08c8b7cf.zip
Edit useful script examples. Clean up formating para-call-graph-simple.stp
Diffstat (limited to 'doc/SystemTap_Beginners_Guide/en-US')
-rw-r--r--doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-iotime.xml15
-rw-r--r--doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-nettop.xml13
-rwxr-xr-xdoc/SystemTap_Beginners_Guide/en-US/extras/para-callgraph-simple.stp36
3 files changed, 33 insertions, 31 deletions
diff --git a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-iotime.xml b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-iotime.xml
index 21b6db9d..7a1633aa 100644
--- a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-iotime.xml
+++ b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-iotime.xml
@@ -68,13 +68,12 @@
<title><xref linkend="iotime"/> Sample Output</title>
<screen>
[...]
-3123380 2460 (pcscd) access /dev/bus/usb/005/001 read: 0 write: 0
-825946 3364 (NetworkManager) access /sys/class/net/eth0/carrier read: 8190 write: 0
-825955 3364 (NetworkManager) iotime /sys/class/net/eth0/carrier time: 9
-117061 2460 (pcscd) access /dev/bus/usb/003/001 read: 43 write: 0
-117065 2460 (pcscd) iotime /dev/bus/usb/003/001 time: 7
-3973737 2886 (sendmail) access /proc/loadavg read: 4096 write: 0
-3973744 2886 (sendmail) iotime /proc/loadavg time: 11
+825946 3364 (NetworkManager) access /sys/class/net/eth0/carrier read: 8190 write: 0
+825955 3364 (NetworkManager) iotime /sys/class/net/eth0/carrier time: 9
+117061 2460 (pcscd) access /dev/bus/usb/003/001 read: 43 write: 0
+117065 2460 (pcscd) iotime /dev/bus/usb/003/001 time: 7
+3973737 2886 (sendmail) access /proc/loadavg read: 4096 write: 0
+3973744 2886 (sendmail) iotime /proc/loadavg time: 11
[...]
</screen>
</example>
@@ -137,4 +136,4 @@ print("\n")
}
-->
-</section> \ No newline at end of file
+</section>
diff --git a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-nettop.xml b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-nettop.xml
index c51d4b66..2d7e3595 100644
--- a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-nettop.xml
+++ b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-nettop.xml
@@ -63,20 +63,23 @@
<primary>if/else conditionals, alternative syntax</primary>
<secondary>examples of SystemTap scripts</secondary>
</indexterm>
-<para>Note that <command>function print_activity()</command> uses the following constructs:</para>
+<para>Note that <command>function print_activity()</command> uses the following
+expressions:</para>
<screen>
-n_xmit ? @sum(ifxmit[pid, dev, exec, uid])/1024 : 0,
+n_xmit ? @sum(ifxmit[pid, dev, exec, uid])/1024 : 0
n_recv ? @sum(ifrecv[pid, dev, exec, uid])/1024 : 0
</screen>
-<para>These constructs are if/else conditionals. The first statement is simply a more concise way of writing:</para>
+<para>These expressions are if/else conditionals.
+The first statement is simply a more concise way of writing the following
+psuedo code:</para>
<screen>
if n_recv != 0 then
- @sum(ifrecv[pid, dev, exec, uid])/1024
+ @sum(ifrecv[pid, dev, exec, uid])/1024
else
- 0
+ 0
</screen>
<para><xref linkend="nettop"/> tracks which processes are generating network traffic on the system, and provides the following information about each process:</para>
diff --git a/doc/SystemTap_Beginners_Guide/en-US/extras/para-callgraph-simple.stp b/doc/SystemTap_Beginners_Guide/en-US/extras/para-callgraph-simple.stp
index 17cf50a5..1a3e2e03 100755
--- a/doc/SystemTap_Beginners_Guide/en-US/extras/para-callgraph-simple.stp
+++ b/doc/SystemTap_Beginners_Guide/en-US/extras/para-callgraph-simple.stp
@@ -1,39 +1,39 @@
function trace(entry_p) {
- if(tid() in trace)
- printf("%s%s%s\n",thread_indent(entry_p),
- (entry_p>0?"->":"<-"),
- probefunc())
+ if(tid() in trace)
+ printf("%s%s%s\n",thread_indent(entry_p),
+ (entry_p>0?"->":"<-"),
+ probefunc())
}
global trace
probe kernel.function(@1).call {
- if (execname() == "stapio") next # skip our own helper process
- trace[tid()] = 1
- trace(1)
+ if (execname() == "stapio") next # skip our own helper process
+ trace[tid()] = 1
+ trace(1)
}
probe kernel.function(@1).return {
- trace(-1)
- delete trace[tid()]
+ trace(-1)
+ delete trace[tid()]
}
probe kernel.function(@2).call { trace(1) }
probe kernel.function(@2).return { trace(-1) }
function trace(entry_p) {
- if(tid() in trace)
- printf("%s%s%s\n",thread_indent(entry_p),
- (entry_p>0?"->":"<-"),
- probefunc())
+ if(tid() in trace)
+ printf("%s%s%s\n",thread_indent(entry_p),
+ (entry_p>0?"->":"<-"),
+ probefunc())
}
global trace
probe kernel.function(@1).call {
- if (execname() == "stapio") next # skip our own helper process
- trace[tid()] = 1
- trace(1)
+ if (execname() == "stapio") next # skip our own helper process
+ trace[tid()] = 1
+ trace(1)
}
probe kernel.function(@1).return {
- trace(-1)
- delete trace[tid()]
+ trace(-1)
+ delete trace[tid()]
}
probe kernel.function(@2).call { trace(1) }