Update tutorial to SystemTap-1.8 version.

diff --git a/tutorial.pdf b/tutorial.pdf
index e70ed2829412594ff249f02328abd23ac4c9ee50..283a3f9bfda6f65188ddc8ab0133c16c5f87d155 100644 (file)
Binary files a/tutorial.pdf and b/tutorial.pdf differ

diff --git a/tutorial/.gitignore b/tutorial/.gitignore
deleted file mode 100644 (file)
index 69c5519..0000000
--- a/tutorial/.gitignore
+++ /dev/null
@@ -1,3 +0,0 @@
-WARNINGS
-images.*
-*.pl

diff --git a/tutorial/About_this_document.html b/tutorial/About_this_document.html
index 23c5f92e64a4c28513334dce1cfe4041c7893781..0a2a9be50e4c3d3946cb968c8798aa0e79c03a2c 100644 (file)
--- a/tutorial/About_this_document.html
+++ b/tutorial/About_this_document.html
@@ -63,7 +63,7 @@ Mathematics Department, Macquarie University, Sydney.
 The command line arguments were: <BR>
  <STRONG>latex2html</STRONG> <TT>-noaddress -show_section_numbers -custom_titles -local_icons -split 4 tutorial.tex -dir ./tutorial2</TT>
 <P>
-The translation was initiated by William Cohen on 2012-02-03
+The translation was initiated by William Cohen on 2012-06-29
 <BR><HR>
 
 </BODY>

diff --git a/tutorial/Further_information.html b/tutorial/Further_information.html
index 61d6475d6b80fa982496eed7477ed258ea6f438e..dd761b1facb632df9645db2e4c86998276ac4ca9 100644 (file)
--- a/tutorial/Further_information.html
+++ b/tutorial/Further_information.html
@@ -69,14 +69,20 @@ There are <code>man</code> pages:
 <TR><TD ALIGN="RIGHT"><code>stappaths</code></TD>
 <TD ALIGN="LEFT">your systemtap installation paths</TD>
 </TR>
-<TR><TD ALIGN="RIGHT"><code>stapfuncs</code></TD>
-<TD ALIGN="LEFT">functions provided by tapsets</TD>
-</TR>
 <TR><TD ALIGN="RIGHT"><code>stapprobes</code></TD>
-<TD ALIGN="LEFT">probes / probe aliases provided by tapsets</TD>
+<TD ALIGN="LEFT">probes / probe aliases provided by built-in tapsets</TD>
 </TR>
 <TR><TD ALIGN="RIGHT"><code>stapex</code></TD>
-<TD ALIGN="LEFT">some example scripts</TD>
+<TD ALIGN="LEFT">a few basic example scripts</TD>
+</TR>
+<TR><TD ALIGN="RIGHT"><code>tapset::*</code></TD>
+<TD ALIGN="LEFT">summaries of the probes and functions in each tapset</TD>
+</TR>
+<TR><TD ALIGN="RIGHT"><code>probe::*</code></TD>
+<TD ALIGN="LEFT">detailed descriptions of each probe</TD>
+</TR>
+<TR><TD ALIGN="RIGHT"><code>function::*</code></TD>
+<TD ALIGN="LEFT">detailed descriptions of each function</TD>
 </TR>
 </TABLE>
 

diff --git a/tutorial/Tapsets.html b/tutorial/Tapsets.html
index 63bbd5add5d2d19b39cecf3a6c09081a059d8531..319b35ac4194845a4b8f6aea35d6d75b89cd76e8 100644 (file)
--- a/tutorial/Tapsets.html
+++ b/tutorial/Tapsets.html
@@ -249,9 +249,8 @@ Embedded C can be the body of a script function.  Instead enclosing
 the function body statements in <code>{</code> and <code>}</code>, use <code>%{</code>
 and <code>%}</code>.  Any enclosed C code is literally transcribed into the
 kernel module: it is up to you to make it safe and correct.  In order
-to take parameters and return a value, a pointer macro <code>THIS</code> is
-available.  Function parameters and a place for the return value are
-available as fields of that pointer.  The familiar data-gathering
+to take parameters and return a value, macros <code>STAP_ARG_*</code> and
+<code>STAP_RETVALUE</code> are made available.  The familiar data-gathering
 functions <code>pid()</code>, <code>execname()</code>, and their neighbours are
 all embedded C functions.  Figure&nbsp;<A HREF="#fig:embedded-C">10</A> contains
 another example.

diff --git a/tutorial/Tracing.html b/tutorial/Tracing.html
index 9769cd5635d97acff4b9830fc24f7a16866efe44..c77e23906aa7fae630c85e5eade2a6568e0fbeb1 100644 (file)
--- a/tutorial/Tracing.html
+++ b/tutorial/Tracing.html
@@ -185,7 +185,7 @@ the line.
 Systemtap provides a variety of such contextual data, ready for
 formatting.  They usually appear as function calls within the handler,
 like you already saw in Figure&nbsp;<A HREF="Introduction.html#fig:strace-open">1</A>.  <B>See the
-<code>stapfuncs</code> man page for those functions and more defined in the
+<code>function::*</code> man pages for those functions and more defined in the
 tapset library</B>, but here's a sampling:
 
 <P>

