From afd0a6cb4f01ee04a77a6f04348e906edb929732 Mon Sep 17 00:00:00 2001 From: Don Domingo Date: Mon, 20 Jul 2009 10:59:30 +1000 Subject: minor revisions to language --- .../en-US/Useful_Scripts-dropwatch.xml | 28 +++++++++++++++------- 1 file changed, 19 insertions(+), 9 deletions(-) (limited to 'doc/SystemTap_Beginners_Guide') diff --git a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-dropwatch.xml b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-dropwatch.xml index c7bee988..3bc69899 100644 --- a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-dropwatch.xml +++ b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-dropwatch.xml @@ -39,11 +39,10 @@ tracepoint The network stack in Linux can discard packets for various reasons. Some Linux kernels include a -tracepoint, kernel.trace("kfree_skb"), to allow easy probing -to determine where the packets are discarded. The -script uses that tracepoint trace packet discards. The script summarizes the -locations discarding packets every five seconds as totals number of packets -discarded for each location. +tracepoint, kernel.trace("kfree_skb"), which easily tracks where packets +are discarded. uses kernel.trace("kfree_skb") to trace +packet discards; the script summarizes which locations +discard packets every five-second interval. @@ -56,9 +55,8 @@ discarded for each location. -The kernel.trace("kfree_skb") instruments each of the places -in the kernel that drops network packets. Like probes for functions the -tracepoint probes also have arguments. The +The kernel.trace("kfree_skb") traces which places +in the kernel drop network packets. The kernel.trace("kfree_skb") has two arguments: a pointer to the buffer being freed ($skb) and the location in kernel code the buffer is being freed ($location). @@ -87,6 +85,18 @@ Stopping dropped packet monitor + +To make the location of packet drops more meaningful, refer to the +/boot/System.map-`uname -r` file. This file lists the +starting addresses for each function, allowing you to map the +addresses in the output of to a specific +function name. Given the following snippet of the /boot/System.map-`uname -r` file, +the +address 0xffffffff8024cd0f maps to the function +unix_stream_recvmsg and the address 0xffffffff8044b472 maps +to the function arp_rcv: + + [...] ffffffff8024c5cd T unlock_new_inode -- cgit From 83a2e2b55a9eacdd36ac4ea4d8e59e9204123ceb Mon Sep 17 00:00:00 2001 From: Don Domingo Date: Mon, 20 Jul 2009 11:42:33 +1000 Subject: revising for brew build --- doc/SystemTap_Beginners_Guide/en-US/Book_Info.xml | 2 +- .../en-US/Revision_History.xml | 32 +++++++++++++++++++++- 2 files changed, 32 insertions(+), 2 deletions(-) (limited to 'doc/SystemTap_Beginners_Guide') diff --git a/doc/SystemTap_Beginners_Guide/en-US/Book_Info.xml b/doc/SystemTap_Beginners_Guide/en-US/Book_Info.xml index 5dfeeee2..acca17ae 100644 --- a/doc/SystemTap_Beginners_Guide/en-US/Book_Info.xml +++ b/doc/SystemTap_Beginners_Guide/en-US/Book_Info.xml @@ -5,7 +5,7 @@ SystemTap Beginners Guide Introduction to SystemTap (for Red Hat Enterprise Linux 5.4) - Introduction to SystemTap (for Fedora 10) + 2.0 Red Hat Enterprise Linux diff --git a/doc/SystemTap_Beginners_Guide/en-US/Revision_History.xml b/doc/SystemTap_Beginners_Guide/en-US/Revision_History.xml index d5ce8446..96201d56 100644 --- a/doc/SystemTap_Beginners_Guide/en-US/Revision_History.xml +++ b/doc/SystemTap_Beginners_Guide/en-US/Revision_History.xml @@ -6,7 +6,36 @@ Revision History - + + 2.0 + Mon Jul 20 2009 + + Don + Domingo + ddomingo@redhat.com + + + + includes 5.4 minor updates and additional script "dropwatch.stp" + + + + + + 1.0 + Wed Jun 17 2009 + + Don + Domingo + ddomingo@redhat.com + + + + Building+pushing to RHEL + + + + -- cgit From a23fc5e3fc3e6783226a8c9092ada9ec6d0a6c53 Mon Sep 17 00:00:00 2001 From: Don Domingo Date: Mon, 20 Jul 2009 13:16:47 +1000 Subject: minor typo --- doc/SystemTap_Beginners_Guide/en-US/Installation.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'doc/SystemTap_Beginners_Guide') diff --git a/doc/SystemTap_Beginners_Guide/en-US/Installation.xml b/doc/SystemTap_Beginners_Guide/en-US/Installation.xml index d0ce1f26..ab984b14 100644 --- a/doc/SystemTap_Beginners_Guide/en-US/Installation.xml +++ b/doc/SystemTap_Beginners_Guide/en-US/Installation.xml @@ -213,7 +213,7 @@ enabled=1 Replace kernelname with the appropriate kernel variant name (for example, kernel-PAE), and version with the target kernel's version. For example, to install the required kernel information packages for - the kernel-PAE--2.6.18-53.1.13.el5 kernel, run: + the kernel-PAE-2.6.18-53.1.13.el5 kernel, run: -- cgit