From bbd2860f9c95fbef790a2f414c8fc6548c5fec3d Mon Sep 17 00:00:00 2001 From: ddomingo Date: Tue, 4 Nov 2008 12:50:46 +1000 Subject: added notes and questions to several XMLs --- doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-disktop.xml | 2 ++ doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-iotop.xml | 2 ++ doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-traceio.xml | 2 ++ 3 files changed, 6 insertions(+) (limited to 'doc/SystemTap_Beginners_Guide/en-US') diff --git a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-disktop.xml b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-disktop.xml index 041a4689..028ab530 100644 --- a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-disktop.xml +++ b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-disktop.xml @@ -42,7 +42,9 @@ BYTES — the amount of data read to or written from disk. +The time and date in the output of is returned by the functions ctime() and gettimeofday_s(). ctime() derives calendar time in terms of seconds passed since the Unix epoch (January 1, 1970). gettimeofday_s() counts the actual number of seconds since Unix epoch, which gives a fairly accurate human-readable timestamp for the output. +needinfo: what does $return do? <xref linkend="scriptdisktop"/> Sample Output diff --git a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-iotop.xml b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-iotop.xml index 4fd41c6e..6742740f 100644 --- a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-iotop.xml +++ b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-iotop.xml @@ -16,6 +16,8 @@ +what does $count do, specifically? + prints out the top ten executables generating I/O traffic every 5-second interval, in descending order. Its output contains the process name and the amount of data read or written by the process, in KB. For example: diff --git a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-traceio.xml b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-traceio.xml index 71bd1984..14dc754c 100644 --- a/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-traceio.xml +++ b/doc/SystemTap_Beginners_Guide/en-US/Useful_Scripts-traceio.xml @@ -17,6 +17,8 @@ +what do $return, $length, and $count return, specifically? when i substituted $return for $length here, script still ran but gave me bigger numbers. errored out with $length. where documented? + is similar to (from ); both SystemTap scripts print out the top ten executables generating I/O traffic over time. However, tracks the cumulative amount of I/O reads and writes done by the system's top ten executables. This information is tracked and printed out in 1-second intervals and in descending order. -- cgit