+++ /dev/null
-WARNINGS
-images.*
-*.pl
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>
<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>
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 <A HREF="#fig:embedded-C">10</A> contains
another example.
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 <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>
-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
\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
] (./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).
\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
struct list_head *_p, *_n;
list_for_each_safe(_p, _n, ¤t->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);
}
%}
<TR><TD>
Frank Ch. Eigler <TT><FONT SIZE="-1"><fche@redhat.com></FONT></TT>
<BR>
-February 3, 2012
+June 29, 2012
</TD></TR>
</TABLE>
<TR><TD>
Frank Ch. Eigler <TT><FONT SIZE="-1"><fche@redhat.com></FONT></TT>
<BR>
-February 3, 2012
+June 29, 2012
</TD></TR>
</TABLE>