summaryrefslogtreecommitdiffstats
diff options
authorFrank Ch. Eigler <fche@redhat.com>2024-04-26 17:34:34 -0400
committerFrank Ch. Eigler <fche@redhat.com>2024-04-26 17:34:34 -0400
commit3a0c9c15163520dd0d9ab07177da62ce9cc2332f (patch)
tree1e6668d9d2e425c4c77930d071e639aa28736f08
parentpre-release: scripts/update-docs (diff)
pre-release testsuite reindexrelease-5.1
-rw-r--r--testsuite/systemtap.examples/index.html4
-rw-r--r--testsuite/systemtap.examples/index.txt4
-rw-r--r--testsuite/systemtap.examples/keyword-index.html6
-rw-r--r--testsuite/systemtap.examples/keyword-index.txt6
-rw-r--r--testsuite/systemtap.examples/metadatabase.dbbin194560 -> 194560 bytes
5 files changed, 10 insertions, 10 deletions
diff --git a/testsuite/systemtap.examples/index.html b/testsuite/systemtap.examples/index.html
index dcbed899a..c78bb73b2 100644
--- a/testsuite/systemtap.examples/index.html
+++ b/testsuite/systemtap.examples/index.html
@@ -38,7 +38,7 @@
38 <li><a href="keyword-index.html">By Keyword</a></li> 38 <li><a href="keyword-index.html">By Keyword</a></li>
39 </ul> 39 </ul>
40 40
41<p><em>For systemtap version 5.0.</em></p><h2>Best Examples</h2> 41<p><em>For systemtap version 5.1.</em></p><h2>Best Examples</h2>
42<ul> 42<ul>
43<li><a href="#general/helloworld.stp">general/helloworld.stp - SystemTap "Hello World" Program</a></li> 43<li><a href="#general/helloworld.stp">general/helloworld.stp - SystemTap "Hello World" Program</a></li>
44<li><a href="#general/para-callgraph.stp">general/para-callgraph.stp - Callgraph Tracing with Arguments</a></li> 44<li><a href="#general/para-callgraph.stp">general/para-callgraph.stp - Callgraph Tracing with Arguments</a></li>
@@ -525,7 +525,7 @@ keywords: <a href="keyword-index.html#_BEST">_BEST</a> <a href="keyword-index.ht
525<p>The fntimes.stp script monitors the execution time history of a given function family (assumed non-recursive). Each time (beyond a warmup interval) is then compared to the historical maximum. If it exceeds a certain threshold (250%), a message is printed.</p><p><i><a href="profiling/fntimes.txt">sample usage in profiling/fntimes.txt</i></font></p> 525<p>The fntimes.stp script monitors the execution time history of a given function family (assumed non-recursive). Each time (beyond a warmup interval) is then compared to the historical maximum. If it exceeds a certain threshold (250%), a message is printed.</p><p><i><a href="profiling/fntimes.txt">sample usage in profiling/fntimes.txt</i></font></p>
526</li><li><a name="profiling/functioncallcount.stp"></a><a href="#profiling/functioncallcount.stp">&para;</a> <a href="profiling/functioncallcount.stp">profiling/functioncallcount.stp</a> - Count Times Functions Are Called<br> 526</li><li><a name="profiling/functioncallcount.stp"></a><a href="#profiling/functioncallcount.stp">&para;</a> <a href="profiling/functioncallcount.stp">profiling/functioncallcount.stp</a> - Count Times Functions Are Called<br>
527keywords: <a href="keyword-index.html#PROFILING">PROFILING</a> <a href="keyword-index.html#FUNCTION">FUNCTION</a> <br> 527keywords: <a href="keyword-index.html#PROFILING">PROFILING</a> <a href="keyword-index.html#FUNCTION">FUNCTION</a> <br>
528<p>The functioncallcount.stp script takes one argument, a list of functions to probe. The script will run and count the number of times that each of the functions on the list is called. On exit the script will print a sorted list from most frequently to least frequently called function.</p><p><font size="-2"><pre># stap -w functioncallcount.stp &quot;*@mm/*.c&quot; -T 1</pre></font></p> 528<p>The functioncallcount.stp script takes one argument, a list of functions to probe. The script will run and count the number of times that each of the functions on the list is called. On exit the script will print a sorted list from most frequently to least frequently called function.</p><p><font size="-2"><pre># stap -w functioncallcount.stp &quot;*@fs/*.c&quot; -T 1</pre></font></p>
529</li><li><a name="profiling/ioctl_handler.stp"></a><a href="#profiling/ioctl_handler.stp">&para;</a> <a href="profiling/ioctl_handler.stp">profiling/ioctl_handler.stp</a> - Monitor which executables use ioctl syscalls and what kernel code is handling the ioctl<br> 529</li><li><a name="profiling/ioctl_handler.stp"></a><a href="#profiling/ioctl_handler.stp">&para;</a> <a href="profiling/ioctl_handler.stp">profiling/ioctl_handler.stp</a> - Monitor which executables use ioctl syscalls and what kernel code is handling the ioctl<br>
530keywords: <a href="keyword-index.html#PROFILING">PROFILING</a> <br> 530keywords: <a href="keyword-index.html#PROFILING">PROFILING</a> <br>
531<p>The ioctl systemcall is used to manipulate devices setting or special files. The way that ioctl syscalls are handled depend greatly on the device the special file is associated with. Using strace to monitor the open and ioctl syscalls may not give a good indication of what kernel code is actually handling the ioctl operations. The ioctl_handler.stp script is designed to provide more details. On exit the ioctl_handler.stp script provides a count of the ioctl syscalls for each executable run on the system. If there was some special device driver code used to handle to the ioctl, the output will have a tally of the times the function name and module was called for that executable. The &quot;--all-modules&quot; option should be included on the command line so the script can provide function name information.</p><p><font size="-2"><pre># stap ioctl_handler.stp --all-modules -T 1</pre></font></p> 531<p>The ioctl systemcall is used to manipulate devices setting or special files. The way that ioctl syscalls are handled depend greatly on the device the special file is associated with. Using strace to monitor the open and ioctl syscalls may not give a good indication of what kernel code is actually handling the ioctl operations. The ioctl_handler.stp script is designed to provide more details. On exit the ioctl_handler.stp script provides a count of the ioctl syscalls for each executable run on the system. If there was some special device driver code used to handle to the ioctl, the output will have a tally of the times the function name and module was called for that executable. The &quot;--all-modules&quot; option should be included on the command line so the script can provide function name information.</p><p><font size="-2"><pre># stap ioctl_handler.stp --all-modules -T 1</pre></font></p>
diff --git a/testsuite/systemtap.examples/index.txt b/testsuite/systemtap.examples/index.txt
index 571522975..ab5f6d95b 100644
--- a/testsuite/systemtap.examples/index.txt
+++ b/testsuite/systemtap.examples/index.txt
@@ -2,7 +2,7 @@ SYSTEMTAP EXAMPLES INDEX
2(see also keyword-index.txt) 2(see also keyword-index.txt)
3 3
4 4
5For systemtap version 5.0. 5For systemtap version 5.1.
6 6
7apps/gmalloc_watch.stp - Tracing glib2 memory allocations 7apps/gmalloc_watch.stp - Tracing glib2 memory allocations
8keywords: trace 8keywords: trace
@@ -1726,7 +1726,7 @@ keywords: profiling function
1726 will print a sorted list from most frequently to least frequently 1726 will print a sorted list from most frequently to least frequently
1727 called function. 1727 called function.
1728 1728
1729 # stap -w functioncallcount.stp "*@mm/*.c" -T 1 1729 # stap -w functioncallcount.stp "*@fs/*.c" -T 1
1730 1730
1731 1731
1732profiling/ioctl_handler.stp - Monitor which executables use ioctl syscalls and what kernel code is handling the ioctl 1732profiling/ioctl_handler.stp - Monitor which executables use ioctl syscalls and what kernel code is handling the ioctl
diff --git a/testsuite/systemtap.examples/keyword-index.html b/testsuite/systemtap.examples/keyword-index.html
index fc6fb9873..6bdaf33cc 100644
--- a/testsuite/systemtap.examples/keyword-index.html
+++ b/testsuite/systemtap.examples/keyword-index.html
@@ -38,7 +38,7 @@
38 <li><a href="keyword-index.html">By Keyword</a></li> 38 <li><a href="keyword-index.html">By Keyword</a></li>
39 </ul> 39 </ul>
40 40
41<p><em>For systemtap version 5.0.</em></p><h2>Examples by Keyword</h2> 41<p><em>For systemtap version 5.1.</em></p><h2>Examples by Keyword</h2>
42<p><tt><a href="#_BEST">_BEST(17)</a> <a href="#APPLICATION">APPLICATION(2)</a> <a href="#BACKTRACE">BACKTRACE(8)</a> <a href="#BPF">BPF(11)</a> <a href="#CALLGRAPH">CALLGRAPH(4)</a> <a href="#CONTAINER">CONTAINER(1)</a> <a href="#DIAGRAM">DIAGRAM(1)</a> <a href="#DISK">DISK(5)</a> <a href="#DYNINST">DYNINST(1)</a> <a href="#FILE">FILE(2)</a> <a href="#FILESYSTEM">FILESYSTEM(4)</a> <a href="#FLOATINGPOINT">FLOATINGPOINT(1)</a> <a href="#FORMAT">FORMAT(2)</a> <a href="#FUNCTION">FUNCTION(4)</a> <a href="#FUTEX">FUTEX(2)</a> <a href="#GURU">GURU(25)</a> <a href="#INTERACTIVE">INTERACTIVE(2)</a> <a href="#INTERRUPT">INTERRUPT(3)</a> <a href="#IO">IO(31)</a> <a href="#JSON">JSON(2)</a> <a href="#KVM">KVM(3)</a> <a href="#LIMITS">LIMITS(3)</a> <a href="#LOCKING">LOCKING(6)</a> <a href="#MEMORY">MEMORY(20)</a> <a href="#MONITORING">MONITORING(9)</a> <a href="#NANOSLEEP">NANOSLEEP(1)</a> <a href="#NETWORK">NETWORK(21)</a> <a href="#NFS">NFS(5)</a> <a href="#NUMA">NUMA(1)</a> <a href="#PACKETS">PACKETS(1)</a> <a href="#PROCESS">PROCESS(27)</a> <a href="#PROFILING">PROFILING(24)</a> <a href="#PROMETHEUS">PROMETHEUS(6)</a> <a href="#QEMU">QEMU(2)</a> <a href="#REGEX">REGEX(1)</a> <a href="#RETRANSMISSION">RETRANSMISSION(1)</a> <a href="#SCHEDULER">SCHEDULER(9)</a> <a href="#SCSI">SCSI(1)</a> <a href="#SECURITY">SECURITY(19)</a> <a href="#SIGNALS">SIGNALS(5)</a> <a href="#SIMPLE">SIMPLE(11)</a> <a href="#SOCKET">SOCKET(8)</a> <a href="#SPECULATION">SPECULATION(1)</a> <a href="#STAPGAMES">STAPGAMES(5)</a> <a href="#STATISTICS">STATISTICS(10)</a> <a href="#SYSCALL">SYSCALL(19)</a> <a href="#TCP">TCP(4)</a> <a href="#THREAD">THREAD(2)</a> <a href="#TIME">TIME(4)</a> <a href="#TRACE">TRACE(11)</a> <a href="#TRACEPOINT">TRACEPOINT(8)</a> <a href="#TRAFFIC">TRAFFIC(8)</a> <a href="#TTY">TTY(1)</a> <a href="#VIRTUALIZATION">VIRTUALIZATION(3)</a> <a href="#WATCHDOG">WATCHDOG(1)</a> <a href="#WATCHPOINT">WATCHPOINT(2)</a> </tt></p> 42<p><tt><a href="#_BEST">_BEST(17)</a> <a href="#APPLICATION">APPLICATION(2)</a> <a href="#BACKTRACE">BACKTRACE(8)</a> <a href="#BPF">BPF(11)</a> <a href="#CALLGRAPH">CALLGRAPH(4)</a> <a href="#CONTAINER">CONTAINER(1)</a> <a href="#DIAGRAM">DIAGRAM(1)</a> <a href="#DISK">DISK(5)</a> <a href="#DYNINST">DYNINST(1)</a> <a href="#FILE">FILE(2)</a> <a href="#FILESYSTEM">FILESYSTEM(4)</a> <a href="#FLOATINGPOINT">FLOATINGPOINT(1)</a> <a href="#FORMAT">FORMAT(2)</a> <a href="#FUNCTION">FUNCTION(4)</a> <a href="#FUTEX">FUTEX(2)</a> <a href="#GURU">GURU(25)</a> <a href="#INTERACTIVE">INTERACTIVE(2)</a> <a href="#INTERRUPT">INTERRUPT(3)</a> <a href="#IO">IO(31)</a> <a href="#JSON">JSON(2)</a> <a href="#KVM">KVM(3)</a> <a href="#LIMITS">LIMITS(3)</a> <a href="#LOCKING">LOCKING(6)</a> <a href="#MEMORY">MEMORY(20)</a> <a href="#MONITORING">MONITORING(9)</a> <a href="#NANOSLEEP">NANOSLEEP(1)</a> <a href="#NETWORK">NETWORK(21)</a> <a href="#NFS">NFS(5)</a> <a href="#NUMA">NUMA(1)</a> <a href="#PACKETS">PACKETS(1)</a> <a href="#PROCESS">PROCESS(27)</a> <a href="#PROFILING">PROFILING(24)</a> <a href="#PROMETHEUS">PROMETHEUS(6)</a> <a href="#QEMU">QEMU(2)</a> <a href="#REGEX">REGEX(1)</a> <a href="#RETRANSMISSION">RETRANSMISSION(1)</a> <a href="#SCHEDULER">SCHEDULER(9)</a> <a href="#SCSI">SCSI(1)</a> <a href="#SECURITY">SECURITY(19)</a> <a href="#SIGNALS">SIGNALS(5)</a> <a href="#SIMPLE">SIMPLE(11)</a> <a href="#SOCKET">SOCKET(8)</a> <a href="#SPECULATION">SPECULATION(1)</a> <a href="#STAPGAMES">STAPGAMES(5)</a> <a href="#STATISTICS">STATISTICS(10)</a> <a href="#SYSCALL">SYSCALL(19)</a> <a href="#TCP">TCP(4)</a> <a href="#THREAD">THREAD(2)</a> <a href="#TIME">TIME(4)</a> <a href="#TRACE">TRACE(11)</a> <a href="#TRACEPOINT">TRACEPOINT(8)</a> <a href="#TRAFFIC">TRAFFIC(8)</a> <a href="#TTY">TTY(1)</a> <a href="#VIRTUALIZATION">VIRTUALIZATION(3)</a> <a href="#WATCHDOG">WATCHDOG(1)</a> <a href="#WATCHPOINT">WATCHPOINT(2)</a> </tt></p>
43<h3><a name="_BEST"><a href="#_BEST">&para;</a> _BEST</a></h3> 43<h3><a name="_BEST"><a href="#_BEST">&para;</a> _BEST</a></h3>
44<ul> 44<ul>
@@ -268,7 +268,7 @@ keywords: <a href="keyword-index.html#SPECULATION">SPECULATION</a> <a href="keyw
268<p>The whythefail.stp script prints a statement-execution trace for a given function, but only for those runs of the function that ended up with a (configurable) post-return condition.</p><p><i><a href="general/whythefail.txt">sample usage in general/whythefail.txt</i></font></p> 268<p>The whythefail.stp script prints a statement-execution trace for a given function, but only for those runs of the function that ended up with a (configurable) post-return condition.</p><p><i><a href="general/whythefail.txt">sample usage in general/whythefail.txt</i></font></p>
269</li><li><a href="profiling/functioncallcount.stp">profiling/functioncallcount.stp</a> - Count Times Functions Are Called<br> 269</li><li><a href="profiling/functioncallcount.stp">profiling/functioncallcount.stp</a> - Count Times Functions Are Called<br>
270keywords: <a href="keyword-index.html#PROFILING">PROFILING</a> <a href="keyword-index.html#FUNCTION">FUNCTION</a> <br> 270keywords: <a href="keyword-index.html#PROFILING">PROFILING</a> <a href="keyword-index.html#FUNCTION">FUNCTION</a> <br>
271<p>The functioncallcount.stp script takes one argument, a list of functions to probe. The script will run and count the number of times that each of the functions on the list is called. On exit the script will print a sorted list from most frequently to least frequently called function.</p><p><font size="-2"><pre># stap -w functioncallcount.stp &quot;*@mm/*.c&quot; -T 1</pre></font></p> 271<p>The functioncallcount.stp script takes one argument, a list of functions to probe. The script will run and count the number of times that each of the functions on the list is called. On exit the script will print a sorted list from most frequently to least frequently called function.</p><p><font size="-2"><pre># stap -w functioncallcount.stp &quot;*@fs/*.c&quot; -T 1</pre></font></p>
272</li><li><a href="profiling/sched_switch.stp">profiling/sched_switch.stp</a> - Display the Task Switches Happening in the Scheduler<br> 272</li><li><a href="profiling/sched_switch.stp">profiling/sched_switch.stp</a> - Display the Task Switches Happening in the Scheduler<br>
273keywords: <a href="keyword-index.html#PROFILING">PROFILING</a> <a href="keyword-index.html#FUNCTION">FUNCTION</a> <br> 273keywords: <a href="keyword-index.html#PROFILING">PROFILING</a> <a href="keyword-index.html#FUNCTION">FUNCTION</a> <br>
274<p>The sched_switch.stp script takes two arguments, first argument can be &quot;pid&quot; or &quot;name&quot; to indicate what is being passed as second argument. The script will trace the process based on pid/name and print the scheduler switches happening with the process. If no arguments are passed, it displays all the scheduler switches. This can be used to understand which tasks schedule out the current process being traced, and when it gets scheduled in again.</p><p><font size="-2"><pre># stap sched_switch.stp -T 1</pre></font></p> 274<p>The sched_switch.stp script takes two arguments, first argument can be &quot;pid&quot; or &quot;name&quot; to indicate what is being passed as second argument. The script will trace the process based on pid/name and print the scheduler switches happening with the process. If no arguments are passed, it displays all the scheduler switches. This can be used to understand which tasks schedule out the current process being traced, and when it gets scheduled in again.</p><p><font size="-2"><pre># stap sched_switch.stp -T 1</pre></font></p>
@@ -846,7 +846,7 @@ keywords: <a href="keyword-index.html#_BEST">_BEST</a> <a href="keyword-index.ht
846<p>The fntimes.stp script monitors the execution time history of a given function family (assumed non-recursive). Each time (beyond a warmup interval) is then compared to the historical maximum. If it exceeds a certain threshold (250%), a message is printed.</p><p><i><a href="profiling/fntimes.txt">sample usage in profiling/fntimes.txt</i></font></p> 846<p>The fntimes.stp script monitors the execution time history of a given function family (assumed non-recursive). Each time (beyond a warmup interval) is then compared to the historical maximum. If it exceeds a certain threshold (250%), a message is printed.</p><p><i><a href="profiling/fntimes.txt">sample usage in profiling/fntimes.txt</i></font></p>
847</li><li><a href="profiling/functioncallcount.stp">profiling/functioncallcount.stp</a> - Count Times Functions Are Called<br> 847</li><li><a href="profiling/functioncallcount.stp">profiling/functioncallcount.stp</a> - Count Times Functions Are Called<br>
848keywords: <a href="keyword-index.html#PROFILING">PROFILING</a> <a href="keyword-index.html#FUNCTION">FUNCTION</a> <br> 848keywords: <a href="keyword-index.html#PROFILING">PROFILING</a> <a href="keyword-index.html#FUNCTION">FUNCTION</a> <br>
849<p>The functioncallcount.stp script takes one argument, a list of functions to probe. The script will run and count the number of times that each of the functions on the list is called. On exit the script will print a sorted list from most frequently to least frequently called function.</p><p><font size="-2"><pre># stap -w functioncallcount.stp &quot;*@mm/*.c&quot; -T 1</pre></font></p> 849<p>The functioncallcount.stp script takes one argument, a list of functions to probe. The script will run and count the number of times that each of the functions on the list is called. On exit the script will print a sorted list from most frequently to least frequently called function.</p><p><font size="-2"><pre># stap -w functioncallcount.stp &quot;*@fs/*.c&quot; -T 1</pre></font></p>
850</li><li><a href="profiling/ioctl_handler.stp">profiling/ioctl_handler.stp</a> - Monitor which executables use ioctl syscalls and what kernel code is handling the ioctl<br> 850</li><li><a href="profiling/ioctl_handler.stp">profiling/ioctl_handler.stp</a> - Monitor which executables use ioctl syscalls and what kernel code is handling the ioctl<br>
851keywords: <a href="keyword-index.html#PROFILING">PROFILING</a> <br> 851keywords: <a href="keyword-index.html#PROFILING">PROFILING</a> <br>
852<p>The ioctl systemcall is used to manipulate devices setting or special files. The way that ioctl syscalls are handled depend greatly on the device the special file is associated with. Using strace to monitor the open and ioctl syscalls may not give a good indication of what kernel code is actually handling the ioctl operations. The ioctl_handler.stp script is designed to provide more details. On exit the ioctl_handler.stp script provides a count of the ioctl syscalls for each executable run on the system. If there was some special device driver code used to handle to the ioctl, the output will have a tally of the times the function name and module was called for that executable. The &quot;--all-modules&quot; option should be included on the command line so the script can provide function name information.</p><p><font size="-2"><pre># stap ioctl_handler.stp --all-modules -T 1</pre></font></p> 852<p>The ioctl systemcall is used to manipulate devices setting or special files. The way that ioctl syscalls are handled depend greatly on the device the special file is associated with. Using strace to monitor the open and ioctl syscalls may not give a good indication of what kernel code is actually handling the ioctl operations. The ioctl_handler.stp script is designed to provide more details. On exit the ioctl_handler.stp script provides a count of the ioctl syscalls for each executable run on the system. If there was some special device driver code used to handle to the ioctl, the output will have a tally of the times the function name and module was called for that executable. The &quot;--all-modules&quot; option should be included on the command line so the script can provide function name information.</p><p><font size="-2"><pre># stap ioctl_handler.stp --all-modules -T 1</pre></font></p>
diff --git a/testsuite/systemtap.examples/keyword-index.txt b/testsuite/systemtap.examples/keyword-index.txt
index cb3643fbf..87fdfea21 100644
--- a/testsuite/systemtap.examples/keyword-index.txt
+++ b/testsuite/systemtap.examples/keyword-index.txt
@@ -2,7 +2,7 @@ SYSTEMTAP EXAMPLES INDEX BY KEYWORD
2(see also index.txt) 2(see also index.txt)
3 3
4 4
5For systemtap version 5.0. 5For systemtap version 5.1.
6 6
7= _BEST = 7= _BEST =
8 8
@@ -741,7 +741,7 @@ keywords: profiling function
741 will print a sorted list from most frequently to least frequently 741 will print a sorted list from most frequently to least frequently
742 called function. 742 called function.
743 743
744 # stap -w functioncallcount.stp "*@mm/*.c" -T 1 744 # stap -w functioncallcount.stp "*@fs/*.c" -T 1
745 745
746 746
747profiling/sched_switch.stp - Display the Task Switches Happening in the Scheduler 747profiling/sched_switch.stp - Display the Task Switches Happening in the Scheduler
@@ -2685,7 +2685,7 @@ keywords: profiling function
2685 will print a sorted list from most frequently to least frequently 2685 will print a sorted list from most frequently to least frequently
2686 called function. 2686 called function.
2687 2687
2688 # stap -w functioncallcount.stp "*@mm/*.c" -T 1 2688 # stap -w functioncallcount.stp "*@fs/*.c" -T 1
2689 2689
2690 2690
2691profiling/ioctl_handler.stp - Monitor which executables use ioctl syscalls and what kernel code is handling the ioctl 2691profiling/ioctl_handler.stp - Monitor which executables use ioctl syscalls and what kernel code is handling the ioctl
diff --git a/testsuite/systemtap.examples/metadatabase.db b/testsuite/systemtap.examples/metadatabase.db
index 82e9b92a4..7cfe0ab54 100644
--- a/testsuite/systemtap.examples/metadatabase.db
+++ b/testsuite/systemtap.examples/metadatabase.db
Binary files differ