From: wcohen Date: Fri, 29 Jun 2012 18:36:47 +0000 (+0000) Subject: Update tutorial to SystemTap-1.8 version. X-Git-Url: https://sourceware.org/git/?a=commitdiff_plain;h=0b74d199939d5cbc474b89aed579237aa95454c1;p=systemtap-htdocs.git Update tutorial to SystemTap-1.8 version. --- diff --git a/tutorial.pdf b/tutorial.pdf index e70ed282..283a3f9b 100644 Binary files a/tutorial.pdf and b/tutorial.pdf differ diff --git a/tutorial/.gitignore b/tutorial/.gitignore deleted file mode 100644 index 69c55197..00000000 --- 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 23c5f92e..0a2a9be5 100644 --- 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:
latex2html -noaddress -show_section_numbers -custom_titles -local_icons -split 4 tutorial.tex -dir ./tutorial2

-The translation was initiated by William Cohen on 2012-02-03 +The translation was initiated by William Cohen on 2012-06-29

diff --git a/tutorial/Further_information.html b/tutorial/Further_information.html index 61d6475d..dd761b1f 100644 --- a/tutorial/Further_information.html +++ b/tutorial/Further_information.html @@ -69,14 +69,20 @@ There are man pages: stappaths your systemtap installation paths -stapfuncs -functions provided by tapsets - stapprobes -probes / probe aliases provided by tapsets +probes / probe aliases provided by built-in tapsets stapex -some example scripts +a few basic example scripts + +tapset::* +summaries of the probes and functions in each tapset + +probe::* +detailed descriptions of each probe + +function::* +detailed descriptions of each function diff --git a/tutorial/Tapsets.html b/tutorial/Tapsets.html index 63bbd5ad..319b35ac 100644 --- 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 { and }, use %{ and %}. 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 THIS 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 STAP_ARG_* and +STAP_RETVALUE are made available. The familiar data-gathering functions pid(), execname(), and their neighbours are all embedded C functions. Figure 10 contains another example. diff --git a/tutorial/Tracing.html b/tutorial/Tracing.html index 9769cd56..c77e2390 100644 --- 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 1. See the -stapfuncs man page for those functions and more defined in the +function::* man pages for those functions and more defined in the tapset library, but here's a sampling:

diff --git a/tutorial/images.log b/tutorial/images.log index decc2b70..654d1196 100644 --- 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 87a3e4e9..c188d5a3 100644 --- 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, ¤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); } %} diff --git a/tutorial/img12.png b/tutorial/img12.png index 99693838..63f6a95a 100644 Binary files a/tutorial/img12.png and b/tutorial/img12.png differ diff --git a/tutorial/img6.png b/tutorial/img6.png index 2a8af6c4..9b7b1de5 100644 Binary files a/tutorial/img6.png and b/tutorial/img6.png differ diff --git a/tutorial/index.html b/tutorial/index.html index 47ee5328..a4667cb5 100644 --- a/tutorial/index.html +++ b/tutorial/index.html @@ -51,7 +51,7 @@ original version by: Nikos Drakos, CBLU, University of Leeds Frank Ch. Eigler <fche@redhat.com>
-February 3, 2012 +June 29, 2012 diff --git a/tutorial/tutorial.html b/tutorial/tutorial.html index 47ee5328..a4667cb5 100644 --- a/tutorial/tutorial.html +++ b/tutorial/tutorial.html @@ -51,7 +51,7 @@ original version by: Nikos Drakos, CBLU, University of Leeds Frank Ch. Eigler <fche@redhat.com>
-February 3, 2012 +June 29, 2012