diff --git a/tutorial/images.log b/tutorial/images.log
index decc2b7006bc8c229c77302ed092a0ed3da19b1b..654d11965fd890baeb98de2a982ad0c1d9e18c0c 100644 (file)
--- a/tutorial/images.log
+++ b/tutorial/images.log
@@ -1,4 +1,4 @@
-This is pdfTeXk, Version 3.141592-1.40.3 (Web2C 7.5.6) (format=latex 2010.11.23)  3 FEB 2012 14:55
+This is pdfTeXk, Version 3.141592-1.40.3 (Web2C 7.5.6) (format=latex 2012.2.16)  29 JUN 2012 14:24
 entering extended mode
  %&-line parsing enabled.
 **./images.tex
@@ -162,7 +162,7 @@ Style option: `fancybox' v1.3 <2000/09/19> (tvz)
 \EndVerbatimTokens=\toks24
 \Verbatim@Outfile=\write5
 \Verbatim@Infile=\read2
-) (/home/wcohen/research/profiling/systemtap_write/systemtap/doc/nomencl.sty
+) (/tmp/systemtap-1.8/doc/nomencl.sty
 Package: nomencl 2005/09/22 v4.2 Nomenclature package (LN)
 \nomlabelwidth=\dimen113
 \nom@tempdim=\dimen114
@@ -449,11 +449,11 @@ l2hSize :tex2html_wrap_inline495:7.22998pt::0.0pt::12.16664pt.
 ] (./images.aux) ) 
 Here is how much of TeX's memory you used:
  4823 strings out of 256217
- 68173 string characters out of 1917094
+ 68056 string characters out of 1917095
  129611 words of memory out of 1500000
  8089 multiletter control sequences out of 10000+200000
  4402 words of font info for 16 fonts, out of 1200000 for 2000
  645 hyphenation exceptions out of 8191
  32i,6n,32p,225b,384s stack positions out of 5000i,500n,6000p,200000b,15000s
 
-Output written on images.dvi (13 pages, 17724 bytes).
+Output written on images.dvi (13 pages, 17752 bytes).

diff --git a/tutorial/images.tex b/tutorial/images.tex
index 87a3e4e9e35825ea8ffd5d6446d65b7d731bc12f..c188d5a3479c5f28762d8ac735b538fc30fd0380 100644 (file)
--- a/tutorial/images.tex
+++ b/tutorial/images.tex
@@ -320,7 +320,7 @@ more(30789) vfs_read 0xfd00003/133099\end{verbatim}
 \begin{center}\begin{Sbox}\begin{minipage}{4.5in}
 \begin{verbatim}
 
-# Red Hat convention
+# Red Hat convention; see /etc/login.defs UID_MIN
 function system_uid_p (u) { return u < 500 }
 
 # kernel device number assembly macro
@@ -472,8 +472,8 @@ function task_execname_by_pid:string (pid:long) %{
   struct list_head *_p, *_n;
   list_for_each_safe(_p, _n, &current->tasks) {
     p = list_entry(_p, struct task_struct, tasks);
-    if (p->pid == (int)THIS->pid) 
-      snprintf(THIS->__retvalue, MAXSTRINGLEN, "%s", p->comm);
+    if (p->pid == (int)STAP_ARG_pid) 
+      snprintf(STAP_RETVALUE, MAXSTRINGLEN, "%s", p->comm);
   }
 %}
 

diff --git a/tutorial/img12.png b/tutorial/img12.png
index 996938383537cd7e3cb6d4f5654455c1c7ea589c..63f6a95aefd1c6e0109ef68adba65728eda2e478 100644 (file)
Binary files a/tutorial/img12.png and b/tutorial/img12.png differ

diff --git a/tutorial/img6.png b/tutorial/img6.png
index 2a8af6c4d7ec67e77f414fe892439be82d4b201d..9b7b1de5de1ea1882172a83adf8659f82c5ae3f0 100644 (file)
Binary files a/tutorial/img6.png and b/tutorial/img6.png differ

diff --git a/tutorial/index.html b/tutorial/index.html
index 47ee532869f76866ac2bdc64dadebffe62b84046..a4667cb5412a3be06bc76f06b2d79f7ce7855a42 100644 (file)
--- a/tutorial/index.html
+++ b/tutorial/index.html
@@ -51,7 +51,7 @@ original version by:  Nikos Drakos, CBLU, University of Leeds
 <TR><TD>
 Frank Ch. Eigler <TT><FONT SIZE="-1">&lt;fche@redhat.com&gt;</FONT></TT> 
 <BR>
-February 3, 2012
+June 29, 2012
 </TD></TR>
 </TABLE>
 

diff --git a/tutorial/tutorial.html b/tutorial/tutorial.html
index 47ee532869f76866ac2bdc64dadebffe62b84046..a4667cb5412a3be06bc76f06b2d79f7ce7855a42 100644 (file)
--- a/tutorial/tutorial.html
+++ b/tutorial/tutorial.html
@@ -51,7 +51,7 @@ original version by:  Nikos Drakos, CBLU, University of Leeds
 <TR><TD>
 Frank Ch. Eigler <TT><FONT SIZE="-1">&lt;fche@redhat.com&gt;</FONT></TT> 
 <BR>
-February 3, 2012
+June 29, 2012
 </TD></TR>
 </TABLE>