HREF="node11.html#SECTION0001111100000000000000">9.1.11 warn</A>
</UL>
<LI><A NAME="tex2html136"
- HREF="node11.html#SECTION000112000000000000000">9.2 Task context at the probe point</A>
+ HREF="node11.html#SECTION000112000000000000000">9.2 Context at the probe point</A>
<UL>
<LI><A NAME="tex2html137"
HREF="node11.html#SECTION000112100000000000000">9.2.1 backtrace</A>
HREF="node11.html#SECTION0001122100000000000000">9.2.21 stp_pid</A>
<LI><A NAME="tex2html158"
HREF="node11.html#SECTION0001122200000000000000">9.2.22 target</A>
+</UL>
<LI><A NAME="tex2html159"
- HREF="node11.html#SECTION0001122300000000000000">9.2.23 task_cpu</A>
+ HREF="node11.html#SECTION000113000000000000000">9.3 Task data</A>
+<UL>
<LI><A NAME="tex2html160"
- HREF="node11.html#SECTION0001122400000000000000">9.2.24 task_current</A>
+ HREF="node11.html#SECTION000113100000000000000">9.3.1 task_cpu</A>
<LI><A NAME="tex2html161"
- HREF="node11.html#SECTION0001122500000000000000">9.2.25 task_egid</A>
+ HREF="node11.html#SECTION000113200000000000000">9.3.2 task_current</A>
<LI><A NAME="tex2html162"
- HREF="node11.html#SECTION0001122600000000000000">9.2.26 task_execname</A>
+ HREF="node11.html#SECTION000113300000000000000">9.3.3 task_egid</A>
<LI><A NAME="tex2html163"
- HREF="node11.html#SECTION0001122700000000000000">9.2.27 task_euid</A>
+ HREF="node11.html#SECTION000113400000000000000">9.3.4 task_execname</A>
<LI><A NAME="tex2html164"
- HREF="node11.html#SECTION0001122800000000000000">9.2.28 task_gid</A>
+ HREF="node11.html#SECTION000113500000000000000">9.3.5 task_euid</A>
<LI><A NAME="tex2html165"
- HREF="node11.html#SECTION0001122900000000000000">9.2.29 task_nice</A>
+ HREF="node11.html#SECTION000113600000000000000">9.3.6 task_gid</A>
<LI><A NAME="tex2html166"
- HREF="node11.html#SECTION0001123000000000000000">9.2.30 task_parent</A>
+ HREF="node11.html#SECTION000113700000000000000">9.3.7 task_nice</A>
<LI><A NAME="tex2html167"
- HREF="node11.html#SECTION0001123100000000000000">9.2.31 task_pid</A>
+ HREF="node11.html#SECTION000113800000000000000">9.3.8 task_parent</A>
<LI><A NAME="tex2html168"
- HREF="node11.html#SECTION0001123200000000000000">9.2.32 task_prio</A>
+ HREF="node11.html#SECTION000113900000000000000">9.3.9 task_pid</A>
<LI><A NAME="tex2html169"
- HREF="node11.html#SECTION0001123300000000000000">9.2.33 task_state</A>
+ HREF="node11.html#SECTION0001131000000000000000">9.3.10 task_prio</A>
<LI><A NAME="tex2html170"
- HREF="node11.html#SECTION0001123400000000000000">9.2.34 task_tid</A>
+ HREF="node11.html#SECTION0001131100000000000000">9.3.11 task_state</A>
<LI><A NAME="tex2html171"
- HREF="node11.html#SECTION0001123500000000000000">9.2.35 task_uid</A>
+ HREF="node11.html#SECTION0001131200000000000000">9.3.12 task_tid</A>
<LI><A NAME="tex2html172"
- HREF="node11.html#SECTION0001123600000000000000">9.2.36 task_open_file_handles</A>
+ HREF="node11.html#SECTION0001131300000000000000">9.3.13 task_uid</A>
<LI><A NAME="tex2html173"
- HREF="node11.html#SECTION0001123700000000000000">9.2.37 task_max_file_handles</A>
-</UL>
+ HREF="node11.html#SECTION0001131400000000000000">9.3.14 task_open_file_handles</A>
<LI><A NAME="tex2html174"
- HREF="node11.html#SECTION000113000000000000000">9.3 Accessing string data at a probe point</A>
-<UL>
+ HREF="node11.html#SECTION0001131500000000000000">9.3.15 task_max_file_handles</A>
+</UL>
<LI><A NAME="tex2html175"
- HREF="node11.html#SECTION000113100000000000000">9.3.1 kernel_string</A>
+ HREF="node11.html#SECTION000114000000000000000">9.4 Accessing string data at a probe point</A>
+<UL>
<LI><A NAME="tex2html176"
- HREF="node11.html#SECTION000113200000000000000">9.3.2 user_string</A>
+ HREF="node11.html#SECTION000114100000000000000">9.4.1 kernel_string</A>
<LI><A NAME="tex2html177"
- HREF="node11.html#SECTION000113300000000000000">9.3.3 user_string2</A>
+ HREF="node11.html#SECTION000114200000000000000">9.4.2 user_string</A>
<LI><A NAME="tex2html178"
- HREF="node11.html#SECTION000113400000000000000">9.3.4 user_string_warn</A>
+ HREF="node11.html#SECTION000114300000000000000">9.4.3 user_string2</A>
<LI><A NAME="tex2html179"
- HREF="node11.html#SECTION000113500000000000000">9.3.5 user_string_quoted</A>
-</UL>
+ HREF="node11.html#SECTION000114400000000000000">9.4.4 user_string_warn</A>
<LI><A NAME="tex2html180"
- HREF="node11.html#SECTION000114000000000000000">9.4 Initializing queue statistics</A>
-<UL>
+ HREF="node11.html#SECTION000114500000000000000">9.4.5 user_string_quoted</A>
+</UL>
<LI><A NAME="tex2html181"
- HREF="node11.html#SECTION000114100000000000000">9.4.1 qs_wait</A>
+ HREF="node11.html#SECTION000115000000000000000">9.5 Initializing queue statistics</A>
+<UL>
<LI><A NAME="tex2html182"
- HREF="node11.html#SECTION000114200000000000000">9.4.2 qs_run</A>
+ HREF="node11.html#SECTION000115100000000000000">9.5.1 qs_wait</A>
<LI><A NAME="tex2html183"
- HREF="node11.html#SECTION000114300000000000000">9.4.3 qs_done</A>
-</UL>
+ HREF="node11.html#SECTION000115200000000000000">9.5.2 qs_run</A>
<LI><A NAME="tex2html184"
- HREF="node11.html#SECTION000115000000000000000">9.5 Using queue statistics</A>
-<UL>
+ HREF="node11.html#SECTION000115300000000000000">9.5.3 qs_done</A>
+</UL>
<LI><A NAME="tex2html185"
- HREF="node11.html#SECTION000115100000000000000">9.5.1 qsq_blocked</A>
+ HREF="node11.html#SECTION000116000000000000000">9.6 Using queue statistics</A>
+<UL>
<LI><A NAME="tex2html186"
- HREF="node11.html#SECTION000115200000000000000">9.5.2 qsq_print</A>
+ HREF="node11.html#SECTION000116100000000000000">9.6.1 qsq_blocked</A>
<LI><A NAME="tex2html187"
- HREF="node11.html#SECTION000115300000000000000">9.5.3 qsq_service_time</A>
+ HREF="node11.html#SECTION000116200000000000000">9.6.2 qsq_print</A>
<LI><A NAME="tex2html188"
- HREF="node11.html#SECTION000115400000000000000">9.5.4 qsq_start</A>
+ HREF="node11.html#SECTION000116300000000000000">9.6.3 qsq_service_time</A>
<LI><A NAME="tex2html189"
- HREF="node11.html#SECTION000115500000000000000">9.5.5 qsq_throughput</A>
+ HREF="node11.html#SECTION000116400000000000000">9.6.4 qsq_start</A>
<LI><A NAME="tex2html190"
- HREF="node11.html#SECTION000115600000000000000">9.5.6 qsq_utilization</A>
+ HREF="node11.html#SECTION000116500000000000000">9.6.5 qsq_throughput</A>
<LI><A NAME="tex2html191"
- HREF="node11.html#SECTION000115700000000000000">9.5.7 qsq_wait_queue_length</A>
+ HREF="node11.html#SECTION000116600000000000000">9.6.6 qsq_utilization</A>
<LI><A NAME="tex2html192"
- HREF="node11.html#SECTION000115800000000000000">9.5.8 qsq_wait_time</A>
+ HREF="node11.html#SECTION000116700000000000000">9.6.7 qsq_wait_queue_length</A>
<LI><A NAME="tex2html193"
- HREF="node11.html#SECTION000115900000000000000">9.5.9 A queue example</A>
-</UL>
+ HREF="node11.html#SECTION000116800000000000000">9.6.8 qsq_wait_time</A>
<LI><A NAME="tex2html194"
- HREF="node11.html#SECTION000116000000000000000">9.6 Probe point identification</A>
-<UL>
+ HREF="node11.html#SECTION000116900000000000000">9.6.9 A queue example</A>
+</UL>
<LI><A NAME="tex2html195"
- HREF="node11.html#SECTION000116100000000000000">9.6.1 pp</A>
+ HREF="node11.html#SECTION000117000000000000000">9.7 Probe point identification</A>
+<UL>
<LI><A NAME="tex2html196"
- HREF="node11.html#SECTION000116200000000000000">9.6.2 probefunc</A>
+ HREF="node11.html#SECTION000117100000000000000">9.7.1 pp</A>
<LI><A NAME="tex2html197"
- HREF="node11.html#SECTION000116300000000000000">9.6.3 probemod</A>
-</UL>
+ HREF="node11.html#SECTION000117200000000000000">9.7.2 probefunc</A>
<LI><A NAME="tex2html198"
- HREF="node11.html#SECTION000117000000000000000">9.7 Formatting functions</A>
-<UL>
+ HREF="node11.html#SECTION000117300000000000000">9.7.3 probemod</A>
+</UL>
<LI><A NAME="tex2html199"
- HREF="node11.html#SECTION000117100000000000000">9.7.1 ctime</A>
+ HREF="node11.html#SECTION000118000000000000000">9.8 Formatting functions</A>
+<UL>
<LI><A NAME="tex2html200"
- HREF="node11.html#SECTION000117200000000000000">9.7.2 errno_str</A>
+ HREF="node11.html#SECTION000118100000000000000">9.8.1 ctime</A>
<LI><A NAME="tex2html201"
- HREF="node11.html#SECTION000117300000000000000">9.7.3 returnstr</A>
+ HREF="node11.html#SECTION000118200000000000000">9.8.2 errno_str</A>
<LI><A NAME="tex2html202"
- HREF="node11.html#SECTION000117400000000000000">9.7.4 thread_indent</A>
+ HREF="node11.html#SECTION000118300000000000000">9.8.3 returnstr</A>
<LI><A NAME="tex2html203"
- HREF="node11.html#SECTION000117500000000000000">9.7.5 thread_timestamp</A>
-</UL>
+ HREF="node11.html#SECTION000118400000000000000">9.8.4 thread_indent</A>
<LI><A NAME="tex2html204"
- HREF="node11.html#SECTION000118000000000000000">9.8 String functions</A>
-<UL>
+ HREF="node11.html#SECTION000118500000000000000">9.8.5 thread_timestamp</A>
+</UL>
<LI><A NAME="tex2html205"
- HREF="node11.html#SECTION000118100000000000000">9.8.1 isinstr</A>
+ HREF="node11.html#SECTION000119000000000000000">9.9 String functions</A>
+<UL>
<LI><A NAME="tex2html206"
- HREF="node11.html#SECTION000118200000000000000">9.8.2 strlen</A>
+ HREF="node11.html#SECTION000119100000000000000">9.9.1 isinstr</A>
<LI><A NAME="tex2html207"
- HREF="node11.html#SECTION000118300000000000000">9.8.3 strtol</A>
+ HREF="node11.html#SECTION000119200000000000000">9.9.2 strlen</A>
<LI><A NAME="tex2html208"
- HREF="node11.html#SECTION000118400000000000000">9.8.4 substr</A>
+ HREF="node11.html#SECTION000119300000000000000">9.9.3 strtol</A>
<LI><A NAME="tex2html209"
- HREF="node11.html#SECTION000118500000000000000">9.8.5 text_str</A>
+ HREF="node11.html#SECTION000119400000000000000">9.9.4 substr</A>
<LI><A NAME="tex2html210"
- HREF="node11.html#SECTION000118600000000000000">9.8.6 text_strn</A>
+ HREF="node11.html#SECTION000119500000000000000">9.9.5 text_str</A>
<LI><A NAME="tex2html211"
- HREF="node11.html#SECTION000118700000000000000">9.8.7 tokenize</A>
-</UL>
+ HREF="node11.html#SECTION000119600000000000000">9.9.6 text_strn</A>
<LI><A NAME="tex2html212"
- HREF="node11.html#SECTION000119000000000000000">9.9 Timestamps</A>
-<UL>
+ HREF="node11.html#SECTION000119700000000000000">9.9.7 tokenize</A>
+</UL>
<LI><A NAME="tex2html213"
- HREF="node11.html#SECTION000119100000000000000">9.9.1 get_cycles</A>
+ HREF="node11.html#SECTION0001110000000000000000">9.10 Timestamps</A>
+<UL>
<LI><A NAME="tex2html214"
- HREF="node11.html#SECTION000119200000000000000">9.9.2 gettimeofday_ms</A>
+ HREF="node11.html#SECTION0001110100000000000000">9.10.1 get_cycles</A>
<LI><A NAME="tex2html215"
- HREF="node11.html#SECTION000119300000000000000">9.9.3 gettimeofday_ns</A>
+ HREF="node11.html#SECTION0001110200000000000000">9.10.2 gettimeofday_ms</A>
<LI><A NAME="tex2html216"
- HREF="node11.html#SECTION000119400000000000000">9.9.4 gettimeofday_s</A>
+ HREF="node11.html#SECTION0001110300000000000000">9.10.3 gettimeofday_ns</A>
<LI><A NAME="tex2html217"
- HREF="node11.html#SECTION000119500000000000000">9.9.5 gettimeofday_us</A>
-</UL>
+ HREF="node11.html#SECTION0001110400000000000000">9.10.4 gettimeofday_s</A>
<LI><A NAME="tex2html218"
- HREF="node11.html#SECTION0001110000000000000000">9.10 Miscellaneous tapset functions</A>
-<UL>
+ HREF="node11.html#SECTION0001110500000000000000">9.10.5 gettimeofday_us</A>
+</UL>
<LI><A NAME="tex2html219"
- HREF="node11.html#SECTION0001110100000000000000">9.10.1 addr_to_node</A>
+ HREF="node11.html#SECTION0001111000000000000000">9.11 Miscellaneous tapset functions</A>
+<UL>
<LI><A NAME="tex2html220"
- HREF="node11.html#SECTION0001110200000000000000">9.10.2 exit</A>
+ HREF="node11.html#SECTION0001111100000000000000">9.11.1 addr_to_node</A>
<LI><A NAME="tex2html221"
- HREF="node11.html#SECTION0001110300000000000000">9.10.3 system</A>
+ HREF="node11.html#SECTION0001111200000000000000">9.11.2 exit</A>
+<LI><A NAME="tex2html222"
+ HREF="node11.html#SECTION0001111300000000000000">9.11.3 system</A>
</UL>
</UL>
<BR>
-<LI><A NAME="tex2html222"
- HREF="node12.html">10 For Further Reference</A>
<LI><A NAME="tex2html223"
- HREF="node13.html">Index</A>
+ HREF="node12.html">10 For Further Reference</A>
<LI><A NAME="tex2html224"
+ HREF="node13.html">Index</A>
+<LI><A NAME="tex2html225"
HREF="node14.html">About this document ...</A>
</UL>
<!--End of Table of Child-Links-->
$noresave{$key} = "$nosave";
$key = q/sub:user_string/;
-$external_latex_labels{$key} = q|9.3.2|;
+$external_latex_labels{$key} = q|9.4.2|;
$noresave{$key} = "$nosave";
$key = q/sub:Optional-probe-points/;
HREF="node11.html#SECTION0001111100000000000000">9.1.11 warn</A>
</UL>
<LI><A NAME="tex2html136"
- HREF="node11.html#SECTION000112000000000000000">9.2 Task context at the probe point</A>
+ HREF="node11.html#SECTION000112000000000000000">9.2 Context at the probe point</A>
<UL>
<LI><A NAME="tex2html137"
HREF="node11.html#SECTION000112100000000000000">9.2.1 backtrace</A>
HREF="node11.html#SECTION0001122100000000000000">9.2.21 stp_pid</A>
<LI><A NAME="tex2html158"
HREF="node11.html#SECTION0001122200000000000000">9.2.22 target</A>
+</UL>
<LI><A NAME="tex2html159"
- HREF="node11.html#SECTION0001122300000000000000">9.2.23 task_cpu</A>
+ HREF="node11.html#SECTION000113000000000000000">9.3 Task data</A>
+<UL>
<LI><A NAME="tex2html160"
- HREF="node11.html#SECTION0001122400000000000000">9.2.24 task_current</A>
+ HREF="node11.html#SECTION000113100000000000000">9.3.1 task_cpu</A>
<LI><A NAME="tex2html161"
- HREF="node11.html#SECTION0001122500000000000000">9.2.25 task_egid</A>
+ HREF="node11.html#SECTION000113200000000000000">9.3.2 task_current</A>
<LI><A NAME="tex2html162"
- HREF="node11.html#SECTION0001122600000000000000">9.2.26 task_execname</A>
+ HREF="node11.html#SECTION000113300000000000000">9.3.3 task_egid</A>
<LI><A NAME="tex2html163"
- HREF="node11.html#SECTION0001122700000000000000">9.2.27 task_euid</A>
+ HREF="node11.html#SECTION000113400000000000000">9.3.4 task_execname</A>
<LI><A NAME="tex2html164"
- HREF="node11.html#SECTION0001122800000000000000">9.2.28 task_gid</A>
+ HREF="node11.html#SECTION000113500000000000000">9.3.5 task_euid</A>
<LI><A NAME="tex2html165"
- HREF="node11.html#SECTION0001122900000000000000">9.2.29 task_nice</A>
+ HREF="node11.html#SECTION000113600000000000000">9.3.6 task_gid</A>
<LI><A NAME="tex2html166"
- HREF="node11.html#SECTION0001123000000000000000">9.2.30 task_parent</A>
+ HREF="node11.html#SECTION000113700000000000000">9.3.7 task_nice</A>
<LI><A NAME="tex2html167"
- HREF="node11.html#SECTION0001123100000000000000">9.2.31 task_pid</A>
+ HREF="node11.html#SECTION000113800000000000000">9.3.8 task_parent</A>
<LI><A NAME="tex2html168"
- HREF="node11.html#SECTION0001123200000000000000">9.2.32 task_prio</A>
+ HREF="node11.html#SECTION000113900000000000000">9.3.9 task_pid</A>
<LI><A NAME="tex2html169"
- HREF="node11.html#SECTION0001123300000000000000">9.2.33 task_state</A>
+ HREF="node11.html#SECTION0001131000000000000000">9.3.10 task_prio</A>
<LI><A NAME="tex2html170"
- HREF="node11.html#SECTION0001123400000000000000">9.2.34 task_tid</A>
+ HREF="node11.html#SECTION0001131100000000000000">9.3.11 task_state</A>
<LI><A NAME="tex2html171"
- HREF="node11.html#SECTION0001123500000000000000">9.2.35 task_uid</A>
+ HREF="node11.html#SECTION0001131200000000000000">9.3.12 task_tid</A>
<LI><A NAME="tex2html172"
- HREF="node11.html#SECTION0001123600000000000000">9.2.36 task_open_file_handles</A>
+ HREF="node11.html#SECTION0001131300000000000000">9.3.13 task_uid</A>
<LI><A NAME="tex2html173"
- HREF="node11.html#SECTION0001123700000000000000">9.2.37 task_max_file_handles</A>
-</UL>
+ HREF="node11.html#SECTION0001131400000000000000">9.3.14 task_open_file_handles</A>
<LI><A NAME="tex2html174"
- HREF="node11.html#SECTION000113000000000000000">9.3 Accessing string data at a probe point</A>
-<UL>
+ HREF="node11.html#SECTION0001131500000000000000">9.3.15 task_max_file_handles</A>
+</UL>
<LI><A NAME="tex2html175"
- HREF="node11.html#SECTION000113100000000000000">9.3.1 kernel_string</A>
+ HREF="node11.html#SECTION000114000000000000000">9.4 Accessing string data at a probe point</A>
+<UL>
<LI><A NAME="tex2html176"
- HREF="node11.html#SECTION000113200000000000000">9.3.2 user_string</A>
+ HREF="node11.html#SECTION000114100000000000000">9.4.1 kernel_string</A>
<LI><A NAME="tex2html177"
- HREF="node11.html#SECTION000113300000000000000">9.3.3 user_string2</A>
+ HREF="node11.html#SECTION000114200000000000000">9.4.2 user_string</A>
<LI><A NAME="tex2html178"
- HREF="node11.html#SECTION000113400000000000000">9.3.4 user_string_warn</A>
+ HREF="node11.html#SECTION000114300000000000000">9.4.3 user_string2</A>
<LI><A NAME="tex2html179"
- HREF="node11.html#SECTION000113500000000000000">9.3.5 user_string_quoted</A>
-</UL>
+ HREF="node11.html#SECTION000114400000000000000">9.4.4 user_string_warn</A>
<LI><A NAME="tex2html180"
- HREF="node11.html#SECTION000114000000000000000">9.4 Initializing queue statistics</A>
-<UL>
+ HREF="node11.html#SECTION000114500000000000000">9.4.5 user_string_quoted</A>
+</UL>
<LI><A NAME="tex2html181"
- HREF="node11.html#SECTION000114100000000000000">9.4.1 qs_wait</A>
+ HREF="node11.html#SECTION000115000000000000000">9.5 Initializing queue statistics</A>
+<UL>
<LI><A NAME="tex2html182"
- HREF="node11.html#SECTION000114200000000000000">9.4.2 qs_run</A>
+ HREF="node11.html#SECTION000115100000000000000">9.5.1 qs_wait</A>
<LI><A NAME="tex2html183"
- HREF="node11.html#SECTION000114300000000000000">9.4.3 qs_done</A>
-</UL>
+ HREF="node11.html#SECTION000115200000000000000">9.5.2 qs_run</A>
<LI><A NAME="tex2html184"
- HREF="node11.html#SECTION000115000000000000000">9.5 Using queue statistics</A>
-<UL>
+ HREF="node11.html#SECTION000115300000000000000">9.5.3 qs_done</A>
+</UL>
<LI><A NAME="tex2html185"
- HREF="node11.html#SECTION000115100000000000000">9.5.1 qsq_blocked</A>
+ HREF="node11.html#SECTION000116000000000000000">9.6 Using queue statistics</A>
+<UL>
<LI><A NAME="tex2html186"
- HREF="node11.html#SECTION000115200000000000000">9.5.2 qsq_print</A>
+ HREF="node11.html#SECTION000116100000000000000">9.6.1 qsq_blocked</A>
<LI><A NAME="tex2html187"
- HREF="node11.html#SECTION000115300000000000000">9.5.3 qsq_service_time</A>
+ HREF="node11.html#SECTION000116200000000000000">9.6.2 qsq_print</A>
<LI><A NAME="tex2html188"
- HREF="node11.html#SECTION000115400000000000000">9.5.4 qsq_start</A>
+ HREF="node11.html#SECTION000116300000000000000">9.6.3 qsq_service_time</A>
<LI><A NAME="tex2html189"
- HREF="node11.html#SECTION000115500000000000000">9.5.5 qsq_throughput</A>
+ HREF="node11.html#SECTION000116400000000000000">9.6.4 qsq_start</A>
<LI><A NAME="tex2html190"
- HREF="node11.html#SECTION000115600000000000000">9.5.6 qsq_utilization</A>
+ HREF="node11.html#SECTION000116500000000000000">9.6.5 qsq_throughput</A>
<LI><A NAME="tex2html191"
- HREF="node11.html#SECTION000115700000000000000">9.5.7 qsq_wait_queue_length</A>
+ HREF="node11.html#SECTION000116600000000000000">9.6.6 qsq_utilization</A>
<LI><A NAME="tex2html192"
- HREF="node11.html#SECTION000115800000000000000">9.5.8 qsq_wait_time</A>
+ HREF="node11.html#SECTION000116700000000000000">9.6.7 qsq_wait_queue_length</A>
<LI><A NAME="tex2html193"
- HREF="node11.html#SECTION000115900000000000000">9.5.9 A queue example</A>
-</UL>
+ HREF="node11.html#SECTION000116800000000000000">9.6.8 qsq_wait_time</A>
<LI><A NAME="tex2html194"
- HREF="node11.html#SECTION000116000000000000000">9.6 Probe point identification</A>
-<UL>
+ HREF="node11.html#SECTION000116900000000000000">9.6.9 A queue example</A>
+</UL>
<LI><A NAME="tex2html195"
- HREF="node11.html#SECTION000116100000000000000">9.6.1 pp</A>
+ HREF="node11.html#SECTION000117000000000000000">9.7 Probe point identification</A>
+<UL>
<LI><A NAME="tex2html196"
- HREF="node11.html#SECTION000116200000000000000">9.6.2 probefunc</A>
+ HREF="node11.html#SECTION000117100000000000000">9.7.1 pp</A>
<LI><A NAME="tex2html197"
- HREF="node11.html#SECTION000116300000000000000">9.6.3 probemod</A>
-</UL>
+ HREF="node11.html#SECTION000117200000000000000">9.7.2 probefunc</A>
<LI><A NAME="tex2html198"
- HREF="node11.html#SECTION000117000000000000000">9.7 Formatting functions</A>
-<UL>
+ HREF="node11.html#SECTION000117300000000000000">9.7.3 probemod</A>
+</UL>
<LI><A NAME="tex2html199"
- HREF="node11.html#SECTION000117100000000000000">9.7.1 ctime</A>
+ HREF="node11.html#SECTION000118000000000000000">9.8 Formatting functions</A>
+<UL>
<LI><A NAME="tex2html200"
- HREF="node11.html#SECTION000117200000000000000">9.7.2 errno_str</A>
+ HREF="node11.html#SECTION000118100000000000000">9.8.1 ctime</A>
<LI><A NAME="tex2html201"
- HREF="node11.html#SECTION000117300000000000000">9.7.3 returnstr</A>
+ HREF="node11.html#SECTION000118200000000000000">9.8.2 errno_str</A>
<LI><A NAME="tex2html202"
- HREF="node11.html#SECTION000117400000000000000">9.7.4 thread_indent</A>
+ HREF="node11.html#SECTION000118300000000000000">9.8.3 returnstr</A>
<LI><A NAME="tex2html203"
- HREF="node11.html#SECTION000117500000000000000">9.7.5 thread_timestamp</A>
-</UL>
+ HREF="node11.html#SECTION000118400000000000000">9.8.4 thread_indent</A>
<LI><A NAME="tex2html204"
- HREF="node11.html#SECTION000118000000000000000">9.8 String functions</A>
-<UL>
+ HREF="node11.html#SECTION000118500000000000000">9.8.5 thread_timestamp</A>
+</UL>
<LI><A NAME="tex2html205"
- HREF="node11.html#SECTION000118100000000000000">9.8.1 isinstr</A>
+ HREF="node11.html#SECTION000119000000000000000">9.9 String functions</A>
+<UL>
<LI><A NAME="tex2html206"
- HREF="node11.html#SECTION000118200000000000000">9.8.2 strlen</A>
+ HREF="node11.html#SECTION000119100000000000000">9.9.1 isinstr</A>
<LI><A NAME="tex2html207"
- HREF="node11.html#SECTION000118300000000000000">9.8.3 strtol</A>
+ HREF="node11.html#SECTION000119200000000000000">9.9.2 strlen</A>
<LI><A NAME="tex2html208"
- HREF="node11.html#SECTION000118400000000000000">9.8.4 substr</A>
+ HREF="node11.html#SECTION000119300000000000000">9.9.3 strtol</A>
<LI><A NAME="tex2html209"
- HREF="node11.html#SECTION000118500000000000000">9.8.5 text_str</A>
+ HREF="node11.html#SECTION000119400000000000000">9.9.4 substr</A>
<LI><A NAME="tex2html210"
- HREF="node11.html#SECTION000118600000000000000">9.8.6 text_strn</A>
+ HREF="node11.html#SECTION000119500000000000000">9.9.5 text_str</A>
<LI><A NAME="tex2html211"
- HREF="node11.html#SECTION000118700000000000000">9.8.7 tokenize</A>
-</UL>
+ HREF="node11.html#SECTION000119600000000000000">9.9.6 text_strn</A>
<LI><A NAME="tex2html212"
- HREF="node11.html#SECTION000119000000000000000">9.9 Timestamps</A>
-<UL>
+ HREF="node11.html#SECTION000119700000000000000">9.9.7 tokenize</A>
+</UL>
<LI><A NAME="tex2html213"
- HREF="node11.html#SECTION000119100000000000000">9.9.1 get_cycles</A>
+ HREF="node11.html#SECTION0001110000000000000000">9.10 Timestamps</A>
+<UL>
<LI><A NAME="tex2html214"
- HREF="node11.html#SECTION000119200000000000000">9.9.2 gettimeofday_ms</A>
+ HREF="node11.html#SECTION0001110100000000000000">9.10.1 get_cycles</A>
<LI><A NAME="tex2html215"
- HREF="node11.html#SECTION000119300000000000000">9.9.3 gettimeofday_ns</A>
+ HREF="node11.html#SECTION0001110200000000000000">9.10.2 gettimeofday_ms</A>
<LI><A NAME="tex2html216"
- HREF="node11.html#SECTION000119400000000000000">9.9.4 gettimeofday_s</A>
+ HREF="node11.html#SECTION0001110300000000000000">9.10.3 gettimeofday_ns</A>
<LI><A NAME="tex2html217"
- HREF="node11.html#SECTION000119500000000000000">9.9.5 gettimeofday_us</A>
-</UL>
+ HREF="node11.html#SECTION0001110400000000000000">9.10.4 gettimeofday_s</A>
<LI><A NAME="tex2html218"
- HREF="node11.html#SECTION0001110000000000000000">9.10 Miscellaneous tapset functions</A>
-<UL>
+ HREF="node11.html#SECTION0001110500000000000000">9.10.5 gettimeofday_us</A>
+</UL>
<LI><A NAME="tex2html219"
- HREF="node11.html#SECTION0001110100000000000000">9.10.1 addr_to_node</A>
+ HREF="node11.html#SECTION0001111000000000000000">9.11 Miscellaneous tapset functions</A>
+<UL>
<LI><A NAME="tex2html220"
- HREF="node11.html#SECTION0001110200000000000000">9.10.2 exit</A>
+ HREF="node11.html#SECTION0001111100000000000000">9.11.1 addr_to_node</A>
<LI><A NAME="tex2html221"
- HREF="node11.html#SECTION0001110300000000000000">9.10.3 system</A>
+ HREF="node11.html#SECTION0001111200000000000000">9.11.2 exit</A>
+<LI><A NAME="tex2html222"
+ HREF="node11.html#SECTION0001111300000000000000">9.11.3 system</A>
</UL>
</UL>
<BR>
-<LI><A NAME="tex2html222"
- HREF="node12.html">10 For Further Reference</A>
<LI><A NAME="tex2html223"
- HREF="node13.html">Index</A>
+ HREF="node12.html">10 For Further Reference</A>
<LI><A NAME="tex2html224"
+ HREF="node13.html">Index</A>
+<LI><A NAME="tex2html225"
HREF="node14.html">About this document ...</A>
</UL>
<!--End of Table of Child-Links-->
<BODY >
<!--Navigation Panel-->
-<A NAME="tex2html235"
+<A NAME="tex2html236"
HREF="node2.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
-<A NAME="tex2html231"
+<A NAME="tex2html232"
HREF="langref.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
-<A NAME="tex2html225"
+<A NAME="tex2html226"
HREF="langref.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
-<A NAME="tex2html233"
+<A NAME="tex2html234"
HREF="node13.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A>
<BR>
-<B> Next:</B> <A NAME="tex2html236"
+<B> Next:</B> <A NAME="tex2html237"
HREF="node2.html">List of Tables</A>
-<B> Up:</B> <A NAME="tex2html232"
+<B> Up:</B> <A NAME="tex2html233"
HREF="langref.html">SystemTap Language Reference</A>
-<B> Previous:</B> <A NAME="tex2html226"
+<B> Previous:</B> <A NAME="tex2html227"
HREF="langref.html">SystemTap Language Reference</A>
- <B> <A NAME="tex2html234"
+ <B> <A NAME="tex2html235"
HREF="node13.html">Index</A></B>
<BR>
<BR>
<!--Table of Contents-->
<UL>
-<LI><A NAME="tex2html237"
- HREF="node2.html">List of Tables</A>
<LI><A NAME="tex2html238"
+ HREF="node2.html">List of Tables</A>
+<LI><A NAME="tex2html239"
HREF="node3.html">1 SystemTap overview</A>
<UL>
-<LI><A NAME="tex2html239"
- HREF="node3.html#SECTION00031000000000000000">1.1 About this guide</A>
<LI><A NAME="tex2html240"
- HREF="node3.html#SECTION00032000000000000000">1.2 Reasons to use SystemTap</A>
+ HREF="node3.html#SECTION00031000000000000000">1.1 About this guide</A>
<LI><A NAME="tex2html241"
- HREF="node3.html#SECTION00033000000000000000">1.3 Event-action language</A>
+ HREF="node3.html#SECTION00032000000000000000">1.2 Reasons to use SystemTap</A>
<LI><A NAME="tex2html242"
- HREF="node3.html#SECTION00034000000000000000">1.4 Sample SystemTap scripts</A>
+ HREF="node3.html#SECTION00033000000000000000">1.3 Event-action language</A>
<LI><A NAME="tex2html243"
- HREF="node3.html#SECTION00035000000000000000">1.5 The stap command</A>
+ HREF="node3.html#SECTION00034000000000000000">1.4 Sample SystemTap scripts</A>
<LI><A NAME="tex2html244"
+ HREF="node3.html#SECTION00035000000000000000">1.5 The stap command</A>
+<LI><A NAME="tex2html245"
HREF="node3.html#SECTION00036000000000000000">1.6 Safety and security</A>
</UL>
<BR>
-<LI><A NAME="tex2html245"
+<LI><A NAME="tex2html246"
HREF="node4.html">2 Types of SystemTap scripts</A>
<UL>
-<LI><A NAME="tex2html246"
- HREF="node4.html#SECTION00041000000000000000">2.1 Probe scripts</A>
<LI><A NAME="tex2html247"
+ HREF="node4.html#SECTION00041000000000000000">2.1 Probe scripts</A>
+<LI><A NAME="tex2html248"
HREF="node4.html#SECTION00042000000000000000">2.2 Tapset scripts</A>
</UL>
<BR>
-<LI><A NAME="tex2html248"
+<LI><A NAME="tex2html249"
HREF="node5.html">3 Components of a SystemTap script</A>
<UL>
-<LI><A NAME="tex2html249"
- HREF="node5.html#SECTION00051000000000000000">3.1 Probe definitions</A>
<LI><A NAME="tex2html250"
- HREF="node5.html#SECTION00052000000000000000">3.2 Probe aliases</A>
+ HREF="node5.html#SECTION00051000000000000000">3.1 Probe definitions</A>
<LI><A NAME="tex2html251"
- HREF="node5.html#SECTION00053000000000000000">3.3 Variables</A>
+ HREF="node5.html#SECTION00052000000000000000">3.2 Probe aliases</A>
<LI><A NAME="tex2html252"
- HREF="node5.html#SECTION00054000000000000000">3.4 Auxiliary functions</A>
+ HREF="node5.html#SECTION00053000000000000000">3.3 Variables</A>
<LI><A NAME="tex2html253"
- HREF="node5.html#SECTION00055000000000000000">3.5 Embedded C</A>
+ HREF="node5.html#SECTION00054000000000000000">3.4 Auxiliary functions</A>
<LI><A NAME="tex2html254"
+ HREF="node5.html#SECTION00055000000000000000">3.5 Embedded C</A>
+<LI><A NAME="tex2html255"
HREF="node5.html#SECTION00056000000000000000">3.6 Embedded C functions</A>
</UL>
<BR>
-<LI><A NAME="tex2html255"
+<LI><A NAME="tex2html256"
HREF="node6.html">4 Probe points</A>
<UL>
-<LI><A NAME="tex2html256"
- HREF="node6.html#SECTION00061000000000000000">4.1 General syntax</A>
<LI><A NAME="tex2html257"
- HREF="node6.html#SECTION00062000000000000000">4.2 Built-in probe point types (DWARF probes)</A>
+ HREF="node6.html#SECTION00061000000000000000">4.1 General syntax</A>
<LI><A NAME="tex2html258"
- HREF="node6.html#SECTION00063000000000000000">4.3 Timer probes</A>
+ HREF="node6.html#SECTION00062000000000000000">4.2 Built-in probe point types (DWARF probes)</A>
<LI><A NAME="tex2html259"
- HREF="node6.html#SECTION00064000000000000000">4.4 Return probes</A>
+ HREF="node6.html#SECTION00063000000000000000">4.3 Timer probes</A>
<LI><A NAME="tex2html260"
+ HREF="node6.html#SECTION00064000000000000000">4.4 Return probes</A>
+<LI><A NAME="tex2html261"
HREF="node6.html#SECTION00065000000000000000">4.5 Special probe points</A>
</UL>
<BR>
-<LI><A NAME="tex2html261"
+<LI><A NAME="tex2html262"
HREF="node7.html">5 Language elements</A>
<UL>
-<LI><A NAME="tex2html262"
- HREF="node7.html#SECTION00071000000000000000">5.1 Identifiers</A>
<LI><A NAME="tex2html263"
- HREF="node7.html#SECTION00072000000000000000">5.2 Data types</A>
+ HREF="node7.html#SECTION00071000000000000000">5.1 Identifiers</A>
<LI><A NAME="tex2html264"
- HREF="node7.html#SECTION00073000000000000000">5.3 Semicolons</A>
+ HREF="node7.html#SECTION00072000000000000000">5.2 Data types</A>
<LI><A NAME="tex2html265"
- HREF="node7.html#SECTION00074000000000000000">5.4 Comments</A>
+ HREF="node7.html#SECTION00073000000000000000">5.3 Semicolons</A>
<LI><A NAME="tex2html266"
- HREF="node7.html#SECTION00075000000000000000">5.5 Whitespace</A>
+ HREF="node7.html#SECTION00074000000000000000">5.4 Comments</A>
<LI><A NAME="tex2html267"
- HREF="node7.html#SECTION00076000000000000000">5.6 Expressions</A>
+ HREF="node7.html#SECTION00075000000000000000">5.5 Whitespace</A>
<LI><A NAME="tex2html268"
- HREF="node7.html#SECTION00077000000000000000">5.7 Literals passed in from the stap command line</A>
+ HREF="node7.html#SECTION00076000000000000000">5.6 Expressions</A>
<LI><A NAME="tex2html269"
+ HREF="node7.html#SECTION00077000000000000000">5.7 Literals passed in from the stap command line</A>
+<LI><A NAME="tex2html270"
HREF="node7.html#SECTION00078000000000000000">5.8 Conditional compilation</A>
</UL>
<BR>
-<LI><A NAME="tex2html270"
+<LI><A NAME="tex2html271"
HREF="node8.html">6 Statement types</A>
<UL>
-<LI><A NAME="tex2html271"
- HREF="node8.html#SECTION00081000000000000000">6.1 break and continue</A>
<LI><A NAME="tex2html272"
- HREF="node8.html#SECTION00082000000000000000">6.2 delete</A>
+ HREF="node8.html#SECTION00081000000000000000">6.1 break and continue</A>
<LI><A NAME="tex2html273"
- HREF="node8.html#SECTION00083000000000000000">6.3 do</A>
+ HREF="node8.html#SECTION00082000000000000000">6.2 delete</A>
<LI><A NAME="tex2html274"
- HREF="node8.html#SECTION00084000000000000000">6.4 EXP (expression)</A>
+ HREF="node8.html#SECTION00083000000000000000">6.3 do</A>
<LI><A NAME="tex2html275"
- HREF="node8.html#SECTION00085000000000000000">6.5 for</A>
+ HREF="node8.html#SECTION00084000000000000000">6.4 EXP (expression)</A>
<LI><A NAME="tex2html276"
- HREF="node8.html#SECTION00086000000000000000">6.6 foreach</A>
+ HREF="node8.html#SECTION00085000000000000000">6.5 for</A>
<LI><A NAME="tex2html277"
- HREF="node8.html#SECTION00087000000000000000">6.7 if</A>
+ HREF="node8.html#SECTION00086000000000000000">6.6 foreach</A>
<LI><A NAME="tex2html278"
- HREF="node8.html#SECTION00088000000000000000">6.8 next</A>
+ HREF="node8.html#SECTION00087000000000000000">6.7 if</A>
<LI><A NAME="tex2html279"
- HREF="node8.html#SECTION00089000000000000000">6.9 ; (null statement)</A>
+ HREF="node8.html#SECTION00088000000000000000">6.8 next</A>
<LI><A NAME="tex2html280"
- HREF="node8.html#SECTION000810000000000000000">6.10 return</A>
+ HREF="node8.html#SECTION00089000000000000000">6.9 ; (null statement)</A>
<LI><A NAME="tex2html281"
- HREF="node8.html#SECTION000811000000000000000">6.11 { } (statement block)</A>
+ HREF="node8.html#SECTION000810000000000000000">6.10 return</A>
<LI><A NAME="tex2html282"
+ HREF="node8.html#SECTION000811000000000000000">6.11 { } (statement block)</A>
+<LI><A NAME="tex2html283"
HREF="node8.html#SECTION000812000000000000000">6.12 while</A>
</UL>
<BR>
-<LI><A NAME="tex2html283"
+<LI><A NAME="tex2html284"
HREF="node9.html">7 Associative arrays</A>
<UL>
-<LI><A NAME="tex2html284"
- HREF="node9.html#SECTION00091000000000000000">7.1 Examples</A>
<LI><A NAME="tex2html285"
- HREF="node9.html#SECTION00092000000000000000">7.2 Types of values</A>
+ HREF="node9.html#SECTION00091000000000000000">7.1 Examples</A>
<LI><A NAME="tex2html286"
- HREF="node9.html#SECTION00093000000000000000">7.3 Array capacity</A>
+ HREF="node9.html#SECTION00092000000000000000">7.2 Types of values</A>
<LI><A NAME="tex2html287"
+ HREF="node9.html#SECTION00093000000000000000">7.3 Array capacity</A>
+<LI><A NAME="tex2html288"
HREF="node9.html#SECTION00094000000000000000">7.4 Iteration, foreach</A>
</UL>
<BR>
-<LI><A NAME="tex2html288"
+<LI><A NAME="tex2html289"
HREF="node10.html">8 Statistics (aggregates)</A>
<UL>
-<LI><A NAME="tex2html289"
- HREF="node10.html#SECTION000101000000000000000">8.1 The aggregation (< < <) operator</A>
<LI><A NAME="tex2html290"
- HREF="node10.html#SECTION000102000000000000000">8.2 Extraction functions</A>
+ HREF="node10.html#SECTION000101000000000000000">8.1 The aggregation (< < <) operator</A>
<LI><A NAME="tex2html291"
- HREF="node10.html#SECTION000103000000000000000">8.3 Integer extractors</A>
+ HREF="node10.html#SECTION000102000000000000000">8.2 Extraction functions</A>
<LI><A NAME="tex2html292"
+ HREF="node10.html#SECTION000103000000000000000">8.3 Integer extractors</A>
+<LI><A NAME="tex2html293"
HREF="node10.html#SECTION000104000000000000000">8.4 Histogram extractors</A>
</UL>
<BR>
-<LI><A NAME="tex2html293"
+<LI><A NAME="tex2html294"
HREF="node11.html">9 Predefined functions</A>
<UL>
-<LI><A NAME="tex2html294"
- HREF="node11.html#SECTION000111000000000000000">9.1 Output functions</A>
<LI><A NAME="tex2html295"
- HREF="node11.html#SECTION000112000000000000000">9.2 Task context at the probe point</A>
+ HREF="node11.html#SECTION000111000000000000000">9.1 Output functions</A>
<LI><A NAME="tex2html296"
- HREF="node11.html#SECTION000113000000000000000">9.3 Accessing string data at a probe point</A>
+ HREF="node11.html#SECTION000112000000000000000">9.2 Context at the probe point</A>
<LI><A NAME="tex2html297"
- HREF="node11.html#SECTION000114000000000000000">9.4 Initializing queue statistics</A>
+ HREF="node11.html#SECTION000113000000000000000">9.3 Task data</A>
<LI><A NAME="tex2html298"
- HREF="node11.html#SECTION000115000000000000000">9.5 Using queue statistics</A>
+ HREF="node11.html#SECTION000114000000000000000">9.4 Accessing string data at a probe point</A>
<LI><A NAME="tex2html299"
- HREF="node11.html#SECTION000116000000000000000">9.6 Probe point identification</A>
+ HREF="node11.html#SECTION000115000000000000000">9.5 Initializing queue statistics</A>
<LI><A NAME="tex2html300"
- HREF="node11.html#SECTION000117000000000000000">9.7 Formatting functions</A>
+ HREF="node11.html#SECTION000116000000000000000">9.6 Using queue statistics</A>
<LI><A NAME="tex2html301"
- HREF="node11.html#SECTION000118000000000000000">9.8 String functions</A>
+ HREF="node11.html#SECTION000117000000000000000">9.7 Probe point identification</A>
<LI><A NAME="tex2html302"
- HREF="node11.html#SECTION000119000000000000000">9.9 Timestamps</A>
+ HREF="node11.html#SECTION000118000000000000000">9.8 Formatting functions</A>
<LI><A NAME="tex2html303"
- HREF="node11.html#SECTION0001110000000000000000">9.10 Miscellaneous tapset functions</A>
+ HREF="node11.html#SECTION000119000000000000000">9.9 String functions</A>
+<LI><A NAME="tex2html304"
+ HREF="node11.html#SECTION0001110000000000000000">9.10 Timestamps</A>
+<LI><A NAME="tex2html305"
+ HREF="node11.html#SECTION0001111000000000000000">9.11 Miscellaneous tapset functions</A>
</UL>
<BR>
-<LI><A NAME="tex2html304"
+<LI><A NAME="tex2html306"
HREF="node12.html">10 For Further Reference</A>
-<LI><A NAME="tex2html305"
+<LI><A NAME="tex2html307"
HREF="node13.html">Index</A>
</UL>
<!--End of Table of Contents-->
<BODY >
<!--Navigation Panel-->
-<A NAME="tex2html515"
+<A NAME="tex2html517"
HREF="node11.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
-<A NAME="tex2html509"
+<A NAME="tex2html511"
HREF="langref.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
-<A NAME="tex2html503"
+<A NAME="tex2html505"
HREF="node9.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
-<A NAME="tex2html511"
+<A NAME="tex2html513"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
-<A NAME="tex2html513"
+<A NAME="tex2html515"
HREF="node13.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A>
<BR>
-<B> Next:</B> <A NAME="tex2html516"
+<B> Next:</B> <A NAME="tex2html518"
HREF="node11.html">9 Predefined functions</A>
-<B> Up:</B> <A NAME="tex2html510"
+<B> Up:</B> <A NAME="tex2html512"
HREF="langref.html">SystemTap Language Reference</A>
-<B> Previous:</B> <A NAME="tex2html504"
+<B> Previous:</B> <A NAME="tex2html506"
HREF="node9.html">7 Associative arrays</A>
- <B> <A NAME="tex2html512"
- HREF="node1.html">Contents</A></B>
<B> <A NAME="tex2html514"
+ HREF="node1.html">Contents</A></B>
+ <B> <A NAME="tex2html516"
HREF="node13.html">Index</A></B>
<BR>
<BR>
<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></A>
<UL>
-<LI><A NAME="tex2html517"
+<LI><A NAME="tex2html519"
HREF="node10.html#SECTION000101000000000000000">8.1 The aggregation (< < <) operator</A>
-<LI><A NAME="tex2html518"
+<LI><A NAME="tex2html520"
HREF="node10.html#SECTION000102000000000000000">8.2 Extraction functions</A>
-<LI><A NAME="tex2html519"
+<LI><A NAME="tex2html521"
HREF="node10.html#SECTION000103000000000000000">8.3 Integer extractors</A>
<UL>
-<LI><A NAME="tex2html520"
+<LI><A NAME="tex2html522"
HREF="node10.html#SECTION000103100000000000000">8.3.1 @count(s)</A>
-<LI><A NAME="tex2html521"
+<LI><A NAME="tex2html523"
HREF="node10.html#SECTION000103200000000000000">8.3.2 @sum(s)</A>
-<LI><A NAME="tex2html522"
+<LI><A NAME="tex2html524"
HREF="node10.html#SECTION000103300000000000000">8.3.3 @min(s)</A>
-<LI><A NAME="tex2html523"
+<LI><A NAME="tex2html525"
HREF="node10.html#SECTION000103400000000000000">8.3.4 @max(s)</A>
-<LI><A NAME="tex2html524"
+<LI><A NAME="tex2html526"
HREF="node10.html#SECTION000103500000000000000">8.3.5 @avg(s)</A>
</UL>
<BR>
-<LI><A NAME="tex2html525"
+<LI><A NAME="tex2html527"
HREF="node10.html#SECTION000104000000000000000">8.4 Histogram extractors</A>
<UL>
-<LI><A NAME="tex2html526"
+<LI><A NAME="tex2html528"
HREF="node10.html#SECTION000104100000000000000">8.4.1 @hist_linear</A>
-<LI><A NAME="tex2html527"
+<LI><A NAME="tex2html529"
HREF="node10.html#SECTION000104200000000000000">8.4.2 @hist_log</A>
</UL></UL>
<!--End of Table of Child-Links-->
<H2><A NAME="SECTION000101000000000000000">
8.1 The aggregation (< < <) operator</A>
</H2>
-<A NAME="1429"></A>
+<A NAME="1443"></A>
The aggregation operator is ``< < <'',
and its effect is similar to an assignment or a C++ output streaming operation.
The left operand specifies a scalar or array-index <I>l-value</I>, which
identifier, the translator computes a set of statistics. With each execution
of an extraction function, the aggregation is computed for that moment across
all processors. The first argument of each function is the same style of
-l-value as used on the left side of the accumulate operation.
+l-value as used on the left side of the aggregation operation.
<P>
</H2>
<P>
-The following functions give methods to extract information about integer
+The following functions provide methods to extract information about integer
values.
<P>
<BR>
8.4 Histogram extractors
</H2>
-The following functions give methods to extract histogram information.
+The following functions provide methods to extract histogram information.
<P>
8.4.1 @hist_linear
</H3>
The statement <TT>@hist_linear(v,L,H,W)</TT> represents a linear histogram
-<TT>v</TT> whose low, high, and width parameters are given by the following
-three literal numbers <I>L</I>, <I>H</I>, <I>W</I>.
+<TT>v</TT>, where <I>L</I> and <I>H</I> represent the lower and upper end of
+a range of values and <I>W</I> represents the width (or size) of each bucket
+within the range. The low and high values can be negative, but the overall
+difference (high minus low) must be positive. The width parameter must also
+be positive.
+
+<P>
+In the output, a range of consecutive empty buckets may be replaced with a tilde
+(~) character. This can be controlled on the command line
+with -DHIST_ELISION=< num> ,
+where < num> specifies how many
+empty buckets at the top and bottom of the range to print.
+The default is 2. A < num> of 0
+removes all empty buckets. A negative < num>
+turns off bucket removal all together.
+
+<P>
+For example, if you specify -DHIST_ELISION=3 and the histogram has 10
+consecutive empty buckets, the first 3 and last 3 empty buckets will
+be printed and the middle 4 empty buckets will be represented by a
+tilde (~).
<P>
The following is an example.
<DT>
<DD><PRE>
value |-------------------------------------------------- count
- 0 | 258
- 200 | 3
+ 0 |@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ 1650
+ 200 | 8
400 | 0
- 600 | 1
- 800 | 2
- 1000 | 4
- 1200 | 1
- 1400 |@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ 16685
+ 600 | 0
+ ~
+ 1000 | 0
+ 1200 | 0
+ 1400 | 1
1600 | 0
1800 | 0
</PRE>
</DD>
-</DL>
+</DL>This shows that 1650 network reads were of a size between 0 and 200 bytes,
+8 reads were between 200 and 400 bytes, and 1 read was between
+1200 and 1400 bytes. The tilde (~) character indicates
+buckets 700, 800 and 900 were removed because they were empty.
+Empty buckets at the upper end were also removed.
+
<P>
<H3><A NAME="SECTION000104200000000000000"></A>
-<A NAME="674"></A>
+<A NAME="685"></A>
<BR>
8.4.2 @hist_log
</H3>
-The statement <TT>@hist_log(v,N)</TT> represents a base-2 logarithmic histogram
-with the given number of buckets. N may be omitted, and defaults to 64.
+The statement <TT>@hist_log(v)</TT> represents a base-2 logarithmic
+histogram. Empty buckets are replaced with a tilde (~)
+character in the same way as <TT>@hist_linear()</TT> (see above).
<P>
The following is an example.
<P>
<HR>
<!--Navigation Panel-->
-<A NAME="tex2html515"
+<A NAME="tex2html517"
HREF="node11.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
-<A NAME="tex2html509"
+<A NAME="tex2html511"
HREF="langref.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
-<A NAME="tex2html503"
+<A NAME="tex2html505"
HREF="node9.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
-<A NAME="tex2html511"
+<A NAME="tex2html513"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
-<A NAME="tex2html513"
+<A NAME="tex2html515"
HREF="node13.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A>
<BR>
-<B> Next:</B> <A NAME="tex2html516"
+<B> Next:</B> <A NAME="tex2html518"
HREF="node11.html">9 Predefined functions</A>
-<B> Up:</B> <A NAME="tex2html510"
+<B> Up:</B> <A NAME="tex2html512"
HREF="langref.html">SystemTap Language Reference</A>
-<B> Previous:</B> <A NAME="tex2html504"
+<B> Previous:</B> <A NAME="tex2html506"
HREF="node9.html">7 Associative arrays</A>
- <B> <A NAME="tex2html512"
- HREF="node1.html">Contents</A></B>
<B> <A NAME="tex2html514"
+ HREF="node1.html">Contents</A></B>
+ <B> <A NAME="tex2html516"
HREF="node13.html">Index</A></B>
<!--End of Navigation Panel-->
<BODY >
<!--Navigation Panel-->
-<A NAME="tex2html540"
+<A NAME="tex2html542"
HREF="node12.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
-<A NAME="tex2html534"
+<A NAME="tex2html536"
HREF="langref.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
-<A NAME="tex2html528"
+<A NAME="tex2html530"
HREF="node10.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
-<A NAME="tex2html536"
+<A NAME="tex2html538"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
-<A NAME="tex2html538"
+<A NAME="tex2html540"
HREF="node13.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A>
<BR>
-<B> Next:</B> <A NAME="tex2html541"
+<B> Next:</B> <A NAME="tex2html543"
HREF="node12.html">10 For Further Reference</A>
-<B> Up:</B> <A NAME="tex2html535"
+<B> Up:</B> <A NAME="tex2html537"
HREF="langref.html">SystemTap Language Reference</A>
-<B> Previous:</B> <A NAME="tex2html529"
+<B> Previous:</B> <A NAME="tex2html531"
HREF="node10.html">8 Statistics (aggregates)</A>
- <B> <A NAME="tex2html537"
- HREF="node1.html">Contents</A></B>
<B> <A NAME="tex2html539"
+ HREF="node1.html">Contents</A></B>
+ <B> <A NAME="tex2html541"
HREF="node13.html">Index</A></B>
<BR>
<BR>
<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></A>
<UL>
-<LI><A NAME="tex2html542"
+<LI><A NAME="tex2html544"
HREF="node11.html#SECTION000111000000000000000">9.1 Output functions</A>
<UL>
-<LI><A NAME="tex2html543"
+<LI><A NAME="tex2html545"
HREF="node11.html#SECTION000111100000000000000">9.1.1 error</A>
-<LI><A NAME="tex2html544"
+<LI><A NAME="tex2html546"
HREF="node11.html#SECTION000111200000000000000">9.1.2 log</A>
-<LI><A NAME="tex2html545"
+<LI><A NAME="tex2html547"
HREF="node11.html#SECTION000111300000000000000">9.1.3 print</A>
-<LI><A NAME="tex2html546"
+<LI><A NAME="tex2html548"
HREF="node11.html#SECTION000111400000000000000">9.1.4 printf</A>
-<LI><A NAME="tex2html547"
+<LI><A NAME="tex2html549"
HREF="node11.html#SECTION000111500000000000000">9.1.5 printd</A>
-<LI><A NAME="tex2html548"
+<LI><A NAME="tex2html550"
HREF="node11.html#SECTION000111600000000000000">9.1.6 printdln</A>
-<LI><A NAME="tex2html549"
+<LI><A NAME="tex2html551"
HREF="node11.html#SECTION000111700000000000000">9.1.7 println</A>
-<LI><A NAME="tex2html550"
+<LI><A NAME="tex2html552"
HREF="node11.html#SECTION000111800000000000000">9.1.8 sprint</A>
-<LI><A NAME="tex2html551"
+<LI><A NAME="tex2html553"
HREF="node11.html#SECTION000111900000000000000">9.1.9 sprintf</A>
-<LI><A NAME="tex2html552"
+<LI><A NAME="tex2html554"
HREF="node11.html#SECTION0001111000000000000000">9.1.10 system</A>
-<LI><A NAME="tex2html553"
+<LI><A NAME="tex2html555"
HREF="node11.html#SECTION0001111100000000000000">9.1.11 warn</A>
</UL>
<BR>
-<LI><A NAME="tex2html554"
- HREF="node11.html#SECTION000112000000000000000">9.2 Task context at the probe point</A>
-<UL>
-<LI><A NAME="tex2html555"
- HREF="node11.html#SECTION000112100000000000000">9.2.1 backtrace</A>
<LI><A NAME="tex2html556"
- HREF="node11.html#SECTION000112200000000000000">9.2.2 caller</A>
+ HREF="node11.html#SECTION000112000000000000000">9.2 Context at the probe point</A>
+<UL>
<LI><A NAME="tex2html557"
- HREF="node11.html#SECTION000112300000000000000">9.2.3 caller_addr</A>
+ HREF="node11.html#SECTION000112100000000000000">9.2.1 backtrace</A>
<LI><A NAME="tex2html558"
- HREF="node11.html#SECTION000112400000000000000">9.2.4 cpu</A>
+ HREF="node11.html#SECTION000112200000000000000">9.2.2 caller</A>
<LI><A NAME="tex2html559"
- HREF="node11.html#SECTION000112500000000000000">9.2.5 egid</A>
+ HREF="node11.html#SECTION000112300000000000000">9.2.3 caller_addr</A>
<LI><A NAME="tex2html560"
- HREF="node11.html#SECTION000112600000000000000">9.2.6 euid</A>
+ HREF="node11.html#SECTION000112400000000000000">9.2.4 cpu</A>
<LI><A NAME="tex2html561"
- HREF="node11.html#SECTION000112700000000000000">9.2.7 execname</A>
+ HREF="node11.html#SECTION000112500000000000000">9.2.5 egid</A>
<LI><A NAME="tex2html562"
- HREF="node11.html#SECTION000112800000000000000">9.2.8 gid</A>
+ HREF="node11.html#SECTION000112600000000000000">9.2.6 euid</A>
<LI><A NAME="tex2html563"
- HREF="node11.html#SECTION000112900000000000000">9.2.9 is_return</A>
+ HREF="node11.html#SECTION000112700000000000000">9.2.7 execname</A>
<LI><A NAME="tex2html564"
- HREF="node11.html#SECTION0001121000000000000000">9.2.10 pexecname</A>
+ HREF="node11.html#SECTION000112800000000000000">9.2.8 gid</A>
<LI><A NAME="tex2html565"
- HREF="node11.html#SECTION0001121100000000000000">9.2.11 pid</A>
+ HREF="node11.html#SECTION000112900000000000000">9.2.9 is_return</A>
<LI><A NAME="tex2html566"
- HREF="node11.html#SECTION0001121200000000000000">9.2.12 ppid</A>
+ HREF="node11.html#SECTION0001121000000000000000">9.2.10 pexecname</A>
<LI><A NAME="tex2html567"
- HREF="node11.html#SECTION0001121300000000000000">9.2.13 tid</A>
+ HREF="node11.html#SECTION0001121100000000000000">9.2.11 pid</A>
<LI><A NAME="tex2html568"
- HREF="node11.html#SECTION0001121400000000000000">9.2.14 uid</A>
+ HREF="node11.html#SECTION0001121200000000000000">9.2.12 ppid</A>
<LI><A NAME="tex2html569"
- HREF="node11.html#SECTION0001121500000000000000">9.2.15 print_backtrace</A>
+ HREF="node11.html#SECTION0001121300000000000000">9.2.13 tid</A>
<LI><A NAME="tex2html570"
- HREF="node11.html#SECTION0001121600000000000000">9.2.16 print_regs</A>
+ HREF="node11.html#SECTION0001121400000000000000">9.2.14 uid</A>
<LI><A NAME="tex2html571"
- HREF="node11.html#SECTION0001121700000000000000">9.2.17 print_stack</A>
+ HREF="node11.html#SECTION0001121500000000000000">9.2.15 print_backtrace</A>
<LI><A NAME="tex2html572"
- HREF="node11.html#SECTION0001121800000000000000">9.2.18 stack_size</A>
+ HREF="node11.html#SECTION0001121600000000000000">9.2.16 print_regs</A>
<LI><A NAME="tex2html573"
- HREF="node11.html#SECTION0001121900000000000000">9.2.19 stack_unused</A>
+ HREF="node11.html#SECTION0001121700000000000000">9.2.17 print_stack</A>
<LI><A NAME="tex2html574"
- HREF="node11.html#SECTION0001122000000000000000">9.2.20 stack_used</A>
+ HREF="node11.html#SECTION0001121800000000000000">9.2.18 stack_size</A>
<LI><A NAME="tex2html575"
- HREF="node11.html#SECTION0001122100000000000000">9.2.21 stp_pid</A>
+ HREF="node11.html#SECTION0001121900000000000000">9.2.19 stack_unused</A>
<LI><A NAME="tex2html576"
- HREF="node11.html#SECTION0001122200000000000000">9.2.22 target</A>
+ HREF="node11.html#SECTION0001122000000000000000">9.2.20 stack_used</A>
<LI><A NAME="tex2html577"
- HREF="node11.html#SECTION0001122300000000000000">9.2.23 task_cpu</A>
+ HREF="node11.html#SECTION0001122100000000000000">9.2.21 stp_pid</A>
<LI><A NAME="tex2html578"
- HREF="node11.html#SECTION0001122400000000000000">9.2.24 task_current</A>
+ HREF="node11.html#SECTION0001122200000000000000">9.2.22 target</A>
+</UL>
+<BR>
<LI><A NAME="tex2html579"
- HREF="node11.html#SECTION0001122500000000000000">9.2.25 task_egid</A>
+ HREF="node11.html#SECTION000113000000000000000">9.3 Task data</A>
+<UL>
<LI><A NAME="tex2html580"
- HREF="node11.html#SECTION0001122600000000000000">9.2.26 task_execname</A>
+ HREF="node11.html#SECTION000113100000000000000">9.3.1 task_cpu</A>
<LI><A NAME="tex2html581"
- HREF="node11.html#SECTION0001122700000000000000">9.2.27 task_euid</A>
+ HREF="node11.html#SECTION000113200000000000000">9.3.2 task_current</A>
<LI><A NAME="tex2html582"
- HREF="node11.html#SECTION0001122800000000000000">9.2.28 task_gid</A>
+ HREF="node11.html#SECTION000113300000000000000">9.3.3 task_egid</A>
<LI><A NAME="tex2html583"
- HREF="node11.html#SECTION0001122900000000000000">9.2.29 task_nice</A>
+ HREF="node11.html#SECTION000113400000000000000">9.3.4 task_execname</A>
<LI><A NAME="tex2html584"
- HREF="node11.html#SECTION0001123000000000000000">9.2.30 task_parent</A>
+ HREF="node11.html#SECTION000113500000000000000">9.3.5 task_euid</A>
<LI><A NAME="tex2html585"
- HREF="node11.html#SECTION0001123100000000000000">9.2.31 task_pid</A>
+ HREF="node11.html#SECTION000113600000000000000">9.3.6 task_gid</A>
<LI><A NAME="tex2html586"
- HREF="node11.html#SECTION0001123200000000000000">9.2.32 task_prio</A>
+ HREF="node11.html#SECTION000113700000000000000">9.3.7 task_nice</A>
<LI><A NAME="tex2html587"
- HREF="node11.html#SECTION0001123300000000000000">9.2.33 task_state</A>
+ HREF="node11.html#SECTION000113800000000000000">9.3.8 task_parent</A>
<LI><A NAME="tex2html588"
- HREF="node11.html#SECTION0001123400000000000000">9.2.34 task_tid</A>
+ HREF="node11.html#SECTION000113900000000000000">9.3.9 task_pid</A>
<LI><A NAME="tex2html589"
- HREF="node11.html#SECTION0001123500000000000000">9.2.35 task_uid</A>
+ HREF="node11.html#SECTION0001131000000000000000">9.3.10 task_prio</A>
<LI><A NAME="tex2html590"
- HREF="node11.html#SECTION0001123600000000000000">9.2.36 task_open_file_handles</A>
+ HREF="node11.html#SECTION0001131100000000000000">9.3.11 task_state</A>
<LI><A NAME="tex2html591"
- HREF="node11.html#SECTION0001123700000000000000">9.2.37 task_max_file_handles</A>
-</UL>
-<BR>
+ HREF="node11.html#SECTION0001131200000000000000">9.3.12 task_tid</A>
<LI><A NAME="tex2html592"
- HREF="node11.html#SECTION000113000000000000000">9.3 Accessing string data at a probe point</A>
-<UL>
+ HREF="node11.html#SECTION0001131300000000000000">9.3.13 task_uid</A>
<LI><A NAME="tex2html593"
- HREF="node11.html#SECTION000113100000000000000">9.3.1 kernel_string</A>
+ HREF="node11.html#SECTION0001131400000000000000">9.3.14 task_open_file_handles</A>
<LI><A NAME="tex2html594"
- HREF="node11.html#SECTION000113200000000000000">9.3.2 user_string</A>
+ HREF="node11.html#SECTION0001131500000000000000">9.3.15 task_max_file_handles</A>
+</UL>
+<BR>
<LI><A NAME="tex2html595"
- HREF="node11.html#SECTION000113300000000000000">9.3.3 user_string2</A>
+ HREF="node11.html#SECTION000114000000000000000">9.4 Accessing string data at a probe point</A>
+<UL>
<LI><A NAME="tex2html596"
- HREF="node11.html#SECTION000113400000000000000">9.3.4 user_string_warn</A>
+ HREF="node11.html#SECTION000114100000000000000">9.4.1 kernel_string</A>
<LI><A NAME="tex2html597"
- HREF="node11.html#SECTION000113500000000000000">9.3.5 user_string_quoted</A>
-</UL>
-<BR>
+ HREF="node11.html#SECTION000114200000000000000">9.4.2 user_string</A>
<LI><A NAME="tex2html598"
- HREF="node11.html#SECTION000114000000000000000">9.4 Initializing queue statistics</A>
-<UL>
+ HREF="node11.html#SECTION000114300000000000000">9.4.3 user_string2</A>
<LI><A NAME="tex2html599"
- HREF="node11.html#SECTION000114100000000000000">9.4.1 qs_wait</A>
+ HREF="node11.html#SECTION000114400000000000000">9.4.4 user_string_warn</A>
<LI><A NAME="tex2html600"
- HREF="node11.html#SECTION000114200000000000000">9.4.2 qs_run</A>
-<LI><A NAME="tex2html601"
- HREF="node11.html#SECTION000114300000000000000">9.4.3 qs_done</A>
+ HREF="node11.html#SECTION000114500000000000000">9.4.5 user_string_quoted</A>
</UL>
<BR>
-<LI><A NAME="tex2html602"
- HREF="node11.html#SECTION000115000000000000000">9.5 Using queue statistics</A>
+<LI><A NAME="tex2html601"
+ HREF="node11.html#SECTION000115000000000000000">9.5 Initializing queue statistics</A>
<UL>
+<LI><A NAME="tex2html602"
+ HREF="node11.html#SECTION000115100000000000000">9.5.1 qs_wait</A>
<LI><A NAME="tex2html603"
- HREF="node11.html#SECTION000115100000000000000">9.5.1 qsq_blocked</A>
+ HREF="node11.html#SECTION000115200000000000000">9.5.2 qs_run</A>
<LI><A NAME="tex2html604"
- HREF="node11.html#SECTION000115200000000000000">9.5.2 qsq_print</A>
+ HREF="node11.html#SECTION000115300000000000000">9.5.3 qs_done</A>
+</UL>
+<BR>
<LI><A NAME="tex2html605"
- HREF="node11.html#SECTION000115300000000000000">9.5.3 qsq_service_time</A>
+ HREF="node11.html#SECTION000116000000000000000">9.6 Using queue statistics</A>
+<UL>
<LI><A NAME="tex2html606"
- HREF="node11.html#SECTION000115400000000000000">9.5.4 qsq_start</A>
+ HREF="node11.html#SECTION000116100000000000000">9.6.1 qsq_blocked</A>
<LI><A NAME="tex2html607"
- HREF="node11.html#SECTION000115500000000000000">9.5.5 qsq_throughput</A>
+ HREF="node11.html#SECTION000116200000000000000">9.6.2 qsq_print</A>
<LI><A NAME="tex2html608"
- HREF="node11.html#SECTION000115600000000000000">9.5.6 qsq_utilization</A>
+ HREF="node11.html#SECTION000116300000000000000">9.6.3 qsq_service_time</A>
<LI><A NAME="tex2html609"
- HREF="node11.html#SECTION000115700000000000000">9.5.7 qsq_wait_queue_length</A>
+ HREF="node11.html#SECTION000116400000000000000">9.6.4 qsq_start</A>
<LI><A NAME="tex2html610"
- HREF="node11.html#SECTION000115800000000000000">9.5.8 qsq_wait_time</A>
+ HREF="node11.html#SECTION000116500000000000000">9.6.5 qsq_throughput</A>
<LI><A NAME="tex2html611"
- HREF="node11.html#SECTION000115900000000000000">9.5.9 A queue example</A>
-</UL>
-<BR>
+ HREF="node11.html#SECTION000116600000000000000">9.6.6 qsq_utilization</A>
<LI><A NAME="tex2html612"
- HREF="node11.html#SECTION000116000000000000000">9.6 Probe point identification</A>
-<UL>
+ HREF="node11.html#SECTION000116700000000000000">9.6.7 qsq_wait_queue_length</A>
<LI><A NAME="tex2html613"
- HREF="node11.html#SECTION000116100000000000000">9.6.1 pp</A>
+ HREF="node11.html#SECTION000116800000000000000">9.6.8 qsq_wait_time</A>
<LI><A NAME="tex2html614"
- HREF="node11.html#SECTION000116200000000000000">9.6.2 probefunc</A>
-<LI><A NAME="tex2html615"
- HREF="node11.html#SECTION000116300000000000000">9.6.3 probemod</A>
+ HREF="node11.html#SECTION000116900000000000000">9.6.9 A queue example</A>
</UL>
<BR>
-<LI><A NAME="tex2html616"
- HREF="node11.html#SECTION000117000000000000000">9.7 Formatting functions</A>
+<LI><A NAME="tex2html615"
+ HREF="node11.html#SECTION000117000000000000000">9.7 Probe point identification</A>
<UL>
+<LI><A NAME="tex2html616"
+ HREF="node11.html#SECTION000117100000000000000">9.7.1 pp</A>
<LI><A NAME="tex2html617"
- HREF="node11.html#SECTION000117100000000000000">9.7.1 ctime</A>
+ HREF="node11.html#SECTION000117200000000000000">9.7.2 probefunc</A>
<LI><A NAME="tex2html618"
- HREF="node11.html#SECTION000117200000000000000">9.7.2 errno_str</A>
+ HREF="node11.html#SECTION000117300000000000000">9.7.3 probemod</A>
+</UL>
+<BR>
<LI><A NAME="tex2html619"
- HREF="node11.html#SECTION000117300000000000000">9.7.3 returnstr</A>
+ HREF="node11.html#SECTION000118000000000000000">9.8 Formatting functions</A>
+<UL>
<LI><A NAME="tex2html620"
- HREF="node11.html#SECTION000117400000000000000">9.7.4 thread_indent</A>
+ HREF="node11.html#SECTION000118100000000000000">9.8.1 ctime</A>
<LI><A NAME="tex2html621"
- HREF="node11.html#SECTION000117500000000000000">9.7.5 thread_timestamp</A>
-</UL>
-<BR>
+ HREF="node11.html#SECTION000118200000000000000">9.8.2 errno_str</A>
<LI><A NAME="tex2html622"
- HREF="node11.html#SECTION000118000000000000000">9.8 String functions</A>
-<UL>
+ HREF="node11.html#SECTION000118300000000000000">9.8.3 returnstr</A>
<LI><A NAME="tex2html623"
- HREF="node11.html#SECTION000118100000000000000">9.8.1 isinstr</A>
+ HREF="node11.html#SECTION000118400000000000000">9.8.4 thread_indent</A>
<LI><A NAME="tex2html624"
- HREF="node11.html#SECTION000118200000000000000">9.8.2 strlen</A>
+ HREF="node11.html#SECTION000118500000000000000">9.8.5 thread_timestamp</A>
+</UL>
+<BR>
<LI><A NAME="tex2html625"
- HREF="node11.html#SECTION000118300000000000000">9.8.3 strtol</A>
+ HREF="node11.html#SECTION000119000000000000000">9.9 String functions</A>
+<UL>
<LI><A NAME="tex2html626"
- HREF="node11.html#SECTION000118400000000000000">9.8.4 substr</A>
+ HREF="node11.html#SECTION000119100000000000000">9.9.1 isinstr</A>
<LI><A NAME="tex2html627"
- HREF="node11.html#SECTION000118500000000000000">9.8.5 text_str</A>
+ HREF="node11.html#SECTION000119200000000000000">9.9.2 strlen</A>
<LI><A NAME="tex2html628"
- HREF="node11.html#SECTION000118600000000000000">9.8.6 text_strn</A>
+ HREF="node11.html#SECTION000119300000000000000">9.9.3 strtol</A>
<LI><A NAME="tex2html629"
- HREF="node11.html#SECTION000118700000000000000">9.8.7 tokenize</A>
-</UL>
-<BR>
+ HREF="node11.html#SECTION000119400000000000000">9.9.4 substr</A>
<LI><A NAME="tex2html630"
- HREF="node11.html#SECTION000119000000000000000">9.9 Timestamps</A>
-<UL>
+ HREF="node11.html#SECTION000119500000000000000">9.9.5 text_str</A>
<LI><A NAME="tex2html631"
- HREF="node11.html#SECTION000119100000000000000">9.9.1 get_cycles</A>
+ HREF="node11.html#SECTION000119600000000000000">9.9.6 text_strn</A>
<LI><A NAME="tex2html632"
- HREF="node11.html#SECTION000119200000000000000">9.9.2 gettimeofday_ms</A>
+ HREF="node11.html#SECTION000119700000000000000">9.9.7 tokenize</A>
+</UL>
+<BR>
<LI><A NAME="tex2html633"
- HREF="node11.html#SECTION000119300000000000000">9.9.3 gettimeofday_ns</A>
+ HREF="node11.html#SECTION0001110000000000000000">9.10 Timestamps</A>
+<UL>
<LI><A NAME="tex2html634"
- HREF="node11.html#SECTION000119400000000000000">9.9.4 gettimeofday_s</A>
+ HREF="node11.html#SECTION0001110100000000000000">9.10.1 get_cycles</A>
<LI><A NAME="tex2html635"
- HREF="node11.html#SECTION000119500000000000000">9.9.5 gettimeofday_us</A>
-</UL>
-<BR>
+ HREF="node11.html#SECTION0001110200000000000000">9.10.2 gettimeofday_ms</A>
<LI><A NAME="tex2html636"
- HREF="node11.html#SECTION0001110000000000000000">9.10 Miscellaneous tapset functions</A>
-<UL>
+ HREF="node11.html#SECTION0001110300000000000000">9.10.3 gettimeofday_ns</A>
<LI><A NAME="tex2html637"
- HREF="node11.html#SECTION0001110100000000000000">9.10.1 addr_to_node</A>
+ HREF="node11.html#SECTION0001110400000000000000">9.10.4 gettimeofday_s</A>
<LI><A NAME="tex2html638"
- HREF="node11.html#SECTION0001110200000000000000">9.10.2 exit</A>
+ HREF="node11.html#SECTION0001110500000000000000">9.10.5 gettimeofday_us</A>
+</UL>
+<BR>
<LI><A NAME="tex2html639"
- HREF="node11.html#SECTION0001110300000000000000">9.10.3 system</A>
+ HREF="node11.html#SECTION0001111000000000000000">9.11 Miscellaneous tapset functions</A>
+<UL>
+<LI><A NAME="tex2html640"
+ HREF="node11.html#SECTION0001111100000000000000">9.11.1 addr_to_node</A>
+<LI><A NAME="tex2html641"
+ HREF="node11.html#SECTION0001111200000000000000">9.11.2 exit</A>
+<LI><A NAME="tex2html642"
+ HREF="node11.html#SECTION0001111300000000000000">9.11.3 system</A>
</UL></UL>
<!--End of Table of Child-Links-->
<HR>
<P>
<H3><A NAME="SECTION000111100000000000000"></A>
-<A NAME="687"></A>
+<A NAME="700"></A>
<BR>
9.1.1 error
</H3>
<P>
<H3><A NAME="SECTION000111200000000000000"></A>
-<A NAME="694"></A>
+<A NAME="707"></A>
<BR>
9.1.2 log
</H3>
<P>
<H3><A NAME="SECTION000111300000000000000"></A>
-<A NAME="701"></A>
+<A NAME="714"></A>
<BR>
9.1.3 print
</H3>
<P>
<H3><A NAME="SECTION000111400000000000000"></A>
-<A NAME="707"></A>
+<A NAME="720"></A>
<BR>
9.1.4 printf
</H3>
</PRE>
</DD>
</DL>The printf function takes a formatting string as an argument, and a number
-of values of corresponding types, and prints them all. The printf formatting
-directives are similar to those of C, except that they are fully checked
-for type by the translator.
+of values of corresponding types, and prints them all. The format must be a
+literal string constant. The printf formatting directives are similar to those
+of C, except that they are fully checked for type by the translator.
<P>
The formatting string can contain tags that are defined as follows:
<BR><P></P>
<DIV ALIGN="CENTER">
-<A NAME="718"></A>
+<A NAME="731"></A>
<TABLE CELLPADDING=3 BORDER="1">
<CAPTION><STRONG>Table 1:</STRONG>
printf specifier values</CAPTION>
<BR><P></P>
<DIV ALIGN="CENTER">
-<A NAME="736"></A>
+<A NAME="749"></A>
<TABLE CELLPADDING=3 BORDER="1">
<CAPTION><STRONG>Table 2:</STRONG>
printf flag values</CAPTION>
<BR><P></P>
<DIV ALIGN="CENTER">
-<A NAME="755"></A>
+<A NAME="768"></A>
<TABLE CELLPADDING=3 BORDER="1">
<CAPTION><STRONG>Table 3:</STRONG>
printf width values</CAPTION>
<P>
<P>
-<A NAME="766"></A>
+<A NAME="779"></A>
<TABLE CELLPADDING=3 BORDER="1">
<CAPTION><STRONG>Table 4:</STRONG>
printf precision values</CAPTION>
<P>
<H3><A NAME="SECTION000111500000000000000"></A>
-<A NAME="806"></A>
+<A NAME="819"></A>
<BR>
9.1.5 printd
</H3>
printd:unknown (delimiter:string, )
</PRE>
</DD>
-</DL>This function takes a string delimiter and two or more values of any type, then prints the
-values with the delimiter interposed.
+</DL>This function takes a string delimiter and two or more values of any type, then
+prints the values with the delimiter interposed. The delimiter must be a
+literal string constant.
<P>
For example:
<P>
<H3><A NAME="SECTION000111600000000000000"></A>
-<A NAME="820"></A>
+<A NAME="833"></A>
<BR>
9.1.6 printdln
</H3>
<P>
<H3><A NAME="SECTION000111700000000000000"></A>
-<A NAME="827"></A>
+<A NAME="840"></A>
<BR>
9.1.7 println
</H3>
<P>
<H3><A NAME="SECTION000111800000000000000"></A>
-<A NAME="834"></A>
+<A NAME="847"></A>
<BR>
9.1.8 sprint
</H3>
<P>
<H3><A NAME="SECTION000111900000000000000"></A>
-<A NAME="841"></A>
+<A NAME="854"></A>
<BR>
9.1.9 sprintf
</H3>
<P>
<H3><A NAME="SECTION0001111000000000000000"></A>
-<A NAME="848"></A>
+<A NAME="861"></A>
<BR>
9.1.10 system
</H3>
<P>
<H3><A NAME="SECTION0001111100000000000000"></A>
-<A NAME="854"></A>
+<A NAME="867"></A>
<BR>
9.1.11 warn
</H3>
<P>
<H2><A NAME="SECTION000112000000000000000">
-9.2 Task context at the probe point</A>
+9.2 Context at the probe point</A>
</H2>
<P>
-The following functions provide ways to access the task context at a probe
-point. Note that these may not return correct values when a probe is hit
-in interrupt context.
+The following functions provide ways to access the current task context
+at a probe point. Note that these may not return correct values when
+a probe is hit in interrupt context.
<P>
<H3><A NAME="SECTION000112100000000000000"></A>
-<A NAME="861"></A>
+<A NAME="874"></A>
<BR>
9.2.1 backtrace
</H3>
<P>
<H3><A NAME="SECTION000112200000000000000"></A>
-<A NAME="867"></A>
+<A NAME="880"></A>
<BR>
9.2.2 caller
</H3>
<P>
<H3><A NAME="SECTION000112300000000000000"></A>
-<A NAME="873"></A>
+<A NAME="886"></A>
<BR>
9.2.3 caller_addr
</H3>
<P>
<H3><A NAME="SECTION000112400000000000000"></A>
-<A NAME="879"></A>
+<A NAME="892"></A>
<BR>
9.2.4 cpu
</H3>
<P>
<H3><A NAME="SECTION000112500000000000000"></A>
-<A NAME="885"></A>
+<A NAME="898"></A>
<BR>
9.2.5 egid
</H3>
<P>
<H3><A NAME="SECTION000112600000000000000"></A>
-<A NAME="891"></A>
+<A NAME="904"></A>
<BR>
9.2.6 euid
</H3>
<P>
<H3><A NAME="SECTION000112700000000000000"></A>
-<A NAME="897"></A>
+<A NAME="910"></A>
<BR>
9.2.7 execname
</H3>
<P>
<H3><A NAME="SECTION000112800000000000000"></A>
-<A NAME="903"></A>
+<A NAME="916"></A>
<BR>
9.2.8 gid
</H3>
<P>
<H3><A NAME="SECTION000112900000000000000"></A>
-<A NAME="909"></A>
+<A NAME="922"></A>
<BR>
9.2.9 is_return
</H3>
<P>
<H3><A NAME="SECTION0001121000000000000000"></A>
-<A NAME="916"></A>
+<A NAME="929"></A>
<BR>
9.2.10 pexecname
</H3>
<P>
<H3><A NAME="SECTION0001121100000000000000"></A>
-<A NAME="922"></A>
+<A NAME="935"></A>
<BR>
9.2.11 pid
</H3>
<P>
<H3><A NAME="SECTION0001121200000000000000"></A>
-<A NAME="928"></A>
+<A NAME="941"></A>
<BR>
9.2.12 ppid
</H3>
<P>
<H3><A NAME="SECTION0001121300000000000000"></A>
-<A NAME="934"></A>
+<A NAME="947"></A>
<BR>
9.2.13 tid
</H3>
<P>
<H3><A NAME="SECTION0001121400000000000000"></A>
-<A NAME="940"></A>
+<A NAME="953"></A>
<BR>
9.2.14 uid
</H3>
<P>
<H3><A NAME="SECTION0001121500000000000000"></A>
-<A NAME="946"></A>
+<A NAME="959"></A>
<BR>
9.2.15 print_backtrace
</H3>
<P>
<H3><A NAME="SECTION0001121600000000000000"></A>
-<A NAME="953"></A>
+<A NAME="966"></A>
<BR>
9.2.16 print_regs
</H3>
<P>
<H3><A NAME="SECTION0001121700000000000000"></A>
-<A NAME="959"></A>
+<A NAME="972"></A>
<BR>
9.2.17 print_stack
</H3>
<P>
<H3><A NAME="SECTION0001121800000000000000"></A>
-<A NAME="966"></A>
+<A NAME="979"></A>
<BR>
9.2.18 stack_size
</H3>
<P>
<H3><A NAME="SECTION0001121900000000000000"></A>
-<A NAME="972"></A>
+<A NAME="985"></A>
<BR>
9.2.19 stack_unused
</H3>
<P>
<H3><A NAME="SECTION0001122000000000000000"></A>
-<A NAME="978"></A>
+<A NAME="991"></A>
<BR>
9.2.20 stack_used
</H3>
<P>
<H3><A NAME="SECTION0001122100000000000000"></A>
-<A NAME="984"></A>
+<A NAME="997"></A>
<BR>
9.2.21 stp_pid
</H3>
<P>
<H3><A NAME="SECTION0001122200000000000000"></A>
-<A NAME="990"></A>
+<A NAME="1003"></A>
<BR>
9.2.22 target
</H3>
<P>
-<H3><A NAME="SECTION0001122300000000000000"></A>
-<A NAME="1000"></A>
+<H2><A NAME="SECTION000113000000000000000">
+9.3 Task data</A>
+</H2>
+
+<P>
+These functions return data about a task. They all require a task handle as
+input, such as the value return by task_current() or the variables
+prev_task and next_task in the scheduler.ctxswitch probe alias.
+
+<P>
+
+<H3><A NAME="SECTION000113100000000000000"></A>
+<A NAME="1014"></A>
<BR>
-9.2.23 task_cpu
+9.3.1 task_cpu
</H3>
General syntax:
<P>
-<H3><A NAME="SECTION0001122400000000000000"></A>
-<A NAME="1006"></A>
+<H3><A NAME="SECTION000113200000000000000"></A>
+<A NAME="1020"></A>
<BR>
-9.2.24 task_current
+9.3.2 task_current
</H3>
General syntax:
<P>
-<H3><A NAME="SECTION0001122500000000000000"></A>
-<A NAME="1013"></A>
+<H3><A NAME="SECTION000113300000000000000"></A>
+<A NAME="1027"></A>
<BR>
-9.2.25 task_egid
+9.3.3 task_egid
</H3>
General syntax:
<P>
-<H3><A NAME="SECTION0001122600000000000000"></A>
-<A NAME="1019"></A>
+<H3><A NAME="SECTION000113400000000000000"></A>
+<A NAME="1033"></A>
<BR>
-9.2.26 task_execname
+9.3.4 task_execname
</H3>
General syntax:
<P>
-<H3><A NAME="SECTION0001122700000000000000"></A>
-<A NAME="1025"></A>
+<H3><A NAME="SECTION000113500000000000000"></A>
+<A NAME="1039"></A>
<BR>
-9.2.27 task_euid
+9.3.5 task_euid
</H3>
General syntax:
<P>
-<H3><A NAME="SECTION0001122800000000000000"></A>
-<A NAME="1031"></A>
+<H3><A NAME="SECTION000113600000000000000"></A>
+<A NAME="1045"></A>
<BR>
-9.2.28 task_gid
+9.3.6 task_gid
</H3>
General syntax:
<P>
-<H3><A NAME="SECTION0001122900000000000000"></A>
-<A NAME="1037"></A>
+<H3><A NAME="SECTION000113700000000000000"></A>
+<A NAME="1051"></A>
<BR>
-9.2.29 task_nice
+9.3.7 task_nice
</H3>
General syntax:
<P>
-<H3><A NAME="SECTION0001123000000000000000"></A>
-<A NAME="1043"></A>
+<H3><A NAME="SECTION000113800000000000000"></A>
+<A NAME="1057"></A>
<BR>
-9.2.30 task_parent
+9.3.8 task_parent
</H3>
General syntax:
<P>
-<H3><A NAME="SECTION0001123100000000000000"></A>
-<A NAME="1050"></A>
+<H3><A NAME="SECTION000113900000000000000"></A>
+<A NAME="1064"></A>
<BR>
-9.2.31 task_pid
+9.3.9 task_pid
</H3>
General syntax:
<P>
-<H3><A NAME="SECTION0001123200000000000000"></A>
-<A NAME="1056"></A>
+<H3><A NAME="SECTION0001131000000000000000"></A>
+<A NAME="1070"></A>
<BR>
-9.2.32 task_prio
+9.3.10 task_prio
</H3>
General syntax:
<P>
-<H3><A NAME="SECTION0001123300000000000000"></A>
-<A NAME="1062"></A>
+<H3><A NAME="SECTION0001131100000000000000"></A>
+<A NAME="1076"></A>
<BR>
-9.2.33 task_state
+9.3.11 task_state
</H3>
General syntax:
</DL>
<P>
-<H3><A NAME="SECTION0001123400000000000000"></A>
-<A NAME="1072"></A>
+<H3><A NAME="SECTION0001131200000000000000"></A>
+<A NAME="1086"></A>
<BR>
-9.2.34 task_tid
+9.3.12 task_tid
</H3>
General syntax:
<P>
-<H3><A NAME="SECTION0001123500000000000000"></A>
-<A NAME="1078"></A>
+<H3><A NAME="SECTION0001131300000000000000"></A>
+<A NAME="1092"></A>
<BR>
-9.2.35 task_uid
+9.3.13 task_uid
</H3>
General syntax:
<P>
-<H3><A NAME="SECTION0001123600000000000000"></A>
-<A NAME="1084"></A>
+<H3><A NAME="SECTION0001131400000000000000"></A>
+<A NAME="1098"></A>
<BR>
-9.2.36 task_open_file_handles
+9.3.14 task_open_file_handles
</H3>
General syntax:
<P>
-<H3><A NAME="SECTION0001123700000000000000"></A>
-<A NAME="1090"></A>
+<H3><A NAME="SECTION0001131500000000000000"></A>
+<A NAME="1104"></A>
<BR>
-9.2.37 task_max_file_handles
+9.3.15 task_max_file_handles
</H3>
General syntax:
<P>
-<H2><A NAME="SECTION000113000000000000000">
-9.3 Accessing string data at a probe point</A>
+<H2><A NAME="SECTION000114000000000000000">
+9.4 Accessing string data at a probe point</A>
</H2>
<P>
<P>
-<H3><A NAME="SECTION000113100000000000000"></A>
-<A NAME="1097"></A>
+<H3><A NAME="SECTION000114100000000000000"></A>
+<A NAME="1111"></A>
<BR>
-9.3.1 kernel_string
+9.4.1 kernel_string
</H3>
General syntax:
<P>
-<H3><A NAME="SECTION000113200000000000000"></A><A NAME="sub:user_string"></A>
-<A NAME="1103"></A>
+<H3><A NAME="SECTION000114200000000000000"></A><A NAME="sub:user_string"></A>
+<A NAME="1117"></A>
<BR>
-9.3.2 user_string
+9.4.2 user_string
</H3>
General syntax:
<P>
-<H3><A NAME="SECTION000113300000000000000"></A>
-<A NAME="1110"></A>
+<H3><A NAME="SECTION000114300000000000000"></A>
+<A NAME="1124"></A>
<BR>
-9.3.3 user_string2
+9.4.3 user_string2
</H3>
General syntax:
user_string2:string (addr:long, err_msg:string)
</PRE>
</DD>
-</DL>This function is similar to <TT>user_string</TT>, (Section <A HREF="#sub:user_string">9.3.2</A>)
+</DL>This function is similar to <TT>user_string</TT>, (Section <A HREF="#sub:user_string">9.4.2</A>)
but allows passing an error message as an argument to be returned if userspace
data is not available.
<P>
-<H3><A NAME="SECTION000113400000000000000"></A>
-<A NAME="1118"></A>
+<H3><A NAME="SECTION000114400000000000000"></A>
+<A NAME="1132"></A>
<BR>
-9.3.4 user_string_warn
+9.4.4 user_string_warn
</H3>
General syntax:
<P>
-<H3><A NAME="SECTION000113500000000000000"></A>
-<A NAME="1124"></A>
+<H3><A NAME="SECTION000114500000000000000"></A>
+<A NAME="1138"></A>
<BR>
-9.3.5 user_string_quoted
+9.4.5 user_string_quoted
</H3>
General syntax:
<P>
-<H2><A NAME="SECTION000114000000000000000"></A>
-<A NAME="1130"></A>
+<H2><A NAME="SECTION000115000000000000000"></A>
+<A NAME="1144"></A>
<BR>
-9.4 Initializing queue statistics
+9.5 Initializing queue statistics
</H2>
The queue_stats tapset provides functions that, when given notification
of queuing events like wait, run, or done, track averages such as queue length,
<P>
-<H3><A NAME="SECTION000114100000000000000"></A>
-<A NAME="1132"></A>
+<H3><A NAME="SECTION000115100000000000000"></A>
+<A NAME="1146"></A>
<BR>
-9.4.1 qs_wait
+9.5.1 qs_wait
</H3>
General syntax:
<P>
-<H3><A NAME="SECTION000114200000000000000"></A>
-<A NAME="1138"></A>
+<H3><A NAME="SECTION000115200000000000000"></A>
+<A NAME="1152"></A>
<BR>
-9.4.2 qs_run
+9.5.2 qs_run
</H3>
General syntax:
<P>
-<H3><A NAME="SECTION000114300000000000000"></A>
-<A NAME="1144"></A>
+<H3><A NAME="SECTION000115300000000000000"></A>
+<A NAME="1158"></A>
<BR>
-9.4.3 qs_done
+9.5.3 qs_done
</H3>
General syntax:
<P>
-<H2><A NAME="SECTION000115000000000000000">
-9.5 Using queue statistics</A>
+<H2><A NAME="SECTION000116000000000000000">
+9.6 Using queue statistics</A>
</H2>
<P>
<P>
-<H3><A NAME="SECTION000115100000000000000"></A>
-<A NAME="1151"></A>
+<H3><A NAME="SECTION000116100000000000000"></A>
+<A NAME="1165"></A>
<BR>
-9.5.1 qsq_blocked
+9.6.1 qsq_blocked
</H3>
General syntax:
<P>
-<H3><A NAME="SECTION000115200000000000000"></A>
-<A NAME="1157"></A>
+<H3><A NAME="SECTION000116200000000000000"></A>
+<A NAME="1171"></A>
<BR>
-9.5.2 qsq_print
+9.6.2 qsq_print
</H3>
General syntax:
<P>
-<H3><A NAME="SECTION000115300000000000000"></A>
-<A NAME="1165"></A>
+<H3><A NAME="SECTION000116300000000000000"></A>
+<A NAME="1179"></A>
<BR>
-9.5.3 qsq_service_time
+9.6.3 qsq_service_time
</H3>
General syntax:
<P>
-<H3><A NAME="SECTION000115400000000000000"></A>
-<A NAME="1171"></A>
+<H3><A NAME="SECTION000116400000000000000"></A>
+<A NAME="1185"></A>
<BR>
-9.5.4 qsq_start
+9.6.4 qsq_start
</H3>
General syntax:
<P>
-<H3><A NAME="SECTION000115500000000000000"></A>
-<A NAME="1177"></A>
+<H3><A NAME="SECTION000116500000000000000"></A>
+<A NAME="1191"></A>
<BR>
-9.5.5 qsq_throughput
+9.6.5 qsq_throughput
</H3>
General syntax:
<P>
-<H3><A NAME="SECTION000115600000000000000"></A>
-<A NAME="1183"></A>
+<H3><A NAME="SECTION000116600000000000000"></A>
+<A NAME="1197"></A>
<BR>
-9.5.6 qsq_utilization
+9.6.6 qsq_utilization
</H3>
General syntax:
<P>
-<H3><A NAME="SECTION000115700000000000000"></A>
-<A NAME="1189"></A>
+<H3><A NAME="SECTION000116700000000000000"></A>
+<A NAME="1203"></A>
<BR>
-9.5.7 qsq_wait_queue_length
+9.6.7 qsq_wait_queue_length
</H3>
General syntax:
<P>
-<H3><A NAME="SECTION000115800000000000000"></A>
-<A NAME="1195"></A>
+<H3><A NAME="SECTION000116800000000000000"></A>
+<A NAME="1209"></A>
<BR>
-9.5.8 qsq_wait_time
+9.6.8 qsq_wait_time
</H3>
General syntax:
<P>
-<H3><A NAME="SECTION000115900000000000000">
-9.5.9 A queue example</A>
+<H3><A NAME="SECTION000116900000000000000">
+9.6.9 A queue example</A>
</H3>
<P>
</DL>
<P>
-<H2><A NAME="SECTION000116000000000000000">
-9.6 Probe point identification</A>
+<H2><A NAME="SECTION000117000000000000000">
+9.7 Probe point identification</A>
</H2>
<P>
<P>
-<H3><A NAME="SECTION000116100000000000000"></A>
-<A NAME="1211"></A>
+<H3><A NAME="SECTION000117100000000000000"></A>
+<A NAME="1225"></A>
<BR>
-9.6.1 pp
+9.7.1 pp
</H3>
General syntax:
<P>
-<H3><A NAME="SECTION000116200000000000000"></A>
-<A NAME="1217"></A>
+<H3><A NAME="SECTION000117200000000000000"></A>
+<A NAME="1231"></A>
<BR>
-9.6.2 probefunc
+9.7.2 probefunc
</H3>
General syntax:
<P>
-<H3><A NAME="SECTION000116300000000000000"></A>
-<A NAME="1223"></A>
+<H3><A NAME="SECTION000117300000000000000"></A>
+<A NAME="1237"></A>
<BR>
-9.6.3 probemod
+9.7.3 probemod
</H3>
General syntax:
<P>
-<H2><A NAME="SECTION000117000000000000000"></A>
-<A NAME="1229"></A>
+<H2><A NAME="SECTION000118000000000000000"></A>
+<A NAME="1243"></A>
<BR>
-9.7 Formatting functions
+9.8 Formatting functions
</H2>
The following functions help you format output.
<P>
-<H3><A NAME="SECTION000117100000000000000"></A>
-<A NAME="1231"></A>
+<H3><A NAME="SECTION000118100000000000000"></A>
+<A NAME="1245"></A>
<BR>
-9.7.1 ctime
+9.8.1 ctime
</H3>
General syntax:
<P>
-<H3><A NAME="SECTION000117200000000000000"></A>
-<A NAME="1242"></A>
+<H3><A NAME="SECTION000118200000000000000"></A>
+<A NAME="1256"></A>
<BR>
-9.7.2 errno_str
+9.8.2 errno_str
</H3>
General syntax:
<P>
-<H3><A NAME="SECTION000117300000000000000"></A>
-<A NAME="1248"></A>
+<H3><A NAME="SECTION000118300000000000000"></A>
+<A NAME="1262"></A>
<BR>
-9.7.3 returnstr
+9.8.3 returnstr
</H3>
General syntax:
<P>
-<H3><A NAME="SECTION000117400000000000000"></A>
-<A NAME="1255"></A>
+<H3><A NAME="SECTION000118400000000000000"></A>
+<A NAME="1269"></A>
<BR>
-9.7.4 thread_indent
+9.8.4 thread_indent
</H3>
General syntax:
</DL>
<P>
-<H3><A NAME="SECTION000117500000000000000"></A>
-<A NAME="1271"></A>
+<H3><A NAME="SECTION000118500000000000000"></A>
+<A NAME="1285"></A>
<BR>
-9.7.5 thread_timestamp
+9.8.5 thread_timestamp
</H3>
<P>
<P>
-<H2><A NAME="SECTION000118000000000000000"></A>
-<A NAME="1278"></A>
+<H2><A NAME="SECTION000119000000000000000"></A>
+<A NAME="1292"></A>
<BR>
-9.8 String functions
+9.9 String functions
</H2>
The following are string functions you can use.
<P>
-<H3><A NAME="SECTION000118100000000000000"></A>
-<A NAME="1280"></A>
+<H3><A NAME="SECTION000119100000000000000"></A>
+<A NAME="1294"></A>
<BR>
-9.8.1 isinstr
+9.9.1 isinstr
</H3>
General syntax:
<P>
-<H3><A NAME="SECTION000118200000000000000"></A>
-<A NAME="1286"></A>
+<H3><A NAME="SECTION000119200000000000000"></A>
+<A NAME="1300"></A>
<BR>
-9.8.2 strlen
+9.9.2 strlen
</H3>
General syntax:
<P>
-<H3><A NAME="SECTION000118300000000000000">
-9.8.3 strtol</A>
+<H3><A NAME="SECTION000119300000000000000">
+9.9.3 strtol</A>
</H3>
<P>
<P>
-<H3><A NAME="SECTION000118400000000000000"></A>
-<A NAME="1297"></A>
+<H3><A NAME="SECTION000119400000000000000"></A>
+<A NAME="1311"></A>
<BR>
-9.8.4 substr
+9.9.4 substr
</H3>
General syntax:
<P>
-<H3><A NAME="SECTION000118500000000000000"></A>
-<A NAME="1306"></A>
+<H3><A NAME="SECTION000119500000000000000"></A>
+<A NAME="1320"></A>
<BR>
-9.8.5 text_str
+9.9.5 text_str
</H3>
General syntax:
<P>
-<H3><A NAME="SECTION000118600000000000000"></A>
-<A NAME="1312"></A>
+<H3><A NAME="SECTION000119600000000000000"></A>
+<A NAME="1326"></A>
<BR>
-9.8.6 text_strn
+9.9.6 text_strn
</H3>
General syntax:
<P>
-<H3><A NAME="SECTION000118700000000000000">
-9.8.7 tokenize</A>
+<H3><A NAME="SECTION000119700000000000000">
+9.9.7 tokenize</A>
</H3>
<P>
<P>
-<H2><A NAME="SECTION000119000000000000000"></A>
-<A NAME="1325"></A>
+<H2><A NAME="SECTION0001110000000000000000"></A>
+<A NAME="1339"></A>
<BR>
-9.9 Timestamps
+9.10 Timestamps
</H2>
The following functions provide methods to extract time data.
<P>
-<H3><A NAME="SECTION000119100000000000000"></A>
-<A NAME="1327"></A>
+<H3><A NAME="SECTION0001110100000000000000"></A>
+<A NAME="1341"></A>
<BR>
-9.9.1 get_cycles
+9.10.1 get_cycles
</H3>
General syntax:
<P>
-<H3><A NAME="SECTION000119200000000000000"></A>
-<A NAME="1333"></A>
+<H3><A NAME="SECTION0001110200000000000000"></A>
+<A NAME="1347"></A>
<BR>
-9.9.2 gettimeofday_ms
+9.10.2 gettimeofday_ms
</H3>
General syntax:
<P>
-<H3><A NAME="SECTION000119300000000000000"></A>
-<A NAME="1339"></A>
+<H3><A NAME="SECTION0001110300000000000000"></A>
+<A NAME="1353"></A>
<BR>
-9.9.3 gettimeofday_ns
+9.10.3 gettimeofday_ns
</H3>
General syntax:
<P>
-<H3><A NAME="SECTION000119400000000000000"></A>
-<A NAME="1345"></A>
+<H3><A NAME="SECTION0001110400000000000000"></A>
+<A NAME="1359"></A>
<BR>
-9.9.4 gettimeofday_s
+9.10.4 gettimeofday_s
</H3>
General syntax:
<P>
-<H3><A NAME="SECTION000119500000000000000"></A>
-<A NAME="1351"></A>
+<H3><A NAME="SECTION0001110500000000000000"></A>
+<A NAME="1365"></A>
<BR>
-9.9.5 gettimeofday_us
+9.10.5 gettimeofday_us
</H3>
General syntax:
<P>
-<H2><A NAME="SECTION0001110000000000000000">
-9.10 Miscellaneous tapset functions</A>
+<H2><A NAME="SECTION0001111000000000000000">
+9.11 Miscellaneous tapset functions</A>
</H2>
<P>
<P>
-<H3><A NAME="SECTION0001110100000000000000"></A>
-<A NAME="1358"></A>
+<H3><A NAME="SECTION0001111100000000000000"></A>
+<A NAME="1372"></A>
<BR>
-9.10.1 addr_to_node
+9.11.1 addr_to_node
</H3>
General syntax:
<P>
-<H3><A NAME="SECTION0001110200000000000000"></A>
-<A NAME="1364"></A>
+<H3><A NAME="SECTION0001111200000000000000"></A>
+<A NAME="1378"></A>
<BR>
-9.10.2 exit
+9.11.2 exit
</H3>
General syntax:
<P>
-<H3><A NAME="SECTION0001110300000000000000"></A>
-<A NAME="1370"></A>
+<H3><A NAME="SECTION0001111300000000000000"></A>
+<A NAME="1384"></A>
<BR>
-9.10.3 system
+9.11.3 system
</H3>
General syntax:
<P>
<HR>
<!--Navigation Panel-->
-<A NAME="tex2html540"
+<A NAME="tex2html542"
HREF="node12.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
-<A NAME="tex2html534"
+<A NAME="tex2html536"
HREF="langref.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
-<A NAME="tex2html528"
+<A NAME="tex2html530"
HREF="node10.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
-<A NAME="tex2html536"
+<A NAME="tex2html538"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
-<A NAME="tex2html538"
+<A NAME="tex2html540"
HREF="node13.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A>
<BR>
-<B> Next:</B> <A NAME="tex2html541"
+<B> Next:</B> <A NAME="tex2html543"
HREF="node12.html">10 For Further Reference</A>
-<B> Up:</B> <A NAME="tex2html535"
+<B> Up:</B> <A NAME="tex2html537"
HREF="langref.html">SystemTap Language Reference</A>
-<B> Previous:</B> <A NAME="tex2html529"
+<B> Previous:</B> <A NAME="tex2html531"
HREF="node10.html">8 Statistics (aggregates)</A>
- <B> <A NAME="tex2html537"
- HREF="node1.html">Contents</A></B>
<B> <A NAME="tex2html539"
+ HREF="node1.html">Contents</A></B>
+ <B> <A NAME="tex2html541"
HREF="node13.html">Index</A></B>
<!--End of Navigation Panel-->
<BODY >
<!--Navigation Panel-->
-<A NAME="tex2html652"
+<A NAME="tex2html655"
HREF="node13.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
-<A NAME="tex2html646"
+<A NAME="tex2html649"
HREF="langref.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
-<A NAME="tex2html640"
+<A NAME="tex2html643"
HREF="node11.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
-<A NAME="tex2html648"
+<A NAME="tex2html651"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
-<A NAME="tex2html650"
+<A NAME="tex2html653"
HREF="node13.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A>
<BR>
-<B> Next:</B> <A NAME="tex2html653"
+<B> Next:</B> <A NAME="tex2html656"
HREF="node13.html">Index</A>
-<B> Up:</B> <A NAME="tex2html647"
+<B> Up:</B> <A NAME="tex2html650"
HREF="langref.html">SystemTap Language Reference</A>
-<B> Previous:</B> <A NAME="tex2html641"
+<B> Previous:</B> <A NAME="tex2html644"
HREF="node11.html">9 Predefined functions</A>
- <B> <A NAME="tex2html649"
+ <B> <A NAME="tex2html652"
HREF="node1.html">Contents</A></B>
- <B> <A NAME="tex2html651"
+ <B> <A NAME="tex2html654"
HREF="node13.html">Index</A></B>
<BR>
<BR>
<BODY >
<!--Navigation Panel-->
-<A NAME="tex2html664"
+<A NAME="tex2html667"
HREF="node14.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
-<A NAME="tex2html660"
+<A NAME="tex2html663"
HREF="langref.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
-<A NAME="tex2html654"
+<A NAME="tex2html657"
HREF="node12.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
-<A NAME="tex2html662"
+<A NAME="tex2html665"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
<BR>
-<B> Next:</B> <A NAME="tex2html665"
+<B> Next:</B> <A NAME="tex2html668"
HREF="node14.html">About this document ...</A>
-<B> Up:</B> <A NAME="tex2html661"
+<B> Up:</B> <A NAME="tex2html664"
HREF="langref.html">SystemTap Language Reference</A>
-<B> Previous:</B> <A NAME="tex2html655"
+<B> Previous:</B> <A NAME="tex2html658"
HREF="node12.html">10 For Further Reference</A>
- <B> <A NAME="tex2html663"
+ <B> <A NAME="tex2html666"
HREF="node1.html">Contents</A></B>
<BR>
<BR>
<DD><A HREF="node7.html#387">5.3</A>
| <A HREF="node8.html#578">6.9</A>
<DT><STRONG>< < <</STRONG>
-<DD><A HREF="node10.html#1429">8.1</A>
+<DD><A HREF="node10.html#1443">8.1</A>
<DT><STRONG>=</STRONG>
<DD><A HREF="node5.html#146">3.2.1</A>
<DT><STRONG>?</STRONG>
<DT><STRONG>{ }</STRONG>
<DD><A HREF="node8.html#593">6.11</A>
<DT><STRONG>addr_to_node</STRONG>
-<DD><A HREF="node11.html#1358">9.10.1</A>
+<DD><A HREF="node11.html#1372">9.11.1</A>
<DT><STRONG>aggregates</STRONG>
<DD><A HREF="node10.html#630">8</A>
<DT><STRONG>arch</STRONG>
<DT><STRONG>avg</STRONG>
<DD><A HREF="node10.html#655">8.3.5</A>
<DT><STRONG>backtrace</STRONG>
-<DD><A HREF="node11.html#861">9.2.1</A>
+<DD><A HREF="node11.html#874">9.2.1</A>
<DT><STRONG>begin</STRONG>
<DD><A HREF="node6.html#336">4.5.1</A>
<DT><STRONG>binary</STRONG>
<DT><STRONG>built-in probes</STRONG>
<DD><A HREF="node6.html#249">4.2</A>
<DT><STRONG>caller</STRONG>
-<DD><A HREF="node11.html#867">9.2.2</A>
+<DD><A HREF="node11.html#880">9.2.2</A>
<DT><STRONG>caller_addr</STRONG>
-<DD><A HREF="node11.html#873">9.2.3</A>
+<DD><A HREF="node11.html#886">9.2.3</A>
<DT><STRONG>comments</STRONG>
<DD><A HREF="node7.html#389">5.4</A>
<DT><STRONG>comparison</STRONG>
<DT><STRONG>count</STRONG>
<DD><A HREF="node10.html#647">8.3.1</A>
<DT><STRONG>cpu</STRONG>
-<DD><A HREF="node11.html#879">9.2.4</A>
+<DD><A HREF="node11.html#892">9.2.4</A>
<DT><STRONG>ctime</STRONG>
-<DD><A HREF="node11.html#1231">9.7.1</A>
+<DD><A HREF="node11.html#1245">9.8.1</A>
<DT><STRONG>data types</STRONG>
<DD><A HREF="node7.html#366">5.2</A>
<DT><STRONG>delete</STRONG>
<DT><STRONG>dwarf probes</STRONG>
<DD><A HREF="node6.html#250">4.2</A>
<DT><STRONG>egid</STRONG>
-<DD><A HREF="node11.html#885">9.2.5</A>
+<DD><A HREF="node11.html#898">9.2.5</A>
<DT><STRONG>embedded C</STRONG>
<DD><A HREF="node5.html#195">3.5</A>
<DT><STRONG>end</STRONG>
<DT><STRONG>epilogue-style aliases</STRONG>
<DD><A HREF="node5.html#152">3.2.2</A>
<DT><STRONG>errno_str</STRONG>
-<DD><A HREF="node11.html#1242">9.7.2</A>
+<DD><A HREF="node11.html#1256">9.8.2</A>
<DT><STRONG>error</STRONG>
-<DD><A HREF="node11.html#687">9.1.1</A>
+<DD><A HREF="node11.html#700">9.1.1</A>
<DT><STRONG>euid</STRONG>
-<DD><A HREF="node11.html#891">9.2.6</A>
+<DD><A HREF="node11.html#904">9.2.6</A>
<DT><STRONG>example scripts</STRONG>
<DD><A HREF="node3.html#52">1.4</A>
<DT><STRONG>execname</STRONG>
-<DD><A HREF="node11.html#897">9.2.7</A>
+<DD><A HREF="node11.html#910">9.2.7</A>
<DT><STRONG>exit</STRONG>
-<DD><A HREF="node11.html#1364">9.10.2</A>
+<DD><A HREF="node11.html#1378">9.11.2</A>
<DT><STRONG>expression</STRONG>
<DD><A HREF="node8.html#539">6.4</A>
<DT><STRONG>expressions</STRONG>
<DD><A HREF="node8.html#551">6.6</A>
| <A HREF="node9.html#622">7.4</A>
<DT><STRONG>formatting</STRONG>
-<DD><A HREF="node11.html#1229">9.7</A>
+<DD><A HREF="node11.html#1243">9.8</A>
<DT><STRONG>get_cycles</STRONG>
-<DD><A HREF="node11.html#1327">9.9.1</A>
+<DD><A HREF="node11.html#1341">9.10.1</A>
<DT><STRONG>gettimeofday_ s</STRONG>
-<DD><A HREF="node11.html#1345">9.9.4</A>
+<DD><A HREF="node11.html#1359">9.10.4</A>
<DT><STRONG>gettimeofday_ms</STRONG>
-<DD><A HREF="node11.html#1333">9.9.2</A>
+<DD><A HREF="node11.html#1347">9.10.2</A>
<DT><STRONG>gettimeofday_ns</STRONG>
-<DD><A HREF="node11.html#1339">9.9.3</A>
+<DD><A HREF="node11.html#1353">9.10.3</A>
<DT><STRONG>gettimeofday_us</STRONG>
-<DD><A HREF="node11.html#1351">9.9.5</A>
+<DD><A HREF="node11.html#1365">9.10.5</A>
<DT><STRONG>gid</STRONG>
-<DD><A HREF="node11.html#903">9.2.8</A>
+<DD><A HREF="node11.html#916">9.2.8</A>
<DT><STRONG>grouping</STRONG>
<DD><A HREF="node7.html#426">5.6.8</A>
<DT><STRONG>guru mode</STRONG>
<DT><STRONG>hist_linear</STRONG>
<DD><A HREF="node10.html#659">8.4.1</A>
<DT><STRONG>hist_log</STRONG>
-<DD><A HREF="node10.html#674">8.4.2</A>
+<DD><A HREF="node10.html#685">8.4.2</A>
<DT><STRONG>histograms</STRONG>
<DD><A HREF="node10.html#657">8.4</A>
<DT><STRONG>identifiers</STRONG>
<DT><STRONG>integers</STRONG>
<DD><A HREF="node7.html#376">5.2.3</A>
<DT><STRONG>is_return</STRONG>
-<DD><A HREF="node11.html#909">9.2.9</A>
+<DD><A HREF="node11.html#922">9.2.9</A>
<DT><STRONG>isinstr</STRONG>
-<DD><A HREF="node11.html#1280">9.8.1</A>
+<DD><A HREF="node11.html#1294">9.9.1</A>
<DT><STRONG>jiffies</STRONG>
<DD><A HREF="node6.html#304">4.3</A>
<DT><STRONG>kernel version</STRONG>
<DT><STRONG>kernel.statement</STRONG>
<DD><A HREF="node6.html#291">4.2.2</A>
<DT><STRONG>kernel_string</STRONG>
-<DD><A HREF="node11.html#1097">9.3.1</A>
+<DD><A HREF="node11.html#1111">9.4.1</A>
<DT><STRONG>kernel_v</STRONG>
<DD><A HREF="node7.html#477">5.8.2</A>
<DT><STRONG>kernel_vr</STRONG>
<DT><STRONG>local arrays</STRONG>
<DD><A HREF="node5.html#168">3.3</A>
<DT><STRONG>log</STRONG>
-<DD><A HREF="node11.html#694">9.1.2</A>
+<DD><A HREF="node11.html#707">9.1.2</A>
<DT><STRONG>max</STRONG>
<DD><A HREF="node10.html#653">8.3.4</A>
<DT><STRONG>milliseconds</STRONG>
<DT><STRONG>numeric</STRONG>
<DD><A HREF="node7.html#408">5.6.3</A>
<DT><STRONG>pexecname</STRONG>
-<DD><A HREF="node11.html#916">9.2.10</A>
+<DD><A HREF="node11.html#929">9.2.10</A>
<DT><STRONG>pid</STRONG>
-<DD><A HREF="node11.html#922">9.2.11</A>
+<DD><A HREF="node11.html#935">9.2.11</A>
<DT><STRONG>pointer</STRONG>
<DD><A HREF="node7.html#432">5.6.10</A>
<DT><STRONG>pp</STRONG>
-<DD><A HREF="node11.html#1211">9.6.1</A>
+<DD><A HREF="node11.html#1225">9.7.1</A>
<DT><STRONG>ppid</STRONG>
-<DD><A HREF="node11.html#928">9.2.12</A>
+<DD><A HREF="node11.html#941">9.2.12</A>
<DT><STRONG>prefixes</STRONG>
<DD><A HREF="node6.html#228">4.1.1</A>
<DT><STRONG>print</STRONG>
-<DD><A HREF="node11.html#701">9.1.3</A>
+<DD><A HREF="node11.html#714">9.1.3</A>
<DT><STRONG>print_backtrace</STRONG>
-<DD><A HREF="node11.html#946">9.2.15</A>
+<DD><A HREF="node11.html#959">9.2.15</A>
<DT><STRONG>print_regs</STRONG>
-<DD><A HREF="node11.html#953">9.2.16</A>
+<DD><A HREF="node11.html#966">9.2.16</A>
<DT><STRONG>print_stack</STRONG>
-<DD><A HREF="node11.html#959">9.2.17</A>
+<DD><A HREF="node11.html#972">9.2.17</A>
<DT><STRONG>printd</STRONG>
-<DD><A HREF="node11.html#806">9.1.5</A>
+<DD><A HREF="node11.html#819">9.1.5</A>
<DT><STRONG>printdln</STRONG>
-<DD><A HREF="node11.html#820">9.1.6</A>
+<DD><A HREF="node11.html#833">9.1.6</A>
<DT><STRONG>printf</STRONG>
-<DD><A HREF="node11.html#707">9.1.4</A>
+<DD><A HREF="node11.html#720">9.1.4</A>
<DT><STRONG>println</STRONG>
-<DD><A HREF="node11.html#827">9.1.7</A>
+<DD><A HREF="node11.html#840">9.1.7</A>
<DT><STRONG>probe aliases</STRONG>
<DD><A HREF="node5.html#125">3.2</A>
<DT><STRONG>probe points</STRONG>
<DT><STRONG>probe syntax</STRONG>
<DD><A HREF="node6.html#218">4.1</A>
<DT><STRONG>probefunc</STRONG>
-<DD><A HREF="node11.html#1217">9.6.2</A>
- | <A HREF="node11.html#1223">9.6.3</A>
+<DD><A HREF="node11.html#1231">9.7.2</A>
+ | <A HREF="node11.html#1237">9.7.3</A>
<DT><STRONG>prologue-style aliases</STRONG>
<DD><A HREF="node5.html#145">3.2.1</A>
<DT><STRONG>qs_done</STRONG>
-<DD><A HREF="node11.html#1144">9.4.3</A>
+<DD><A HREF="node11.html#1158">9.5.3</A>
<DT><STRONG>qs_run</STRONG>
-<DD><A HREF="node11.html#1138">9.4.2</A>
+<DD><A HREF="node11.html#1152">9.5.2</A>
<DT><STRONG>qs_wait</STRONG>
-<DD><A HREF="node11.html#1132">9.4.1</A>
+<DD><A HREF="node11.html#1146">9.5.1</A>
<DT><STRONG>qsq wait_queue_length</STRONG>
-<DD><A HREF="node11.html#1189">9.5.7</A>
+<DD><A HREF="node11.html#1203">9.6.7</A>
<DT><STRONG>qsq_blocked</STRONG>
-<DD><A HREF="node11.html#1151">9.5.1</A>
+<DD><A HREF="node11.html#1165">9.6.1</A>
<DT><STRONG>qsq_print</STRONG>
-<DD><A HREF="node11.html#1157">9.5.2</A>
+<DD><A HREF="node11.html#1171">9.6.2</A>
<DT><STRONG>qsq_service_time</STRONG>
-<DD><A HREF="node11.html#1165">9.5.3</A>
+<DD><A HREF="node11.html#1179">9.6.3</A>
<DT><STRONG>qsq_start</STRONG>
-<DD><A HREF="node11.html#1171">9.5.4</A>
+<DD><A HREF="node11.html#1185">9.6.4</A>
<DT><STRONG>qsq_throughput</STRONG>
-<DD><A HREF="node11.html#1177">9.5.5</A>
+<DD><A HREF="node11.html#1191">9.6.5</A>
<DT><STRONG>qsq_utilization</STRONG>
-<DD><A HREF="node11.html#1183">9.5.6</A>
+<DD><A HREF="node11.html#1197">9.6.6</A>
<DT><STRONG>qsq_wait_time</STRONG>
-<DD><A HREF="node11.html#1195">9.5.8</A>
+<DD><A HREF="node11.html#1209">9.6.8</A>
<DT><STRONG>queue statistics</STRONG>
-<DD><A HREF="node11.html#1130">9.4</A>
+<DD><A HREF="node11.html#1144">9.5</A>
<DT><STRONG>randomize</STRONG>
<DD><A HREF="node6.html#311">4.3</A>
<DT><STRONG>recursion</STRONG>
<DT><STRONG>return probes</STRONG>
<DD><A HREF="node6.html#328">4.4</A>
<DT><STRONG>returnstr</STRONG>
-<DD><A HREF="node11.html#1248">9.7.3</A>
+<DD><A HREF="node11.html#1262">9.8.3</A>
<DT><STRONG>sequence</STRONG>
<DD><A HREF="node6.html#346">4.5.3</A>
<DT><STRONG>sprint</STRONG>
-<DD><A HREF="node11.html#834">9.1.8</A>
+<DD><A HREF="node11.html#847">9.1.8</A>
<DT><STRONG>sprintf</STRONG>
-<DD><A HREF="node11.html#841">9.1.9</A>
+<DD><A HREF="node11.html#854">9.1.9</A>
<DT><STRONG>stack_size</STRONG>
-<DD><A HREF="node11.html#966">9.2.18</A>
+<DD><A HREF="node11.html#979">9.2.18</A>
<DT><STRONG>stack_unused</STRONG>
-<DD><A HREF="node11.html#972">9.2.19</A>
+<DD><A HREF="node11.html#985">9.2.19</A>
<DT><STRONG>stack_used</STRONG>
-<DD><A HREF="node11.html#978">9.2.20</A>
+<DD><A HREF="node11.html#991">9.2.20</A>
<DT><STRONG>stap</STRONG>
<DD><A HREF="node3.html#86">1.5</A>
<DT><STRONG>statement block</STRONG>
<DD><A HREF="node8.html#594">6.11</A>
<DT><STRONG>stp_pid</STRONG>
-<DD><A HREF="node11.html#984">9.2.21</A>
+<DD><A HREF="node11.html#997">9.2.21</A>
<DT><STRONG>string</STRONG>
-<DD><A HREF="node11.html#1278">9.8</A>
+<DD><A HREF="node11.html#1292">9.9</A>
<DT><STRONG>strings</STRONG>
<DD><A HREF="node7.html#379">5.2.4</A>
<DT><STRONG>strlen</STRONG>
-<DD><A HREF="node11.html#1286">9.8.2</A>
+<DD><A HREF="node11.html#1300">9.9.2</A>
<DT><STRONG>substr</STRONG>
-<DD><A HREF="node11.html#1297">9.8.4</A>
+<DD><A HREF="node11.html#1311">9.9.4</A>
<DT><STRONG>suffixes</STRONG>
<DD><A HREF="node6.html#233">4.1.2</A>
<DT><STRONG>sum</STRONG>
<DT><STRONG>synchronous</STRONG>
<DD><A HREF="node6.html#224">4.1</A>
<DT><STRONG>system</STRONG>
-<DD><A HREF="node11.html#848">9.1.10</A>
- | <A HREF="node11.html#1370">9.10.3</A>
+<DD><A HREF="node11.html#861">9.1.10</A>
+ | <A HREF="node11.html#1384">9.11.3</A>
<DT><STRONG>target</STRONG>
-<DD><A HREF="node11.html#990">9.2.22</A>
+<DD><A HREF="node11.html#1003">9.2.22</A>
<DT><STRONG>target variables</STRONG>
<DD><A HREF="node5.html#123">3.1</A>
<DT><STRONG>task_cpu</STRONG>
-<DD><A HREF="node11.html#1000">9.2.23</A>
+<DD><A HREF="node11.html#1014">9.3.1</A>
<DT><STRONG>task_current</STRONG>
-<DD><A HREF="node11.html#1006">9.2.24</A>
+<DD><A HREF="node11.html#1020">9.3.2</A>
<DT><STRONG>task_egid</STRONG>
-<DD><A HREF="node11.html#1013">9.2.25</A>
+<DD><A HREF="node11.html#1027">9.3.3</A>
<DT><STRONG>task_euid</STRONG>
-<DD><A HREF="node11.html#1025">9.2.27</A>
+<DD><A HREF="node11.html#1039">9.3.5</A>
<DT><STRONG>task_execname</STRONG>
-<DD><A HREF="node11.html#1019">9.2.26</A>
+<DD><A HREF="node11.html#1033">9.3.4</A>
<DT><STRONG>task_gid</STRONG>
-<DD><A HREF="node11.html#1031">9.2.28</A>
+<DD><A HREF="node11.html#1045">9.3.6</A>
<DT><STRONG>task_max_file_handles</STRONG>
-<DD><A HREF="node11.html#1090">9.2.37</A>
+<DD><A HREF="node11.html#1104">9.3.15</A>
<DT><STRONG>task_nice</STRONG>
-<DD><A HREF="node11.html#1037">9.2.29</A>
+<DD><A HREF="node11.html#1051">9.3.7</A>
<DT><STRONG>task_open_file_handles</STRONG>
-<DD><A HREF="node11.html#1084">9.2.36</A>
+<DD><A HREF="node11.html#1098">9.3.14</A>
<DT><STRONG>task_parent</STRONG>
-<DD><A HREF="node11.html#1043">9.2.30</A>
+<DD><A HREF="node11.html#1057">9.3.8</A>
<DT><STRONG>task_pid</STRONG>
-<DD><A HREF="node11.html#1050">9.2.31</A>
+<DD><A HREF="node11.html#1064">9.3.9</A>
<DT><STRONG>task_prio</STRONG>
-<DD><A HREF="node11.html#1056">9.2.32</A>
+<DD><A HREF="node11.html#1070">9.3.10</A>
<DT><STRONG>task_state</STRONG>
-<DD><A HREF="node11.html#1062">9.2.33</A>
+<DD><A HREF="node11.html#1076">9.3.11</A>
<DT><STRONG>task_tid</STRONG>
-<DD><A HREF="node11.html#1072">9.2.34</A>
+<DD><A HREF="node11.html#1086">9.3.12</A>
<DT><STRONG>task_uid</STRONG>
-<DD><A HREF="node11.html#1078">9.2.35</A>
+<DD><A HREF="node11.html#1092">9.3.13</A>
<DT><STRONG>text_str</STRONG>
-<DD><A HREF="node11.html#1306">9.8.5</A>
+<DD><A HREF="node11.html#1320">9.9.5</A>
<DT><STRONG>text_strn</STRONG>
-<DD><A HREF="node11.html#1312">9.8.6</A>
+<DD><A HREF="node11.html#1326">9.9.6</A>
<DT><STRONG>THIS</STRONG>
<DD><A HREF="node5.html#210">3.6</A>
<DT><STRONG>thread_indent</STRONG>
-<DD><A HREF="node11.html#1255">9.7.4</A>
+<DD><A HREF="node11.html#1269">9.8.4</A>
<DT><STRONG>thread_timestamp</STRONG>
-<DD><A HREF="node11.html#1271">9.7.5</A>
+<DD><A HREF="node11.html#1285">9.8.5</A>
<DT><STRONG>tid</STRONG>
-<DD><A HREF="node11.html#934">9.2.13</A>
+<DD><A HREF="node11.html#947">9.2.13</A>
<DT><STRONG>timer probes</STRONG>
<DD><A HREF="node6.html#303">4.3</A>
<DT><STRONG>timestamps</STRONG>
-<DD><A HREF="node11.html#1325">9.9</A>
+<DD><A HREF="node11.html#1339">9.10</A>
<DT><STRONG>tokens</STRONG>
<DD><A HREF="node7.html#496">5.8.4</A>
<DT><STRONG>uid</STRONG>
-<DD><A HREF="node11.html#940">9.2.14</A>
+<DD><A HREF="node11.html#953">9.2.14</A>
<DT><STRONG>unary</STRONG>
<DD><A HREF="node7.html#416">5.6.5</A>
<DT><STRONG>unused variables</STRONG>
<DD><A HREF="node5.html#164">3.2.4</A>
<DT><STRONG>user_string</STRONG>
-<DD><A HREF="node11.html#1103">9.3.2</A>
+<DD><A HREF="node11.html#1117">9.4.2</A>
<DT><STRONG>user_string2</STRONG>
-<DD><A HREF="node11.html#1110">9.3.3</A>
+<DD><A HREF="node11.html#1124">9.4.3</A>
<DT><STRONG>user_string_quoted</STRONG>
-<DD><A HREF="node11.html#1124">9.3.5</A>
+<DD><A HREF="node11.html#1138">9.4.5</A>
<DT><STRONG>user_string_warn</STRONG>
-<DD><A HREF="node11.html#1118">9.3.4</A>
+<DD><A HREF="node11.html#1132">9.4.4</A>
<DT><STRONG>variables</STRONG>
<DD><A HREF="node5.html#167">3.3</A>
<DT><STRONG>warn</STRONG>
-<DD><A HREF="node11.html#854">9.1.11</A>
+<DD><A HREF="node11.html#867">9.1.11</A>
<DT><STRONG>while</STRONG>
<DD><A HREF="node8.html#600">6.12</A>
<DT><STRONG>whitespace</STRONG>
<BODY >
<!--Navigation Panel-->
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next_g.png">
-<A NAME="tex2html670"
+<A NAME="tex2html673"
HREF="langref.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
-<A NAME="tex2html666"
+<A NAME="tex2html669"
HREF="node13.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
-<A NAME="tex2html672"
+<A NAME="tex2html675"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
-<A NAME="tex2html674"
+<A NAME="tex2html677"
HREF="node13.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A>
<BR>
-<B> Up:</B> <A NAME="tex2html671"
+<B> Up:</B> <A NAME="tex2html674"
HREF="langref.html">SystemTap Language Reference</A>
-<B> Previous:</B> <A NAME="tex2html667"
+<B> Previous:</B> <A NAME="tex2html670"
HREF="node13.html">Index</A>
- <B> <A NAME="tex2html673"
+ <B> <A NAME="tex2html676"
HREF="node1.html">Contents</A></B>
- <B> <A NAME="tex2html675"
+ <B> <A NAME="tex2html678"
HREF="node13.html">Index</A></B>
<BR>
<BR>
The command line arguments were: <BR>
<STRONG>latex2html</STRONG> <TT>-noaddress -show_section_numbers -local_icons -split 4 langref.tex -dir ../../htdocs/langref</TT>
<P>
-The translation was initiated by root on 2007-10-18
+The translation was initiated by root on 2007-10-28
<BR><HR>
</BODY>
<BODY >
<!--Navigation Panel-->
-<A NAME="tex2html318"
+<A NAME="tex2html320"
HREF="node3.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
-<A NAME="tex2html312"
+<A NAME="tex2html314"
HREF="langref.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
-<A NAME="tex2html306"
+<A NAME="tex2html308"
HREF="node1.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
-<A NAME="tex2html314"
+<A NAME="tex2html316"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
-<A NAME="tex2html316"
+<A NAME="tex2html318"
HREF="node13.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A>
<BR>
-<B> Next:</B> <A NAME="tex2html319"
+<B> Next:</B> <A NAME="tex2html321"
HREF="node3.html">1 SystemTap overview</A>
-<B> Up:</B> <A NAME="tex2html313"
+<B> Up:</B> <A NAME="tex2html315"
HREF="langref.html">SystemTap Language Reference</A>
-<B> Previous:</B> <A NAME="tex2html307"
+<B> Previous:</B> <A NAME="tex2html309"
HREF="node1.html">Contents</A>
- <B> <A NAME="tex2html315"
- HREF="node1.html">Contents</A></B>
<B> <A NAME="tex2html317"
+ HREF="node1.html">Contents</A></B>
+ <B> <A NAME="tex2html319"
HREF="node13.html">Index</A></B>
<BR>
<BR>
List of Tables</A>
</H2><UL>
<LI>1. <A NAME="tex2html4"
- HREF="node11.html#718">printf specifier values</A>
+ HREF="node11.html#731">printf specifier values</A>
<LI>2. <A NAME="tex2html5"
- HREF="node11.html#736">printf flag values</A>
+ HREF="node11.html#749">printf flag values</A>
<LI>3. <A NAME="tex2html6"
- HREF="node11.html#755">printf width values</A>
+ HREF="node11.html#768">printf width values</A>
<LI>4. <A NAME="tex2html7"
- HREF="node11.html#766">printf precision values</A></UL>
+ HREF="node11.html#779">printf precision values</A></UL>
<P>
<BR><HR>
<BODY >
<!--Navigation Panel-->
-<A NAME="tex2html332"
+<A NAME="tex2html334"
HREF="node4.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
-<A NAME="tex2html326"
+<A NAME="tex2html328"
HREF="langref.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
-<A NAME="tex2html320"
+<A NAME="tex2html322"
HREF="node2.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
-<A NAME="tex2html328"
+<A NAME="tex2html330"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
-<A NAME="tex2html330"
+<A NAME="tex2html332"
HREF="node13.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A>
<BR>
-<B> Next:</B> <A NAME="tex2html333"
+<B> Next:</B> <A NAME="tex2html335"
HREF="node4.html">2 Types of SystemTap</A>
-<B> Up:</B> <A NAME="tex2html327"
+<B> Up:</B> <A NAME="tex2html329"
HREF="langref.html">SystemTap Language Reference</A>
-<B> Previous:</B> <A NAME="tex2html321"
+<B> Previous:</B> <A NAME="tex2html323"
HREF="node2.html">List of Tables</A>
- <B> <A NAME="tex2html329"
- HREF="node1.html">Contents</A></B>
<B> <A NAME="tex2html331"
+ HREF="node1.html">Contents</A></B>
+ <B> <A NAME="tex2html333"
HREF="node13.html">Index</A></B>
<BR>
<BR>
<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></A>
<UL>
-<LI><A NAME="tex2html334"
+<LI><A NAME="tex2html336"
HREF="node3.html#SECTION00031000000000000000">1.1 About this guide</A>
-<LI><A NAME="tex2html335"
+<LI><A NAME="tex2html337"
HREF="node3.html#SECTION00032000000000000000">1.2 Reasons to use SystemTap</A>
-<LI><A NAME="tex2html336"
+<LI><A NAME="tex2html338"
HREF="node3.html#SECTION00033000000000000000">1.3 Event-action language</A>
-<LI><A NAME="tex2html337"
+<LI><A NAME="tex2html339"
HREF="node3.html#SECTION00034000000000000000">1.4 Sample SystemTap scripts</A>
<UL>
-<LI><A NAME="tex2html338"
+<LI><A NAME="tex2html340"
HREF="node3.html#SECTION00034100000000000000">1.4.1 Basic SystemTap syntax and control structures</A>
-<LI><A NAME="tex2html339"
+<LI><A NAME="tex2html341"
HREF="node3.html#SECTION00034200000000000000">1.4.2 Primes between 0 and 49</A>
-<LI><A NAME="tex2html340"
+<LI><A NAME="tex2html342"
HREF="node3.html#SECTION00034300000000000000">1.4.3 Recursive functions</A>
</UL>
<BR>
-<LI><A NAME="tex2html341"
+<LI><A NAME="tex2html343"
HREF="node3.html#SECTION00035000000000000000">1.5 The stap command</A>
-<LI><A NAME="tex2html342"
+<LI><A NAME="tex2html344"
HREF="node3.html#SECTION00036000000000000000">1.6 Safety and security</A>
</UL>
<!--End of Table of Child-Links-->
<P>
<HR>
<!--Navigation Panel-->
-<A NAME="tex2html332"
+<A NAME="tex2html334"
HREF="node4.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
-<A NAME="tex2html326"
+<A NAME="tex2html328"
HREF="langref.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
-<A NAME="tex2html320"
+<A NAME="tex2html322"
HREF="node2.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
-<A NAME="tex2html328"
+<A NAME="tex2html330"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
-<A NAME="tex2html330"
+<A NAME="tex2html332"
HREF="node13.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A>
<BR>
-<B> Next:</B> <A NAME="tex2html333"
+<B> Next:</B> <A NAME="tex2html335"
HREF="node4.html">2 Types of SystemTap</A>
-<B> Up:</B> <A NAME="tex2html327"
+<B> Up:</B> <A NAME="tex2html329"
HREF="langref.html">SystemTap Language Reference</A>
-<B> Previous:</B> <A NAME="tex2html321"
+<B> Previous:</B> <A NAME="tex2html323"
HREF="node2.html">List of Tables</A>
- <B> <A NAME="tex2html329"
- HREF="node1.html">Contents</A></B>
<B> <A NAME="tex2html331"
+ HREF="node1.html">Contents</A></B>
+ <B> <A NAME="tex2html333"
HREF="node13.html">Index</A></B>
<!--End of Navigation Panel-->
<BODY >
<!--Navigation Panel-->
-<A NAME="tex2html355"
+<A NAME="tex2html357"
HREF="node5.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
-<A NAME="tex2html349"
+<A NAME="tex2html351"
HREF="langref.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
-<A NAME="tex2html343"
+<A NAME="tex2html345"
HREF="node3.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
-<A NAME="tex2html351"
+<A NAME="tex2html353"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
-<A NAME="tex2html353"
+<A NAME="tex2html355"
HREF="node13.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A>
<BR>
-<B> Next:</B> <A NAME="tex2html356"
+<B> Next:</B> <A NAME="tex2html358"
HREF="node5.html">3 Components of a</A>
-<B> Up:</B> <A NAME="tex2html350"
+<B> Up:</B> <A NAME="tex2html352"
HREF="langref.html">SystemTap Language Reference</A>
-<B> Previous:</B> <A NAME="tex2html344"
+<B> Previous:</B> <A NAME="tex2html346"
HREF="node3.html">1 SystemTap overview</A>
- <B> <A NAME="tex2html352"
- HREF="node1.html">Contents</A></B>
<B> <A NAME="tex2html354"
+ HREF="node1.html">Contents</A></B>
+ <B> <A NAME="tex2html356"
HREF="node13.html">Index</A></B>
<BR>
<BR>
<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></A>
<UL>
-<LI><A NAME="tex2html357"
+<LI><A NAME="tex2html359"
HREF="node4.html#SECTION00041000000000000000">2.1 Probe scripts</A>
-<LI><A NAME="tex2html358"
+<LI><A NAME="tex2html360"
HREF="node4.html#SECTION00042000000000000000">2.2 Tapset scripts</A>
</UL>
<!--End of Table of Child-Links-->
<BODY >
<!--Navigation Panel-->
-<A NAME="tex2html371"
+<A NAME="tex2html373"
HREF="node6.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
-<A NAME="tex2html365"
+<A NAME="tex2html367"
HREF="langref.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
-<A NAME="tex2html359"
+<A NAME="tex2html361"
HREF="node4.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
-<A NAME="tex2html367"
+<A NAME="tex2html369"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
-<A NAME="tex2html369"
+<A NAME="tex2html371"
HREF="node13.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A>
<BR>
-<B> Next:</B> <A NAME="tex2html372"
+<B> Next:</B> <A NAME="tex2html374"
HREF="node6.html">4 Probe points</A>
-<B> Up:</B> <A NAME="tex2html366"
+<B> Up:</B> <A NAME="tex2html368"
HREF="langref.html">SystemTap Language Reference</A>
-<B> Previous:</B> <A NAME="tex2html360"
+<B> Previous:</B> <A NAME="tex2html362"
HREF="node4.html">2 Types of SystemTap</A>
- <B> <A NAME="tex2html368"
- HREF="node1.html">Contents</A></B>
<B> <A NAME="tex2html370"
+ HREF="node1.html">Contents</A></B>
+ <B> <A NAME="tex2html372"
HREF="node13.html">Index</A></B>
<BR>
<BR>
<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></A>
<UL>
-<LI><A NAME="tex2html373"
+<LI><A NAME="tex2html375"
HREF="node5.html#SECTION00051000000000000000">3.1 Probe definitions</A>
-<LI><A NAME="tex2html374"
+<LI><A NAME="tex2html376"
HREF="node5.html#SECTION00052000000000000000">3.2 Probe aliases</A>
<UL>
-<LI><A NAME="tex2html375"
+<LI><A NAME="tex2html377"
HREF="node5.html#SECTION00052100000000000000">3.2.1 Prologue-style aliases (=)</A>
-<LI><A NAME="tex2html376"
+<LI><A NAME="tex2html378"
HREF="node5.html#SECTION00052200000000000000">3.2.2 Epilogue-style aliases (+=)</A>
-<LI><A NAME="tex2html377"
+<LI><A NAME="tex2html379"
HREF="node5.html#SECTION00052300000000000000">3.2.3 Probe alias usage</A>
-<LI><A NAME="tex2html378"
+<LI><A NAME="tex2html380"
HREF="node5.html#SECTION00052400000000000000">3.2.4 Unused alias variables</A>
</UL>
<BR>
-<LI><A NAME="tex2html379"
+<LI><A NAME="tex2html381"
HREF="node5.html#SECTION00053000000000000000">3.3 Variables</A>
-<LI><A NAME="tex2html380"
+<LI><A NAME="tex2html382"
HREF="node5.html#SECTION00054000000000000000">3.4 Auxiliary functions</A>
-<LI><A NAME="tex2html381"
+<LI><A NAME="tex2html383"
HREF="node5.html#SECTION00055000000000000000">3.5 Embedded C</A>
-<LI><A NAME="tex2html382"
+<LI><A NAME="tex2html384"
HREF="node5.html#SECTION00056000000000000000">3.6 Embedded C functions</A>
</UL>
<!--End of Table of Child-Links-->
<P>
<HR>
<!--Navigation Panel-->
-<A NAME="tex2html371"
+<A NAME="tex2html373"
HREF="node6.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
-<A NAME="tex2html365"
+<A NAME="tex2html367"
HREF="langref.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
-<A NAME="tex2html359"
+<A NAME="tex2html361"
HREF="node4.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
-<A NAME="tex2html367"
+<A NAME="tex2html369"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
-<A NAME="tex2html369"
+<A NAME="tex2html371"
HREF="node13.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A>
<BR>
-<B> Next:</B> <A NAME="tex2html372"
+<B> Next:</B> <A NAME="tex2html374"
HREF="node6.html">4 Probe points</A>
-<B> Up:</B> <A NAME="tex2html366"
+<B> Up:</B> <A NAME="tex2html368"
HREF="langref.html">SystemTap Language Reference</A>
-<B> Previous:</B> <A NAME="tex2html360"
+<B> Previous:</B> <A NAME="tex2html362"
HREF="node4.html">2 Types of SystemTap</A>
- <B> <A NAME="tex2html368"
- HREF="node1.html">Contents</A></B>
<B> <A NAME="tex2html370"
+ HREF="node1.html">Contents</A></B>
+ <B> <A NAME="tex2html372"
HREF="node13.html">Index</A></B>
<!--End of Navigation Panel-->
<BODY >
<!--Navigation Panel-->
-<A NAME="tex2html395"
+<A NAME="tex2html397"
HREF="node7.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
-<A NAME="tex2html389"
+<A NAME="tex2html391"
HREF="langref.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
-<A NAME="tex2html383"
+<A NAME="tex2html385"
HREF="node5.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
-<A NAME="tex2html391"
+<A NAME="tex2html393"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
-<A NAME="tex2html393"
+<A NAME="tex2html395"
HREF="node13.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A>
<BR>
-<B> Next:</B> <A NAME="tex2html396"
+<B> Next:</B> <A NAME="tex2html398"
HREF="node7.html">5 Language elements</A>
-<B> Up:</B> <A NAME="tex2html390"
+<B> Up:</B> <A NAME="tex2html392"
HREF="langref.html">SystemTap Language Reference</A>
-<B> Previous:</B> <A NAME="tex2html384"
+<B> Previous:</B> <A NAME="tex2html386"
HREF="node5.html">3 Components of a</A>
- <B> <A NAME="tex2html392"
- HREF="node1.html">Contents</A></B>
<B> <A NAME="tex2html394"
+ HREF="node1.html">Contents</A></B>
+ <B> <A NAME="tex2html396"
HREF="node13.html">Index</A></B>
<BR>
<BR>
<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></A>
<UL>
-<LI><A NAME="tex2html397"
+<LI><A NAME="tex2html399"
HREF="node6.html#SECTION00061000000000000000">4.1 General syntax</A>
<UL>
-<LI><A NAME="tex2html398"
+<LI><A NAME="tex2html400"
HREF="node6.html#SECTION00061100000000000000">4.1.1 Prefixes</A>
-<LI><A NAME="tex2html399"
+<LI><A NAME="tex2html401"
HREF="node6.html#SECTION00061200000000000000">4.1.2 Suffixes</A>
-<LI><A NAME="tex2html400"
+<LI><A NAME="tex2html402"
HREF="node6.html#SECTION00061300000000000000">4.1.3 Wildcarded file names, function names</A>
-<LI><A NAME="tex2html401"
+<LI><A NAME="tex2html403"
HREF="node6.html#SECTION00061400000000000000">4.1.4 Optional probe points</A>
</UL>
<BR>
-<LI><A NAME="tex2html402"
+<LI><A NAME="tex2html404"
HREF="node6.html#SECTION00062000000000000000">4.2 Built-in probe point types (DWARF probes)</A>
<UL>
-<LI><A NAME="tex2html403"
+<LI><A NAME="tex2html405"
HREF="node6.html#SECTION00062100000000000000">4.2.1 kernel.function, module().function</A>
-<LI><A NAME="tex2html404"
+<LI><A NAME="tex2html406"
HREF="node6.html#SECTION00062200000000000000">4.2.2 kernel.statement, module().statement</A>
</UL>
<BR>
-<LI><A NAME="tex2html405"
+<LI><A NAME="tex2html407"
HREF="node6.html#SECTION00063000000000000000">4.3 Timer probes</A>
-<LI><A NAME="tex2html406"
+<LI><A NAME="tex2html408"
HREF="node6.html#SECTION00064000000000000000">4.4 Return probes</A>
-<LI><A NAME="tex2html407"
+<LI><A NAME="tex2html409"
HREF="node6.html#SECTION00065000000000000000">4.5 Special probe points</A>
<UL>
-<LI><A NAME="tex2html408"
+<LI><A NAME="tex2html410"
HREF="node6.html#SECTION00065100000000000000">4.5.1 begin</A>
-<LI><A NAME="tex2html409"
+<LI><A NAME="tex2html411"
HREF="node6.html#SECTION00065200000000000000">4.5.2 end</A>
-<LI><A NAME="tex2html410"
+<LI><A NAME="tex2html412"
HREF="node6.html#SECTION00065300000000000000">4.5.3 begin and end probe sequence</A>
-<LI><A NAME="tex2html411"
+<LI><A NAME="tex2html413"
HREF="node6.html#SECTION00065400000000000000">4.5.4 never</A>
</UL></UL>
<!--End of Table of Child-Links-->
<P>
<HR>
<!--Navigation Panel-->
-<A NAME="tex2html395"
+<A NAME="tex2html397"
HREF="node7.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
-<A NAME="tex2html389"
+<A NAME="tex2html391"
HREF="langref.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
-<A NAME="tex2html383"
+<A NAME="tex2html385"
HREF="node5.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
-<A NAME="tex2html391"
+<A NAME="tex2html393"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
-<A NAME="tex2html393"
+<A NAME="tex2html395"
HREF="node13.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A>
<BR>
-<B> Next:</B> <A NAME="tex2html396"
+<B> Next:</B> <A NAME="tex2html398"
HREF="node7.html">5 Language elements</A>
-<B> Up:</B> <A NAME="tex2html390"
+<B> Up:</B> <A NAME="tex2html392"
HREF="langref.html">SystemTap Language Reference</A>
-<B> Previous:</B> <A NAME="tex2html384"
+<B> Previous:</B> <A NAME="tex2html386"
HREF="node5.html">3 Components of a</A>
- <B> <A NAME="tex2html392"
- HREF="node1.html">Contents</A></B>
<B> <A NAME="tex2html394"
+ HREF="node1.html">Contents</A></B>
+ <B> <A NAME="tex2html396"
HREF="node13.html">Index</A></B>
<!--End of Navigation Panel-->
<BODY >
<!--Navigation Panel-->
-<A NAME="tex2html424"
+<A NAME="tex2html426"
HREF="node8.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
-<A NAME="tex2html418"
+<A NAME="tex2html420"
HREF="langref.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
-<A NAME="tex2html412"
+<A NAME="tex2html414"
HREF="node6.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
-<A NAME="tex2html420"
+<A NAME="tex2html422"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
-<A NAME="tex2html422"
+<A NAME="tex2html424"
HREF="node13.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A>
<BR>
-<B> Next:</B> <A NAME="tex2html425"
+<B> Next:</B> <A NAME="tex2html427"
HREF="node8.html">6 Statement types</A>
-<B> Up:</B> <A NAME="tex2html419"
+<B> Up:</B> <A NAME="tex2html421"
HREF="langref.html">SystemTap Language Reference</A>
-<B> Previous:</B> <A NAME="tex2html413"
+<B> Previous:</B> <A NAME="tex2html415"
HREF="node6.html">4 Probe points</A>
- <B> <A NAME="tex2html421"
- HREF="node1.html">Contents</A></B>
<B> <A NAME="tex2html423"
+ HREF="node1.html">Contents</A></B>
+ <B> <A NAME="tex2html425"
HREF="node13.html">Index</A></B>
<BR>
<BR>
<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></A>
<UL>
-<LI><A NAME="tex2html426"
+<LI><A NAME="tex2html428"
HREF="node7.html#SECTION00071000000000000000">5.1 Identifiers</A>
-<LI><A NAME="tex2html427"
+<LI><A NAME="tex2html429"
HREF="node7.html#SECTION00072000000000000000">5.2 Data types</A>
<UL>
-<LI><A NAME="tex2html428"
+<LI><A NAME="tex2html430"
HREF="node7.html#SECTION00072100000000000000">5.2.1 Numbers</A>
-<LI><A NAME="tex2html429"
+<LI><A NAME="tex2html431"
HREF="node7.html#SECTION00072200000000000000">5.2.2 Literals</A>
-<LI><A NAME="tex2html430"
+<LI><A NAME="tex2html432"
HREF="node7.html#SECTION00072300000000000000">5.2.3 Integers</A>
-<LI><A NAME="tex2html431"
+<LI><A NAME="tex2html433"
HREF="node7.html#SECTION00072400000000000000">5.2.4 Strings</A>
-<LI><A NAME="tex2html432"
+<LI><A NAME="tex2html434"
HREF="node7.html#SECTION00072500000000000000">5.2.5 Associative arrays</A>
-<LI><A NAME="tex2html433"
+<LI><A NAME="tex2html435"
HREF="node7.html#SECTION00072600000000000000">5.2.6 Statistics</A>
</UL>
<BR>
-<LI><A NAME="tex2html434"
+<LI><A NAME="tex2html436"
HREF="node7.html#SECTION00073000000000000000">5.3 Semicolons</A>
-<LI><A NAME="tex2html435"
+<LI><A NAME="tex2html437"
HREF="node7.html#SECTION00074000000000000000">5.4 Comments</A>
-<LI><A NAME="tex2html436"
+<LI><A NAME="tex2html438"
HREF="node7.html#SECTION00075000000000000000">5.5 Whitespace</A>
-<LI><A NAME="tex2html437"
+<LI><A NAME="tex2html439"
HREF="node7.html#SECTION00076000000000000000">5.6 Expressions</A>
<UL>
-<LI><A NAME="tex2html438"
+<LI><A NAME="tex2html440"
HREF="node7.html#SECTION00076100000000000000">5.6.1 Binary numeric operators</A>
-<LI><A NAME="tex2html439"
+<LI><A NAME="tex2html441"
HREF="node7.html#SECTION00076200000000000000">5.6.2 Binary string operators</A>
-<LI><A NAME="tex2html440"
+<LI><A NAME="tex2html442"
HREF="node7.html#SECTION00076300000000000000">5.6.3 Numeric assignment operators</A>
-<LI><A NAME="tex2html441"
+<LI><A NAME="tex2html443"
HREF="node7.html#SECTION00076400000000000000">5.6.4 String assignment operators</A>
-<LI><A NAME="tex2html442"
+<LI><A NAME="tex2html444"
HREF="node7.html#SECTION00076500000000000000">5.6.5 Unary numeric operators</A>
-<LI><A NAME="tex2html443"
+<LI><A NAME="tex2html445"
HREF="node7.html#SECTION00076600000000000000">5.6.6 Binary numeric or string comparison operators</A>
-<LI><A NAME="tex2html444"
+<LI><A NAME="tex2html446"
HREF="node7.html#SECTION00076700000000000000">5.6.7 Ternary operator</A>
-<LI><A NAME="tex2html445"
+<LI><A NAME="tex2html447"
HREF="node7.html#SECTION00076800000000000000">5.6.8 Grouping operator</A>
-<LI><A NAME="tex2html446"
+<LI><A NAME="tex2html448"
HREF="node7.html#SECTION00076900000000000000">5.6.9 Function call</A>
-<LI><A NAME="tex2html447"
+<LI><A NAME="tex2html449"
HREF="node7.html#SECTION000761000000000000000">5.6.10 $ptr->member</A>
-<LI><A NAME="tex2html448"
+<LI><A NAME="tex2html450"
HREF="node7.html#SECTION000761100000000000000">5.6.11 <value> in <array_name></A>
-<LI><A NAME="tex2html449"
+<LI><A NAME="tex2html451"
HREF="node7.html#SECTION000761200000000000000">5.6.12 [ <value>, ... ] in <array_name></A>
</UL>
<BR>
-<LI><A NAME="tex2html450"
+<LI><A NAME="tex2html452"
HREF="node7.html#SECTION00077000000000000000">5.7 Literals passed in from the stap command line</A>
<UL>
-<LI><A NAME="tex2html451"
+<LI><A NAME="tex2html453"
HREF="node7.html#SECTION00077100000000000000">5.7.1 $1 ... $<NN> for integers</A>
-<LI><A NAME="tex2html452"
+<LI><A NAME="tex2html454"
HREF="node7.html#SECTION00077200000000000000">5.7.2 @1 ... @<NN> for strings</A>
-<LI><A NAME="tex2html453"
+<LI><A NAME="tex2html455"
HREF="node7.html#SECTION00077300000000000000">5.7.3 Examples</A>
</UL>
<BR>
-<LI><A NAME="tex2html454"
+<LI><A NAME="tex2html456"
HREF="node7.html#SECTION00078000000000000000">5.8 Conditional compilation</A>
<UL>
-<LI><A NAME="tex2html455"
+<LI><A NAME="tex2html457"
HREF="node7.html#SECTION00078100000000000000">5.8.1 Conditions</A>
-<LI><A NAME="tex2html456"
+<LI><A NAME="tex2html458"
HREF="node7.html#SECTION00078200000000000000">5.8.2 Conditions based on kernel version: kernel_v, kernel_vr</A>
-<LI><A NAME="tex2html457"
+<LI><A NAME="tex2html459"
HREF="node7.html#SECTION00078300000000000000">5.8.3 Conditions based on architecture: arch</A>
-<LI><A NAME="tex2html458"
+<LI><A NAME="tex2html460"
HREF="node7.html#SECTION00078400000000000000">5.8.4 True and False Tokens</A>
</UL></UL>
<!--End of Table of Child-Links-->
<P>
<HR>
<!--Navigation Panel-->
-<A NAME="tex2html424"
+<A NAME="tex2html426"
HREF="node8.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
-<A NAME="tex2html418"
+<A NAME="tex2html420"
HREF="langref.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
-<A NAME="tex2html412"
+<A NAME="tex2html414"
HREF="node6.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
-<A NAME="tex2html420"
+<A NAME="tex2html422"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
-<A NAME="tex2html422"
+<A NAME="tex2html424"
HREF="node13.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A>
<BR>
-<B> Next:</B> <A NAME="tex2html425"
+<B> Next:</B> <A NAME="tex2html427"
HREF="node8.html">6 Statement types</A>
-<B> Up:</B> <A NAME="tex2html419"
+<B> Up:</B> <A NAME="tex2html421"
HREF="langref.html">SystemTap Language Reference</A>
-<B> Previous:</B> <A NAME="tex2html413"
+<B> Previous:</B> <A NAME="tex2html415"
HREF="node6.html">4 Probe points</A>
- <B> <A NAME="tex2html421"
- HREF="node1.html">Contents</A></B>
<B> <A NAME="tex2html423"
+ HREF="node1.html">Contents</A></B>
+ <B> <A NAME="tex2html425"
HREF="node13.html">Index</A></B>
<!--End of Navigation Panel-->
<BODY >
<!--Navigation Panel-->
-<A NAME="tex2html471"
+<A NAME="tex2html473"
HREF="node9.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
-<A NAME="tex2html465"
+<A NAME="tex2html467"
HREF="langref.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
-<A NAME="tex2html459"
+<A NAME="tex2html461"
HREF="node7.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
-<A NAME="tex2html467"
+<A NAME="tex2html469"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
-<A NAME="tex2html469"
+<A NAME="tex2html471"
HREF="node13.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A>
<BR>
-<B> Next:</B> <A NAME="tex2html472"
+<B> Next:</B> <A NAME="tex2html474"
HREF="node9.html">7 Associative arrays</A>
-<B> Up:</B> <A NAME="tex2html466"
+<B> Up:</B> <A NAME="tex2html468"
HREF="langref.html">SystemTap Language Reference</A>
-<B> Previous:</B> <A NAME="tex2html460"
+<B> Previous:</B> <A NAME="tex2html462"
HREF="node7.html">5 Language elements</A>
- <B> <A NAME="tex2html468"
- HREF="node1.html">Contents</A></B>
<B> <A NAME="tex2html470"
+ HREF="node1.html">Contents</A></B>
+ <B> <A NAME="tex2html472"
HREF="node13.html">Index</A></B>
<BR>
<BR>
<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></A>
<UL>
-<LI><A NAME="tex2html473"
+<LI><A NAME="tex2html475"
HREF="node8.html#SECTION00081000000000000000">6.1 break and continue</A>
-<LI><A NAME="tex2html474"
+<LI><A NAME="tex2html476"
HREF="node8.html#SECTION00082000000000000000">6.2 delete</A>
-<LI><A NAME="tex2html475"
+<LI><A NAME="tex2html477"
HREF="node8.html#SECTION00083000000000000000">6.3 do</A>
-<LI><A NAME="tex2html476"
+<LI><A NAME="tex2html478"
HREF="node8.html#SECTION00084000000000000000">6.4 EXP (expression)</A>
-<LI><A NAME="tex2html477"
+<LI><A NAME="tex2html479"
HREF="node8.html#SECTION00085000000000000000">6.5 for</A>
-<LI><A NAME="tex2html478"
+<LI><A NAME="tex2html480"
HREF="node8.html#SECTION00086000000000000000">6.6 foreach</A>
-<LI><A NAME="tex2html479"
+<LI><A NAME="tex2html481"
HREF="node8.html#SECTION00087000000000000000">6.7 if</A>
-<LI><A NAME="tex2html480"
+<LI><A NAME="tex2html482"
HREF="node8.html#SECTION00088000000000000000">6.8 next</A>
-<LI><A NAME="tex2html481"
+<LI><A NAME="tex2html483"
HREF="node8.html#SECTION00089000000000000000">6.9 ; (null statement)</A>
-<LI><A NAME="tex2html482"
+<LI><A NAME="tex2html484"
HREF="node8.html#SECTION000810000000000000000">6.10 return</A>
-<LI><A NAME="tex2html483"
+<LI><A NAME="tex2html485"
HREF="node8.html#SECTION000811000000000000000">6.11 { } (statement block)</A>
-<LI><A NAME="tex2html484"
+<LI><A NAME="tex2html486"
HREF="node8.html#SECTION000812000000000000000">6.12 while</A>
</UL>
<!--End of Table of Child-Links-->
<P>
<HR>
<!--Navigation Panel-->
-<A NAME="tex2html471"
+<A NAME="tex2html473"
HREF="node9.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
-<A NAME="tex2html465"
+<A NAME="tex2html467"
HREF="langref.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
-<A NAME="tex2html459"
+<A NAME="tex2html461"
HREF="node7.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
-<A NAME="tex2html467"
+<A NAME="tex2html469"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
-<A NAME="tex2html469"
+<A NAME="tex2html471"
HREF="node13.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A>
<BR>
-<B> Next:</B> <A NAME="tex2html472"
+<B> Next:</B> <A NAME="tex2html474"
HREF="node9.html">7 Associative arrays</A>
-<B> Up:</B> <A NAME="tex2html466"
+<B> Up:</B> <A NAME="tex2html468"
HREF="langref.html">SystemTap Language Reference</A>
-<B> Previous:</B> <A NAME="tex2html460"
+<B> Previous:</B> <A NAME="tex2html462"
HREF="node7.html">5 Language elements</A>
- <B> <A NAME="tex2html468"
- HREF="node1.html">Contents</A></B>
<B> <A NAME="tex2html470"
+ HREF="node1.html">Contents</A></B>
+ <B> <A NAME="tex2html472"
HREF="node13.html">Index</A></B>
<!--End of Navigation Panel-->
<BODY >
<!--Navigation Panel-->
-<A NAME="tex2html497"
+<A NAME="tex2html499"
HREF="node10.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
-<A NAME="tex2html491"
+<A NAME="tex2html493"
HREF="langref.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
-<A NAME="tex2html485"
+<A NAME="tex2html487"
HREF="node8.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
-<A NAME="tex2html493"
+<A NAME="tex2html495"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
-<A NAME="tex2html495"
+<A NAME="tex2html497"
HREF="node13.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A>
<BR>
-<B> Next:</B> <A NAME="tex2html498"
+<B> Next:</B> <A NAME="tex2html500"
HREF="node10.html">8 Statistics (aggregates)</A>
-<B> Up:</B> <A NAME="tex2html492"
+<B> Up:</B> <A NAME="tex2html494"
HREF="langref.html">SystemTap Language Reference</A>
-<B> Previous:</B> <A NAME="tex2html486"
+<B> Previous:</B> <A NAME="tex2html488"
HREF="node8.html">6 Statement types</A>
- <B> <A NAME="tex2html494"
- HREF="node1.html">Contents</A></B>
<B> <A NAME="tex2html496"
+ HREF="node1.html">Contents</A></B>
+ <B> <A NAME="tex2html498"
HREF="node13.html">Index</A></B>
<BR>
<BR>
<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></A>
<UL>
-<LI><A NAME="tex2html499"
+<LI><A NAME="tex2html501"
HREF="node9.html#SECTION00091000000000000000">7.1 Examples</A>
-<LI><A NAME="tex2html500"
+<LI><A NAME="tex2html502"
HREF="node9.html#SECTION00092000000000000000">7.2 Types of values</A>
-<LI><A NAME="tex2html501"
+<LI><A NAME="tex2html503"
HREF="node9.html#SECTION00093000000000000000">7.3 Array capacity</A>
-<LI><A NAME="tex2html502"
+<LI><A NAME="tex2html504"
HREF="node9.html#SECTION00094000000000000000">7.4 Iteration, foreach</A>
</UL>
<!--End of Table of Child-Links-->
<P>
<HR>
<!--Navigation Panel-->
-<A NAME="tex2html497"
+<A NAME="tex2html499"
HREF="node10.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
-<A NAME="tex2html491"
+<A NAME="tex2html493"
HREF="langref.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
-<A NAME="tex2html485"
+<A NAME="tex2html487"
HREF="node8.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
-<A NAME="tex2html493"
+<A NAME="tex2html495"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
-<A NAME="tex2html495"
+<A NAME="tex2html497"
HREF="node13.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A>
<BR>
-<B> Next:</B> <A NAME="tex2html498"
+<B> Next:</B> <A NAME="tex2html500"
HREF="node10.html">8 Statistics (aggregates)</A>
-<B> Up:</B> <A NAME="tex2html492"
+<B> Up:</B> <A NAME="tex2html494"
HREF="langref.html">SystemTap Language Reference</A>
-<B> Previous:</B> <A NAME="tex2html486"
+<B> Previous:</B> <A NAME="tex2html488"
HREF="node8.html">6 Statement types</A>
- <B> <A NAME="tex2html494"
- HREF="node1.html">Contents</A></B>
<B> <A NAME="tex2html496"
+ HREF="node1.html">Contents</A></B>
+ <B> <A NAME="tex2html498"
HREF="node13.html">Index</A></B>
<!--End of Navigation Panel-->