--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of ADDR_TO_NODE</TITLE>
+</HEAD><BODY>
+<H1>ADDR_TO_NODE</H1>
+Section: Memory Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+addr_to_node - Returns which node a given address belongs to within a NUMA system.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ addr_to_node:long(addr:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>addr</I>
+<DL COMPACT><DT><DD>
+The address of the faulting memory access.
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:52 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of ANSI_CLEAR_SCREEN</TITLE>
+</HEAD><BODY>
+<H1>ANSI_CLEAR_SCREEN</H1>
+Section: Utility functions for using an (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+ansi_clear_screen - Move cursor to top left and clear screen.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ ansi_clear_screen()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Sends ansi code for moving cursor to top left and then the ansi code for clearing the screen from the cursor position to the end.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:52 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of ANSI_CURSOR_HIDE</TITLE>
+</HEAD><BODY>
+<H1>ANSI_CURSOR_HIDE</H1>
+Section: Utility functions for using an (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+ansi_cursor_hide - Hides the cursor.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ ansi_cursor_hide()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Sends ansi code for hiding the cursor.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:52 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of ANSI_CURSOR_MOVE</TITLE>
+</HEAD><BODY>
+<H1>ANSI_CURSOR_MOVE</H1>
+Section: Utility functions for using an (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+ansi_cursor_move - Move cursor to new coordinates.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ ansi_cursor_move(x:long,y:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>x</I>
+<DL COMPACT><DT><DD>
+Row to move the cursor to.
+</DL>
+
+<P>
+
+<I>y</I>
+<DL COMPACT><DT><DD>
+Colomn to move the cursor to.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Sends ansi code for positioning the cursor at row x and column y. Coordinates start at one, (1,1) is the top-left corner.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:52 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of ANSI_CURSOR_RESTORE</TITLE>
+</HEAD><BODY>
+<H1>ANSI_CURSOR_RESTORE</H1>
+Section: Utility functions for using an (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+ansi_cursor_restore - Restores a previously saved cursor position.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ ansi_cursor_restore()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Sends ansi code for restoring the current cursor position previously saved with
+<B>ansi_cursor_save</B>.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:52 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of ANSI_CURSOR_SAVE</TITLE>
+</HEAD><BODY>
+<H1>ANSI_CURSOR_SAVE</H1>
+Section: Utility functions for using an (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+ansi_cursor_save - Saves the cursor position.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ ansi_cursor_save()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Sends ansi code for saving the current cursor position.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:52 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of ANSI_CURSOR_SHOW</TITLE>
+</HEAD><BODY>
+<H1>ANSI_CURSOR_SHOW</H1>
+Section: Utility functions for using an (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+ansi_cursor_show - Shows the cursor.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ ansi_cursor_show()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Sends ansi code for showing the cursor.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:52 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of ANSI_NEW_LINE</TITLE>
+</HEAD><BODY>
+<H1>ANSI_NEW_LINE</H1>
+Section: Utility functions for using an (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+ansi_new_line - Move cursor to new line.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ ansi_new_line()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Sends ansi code new line.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:52 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of ANSI_RESET_COLOR</TITLE>
+</HEAD><BODY>
+<H1>ANSI_RESET_COLOR</H1>
+Section: Utility functions for using an (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+ansi_reset_color - Resets Select Graphic Rendition mode.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ ansi_reset_color()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Sends ansi code to reset foreground, background and color attribute to default values.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:52 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of ANSI_SET_COLOR</TITLE>
+</HEAD><BODY>
+<H1>ANSI_SET_COLOR</H1>
+Section: Utility functions for using an (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+ansi_set_color - Set the ansi Select Graphic Rendition mode.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ ansi_set_color(fg:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>fg</I>
+<DL COMPACT><DT><DD>
+Foreground color to set.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Sends ansi code for Select Graphic Rendition mode for the given forground color. Black (30), Blue (34), Green (32), Cyan (36), Red (31), Purple (35), Brown (33), Light Gray (37).
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:52 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of ANSI_SET_COLOR2</TITLE>
+</HEAD><BODY>
+<H1>ANSI_SET_COLOR2</H1>
+Section: Utility functions for using an (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+ansi_set_color2 - Set the ansi Select Graphic Rendition mode.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ ansi_set_color2(fg:long,bg:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>fg</I>
+<DL COMPACT><DT><DD>
+Foreground color to set.
+</DL>
+
+<P>
+
+<I>bg</I>
+<DL COMPACT><DT><DD>
+Background color to set.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Sends ansi code for Select Graphic Rendition mode for the given forground color, Black (30), Blue (34), Green (32), Cyan (36), Red (31), Purple (35), Brown (33), Light Gray (37) and the given background color, Black (40), Red (41), Green (42), Yellow (43), Blue (44), Magenta (45), Cyan (46), White (47).
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:52 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of ANSI_SET_COLOR3</TITLE>
+</HEAD><BODY>
+<H1>ANSI_SET_COLOR3</H1>
+Section: Utility functions for using an (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+ansi_set_color3 - Set the ansi Select Graphic Rendition mode.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ ansi_set_color3(fg:long,bg:long,attr:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>fg</I>
+<DL COMPACT><DT><DD>
+Foreground color to set.
+</DL>
+
+<P>
+
+<I>bg</I>
+<DL COMPACT><DT><DD>
+Background color to set.
+</DL>
+
+<P>
+
+<I>attr</I>
+<DL COMPACT><DT><DD>
+Color attribute to set.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Sends ansi code for Select Graphic Rendition mode for the given forground color, Black (30), Blue (34), Green (32), Cyan (36), Red (31), Purple (35), Brown (33), Light Gray (37), the given background color, Black (40), Red (41), Green (42), Yellow (43), Blue (44), Magenta (45), Cyan (46), White (47) and the color attribute All attributes off (0), Intensity Bold (1), Underline Single (4), Blink Slow (5), Blink Rapid (6), Image Negative (7).
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:52 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of BACKTRACE</TITLE>
+</HEAD><BODY>
+<H1>BACKTRACE</H1>
+Section: Context Functions (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+backtrace - Hex backtrace of current stack
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ backtrace:string()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+<P>
+
+Return a string of hex addresses that are a backtrace of the stack. Output may be truncated as per maximum string length.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:52 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of BYTES_TO_STRING</TITLE>
+</HEAD><BODY>
+<H1>BYTES_TO_STRING</H1>
+Section: Memory Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+bytes_to_string - Human readable string for given bytes.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ bytes_to_string:string(bytes:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>bytes</I>
+<DL COMPACT><DT><DD>
+Number of bytes to translate.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Returns a string representing the number of bytes (up to 1024 bytes), the number of kilobytes (when less than 1024K) postfixed by 'K', the number of megabytes (when less than 1024M) postfixed by 'M' or the number of gigabytes postfixed by 'G'. If representing K, M or G, and the number is amount is less than 100, it includes a '.' plus the remainer. The returned string will be 5 characters wide (padding with whitespace at the front) unless negative or representing more than 9999G bytes.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:52 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of CALLER</TITLE>
+</HEAD><BODY>
+<H1>CALLER</H1>
+Section: Context Functions (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+caller - Return name and address of calling function
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ caller:string()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+<P>
+
+Return the address and name of the calling function.
+<A NAME="lbAF"> </A>
+<H2>THIS IS EQUIVALENT TO CALLING</H2>
+
+<P>
+
+sprintf(lq<B>s</B> 0x<B>x</B>rq, symname(<B>caller_addr</B>,
+<B>caller_addr</B>)) Works only for return probes at this time.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+<DT><A HREF="#lbAF">THIS IS EQUIVALENT TO CALLING</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:52 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of CALLER_ADDR</TITLE>
+</HEAD><BODY>
+<H1>CALLER_ADDR</H1>
+Section: Context Functions (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+caller_addr - Return caller address
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ caller_addr:long()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+<P>
+
+Return the address of the calling function. Works only for return probes at this time.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:52 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of CPU</TITLE>
+</HEAD><BODY>
+<H1>CPU</H1>
+Section: Context Functions (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+cpu - Returns the current cpu number.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ cpu:long()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:52 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of CPUTIME_TO_MSECS</TITLE>
+</HEAD><BODY>
+<H1>CPUTIME_TO_MSECS</H1>
+Section: Task Time Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+cputime_to_msecs - Translates the given cputime into milliseconds.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ cputime_to_msecs:long(cputime:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>cputime</I>
+<DL COMPACT><DT><DD>
+Time to convert to milliseconds.
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:52 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of CPUTIME_TO_STRING</TITLE>
+</HEAD><BODY>
+<H1>CPUTIME_TO_STRING</H1>
+Section: Task Time Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+cputime_to_string - Human readable string for given cputime.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ cputime_to_string:string(cputime:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>cputime</I>
+<DL COMPACT><DT><DD>
+Time to translate.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Equivalent to calling: msec_to_string (cputime_to_msecs (cputime).
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of CTIME</TITLE>
+</HEAD><BODY>
+<H1>CTIME</H1>
+Section: Time string utility function (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+ctime - Convert seconds since epoch into human readable date/time string.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ ctime:string(epochsecs:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>epochsecs</I>
+<DL COMPACT><DT><DD>
+Number of seconds since epoch (as returned by
+<B>gettimeofday_s</B>).
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Takes an argument of seconds since the epoch as returned by
+<B>gettimeofday_s</B>. Returns a string of the form
+<P>
+
+<P>
+lqWed Jun 30 21:49:08 1993rq
+<P>
+
+The string will always be exactly 24 characters. If the time would be unreasonable far in the past (before what can be represented with a 32 bit offset in seconds from the epoch) the returned string will be
+lqa long, long time ago...rq. If the time would be unreasonable far in the future the returned string will be
+lqfar far in the future...rq
+(both these strings are also 24 characters wide).
+<P>
+
+Note that the epoch (zero) corresponds to
+<P>
+
+<P>
+lqThu Jan 1 00:00:00 1970rq
+<P>
+
+The earliest full date given by ctime, corresponding to epochsecs -2147483648 is
+lqFri Dec 13 20:45:52 1901rq. The latest full date given by ctime, corresponding to epochsecs 2147483647 is
+lqTue Jan 19 03:14:07 2038rq.
+<P>
+
+The abbreviations for the days of the week are oqSuncq, oqMoncq, oqTuecq, oqWedcq, oqThucq, oqFricq, and oqSatcq. The abbreviations for the months are oqJancq, oqFebcq, oqMarcq, oqAprcq, oqMaycq, oqJuncq, oqJulcq, oqAugcq, oqSepcq, oqOctcq, oqNovcq, and oqDeccq.
+<P>
+
+Note that the real C library
+<B>ctime</B>
+function puts a newline ('\n') character at the end of the string that this function does not. Also note that since the kernel has no concept of timezones, the returned time is always in GMT.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of D_NAME</TITLE>
+</HEAD><BODY>
+<H1>D_NAME</H1>
+Section: Directory-entry (dentry) Tapse (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+d_name - get the dirent name
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ d_name:string(dentry:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>dentry</I>
+<DL COMPACT><DT><DD>
+Pointer to dentry.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+<P>
+
+Returns the dirent name (path basename).
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of D_PATH</TITLE>
+</HEAD><BODY>
+<H1>D_PATH</H1>
+Section: Directory-entry (dentry) Tapse (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+d_path - get the full nameidata path
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ d_path:string(nd:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>nd</I>
+<DL COMPACT><DT><DD>
+Pointer to nameidata.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+<P>
+
+Returns the full dirent name (full path to the root), like the kernel d_path function.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of EGID</TITLE>
+</HEAD><BODY>
+<H1>EGID</H1>
+Section: Context Functions (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+egid - Returns the effective gid of a target process.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ egid:long()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of ERROR</TITLE>
+</HEAD><BODY>
+<H1>ERROR</H1>
+Section: Logging Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+error - Send an error message.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ error(msg:string)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>msg</I>
+<DL COMPACT><DT><DD>
+The formatted message string.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+An implicit end-of-line is added. staprun prepends the string
+lqERROR:rq. Sending an error message aborts the currently running probe. Depending on the MAXERRORS parameter, it may trigger an
+<B>exit</B>.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of EUID</TITLE>
+</HEAD><BODY>
+<H1>EUID</H1>
+Section: Context Functions (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+euid - Return the effective uid of a target process.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ euid:long()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of EXECNAME</TITLE>
+</HEAD><BODY>
+<H1>EXECNAME</H1>
+Section: Context Functions (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+execname - Returns the execname of a target process (or group of processes).
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ execname:string()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of EXIT</TITLE>
+</HEAD><BODY>
+<H1>EXIT</H1>
+Section: Logging Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+exit - Start shutting down probing script.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ exit()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+This only enqueues a request to start shutting down the script. New probes will not fire (except
+lqendrq
+probes), but all currently running ones may complete their work.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of FTRACE</TITLE>
+</HEAD><BODY>
+<H1>FTRACE</H1>
+Section: Logging Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+ftrace - Send a message to the ftrace ring-buffer (or else printk).
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ ftrace(msg:string)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>msg</I>
+<DL COMPACT><DT><DD>
+The formatted message string.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+If the ftrace ring-buffer is configured & available, see /debugfs/tracing/trace for the message. Otherwise, the message may be quietly dropped. An implicit end-of-line is added.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of GET_CYCLES</TITLE>
+</HEAD><BODY>
+<H1>GET_CYCLES</H1>
+Section: Timestamp Functions (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+get_cycles - Processor cycle count.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ get_cycles:long()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+<P>
+
+Return the processor cycle counter value, or 0 if unavailable.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of GID</TITLE>
+</HEAD><BODY>
+<H1>GID</H1>
+Section: Context Functions (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+gid - Returns the group ID of a target process.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ gid:long()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+<html><head><title>systemtap man page index</title></head><body><ul>
+<li><a href="stap.1.html">stap.1</a></li>
+<li><a href="addr_to_node.3stap.html">addr_to_node.3stap</a></li>
+<li><a href="ansi_clear_screen.3stap.html">ansi_clear_screen.3stap</a></li>
+<li><a href="ansi_cursor_hide.3stap.html">ansi_cursor_hide.3stap</a></li>
+<li><a href="ansi_cursor_move.3stap.html">ansi_cursor_move.3stap</a></li>
+<li><a href="ansi_cursor_restore.3stap.html">ansi_cursor_restore.3stap</a></li>
+<li><a href="ansi_cursor_save.3stap.html">ansi_cursor_save.3stap</a></li>
+<li><a href="ansi_cursor_show.3stap.html">ansi_cursor_show.3stap</a></li>
+<li><a href="ansi_new_line.3stap.html">ansi_new_line.3stap</a></li>
+<li><a href="ansi_reset_color.3stap.html">ansi_reset_color.3stap</a></li>
+<li><a href="ansi_set_color2.3stap.html">ansi_set_color2.3stap</a></li>
+<li><a href="ansi_set_color3.3stap.html">ansi_set_color3.3stap</a></li>
+<li><a href="ansi_set_color.3stap.html">ansi_set_color.3stap</a></li>
+<li><a href="backtrace.3stap.html">backtrace.3stap</a></li>
+<li><a href="bytes_to_string.3stap.html">bytes_to_string.3stap</a></li>
+<li><a href="caller.3stap.html">caller.3stap</a></li>
+<li><a href="caller_addr.3stap.html">caller_addr.3stap</a></li>
+<li><a href="cpu.3stap.html">cpu.3stap</a></li>
+<li><a href="cputime_to_msecs.3stap.html">cputime_to_msecs.3stap</a></li>
+<li><a href="cputime_to_string.3stap.html">cputime_to_string.3stap</a></li>
+<li><a href="ctime.3stap.html">ctime.3stap</a></li>
+<li><a href="d_name.3stap.html">d_name.3stap</a></li>
+<li><a href="d_path.3stap.html">d_path.3stap</a></li>
+<li><a href="egid.3stap.html">egid.3stap</a></li>
+<li><a href="error.3stap.html">error.3stap</a></li>
+<li><a href="euid.3stap.html">euid.3stap</a></li>
+<li><a href="execname.3stap.html">execname.3stap</a></li>
+<li><a href="exit.3stap.html">exit.3stap</a></li>
+<li><a href="ftrace.3stap.html">ftrace.3stap</a></li>
+<li><a href="get_cycles.3stap.html">get_cycles.3stap</a></li>
+<li><a href="gid.3stap.html">gid.3stap</a></li>
+<li><a href="ioscheduler.elv_add_request.3stap.html">ioscheduler.elv_add_request.3stap</a></li>
+<li><a href="ioscheduler.elv_completed_request.3stap.html">ioscheduler.elv_completed_request.3stap</a></li>
+<li><a href="ioscheduler.elv_next_request.3stap.html">ioscheduler.elv_next_request.3stap</a></li>
+<li><a href="ioscheduler.elv_next_request.return.3stap.html">ioscheduler.elv_next_request.return.3stap</a></li>
+<li><a href="ip_ntop.3stap.html">ip_ntop.3stap</a></li>
+<li><a href="is_myproc.3stap.html">is_myproc.3stap</a></li>
+<li><a href="is_return.3stap.html">is_return.3stap</a></li>
+<li><a href="kernel_char.3stap.html">kernel_char.3stap</a></li>
+<li><a href="kernel_int.3stap.html">kernel_int.3stap</a></li>
+<li><a href="kernel_long.3stap.html">kernel_long.3stap</a></li>
+<li><a href="kernel_short.3stap.html">kernel_short.3stap</a></li>
+<li><a href="kernel_string.3stap.html">kernel_string.3stap</a></li>
+<li><a href="kernel_string_n.3stap.html">kernel_string_n.3stap</a></li>
+<li><a href="kprocess.create.3stap.html">kprocess.create.3stap</a></li>
+<li><a href="kprocess.exec.3stap.html">kprocess.exec.3stap</a></li>
+<li><a href="kprocess.exec_complete.3stap.html">kprocess.exec_complete.3stap</a></li>
+<li><a href="kprocess.exit.3stap.html">kprocess.exit.3stap</a></li>
+<li><a href="kprocess.release.3stap.html">kprocess.release.3stap</a></li>
+<li><a href="kprocess.start.3stap.html">kprocess.start.3stap</a></li>
+<li><a href="log.3stap.html">log.3stap</a></li>
+<li><a href="mem_page_size.3stap.html">mem_page_size.3stap</a></li>
+<li><a href="modname.3stap.html">modname.3stap</a></li>
+<li><a href="msecs_to_string.3stap.html">msecs_to_string.3stap</a></li>
+<li><a href="netdev.change_mac.3stap.html">netdev.change_mac.3stap</a></li>
+<li><a href="netdev.change_mtu.3stap.html">netdev.change_mtu.3stap</a></li>
+<li><a href="netdev.change_rx_flag.3stap.html">netdev.change_rx_flag.3stap</a></li>
+<li><a href="netdev.close.3stap.html">netdev.close.3stap</a></li>
+<li><a href="netdev.get_stats.3stap.html">netdev.get_stats.3stap</a></li>
+<li><a href="netdev.hard_transmit.3stap.html">netdev.hard_transmit.3stap</a></li>
+<li><a href="netdev.ioctl.3stap.html">netdev.ioctl.3stap</a></li>
+<li><a href="netdev.open.3stap.html">netdev.open.3stap</a></li>
+<li><a href="netdev.receive.3stap.html">netdev.receive.3stap</a></li>
+<li><a href="netdev.register.3stap.html">netdev.register.3stap</a></li>
+<li><a href="netdev.rx.3stap.html">netdev.rx.3stap</a></li>
+<li><a href="netdev.set_promiscuity.3stap.html">netdev.set_promiscuity.3stap</a></li>
+<li><a href="netdev.transmit.3stap.html">netdev.transmit.3stap</a></li>
+<li><a href="netdev.unregister.3stap.html">netdev.unregister.3stap</a></li>
+<li><a href="pages_to_string.3stap.html">pages_to_string.3stap</a></li>
+<li><a href="pexecname.3stap.html">pexecname.3stap</a></li>
+<li><a href="pgrp.3stap.html">pgrp.3stap</a></li>
+<li><a href="pid.3stap.html">pid.3stap</a></li>
+<li><a href="pp.3stap.html">pp.3stap</a></li>
+<li><a href="ppid.3stap.html">ppid.3stap</a></li>
+<li><a href="print_backtrace.3stap.html">print_backtrace.3stap</a></li>
+<li><a href="print_regs.3stap.html">print_regs.3stap</a></li>
+<li><a href="print_stack.3stap.html">print_stack.3stap</a></li>
+<li><a href="print_ubacktrace.3stap.html">print_ubacktrace.3stap</a></li>
+<li><a href="print_ustack.3stap.html">print_ustack.3stap</a></li>
+<li><a href="probefunc.3stap.html">probefunc.3stap</a></li>
+<li><a href="probemod.3stap.html">probemod.3stap</a></li>
+<li><a href="proc_mem_data.3stap.html">proc_mem_data.3stap</a></li>
+<li><a href="proc_mem_rss.3stap.html">proc_mem_rss.3stap</a></li>
+<li><a href="proc_mem_shr.3stap.html">proc_mem_shr.3stap</a></li>
+<li><a href="proc_mem_size.3stap.html">proc_mem_size.3stap</a></li>
+<li><a href="proc_mem_string.3stap.html">proc_mem_string.3stap</a></li>
+<li><a href="proc_mem_txt.3stap.html">proc_mem_txt.3stap</a></li>
+<li><a href="randint.3stap.html">randint.3stap</a></li>
+<li><a href="registers_valid.3stap.html">registers_valid.3stap</a></li>
+<li><a href="reverse_path_walk.3stap.html">reverse_path_walk.3stap</a></li>
+<li><a href="scsi.iocompleted.3stap.html">scsi.iocompleted.3stap</a></li>
+<li><a href="scsi.iodispatching.3stap.html">scsi.iodispatching.3stap</a></li>
+<li><a href="scsi.iodone.3stap.html">scsi.iodone.3stap</a></li>
+<li><a href="scsi.ioentry.3stap.html">scsi.ioentry.3stap</a></li>
+<li><a href="sid.3stap.html">sid.3stap</a></li>
+<li><a href="signal.check_ignored.3stap.html">signal.check_ignored.3stap</a></li>
+<li><a href="signal.check_ignored.return.3stap.html">signal.check_ignored.return.3stap</a></li>
+<li><a href="signal.checkperm.3stap.html">signal.checkperm.3stap</a></li>
+<li><a href="signal.checkperm.return.3stap.html">signal.checkperm.return.3stap</a></li>
+<li><a href="signal.do_action.3stap.html">signal.do_action.3stap</a></li>
+<li><a href="signal.do_action.return.3stap.html">signal.do_action.return.3stap</a></li>
+<li><a href="signal.flush.3stap.html">signal.flush.3stap</a></li>
+<li><a href="signal.force_segv.3stap.html">signal.force_segv.3stap</a></li>
+<li><a href="signal.force_segv.return.3stap.html">signal.force_segv.return.3stap</a></li>
+<li><a href="signal.handle.3stap.html">signal.handle.3stap</a></li>
+<li><a href="signal.handle.return.3stap.html">signal.handle.return.3stap</a></li>
+<li><a href="signal.pending.3stap.html">signal.pending.3stap</a></li>
+<li><a href="signal.pending.return.3stap.html">signal.pending.return.3stap</a></li>
+<li><a href="signal.procmask.3stap.html">signal.procmask.3stap</a></li>
+<li><a href="signal.send.3stap.html">signal.send.3stap</a></li>
+<li><a href="signal.send.return.3stap.html">signal.send.return.3stap</a></li>
+<li><a href="signal.send_sig_queue.3stap.html">signal.send_sig_queue.3stap</a></li>
+<li><a href="signal.send_sig_queue.return.3stap.html">signal.send_sig_queue.return.3stap</a></li>
+<li><a href="signal.syskill.3stap.html">signal.syskill.3stap</a></li>
+<li><a href="signal.syskill.return.3stap.html">signal.syskill.return.3stap</a></li>
+<li><a href="signal.sys_tgkill.3stap.html">signal.sys_tgkill.3stap</a></li>
+<li><a href="signal.sys_tgkill.return.3stap.html">signal.sys_tgkill.return.3stap</a></li>
+<li><a href="signal.sys_tkill.3stap.html">signal.sys_tkill.3stap</a></li>
+<li><a href="signal.systkill.return.3stap.html">signal.systkill.return.3stap</a></li>
+<li><a href="signal.wakeup.3stap.html">signal.wakeup.3stap</a></li>
+<li><a href="socket.aio_read.3stap.html">socket.aio_read.3stap</a></li>
+<li><a href="socket.aio_read.return.3stap.html">socket.aio_read.return.3stap</a></li>
+<li><a href="socket.aio_write.3stap.html">socket.aio_write.3stap</a></li>
+<li><a href="socket.aio_write.return.3stap.html">socket.aio_write.return.3stap</a></li>
+<li><a href="socket.close.3stap.html">socket.close.3stap</a></li>
+<li><a href="socket.close.return.3stap.html">socket.close.return.3stap</a></li>
+<li><a href="socket.create.3stap.html">socket.create.3stap</a></li>
+<li><a href="socket.create.return.3stap.html">socket.create.return.3stap</a></li>
+<li><a href="socket.readv.3stap.html">socket.readv.3stap</a></li>
+<li><a href="socket.readv.return.3stap.html">socket.readv.return.3stap</a></li>
+<li><a href="socket.receive.3stap.html">socket.receive.3stap</a></li>
+<li><a href="socket.recvmsg.3stap.html">socket.recvmsg.3stap</a></li>
+<li><a href="socket.recvmsg.return.3stap.html">socket.recvmsg.return.3stap</a></li>
+<li><a href="socket.send.3stap.html">socket.send.3stap</a></li>
+<li><a href="socket.sendmsg.3stap.html">socket.sendmsg.3stap</a></li>
+<li><a href="socket.sendmsg.return.3stap.html">socket.sendmsg.return.3stap</a></li>
+<li><a href="socket.writev.3stap.html">socket.writev.3stap</a></li>
+<li><a href="socket.writev.return.3stap.html">socket.writev.return.3stap</a></li>
+<li><a href="sock_fam_num2str.3stap.html">sock_fam_num2str.3stap</a></li>
+<li><a href="sock_fam_str2num.3stap.html">sock_fam_str2num.3stap</a></li>
+<li><a href="sock_prot_num2str.3stap.html">sock_prot_num2str.3stap</a></li>
+<li><a href="sock_prot_str2num.3stap.html">sock_prot_str2num.3stap</a></li>
+<li><a href="sock_state_num2str.3stap.html">sock_state_num2str.3stap</a></li>
+<li><a href="sock_state_str2num.3stap.html">sock_state_str2num.3stap</a></li>
+<li><a href="stack_size.3stap.html">stack_size.3stap</a></li>
+<li><a href="stack_unused.3stap.html">stack_unused.3stap</a></li>
+<li><a href="stack_used.3stap.html">stack_used.3stap</a></li>
+<li><a href="stapex.3stap.html">stapex.3stap</a></li>
+<li><a href="stapfuncs.3stap.html">stapfuncs.3stap</a></li>
+<li><a href="stapprobes.3stap.html">stapprobes.3stap</a></li>
+<li><a href="stapprobes.iosched.3stap.html">stapprobes.iosched.3stap</a></li>
+<li><a href="stapprobes.kprocess.3stap.html">stapprobes.kprocess.3stap</a></li>
+<li><a href="stapprobes.netdev.3stap.html">stapprobes.netdev.3stap</a></li>
+<li><a href="stapprobes.nfs.3stap.html">stapprobes.nfs.3stap</a></li>
+<li><a href="stapprobes.nfsd.3stap.html">stapprobes.nfsd.3stap</a></li>
+<li><a href="stapprobes.pagefault.3stap.html">stapprobes.pagefault.3stap</a></li>
+<li><a href="stapprobes.rpc.3stap.html">stapprobes.rpc.3stap</a></li>
+<li><a href="stapprobes.scsi.3stap.html">stapprobes.scsi.3stap</a></li>
+<li><a href="stapprobes.signal.3stap.html">stapprobes.signal.3stap</a></li>
+<li><a href="stapprobes.socket.3stap.html">stapprobes.socket.3stap</a></li>
+<li><a href="stapprobes.tcp.3stap.html">stapprobes.tcp.3stap</a></li>
+<li><a href="stapprobes.udp.3stap.html">stapprobes.udp.3stap</a></li>
+<li><a href="stapvars.3stap.html">stapvars.3stap</a></li>
+<li><a href="symdata.3stap.html">symdata.3stap</a></li>
+<li><a href="symname.3stap.html">symname.3stap</a></li>
+<li><a href="target.3stap.html">target.3stap</a></li>
+<li><a href="task_backtrace.3stap.html">task_backtrace.3stap</a></li>
+<li><a href="task_stime.3stap.html">task_stime.3stap</a></li>
+<li><a href="task_time_string.3stap.html">task_time_string.3stap</a></li>
+<li><a href="task_utime.3stap.html">task_utime.3stap</a></li>
+<li><a href="tcp.disconnect.3stap.html">tcp.disconnect.3stap</a></li>
+<li><a href="tcp.disconnect.return.3stap.html">tcp.disconnect.return.3stap</a></li>
+<li><a href="tcp.receive.3stap.html">tcp.receive.3stap</a></li>
+<li><a href="tcp.recvmsg.3stap.html">tcp.recvmsg.3stap</a></li>
+<li><a href="tcp.recvmsg.return.3stap.html">tcp.recvmsg.return.3stap</a></li>
+<li><a href="tcp.sendmsg.3stap.html">tcp.sendmsg.3stap</a></li>
+<li><a href="tcp.sendmsg.return.3stap.html">tcp.sendmsg.return.3stap</a></li>
+<li><a href="tcp.setsockopt.3stap.html">tcp.setsockopt.3stap</a></li>
+<li><a href="tcp.setsockopt.return.3stap.html">tcp.setsockopt.return.3stap</a></li>
+<li><a href="tid.3stap.html">tid.3stap</a></li>
+<li><a href="tty.init.3stap.html">tty.init.3stap</a></li>
+<li><a href="tty.ioctl.3stap.html">tty.ioctl.3stap</a></li>
+<li><a href="tty.open.3stap.html">tty.open.3stap</a></li>
+<li><a href="tty.poll.3stap.html">tty.poll.3stap</a></li>
+<li><a href="tty.read.3stap.html">tty.read.3stap</a></li>
+<li><a href="tty.receive.3stap.html">tty.receive.3stap</a></li>
+<li><a href="tty.register.3stap.html">tty.register.3stap</a></li>
+<li><a href="tty.release.3stap.html">tty.release.3stap</a></li>
+<li><a href="tty.resize.3stap.html">tty.resize.3stap</a></li>
+<li><a href="tty.unregister.3stap.html">tty.unregister.3stap</a></li>
+<li><a href="tty.write.3stap.html">tty.write.3stap</a></li>
+<li><a href="uaddr.3stap.html">uaddr.3stap</a></li>
+<li><a href="ubacktrace.3stap.html">ubacktrace.3stap</a></li>
+<li><a href="udp.disconnect.3stap.html">udp.disconnect.3stap</a></li>
+<li><a href="udp.disconnect.return.3stap.html">udp.disconnect.return.3stap</a></li>
+<li><a href="udp.recvmsg.3stap.html">udp.recvmsg.3stap</a></li>
+<li><a href="udp.recvmsg.return.3stap.html">udp.recvmsg.return.3stap</a></li>
+<li><a href="udp.sendmsg.3stap.html">udp.sendmsg.3stap</a></li>
+<li><a href="udp.sendmsg.return.3stap.html">udp.sendmsg.return.3stap</a></li>
+<li><a href="uid.3stap.html">uid.3stap</a></li>
+<li><a href="user_char.3stap.html">user_char.3stap</a></li>
+<li><a href="user_char_warn.3stap.html">user_char_warn.3stap</a></li>
+<li><a href="user_int.3stap.html">user_int.3stap</a></li>
+<li><a href="user_int_warn.3stap.html">user_int_warn.3stap</a></li>
+<li><a href="user_long.3stap.html">user_long.3stap</a></li>
+<li><a href="user_long_warn.3stap.html">user_long_warn.3stap</a></li>
+<li><a href="user_mode.3stap.html">user_mode.3stap</a></li>
+<li><a href="user_short.3stap.html">user_short.3stap</a></li>
+<li><a href="user_short_warn.3stap.html">user_short_warn.3stap</a></li>
+<li><a href="user_string2.3stap.html">user_string2.3stap</a></li>
+<li><a href="user_string.3stap.html">user_string.3stap</a></li>
+<li><a href="user_string_n2.3stap.html">user_string_n2.3stap</a></li>
+<li><a href="user_string_n.3stap.html">user_string_n.3stap</a></li>
+<li><a href="user_string_n_quoted.3stap.html">user_string_n_quoted.3stap</a></li>
+<li><a href="user_string_n_warn.3stap.html">user_string_n_warn.3stap</a></li>
+<li><a href="user_string_quoted.3stap.html">user_string_quoted.3stap</a></li>
+<li><a href="user_string_warn.3stap.html">user_string_warn.3stap</a></li>
+<li><a href="usymdata.3stap.html">usymdata.3stap</a></li>
+<li><a href="usymname.3stap.html">usymname.3stap</a></li>
+<li><a href="vm.brk.3stap.html">vm.brk.3stap</a></li>
+<li><a href="vm_fault_contains.3stap.html">vm_fault_contains.3stap</a></li>
+<li><a href="vm.mmap.3stap.html">vm.mmap.3stap</a></li>
+<li><a href="vm.munmap.3stap.html">vm.munmap.3stap</a></li>
+<li><a href="vm.oom_kill.3stap.html">vm.oom_kill.3stap</a></li>
+<li><a href="vm.pagefault.3stap.html">vm.pagefault.3stap</a></li>
+<li><a href="vm.pagefault.return.3stap.html">vm.pagefault.return.3stap</a></li>
+<li><a href="vm.write_shared.3stap.html">vm.write_shared.3stap</a></li>
+<li><a href="vm.write_shared_copy.3stap.html">vm.write_shared_copy.3stap</a></li>
+<li><a href="warn.3stap.html">warn.3stap</a></li>
+<li><a href="staprun.8.html">staprun.8</a></li>
+<li><a href="stap-server.8.html">stap-server.8</a></li>
+</ul></body></html>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of IOSCHEDULER\&.ELV_AD</TITLE>
+</HEAD><BODY>
+<H1>IOSCHEDULER\&.ELV_AD</H1>
+Section: IO Scheduler Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+ioscheduler.elv_add_request - A request was added to the request queue
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ioscheduler.elv_add_request
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>req_flags</I>
+<DL COMPACT><DT><DD>
+Request flags
+</DL>
+
+<P>
+
+<I>req</I>
+<DL COMPACT><DT><DD>
+Address of the request
+</DL>
+
+<P>
+
+<I>disk_major</I>
+<DL COMPACT><DT><DD>
+Disk major number of the request
+</DL>
+
+<P>
+
+<I>elevator_name</I>
+<DL COMPACT><DT><DD>
+The type of I/O elevator currently enabled
+</DL>
+
+<P>
+
+<I>disk_minor</I>
+<DL COMPACT><DT><DD>
+Disk minor number of the request
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of IOSCHEDULER\&.ELV_CO</TITLE>
+</HEAD><BODY>
+<H1>IOSCHEDULER\&.ELV_CO</H1>
+Section: IO Scheduler Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+ioscheduler.elv_completed_request - Fires when a request is completed
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ioscheduler.elv_completed_request
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>req_flags</I>
+<DL COMPACT><DT><DD>
+Request flags
+</DL>
+
+<P>
+
+<I>req</I>
+<DL COMPACT><DT><DD>
+Address of the request
+</DL>
+
+<P>
+
+<I>disk_major</I>
+<DL COMPACT><DT><DD>
+Disk major number of the request
+</DL>
+
+<P>
+
+<I>elevator_name</I>
+<DL COMPACT><DT><DD>
+The type of I/O elevator currently enabled
+</DL>
+
+<P>
+
+<I>disk_minor</I>
+<DL COMPACT><DT><DD>
+Disk minor number of the request
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of IOSCHEDULER\&.ELV_NE</TITLE>
+</HEAD><BODY>
+<H1>IOSCHEDULER\&.ELV_NE</H1>
+Section: IO Scheduler Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+ioscheduler.elv_next_request - Fires when a request is retrieved from the request queue
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ioscheduler.elv_next_request
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>elevator_name</I>
+<DL COMPACT><DT><DD>
+The type of I/O elevator currently enabled
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of IOSCHEDULER\&.ELV_NE</TITLE>
+</HEAD><BODY>
+<H1>IOSCHEDULER\&.ELV_NE</H1>
+Section: IO Scheduler Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+ioscheduler.elv_next_request.return - Fires when a request retrieval issues a return signal
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ioscheduler.elv_next_request.return
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>req_flags</I>
+<DL COMPACT><DT><DD>
+Request flags
+</DL>
+
+<P>
+
+<I>req</I>
+<DL COMPACT><DT><DD>
+Address of the request
+</DL>
+
+<P>
+
+<I>disk_major</I>
+<DL COMPACT><DT><DD>
+Disk major number of the request
+</DL>
+
+<P>
+
+<I>disk_minor</I>
+<DL COMPACT><DT><DD>
+Disk minor number of the request
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of IP_NTOP</TITLE>
+</HEAD><BODY>
+<H1>IP_NTOP</H1>
+Section: Networking Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+ip_ntop - returns a string representation from an integer IP number
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ ip_ntop:string(addr:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>addr</I>
+<DL COMPACT><DT><DD>
+the ip represented as an integer
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of IS_MYPROC</TITLE>
+</HEAD><BODY>
+<H1>IS_MYPROC</H1>
+Section: Context Functions (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+is_myproc - Determines if the current probe point has occurred in the user's own process.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ is_myproc:long()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+<P>
+
+Return 1 if the current probe point has occurred in the user's own process.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of IS_RETURN</TITLE>
+</HEAD><BODY>
+<H1>IS_RETURN</H1>
+Section: Context Functions (3stap)<BR>Updated: September 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+is_return - Determines if probe point is a return probe.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ is_return:long()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+<P>
+
+Return 1 if the probe point is a return probe. <emphasis>Deprecated.</emphasis>
+<A NAME="lbAF"> </A>
+<H2>AUTHOR</H2>
+
+<P>
+
+<B>SystemTap</B>
+<DL COMPACT><DT><DD>
+Hackers
+</DL>
+
+<A NAME="lbAG"> </A>
+<H2>COPYRIGHT</H2>
+
+<BR>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+<DT><A HREF="#lbAF">AUTHOR</A><DD>
+<DT><A HREF="#lbAG">COPYRIGHT</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of KERNEL_CHAR</TITLE>
+</HEAD><BODY>
+<H1>KERNEL_CHAR</H1>
+Section: String and data retrieving fun (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+kernel_char - Retrieves a char value stored in kernel memory.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ kernel_char:long(addr:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>addr</I>
+<DL COMPACT><DT><DD>
+The kernel address to retrieve the char from.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Returns the char value from a given kernel memory address. Reports an error when reading from the given address fails.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of KERNEL_INT</TITLE>
+</HEAD><BODY>
+<H1>KERNEL_INT</H1>
+Section: String and data retrieving fun (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+kernel_int - Retrieves an int value stored in kernel memory.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ kernel_int:long(addr:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>addr</I>
+<DL COMPACT><DT><DD>
+The kernel address to retrieve the int from.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Returns the int value from a given kernel memory address. Reports an error when reading from the given address fails.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of KERNEL_LONG</TITLE>
+</HEAD><BODY>
+<H1>KERNEL_LONG</H1>
+Section: String and data retrieving fun (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+kernel_long - Retrieves a long value stored in kernel memory.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ kernel_long:long(addr:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>addr</I>
+<DL COMPACT><DT><DD>
+The kernel address to retrieve the long from.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Returns the long value from a given kernel memory address. Reports an error when reading from the given address fails.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of KERNEL_SHORT</TITLE>
+</HEAD><BODY>
+<H1>KERNEL_SHORT</H1>
+Section: String and data retrieving fun (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+kernel_short - Retrieves a short value stored in kernel memory.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ kernel_short:long(addr:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>addr</I>
+<DL COMPACT><DT><DD>
+The kernel address to retrieve the short from.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Returns the short value from a given kernel memory address. Reports an error when reading from the given address fails.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of KERNEL_STRING</TITLE>
+</HEAD><BODY>
+<H1>KERNEL_STRING</H1>
+Section: String and data retrieving fun (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+kernel_string - Retrieves string from kernel memory.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ kernel_string:string(addr:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>addr</I>
+<DL COMPACT><DT><DD>
+The kernel address to retrieve the string from.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Returns the null terminated C string from a given kernel memory address. Reports an error on string copy fault.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of KERNEL_STRING_N</TITLE>
+</HEAD><BODY>
+<H1>KERNEL_STRING_N</H1>
+Section: String and data retrieving fun (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+kernel_string_n - Retrieves string of given length from kernel memory.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ kernel_string_n:string(addr:long,n:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>addr</I>
+<DL COMPACT><DT><DD>
+The kernel address to retrieve the string from.
+</DL>
+
+<P>
+
+<I>n</I>
+<DL COMPACT><DT><DD>
+The maximum length of the string (if not null terminated).
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Returns the C string of a maximum given length from a given kernel memory address. Reports an error on string copy fault.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of KPROCESS\&.CREATE</TITLE>
+</HEAD><BODY>
+<H1>KPROCESS\&.CREATE</H1>
+Section: Kernel Process Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+kprocess.create - Fires whenever a new process is successfully created
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+kprocess.create
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>new_pid</I>
+<DL COMPACT><DT><DD>
+The PID of the newly created process
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+Parent of the created process.
+<A NAME="lbAF"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Fires whenever a new process is successfully created, either as a result of fork (or one of its syscall variants), or a new kernel thread.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of KPROCESS\&.EXEC</TITLE>
+</HEAD><BODY>
+<H1>KPROCESS\&.EXEC</H1>
+Section: Kernel Process Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+kprocess.exec - Attempt to exec to a new program
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+kprocess.exec
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>filename</I>
+<DL COMPACT><DT><DD>
+The path to the new executable
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The caller of exec.
+<A NAME="lbAF"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Fires whenever a process attempts to exec to a new program.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of KPROCESS\&.EXEC_COMP</TITLE>
+</HEAD><BODY>
+<H1>KPROCESS\&.EXEC_COMP</H1>
+Section: Kernel Process Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+kprocess.exec_complete - Return from exec to a new program
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+kprocess.exec_complete
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>success</I>
+<DL COMPACT><DT><DD>
+A boolean indicating whether the exec was successful
+</DL>
+
+<P>
+
+<I>errno</I>
+<DL COMPACT><DT><DD>
+The error number resulting from the exec
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+On success, the context of the new executable. On failure, remains in the context of the caller.
+<A NAME="lbAF"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Fires at the completion of an exec call.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of KPROCESS\&.EXIT</TITLE>
+</HEAD><BODY>
+<H1>KPROCESS\&.EXIT</H1>
+Section: Kernel Process Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+kprocess.exit - Exit from process
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+kprocess.exit
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>code</I>
+<DL COMPACT><DT><DD>
+The exit code of the process
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The process which is terminating.
+<A NAME="lbAF"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Fires when a process terminates. This will always be followed by a kprocess.release, though the latter may be delayed if the process waits in a zombie state.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of KPROCESS\&.RELEASE</TITLE>
+</HEAD><BODY>
+<H1>KPROCESS\&.RELEASE</H1>
+Section: Kernel Process Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+kprocess.release - Process released
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+kprocess.release
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>pid</I>
+<DL COMPACT><DT><DD>
+PID of the process being released
+</DL>
+
+<P>
+
+<I>task</I>
+<DL COMPACT><DT><DD>
+A task handle to the process being released
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The context of the parent, if it wanted notification of this process' termination, else the context of the process itself.
+<A NAME="lbAF"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Fires when a process is released from the kernel. This always follows a kprocess.exit, though it may be delayed somewhat if the process waits in a zombie state.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of KPROCESS\&.START</TITLE>
+</HEAD><BODY>
+<H1>KPROCESS\&.START</H1>
+Section: Kernel Process Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+kprocess.start - Starting new process
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+kprocess.start
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+None
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+Newly created process.
+<A NAME="lbAF"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Fires immediately before a new process begins execution.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of LOG</TITLE>
+</HEAD><BODY>
+<H1>LOG</H1>
+Section: Logging Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+log - Send a line to the common trace buffer.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ log(msg:string)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>msg</I>
+<DL COMPACT><DT><DD>
+The formatted message string.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+An implicit end-of-line is added. Same as
+<B>println</B>
+with a single string argument.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of MEM_PAGE_SIZE</TITLE>
+</HEAD><BODY>
+<H1>MEM_PAGE_SIZE</H1>
+Section: Memory Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+mem_page_size - Number of bytes in a page for this architecture.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ mem_page_size:long()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of MODNAME</TITLE>
+</HEAD><BODY>
+<H1>MODNAME</H1>
+Section: Context Functions (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+modname - Return the kernel module name loaded at the address.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ modname:string(addr:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>addr</I>
+<DL COMPACT><DT><DD>
+The address.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Returns the module name associated with the given address if known. If not known it will return the string
+lq<unknown>rq. If the address was not in a kernel module, but in the kernel itself, then the string
+lqkernelrq
+will be returned.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of MSECS_TO_STRING</TITLE>
+</HEAD><BODY>
+<H1>MSECS_TO_STRING</H1>
+Section: Task Time Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+msecs_to_string - Human readable string for given milliseconds.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ msecs_to_string:string(msecs:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>msecs</I>
+<DL COMPACT><DT><DD>
+Number of milliseconds to translate.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Returns a string representing the number of milliseconds as a human readable string consisting of
+lqXmY.ZZZsrq, where X is the number of minutes, Y is the number of seconds and ZZZ is the number of milliseconds.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of NETDEV\&.CHANGE_MAC</TITLE>
+</HEAD><BODY>
+<H1>NETDEV\&.CHANGE_MAC</H1>
+Section: Networking Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+netdev.change_mac - Called when the netdev_name has the MAC changed
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+netdev.change_mac
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>dev_name</I>
+<DL COMPACT><DT><DD>
+The device that will have the MTU changed
+</DL>
+
+<P>
+
+<I>new_mac</I>
+<DL COMPACT><DT><DD>
+The new MAC address
+</DL>
+
+<P>
+
+<I>mac_len</I>
+<DL COMPACT><DT><DD>
+The MAC length
+</DL>
+
+<P>
+
+<I>old_mac</I>
+<DL COMPACT><DT><DD>
+The current MAC address
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of NETDEV\&.CHANGE_MTU</TITLE>
+</HEAD><BODY>
+<H1>NETDEV\&.CHANGE_MTU</H1>
+Section: Networking Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+netdev.change_mtu - Called when the netdev MTU is changed
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+netdev.change_mtu
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>dev_name</I>
+<DL COMPACT><DT><DD>
+The device that will have the MTU changed
+</DL>
+
+<P>
+
+<I>new_mtu</I>
+<DL COMPACT><DT><DD>
+The new MTU
+</DL>
+
+<P>
+
+<I>old_mtu</I>
+<DL COMPACT><DT><DD>
+The current MTU
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of NETDEV\&.CHANGE_RX_F</TITLE>
+</HEAD><BODY>
+<H1>NETDEV\&.CHANGE_RX_F</H1>
+Section: Networking Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+netdev.change_rx_flag - Called when the device RX flag will be changed
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+netdev.change_rx_flag
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>dev_name</I>
+<DL COMPACT><DT><DD>
+The device that will be changed
+</DL>
+
+<P>
+
+<I>flags</I>
+<DL COMPACT><DT><DD>
+The new flags
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of NETDEV\&.CLOSE</TITLE>
+</HEAD><BODY>
+<H1>NETDEV\&.CLOSE</H1>
+Section: Networking Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+netdev.close - Called when the device is closed
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+netdev.close
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>dev_name</I>
+<DL COMPACT><DT><DD>
+The device that is going to be closed
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of NETDEV\&.GET_STATS</TITLE>
+</HEAD><BODY>
+<H1>NETDEV\&.GET_STATS</H1>
+Section: Networking Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+netdev.get_stats - Called when someone asks the device statistics
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+netdev.get_stats
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>dev_name</I>
+<DL COMPACT><DT><DD>
+The device that is going to provide the statistics
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of NETDEV\&.HARD_TRANSM</TITLE>
+</HEAD><BODY>
+<H1>NETDEV\&.HARD_TRANSM</H1>
+Section: Networking Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+netdev.hard_transmit - Called when the devices is going to TX (hard)
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+netdev.hard_transmit
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>protocol</I>
+<DL COMPACT><DT><DD>
+The protocol used in the transmission
+</DL>
+
+<P>
+
+<I>dev_name</I>
+<DL COMPACT><DT><DD>
+The device scheduled to transmit
+</DL>
+
+<P>
+
+<I>length</I>
+<DL COMPACT><DT><DD>
+The length of the transmit buffer.
+</DL>
+
+<P>
+
+<I>truesize</I>
+<DL COMPACT><DT><DD>
+The size of the data to be transmitted.
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of NETDEV\&.IOCTL</TITLE>
+</HEAD><BODY>
+<H1>NETDEV\&.IOCTL</H1>
+Section: Networking Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+netdev.ioctl - Called when the device suffers an IOCTL
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+netdev.ioctl
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>cmd</I>
+<DL COMPACT><DT><DD>
+The IOCTL request
+</DL>
+
+<P>
+
+<I>arg</I>
+<DL COMPACT><DT><DD>
+The IOCTL argument (usually the netdev interface)
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of NETDEV\&.OPEN</TITLE>
+</HEAD><BODY>
+<H1>NETDEV\&.OPEN</H1>
+Section: Networking Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+netdev.open - Called when the device is opened
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+netdev.open
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>dev_name</I>
+<DL COMPACT><DT><DD>
+The device that is going to be opened
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of NETDEV\&.RECEIVE</TITLE>
+</HEAD><BODY>
+<H1>NETDEV\&.RECEIVE</H1>
+Section: Networking Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+netdev.receive - Data received from network device.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+netdev.receive
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>protocol</I>
+<DL COMPACT><DT><DD>
+Protocol of received packet.
+</DL>
+
+<P>
+
+<I>dev_name</I>
+<DL COMPACT><DT><DD>
+The name of the device. e.g: eth0, ath1.
+</DL>
+
+<P>
+
+<I>length</I>
+<DL COMPACT><DT><DD>
+The length of the receiving buffer.
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of NETDEV\&.REGISTER</TITLE>
+</HEAD><BODY>
+<H1>NETDEV\&.REGISTER</H1>
+Section: Networking Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+netdev.register - Called when the device is registered
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+netdev.register
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>dev_name</I>
+<DL COMPACT><DT><DD>
+The device that is going to be registered
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of NETDEV\&.RX</TITLE>
+</HEAD><BODY>
+<H1>NETDEV\&.RX</H1>
+Section: Networking Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+netdev.rx - Called when the device is going to receive a packet
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+netdev.rx
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>protocol</I>
+<DL COMPACT><DT><DD>
+The packet protocol
+</DL>
+
+<P>
+
+<I>dev_name</I>
+<DL COMPACT><DT><DD>
+The device received the packet
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of NETDEV\&.SET_PROMISC</TITLE>
+</HEAD><BODY>
+<H1>NETDEV\&.SET_PROMISC</H1>
+Section: Networking Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+netdev.set_promiscuity - Called when the device enters/leaves promiscuity
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+netdev.set_promiscuity
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>dev_name</I>
+<DL COMPACT><DT><DD>
+The device that is entering/leaving promiscuity mode
+</DL>
+
+<P>
+
+<I>enable</I>
+<DL COMPACT><DT><DD>
+If the device is entering promiscuity mode
+</DL>
+
+<P>
+
+<I>inc</I>
+<DL COMPACT><DT><DD>
+Count the number of promiscuity openers
+</DL>
+
+<P>
+
+<I>disable</I>
+<DL COMPACT><DT><DD>
+If the device is leaving promiscuity mode
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of NETDEV\&.TRANSMIT</TITLE>
+</HEAD><BODY>
+<H1>NETDEV\&.TRANSMIT</H1>
+Section: Networking Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+netdev.transmit - Network device transmitting buffer
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+netdev.transmit
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>protocol</I>
+<DL COMPACT><DT><DD>
+The protocol of this packet(defined in include/linux/if_ether.h).
+</DL>
+
+<P>
+
+<I>dev_name</I>
+<DL COMPACT><DT><DD>
+The name of the device. e.g: eth0, ath1.
+</DL>
+
+<P>
+
+<I>length</I>
+<DL COMPACT><DT><DD>
+The length of the transmit buffer.
+</DL>
+
+<P>
+
+<I>truesize</I>
+<DL COMPACT><DT><DD>
+The size of the data to be transmitted.
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of NETDEV\&.UNREGISTER</TITLE>
+</HEAD><BODY>
+<H1>NETDEV\&.UNREGISTER</H1>
+Section: Networking Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+netdev.unregister - Called when the device is being unregistered
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+netdev.unregister
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>dev_name</I>
+<DL COMPACT><DT><DD>
+The device that is going to be unregistered
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of PAGES_TO_STRING</TITLE>
+</HEAD><BODY>
+<H1>PAGES_TO_STRING</H1>
+Section: Memory Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+pages_to_string - Turns pages into a human readable string.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ pages_to_string:string(pages:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>pages</I>
+<DL COMPACT><DT><DD>
+Number of pages to translate.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Multiplies pages by
+<B>page_size</B>
+to get the number of bytes and returns the result of
+<B>bytes_to_string</B>.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of PEXECNAME</TITLE>
+</HEAD><BODY>
+<H1>PEXECNAME</H1>
+Section: Context Functions (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+pexecname - Returns the execname of a target process's parent process.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ pexecname:string()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of PGRP</TITLE>
+</HEAD><BODY>
+<H1>PGRP</H1>
+Section: Context Functions (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+pgrp - Returns the process group ID of the current process.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ pgrp:long()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of PID</TITLE>
+</HEAD><BODY>
+<H1>PID</H1>
+Section: Context Functions (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+pid - Returns the ID of a target process.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ pid:long()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of PP</TITLE>
+</HEAD><BODY>
+<H1>PP</H1>
+Section: Context Functions (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+pp - Return the probe point associated with the currently running probe handler,
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ pp:string()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+including alias and wildcard expansion effects
+<A NAME="lbAF"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The current probe point.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+<DT><A HREF="#lbAF">CONTEXT</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of PPID</TITLE>
+</HEAD><BODY>
+<H1>PPID</H1>
+Section: Context Functions (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+ppid - Returns the process ID of a target process's parent process.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ ppid:long()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of PRINT_BACKTRACE</TITLE>
+</HEAD><BODY>
+<H1>PRINT_BACKTRACE</H1>
+Section: Context Functions (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+print_backtrace - Print stack back trace
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ print_backtrace()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+<P>
+
+Equivalent to print_stack(<B>backtrace</B>), except that deeper stack nesting may be supported. Return nothing.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of PRINT_REGS</TITLE>
+</HEAD><BODY>
+<H1>PRINT_REGS</H1>
+Section: Context Functions (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+print_regs - Print a register dump.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ print_regs()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of PRINT_STACK</TITLE>
+</HEAD><BODY>
+<H1>PRINT_STACK</H1>
+Section: Context Functions (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+print_stack - Print out stack from string.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ print_stack(stk:string)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>stk</I>
+<DL COMPACT><DT><DD>
+String with list of hexadecimal addresses.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Perform a symbolic lookup of the addresses in the given string, which is assumed to be the result of a prior call to
+<B>backtrace</B>.
+<P>
+
+Print one line per address, including the address, the name of the function containing the address, and an estimate of its position within that function. Return nothing.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of PRINT_UBACKTRACE</TITLE>
+</HEAD><BODY>
+<H1>PRINT_UBACKTRACE</H1>
+Section: Context Functions (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+print_ubacktrace - Print stack back trace for current task. EXPERIMENTAL!
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ print_ubacktrace()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+<P>
+
+Equivalent to print_ustack(<B>ubacktrace</B>), except that deeper stack nesting may be supported. Return nothing.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of PRINT_USTACK</TITLE>
+</HEAD><BODY>
+<H1>PRINT_USTACK</H1>
+Section: Context Functions (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+print_ustack - Print out stack for the current task from string. EXPERIMENTAL!
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ print_ustack(stk:string)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>stk</I>
+<DL COMPACT><DT><DD>
+String with list of hexadecimal addresses for the current task.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Perform a symbolic lookup of the addresses in the given string, which is assumed to be the result of a prior call to
+<B>ubacktrace</B>
+for the current task.
+<P>
+
+Print one line per address, including the address, the name of the function containing the address, and an estimate of its position within that function. Return nothing.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of PROBEFUNC</TITLE>
+</HEAD><BODY>
+<H1>PROBEFUNC</H1>
+Section: Context Functions (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+probefunc - Return the probe point's function name, if known.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ probefunc:string()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of PROBEMOD</TITLE>
+</HEAD><BODY>
+<H1>PROBEMOD</H1>
+Section: Context Functions (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+probemod - Return the probe point's module name, if known.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ probemod:string()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of PROC_MEM_DATA</TITLE>
+</HEAD><BODY>
+<H1>PROC_MEM_DATA</H1>
+Section: Memory Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+proc_mem_data - Program data size (data + stack) in pages.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ proc_mem_data:long()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Returns the current process data size (data + stack) in pages, or zero when there is no current process or the number of pages couldn't be retrieved.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of PROC_MEM_RSS</TITLE>
+</HEAD><BODY>
+<H1>PROC_MEM_RSS</H1>
+Section: Memory Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+proc_mem_rss - Program resident set size in pages.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ proc_mem_rss:long()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Returns the resident set size in pages of the current process, or zero when there is no current process or the number of pages couldn't be retrieved.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of PROC_MEM_SHR</TITLE>
+</HEAD><BODY>
+<H1>PROC_MEM_SHR</H1>
+Section: Memory Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+proc_mem_shr - Program shared pages (from shared mappings).
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ proc_mem_shr:long()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Returns the shared pages (from shared mappings) of the current process, or zero when there is no current process or the number of pages couldn't be retrieved.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of PROC_MEM_SIZE</TITLE>
+</HEAD><BODY>
+<H1>PROC_MEM_SIZE</H1>
+Section: Memory Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+proc_mem_size - Total program virtual memory size in pages.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ proc_mem_size:long()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Returns the total virtual memory size in pages of the current process, or zero when there is no current process or the number of pages couldn't be retrieved.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of PROC_MEM_STRING</TITLE>
+</HEAD><BODY>
+<H1>PROC_MEM_STRING</H1>
+Section: Memory Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+proc_mem_string - Human readable string of current proc memory usage.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ proc_mem_string:string()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Returns a human readable string showing the size, rss, shr, txt and data of the memory used by the current process. For example
+lqsize: 301m, rss: 11m, shr: 8m, txt: 52k, data: 2248krq.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of PROC_MEM_TXT</TITLE>
+</HEAD><BODY>
+<H1>PROC_MEM_TXT</H1>
+Section: Memory Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+proc_mem_txt - Program text (code) size in pages.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ proc_mem_txt:long()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Returns the current process text (code) size in pages, or zero when there is no current process or the number of pages couldn't be retrieved.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of RANDINT</TITLE>
+</HEAD><BODY>
+<H1>RANDINT</H1>
+Section: Random functions Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+randint - Return a random number between [0,n)
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ randint:long(n:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>n</I>
+<DL COMPACT><DT><DD>
+Number past upper limit of range, not larger than 2**20.
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of REGISTERS_VALID</TITLE>
+</HEAD><BODY>
+<H1>REGISTERS_VALID</H1>
+Section: Context Functions (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+registers_valid - Determines validity of <B>register</B> and <B>u_register</B> in current context.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ registers_valid:long()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+<P>
+
+Return 1 if
+<B>register</B>
+and
+<B>u_register</B>
+can be used in the current context, or 0 otherwise. For example,
+<B>registers_valid</B>
+returns 0 when called from a begin or end probe.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of REVERSE_PATH_WALK</TITLE>
+</HEAD><BODY>
+<H1>REVERSE_PATH_WALK</H1>
+Section: Directory-entry (dentry) Tapse (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+reverse_path_walk - get the full dirent path
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ reverse_path_walk:string(dentry:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>dentry</I>
+<DL COMPACT><DT><DD>
+Pointer to dentry.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+<P>
+
+Returns the path name (partial path to mount point).
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SCSI\&.IOCOMPLETED</TITLE>
+</HEAD><BODY>
+<H1>SCSI\&.IOCOMPLETED</H1>
+Section: SCSI Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+scsi.iocompleted - SCSI mid-layer running the completion processing for block device I/O requests
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+scsi.iocompleted
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>lun</I>
+<DL COMPACT><DT><DD>
+The lun number
+</DL>
+
+<P>
+
+<I>host_no</I>
+<DL COMPACT><DT><DD>
+The host number
+</DL>
+
+<P>
+
+<I>device_state</I>
+<DL COMPACT><DT><DD>
+The current state of the device
+</DL>
+
+<P>
+
+<I>dev_id</I>
+<DL COMPACT><DT><DD>
+The scsi device id
+</DL>
+
+<P>
+
+<I>channel</I>
+<DL COMPACT><DT><DD>
+The channel number
+</DL>
+
+<P>
+
+<I>data_direction</I>
+<DL COMPACT><DT><DD>
+The data_direction specifies whether this command is from/to the device
+</DL>
+
+<P>
+
+<I>goodbytes</I>
+<DL COMPACT><DT><DD>
+The bytes completed.
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SCSI\&.IODISPATCHING</TITLE>
+</HEAD><BODY>
+<H1>SCSI\&.IODISPATCHING</H1>
+Section: SCSI Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+scsi.iodispatching - SCSI mid-layer dispatched low-level SCSI command
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+scsi.iodispatching
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>lun</I>
+<DL COMPACT><DT><DD>
+The lun number
+</DL>
+
+<P>
+
+<I>req_bufflen</I>
+<DL COMPACT><DT><DD>
+The request buffer length
+</DL>
+
+<P>
+
+<I>host_no</I>
+<DL COMPACT><DT><DD>
+The host number
+</DL>
+
+<P>
+
+<I>device_state</I>
+<DL COMPACT><DT><DD>
+The current state of the device.
+</DL>
+
+<P>
+
+<I>dev_id</I>
+<DL COMPACT><DT><DD>
+The scsi device id
+</DL>
+
+<P>
+
+<I>channel</I>
+<DL COMPACT><DT><DD>
+The channel number
+</DL>
+
+<P>
+
+<I>data_direction</I>
+<DL COMPACT><DT><DD>
+The data_direction specifies whether this command is from/to the device. 0 (DMA_BIDIRECTIONAL), 1 (DMA_TO_DEVICE), 2 (DMA_FROM_DEVICE), 3 (DMA_NONE)
+</DL>
+
+<P>
+
+<I>request_buffer</I>
+<DL COMPACT><DT><DD>
+The request buffer address
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SCSI\&.IODONE</TITLE>
+</HEAD><BODY>
+<H1>SCSI\&.IODONE</H1>
+Section: SCSI Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+scsi.iodone - SCSI command completed by low level driver and enqueued into the done queue.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+scsi.iodone
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>lun</I>
+<DL COMPACT><DT><DD>
+The lun number
+</DL>
+
+<P>
+
+<I>host_no</I>
+<DL COMPACT><DT><DD>
+The host number
+</DL>
+
+<P>
+
+<I>device_state</I>
+<DL COMPACT><DT><DD>
+The current state of the device
+</DL>
+
+<P>
+
+<I>dev_id</I>
+<DL COMPACT><DT><DD>
+The scsi device id
+</DL>
+
+<P>
+
+<I>channel</I>
+<DL COMPACT><DT><DD>
+The channel number
+</DL>
+
+<P>
+
+<I>data_direction</I>
+<DL COMPACT><DT><DD>
+The data_direction specifies whether this command is from/to the device.
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SCSI\&.IOENTRY</TITLE>
+</HEAD><BODY>
+<H1>SCSI\&.IOENTRY</H1>
+Section: SCSI Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+scsi.ioentry - Prepares a SCSI mid-layer request
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+scsi.ioentry
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>disk_major</I>
+<DL COMPACT><DT><DD>
+The major number of the disk (-1 if no information)
+</DL>
+
+<P>
+
+<I>device_state</I>
+<DL COMPACT><DT><DD>
+The current state of the device.
+</DL>
+
+<P>
+
+<I>disk_minor</I>
+<DL COMPACT><DT><DD>
+The minor number of the disk (-1 if no information)
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SID</TITLE>
+</HEAD><BODY>
+<H1>SID</H1>
+Section: Context Functions (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+sid - Returns the session ID of the current process.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ sid:long()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+<P>
+
+The session ID of a process is the process group ID of the session leader. Session ID is stored in the signal_struct since Kernel 2.6.0.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SIGNAL\&.CHECK_IGNOR</TITLE>
+</HEAD><BODY>
+<H1>SIGNAL\&.CHECK_IGNOR</H1>
+Section: Signal Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+signal.check_ignored - Checking to see signal is ignored
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+signal.check_ignored
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>sig_name</I>
+<DL COMPACT><DT><DD>
+A string representation of the signal
+</DL>
+
+<P>
+
+<I>sig</I>
+<DL COMPACT><DT><DD>
+The number of the signal
+</DL>
+
+<P>
+
+<I>pid_name</I>
+<DL COMPACT><DT><DD>
+Name of the process receiving the signal
+</DL>
+
+<P>
+
+<I>sig_pid</I>
+<DL COMPACT><DT><DD>
+The PID of the process receiving the signal
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SIGNAL\&.CHECK_IGNOR</TITLE>
+</HEAD><BODY>
+<H1>SIGNAL\&.CHECK_IGNOR</H1>
+Section: Signal Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+signal.check_ignored.return - Check to see signal is ignored completed
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+signal.check_ignored.return
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>retstr</I>
+<DL COMPACT><DT><DD>
+Return value as a string
+</DL>
+
+<P>
+
+<I>name</I>
+<DL COMPACT><DT><DD>
+Name of the probe point; default value is signal.checkperm
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SIGNAL\&.CHECKPERM</TITLE>
+</HEAD><BODY>
+<H1>SIGNAL\&.CHECKPERM</H1>
+Section: Signal Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+signal.checkperm - Check being performed on a sent signal
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+signal.checkperm
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>name</I>
+<DL COMPACT><DT><DD>
+Name of the probe point; default value is signal.checkperm
+</DL>
+
+<P>
+
+<I>task</I>
+<DL COMPACT><DT><DD>
+A task handle to the signal recipient
+</DL>
+
+<P>
+
+<I>sinfo</I>
+<DL COMPACT><DT><DD>
+The address of the siginfo structure
+</DL>
+
+<P>
+
+<I>si_code</I>
+<DL COMPACT><DT><DD>
+Indicates the signal type
+</DL>
+
+<P>
+
+<I>sig_name</I>
+<DL COMPACT><DT><DD>
+A string representation of the signal
+</DL>
+
+<P>
+
+<I>sig</I>
+<DL COMPACT><DT><DD>
+The number of the signal
+</DL>
+
+<P>
+
+<I>pid_name</I>
+<DL COMPACT><DT><DD>
+Name of the process receiving the signal
+</DL>
+
+<P>
+
+<I>sig_pid</I>
+<DL COMPACT><DT><DD>
+The PID of the process receiving the signal
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SIGNAL\&.CHECKPERM\&</TITLE>
+</HEAD><BODY>
+<H1>SIGNAL\&.CHECKPERM\&</H1>
+Section: Signal Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+signal.checkperm.return - Check performed on a sent signal completed
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+signal.checkperm.return
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>retstr</I>
+<DL COMPACT><DT><DD>
+Return value as a string
+</DL>
+
+<P>
+
+<I>name</I>
+<DL COMPACT><DT><DD>
+Name of the probe point; default value is signal.checkperm
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SIGNAL\&.DO_ACTION</TITLE>
+</HEAD><BODY>
+<H1>SIGNAL\&.DO_ACTION</H1>
+Section: Signal Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+signal.do_action - Examining or changing a signal action
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+signal.do_action
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>sa_mask</I>
+<DL COMPACT><DT><DD>
+The new mask of the signal
+</DL>
+
+<P>
+
+<I>oldsigact_addr</I>
+<DL COMPACT><DT><DD>
+The address of the old sigaction struct associated with the signal
+</DL>
+
+<P>
+
+<I>sig</I>
+<DL COMPACT><DT><DD>
+The signal to be examined/changed
+</DL>
+
+<P>
+
+<I>sa_handler</I>
+<DL COMPACT><DT><DD>
+The new handler of the signal
+</DL>
+
+<P>
+
+<I>sigact_addr</I>
+<DL COMPACT><DT><DD>
+The address of the new sigaction struct associated with the signal
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SIGNAL\&.DO_ACTION\&</TITLE>
+</HEAD><BODY>
+<H1>SIGNAL\&.DO_ACTION\&</H1>
+Section: Signal Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+signal.do_action.return - Examining or changing a signal action completed
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+signal.do_action.return
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>retstr</I>
+<DL COMPACT><DT><DD>
+Return value as a string
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SIGNAL\&.FLUSH</TITLE>
+</HEAD><BODY>
+<H1>SIGNAL\&.FLUSH</H1>
+Section: Signal Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+signal.flush - Flushing all pending signals for a task
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+signal.flush
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>task</I>
+<DL COMPACT><DT><DD>
+The task handler of the process performing the flush
+</DL>
+
+<P>
+
+<I>pid_name</I>
+<DL COMPACT><DT><DD>
+The name of the process associated with the task performing the flush
+</DL>
+
+<P>
+
+<I>sig_pid</I>
+<DL COMPACT><DT><DD>
+The PID of the process associated with the task performing the flush
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SIGNAL\&.FORCE_SEGV</TITLE>
+</HEAD><BODY>
+<H1>SIGNAL\&.FORCE_SEGV</H1>
+Section: Signal Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+signal.force_segv - Forcing send of SIGSEGV
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+signal.force_segv
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>sig_name</I>
+<DL COMPACT><DT><DD>
+A string representation of the signal
+</DL>
+
+<P>
+
+<I>sig</I>
+<DL COMPACT><DT><DD>
+The number of the signal
+</DL>
+
+<P>
+
+<I>pid_name</I>
+<DL COMPACT><DT><DD>
+Name of the process receiving the signal
+</DL>
+
+<P>
+
+<I>sig_pid</I>
+<DL COMPACT><DT><DD>
+The PID of the process receiving the signal
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Invalid Manpage</TITLE></HEAD>
+<BODY>
+<H1>Invalid Manpage</H1>
+The requested file (stdin) is not a valid (unformatted) man page.</BODY></HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SIGNAL\&.HANDLE</TITLE>
+</HEAD><BODY>
+<H1>SIGNAL\&.HANDLE</H1>
+Section: Signal Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+signal.handle - Signal handler being invoked
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+signal.handle
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>regs</I>
+<DL COMPACT><DT><DD>
+The address of the kernel-mode stack area
+</DL>
+
+<P>
+
+<I>sig_code</I>
+<DL COMPACT><DT><DD>
+The si_code value of the siginfo signal
+</DL>
+
+<P>
+
+<I>sig_mode</I>
+<DL COMPACT><DT><DD>
+Indicates whether the signal was a user-mode or kernel-mode signal
+</DL>
+
+<P>
+
+<I>sinfo</I>
+<DL COMPACT><DT><DD>
+The address of the siginfo table
+</DL>
+
+<P>
+
+<I>oldset_addr</I>
+<DL COMPACT><DT><DD>
+The address of the bitmask array of blocked signals
+</DL>
+
+<P>
+
+<I>sig</I>
+<DL COMPACT><DT><DD>
+The signal number that invoked the signal handler
+</DL>
+
+<P>
+
+<I>ka_addr</I>
+<DL COMPACT><DT><DD>
+The address of the k_sigaction table associated with the signal
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SIGNAL\&.HANDLE\&.RE</TITLE>
+</HEAD><BODY>
+<H1>SIGNAL\&.HANDLE\&.RE</H1>
+Section: Signal Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+signal.handle.return - Signal handler invocation completed
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+signal.handle.return
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>retstr</I>
+<DL COMPACT><DT><DD>
+Return value as a string
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SIGNAL\&.PENDING</TITLE>
+</HEAD><BODY>
+<H1>SIGNAL\&.PENDING</H1>
+Section: Signal Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+signal.pending - Examining pending signal
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+signal.pending
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>sigset_size</I>
+<DL COMPACT><DT><DD>
+The size of the user-space signal set
+</DL>
+
+<P>
+
+<I>sigset_add</I>
+<DL COMPACT><DT><DD>
+The address of the user-space signal set (sigset_t)
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+This probe is used to examine a set of signals pending for delivery to a specific thread. This normally occurs when the do_sigpending kernel function is executed.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SIGNAL\&.PENDING\&.R</TITLE>
+</HEAD><BODY>
+<H1>SIGNAL\&.PENDING\&.R</H1>
+Section: Signal Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+signal.pending.return - Examination of pending signal completed
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+signal.pending.return
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>retstr</I>
+<DL COMPACT><DT><DD>
+Return value as a string
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SIGNAL\&.PROCMASK</TITLE>
+</HEAD><BODY>
+<H1>SIGNAL\&.PROCMASK</H1>
+Section: Signal Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+signal.procmask - Examining or changing blocked signals
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+signal.procmask
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>how</I>
+<DL COMPACT><DT><DD>
+Indicates how to change the blocked signals; possible values are SIG_BLOCK=0 (for blocking signals), SIG_UNBLOCK=1 (for unblocking signals), and SIG_SETMASK=2 for setting the signal mask.
+</DL>
+
+<P>
+
+<I>oldsigset_addr</I>
+<DL COMPACT><DT><DD>
+The old address of the signal set (sigset_t)
+</DL>
+
+<P>
+
+<I>sigset</I>
+<DL COMPACT><DT><DD>
+The actual value to be set for sigset_t (correct?)
+</DL>
+
+<P>
+
+<I>sigset_addr</I>
+<DL COMPACT><DT><DD>
+The address of the signal set (sigset_t) to be implemented
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SIGNAL\&.SEND</TITLE>
+</HEAD><BODY>
+<H1>SIGNAL\&.SEND</H1>
+Section: Signal Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+signal.send - Signal being sent to a process
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+signal.send
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>send2queue</I>
+<DL COMPACT><DT><DD>
+Indicates whether the signal is sent to an existing sigqueue
+</DL>
+
+<P>
+
+<I>name</I>
+<DL COMPACT><DT><DD>
+The name of the function used to send out the signal
+</DL>
+
+<P>
+
+<I>task</I>
+<DL COMPACT><DT><DD>
+A task handle to the signal recipient
+</DL>
+
+<P>
+
+<I>sinfo</I>
+<DL COMPACT><DT><DD>
+The address of siginfo struct
+</DL>
+
+<P>
+
+<I>si_code</I>
+<DL COMPACT><DT><DD>
+Indicates the signal type
+</DL>
+
+<P>
+
+<I>sig_name</I>
+<DL COMPACT><DT><DD>
+A string representation of the signal
+</DL>
+
+<P>
+
+<I>sig</I>
+<DL COMPACT><DT><DD>
+The number of the signal
+</DL>
+
+<P>
+
+<I>shared</I>
+<DL COMPACT><DT><DD>
+Indicates whether the signal is shared by the thread group
+</DL>
+
+<P>
+
+<I>sig_pid</I>
+<DL COMPACT><DT><DD>
+The PID of the process receiving the signal
+</DL>
+
+<P>
+
+<I>pid_name</I>
+<DL COMPACT><DT><DD>
+The name of the signal recipient
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The signal's sender.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SIGNAL\&.SEND\&.RETU</TITLE>
+</HEAD><BODY>
+<H1>SIGNAL\&.SEND\&.RETU</H1>
+Section: Signal Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+signal.send.return - Signal being sent to a process completed
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+signal.send.return
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>retstr</I>
+<DL COMPACT><DT><DD>
+The return value to either __group_send_sig_info, specific_send_sig_info, or send_sigqueue
+</DL>
+
+<P>
+
+<I>send2queue</I>
+<DL COMPACT><DT><DD>
+Indicates whether the sent signal was sent to an existing sigqueue
+</DL>
+
+<P>
+
+<I>name</I>
+<DL COMPACT><DT><DD>
+The name of the function used to send out the signal
+</DL>
+
+<P>
+
+<I>shared</I>
+<DL COMPACT><DT><DD>
+Indicates whether the sent signal is shared by the thread group.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The signal's sender. (correct?)
+<A NAME="lbAF"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Possible __group_send_sig_info and specific_send_sig_info return values are as follows;
+<P>
+
+0 -- The signal is sucessfully sent to a process,
+<A NAME="lbAG"> </A>
+<H2>WHICH MEANS THAT</H2>
+
+<P>
+
+(1) the signal was ignored by the receiving process, (2) this is a non-RT signal and the system already has one queued, and (3) the signal was successfully added to the sigqueue of the receiving process.
+<P>
+
+-EAGAIN -- The sigqueue of the receiving process is overflowing, the signal was RT, and the signal was sent by a user using something other than
+<B>kill</B>.
+<P>
+
+Possible send_group_sigqueue and send_sigqueue return values are as follows;
+<P>
+
+0 -- The signal was either sucessfully added into the sigqueue of the receiving process, or a SI_TIMER entry is already queued (in which case, the overrun count will be simply incremented).
+<P>
+
+1 -- The signal was ignored by the receiving process.
+<P>
+
+-1 -- (send_sigqueue only) The task was marked exiting, allowing * posix_timer_event to redirect it to the group leader.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
+<DT><A HREF="#lbAG">WHICH MEANS THAT</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SIGNAL\&.SEND_SIG_QU</TITLE>
+</HEAD><BODY>
+<H1>SIGNAL\&.SEND_SIG_QU</H1>
+Section: Signal Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+signal.send_sig_queue - Queuing a signal to a process
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+signal.send_sig_queue
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>sigqueue_addr</I>
+<DL COMPACT><DT><DD>
+The address of the signal queue
+</DL>
+
+<P>
+
+<I>sig_name</I>
+<DL COMPACT><DT><DD>
+A string representation of the signal
+</DL>
+
+<P>
+
+<I>sig</I>
+<DL COMPACT><DT><DD>
+The queued signal
+</DL>
+
+<P>
+
+<I>pid_name</I>
+<DL COMPACT><DT><DD>
+Name of the process to which the signal is queued
+</DL>
+
+<P>
+
+<I>sig_pid</I>
+<DL COMPACT><DT><DD>
+The PID of the process to which the signal is queued
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SIGNAL\&.SEND_SIG_QU</TITLE>
+</HEAD><BODY>
+<H1>SIGNAL\&.SEND_SIG_QU</H1>
+Section: Signal Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+signal.send_sig_queue.return - Queuing a signal to a process completed
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+signal.send_sig_queue.return
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>retstr</I>
+<DL COMPACT><DT><DD>
+Return value as a string
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SIGNAL\&.SYS_TGKILL</TITLE>
+</HEAD><BODY>
+<H1>SIGNAL\&.SYS_TGKILL</H1>
+Section: Signal Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+signal.sys_tgkill - Sending kill signal to a thread group
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+signal.sys_tgkill
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>sig_name</I>
+<DL COMPACT><DT><DD>
+A string representation of the signal
+</DL>
+
+<P>
+
+<I>sig</I>
+<DL COMPACT><DT><DD>
+The specific kill signal sent to the process
+</DL>
+
+<P>
+
+<I>pid</I>
+<DL COMPACT><DT><DD>
+The PID of the thread receiving the kill signal
+</DL>
+
+<P>
+
+<I>tgid</I>
+<DL COMPACT><DT><DD>
+The thread group ID of the thread receiving the kill signal
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+The tgkill call is similar to tkill, except that it also allows the caller to specify the thread group ID of the thread to be signalled. This protects against TID reuse.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Invalid Manpage</TITLE></HEAD>
+<BODY>
+<H1>Invalid Manpage</H1>
+The requested file (stdin) is not a valid (unformatted) man page.</BODY></HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SIGNAL\&.SYS_TKILL</TITLE>
+</HEAD><BODY>
+<H1>SIGNAL\&.SYS_TKILL</H1>
+Section: Signal Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+signal.sys_tkill - Sending a kill signal to a thread
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+signal.sys_tkill
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>sig_name</I>
+<DL COMPACT><DT><DD>
+The specific signal sent to the process
+</DL>
+
+<P>
+
+<I>sig</I>
+<DL COMPACT><DT><DD>
+The specific signal sent to the process
+</DL>
+
+<P>
+
+<I>pid</I>
+<DL COMPACT><DT><DD>
+The PID of the process receiving the kill signal
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+The tkill call is analogous to <A HREF="kill.2.html">kill</A>(2), except that it also allows a process within a specific thread group to be targeted. Such processes are targeted through their unique thread IDs (TID).
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SIGNAL\&.SYSKILL</TITLE>
+</HEAD><BODY>
+<H1>SIGNAL\&.SYSKILL</H1>
+Section: Signal Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+signal.syskill - Sending kill signal to a process
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+signal.syskill
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>sig</I>
+<DL COMPACT><DT><DD>
+The specific signal sent to the process
+</DL>
+
+<P>
+
+<I>pid</I>
+<DL COMPACT><DT><DD>
+The PID of the process receiving the signal
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SIGNAL\&.SYSKILL\&.R</TITLE>
+</HEAD><BODY>
+<H1>SIGNAL\&.SYSKILL\&.R</H1>
+Section: Signal Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+signal.syskill.return - Sending kill signal completed
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+signal.syskill.return
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+None
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SIGNAL\&.SYSTKILL\&.</TITLE>
+</HEAD><BODY>
+<H1>SIGNAL\&.SYSTKILL\&.</H1>
+Section: Signal Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+signal.systkill.return - Sending kill signal to a thread completed
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+signal.systkill.return
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+None
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:53 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SIGNAL\&.WAKEUP</TITLE>
+</HEAD><BODY>
+<H1>SIGNAL\&.WAKEUP</H1>
+Section: Signal Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+signal.wakeup - Sleeping process being wakened for signal
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+signal.wakeup
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>resume</I>
+<DL COMPACT><DT><DD>
+Indicates whether to wake up a task in a STOPPED or TRACED state
+</DL>
+
+<P>
+
+<I>state_mask</I>
+<DL COMPACT><DT><DD>
+A string representation indicating the mask of task states to wake. Possible values are TASK_INTERRUPTIBLE, TASK_STOPPED, TASK_TRACED, and TASK_INTERRUPTIBLE.
+</DL>
+
+<P>
+
+<I>pid_name</I>
+<DL COMPACT><DT><DD>
+Name of the process to wake
+</DL>
+
+<P>
+
+<I>sig_pid</I>
+<DL COMPACT><DT><DD>
+The PID of the process to wake
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SOCK_FAM_NUM2STR</TITLE>
+</HEAD><BODY>
+<H1>SOCK_FAM_NUM2STR</H1>
+Section: Socket Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+sock_fam_num2str - Given a protocol family number, return a string representation.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ sock_fam_num2str:string(family:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>family</I>
+<DL COMPACT><DT><DD>
+The family number.
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SOCK_FAM_STR2NUM</TITLE>
+</HEAD><BODY>
+<H1>SOCK_FAM_STR2NUM</H1>
+Section: Socket Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+sock_fam_str2num - Given a protocol family name (string), return the corresponding
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ sock_fam_str2num:long(family:string)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>family</I>
+<DL COMPACT><DT><DD>
+The family name.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+protocol family number.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SOCK_PROT_NUM2STR</TITLE>
+</HEAD><BODY>
+<H1>SOCK_PROT_NUM2STR</H1>
+Section: Socket Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+sock_prot_num2str - Given a protocol number, return a string representation.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ sock_prot_num2str:string(proto:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>proto</I>
+<DL COMPACT><DT><DD>
+The protocol number.
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SOCK_PROT_STR2NUM</TITLE>
+</HEAD><BODY>
+<H1>SOCK_PROT_STR2NUM</H1>
+Section: Socket Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+sock_prot_str2num - Given a protocol name (string), return the corresponding protocol number.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ sock_prot_str2num:long(proto:string)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>proto</I>
+<DL COMPACT><DT><DD>
+The protocol name.
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SOCK_STATE_NUM2STR</TITLE>
+</HEAD><BODY>
+<H1>SOCK_STATE_NUM2STR</H1>
+Section: Socket Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+sock_state_num2str - Given a socket state number, return a string representation.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ sock_state_num2str:string(state:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>state</I>
+<DL COMPACT><DT><DD>
+The state number.
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SOCK_STATE_STR2NUM</TITLE>
+</HEAD><BODY>
+<H1>SOCK_STATE_STR2NUM</H1>
+Section: Socket Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+sock_state_str2num - Given a socket state string, return the corresponding state number.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ sock_state_str2num:long(state:string)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>state</I>
+<DL COMPACT><DT><DD>
+The state name.
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SOCKET\&.AIO_READ</TITLE>
+</HEAD><BODY>
+<H1>SOCKET\&.AIO_READ</H1>
+Section: Socket Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+socket.aio_read - Receiving message via <B>sock_aio_read</B>
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+socket.aio_read
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>protocol</I>
+<DL COMPACT><DT><DD>
+Protocol value
+</DL>
+
+<P>
+
+<I>flags</I>
+<DL COMPACT><DT><DD>
+Socket flags value
+</DL>
+
+<P>
+
+<I>name</I>
+<DL COMPACT><DT><DD>
+Name of this probe
+</DL>
+
+<P>
+
+<I>state</I>
+<DL COMPACT><DT><DD>
+Socket state value
+</DL>
+
+<P>
+
+<I>size</I>
+<DL COMPACT><DT><DD>
+Message size in bytes
+</DL>
+
+<P>
+
+<I>type</I>
+<DL COMPACT><DT><DD>
+Socket type value
+</DL>
+
+<P>
+
+<I>family</I>
+<DL COMPACT><DT><DD>
+Protocol family value
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The message sender
+<A NAME="lbAF"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Fires at the beginning of receiving a message on a socket via the
+<B>sock_aio_read</B>
+function
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SOCKET\&.AIO_READ\&.</TITLE>
+</HEAD><BODY>
+<H1>SOCKET\&.AIO_READ\&.</H1>
+Section: Socket Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+socket.aio_read.return - Conclusion of message received via <B>sock_aio_read</B>
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+socket.aio_read.return
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>success</I>
+<DL COMPACT><DT><DD>
+Was receive successful? (1 = yes, 0 = no)
+</DL>
+
+<P>
+
+<I>protocol</I>
+<DL COMPACT><DT><DD>
+Protocol value
+</DL>
+
+<P>
+
+<I>flags</I>
+<DL COMPACT><DT><DD>
+Socket flags value
+</DL>
+
+<P>
+
+<I>name</I>
+<DL COMPACT><DT><DD>
+Name of this probe
+</DL>
+
+<P>
+
+<I>state</I>
+<DL COMPACT><DT><DD>
+Socket state value
+</DL>
+
+<P>
+
+<I>size</I>
+<DL COMPACT><DT><DD>
+Size of message received (in bytes) or error code if success = 0
+</DL>
+
+<P>
+
+<I>type</I>
+<DL COMPACT><DT><DD>
+Socket type value
+</DL>
+
+<P>
+
+<I>family</I>
+<DL COMPACT><DT><DD>
+Protocol family value
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The message receiver.
+<A NAME="lbAF"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Fires at the conclusion of receiving a message on a socket via the
+<B>sock_aio_read</B>
+function
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SOCKET\&.AIO_WRITE</TITLE>
+</HEAD><BODY>
+<H1>SOCKET\&.AIO_WRITE</H1>
+Section: Socket Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+socket.aio_write - Message send via <B>sock_aio_write</B>
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+socket.aio_write
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>protocol</I>
+<DL COMPACT><DT><DD>
+Protocol value
+</DL>
+
+<P>
+
+<I>flags</I>
+<DL COMPACT><DT><DD>
+Socket flags value
+</DL>
+
+<P>
+
+<I>name</I>
+<DL COMPACT><DT><DD>
+Name of this probe
+</DL>
+
+<P>
+
+<I>state</I>
+<DL COMPACT><DT><DD>
+Socket state value
+</DL>
+
+<P>
+
+<I>size</I>
+<DL COMPACT><DT><DD>
+Message size in bytes
+</DL>
+
+<P>
+
+<I>type</I>
+<DL COMPACT><DT><DD>
+Socket type value
+</DL>
+
+<P>
+
+<I>family</I>
+<DL COMPACT><DT><DD>
+Protocol family value
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The message sender
+<A NAME="lbAF"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Fires at the beginning of sending a message on a socket via the
+<B>sock_aio_write</B>
+function
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SOCKET\&.AIO_WRITE\&</TITLE>
+</HEAD><BODY>
+<H1>SOCKET\&.AIO_WRITE\&</H1>
+Section: Socket Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+socket.aio_write.return - Conclusion of message send via <B>sock_aio_write</B>
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+socket.aio_write.return
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>success</I>
+<DL COMPACT><DT><DD>
+Was receive successful? (1 = yes, 0 = no)
+</DL>
+
+<P>
+
+<I>protocol</I>
+<DL COMPACT><DT><DD>
+Protocol value
+</DL>
+
+<P>
+
+<I>flags</I>
+<DL COMPACT><DT><DD>
+Socket flags value
+</DL>
+
+<P>
+
+<I>name</I>
+<DL COMPACT><DT><DD>
+Name of this probe
+</DL>
+
+<P>
+
+<I>state</I>
+<DL COMPACT><DT><DD>
+Socket state value
+</DL>
+
+<P>
+
+<I>size</I>
+<DL COMPACT><DT><DD>
+Size of message received (in bytes) or error code if success = 0
+</DL>
+
+<P>
+
+<I>type</I>
+<DL COMPACT><DT><DD>
+Socket type value
+</DL>
+
+<P>
+
+<I>family</I>
+<DL COMPACT><DT><DD>
+Protocol family value
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The message receiver.
+<A NAME="lbAF"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Fires at the conclusion of sending a message on a socket via the
+<B>sock_aio_write</B>
+function
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SOCKET\&.CLOSE</TITLE>
+</HEAD><BODY>
+<H1>SOCKET\&.CLOSE</H1>
+Section: Socket Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+socket.close - Close a socket
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+socket.close
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>protocol</I>
+<DL COMPACT><DT><DD>
+Protocol value
+</DL>
+
+<P>
+
+<I>flags</I>
+<DL COMPACT><DT><DD>
+Socket flags value
+</DL>
+
+<P>
+
+<I>name</I>
+<DL COMPACT><DT><DD>
+Name of this probe
+</DL>
+
+<P>
+
+<I>state</I>
+<DL COMPACT><DT><DD>
+Socket state value
+</DL>
+
+<P>
+
+<I>type</I>
+<DL COMPACT><DT><DD>
+Socket type value
+</DL>
+
+<P>
+
+<I>family</I>
+<DL COMPACT><DT><DD>
+Protocol family value
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The requester (user process or kernel)
+<A NAME="lbAF"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Fires at the beginning of closing a socket.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SOCKET\&.CLOSE\&.RET</TITLE>
+</HEAD><BODY>
+<H1>SOCKET\&.CLOSE\&.RET</H1>
+Section: Socket Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+socket.close.return - Return from closing a socket
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+socket.close.return
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>name</I>
+<DL COMPACT><DT><DD>
+Name of this probe
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The requester (user process or kernel)
+<A NAME="lbAF"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Fires at the conclusion of closing a socket.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SOCKET\&.CREATE</TITLE>
+</HEAD><BODY>
+<H1>SOCKET\&.CREATE</H1>
+Section: Socket Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+socket.create - Creation of a socket
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+socket.create
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>protocol</I>
+<DL COMPACT><DT><DD>
+Protocol value
+</DL>
+
+<P>
+
+<I>name</I>
+<DL COMPACT><DT><DD>
+Name of this probe
+</DL>
+
+<P>
+
+<I>requester</I>
+<DL COMPACT><DT><DD>
+Requested by user process or the kernel (1 = kernel, 0 = user)
+</DL>
+
+<P>
+
+<I>type</I>
+<DL COMPACT><DT><DD>
+Socket type value
+</DL>
+
+<P>
+
+<I>family</I>
+<DL COMPACT><DT><DD>
+Protocol family value
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The requester (see requester variable)
+<A NAME="lbAF"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Fires at the beginning of creating a socket.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SOCKET\&.CREATE\&.RE</TITLE>
+</HEAD><BODY>
+<H1>SOCKET\&.CREATE\&.RE</H1>
+Section: Socket Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+socket.create.return - Return from Creation of a socket
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+socket.create.return
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>success</I>
+<DL COMPACT><DT><DD>
+Was socket creation successful? (1 = yes, 0 = no)
+</DL>
+
+<P>
+
+<I>protocol</I>
+<DL COMPACT><DT><DD>
+Protocol value
+</DL>
+
+<P>
+
+<I>err</I>
+<DL COMPACT><DT><DD>
+Error code if success == 0
+</DL>
+
+<P>
+
+<I>name</I>
+<DL COMPACT><DT><DD>
+Name of this probe
+</DL>
+
+<P>
+
+<I>requester</I>
+<DL COMPACT><DT><DD>
+Requested by user process or the kernel (1 = kernel, 0 = user)
+</DL>
+
+<P>
+
+<I>type</I>
+<DL COMPACT><DT><DD>
+Socket type value
+</DL>
+
+<P>
+
+<I>family</I>
+<DL COMPACT><DT><DD>
+Protocol family value
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The requester (user process or kernel)
+<A NAME="lbAF"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Fires at the conclusion of creating a socket.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SOCKET\&.READV</TITLE>
+</HEAD><BODY>
+<H1>SOCKET\&.READV</H1>
+Section: Socket Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+socket.readv - Receiving a message via <B>sock_readv</B>
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+socket.readv
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>protocol</I>
+<DL COMPACT><DT><DD>
+Protocol value
+</DL>
+
+<P>
+
+<I>flags</I>
+<DL COMPACT><DT><DD>
+Socket flags value
+</DL>
+
+<P>
+
+<I>name</I>
+<DL COMPACT><DT><DD>
+Name of this probe
+</DL>
+
+<P>
+
+<I>state</I>
+<DL COMPACT><DT><DD>
+Socket state value
+</DL>
+
+<P>
+
+<I>size</I>
+<DL COMPACT><DT><DD>
+Message size in bytes
+</DL>
+
+<P>
+
+<I>type</I>
+<DL COMPACT><DT><DD>
+Socket type value
+</DL>
+
+<P>
+
+<I>family</I>
+<DL COMPACT><DT><DD>
+Protocol family value
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The message sender
+<A NAME="lbAF"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Fires at the beginning of receiving a message on a socket via the
+<B>sock_readv</B>
+function
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SOCKET\&.READV\&.RET</TITLE>
+</HEAD><BODY>
+<H1>SOCKET\&.READV\&.RET</H1>
+Section: Socket Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+socket.readv.return - Conclusion of receiving a message via <B>sock_readv</B>
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+socket.readv.return
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>success</I>
+<DL COMPACT><DT><DD>
+Was receive successful? (1 = yes, 0 = no)
+</DL>
+
+<P>
+
+<I>protocol</I>
+<DL COMPACT><DT><DD>
+Protocol value
+</DL>
+
+<P>
+
+<I>flags</I>
+<DL COMPACT><DT><DD>
+Socket flags value
+</DL>
+
+<P>
+
+<I>name</I>
+<DL COMPACT><DT><DD>
+Name of this probe
+</DL>
+
+<P>
+
+<I>state</I>
+<DL COMPACT><DT><DD>
+Socket state value
+</DL>
+
+<P>
+
+<I>size</I>
+<DL COMPACT><DT><DD>
+Size of message received (in bytes) or error code if success = 0
+</DL>
+
+<P>
+
+<I>type</I>
+<DL COMPACT><DT><DD>
+Socket type value
+</DL>
+
+<P>
+
+<I>family</I>
+<DL COMPACT><DT><DD>
+Protocol family value
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The message receiver.
+<A NAME="lbAF"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Fires at the conclusion of receiving a message on a socket via the
+<B>sock_readv</B>
+function
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SOCKET\&.RECEIVE</TITLE>
+</HEAD><BODY>
+<H1>SOCKET\&.RECEIVE</H1>
+Section: Socket Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+socket.receive - Message received on a socket.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+socket.receive
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>success</I>
+<DL COMPACT><DT><DD>
+Was send successful? (1 = yes, 0 = no)
+</DL>
+
+<P>
+
+<I>protocol</I>
+<DL COMPACT><DT><DD>
+Protocol value
+</DL>
+
+<P>
+
+<I>flags</I>
+<DL COMPACT><DT><DD>
+Socket flags value
+</DL>
+
+<P>
+
+<I>name</I>
+<DL COMPACT><DT><DD>
+Name of this probe
+</DL>
+
+<P>
+
+<I>state</I>
+<DL COMPACT><DT><DD>
+Socket state value
+</DL>
+
+<P>
+
+<I>size</I>
+<DL COMPACT><DT><DD>
+Size of message received (in bytes) or error code if success = 0
+</DL>
+
+<P>
+
+<I>type</I>
+<DL COMPACT><DT><DD>
+Socket type value
+</DL>
+
+<P>
+
+<I>family</I>
+<DL COMPACT><DT><DD>
+Protocol family value
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The message receiver
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SOCKET\&.RECVMSG</TITLE>
+</HEAD><BODY>
+<H1>SOCKET\&.RECVMSG</H1>
+Section: Socket Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+socket.recvmsg - Message being received on socket
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+socket.recvmsg
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>protocol</I>
+<DL COMPACT><DT><DD>
+Protocol value
+</DL>
+
+<P>
+
+<I>flags</I>
+<DL COMPACT><DT><DD>
+Socket flags value
+</DL>
+
+<P>
+
+<I>name</I>
+<DL COMPACT><DT><DD>
+Name of this probe
+</DL>
+
+<P>
+
+<I>state</I>
+<DL COMPACT><DT><DD>
+Socket state value
+</DL>
+
+<P>
+
+<I>size</I>
+<DL COMPACT><DT><DD>
+Message size in bytes
+</DL>
+
+<P>
+
+<I>type</I>
+<DL COMPACT><DT><DD>
+Socket type value
+</DL>
+
+<P>
+
+<I>family</I>
+<DL COMPACT><DT><DD>
+Protocol family value
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The message receiver.
+<A NAME="lbAF"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Fires at the beginning of receiving a message on a socket via the
+<B>sock_recvmsg</B>
+function
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SOCKET\&.RECVMSG\&.R</TITLE>
+</HEAD><BODY>
+<H1>SOCKET\&.RECVMSG\&.R</H1>
+Section: Socket Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+socket.recvmsg.return - Return from Message being received on socket
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+socket.recvmsg.return
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>success</I>
+<DL COMPACT><DT><DD>
+Was receive successful? (1 = yes, 0 = no)
+</DL>
+
+<P>
+
+<I>protocol</I>
+<DL COMPACT><DT><DD>
+Protocol value
+</DL>
+
+<P>
+
+<I>flags</I>
+<DL COMPACT><DT><DD>
+Socket flags value
+</DL>
+
+<P>
+
+<I>name</I>
+<DL COMPACT><DT><DD>
+Name of this probe
+</DL>
+
+<P>
+
+<I>state</I>
+<DL COMPACT><DT><DD>
+Socket state value
+</DL>
+
+<P>
+
+<I>size</I>
+<DL COMPACT><DT><DD>
+Size of message received (in bytes) or error code if success = 0
+</DL>
+
+<P>
+
+<I>type</I>
+<DL COMPACT><DT><DD>
+Socket type value
+</DL>
+
+<P>
+
+<I>family</I>
+<DL COMPACT><DT><DD>
+Protocol family value
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The message receiver.
+<A NAME="lbAF"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Fires at the conclusion of receiving a message on a socket via the
+<B>sock_recvmsg</B>
+function.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SOCKET\&.SEND</TITLE>
+</HEAD><BODY>
+<H1>SOCKET\&.SEND</H1>
+Section: Socket Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+socket.send - Message sent on a socket.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+socket.send
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>success</I>
+<DL COMPACT><DT><DD>
+Was send successful? (1 = yes, 0 = no)
+</DL>
+
+<P>
+
+<I>protocol</I>
+<DL COMPACT><DT><DD>
+Protocol value
+</DL>
+
+<P>
+
+<I>flags</I>
+<DL COMPACT><DT><DD>
+Socket flags value
+</DL>
+
+<P>
+
+<I>name</I>
+<DL COMPACT><DT><DD>
+Name of this probe
+</DL>
+
+<P>
+
+<I>state</I>
+<DL COMPACT><DT><DD>
+Socket state value
+</DL>
+
+<P>
+
+<I>size</I>
+<DL COMPACT><DT><DD>
+Size of message sent (in bytes) or error code if success = 0
+</DL>
+
+<P>
+
+<I>type</I>
+<DL COMPACT><DT><DD>
+Socket type value
+</DL>
+
+<P>
+
+<I>family</I>
+<DL COMPACT><DT><DD>
+Protocol family value
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The message sender
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SOCKET\&.SENDMSG</TITLE>
+</HEAD><BODY>
+<H1>SOCKET\&.SENDMSG</H1>
+Section: Socket Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+socket.sendmsg - Message is currently being sent on a socket.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+socket.sendmsg
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>protocol</I>
+<DL COMPACT><DT><DD>
+Protocol value
+</DL>
+
+<P>
+
+<I>flags</I>
+<DL COMPACT><DT><DD>
+Socket flags value
+</DL>
+
+<P>
+
+<I>name</I>
+<DL COMPACT><DT><DD>
+Name of this probe
+</DL>
+
+<P>
+
+<I>state</I>
+<DL COMPACT><DT><DD>
+Socket state value
+</DL>
+
+<P>
+
+<I>size</I>
+<DL COMPACT><DT><DD>
+Message size in bytes
+</DL>
+
+<P>
+
+<I>type</I>
+<DL COMPACT><DT><DD>
+Socket type value
+</DL>
+
+<P>
+
+<I>family</I>
+<DL COMPACT><DT><DD>
+Protocol family value
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The message sender
+<A NAME="lbAF"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Fires at the beginning of sending a message on a socket via the
+<B>sock_sendmsg</B>
+function
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SOCKET\&.SENDMSG\&.R</TITLE>
+</HEAD><BODY>
+<H1>SOCKET\&.SENDMSG\&.R</H1>
+Section: Socket Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+socket.sendmsg.return - Return from socket.sendmsg.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+socket.sendmsg.return
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>success</I>
+<DL COMPACT><DT><DD>
+Was send successful? (1 = yes, 0 = no)
+</DL>
+
+<P>
+
+<I>protocol</I>
+<DL COMPACT><DT><DD>
+Protocol value
+</DL>
+
+<P>
+
+<I>flags</I>
+<DL COMPACT><DT><DD>
+Socket flags value
+</DL>
+
+<P>
+
+<I>name</I>
+<DL COMPACT><DT><DD>
+Name of this probe
+</DL>
+
+<P>
+
+<I>state</I>
+<DL COMPACT><DT><DD>
+Socket state value
+</DL>
+
+<P>
+
+<I>size</I>
+<DL COMPACT><DT><DD>
+Size of message sent (in bytes) or error code if success = 0
+</DL>
+
+<P>
+
+<I>type</I>
+<DL COMPACT><DT><DD>
+Socket type value
+</DL>
+
+<P>
+
+<I>family</I>
+<DL COMPACT><DT><DD>
+Protocol family value
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The message sender.
+<A NAME="lbAF"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Fires at the conclusion of sending a message on a socket via the
+<B>sock_sendmsg</B>
+function
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SOCKET\&.WRITEV</TITLE>
+</HEAD><BODY>
+<H1>SOCKET\&.WRITEV</H1>
+Section: Socket Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+socket.writev - Message sent via <B>socket_writev</B>
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+socket.writev
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>protocol</I>
+<DL COMPACT><DT><DD>
+Protocol value
+</DL>
+
+<P>
+
+<I>flags</I>
+<DL COMPACT><DT><DD>
+Socket flags value
+</DL>
+
+<P>
+
+<I>name</I>
+<DL COMPACT><DT><DD>
+Name of this probe
+</DL>
+
+<P>
+
+<I>state</I>
+<DL COMPACT><DT><DD>
+Socket state value
+</DL>
+
+<P>
+
+<I>size</I>
+<DL COMPACT><DT><DD>
+Message size in bytes
+</DL>
+
+<P>
+
+<I>type</I>
+<DL COMPACT><DT><DD>
+Socket type value
+</DL>
+
+<P>
+
+<I>family</I>
+<DL COMPACT><DT><DD>
+Protocol family value
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The message sender
+<A NAME="lbAF"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Fires at the beginning of sending a message on a socket via the
+<B>sock_writev</B>
+function
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SOCKET\&.WRITEV\&.RE</TITLE>
+</HEAD><BODY>
+<H1>SOCKET\&.WRITEV\&.RE</H1>
+Section: Socket Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+socket.writev.return - Conclusion of message sent via <B>socket_writev</B>
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+socket.writev.return
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>success</I>
+<DL COMPACT><DT><DD>
+Was send successful? (1 = yes, 0 = no)
+</DL>
+
+<P>
+
+<I>protocol</I>
+<DL COMPACT><DT><DD>
+Protocol value
+</DL>
+
+<P>
+
+<I>flags</I>
+<DL COMPACT><DT><DD>
+Socket flags value
+</DL>
+
+<P>
+
+<I>name</I>
+<DL COMPACT><DT><DD>
+Name of this probe
+</DL>
+
+<P>
+
+<I>state</I>
+<DL COMPACT><DT><DD>
+Socket state value
+</DL>
+
+<P>
+
+<I>size</I>
+<DL COMPACT><DT><DD>
+Size of message sent (in bytes) or error code if success = 0
+</DL>
+
+<P>
+
+<I>type</I>
+<DL COMPACT><DT><DD>
+Socket type value
+</DL>
+
+<P>
+
+<I>family</I>
+<DL COMPACT><DT><DD>
+Protocol family value
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The message receiver.
+<A NAME="lbAF"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Fires at the conclusion of sending a message on a socket via the
+<B>sock_writev</B>
+function
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of STACK_SIZE</TITLE>
+</HEAD><BODY>
+<H1>STACK_SIZE</H1>
+Section: Context Functions (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+stack_size - Return the size of the kernel stack.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ stack_size:long()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of STACK_UNUSED</TITLE>
+</HEAD><BODY>
+<H1>STACK_UNUSED</H1>
+Section: Context Functions (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+stack_unused - Returns the amount of kernel stack currently available.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ stack_unused:long()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+<P>
+
+Determines how many bytes are currently available in the kernel stack.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of STACK_USED</TITLE>
+</HEAD><BODY>
+<H1>STACK_USED</H1>
+Section: Context Functions (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+stack_used - Returns the amount of kernel stack used.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ stack_used:long()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+<P>
+
+Determines how many bytes are currently used in the kernel stack.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of STAP-SERVER</TITLE>
+</HEAD><BODY>
+<H1>STAP-SERVER</H1>
+Section: Maintenance Commands (8)<BR>Updated: 2009-11-17<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+stap-server - systemtap server and related utilities
+<P>
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<BR>
+
+<B>stap-start-server</B>
+
+<BR>
+
+<B>stap-find-servers</B>
+
+[
+<B>--all</B>
+
+]
+<BR>
+
+<B>stap-find-or-start-server</B>
+
+<BR>
+
+<B>stap-stop-server</B>
+
+<I>PID</I>
+
+<BR>
+
+<B>stap-authorize-server-cert </B><I>CERTFILE</I> [ <I>DIRNAME</I> ]
+
+<BR>
+
+<B>stap-client</B>
+
+[
+<B>--server=</B><I>HOSTNAME</I>|<I>IP_ADDRESS</I>[<B>:</B><I>PORT</I>]
+
+]
+[
+<B>--ssl=</B><I>DIRNAME</I>
+
+]
+[
+<I>ARGUMENTS</I>
+
+]
+<P>
+<A NAME="lbAD"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+The systemtap server listens for connections from
+<I>stap-client</I>
+
+on a secure SSL network port and accepts requests to run the
+<I>stap</I>
+
+front end.
+<P>
+<P>
+
+The
+<I>stap-start-server</I>
+
+program attempts to start a systemtap server (<I>stap-serverd</I>)
+on the local host. Upon
+successful startup, the server listens for connections on a random port and
+advertises its presence on the local network using the
+<I>avahi</I>
+
+daemon. If the server is successfully started, its process id is
+echoed to stdout and the exit code is 0. Otherwise, nothing is echoed and the
+exit code is 1.
+<P>
+<P>
+
+The
+<I>stap-find-servers</I>
+
+program attempts to find systemtap servers running on the local network.
+The details of any servers found are echoed to stdout.
+If servers are found, then the exit code is 0, otherwise it is 1.
+<P>
+<P>
+
+The
+<I>stap-find-or-start-server</I>
+
+program attempts to find a compatible systemtap server running on the local network
+using
+<I>stap-find-servers</I>.
+
+If a compatible server is found,
+<I>stap-find-or-start-server</I>
+
+echoes [aq]0[aq] to stdout. Otherwise
+<I>stap-find-or-start-server</I>
+
+attempts to start a server on the local network using
+<I>stap-start-server</I>.
+
+If successful, the process id of the new server is echoed to stdout.
+If no server can be found or started, [aq]-1[aq] is echoed
+to stdout. The exit code is 0 in all cases.
+<P>
+<P>
+
+The
+<I>stap-stop-server</I>
+
+program verifies that the given process id is that of a running systemtap server
+on the local host and, if so, attempts to shut down the server by sending it the
+SIGTERM signal. If a process id is provided and it is that of a running systemtap
+server, the exit code is 0. Otherwise the exit code is 1.
+<I>stap-stop-server</I>
+
+does not verify that the server actually shuts down.
+<P>
+<P>
+
+The
+<I>stap-authorize-server-cert</I>
+
+program adds the given server certificate to the given client-side
+certificate database, making that server a trusted server for clients using that database.
+<P>
+<P>
+
+The
+<I>stap-client</I>
+
+program is analogous to the
+<I>stap</I>
+
+front end except that it attempts to find a compatible systemtap server on the
+local network and then attempts to use that server for actions related to
+passes 1 through 4. Pass 5 actions, if requested, are performed on the local
+host using
+<I>staprun</I>.
+
+Upon successful completion, the exit code is 0. Otherwise the exit code
+is 1.
+<P>
+<A NAME="lbAE"> </A>
+<H2>OPTIONS</H2>
+
+The
+<I>stap-find-servers</I>
+
+program supports the following option. Any other option
+is ignored.
+<DL COMPACT>
+<DT><B>--all</B>
+
+<DD>
+Instructs
+<I>stap-find-servers</I>
+
+to report all systemtap servers on the local network regardless of compatibility.
+The default behavior is to report only servers which are compatible with
+systemtap on the local host.
+<P>
+</DL>
+<P>
+
+In addition to the options accepted by the
+<I>stap</I>
+
+front end,
+<I>stap-client</I>
+
+accepts the following:
+<P>
+<DL COMPACT>
+<DT><B>--server=</B><I>HOSTNAME</I>|<I>IP_ADDRESS</I>[<B>:</B><I>PORT</I>]
+
+<DD>
+This option instructs
+<I>stap-client</I>
+
+to use the named server instead of looking for one automatically. The server may
+be specified using a valid host name or ip address. If no port is specified, then
+<I>stap-client</I>
+
+searches for the server among the servers advertising their presence on the
+local network and uses the port which is being advertised. This is useful for
+connecting to a specific server on the local network. If a port is specified,
+then
+<I>stap-client</I>
+
+will attempt to connect to the named host on the specified port. This is useful
+for connecting to non-local servers. If
+<B>--server</B>
+
+is specified,
+<I>stap-client</I>
+
+will make no attempt to contact other servers. If more than one
+<B>--server</B>
+
+option is specified,
+<I>stap-client</I>
+
+will attempt to use the servers in the order specified.
+<P>
+<DT><B>--ssl=</B><I>DIRNAME</I>
+
+<DD>
+<I>stap-client</I>
+
+uses certificate databases in default locations (see
+<I>SERVER MANAGEMENT</I>
+
+below) in order to authenticate each server which is contacted. The
+<B>--ssl</B>
+
+option is used to specify additional databases to search. Databases specified
+using
+<B>--ssl</B>
+
+are searched before the default databases. If more than one
+<B>--ssl</B>
+
+option is specified, then the databases are searched in the order specified on
+the command line followed by the default locations.
+<P>
+</DL>
+<A NAME="lbAF"> </A>
+<H2>ARGUMENTS</H2>
+
+The
+<I>stap-stop-server</I>
+
+program requires a process id argument which identifies the server to be stopped.
+<P>
+<P>
+
+The
+<I>stap-authorize-server-cert</I>
+
+program accepts two arguments:
+<P>
+<DL COMPACT>
+<DT><B>CERTFILE</B>
+
+<DD>
+This is the name of the file containing the certificate of the new trusted
+server. This is the file named <I>stap.cert</I> which can be found in the
+server[aq]s certificate database.
+<P>
+<DT><B>DIRNAME</B>
+
+<DD>
+This optional argument is the name of the directory containing the client-side
+certificate database to which the certificate is to be added. If not specified, the
+default, for non-root users, is
+<I>$HOME/.systemtap/ssl/server</I>.
+
+For root users (EUID=0), the default is
+<I>$sysconfdir/systemtap/ssl/server</I>.
+
+<P>
+</DL>
+<P>
+
+The
+<I>stap-client</I>
+
+program accepts the same arguments as
+<I>stap</I>.
+
+See <I><A HREF="stap.1.html">stap</A></I>(1) for details.
+<P>
+<A NAME="lbAG"> </A>
+<H2>SERVER MANAGEMENT</H2>
+
+The security of the SSL network connection between the client and server and
+of the signing and verification of the server[aq]s response depend on the proper
+management of server certificates and the public and private key pairs with which
+they are signed and verified.
+<P>
+<P>
+
+The trustworthiness of a given systemtap server can not be determined
+automatically without a trusted certificate authority issuing systemtap server
+certificates. This is
+not practical in everyday use and so, clients must authenticate servers
+against their own databases of trusted server certificates. In this context,
+establishing a given server as trusted by a given client means adding
+that server[aq]s certificate to the
+client[aq]s database of trusted servers.
+<P>
+<P>
+
+The implementation of the client and server have automated many of the tasks
+required. In particular:
+<P>
+<DL COMPACT>
+<DT>*<DD>
+When a user starts a server for the first time, the server will generate its
+own certificate and add it to a database local to that user. For non-root users,
+this database will be created in
+<I>$HOME/.systemtap/ssl/server</I>.
+
+For root users (EUID=0), it will be created in
+<I>$sysconfdir/systemtap/ssl/server</I>.
+
+<P>
+<DT>*<DD>
+At this time, the
+server will also create a local client-side certificate database and add the
+server[aq]s certificate to it. For non-root users,
+this database will be created in
+<I>$HOME/.systemtap/ssl/client</I>.
+
+For root users (EUID=0), it will be created in
+<I>$sysconfdir/systemtap/ssl/client</I>.
+
+<P>
+In this way, a server started by a given user is automatically trusted by
+clients run by that user.
+<P>
+<DT>*<DD>
+The client-side certificate database created for root users is also
+the global client-side database for all clients on the host. In this way,
+a server started by root is automatically trusted by clients run by any
+user on that host.
+<P>
+</DL>
+<P>
+
+The trustworthiness of other servers may be asserted in one of two ways:
+<P>
+<DL COMPACT>
+<DT>*<DD>
+Other existing client-side certificate databases may be searched by using the
+<B>--ssl</B>
+
+option one or more times when running the client (see
+<I>OPTIONS</I>
+
+above). Servers whose certificates are contained in the additional databases
+will be considered to be trusted for that invocation of the client.
+<P>
+<DT>*<DD>
+A user may add the certificate of a new trusted server to his own local
+client-side certificate database using
+[aq]<B>stap-authorize-server-cert </B><I>CERTFILE</I>[aq]
+(see above), where <I>CERTFILE</I> is the server[aq]s certificate file
+(<I>stap.cert</I>) from the server[aq]s certificate database directory and
+<I>DIRNAME</I> is the
+directory containing the user[aq]s client-side certificate database.
+<P>
+The server will trusted by clients run by that user from then on.
+<P>
+</DL>
+<P>
+
+When a root (EUID=0) user adds a server[aq]s certificate to their client-side
+certificate database, which is also the global database for all users on that
+host, they assert the trustworthiness of that server for all users on that
+host.
+<P>
+<A NAME="lbAH"> </A>
+<H2>EXAMPLES</H2>
+
+See the
+<I><A HREF="stapex.3stap.html">stapex</A></I>(3stap)
+
+manual page for a collection of sample scripts.
+<P>
+
+Here is a very basic example of how to use
+<I>stap-client</I>.
+
+<P>
+
+To find out if a compatible systemtap server is running on your local network
+<P>
+
+<B> $ stap-find-servers</B>
+
+<P>
+
+If no servers are reported, you can start one using
+<P>
+
+<B> $ stap-start-server</B>
+
+<P>
+
+You could also have accomplished both of the previous two steps using
+<P>
+
+<B> $ stap-find-or-start-server</B>
+
+<P>
+
+To compile and execute a simple example using an automatically discovered
+server on the local network
+<P>
+
+<B> $ stap-client -e [aq]probe begin { printf(Hello World!\n); exit() }[aq]</B>
+
+<BR>
+
+ Hello World!
+<P>
+
+To compile and execute a simple example using a server on a specific host
+on the local network
+<P>
+
+<B> $ stap-client --server=</B><I>HOSTNAME</I> -e [aq]probe begin { printf(Hello World!\n); exit() }[aq]
+
+<BR>
+
+ Hello World!
+<P>
+
+To compile and execute a simple example using a specific server
+<P>
+
+<B> $ stap-client --server=</B><I>HOSTNAME</I>:<I>PORT</I> -e [aq]probe begin { printf(Hello World!\n); exit() }[aq]
+
+<BR>
+
+ Hello World!
+<P>
+
+To search additional certificate databases in order to compile and execute a
+simple example
+<P>
+
+<B> $ stap-client --ssl=</B><I>DIRNAME</I> -e [aq]probe begin { printf(Hello World!\n); exit() }[aq]
+
+<BR>
+
+ Hello World!
+<P>
+
+To permanently trust a given server for your own use
+<P>
+
+<B> $ stap-authorize-server-cert </B><I>CERTFILE</I>
+
+<P>
+
+As root, to permanently trust a given server for all users on your host
+<P>
+
+<B> $ stap-authorize-server-cert </B><I>CERTFILE</I>
+
+<P>
+
+If a process id was echoed by
+<I>stap-start-server</I>
+
+or
+<I>stap-find-or-start-server</I>
+
+then you can stop the server using
+<P>
+
+<B> $ stap-stop-server </B><I>PID</I>
+
+<P>
+
+where <I>PID</I> is the process id that was echoed.
+<P>
+<A NAME="lbAI"> </A>
+<H2>SAFETY AND SECURITY</H2>
+
+Systemtap is an administrative tool. It exposes kernel internal data
+structures and potentially private user information. See the
+<I><A HREF="stap.1.html">stap</A></I>(1)
+
+manual page for additional information on safety and security.
+<P>
+<P>
+
+The systemtap server and its related utilities use the Secure Socket Layer
+(SSL) as implemented by Network Security Services (NSS)
+for network security. The NSS tool
+<I>certutil</I>
+
+is used for the generation of certificates. The related
+certificate databases must be protected in order to maintain the security of
+the system.
+Use of the utilities provided will help to ensure that the proper protection
+is maintained. The systemtap client and server will both check for proper
+access permissions before making use of any certificate database.
+<P>
+<A NAME="lbAJ"> </A>
+<H2>SEE ALSO</H2>
+
+<I><A HREF="stap.1.html">stap</A></I>(1),
+
+<I><A HREF="staprun.8.html">staprun</A></I>(8),
+
+<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap),
+
+<I><A HREF="stapfuncs.3stap.html">stapfuncs</A></I>(3stap),
+
+<I><A HREF="stapex.3stap.html">stapex</A></I>(3stap),
+
+<I>NSS</I>,
+
+<I>certutil</I>
+
+<P>
+<A NAME="lbAK"> </A>
+<H2>BUGS</H2>
+
+Use the Bugzilla link off of the project web page or our mailing list.
+
+<B><A HREF="http://sources.redhat.com/systemtap/">http://sources.redhat.com/systemtap/</A></B>, <B><<A HREF="mailto:systemtap@sources.redhat.com">systemtap@sources.redhat.com</A>></B>.
+
+
+<P>
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
+<DT><A HREF="#lbAE">OPTIONS</A><DD>
+<DT><A HREF="#lbAF">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAG">SERVER MANAGEMENT</A><DD>
+<DT><A HREF="#lbAH">EXAMPLES</A><DD>
+<DT><A HREF="#lbAI">SAFETY AND SECURITY</A><DD>
+<DT><A HREF="#lbAJ">SEE ALSO</A><DD>
+<DT><A HREF="#lbAK">BUGS</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:55 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of STAP</TITLE>
+</HEAD><BODY>
+<H1>STAP</H1>
+Section: User Commands (1)<BR>Updated: 2009-11-17<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+stap - systemtap script translator/driver
+<P>
+
+
+
+<P>
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<BR>
+
+<B>stap</B>
+
+[
+<I>OPTIONS</I>
+
+]
+<I>FILENAME</I>
+
+[
+<I>ARGUMENTS</I>
+
+]
+<BR>
+
+<B>stap</B>
+
+[
+<I>OPTIONS</I>
+
+]
+<B>-</B>
+
+[
+<I>ARGUMENTS</I>
+
+]
+<BR>
+
+<B>stap</B>
+
+[
+<I>OPTIONS</I>
+
+]
+<B>-e</B><I> SCRIPT</I>
+
+[
+<I>ARGUMENTS</I>
+
+]
+<BR>
+
+<B>stap</B>
+
+[
+<I>OPTIONS</I>
+
+]
+<B>-l</B><I> PROBE</I>
+
+[
+<I>ARGUMENTS</I>
+
+]
+<BR>
+
+<B>stap</B>
+
+[
+<I>OPTIONS</I>
+
+]
+<B>-L</B><I> PROBE</I>
+
+[
+<I>ARGUMENTS</I>
+
+]
+<P>
+<A NAME="lbAD"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+The
+<I>stap</I>
+
+program is the front-end to the Systemtap tool. It accepts probing
+instructions (written in a simple scripting language), translates
+those instructions into C code, compiles this C code, and loads the
+resulting kernel module into a running Linux kernel to perform the
+requested system trace/probe functions. You can supply the script in
+a named file, from standard input, or from the command line. The
+program runs until it is interrupted by the user, or if the script
+voluntarily invokes the
+<I>exit()</I>
+
+function, or by sufficient number of soft errors.
+<P>
+
+The language, which is described in a later section, is strictly typed,
+declaration free, procedural, and inspired by
+<I>awk</I>.
+
+It allows source code points or events in the kernel to be associated
+with handlers, which are subroutines that are executed synchronously. It is
+somewhat similar conceptually to "breakpoint command lists" in the
+<I>gdb</I>
+
+debugger.
+<P>
+
+This manual corresponds to version 1.0.
+<P>
+<A NAME="lbAE"> </A>
+<H2>OPTIONS</H2>
+
+The systemtap translator supports the following options. Any other option
+prints a list of supported options.
+<DL COMPACT>
+<DT><B>-h</B>
+
+<DD>
+Show help message.
+<DT><B>-V</B>
+
+<DD>
+Show version message.
+<DT><B>-p</B><I> NUM</I>
+
+<DD>
+Stop after pass NUM. The passes are numbered 1-5: parse, elaborate,
+translate, compile, run. See the
+<B>PROCESSING</B>
+
+section for details.
+<DT><B>-v</B>
+
+<DD>
+Increase verbosity for all passes. Produce a larger volume of
+informative (?) output each time option repeated.
+<DT><B>--vp ABCDE</B>
+
+<DD>
+Increase verbosity on a per-pass basis. For example, "--vp 002"
+adds 2 units of verbosity to pass 3 only. The combination "-v --vp 00004"
+adds 1 unit of verbosity for all passes, and 4 more for pass 5.
+<DT><B>-k</B>
+
+<DD>
+Keep the temporary directory after all processing. This may be useful
+in order to examine the generated C code, or to reuse the compiled
+kernel object.
+<DT><B>-g</B>
+
+<DD>
+Guru mode. Enable parsing of unsafe expert-level constructs like
+embedded C.
+<DT><B>-P</B>
+
+<DD>
+Prologue-searching mode. Activate heuristics to work around incorrect
+debugging information for $target variables.
+<DT><B>-u</B>
+
+<DD>
+Unoptimized mode. Disable unused code elision during elaboration.
+<DT><B>-w</B>
+
+<DD>
+Suppressed warnings mode. Disables all warning messages.
+<DT><B>-b</B>
+
+<DD>
+Use bulk mode (percpu files) for kernel-to-user data transfer.
+<DT><B>-t</B>
+
+<DD>
+Collect timing information on the number of times probe executes
+and average amount of time spent in each probe.
+<DT><B>-s</B><I>NUM</I>
+
+<DD>
+Use NUM megabyte buffers for kernel-to-user data transfer. On a
+multiprocessor in bulk mode, this is a per-processor amount.
+<DT><B>-I</B><I> DIR</I>
+
+<DD>
+Add the given directory to the tapset search directory. See the
+description of pass 2 for details.
+<DT><B>-D</B><I> NAME=VALUE</I>
+
+<DD>
+Add the given C preprocessor directive to the module Makefile. These can
+be used to override limit parameters described below.
+<DT><B>-B</B><I> NAME=VALUE</I>
+
+<DD>
+Add the given make directive to the kernel module build's make invocation.
+These can be used to add or override kconfig options.
+<DT><B>-R</B><I> DIR</I>
+
+<DD>
+Look for the systemtap runtime sources in the given directory.
+<DT><B>-r</B><I> /DIR</I>
+
+<DD>
+Build for kernel in given build tree. Can also be set with the
+<I>SYSTEMTAP_RELEASE</I>
+
+environment variable.
+<DT><B>-r</B><I> RELEASE</I>
+
+<DD>
+Build for kernel in build tree
+<B>/lib/modules/RELEASE/build</B>.
+
+Can also be set with the
+<I>SYSTEMTAP_RELEASE</I>
+
+environment variable.
+<DT><B>-m</B><I> MODULE</I>
+
+<DD>
+Use the given name for the generated kernel object module, instead
+of a unique randomized name. The generated kernel object module is
+copied to the current directory.
+<DT><B>-d</B><I> MODULE</I>
+
+<DD>
+Add symbol/unwind information for the given module into the kernel object
+module. This may enable symbolic tracebacks from those modules/programs,
+even if they do not have an explicit probe placed into them.
+<DT><B>-o</B><I> FILE</I>
+
+<DD>
+Send standard output to named file. In bulk mode, percpu files will
+start with FILE_ (FILE_cpu with -F) followed by the cpu number.
+This supports <A HREF="strftime.3.html">strftime</A>(3) formats for FILE.
+<DT><B>-c</B><I> CMD</I>
+
+<DD>
+Start the probes, run CMD, and exit when CMD finishes.
+<DT><B>-x</B><I> PID</I>
+
+<DD>
+Sets target() to PID. This allows scripts to be written that filter on
+a specific process.
+<DT><B>-l</B><I> PROBE</I>
+
+<DD>
+Instead of running a probe script, just list all available probe
+points matching the given pattern. The pattern may include wildcards
+and aliases.
+<DT><B>-L</B><I> PROBE</I>
+
+<DD>
+Similar to "-l", but list probe points and script-level local variables.
+<DT><B>-F</B>
+
+<DD>
+Without -o option, load module and start probes, then detach from the module
+leaving the probes running.
+With -o option, run staprun in background as a daemon and show its pid.
+<DT><B>-S</B><I> size[,N]</I>
+
+<DD>
+Sets the maximum size of output file and the maximum number of output files.
+If the size of output file will exceed
+<B>size</B>
+
+, systemtap switches output file to the next file. And if the number of
+output files exceed
+<B>N</B>
+
+, systemtap removes the oldest output file. You can omit the second argument.
+<DT><B>--kelf</B>
+
+<DD>
+For names and addresses of functions to probe,
+consult the symbol tables in the kernel and modules.
+This can be useful if your kernel and/or modules were compiled
+without debugging information, or the function you want to probe
+is in an assembly-language file built without debugging information.
+See the
+<B>MAKING DO WITH SYMBOL TABLES</B>
+
+section for more information.
+<DT><B>--kmap</B><I>[=FILE]</I>
+
+<DD>
+For names and addresses of kernel functions to probe,
+consult the symbol table in the indicated text file.
+The default is /boot/System.map-VERSION.
+The contents of this file should be in the form of the default output from
+<I><A HREF="nm.1.html">nm</A></I>(1).
+
+Only symbols of type T or t are used.
+If you specify /proc/kallsyms or some other file in that format,
+where lines for module symbols contain a fourth column,
+reading of the symbol table stops with the first module symbol
+(which should be right after the last kernel symbol).
+As with
+<B>--kelf</B>,
+
+the symbol table in each module's .ko file will also be consulted.
+See the
+<B>MAKING DO WITH SYMBOL TABLES</B>
+
+section for more information.
+<DT><B>--ignore-vmlinux</B>
+
+<DD>
+For testing, act as though neither the uncompressed kernel (vmlinux)
+nor the kernel debugging information can be found.
+<DT><B>--ignore-dwarf</B>
+
+<DD>
+For testing, act as though vmlinux and modules lack debugging information.
+<DT><B>--skip-badvars</B>
+
+<DD>
+Ignore out of context variables and substitute with literal 0.
+<P>
+</DL>
+<A NAME="lbAF"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+Any additional arguments on the command line are passed to the script
+parser for substitution. See below.
+<P>
+<A NAME="lbAG"> </A>
+<H2>SCRIPT LANGUAGE</H2>
+
+<P>
+The systemtap script language resembles
+<I>awk</I>.
+
+There are two main outermost constructs: probes and functions. Within
+these, statements and expressions use C-like operator syntax and
+precedence.
+<P>
+<A NAME="lbAH"> </A>
+<H3>GENERAL SYNTAX</H3>
+
+Whitespace is ignored. Three forms of comments are supported:
+<DL COMPACT><DT><DD>
+<BR>
+
+<B>#</B> ... shell style, to the end of line, except for $# and @#
+
+<BR>
+
+<B>//</B> ... C++ style, to the end of line
+
+<BR>
+
+<B>/*</B> ... C style ... <B>*/</B>
+
+</DL>
+
+Literals are either strings enclosed in double-quotes (passing through
+the usual C escape codes with backslashes), or integers (in decimal,
+hexadecimal, or octal, using the same notation as in C). All strings
+are limited in length to some reasonable value (a few hundred bytes).
+Integers are 64-bit signed quantities, although the parser also accepts
+(and wraps around) values above positive 2**63.
+<P>
+
+In addition, script arguments given at the end of the command line may
+be inserted. Use
+<B>$1 ... $<NN></B>
+
+for insertion unquoted,
+<B>@1 ... @<NN></B>
+
+for insertion as a string literal. The number of arguments may be accessed
+through
+<B>$#</B>
+
+(as an unquoted number) or through
+<B>@#</B>
+
+(as a quoted number). These may be used at any place a token may begin,
+including within the preprocessing stage. Reference to an argument
+number beyond what was actually given is an error.
+<P>
+<A NAME="lbAI"> </A>
+<H3>PREPROCESSING</H3>
+
+A simple conditional preprocessing stage is run as a part of parsing.
+The general form is similar to the
+cond<B> ? </B>exp1<B> : </B>exp2
+
+ternary operator:
+
+<BR>
+
+<DL COMPACT><DT><DD>
+<PRE>
+<B>%(</B> CONDITION <B>%?</B> TRUE-TOKENS <B>%)</B>
+<B>%(</B> CONDITION <B>%?</B> TRUE-TOKENS <B>%:</B> FALSE-TOKENS <B>%)</B>
+
+</PRE>
+
+</DL>
+
+
+The CONDITION is either an expression whose format is determined by its
+first keyword, or a string literals comparison or a numeric literals
+comparison. It can be also composed of many alternatives and conjunctions
+of CONDITIONs (meant as in previous sentence) using || and && respectively.
+However, parentheses are not supported yet, so remembering that conjunction
+takes precedence over alternative is important.
+<P>
+
+If the first part is the identifier
+<B>kernel_vr</B> or <B>kernel_v</B>
+
+to refer to the kernel version number, with ("2.6.13-1.322FC3smp") or
+without ("2.6.13") the release code suffix, then
+the second part is one of the six standard numeric comparison operators
+<B><</B>, <B><=</B>, <B>==</B>, <B>!=</B>, <B>></B>, and <B>>=</B>,
+
+and the third part is a string literal that contains an RPM-style
+version-release value. The condition is deemed satisfied if the
+version of the target kernel (as optionally overridden by the
+<B>-r</B>
+
+option) compares to the given version string. The comparison is
+performed by the glibc function
+<B>strverscmp</B>.
+
+As a special case, if the operator is for simple equality
+(<B>==</B>),
+
+or inequality
+(<B>!=</B>),
+
+and the third part contains any wildcard characters
+(<B>*</B> or <B>?</B> or <B>[</B>),
+
+then the expression is treated as a wildcard (mis)match as evaluated
+by
+<B>fnmatch</B>.
+
+<P>
+
+If, on the other hand, the first part is the identifier
+<B>arch</B>
+
+to refer to the processor architecture (as named by the kernel
+build system ARCH/SUBARCH), then the second
+part is one of the two string comparison operators
+<B>==</B> or <B>!=</B>,
+
+and the third part is a string literal for matching it. This
+comparison is a wildcard (mis)match.
+<P>
+
+Similarly, if the first part is an identifier like
+<B>CONFIG_something</B>
+
+to refer to a kernel configuration option, then the second part is
+<B>==</B> or <B>!=</B>,
+
+and the third part is a string literal for matching the value
+(commonly "y" or "m"). Nonexistent or unset kernel configuration
+options are represented by the empty string. This comparison is also
+a wildcard (mis)match.
+<P>
+
+Otherwise, the CONDITION is expected to be a comparison between two string
+literals or two numeric literals. In this case, the arguments are the only
+variables usable.
+<P>
+
+The TRUE-TOKENS and FALSE-TOKENS are zero or more general parser
+tokens (possibly including nested preprocessor conditionals), and are
+pasted into the input stream if the condition is true or false. For
+example, the following code induces a parse error unless the target
+kernel version is newer than 2.6.5:
+
+<BR>
+
+<DL COMPACT><DT><DD>
+<PRE>
+%( kernel_v <= "2.6.5" %? **ERROR** %) # invalid token sequence
+
+</PRE>
+
+</DL>
+
+
+The following code might adapt to hypothetical kernel version drift:
+
+<BR>
+
+<DL COMPACT><DT><DD>
+<PRE>
+probe kernel.function (
+ %( kernel_v <= "2.6.12" %? "__mm_do_fault" %:
+ %( kernel_vr == "2.6.13*smp" %? "do_page_fault" %:
+ UNSUPPORTED %) %)
+) { /* ... */ }
+
+%( arch == "ia64" %?
+ probe syscall.vliw = kernel.function("vliw_widget") {}
+%)
+
+</PRE>
+
+</DL>
+
+
+<P>
+<A NAME="lbAJ"> </A>
+<H3>VARIABLES</H3>
+
+Identifiers for variables and functions are an alphanumeric sequence,
+and may include "_" and "$" characters. They may not start with a
+plain digit, as in C. Each variable is by default local to the probe
+or function statement block within which it is mentioned, and therefore
+its scope and lifetime is limited to a particular probe or function
+invocation.
+
+<P>
+
+Scalar variables are implicitly typed as either string or integer.
+Associative arrays also have a string or integer value, and a
+a tuple of strings and/or integers serving as a key. Here are a
+few basic expressions.
+
+<BR>
+
+<DL COMPACT><DT><DD>
+<PRE>
+var1 = 5
+var2 = "bar"
+array1 [pid()] = "name" # single numeric key
+array2 ["foo",4,i++] += 5 # vector of string/num/num keys
+if (["hello",5,4] in array2) println ("yes") # membership test
+
+</PRE>
+
+</DL>
+
+
+<P>
+
+The translator performs
+<I>type inference</I>
+
+on all identifiers, including array indexes and function parameters.
+Inconsistent type-related use of identifiers signals an error.
+<P>
+
+Variables may be declared global, so that they are shared amongst all
+probes and live as long as the entire systemtap session. There is one
+namespace for all global variables, regardless of which script file
+they are found within. A global declaration may be written at the
+outermost level anywhere, not within a block of code. Global
+variables which are written but never read will be displayed
+automatically at session shutdown. The following
+declaration marks a few variables as global. The translator will
+infer for each its value type, and if it is used as an array, its key
+types. Optionally, scalar globals may be initialized with a string
+or number literal.
+<DL COMPACT><DT><DD>
+<B>global</B> var1<B>,</B> var2<B>,</B> var3=4
+
+</DL>
+
+<P>
+
+Arrays are limited in size by the MAXMAPENTRIES variable -- see the
+<B>SAFETY AND SECURITY</B>
+
+section for details. Optionally, global arrays may be declared with a
+maximum size in brackets, overriding MAXMAPENTRIES for that array only.
+Note that this doesn't indicate the type of keys for the array, just the
+size.
+<DL COMPACT><DT><DD>
+<B>global</B> tiny_array[10]<B>,</B> normal_array<B>,</B> big_array[50000]
+
+</DL>
+
+
+<P>
+<A NAME="lbAK"> </A>
+<H3>STATEMENTS</H3>
+
+Statements enable procedural control flow. They may occur within
+functions and probe handlers. The total number of statements executed
+in response to any single probe event is limited to some number
+defined by a macro in the translated C code, and is in the
+neighbourhood of 1000.
+<DL COMPACT>
+<DT>EXP<DD>
+Execute the string- or integer-valued expression and throw away
+the value.
+<DT><B>{</B> STMT1 STMT2 ... <B>}</B>
+
+<DD>
+Execute each statement in sequence in this block. Note that
+separators or terminators are generally not necessary between statements.
+<DT><B>;</B>
+
+<DD>
+Null statement, do nothing. It is useful as an optional separator between
+statements to improve syntax-error detection and to handle certain
+grammar ambiguities.
+<DT><B>if</B> (EXP) STMT1 [ <B>else</B> STMT2 ]
+
+<DD>
+Compare integer-valued EXP to zero. Execute the first (non-zero)
+or second STMT (zero).
+<DT><B>while</B> (EXP) STMT
+
+<DD>
+While integer-valued EXP evaluates to non-zero, execute STMT.
+<DT><B>for</B> (EXP1; EXP2; EXP3) STMT
+
+<DD>
+Execute EXP1 as initialization. While EXP2 is non-zero, execute
+STMT, then the iteration expression EXP3.
+<DT><B>foreach</B> (VAR <B>in</B> ARRAY [ limit<B> EXP ]) STMT</B>
+
+<DD>
+Loop over each element of the named global array, assigning current
+key to VAR. The array may not be modified within the statement.
+By adding a single
+<B>+</B> or <B>-</B>
+
+operator after the VAR or the ARRAY identifier, the iteration will
+proceed in a sorted order, by ascending or descending index or value.
+Using the optional
+<B>limit</B>
+
+keyword limits the number of loop iterations to EXP times. EXP is
+evaluated once at the beginning of the loop.
+<DT><B>foreach</B> ([VAR1, VAR2, ...] <B>in</B> ARRAY [ limit<B> EXP ]) STMT</B>
+
+<DD>
+Same as above, used when the array is indexed with a tuple of keys.
+A sorting suffix may be used on at most one VAR or ARRAY identifier.
+<DT><B>break</B>, <B>continue</B>
+
+<DD>
+Exit or iterate the innermost nesting loop
+(<B>while</B> or <B>for</B> or <B>foreach</B>)
+
+statement.
+<DT><B>return</B> EXP
+
+<DD>
+Return EXP value from enclosing function. If the function's value is
+not taken anywhere, then a return statement is not needed, and the
+function will have a special "unknown" type with no return value.
+<DT><B>next</B>
+
+<DD>
+Return now from enclosing probe handler.
+<DT><B>delete</B> ARRAY[INDEX1, INDEX2, ...]
+
+<DD>
+Remove from ARRAY the element specified by the index tuple. The value will no
+longer be available, and subsequent iterations will not report the element.
+It is not an error to delete an element that does not exist.
+<DT><B>delete</B> ARRAY
+
+<DD>
+Remove all elements from ARRAY.
+<DT><B>delete</B> SCALAR
+
+<DD>
+Removes the value of SCALAR. Integers and strings are cleared to 0 and ""
+respectively, while statistics are reset to the initial empty state.
+<P>
+</DL>
+<A NAME="lbAL"> </A>
+<H3>EXPRESSIONS</H3>
+
+Systemtap supports a number of operators that have the same general syntax,
+semantics, and precedence as in C and awk. Arithmetic is performed as per
+typical C rules for signed integers. Division by zero or overflow is
+detected and results in an error.
+<DL COMPACT>
+<DT>binary numeric operators<DD>
+<B>* / % + - >> << & ^ | && ||</B>
+
+<DT>binary string operators<DD>
+<B>.</B>
+
+(string concatenation)
+<DT>numeric assignment operators<DD>
+<B>= *= /= %= += -= >>= <<= &= ^= |=</B>
+
+<DT>string assignment operators<DD>
+<B>= .=</B>
+
+<DT>unary numeric operators<DD>
+<B>+ - ! ~ ++ --</B>
+
+<DT>binary numeric or string comparison operators<DD>
+<B>< > <= >= == !=</B>
+
+<DT>ternary operator<DD>
+cond<B> ? </B>exp1<B> : </B>exp2
+
+<DT>grouping operator<DD>
+<B>(</B> exp <B>)</B>
+
+<DT>function call<DD>
+fn <B>(</B>[ arg1, arg2, ... ]<B>)</B>
+
+<DT>array membership check<DD>
+exp<B> in </B>array
+
+<BR>
+
+<B>[</B>exp1<B>, </B>exp2<B>, </B>...<B>] in </B>array
+
+<P>
+</DL>
+<A NAME="lbAM"> </A>
+<H3>PROBES</H3>
+
+The main construct in the scripting language identifies probes.
+Probes associate abstract events with a statement block ("probe
+handler") that is to be executed when any of those events occur. The
+general syntax is as follows:
+
+<BR>
+
+<DL COMPACT><DT><DD>
+<PRE>
+<B>probe</B> PROBEPOINT [<B>,</B> PROBEPOINT] <B>{</B> [STMT ...] <B>}</B>
+
+</PRE>
+
+</DL>
+
+
+<P>
+
+Events are specified in a special syntax called "probe points". There
+are several varieties of probe points defined by the translator, and
+tapset scripts may define further ones using aliases. These are
+listed in the
+<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
+
+manual pages.
+<P>
+
+The probe handler is interpreted relative to the context of each
+event. For events associated with kernel code, this context may
+include
+<I>variables</I>
+
+defined in the
+<I>source code</I>
+
+at that spot. These "target variables" are presented to the script as
+variables whose names are prefixed with "$". They may be accessed
+only if the kernel's compiler preserved them despite optimization.
+This is the same constraint that a debugger user faces when working
+with optimized code. Some other events have very little context.
+<P>
+
+New probe points may be defined using "aliases". Probe point aliases
+look similar to probe definitions, but instead of activating a probe
+at the given point, it just defines a new probe point name as an alias
+to an existing one. There are two types of alias, i.e. the prologue
+style and the epilogue style which are identified by "=" and "+="
+respectively.
+<P>
+
+For prologue style alias, the statement block that follows an alias
+definition is implicitly added as a prologue to any probe that refers
+to the alias. While for the epilogue style alias, the statement block
+that follows an alias definition is implicitly added as an epilogue to
+any probe that refers to the alias. For example:
+<P>
+
+<BR>
+
+<DL COMPACT><DT><DD>
+<PRE>
+probe syscall.read = kernel.function("sys_read") {
+ fildes = $fd
+ if (execname == "init") next # skip rest of probe
+}
+
+</PRE>
+
+</DL>
+
+
+defines a new probe point
+
+<I>syscall.read</I>,
+
+
+which expands to
+
+<I>kernel.function(sys_read)</I>,
+
+
+with the given statement as a prologue, which is useful to predefine
+some variables for the alias user and/or to skip probe processing
+entirely based on some conditions. And
+
+<BR>
+
+<DL COMPACT><DT><DD>
+<PRE>
+probe syscall.read += kernel.function("sys_read") {
+ if (tracethis) println ($fd)
+}
+
+</PRE>
+
+</DL>
+
+
+defines a new probe point with the given statement as an epilogue, which
+is useful to take actions based upon variables set or left over by the
+the alias user.
+<P>
+An alias is used just like a built-in probe type.
+
+<BR>
+
+<DL COMPACT><DT><DD>
+<PRE>
+probe syscall.read {
+ printf("reading fd=%d, fildes)
+ if (fildes > 10) tracethis = 1
+}
+
+</PRE>
+
+</DL>
+
+
+<P>
+<A NAME="lbAN"> </A>
+<H3>FUNCTIONS</H3>
+
+Systemtap scripts may define subroutines to factor out common work.
+Functions take any number of scalar (integer or string) arguments, and
+must return a single scalar (integer or string). An example function
+declaration looks like this:
+
+<BR>
+
+<DL COMPACT><DT><DD>
+<PRE>
+function thisfn (arg1, arg2) {
+ return arg1 + arg2
+}
+
+</PRE>
+
+</DL>
+
+
+Note the general absence of type declarations, which are instead
+inferred by the translator. However, if desired, a function
+definition may include explicit type declarations for its return value
+and/or its arguments. This is especially helpful for embedded-C
+functions. In the following example, the type inference engine need
+only infer type type of arg2 (a string).
+
+<BR>
+
+<DL COMPACT><DT><DD>
+<PRE>
+function thatfn:string (arg1:long, arg2) {
+ return sprint(arg1) . arg2
+}
+
+</PRE>
+
+</DL>
+
+
+Functions may call others or themselves
+recursively, up to a fixed nesting limit. This limit is defined by
+a macro in the translated C code and is in the neighbourhood of 10.
+<P>
+<A NAME="lbAO"> </A>
+<H3>PRINTING</H3>
+
+There are a set of function names that are specially treated by the
+translator. They format values for printing to the standard systemtap
+output stream in a more convenient way. The
+<I>sprint*</I>
+
+variants return the formatted string instead of printing it.
+<DL COMPACT>
+<DT><B>print</B>, <B>sprint</B>
+
+<DD>
+Print one or more values of any type, concatenated directly together.
+<DT><B>println</B>, <B>sprintln</B>
+
+<DD>
+Print values like
+<I>print</I> and <I>sprint</I>,
+
+but also append a newline.
+<DT><B>printd</B>, <B>sprintd</B>
+
+<DD>
+Take a string delimiter and two or more values of any type, and print the
+values with the delimiter interposed. The delimiter must be a literal
+string constant.
+<DT><B>printdln</B>, <B>sprintdln</B>
+
+<DD>
+Print values with a delimiter like
+<I>printd</I> and <I>sprintd</I>,
+
+but also append a newline.
+<DT><B>printf</B>, <B>sprintf</B>
+
+<DD>
+Take a formatting string and a number of values of corresponding types,
+and print them all. The format must be a literal string constant.
+</DL>
+<P>
+
+The
+<I>printf</I>
+
+formatting directives similar to those of C, except that they are
+fully type-checked by the translator:
+<DL COMPACT><DT><DD>
+<DL COMPACT>
+<DT>%b<DD>
+Writes a binary blob of the value given, instead of ASCII text. The width specifier determines the number of bytes to write; valid specifiers are %b %1b %2b %4b %8b. Default (%b) is 8 bytes.
+<DT>%c<DD>
+Character.
+<DT>%d,%i<DD>
+Signed decimal.
+<DT>%m<DD>
+Safely reads kernel memory at the given address, outputs its content. The precision specifier determines the number of bytes to read. Default is 1 byte.
+<DT>%M<DD>
+Same as %m, but outputs in hexadecimal. The minimal size of output is double the precision specifier.
+<DT>%o<DD>
+Unsigned octal.
+<DT>%p<DD>
+Unsigned pointer address.
+<DT>%s<DD>
+String.
+<DT>%u<DD>
+Unsigned decimal.
+<DT>%x<DD>
+Unsigned hex value, in all lower-case.
+<DT>%X<DD>
+Unsigned hex value, in all upper-case.
+<DT>%%<DD>
+Writes a %.
+</DL>
+</DL>
+
+<P>
+
+Examples:
+
+<BR>
+
+<DL COMPACT><DT><DD>
+<PRE>
+ a = "alice", b = "bob", p = 0x1234abcd, i = 123, j = -1, id[a] = 1234, id[b] = 4567
+ print("hello")
+ Prints: hello
+ println(b)
+ Prints: bob\n
+ println(a . " is " . sprint(16))
+ Prints: alice is 16
+ foreach (name in id) printdln("|", strlen(name), name, id[name])
+ Prints: 5|alice|1234\n3|bob|4567
+ printf("%c is %s; %x or %X or %p; %d or %u\n",97,a,p,p,p,j,j)
+ Prints: a is alice; 1234abcd or 1234ABCD or 0x1234abcd; -1 or 18446744073709551615\n
+ printf("2 bytes of kernel buffer at address %p: %2m", p, p)
+ Prints: 2 byte of kernel buffer at address 0x1234abcd: <binary data>
+ printf("%4b", p)
+ Prints (these values as binary data): 0x1234abcd
+
+</PRE>
+
+</DL>
+
+
+<P>
+<A NAME="lbAP"> </A>
+<H3>STATISTICS</H3>
+
+It is often desirable to collect statistics in a way that avoids the
+penalties of repeatedly exclusive locking the global variables those
+numbers are being put into. Systemtap provides a solution using a
+special operator to accumulate values, and several pseudo-functions to
+extract the statistical aggregates.
+<P>
+
+The aggregation operator is
+<I><<<</I>,
+
+and resembles an assignment, or a C++ output-streaming operation.
+The left operand specifies a scalar or array-index lvalue, which must
+be declared global. The right operand is a numeric expression. The
+meaning is intuitive: add the given number to the pile of numbers to
+compute statistics of. (The specific list of statistics to gather
+is given separately, by the extraction functions.)
+
+<BR>
+
+<DL COMPACT><DT><DD>
+<PRE>
+ foo <<< 1
+ stats[pid()] <<< memsize
+
+</PRE>
+
+</DL>
+
+
+<P>
+
+The extraction functions are also special. For each appearance of a
+distinct extraction function operating on a given identifier, the
+translator arranges to compute a set of statistics that satisfy it.
+The statistics system is thereby "on-demand". Each execution of
+an extraction function causes the aggregation to be computed for
+that moment across all processors.
+<P>
+
+Here is the set of extractor functions. The first argument of each is
+the same style of lvalue used on the left hand side of the accumulate
+operation. The
+<I>@count(v)</I>, <I>@sum(v)</I>, <I>@min(v)</I>, <I>@max(v)</I>, <I>@avg(v)</I>
+
+extractor functions compute the number/total/minimum/maximum/average
+of all accumulated values. The resulting values are all simple
+integers.
+<P>
+
+Histograms are also available, but are more complicated because they
+have a vector rather than scalar value.
+<I>@hist_linear(v,start,stop,interval)</I>
+
+represents a linear histogram from "start" to "stop" by increments
+of "interval". The interval must be positive. Similarly,
+<I>@hist_log(v)</I>
+
+represents a base-2 logarithmic histogram. Printing a histogram
+with the
+<I>print</I>
+
+family of functions renders a histogram object as a tabular
+"ASCII art" bar chart.
+
+<BR>
+
+<DL COMPACT><DT><DD>
+<PRE>
+probe foo {
+ x <<< $value
+}
+probe end {
+ printf ("avg %d = sum %d / count %d\n",
+ @avg(x), @sum(x), @count(x))
+ print (@hist_log(v))
+}
+
+</PRE>
+
+</DL>
+
+
+<P>
+<A NAME="lbAQ"> </A>
+<H3>TYPECASTING</H3>
+
+Once a pointer has been saved into a script integer variable, the
+translator loses the type information necessary to access members from
+that pointer. Using the
+<I>@cast()</I>
+
+operator tells the translator how to read a pointer.
+
+<BR>
+
+<DL COMPACT><DT><DD>
+<PRE>
+@cast(p, "type_name"[, "module"])->member
+
+</PRE>
+
+</DL>
+
+
+<P>
+
+This will interpret
+<I>p</I>
+
+as a pointer to a struct/union named
+<I>type_name</I>
+
+and dereference the
+<I>member</I>
+
+value. The optional
+<I>module</I>
+
+tells the translator where to look for information about that type.
+Multiple modules may be specified as a list with
+<I>:</I>
+
+separators. If the module is not specified, it will default either to
+the probe module for dwarf probes, or to "kernel" for functions and all
+other probes types.
+<P>
+
+The translator can create its own module with type information from a header
+surrounded by angle brackets, in case normal debuginfo is not available. For
+kernel headers, prefix it with "kernel" to use the appropriate build system.
+All other headers are build with default GCC parameters into a user module.
+
+<BR>
+
+<DL COMPACT><DT><DD>
+<PRE>
+@cast(tv, "timeval", "<<A HREF="file:/usr/include/sys/time.h">sys/time.h</A>>")->tv_sec
+@cast(task, "task_struct", "kernel<<A HREF="file:/usr/include/linux/sched.h">linux/sched.h</A>>")->tgid
+
+</PRE>
+
+</DL>
+
+
+<P>
+
+When in guru mode, the translator will also allow scripts to assign new
+values to members of typecasted pointers.
+<P>
+
+Typecasting is also useful in the case of
+<I>void*</I>
+
+members whose type may be determinable at runtime.
+
+<BR>
+
+<DL COMPACT><DT><DD>
+<PRE>
+probe foo {
+ if ($var->type == 1) {
+ value = @cast($var->data, "type1")->bar
+ } else {
+ value = @cast($var->data, "type2")->baz
+ }
+ print(value)
+}
+
+</PRE>
+
+</DL>
+
+
+<P>
+<A NAME="lbAR"> </A>
+<H3>EMBEDDED C</H3>
+
+When in guru mode, the translator accepts embedded code in the
+script. Such code is enclosed between
+<I>%{</I>
+
+and
+<I>%}</I>
+
+markers, and is transcribed verbatim, without analysis, in some
+sequence, into the generated C code. At the outermost level, this may
+be useful to add
+<I>#include</I>
+
+instructions, and any auxiliary definitions for use by other embedded
+code.
+<P>
+
+The other place where embedded code is permitted is as a function body.
+In this case, the script language body is replaced entirely by a piece
+of C code enclosed again between
+<I>%{</I> and <I>%}</I>
+
+markers.
+This C code may do anything reasonable and safe. There are a number
+of undocumented but complex safety constraints on atomicity,
+concurrency, resource consumption, and run time limits, so this
+is an advanced technique.
+<P>
+
+The memory locations set aside for input and output values
+are made available to it using a macro
+<I>THIS</I>.
+
+Here are some examples:
+
+<BR>
+
+<DL COMPACT><DT><DD>
+<PRE>
+function add_one (val) %{
+ THIS->__retvalue = THIS->val + 1;
+%}
+function add_one_str (val) %{
+ strlcpy (THIS->__retvalue, THIS->val, MAXSTRINGLEN);
+ strlcat (THIS->__retvalue, "one", MAXSTRINGLEN);
+%}
+
+</PRE>
+
+</DL>
+
+
+The function argument and return value types have to be inferred by
+the translator from the call sites in order for this to work. The
+user should examine C code generated for ordinary script-language
+functions in order to write compatible embedded-C ones.
+<P>
+<A NAME="lbAS"> </A>
+<H3>BUILT-INS</H3>
+
+A set of builtin functions and probe point aliases are provided
+by the scripts installed under the
+
+<I>share/systemtap/tapset</I>
+
+
+directory. These are described in the
+<I><A HREF="stapfuncs.3stap.html">stapfuncs</A></I>(3stap) and <I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
+
+manual pages.
+<P>
+<A NAME="lbAT"> </A>
+<H2>PROCESSING</H2>
+
+The translator begins pass 1 by parsing the given input script,
+and all scripts (files named
+<I>*.stp</I>)
+
+found in a tapset directory. The directories listed
+with
+<B>-I</B>
+
+are processed in sequence, each processed in "guru mode". For each
+directory, a number of subdirectories are also searched. These
+subdirectories are derived from the selected kernel version (the
+<B>-R</B>
+
+option),
+in order to allow more kernel-version-specific scripts to override less
+specific ones. For example, for a kernel version
+<I>2.6.12-23.FC3</I>
+
+the following patterns would be searched, in sequence:
+<I>2.6.12-23.FC3/*.stp</I>,
+
+<I>2.6.12/*.stp</I>,
+
+<I>2.6/*.stp</I>,
+
+and finally
+<I>*.stp</I>
+
+Stopping the translator after pass 1 causes it to print the parse trees.
+<P>
+<P>
+
+In pass 2, the translator analyzes the input script to resolve symbols
+and types. References to variables, functions, and probe aliases that
+are unresolved internally are satisfied by searching through the
+parsed tapset scripts. If any tapset script is selected because it
+defines an unresolved symbol, then the entirety of that script is
+added to the translator's resolution queue. This process iterates
+until all symbols are resolved and a subset of tapset scripts is
+selected.
+<P>
+
+Next, all probe point descriptions are validated
+against the wide variety supported by the translator. Probe points that
+refer to code locations ("synchronous probe points") require the
+appropriate kernel debugging information to be installed. In the
+associated probe handlers, target-side variables (whose names begin
+with "$") are found and have their run-time locations decoded.
+<P>
+
+Next, all probes and functions are analyzed for optimization
+opportunities, in order to remove variables, expressions, and
+functions that have no useful value and no side-effect. Embedded-C
+functions are assumed to have side-effects unless they include the
+magic string
+<B>/* pure */</B>.
+
+Since this optimization can hide latent code errors such as type
+mismatches or invalid $target variables, it sometimes may be useful
+to disable the optimizations with the
+<B>-u</B>
+
+option.
+<P>
+
+Finally, all variable, function, parameter, array, and index types are
+inferred from context (literals and operators). Stopping the
+translator after pass 2 causes it to list all the probes, functions,
+and variables, along with all inferred types. Any inconsistent or
+unresolved types cause an error.
+<P>
+<P>
+
+In pass 3, the translator writes C code that represents the actions
+of all selected script files, and creates a
+<I>Makefile</I>
+
+to build that into a kernel object. These files are placed into a
+temporary directory. Stopping the translator at this point causes
+it to print the contents of the C file.
+<P>
+<P>
+
+In pass 4, the translator invokes the Linux kernel build system to
+create the actual kernel object file. This involves running
+<I>make</I>
+
+in the temporary directory, and requires a kernel module build
+system (headers, config and Makefiles) to be installed in the usual
+spot
+<I>/lib/modules/VERSION/build</I>.
+
+Stopping the translator after pass 4 is the last chance before
+running the kernel object. This may be useful if you want to
+archive the file.
+<P>
+<P>
+
+In pass 5, the translator invokes the systemtap auxiliary program
+<I>staprun</I>
+
+program for the given kernel object. This program arranges to load
+the module then communicates with it, copying trace data from the
+kernel into temporary files, until the user sends an interrupt signal.
+Any run-time error encountered by the probe handlers, such as running
+out of memory, division by zero, exceeding nesting or runtime limits,
+results in a soft error indication. Soft errors in excess of
+MAXERRORS block of all subsequent probes (except error-handling
+probes), and terminate the session. Finally,
+<I>staprun</I>
+
+unloads the module, and cleans up.
+<P>
+<A NAME="lbAU"> </A>
+<H3>ABNORMAL TERMINATION</H3>
+
+<P>
+One should avoid killing the stap process forcibly, for example with
+SIGKILL, because the stapio process (a child process of the stap
+process) and the loaded module may be left running on the system. If
+this happens, send SIGTERM or SIGINT to any remaining stapio
+processes, then use rmmod to unload the systemtap module.
+<P>
+<P>
+<A NAME="lbAV"> </A>
+<H2>EXAMPLES</H2>
+
+See the
+<I><A HREF="stapex.3stap.html">stapex</A></I>(3stap)
+
+manual page for a collection of samples.
+<P>
+<A NAME="lbAW"> </A>
+<H2>CACHING</H2>
+
+The systemtap translator caches the pass 3 output (the generated C
+code) and the pass 4 output (the compiled kernel module) if pass 4
+completes successfully. This cached output is reused if the same
+script is translated again assuming the same conditions exist (same kernel
+version, same systemtap version, etc.). Cached files are stored in
+the
+<I>$SYSTEMTAP_DIR/cache</I>
+
+directory. The cache can be limited by having the file
+<I>cache_mb_limit</I>
+
+placed in the cache directory (shown above) containing only an ASCII
+integer representing how many MiB the cache should not exceed. Note that
+this is a 'soft' limit in that the cache will be cleaned after a new entry
+is added, so the total cache size may temporarily exceed this limit. In the
+absence of this file, a default will be created with the limit set to 64MiB.
+<P>
+<A NAME="lbAX"> </A>
+<H2>SAFETY AND SECURITY</H2>
+
+Systemtap is an administrative tool. It exposes kernel internal data
+structures and potentially private user information.
+It acquires
+either root privileges
+<P>
+To actually run the kernel objects it builds, a user must be one of
+the following:
+<DL COMPACT>
+<DT>*<DD>
+the root user;
+<DT>*<DD>
+a member of the
+<I>stapdev</I>
+
+group; or
+<DT>*<DD>
+a member of the
+<I>stapusr</I>
+
+group. Members of the
+<I>stapusr</I>
+
+group can only use modules located in
+the /lib/modules/VERSION/systemtap directory. This directory
+must be owned by root and not be world writable.
+</DL>
+<P>
+
+The kernel modules generated by
+<I>stap</I>
+
+program are run by the
+<I>staprun</I>
+
+program. The latter is a part of the Systemtap package, dedicated to
+module loading and unloading (but only in the white zone), and
+kernel-to-user data transfer. Since
+<I>staprun</I>
+
+does not perform any additional security checks on the kernel objects
+it is given, it would be unwise for a system administrator to add
+untrusted users to the
+<I>stapdev</I>
+
+or
+<I>stapusr</I>
+
+groups.
+<P>
+
+The translator asserts certain safety constraints. It aims to ensure
+that no handler routine can run for very long, allocate memory,
+perform unsafe operations, or in unintentionally interfere with the
+kernel. Use of script global variables is suitably locked to protect
+against manipulation by concurrent probe handlers. Use of guru mode
+constructs such as embedded C can violate these constraints, leading
+to kernel crash or data corruption.
+<P>
+
+The resource use limits are set by macros in the generated C code.
+These may be overridden with the
+<B>-D</B>
+
+flag. A selection of these is as follows:
+<DL COMPACT>
+<DT>MAXNESTING<DD>
+Maximum number of nested function calls. Default determined by
+script analysis, with a bonus 10 slots added for recursive
+scripts.
+<DT>MAXSTRINGLEN<DD>
+Maximum length of strings, default 128.
+<DT>MAXTRYLOCK<DD>
+Maximum number of iterations to wait for locks on global variables
+before declaring possible deadlock and skipping the probe, default 1000.
+<DT>MAXACTION<DD>
+Maximum number of statements to execute during any single probe hit
+(with interrupts disabled),
+default 1000.
+<DT>MAXACTION_INTERRUPTIBLE<DD>
+Maximum number of statements to execute during any single probe hit
+which is executed with interrupts enabled (such as begin/end probes),
+default (MAXACTION * 10).
+<DT>MAXMAPENTRIES<DD>
+Maximum number of rows in any single global array, default 2048.
+<DT>MAXERRORS<DD>
+Maximum number of soft errors before an exit is triggered, default 0, which
+means that the first error will exit the script.
+<DT>MAXSKIPPED<DD>
+Maximum number of skipped probes before an exit is triggered, default 100.
+Running systemtap with -t (timing) mode gives more details about skipped
+probes. With the default -DINTERRUPTIBLE=1 setting, probes skipped due to
+reentrancy are not accumulated against this limit.
+<DT>MINSTACKSPACE<DD>
+Minimum number of free kernel stack bytes required in order to
+run a probe handler, default 1024. This number should be large enough
+for the probe handler's own needs, plus a safety margin.
+<DT>MAXUPROBES<DD>
+Maximum number of concurrently armed user-space probes (uprobes), default
+somewhat larger than the number of user-space probe points named in the script.
+This pool needs to be potentialy large because individual uprobe objects (about
+64 bytes each) are allocated for each process for each matching script-level probe.
+<P>
+</DL>
+<P>
+
+With scripts that contain probes on any interrupt path, it is possible that
+those interrupts may occur in the middle of another probe handler. The probe
+in the interrupt handler would be skipped in this case to avoid reentrance.
+To work around this issue, execute stap with the option
+<B>-DINTERRUPTIBLE=0</B>
+
+to mask interrupts throughout the probe handler. This does add some extra
+overhead to the probes, but it may prevent reentrance for common problem
+cases. However, probes in NMI handlers and in the callpath of the stap
+runtime may still be skipped due to reentrance.
+<P>
+<P>
+
+Multiple scripts can write data into a relay buffer concurrently. A host
+script provides an interface for accessing its relay buffer to guest scripts.
+Then, the output of the guests are merged into the output of the host.
+To run a script as a host, execute stap with
+<B>-DRELAYHOST[=name]</B>
+
+option. The
+<B>name</B>
+
+identifies your host script among several hosts.
+While running the host, execute stap with
+<B>-DRELAYGUEST[=name]</B>
+
+to add a guest script to the host.
+Note that you must unload guests before unloading a host. If there are some
+guests connected to the host, unloading the host will be failed.
+<P>
+<P>
+
+In case something goes wrong with
+<I>stap</I> or <I>staprun</I>
+
+after a probe has already started running, one may safely kill both
+user processes, and remove the active probe kernel module with
+<I>rmmod</I>.
+
+Any pending trace messages may be lost.
+<P>
+<P>
+
+In addition to the methods outlined above, the generated kernel module
+also uses overload processing to make sure that probes can't run for
+too long. If more than STP_OVERLOAD_THRESHOLD cycles (default
+500000000) have been spent in all the probes on a single cpu during
+the last STP_OVERLOAD_INTERVAL cycles (default 1000000000), the probes
+have overloaded the system and an exit is triggered.
+<P>
+
+By default, overload processing is turned on for all modules. If you
+would like to disable overload processing, define STP_NO_OVERLOAD.
+<P>
+<A NAME="lbAY"> </A>
+<H2>MAKING DO WITH SYMBOL TABLES</H2>
+
+Systemtap performs best when it has access to the debugging information
+associated with your kernel and modules.
+However, if this information is not available,
+systemtap can still support probing of function entries and returns
+using symbols read from vmlinux and/or the modules in /lib/modules.
+Systemtap can also read the kernel symbol table from a text file
+such as /boot/System.map or /proc/kallsyms.
+See the
+<B>--kelf</B>
+
+and
+<B>--kmap</B>
+
+options.
+<P>
+
+If systemtap finds relevant debugging information,
+it will use it even if you specify
+<B>--kelf</B>
+
+or
+<B>--kmap</B>.
+
+<P>
+
+Without debugging information, systemtap cannot support the
+following types of language constructs:
+<DL COMPACT>
+<DT>*<DD>
+probe specifications that refer to source files or line numbers
+<DT>*<DD>
+probe specifications that refer to inline functions
+<DT>*<DD>
+statements that refer to $target variables
+<DT>*<DD>
+statements that refer to @cast() variables
+<DT>*<DD>
+tapset-defined variables defined using any of the above constructs.
+In particular, at this writing,
+the prologue blocks for certain aliases in the syscall tapset
+(e.g., syscall.open) contain "if" statements that refer to $target variables.
+If your script refers to any such aliases,
+systemtap must have access to the kernel's debugging information.
+</DL>
+<P>
+
+Most T and t symbols correspond to function entry points, but some do not.
+Based only on the symbol table, systemtap cannot tell the difference.
+Placing return probes on symbols that aren't entry points
+will most likely lead to kernel stack corruption.
+<P>
+<A NAME="lbAZ"> </A>
+<H2>FILES</H2>
+
+
+<DL COMPACT>
+<DT>~/.systemtap<DD>
+Systemtap data directory for cached systemtap files, unless overridden
+by the
+<I>SYSTEMTAP_DIR</I>
+
+environment variable.
+<DT>/tmp/stapXXXXXX<DD>
+Temporary directory for systemtap files, including translated C code
+and kernel object.
+<DT>share/systemtap/tapset<DD>
+The automatic tapset search directory, unless overridden by
+the
+<I>SYSTEMTAP_TAPSET</I>
+
+environment variable.
+<DT>share/systemtap/runtime<DD>
+The runtime sources, unless overridden by the
+<I>SYSTEMTAP_RUNTIME</I>
+
+environment variable.
+<DT>/lib/modules/VERSION/build<DD>
+The location of kernel module building infrastructure.
+<DT>lib/debug/lib/modules/VERSION<DD>
+The location of kernel debugging information when packaged into the
+<I>kernel-debuginfo</I>
+
+RPM, unless overridden by the
+<I>SYSTEMTAP_DEBUGINFO_PATH</I>
+
+environment variable. The default value for this variable is
+<I>+:.debug:/usr/lib/debug:build</I>.
+
+Elfutils searches vmlinux in this path and it interprets the path as a base
+directory of which various subdirectories will be searched for finding modules.
+<DT>bin/staprun<DD>
+The auxiliary program supervising module loading, interaction, and
+unloading.
+<P>
+</DL>
+<A NAME="lbBA"> </A>
+<H2>SEE ALSO</H2>
+
+<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap),
+
+<I><A HREF="stapfuncs.3stap.html">stapfuncs</A></I>(3stap),
+
+<I><A HREF="stapvars.3stap.html">stapvars</A></I>(3stap),
+
+<I><A HREF="stapex.3stap.html">stapex</A></I>(3stap),
+
+<I><A HREF="awk.1.html">awk</A></I>(1),
+
+<I><A HREF="gdb.1.html">gdb</A></I>(1)
+
+<P>
+<A NAME="lbBB"> </A>
+<H2>BUGS</H2>
+
+Use the Bugzilla link off of the project web page or our mailing list.
+
+<B><A HREF="http://sources.redhat.com/systemtap/">http://sources.redhat.com/systemtap/</A></B>,<B><<A HREF="mailto:systemtap@sources.redhat.com">systemtap@sources.redhat.com</A>></B>.
+
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
+<DT><A HREF="#lbAE">OPTIONS</A><DD>
+<DT><A HREF="#lbAF">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAG">SCRIPT LANGUAGE</A><DD>
+<DL>
+<DT><A HREF="#lbAH">GENERAL SYNTAX</A><DD>
+<DT><A HREF="#lbAI">PREPROCESSING</A><DD>
+<DT><A HREF="#lbAJ">VARIABLES</A><DD>
+<DT><A HREF="#lbAK">STATEMENTS</A><DD>
+<DT><A HREF="#lbAL">EXPRESSIONS</A><DD>
+<DT><A HREF="#lbAM">PROBES</A><DD>
+<DT><A HREF="#lbAN">FUNCTIONS</A><DD>
+<DT><A HREF="#lbAO">PRINTING</A><DD>
+<DT><A HREF="#lbAP">STATISTICS</A><DD>
+<DT><A HREF="#lbAQ">TYPECASTING</A><DD>
+<DT><A HREF="#lbAR">EMBEDDED C</A><DD>
+<DT><A HREF="#lbAS">BUILT-INS</A><DD>
+</DL>
+<DT><A HREF="#lbAT">PROCESSING</A><DD>
+<DL>
+<DT><A HREF="#lbAU">ABNORMAL TERMINATION</A><DD>
+</DL>
+<DT><A HREF="#lbAV">EXAMPLES</A><DD>
+<DT><A HREF="#lbAW">CACHING</A><DD>
+<DT><A HREF="#lbAX">SAFETY AND SECURITY</A><DD>
+<DT><A HREF="#lbAY">MAKING DO WITH SYMBOL TABLES</A><DD>
+<DT><A HREF="#lbAZ">FILES</A><DD>
+<DT><A HREF="#lbBA">SEE ALSO</A><DD>
+<DT><A HREF="#lbBB">BUGS</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:52 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of STAPEX</TITLE>
+</HEAD><BODY>
+<H1>STAPEX</H1>
+Section: Misc. Reference Manual Pages (3stap)<BR>Updated: 2009-11-17<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+stapex - systemtap examples
+<P>
+
+
+
+<P>
+<A NAME="lbAC"> </A>
+<H2>LANGUAGE BASICS</H2>
+
+These examples give a feel for basic systemtap syntax and
+control structures.
+<P>
+
+<BR>
+
+<DL COMPACT><DT><DD>
+<PRE>
+global odds, evens
+
+probe begin {
+ # "no" and "ne" are local integers
+ for (i=0; i<10; i++) {
+ if (i % 2) odds [no++] = i
+ else evens [ne++] = i
+ }
+ delete odds[2]
+ delete evens[3]
+ exit ()
+}
+
+probe end {
+ foreach (x+ in odds) {
+ printf ("odds[%d] = %d, x, odds[x])
+ }
+ foreach (x in evens-) {
+ printf ("evens[%d] = %d, x, evens[x])
+ }
+}
+
+</PRE>
+
+</DL>
+
+
+This prints:
+
+<BR>
+
+<DL COMPACT><DT><DD>
+<PRE>
+odds[1] = 1
+odds[3] = 5
+odds[4] = 7
+odds[5] = 9
+evens[5] = 8
+evens[4] = 6
+evens[2] = 2
+evens[1] = 0
+
+</PRE>
+
+</DL>
+
+
+Note that all variables types are inferred, and that all locals
+and globals are automatically initialized.
+<P>
+<P>
+
+This script prints the primes between 0 and 49.
+
+<BR>
+
+<DL COMPACT><DT><DD>
+<PRE>
+function isprime (x) {
+ if (x < 2) return 0
+ for (i=2; i<x; i++) {
+ if (x % i == 0) return 0
+ if (i * i > x) break
+ }
+ return 1
+}
+probe begin {
+ for (i=0; i<50; i++)
+ if (isprime (i)) printf("%d, i)
+ exit()
+}
+
+</PRE>
+
+</DL>
+
+
+<P>
+<P>
+
+This script demonstrates recursive functions.
+
+<BR>
+
+<DL COMPACT><DT><DD>
+<PRE>
+function fibonacci(i) {
+ if (i < 1) error ("bad number")
+ if (i == 1) return 1
+ if (i == 2) return 2
+ return fibonacci (i-1) + fibonacci (i-2)
+}
+probe begin {
+ printf ("11th fibonacci number: %d, fibonacci (11))
+ exit ()
+}
+
+</PRE>
+
+</DL>
+
+
+Any larger number may exceed the MAXACTION or MAXNESTING
+limits, and result in an error.
+<P>
+<P>
+<A NAME="lbAD"> </A>
+<H2>PROBING</H2>
+
+<P>
+To trace entry and exit from a function, use a pair of probes:
+
+<BR>
+
+<DL COMPACT><DT><DD>
+<PRE>
+probe kernel.function("sys_mkdir") { println ("enter") }
+probe kernel.function("sys_mkdir").return { println ("exit") }
+
+</PRE>
+
+</DL>
+
+
+<P>
+To list the probeable functions in the kernel, use the listings mode.
+
+<BR>
+
+<DL COMPACT><DT><DD>
+<PRE>
+% stap -l [aq]kernel.function("*")[aq]
+
+</PRE>
+
+</DL>
+
+
+<P>
+To list the probeable functions and local variables in the kernel, use another listings mode.
+
+<BR>
+
+<DL COMPACT><DT><DD>
+<PRE>
+% stap -L [aq]kernel.function("*")[aq]
+
+</PRE>
+
+</DL>
+
+
+<P>
+<A NAME="lbAE"> </A>
+<H2>MORE EXAMPLES</H2>
+
+<P>
+Larger examples, demos and samples can be found in
+doc/systemtap*/examples, each example comes with either a .txt
+or .meta file explaining what the example, sample or demo does and how
+it is ordinarily run.
+<P>
+<A NAME="lbAF"> </A>
+<H2>SEE ALSO</H2>
+
+<B>doc/systemtap*/examples</B>
+
+<I><A HREF="stap.1.html">stap</A></I>(1)
+
+<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
+
+<I><A HREF="stapfuncs.3stap.html">stapfuncs</A></I>(3stap)
+
+<P>
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">LANGUAGE BASICS</A><DD>
+<DT><A HREF="#lbAD">PROBING</A><DD>
+<DT><A HREF="#lbAE">MORE EXAMPLES</A><DD>
+<DT><A HREF="#lbAF">SEE ALSO</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of STAPFUNCS</TITLE>
+</HEAD><BODY>
+<H1>STAPFUNCS</H1>
+Section: Misc. Reference Manual Pages (3stap)<BR>Updated: 2009-11-17<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+stapfuncs - systemtap functions
+<P>
+<A NAME="lbAC"> </A>
+<H2>DESCRIPTION</H2>
+
+The following sections enumerate the public functions provided by
+standard tapsets installed under share/systemtap/tapset. Each
+function is described with a signature, and its behavior/restrictions.
+The signature line includes the name of the function, the type of
+its return value (if any), and the names and types of all parameters.
+The syntax is the same as printed with the
+<I>stap</I> option <I>-p2</I>.
+
+Examples:
+<P>
+<DL COMPACT>
+<DT>example1:long (v:string, k:long)<DD>
+In function "example1", do something with the given string and integer.
+Return some integer.
+<P>
+<DT>example2:unknown ()<DD>
+In function "example2", do something. There is no explicit return value
+and take no parameters.
+<P>
+<P>
+</DL>
+<A NAME="lbAD"> </A>
+<H3>CONVERSIONS</H3>
+
+<P>
+
+These functions access kernel or user-space data. They try to validate the
+supplied addresses, and can thus result in errors if the pointers are invalid,
+or if a user-space access would cause a fault.
+<DL COMPACT>
+<DT>kernel_string:string (addr:long)<DD>
+Copy a 0-terminated string from kernel space at given address.
+<DT>kernel_string_n:string (addr:long, n:long)<DD>
+Similar with kernel_string, except that not more than n bytes are copied.
+Thus, if there are null bytes among the first n bytes, it is same as
+kernel_string(addr). If not, n bytes will be copied and a null byte will
+be padded to the end.
+<DT>kernel_long:long (addr:long)<DD>
+Copy a long from kernel space at given address.
+<DT>kernel_int:long (addr:long)<DD>
+Copy an int from kernel space at given address.
+<DT>kernel_short:long (addr:long)<DD>
+Copy a short from kernel space at given address.
+<DT>kernel_char:long (addr:long)<DD>
+Copy a char from kernel space at given address.
+<DT>user_string:string (addr:long)<DD>
+Copy a string from user space at given address. If the access would
+fault, return "<unknown>" and signal no errors.
+<DT>user_string2:string (addr:long, err_msg:string)<DD>
+Copy a string from user space at given address. If the access would
+fault, return instead the err_msg value.
+<DT>user_string_warn:string (addr:long)<DD>
+Copy a string from user space at given address. If the access would
+fault, signal a warning and return "<unknown>".
+<DT>user_string_quoted:string (addr:long)<DD>
+Copy a string from user space at given address. Any ASCII characters
+that are not printable are replaced by the corresponding escape
+sequence in the returned string.
+<DT>user_string_n:string (addr:long, n:long)<DD>
+Copy a string of n bytes from user space at given address. If the access
+would fault, return "<unknown>".
+<DT>user_string_n2:string (addr:long, n:long, err_msg:string)<DD>
+Copy a string of n bytes from user space at given address. If the access
+would fault, return the err_msg value.
+<DT>user_string_n_warn:string (addr:long, n:long)<DD>
+Copy a string of n bytes from user space at given address. If the access
+would fault, signal a warning and return "<unknown>".
+<DT>user_string_n_quoted:string (addr:long, n:long)<DD>
+Copy a string of n bytes from user space at given address. Any ASCII
+characters that are not printable are replaced by the corresponding escape
+sequence in the returned string. If the access would fault, return "<unknown>".
+<DT>user_short:long (addr:long)<DD>
+Copy a short from user space at given address. If the access would fault,
+return 0.
+<DT>user_short_warn:long (addr:long)<DD>
+Copy a short from user space at given address. If the access would fault,
+signal a warning and return 0.
+<DT>user_int:long (addr:long)<DD>
+Copy an int from user space at given address. If the access would fault,
+return 0.
+<DT>user_int_warn:long (addr:long)<DD>
+Copy an int from user space at given address. If the access would fault,
+signal a warning and return 0.
+<DT>user_long:long (addr:long)<DD>
+Copy a long from user space at given address. If the access would fault,
+return 0.
+<DT>user_long_warn:long (addr:long)<DD>
+Copy a long from user space at given address. If the access would fault,
+signal a warning and return 0.
+<DT>user_char:long (addr:long)<DD>
+Copy a char from user space at given address. If the access would fault,
+return 0.
+<DT>user_char_warn:long (addr:long)<DD>
+Copy a char from user space at given address. If the access would fault,
+signal a warning and return 0.
+</DL>
+<A NAME="lbAE"> </A>
+<H3>STRING</H3>
+
+<DL COMPACT>
+<DT>strlen:long (str:string)<DD>
+Return the number of characters in str.
+<DT>substr:string (str:string,start:long, stop:long)<DD>
+Return the substring of str starting from character start and ending at character stop.
+<DT>stringat:string (str:string,pos:long)<DD>
+Return the character in given position of string.
+<DT>isinstr:long (s1:string, s2:string)<DD>
+Return 1 if string s1 contains string s2, returns 0 otherwise.
+<DT>strtol:long (str:string, base:long)<DD>
+Convert the string representation of a number to a long using the numbering system
+specified by base. For example, strtol("1000", 16) returns 4096. Returns 0 if the
+string cannot be converted.
+<DT>tokenize:string (str:string, delim:string)<DD>
+Return the next non-empty token in the given str string, where the tokens are
+delimited by characters in the delim string. If the str string is not blank,
+it returns the first token. If the str string is blank, it returns the next
+token in the string passed in the previous call to tokenize. If no delimiter
+is found, the entire remaining str string is returned. Returns blank when
+no more tokens are left.
+<P>
+</DL>
+<A NAME="lbAF"> </A>
+<H3>TIMESTAMP</H3>
+
+<DL COMPACT>
+<DT>get_cycles:long ()<DD>
+Return the processor cycle counter value, or 0 if unavailable.
+<DT>gettimeofday_ns:long ()<DD>
+Return the number of nanoseconds since the UNIX epoch.
+<DT>gettimeofday_us:long ()<DD>
+Return the number of microseconds since the UNIX epoch.
+<DT>gettimeofday_ms:long ()<DD>
+Return the number of milliseconds since the UNIX epoch.
+<DT>gettimeofday_s:long ()<DD>
+Return the number of seconds since the UNIX epoch.
+<P>
+</DL>
+<A NAME="lbAG"> </A>
+<H3>CONTEXT INFO</H3>
+
+<DL COMPACT>
+<DT>cpu:long ()<DD>
+Return the current cpu number.
+<DT>execname:string ()<DD>
+Return the name of the current process.
+<DT>pexecname:string()<DD>
+Return the name of the parent process.
+<DT>tid:long ()<DD>
+Return the id of the current thread.
+<DT>pid:long ()<DD>
+Return the id of the current process.
+<DT>ppid:long ()<DD>
+Return the id of the parent process.
+<DT>pgrp:long ()<DD>
+Return the pgrp of the current process.
+<DT>sid:long ()<DD>
+Return the sid of the current process.
+<DT>uid:long ()<DD>
+Return the uid of the current process.
+<DT>euid:long ()<DD>
+Return the effective uid of the current process.
+<DT>gid:long ()<DD>
+Return the gid of the current process.
+<DT>egid:long ()<DD>
+Return the effective gid of the current process.
+<DT>print_regs:unknown ()<DD>
+Print a register dump.
+<DT>backtrace:string ()<DD>
+Return a string of hex addresses that are a backtrace of the stack.
+It may be truncated due to maximum string length.
+<DT>print_stack:unknown (bt:string)<DD>
+Perform a symbolic lookup of the addresses in the given string,
+which is assumed to be the result of a prior call to
+<I>backtrace()</I>.
+
+Print one line per address, including the address, the name of the
+function containing the address, and an estimate of its position
+within that function. Return nothing.
+<DT>print_backtrace:unknown ()<DD>
+Equivalent to
+<I>print_stack(backtrace())</I>,
+
+except that deeper stack nesting may be supported. Return nothing.
+<DT>pp:string ()<DD>
+Return the probe point associated with the currently running probe handler,
+including alias and wildcard expansion effects.
+<DT>probefunc:string ()<DD>
+Return the probe point's function name, if known.
+<DT>probemod:string ()<DD>
+Return the probe point's module name, if known.
+<DT>target:long ()<DD>
+Return the pid of the target process.
+<DT>user_mode:long ()<DD>
+Return 1 if the probe point occurred in user-mode.
+<DT>is_return:long ()<DD>
+Return 1 if the probe point is a return probe. Deprecated.
+<P>
+</DL>
+<A NAME="lbAH"> </A>
+<H3>TARGET_SET</H3>
+
+<DL COMPACT>
+<DT>target_set_pid:long (tid:long)<DD>
+Return whether the given process-id is within the "target set", that is whether
+it is a descendent of the top-level target() process.
+<DT>target_set_report:unknown ()<DD>
+Print a report about the target set, and their ancestry.
+<P>
+</DL>
+<A NAME="lbAI"> </A>
+<H3>ERRNO</H3>
+
+<DL COMPACT>
+<DT>errno_str:string (e:long)<DD>
+Return the symbolic string associated with the given error code, like
+"ENOENT" for the number 2, or "E#3333" for an out-of-range value like 3333.
+<P>
+</DL>
+<A NAME="lbAJ"> </A>
+<H3>TASK</H3>
+
+<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>
+<DL COMPACT>
+<DT>task_current:long()<DD>
+Return the task_struct of the current process.
+<P>
+<DT>task_parent:long(task:long)<DD>
+Return the parent task_struct of the given task.
+<DT>task_state:long(task:long)<DD>
+Return the state of the given task, which can be one of the following:
+<P>
+<BR> TASK_RUNNING 0
+<BR> TASK_INTERRUPTIBLE 1
+<BR> TASK_UNINTERRUPTIBLE 2
+<BR> TASK_STOPPED 4
+<BR> TASK_TRACED 8
+<BR> EXIT_ZOMBIE 16
+<BR> EXIT_DEAD 32
+<P>
+<DT>task_execname:string(task:long)<DD>
+Return the name of the given task.
+<P>
+<DT>task_pid:long(task:long)<DD>
+Return the process id of the given task.
+<P>
+<DT>task_tid:long(task:long)<DD>
+Return the thread id of the given task.
+<P>
+<DT>task_gid:long(task:long)<DD>
+Return the group id of the given task.
+<P>
+<DT>task_egid:long(task:long)<DD>
+Return the effective group id of the given task.
+<P>
+<DT>task_uid:long(task:long)<DD>
+Return the user id of the given task.
+<P>
+<DT>task_euid:long(task:long)<DD>
+Return the effective user id of the given task.
+<P>
+<DT>task_prio:long(task:long)<DD>
+Return the priority of the given task.
+<P>
+<DT>task_nice:long(task:long)<DD>
+Return the nice value of the given task.
+<P>
+<DT>task_cpu:long(task:long)<DD>
+Return the scheduled cpu for the given task.
+<P>
+<DT>task_open_file_handles:long(task:long)<DD>
+Return the number of open file handles for the given task.
+<P>
+<DT>task_max_file_handles:long(task:long)<DD>
+Return the maximum number of file handles for the given task.
+<P>
+<DT>pid2task:long(pid:long)<DD>
+Return the task of the given process id.
+<P>
+<DT>pid2execname:string(pid:long)<DD>
+Return the name of the given process id.
+<P>
+</DL>
+<A NAME="lbAK"> </A>
+<H3>CPU REGISTERS</H3>
+
+<DL COMPACT>
+<DT>registers_valid:long ()<DD>
+Return 1 if register() and u_register() can be used
+in the current context, or 0 otherwise.
+For example, registers_valid() returns 0 when called from a begin or end probe.
+<DT>register:long (name:string)<DD>
+Return the value of the named CPU register,
+as it was saved when the current probe point was hit.
+If the register is 32 bits, it is sign-extended to 64 bits.
+<P>
+For the i386 architecture, the following names are recognized.
+(name1/name2 indicates that name1 and name2 are alternative names
+for the same register.)
+eax/ax, ebp/bp, ebx/bx, ecx/cx, edi/di, edx/dx, eflags/flags,
+eip/ip, esi/si, esp/sp, orig_eax/orig_ax,
+xcs/cs, xds/ds, xes/es, xfs/fs, xss/ss.
+<P>
+For the x86_64 architecture, the following names are recognized:
+64-bit registers:
+r8, r9, r10, r11, r12, r13, r14, r15,
+rax/ax, rbp/bp, rbx/bx, rcx/cx, rdi/di, rdx/dx,
+rip/ip, rsi/si, rsp/sp;
+32-bit registers:
+eax, ebp, ebx, ecx, edx, edi, edx, eip, esi, esp, flags/eflags, orig_eax;
+segment registers: xcs/cs, xss/ss.
+<P>
+For powerpc, the following names are recognized:
+r0, r1, ... r31, nip, msr, orig_gpr3, ctr, link, xer, ccr, softe, trap,
+dar, dsisr, result.
+<P>
+For s390x, the following names are recognized:
+r0, r1, ... r15, args, psw.mask, psw.addr, orig_gpr2, ilc, trap.
+<P>
+<DT>u_register:long (name:string)<DD>
+Same as register(name), except that
+if the register is 32 bits, it is zero-extended to 64 bits.
+<P>
+</DL>
+<A NAME="lbAL"> </A>
+<H3>NUMBERED FUNCTION ARGUMENTS</H3>
+
+The functions in this section provide the values of a probed function's
+arguments.
+They can be called when you have hit
+a probe point at the entry to a function.
+Arguments are referred to by number, starting at 1.
+Ordinarily, you can access arguments by name as well,
+but you may find these functions useful if the code you are probing
+was built without debugging information.
+<P>
+On 32-bit architectures
+--- and when probing 32-bit applications on 64-bit architectures ---
+a 64-bit argument occupies two "arg slots."
+For example, if you are probing the following function
+<P>
+<BR> void f(int a, long long b, char *c)
+<P>
+you would refer to a, b, and c as <A HREF="int_arg.1.html">int_arg</A>(1), <A HREF="longlong_arg.2.html">longlong_arg</A>(2), and
+<A HREF="pointer_arg.3.html">pointer_arg</A>(3), respectively, on a 64-bit architecture;
+but on a 32-bit architecture, you would refer to c as <A HREF="pointer_arg.4.html">pointer_arg</A>(4)
+(since b occupies slots 2 and 3).
+<P>
+If the function you are probing doesn't follow the default rules
+for argument passing, you need to call one of the following functions
+(which see) in your handler before calling any *_arg function:
+asmlinkage(), fastcall(), or regparm().
+(This isn't necessary when referring to arguments only by name.)
+<DL COMPACT>
+<DT>int_arg:long (n:long)<DD>
+Return the value of argument n as a signed int
+(i.e., a 32-bit integer sign-extended to 64 bits).
+<DT>uint_arg:long (n:long)<DD>
+Return the value of argument n as an unsigned int
+(i.e., a 32-bit integer zero-extended to 64 bits).
+<DT>long_arg:long (n:long)<DD>
+Return the value of argument n as a signed long.
+On architectures where a long is 32 bits, the value is sign-extended to 64 bits.
+<DT>ulong_arg:long (n:long)<DD>
+Return the value of argument n as an unsigned long.
+On architectures where a long is 32 bits, the value is zero-extended to 64 bits.
+<DT>longlong_arg:long (n:long)<DD>
+Return the value of argument n as a 64-bit value.
+<DT>ulonglong_arg:long (n:long)<DD>
+Same as <A HREF="../mann/longlong_arg.n.html">longlong_arg</A>(n).
+<DT>pointer_arg:long (n:long)<DD>
+Same as <A HREF="../mann/ulong_arg.n.html">ulong_arg</A>(n).
+Use with any type of pointer.
+<DT>s32_arg:long (n:long)<DD>
+Same as <A HREF="../mann/int_arg.n.html">int_arg</A>(n).
+<DT>u32_arg:long (n:long)<DD>
+Same as <A HREF="../mann/uint_arg.n.html">uint_arg</A>(n).
+<DT>s64_arg:long (n:long)<DD>
+Same as <A HREF="../mann/longlong_arg.n.html">longlong_arg</A>(n).
+<DT>u64_arg:long (n:long)<DD>
+Same as [u]<A HREF="../mann/longlong_arg.n.html">longlong_arg</A>(n).
+<DT>asmlinkage:unknown ()<DD>
+The probed kernel function is declared asmlinkage in the source.
+<DT>fastcall:unknown ()<DD>
+The probed kernel function is declared fastcall in the source.
+<DT>regparm:unknown (n:long)<DD>
+The probed function was built with the gcc -mregparm=n option.
+(The i386 kernel is built with -mregparm=3, so systemtap considers
+<A HREF="regparm.3.html">regparm</A>(3) the default for kernel functions on that architecture.)
+<P>
+For some architectures, the *_arg functions may reject unusually high
+values of n.
+<P>
+</DL>
+<A NAME="lbAM"> </A>
+<H3>QUEUE_STATS</H3>
+
+<P>
+
+The queue_stats tapset provides functions that, given notifications of
+elementary queuing events (wait, run, done), tracks averages such as
+queue length, service and wait times, utilization. The following
+three functions should be called from appropriate probes, in sequence.
+<DL COMPACT>
+<DT>qs_wait:unknown (qname:string)<DD>
+Record that a new request was enqueued for the given queue name.
+<DT>qs_run:unknown (qname:string)<DD>
+Record that a previously enqueued request was removed from the given
+wait queue and is now being serviced.
+<DT>qs_done:unknown (qname:string)<DD>
+Record that a request originally from the given queue has completed
+being serviced.
+
+</DL>
+<P>
+
+Functions with the prefix
+<B>qsq_</B>
+
+are for querying the statistics averaged since the first queue operation
+(or when
+<B>qsq_start</B>
+
+was called). Since statistics are often fractional, a scale parameter
+is multiplies the result to a more useful scale. For some fractions,
+a scale of 100 will usefully return percentage numbers.
+<DL COMPACT>
+<DT>qsq_start:unknown (qname:string)<DD>
+Reset the statistics counters for the given queue, and start tracking
+anew from this moment.
+<DT>qsq_print:unknown (qname:string)<DD>
+Print a line containing a selection of the given queue's statistics.
+<DT>qsq_utilization:long (qname:string, scale:long)<DD>
+Return the fraction of elapsed time when the resource was utilized.
+<DT>qsq_blocked:long (qname:string, scale:long)<DD>
+Return the fraction of elapsed time when the wait queue was used.
+<DT>qsq_wait_queue_length:long (qname:string, scale:long)<DD>
+Return the average length of the wait queue.
+<DT>qsq_service_time:long (qname:string, scale:long)<DD>
+Return the average time required to service a request.
+<DT>qsq_wait_time:long (qname:string, scale:long)<DD>
+Return the average time a request took from being enqueued to completed.
+<DT>qsq_throughput:long (qname:string, scale:long)<DD>
+Return the average rate of requests per scale units of time.
+<P>
+</DL>
+<A NAME="lbAN"> </A>
+<H3>INDENT</H3>
+
+<P>
+
+The indent tapset provides functions to generate indented lines for
+nested kinds of trace messages. Each line contains a relative
+timestamp, and the process name / pid.
+<DL COMPACT>
+<DT>thread_indent:string (delta:long)<DD>
+Return a string with an appropriate indentation for this thread.
+Call it with a small positive or matching negative delta.
+If this is the outermost, initial level of indentation, reset the
+relative timestamp base to zero.
+<DT>thread_timestamp:long ()<DD>
+Return an absolute timestamp value for use by the indentation function.
+The default function uses
+<I>gettimeofday_us</I>
+
+<P>
+</DL>
+<A NAME="lbAO"> </A>
+<H3>SYSTEM</H3>
+
+<DL COMPACT>
+<DT>system (cmd:string)<DD>
+Runs a command on the system. The command will run in the background
+when the current probe completes.
+<P>
+</DL>
+<A NAME="lbAP"> </A>
+<H3>NUMA</H3>
+
+<DL COMPACT>
+<DT>addr_to_node:long (addr:long)<DD>
+Return which node the given address belongs to in a NUMA system.
+<P>
+</DL>
+<A NAME="lbAQ"> </A>
+<H3>CTIME</H3>
+
+<DL COMPACT>
+<DT>ctime:string (seconds:long)<DD>
+Return a simple textual rendering (e.g., "Wed Jun 30 21:49:008 1993")
+of the given number of seconds since the epoch, as perhaps returned by
+<I>gettimeofday_s()</I>.
+
+<P>
+</DL>
+<A NAME="lbAR"> </A>
+<H3>PERFMON</H3>
+
+<DL COMPACT>
+<DT>read_counter:long (handle:long)<DD>
+Returns the value for the processor's performance counter for the associated
+handle. The body of the a perfmon probe should set record
+the handle being used for that event.
+<P>
+</DL>
+<A NAME="lbAS"> </A>
+<H3>SOCKETS</H3>
+
+These functions convert arguments in the socket tapset back and
+forth between their numeric and string representations.
+See
+<I><A HREF="stapprobes.socket.3stap.html">stapprobes.socket</A></I>(3stap)
+
+for details.
+<P>
+<DL COMPACT>
+<DT>sock_prot_num2str:string (proto:long)<DD>
+Returns the string representation of the given protocol value.
+<DT>sock_prot_str2num:long (proto:string)<DD>
+Returns the numeric value associated with the given protocol string.
+<DT>sock_fam_num2str:string (family:long)<DD>
+Returns the string representation of the given protocol family value.
+<DT>sock_fam_str2num:long (family:string)<DD>
+Returns the numeric value associated with the given protocol family string.
+<DT>sock_state_num2str:string (state:long)<DD>
+Returns the string representation of the given socket state value.
+<DT>sock_state_str2num:long (state:string)<DD>
+Returns the numeric value associated with the given socket state string.
+<DT>sock_type_num2str:string (type:long)<DD>
+Returns the string representation of the given socket type value.
+<DT>sock_type_str2num:long (type:string)<DD>
+Returns the numeric value associated with the given socket type string.
+<DT>sock_flags_num2str:string (flags:long)<DD>
+Returns the string representation of the given socket flags value.
+<DT>msg_flags_num2str:string (flags:long)<DD>
+Returns the string representation of the given message flags bit map.
+<P>
+</DL>
+<A NAME="lbAT"> </A>
+<H3>INET</H3>
+
+These functions convert between network (big-endian) and host byte order, like their
+namesake C functions.
+<DL COMPACT>
+<DT>ntohll:long (x:long)<DD>
+Convert from network to host byte order, 64-bit.
+<DT>ntohl:long (x:long)<DD>
+Convert from network to host byte order, 32-bit.
+<DT>ntohs:long (x:long)<DD>
+Convert from network to host byte order, 16-bit.
+<DT>htonll:long (x:long)<DD>
+Convert from host to network byte order, 64-bit.
+<DT>htonl:long (x:long)<DD>
+Convert from host to network byte order, 32-bit.
+<DT>htons:long (x:long)<DD>
+Convert from host to network byte order, 16-bit.
+<P>
+</DL>
+<A NAME="lbAU"> </A>
+<H3>SIGNAL</H3>
+
+<DL COMPACT>
+<DT>get_sa_flags:long (act:long)<DD>
+Returns the numeric value of sa_flags.
+<DT>get_sa_handler:long (act:long)<DD>
+Returns the numeric value of sa_handler.
+<DT>sigset_mask_str:string (mask:long)<DD>
+Returns the string representation of the sigset sa_mask.
+<DT>is_sig_blocked:long (task:long, sig:long)<DD>
+Returns 1 if the signal is currently blocked, or 0 if it is not.
+<DT>sa_flags_str:string (sa_flags:long)<DD>
+Returns the string representation of sa_flags.
+<DT>sa_handler_str(handler)<DD>
+Returns the string representation of sa_handler. If it is not SIG_DFL, SIG_IGN
+or SIG_ERR, it will return the address of the handler.
+<DT>signal_str(num)<DD>
+Returns the string representation of the given signal number.
+<P>
+</DL>
+<A NAME="lbAV"> </A>
+<H3>DEVICE</H3>
+
+<DL COMPACT>
+<DT>MAJOR:long(dev:long)<DD>
+Extracts the major device number from a kernel device number (kdev_t).
+<DT>MINOR:long(dev:long)<DD>
+Extracts the minor device number from a kernel device number (kdev_t).
+<DT>MKDEV:long(major:long, minor:long)<DD>
+Creates a value that can be compared to a kernel device number (kdev_t).
+<DT>usrdev2kerndev:long(dev:long)<DD>
+Converts a user-space device number into the format used in the kernel.
+<P>
+</DL>
+<A NAME="lbAW"> </A>
+<H2>FILES</H2>
+
+
+<I>share/systemtap/tapset</I>
+
+
+<P>
+<A NAME="lbAX"> </A>
+<H2>SEE ALSO</H2>
+
+<I><A HREF="stap.1.html">stap</A></I>(1)
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
+<DL>
+<DT><A HREF="#lbAD">CONVERSIONS</A><DD>
+<DT><A HREF="#lbAE">STRING</A><DD>
+<DT><A HREF="#lbAF">TIMESTAMP</A><DD>
+<DT><A HREF="#lbAG">CONTEXT INFO</A><DD>
+<DT><A HREF="#lbAH">TARGET_SET</A><DD>
+<DT><A HREF="#lbAI">ERRNO</A><DD>
+<DT><A HREF="#lbAJ">TASK</A><DD>
+<DT><A HREF="#lbAK">CPU REGISTERS</A><DD>
+<DT><A HREF="#lbAL">NUMBERED FUNCTION ARGUMENTS</A><DD>
+<DT><A HREF="#lbAM">QUEUE_STATS</A><DD>
+<DT><A HREF="#lbAN">INDENT</A><DD>
+<DT><A HREF="#lbAO">SYSTEM</A><DD>
+<DT><A HREF="#lbAP">NUMA</A><DD>
+<DT><A HREF="#lbAQ">CTIME</A><DD>
+<DT><A HREF="#lbAR">PERFMON</A><DD>
+<DT><A HREF="#lbAS">SOCKETS</A><DD>
+<DT><A HREF="#lbAT">INET</A><DD>
+<DT><A HREF="#lbAU">SIGNAL</A><DD>
+<DT><A HREF="#lbAV">DEVICE</A><DD>
+</DL>
+<DT><A HREF="#lbAW">FILES</A><DD>
+<DT><A HREF="#lbAX">SEE ALSO</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of STAPPROBES</TITLE>
+</HEAD><BODY>
+<H1>STAPPROBES</H1>
+Section: Misc. Reference Manual Pages (3stap)<BR>Updated: 2009-11-17<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+stapprobes - systemtap probe points
+<P>
+
+
+
+<P>
+<A NAME="lbAC"> </A>
+<H2>DESCRIPTION</H2>
+
+The following sections enumerate the variety of probe points supported
+by the systemtap translator, and additional aliases defined by
+standard tapset scripts.
+<P>
+
+The general probe point syntax is a dotted-symbol sequence. This
+allows a breakdown of the event namespace into parts, somewhat like
+the Domain Name System does on the Internet. Each component
+identifier may be parametrized by a string or number literal, with a
+syntax like a function call. A component may include a "*" character,
+to expand to a set of matching probe points. Probe aliases likewise
+expand to other probe points. Each and every resulting probe point is
+normally resolved to some low-level system instrumentation facility
+(e.g., a kprobe address, marker, or a timer configuration), otherwise
+the elaboration phase will fail.
+<P>
+
+However, a probe point may be followed by a "?" character, to indicate
+that it is optional, and that no error should result if it fails to
+resolve. Optionalness passes down through all levels of
+alias/wildcard expansion. Alternately, a probe point may be followed
+by a "!" character, to indicate that it is both optional and
+sufficient. (Think vaguely of the Prolog cut operator.) If it does
+resolve, then no further probe points in the same comma-separated list
+will be resolved. Therefore, the "!" sufficiency mark only makes
+sense in a list of probe point alternatives.
+<P>
+
+Additionally, a probe point may be followed by a "if (expr)" statement, in
+order to enable/disable the probe point on-the-fly. With the "if" statement,
+if the "expr" is false when the probe point is hit, the whole probe body
+including alias's body is skipped. The condition is stacked up through
+all levels of alias/wildcard expansion. So the final condition becomes
+the logical-and of conditions of all expanded alias/wildcard.
+<P>
+These are all
+<B>syntactically</B>
+
+valid probe points. (They are generally
+<B>semantically</B>
+
+invalid, depending on the contents of the tapsets, and the versions of
+kernel/user software installed.)
+<P>
+
+<BR>
+
+<DL COMPACT><DT><DD>
+<PRE>
+kernel.function("foo").return
+process("/bin/vi").statement(0x2222)
+end
+syscall.*
+kernel.function("no_such_function") ?
+module("awol").function("no_such_function") !
+signal.*? if (switch)
+kprobe.function("foo")
+
+</PRE>
+
+</DL>
+
+
+<P>
+<P>
+Probes may be broadly classified into "synchronous" and
+"asynchronous". A "synchronous" event is deemed to occur when any
+processor executes an instruction matched by the specification. This
+gives these probes a reference point (instruction address) from which
+more contextual data may be available. Other families of probe points
+refer to "asynchronous" events such as timers/counters rolling over,
+where there is no fixed reference point that is related. Each probe
+point specification may match multiple locations (for example, using
+wildcards or aliases), and all them are then probed. A probe
+declaration may also contain several comma-separated specifications,
+all of which are probed.
+<P>
+<A NAME="lbAD"> </A>
+<H3>BEGIN/END/ERROR</H3>
+
+<P>
+The probe points
+<I>begin</I> and <I>end</I>
+
+are defined by the translator to refer to the time of session startup
+and shutdown. All "begin" probe handlers are run, in some sequence,
+during the startup of the session. All global variables will have
+been initialized prior to this point. All "end" probes are run, in
+some sequence, during the
+<I>normal</I>
+
+shutdown of a session, such as in the aftermath of an
+<I>exit ()</I>
+
+function call, or an interruption from the user. In the case of an
+error-triggered shutdown, "end" probes are not run. There are no
+target variables available in either context.
+<P>
+
+If the order of execution among "begin" or "end" probes is significant,
+then an optional sequence number may be provided:
+<P>
+
+<BR>
+
+<DL COMPACT><DT><DD>
+<PRE>
+begin(N)
+end(N)
+
+</PRE>
+
+</DL>
+
+
+<P>
+The number N may be positive or negative. The probe handlers are run in
+increasing order, and the order between handlers with the same sequence
+number is unspecified. When "begin" or "end" are given without a
+sequence, they are effectively sequence zero.
+<P>
+The
+<I>error</I>
+
+probe point is similar to the
+<I>end</I>
+
+probe, except that each such probe handler run when the session ends
+after errors have occurred. In such cases, "end" probes are skipped,
+but each "error" probe is still attempted. This kind of probe can be
+used to clean up or emit a "final gasp". It may also be numerically
+parametrized to set a sequence.
+<P>
+<A NAME="lbAE"> </A>
+<H3>NEVER</H3>
+
+The probe point
+<I>never</I>
+
+is specially defined by the translator to mean "never". Its probe
+handler is never run, though its statements are analyzed for symbol /
+type correctness as usual. This probe point may be useful in
+conjunction with optional probes.
+<P>
+<A NAME="lbAF"> </A>
+<H3>SYSCALL</H3>
+
+<P>
+The
+<I>syscall.*</I>
+
+aliases define several hundred probes, too many to
+summarize here. They are:
+<P>
+
+<BR>
+
+<DL COMPACT><DT><DD>
+<PRE>
+syscall.NAME
+<BR>
+syscall.NAME.return
+
+</PRE>
+
+</DL>
+
+
+<P>
+Generally, two probes are defined for each normal system call as listed in the
+<I><A HREF="syscalls.2.html">syscalls</A>(2)</I>
+
+manual page, one for entry and one for return. Those system calls that never
+return do not have a corresponding
+<I>.return</I>
+
+probe.
+<P>
+
+Each probe alias defines a variety of variables. Looking at the tapset source
+code is the most reliable way. Generally, each variable listed in the standard
+manual page is made available as a script-level variable, so
+<I>syscall.open</I>
+
+exposes
+<I>filename</I>, <I>flags</I>, and <I>mode</I>.
+
+In addition, a standard suite of variables is available at most aliases:
+<DL COMPACT>
+<DT><I>argstr</I>
+
+<DD>
+A pretty-printed form of the entire argument list, without parentheses.
+<DT><I>name</I>
+
+<DD>
+The name of the system call.
+<DT><I>retstr</I>
+
+<DD>
+For return probes, a pretty-printed form of the system-call result.
+</DL>
+<P>
+
+Not all probe aliases obey all of these general guidelines. Please report
+any bothersome ones you encounter as a bug.
+<P>
+<P>
+<A NAME="lbAG"> </A>
+<H3>TIMERS</H3>
+
+<P>
+Intervals defined by the standard kernel "jiffies" timer may be used
+to trigger probe handlers asynchronously. Two probe point variants
+are supported by the translator:
+<P>
+
+<BR>
+
+<DL COMPACT><DT><DD>
+<PRE>
+timer.jiffies(N)
+timer.jiffies(N).randomize(M)
+
+</PRE>
+
+</DL>
+
+
+<P>
+The probe handler is run every N jiffies (a kernel-defined unit of
+time, typically between 1 and 60 ms). If the "randomize" component is
+given, a linearly distributed random value in the range [-M..+M] is
+added to N every time the handler is run. N is restricted to a
+reasonable range (1 to around a million), and M is restricted to be
+smaller than N. There are no target variables provided in either
+context. It is possible for such probes to be run concurrently on
+a multi-processor computer.
+<P>
+
+Alternatively, intervals may be specified in units of time.
+There are two probe point variants similar to the jiffies timer:
+<P>
+
+<BR>
+
+<DL COMPACT><DT><DD>
+<PRE>
+timer.ms(N)
+timer.ms(N).randomize(M)
+
+</PRE>
+
+</DL>
+
+
+<P>
+Here, N and M are specified in milliseconds, but the full options for units
+are seconds (s/sec), milliseconds (ms/msec), microseconds (us/usec),
+nanoseconds (ns/nsec), and hertz (hz). Randomization is not supported for
+hertz timers.
+<P>
+The actual resolution of the timers depends on the target kernel. For
+kernels prior to 2.6.17, timers are limited to jiffies resolution, so
+intervals are rounded up to the nearest jiffies interval. After 2.6.17,
+the implementation uses hrtimers for tighter precision, though the actual
+resolution will be arch-dependent. In either case, if the "randomize"
+component is given, then the random value will be added to the interval
+before any rounding occurs.
+<P>
+
+Profiling timers are also available to provide probes that execute on all
+CPUs at the rate of the system tick (CONFIG_HZ).
+This probe takes no parameters.
+<P>
+
+<BR>
+
+<DL COMPACT><DT><DD>
+<PRE>
+timer.profile
+
+</PRE>
+
+</DL>
+
+
+<P>
+Full context information of the interrupted process is available, making
+this probe suitable for a time-based sampling profiler.
+<P>
+<A NAME="lbAH"> </A>
+<H3>DWARF</H3>
+
+<P>
+This family of probe points uses symbolic debugging information for
+the target kernel/module/program, as may be found in unstripped
+executables, or the separate
+<I>debuginfo</I>
+
+packages. They allow placement of probes logically into the execution
+path of the target program, by specifying a set of points in the
+source or object code. When a matching statement executes on any
+processor, the probe handler is run in that context.
+<P>
+
+Points in a kernel, which are identified by
+module, source file, line number, function name, or some
+combination of these.
+<P>
+
+Here is a list of probe point families currently supported. The
+<B>.function</B>
+
+variant places a probe near the beginning of the named function, so that
+parameters are available as context variables. The
+<B>.return</B>
+
+variant places a probe at the moment
+<B>after</B>
+
+the return from the named function, so the return value is available
+as the "$return" context variable. The
+<B>.inline</B>
+
+modifier for
+<B>.function</B>
+
+filters the results to include only instances of inlined functions.
+The
+<B>.call</B>
+
+modifier selects the opposite subset. Inline functions do not have an
+identifiable return point, so
+<B>.return</B>
+
+is not supported on
+<B>.inline</B>
+
+probes. The
+<B>.statement</B>
+
+variant places a probe at the exact spot, exposing those local variables
+that are visible there.
+<P>
+
+<BR>
+
+<DL COMPACT><DT><DD>
+<PRE>
+kernel.function(PATTERN)
+<BR>
+kernel.function(PATTERN).call
+<BR>
+kernel.function(PATTERN).return
+<BR>
+kernel.function(PATTERN).inline
+<BR>
+kernel.function(PATTERN).label(LPATTERN)
+<BR>
+module(MPATTERN).function(PATTERN)
+<BR>
+module(MPATTERN).function(PATTERN).call
+<BR>
+module(MPATTERN).function(PATTERN).return
+<BR>
+module(MPATTERN).function(PATTERN).inline
+<BR>
+<BR>
+kernel.statement(PATTERN)
+<BR>
+kernel.statement(ADDRESS).absolute
+<BR>
+module(MPATTERN).statement(PATTERN)
+
+</PRE>
+
+</DL>
+
+
+<P>
+In the above list, MPATTERN stands for a string literal that aims to
+identify the loaded kernel module of interest and LPATTERN stands for
+a source program label. Both MPATTERN and LPATTERN may include the "*"
+"[]", and "?" wildcards.
+PATTERN stands for a string literal that
+aims to identify a point in the program. It is made up of three
+parts:
+<DL COMPACT>
+<DT>*<DD>
+The first part is the name of a function, as would appear in the
+<I>nm</I>
+
+program's output. This part may use the "*" and "?" wildcarding
+operators to match multiple names.
+<DT>*<DD>
+The second part is optional and begins with the "@" character.
+It is followed by the path to the source file containing the function,
+which may include a wildcard pattern, such as mm/slab*.
+If it does not match as is, an implicit "*/" is optionally added
+<I>before</I>
+
+the pattern, so that a script need only name the last few components
+of a possibly long source directory path.
+<DT>*<DD>
+Finally, the third part is optional if the file name part was given,
+and identifies the line number in the source file preceded by a ":"
+or a "+". The line number is assumed to be an
+absolute line number if preceded by a ":", or relative to the entry of
+the function if preceded by a "+".
+All the lines in the function can be matched with ":*".
+A range of lines x through y can be matched with ":x-y".
+</DL>
+<P>
+
+As an alternative, PATTERN may be a numeric constant, indicating an
+address. Such an address may be found from symbol tables of the
+appropriate kernel / module object file. It is verified against
+known statement code boundaries, and will be relocated for use at
+run time.
+<P>
+
+In guru mode only, absolute kernel-space addresses may be specified with
+the ".absolute" suffix. Such an address is considered already relocated,
+as if it came from
+<B>/proc/kallsyms</B>,
+
+so it cannot be checked against statement/instruction boundaries.
+<P>
+
+Some of the source-level context variables, such as function parameters,
+locals, globals visible in the compilation unit, may be visible to
+probe handlers. They may refer to these variables by prefixing their
+name with "$" within the scripts. In addition, a special syntax
+allows limited traversal of structures, pointers, and arrays.
+<DL COMPACT>
+<DT>$var<DD>
+refers to an in-scope variable "var". If it's an integer-like type,
+it will be cast to a 64-bit int for systemtap script use. String-like
+pointers (char *) may be copied to systemtap string values using the
+<I>kernel_string</I> or <I>user_string</I>
+
+functions.
+<DT>$var->field<DD>
+traversal to a structure's field. The indirection operator
+may be repeated to follow more levels of pointers.
+<DT>$return<DD>
+is available in return probes only for functions that are declared
+with a return value.
+<DT><DT>$var[N]<DD>
+<DD>
+indexes into an array. The index is given with a
+literal number.
+<DT>$$vars<DD>
+expands to a character string that is equivalent to
+sprintf("parm1=%x ... parmN=%x var1=%x ... varN=%x", parm1, ..., parmN,
+var1, ..., varN)
+<DT>$$locals<DD>
+expands to a subset of $$vars for only local variables.
+<DT>$$parms<DD>
+expands to a subset of $$vars for only function parameters.
+<DT>$$return<DD>
+is available in return probes only. It expands to a string that
+is equivalent to sprintf("return=%x", $return)
+if the probed function has a return value, or else an empty string.
+</DL>
+<P>
+
+For ".return" probes, context variables other than the "$return"
+value itself are only available for the function call parameters.
+The expressions evaluate to the
+<I>entry-time</I>
+
+values of those variables, since that is when a snapshot is taken.
+Other local variables are not generally accessible, since by the time
+a ".return" probe hits, the probed function will have already returned.
+<P>
+<P>
+<A NAME="lbAI"> </A>
+<H3>DWARFLESS</H3>
+
+In absence of debugging information, entry & exit points of kernel & module
+functions can be probed using the "kprobe" family of probes.
+However, these do not permit looking up the arguments / local variables
+of the function.
+Following constructs are supported :
+
+<BR>
+
+<DL COMPACT><DT><DD>
+<PRE>
+kprobe.function(FUNCTION)
+kprobe.function(FUNCTION).return
+kprobe.module(NAME).function(FUNCTION)
+kprobe.module(NAME).function(FUNCTION).return
+kprobe.statement.(ADDRESS).absolute
+
+</PRE>
+
+</DL>
+
+
+<P>
+
+Probes of type
+<B>function</B>
+
+are recommended for kernel functions, whereas probes of type
+<B>module</B>
+
+are recommended for probing functions of the specified module.
+In case the absolute address of a kernel or module function is known,
+<B>statement</B>
+
+probes can be utilized.
+<P>
+
+Note that
+<I>FUNCTION</I>
+
+and
+<I>MODULE</I>
+
+names
+<B>must not</B>
+
+contain wildcards, or the probe will not be registered.
+Also, statement probes must be run under guru-mode only.
+<P>
+<P>
+<A NAME="lbAJ"> </A>
+<H3>USER-SPACE</H3>
+
+Support for user-space probing is available for kernels
+that are configured with the utrace extensions. See
+
+<BR>
+
+<DL COMPACT><DT><DD>
+<PRE>
+<A HREF="http://people.redhat.com/roland/utrace/">http://people.redhat.com/roland/utrace/</A>
+
+</PRE>
+
+</DL>
+
+
+<P>
+
+There are several forms. First, a non-symbolic probe point:
+
+<BR>
+
+<DL COMPACT><DT><DD>
+<PRE>
+process(PID).statement(ADDRESS).absolute
+
+</PRE>
+
+</DL>
+
+
+is analogous to
+<I>kernel.statement(ADDRESS).absolute</I>
+
+in that both use raw (unverified) virtual addresses and provide
+no $variables. The target PID parameter must identify a running
+process, and ADDRESS should identify a valid instruction address.
+All threads of that process will be probed.
+<P>
+
+Second, non-symbolic user-kernel interface events handled by
+utrace may be probed:
+
+<BR>
+
+<DL COMPACT><DT><DD>
+<PRE>
+process(PID).begin
+process("PATH").begin
+process.begin
+process(PID).thread.begin
+process("PATH").thread.begin
+process.thread.begin
+process(PID).end
+process("PATH").end
+process.end
+process(PID).thread.end
+process("PATH").thread.end
+process.thread.end
+process(PID).syscall
+process("PATH").syscall
+process.syscall
+process(PID).syscall.return
+process("PATH").syscall.return
+process.syscall.return
+process(PID).insn
+process("PATH").insn
+process(PID).insn.block
+process("PATH").insn.block
+
+</PRE>
+
+</DL>
+
+
+<P>
+
+A
+<B>.begin</B>
+
+probe gets called when new process described by PID or PATH gets created.
+A
+<B>.thread.begin</B>
+
+probe gets called when a new thread described by PID or PATH gets created.
+A
+<B>.end</B>
+
+probe gets called when process described by PID or PATH dies.
+A
+<B>.thread.end</B>
+
+probe gets called when a thread described by PID or PATH dies.
+A
+<B>.syscall</B>
+
+probe gets called when a thread described by PID or PATH makes a
+system call. The system call number is available in the
+<B>$syscall</B>
+
+context variable, and the first 6 arguments of the system call
+are available in the
+<B>$argN</B>
+
+(ex. $arg1, $arg2, ...) context variable.
+A
+<B>.syscall.return</B>
+
+probe gets called when a thread described by PID or PATH returns from a
+system call. The system call number is available in the
+<B>$syscall</B>
+
+context variable, and the return value of the system call is available
+in the
+<B>$return</B>
+
+context variable.
+A
+<B>.insn</B>
+
+probe gets called for every single-stepped instruction of the process described by PID or PATH.
+A
+<B>.insn.block</B>
+
+probe gets called for every block-stepped instruction of the process described by PID or PATH.
+<P>
+<P>
+
+Third, symbolic static instrumentation compiled into programs and
+shared libraries may be
+probed:
+
+<BR>
+
+<DL COMPACT><DT><DD>
+<PRE>
+process("PATH").mark("LABEL")
+
+</PRE>
+
+</DL>
+
+
+<P>
+
+A
+<B>.mark</B>
+
+probe gets called via a static probe which is defined in the
+application by
+STAP_PROBE1(handle,LABEL,arg1), which is defined in sdt.h. The handle is an application handle,
+LABEL corresponds to the .mark argument, and arg1 is the argument.
+STAP_PROBE1 is used for probes with 1 argument, STAP_PROBE2 is used
+for probes with 2 arguments, and so on.
+The arguments of the probe are available in the context variables
+$arg1, $arg2, ... An alternative to using the STAP_PROBE macros is to
+use the dtrace script to create custom macros.
+<P>
+<P>
+
+Finally, full symbolic source-level probes in user-space programs
+and shared libraries are supported. These are exactly analogous
+to the symbolic DWARF-based kernel/module probes described above,
+and expose similar contextual $-variables.
+
+<BR>
+
+<DL COMPACT><DT><DD>
+<PRE>
+process("PATH").function("NAME")
+process("PATH").statement("*@FILE.c:123")
+process("PATH").function("*").return
+process("PATH").function("myfun").label("foo")
+
+</PRE>
+
+</DL>
+
+
+<P>
+<P>
+
+Note that for all process probes,
+<I>PATH</I>
+
+names refer to executables that are searched the same way shells do: relative
+to the working directory if they contain a "/" character, otherwise in
+<B>$PATH</B>.
+
+If a process probe is specified without a PID or PATH, all user
+threads are probed. PATH may sometimes name a shared library
+in which case all processes that map that shared library may be
+probed. However, if systemtap was invoked with the
+<I>-c</I> or <I>-x</I>
+
+options, then process probes are restricted to the process
+hierarchy associated with the target process.
+<P>
+<A NAME="lbAK"> </A>
+<H3>PROCFS</H3>
+
+<P>
+These probe points allow procfs "files" in
+/proc/systemtap/MODNAME to be created, read and written
+(<I>MODNAME</I>
+
+is the name of the systemtap module). The
+<I>proc</I>
+
+filesystem is a pseudo-filesystem which is used an an interface to
+kernel data structures. There are four probe point variants supported
+by the translator:
+<P>
+
+<BR>
+
+<DL COMPACT><DT><DD>
+<PRE>
+procfs("PATH").read
+procfs("PATH").write
+procfs.read
+procfs.write
+
+</PRE>
+
+</DL>
+
+
+<P>
+<I>PATH</I>
+
+is the file name (relative to /proc/systemtap/MODNAME) to be created.
+If no
+<I>PATH</I>
+
+is specified (as in the last two variants above),
+<I>PATH</I>
+
+defaults to "command".
+<P>
+
+When a user reads /proc/systemtap/MODNAME/PATH, the corresponding
+procfs
+<I>read</I>
+
+probe is triggered. The string data to be read should be assigned to
+a variable named
+<I>$value</I>,
+
+like this:
+<P>
+
+<BR>
+
+<DL COMPACT><DT><DD>
+<PRE>
+procfs("PATH").read { $value = "100\n" }
+
+</PRE>
+
+</DL>
+
+
+<P>
+
+When a user writes into /proc/systemtap/MODNAME/PATH, the
+corresponding procfs
+<I>write</I>
+
+probe is triggered. The data the user wrote is available in the
+string variable named
+<I>$value</I>,
+
+like this:
+<P>
+
+<BR>
+
+<DL COMPACT><DT><DD>
+<PRE>
+procfs("PATH").write { printf("user wrote: %s", $value) }
+
+</PRE>
+
+</DL>
+
+
+<P>
+<A NAME="lbAL"> </A>
+<H3>MARKERS</H3>
+
+<P>
+This family of probe points hooks up to static probing markers
+inserted into the kernel or modules. These markers are special macro
+calls inserted by kernel developers to make probing faster and more
+reliable than with DWARF-based probes. Further, DWARF debugging
+information is
+<I>not</I>
+
+required to probe markers.
+<P>
+Marker probe points begin with
+<B>kernel</B>.
+
+The next part names the marker itself:
+<B>mark(name)</B>.
+
+The marker name string, which may contain the usual wildcard characters,
+is matched against the names given to the marker macros when the kernel
+and/or module was compiled. Optionally, you can specify
+<B>format(format)</B>.
+
+Specifying the marker format string allows differentiation between two
+markers with the same name but different marker format strings.
+<P>
+The handler associated with a marker-based probe may read the
+optional parameters specified at the macro call site. These are
+named
+<B>$arg1</B> through <B>$argNN</B>,
+
+where NN is the number of parameters supplied by the macro. Number
+and string parameters are passed in a type-safe manner.
+<P>
+The marker format string associated with a marker is available in
+<B>$format</B>.
+
+And also the marker name string is available in
+<B>$name</B>.
+
+<P>
+<A NAME="lbAM"> </A>
+<H3>TRACEPOINTS</H3>
+
+<P>
+This family of probe points hooks up to static probing tracepoints
+inserted into the kernel or modules. As with markers, these
+tracepoints are special macro calls inserted by kernel developers to
+make probing faster and more reliable than with DWARF-based probes,
+and DWARF debugging information is not required to probe tracepoints.
+Tracepoints have an extra advantage of more strongly-typed parameters
+than markers.
+<P>
+Tracepoint probes begin with
+<B>kernel</B>.
+
+The next part names the tracepoint itself:
+<B>trace(name)</B>.
+
+The tracepoint name string, which may contain the usual wildcard
+characters, is matched against the names defined by the kernel
+developers in the tracepoint header files.
+<P>
+The handler associated with a tracepoint-based probe may read the
+optional parameters specified at the macro call site. These are
+named according to the declaration by the tracepoint author. For
+example, the tracepoint probe
+<B>kernel.trace(sched_switch)</B>
+
+provides the parameters
+<B>$rq</B>, <B>$prev</B>, and <B>$next</B>.
+
+If the parameter is a complex type, as in a struct pointer, then a
+script can access fields with the same syntax as DWARF $target
+variables. Also, tracepoint parameters cannot be modified, but in
+guru-mode a script may modify fields of parameters.
+<P>
+The name of the tracepoint is available in
+<B>$$name</B>,
+
+and a string of name=value pairs for all parameters of the tracepoint
+is available in
+<B>$$vars</B> or <B>$$parms</B>.
+
+<P>
+<A NAME="lbAN"> </A>
+<H3>PERFORMANCE MONITORING HARDWARE</H3>
+
+<P>
+The perfmon family of probe points is used to access the performance
+monitoring hardware available in modern processors. This family of
+probes points needs the perfmon2 support in the kernel to access the
+performance monitoring hardware.
+<P>
+
+Performance monitor hardware points begin with a
+<B>perfmon</B>.
+
+The next part of the names the event being counted
+<B>counter(event)</B>.
+
+The event names are processor implementation specific with the
+exception of the generic
+<B>cycles</B> and <B>instructions</B>
+
+events, which are available on all processors. This sets up a counter
+on the processor to count the number of events occurring on the
+processor. For more details on the performance monitoring events
+available on a specific processor use the command perfmon2 command:
+<P>
+
+<BR>
+
+<DL COMPACT><DT><DD>
+<PRE>
+pfmon -l
+
+</PRE>
+
+</DL>
+
+
+<DL COMPACT>
+<DT>$counter<DD>
+is a handle used in the body of the probe for operations
+involving the counter associated with the probe.
+<DT>read_counter<DD>
+is a function that is passed the handle for the perfmon probe and returns
+the current count for the event.
+<P>
+</DL>
+<A NAME="lbAO"> </A>
+<H2>EXAMPLES</H2>
+
+<P>
+
+Here are some example probe points, defining the associated events.
+<DL COMPACT>
+<DT>begin, end, end<DD>
+refers to the startup and normal shutdown of the session. In this
+case, the handler would run once during startup and twice during
+shutdown.
+<DT>timer.jiffies(1000).randomize(200)<DD>
+refers to a periodic interrupt, every 1000 +/- 200 jiffies.
+<DT>kernel.function("*init*"), kernel.function("*exit*")<DD>
+refers to all kernel functions with "init" or "exit" in the name.
+<DT>kernel.function("*@kernel/sched.c:240")<DD>
+refers to any functions within the "kernel/sched.c" file that span
+line 240.
+<DT>kernel.mark("getuid")<DD>
+refers to an STAP_MARK(getuid, ...) macro call in the kernel.
+<DT>module("usb*").function("*sync*").return<DD>
+refers to the moment of return from all functions with "sync" in the
+name in any of the USB drivers.
+<DT>kernel.statement(0xc0044852)<DD>
+refers to the first byte of the statement whose compiled instructions
+include the given address in the kernel.
+<DT>kernel.statement("*@kernel/sched.c:2917")<DD>
+refers to the statement of line 2917 within "kernel/sched.c".
+<DT>kernel.statement("bio_init@fs/bio.c+3")<DD>
+refers to the statement at line bio_init+3 within "fs/bio.c".
+<DT>syscall.*.return<DD>
+refers to the group of probe aliases with any name in the third position
+<P>
+</DL>
+<A NAME="lbAP"> </A>
+<H2>SEE ALSO</H2>
+
+<I><A HREF="stap.1.html">stap</A></I>(1),
+
+<I><A HREF="stapprobes.iosched.3stap.html">stapprobes.iosched</A></I>(3stap),
+
+<I><A HREF="stapprobes.netdev.3stap.html">stapprobes.netdev</A></I>(3stap),
+
+<I><A HREF="stapprobes.nfs.3stap.html">stapprobes.nfs</A></I>(3stap),
+
+<I><A HREF="stapprobes.nfsd.3stap.html">stapprobes.nfsd</A></I>(3stap),
+
+<I><A HREF="stapprobes.pagefault.3stap.html">stapprobes.pagefault</A></I>(3stap),
+
+<I><A HREF="stapprobes.process.3stap.html">stapprobes.process</A></I>(3stap),
+
+<I><A HREF="stapprobes.rpc.3stap.html">stapprobes.rpc</A></I>(3stap),
+
+<I><A HREF="stapprobes.scsi.3stap.html">stapprobes.scsi</A></I>(3stap),
+
+<I><A HREF="stapprobes.signal.3stap.html">stapprobes.signal</A></I>(3stap),
+
+<I><A HREF="stapprobes.socket.3stap.html">stapprobes.socket</A></I>(3stap),
+
+<I><A HREF="stapprobes.tcp.3stap.html">stapprobes.tcp</A></I>(3stap),
+
+<I><A HREF="stapprobes.udp.3stap.html">stapprobes.udp</A></I>(3stap),
+
+<I><A HREF="proc.3stap.html">proc</A></I>(3stap)
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
+<DL>
+<DT><A HREF="#lbAD">BEGIN/END/ERROR</A><DD>
+<DT><A HREF="#lbAE">NEVER</A><DD>
+<DT><A HREF="#lbAF">SYSCALL</A><DD>
+<DT><A HREF="#lbAG">TIMERS</A><DD>
+<DT><A HREF="#lbAH">DWARF</A><DD>
+<DT><A HREF="#lbAI">DWARFLESS</A><DD>
+<DT><A HREF="#lbAJ">USER-SPACE</A><DD>
+<DT><A HREF="#lbAK">PROCFS</A><DD>
+<DT><A HREF="#lbAL">MARKERS</A><DD>
+<DT><A HREF="#lbAM">TRACEPOINTS</A><DD>
+<DT><A HREF="#lbAN">PERFORMANCE MONITORING HARDWARE</A><DD>
+</DL>
+<DT><A HREF="#lbAO">EXAMPLES</A><DD>
+<DT><A HREF="#lbAP">SEE ALSO</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of STAPPROBES.IOSCHED</TITLE>
+</HEAD><BODY>
+<H1>STAPPROBES.IOSCHED</H1>
+Section: Misc. Reference Manual Pages (3stap)<BR>Updated: 2009-11-17<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+stapprobes.iosched - systemtap IO scheduler probe points
+<P>
+
+
+
+<P>
+<A NAME="lbAC"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+This family of probe points is used to probe the IO scheduler
+activities. It contains the following probe points:
+<P>
+
+<DL COMPACT>
+<DT><B>ioscheduler.elv_next_request</B>
+
+<DD>
+Fires when retrieves a request from request queue
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>elevator_name</I>
+
+<BR> The elevator name
+<P>
+
+<DT><B>ioscheduler.elv_next_request.return</B>
+
+<DD>
+Fires when return from retrieving a request
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>req</I>
+
+<BR> Address of the request
+<P>
+<I>req_flags</I>
+
+<BR> request flags
+<P>
+<I>disk_major</I>
+
+<BR> disk major number of the request
+<P>
+<I>disk_minor</I>
+
+<BR> disk minor number of the request
+<P>
+
+<DT><B>ioscheduler.elv_add_request</B>
+
+<DD>
+Fires when add a request into request queue
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>elevator_name</I>
+
+<BR> The elevator name
+<P>
+<I>req</I>
+
+<BR> Address of the request
+<P>
+<I>req_flags</I>
+
+<BR> request flags
+<P>
+<I>disk_major</I>
+
+<BR> disk major number of the request
+<P>
+<I>disk_minor</I>
+
+<BR> disk minor number of the request
+<P>
+
+<DT><B>ioscheduler.elv_completed_request</B>
+
+<DD>
+Fires when a request is completed
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>elevator_name</I>
+
+<BR> The elevator name
+<P>
+<I>req</I>
+
+<BR> Address of the request
+<P>
+<I>req_flags</I>
+
+<BR> request flags
+<P>
+<I>disk_major</I>
+
+<BR> disk major number of the request
+<P>
+<I>disk_minor</I>
+
+<BR> disk minor number of the request
+<P>
+</DL>
+<A NAME="lbAD"> </A>
+<H2>SEE ALSO</H2>
+
+<I><A HREF="stap.1.html">stap</A></I>(1),
+
+<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
+
+<P>
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
+<DT><A HREF="#lbAD">SEE ALSO</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of STAPPROBES.KPROCESS</TITLE>
+</HEAD><BODY>
+<H1>STAPPROBES.KPROCESS</H1>
+Section: Misc. Reference Manual Pages (3stap)<BR>Updated: 2009-11-17<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+stapprobes.kprocess - systemtap kernel process probe points
+<P>
+
+
+
+<P>
+<A NAME="lbAC"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+This family of probe points is used to probe the kernel's process activities.
+It contains the following probe points:
+<P>
+
+<DL COMPACT>
+<DT><B>kprocess.create</B>
+
+<DD>
+<P>
+Fires whenever a new process is successfully created, either as a
+result of one of the fork syscall variants, or a new kernel thread.
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>task</I>
+
+<BR> a handle to the newly created process
+<P>
+<I>new_pid</I>
+
+<BR> pid of the newly created process
+<P>
+
+<DT><B>kprocess.start</B>
+
+<DD>
+<P>
+Fires immediately before a new process begins execution.
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>N/A</I>
+
+<P>
+
+<DT><B>kprocess.exec</B>
+
+<DD>
+<P>
+Fires whenever a process attempts to exec to a new program
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>filename</I>
+
+<BR> the path to the new executable
+<P>
+
+<DT><B>kprocess.exec_complete</B>
+
+<DD>
+<P>
+Fires at the completion of an exec call
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>errno</I>
+
+<BR> the error number resulting from the exec
+<P>
+<I>success</I>
+
+<BR> a boolean indicating whether the exec was successful
+<P>
+
+<DT><B>kprocess.exit</B>
+
+<DD>
+<P>
+Fires when a process terminates. This will always be followed by a
+kprocess.release, though the latter may be delayed if the process
+waits in a zombie state.
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>code</I>
+
+<BR> the exit code of the process
+<P>
+
+<DT><B>kprocess.release</B>
+
+<DD>
+<P>
+Fires when a process is released from the kernel. This always
+follows a kprocess.exit, though it may be delayed somewhat if the
+process waits in a zombie state.
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>task</I>
+
+<BR> a task handle to the process being released
+<P>
+<I>pid</I>
+
+<BR> pid of the process being released
+<P>
+</DL>
+<A NAME="lbAD"> </A>
+<H2>SEE ALSO</H2>
+
+<I><A HREF="stap.1.html">stap</A></I>(1),
+
+<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
+
+<P>
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
+<DT><A HREF="#lbAD">SEE ALSO</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of STAPPROBES.NETDEV</TITLE>
+</HEAD><BODY>
+<H1>STAPPROBES.NETDEV</H1>
+Section: Misc. Reference Manual Pages (3stap)<BR>Updated: 2009-11-17<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+stapprobes.netdev - systemtap network device probe points
+<P>
+
+
+
+<P>
+<A NAME="lbAC"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+This family of probe points is used to probe the activities of network
+device.
+It contains the following probe points:
+<P>
+
+<DL COMPACT>
+<DT><B>netdev.receive</B>
+
+<DD>
+Fires when data arrives on network device
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>dev_name</I>
+
+<BR> The name of the device. e.g: eth0, ath1
+<P>
+<I>length</I>
+
+<BR> The length of the receiving buffer
+<P>
+<I>protocol</I>
+
+<BR> The possible values of protocol could be:
+<BR> 0800 IP
+<BR> 8100 802.1Q VLAN
+<BR> 0001 802.3
+<BR> 0002 AX.25
+<BR> 0004 802.2
+<BR> 8035 RARP
+<BR> 0005 SNAP
+<BR> 0805 X.25
+<BR> 0806 ARP
+<BR> 8137 IPX
+<BR> 0009 Localtalk
+<BR> 86DD IPv6
+<P>
+<I>truesize</I>
+
+<BR> The size of the received data
+<P>
+
+<DT><B>netdev.transmit</B>
+
+<DD>
+Fires when the network device wants to transmit a buffer
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>dev_name</I>
+
+<BR> The name of the device. e.g: eth0, ath1
+<P>
+<I>length</I>
+
+<BR> The length of the transmit buffer
+<P>
+<I>protocol</I>
+
+<BR> The protocol of this packet.
+<P>
+<I>truesize</I>
+
+<BR> The size of the data to be transmitted.
+<P>
+</DL>
+<A NAME="lbAD"> </A>
+<H2>SEE ALSO</H2>
+
+<I><A HREF="stap.1.html">stap</A></I>(1),
+
+<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
+<DT><A HREF="#lbAD">SEE ALSO</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of STAPPROBES.NFS</TITLE>
+</HEAD><BODY>
+<H1>STAPPROBES.NFS</H1>
+Section: Misc. Reference Manual Pages (3stap)<BR>Updated: 2009-11-17<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+stapprobes.nfs - systemtap NFS client side probe points
+<P>
+
+
+
+<P>
+<A NAME="lbAC"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+This family of probe points is used to probe NFS activities on
+client side.
+It contains the following probe points:
+<P>
+
+<DL COMPACT>
+<DT><B>nfs.fop.llseek </B>
+
+<DD>
+<P>
+Fires whenever doing a llseek operation on nfs client side
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>dev </I>
+
+<BR> device identifier
+<P>
+<I>ino </I>
+
+<BR> inode number
+<P>
+<I>s_id</I>
+
+<BR> the pointer to s_id
+<P>
+<I>devname </I>
+
+<BR> the combination of server ip and the name of block device
+<BR> on server
+<P>
+<I>maxbyte</I>
+
+<BR> Maximum size of the files
+<P>
+<I>offset</I>
+
+<BR> the offset of file to be repositioned
+<P>
+<I>origin</I>
+
+<BR> the original position. The possible value could be:
+<BR> SEEK_SET
+<BR> The offset is set to offset bytes.
+<BR> SEEK_CUR
+<BR> The offset is set to its current location
+<BR> plus offset bytes.
+<BR> SEEK_END
+<BR> The offset is set to the size of the file
+<BR> plus offset bytes.
+<P>
+
+<DT><B>nfs.fop.llseek.return</B>
+
+<DD>
+<P>
+Fires whenever nfs llseek operation is done
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>retstr </I>
+
+<BR> resulting offset location
+<P>
+
+<DT><B>nfs.fop.read</B>
+
+<DD>
+<P>
+Fires whenever doing a read operation on nfs client side
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>dev </I>
+
+<BR> device identifier
+<P>
+<I>ino </I>
+
+<BR> inode number
+<P>
+<I>s_id</I>
+
+<BR> the pointer to s_id
+<P>
+<I>devname </I>
+
+<BR> the combination of server ip and the name of block device
+<BR> on server
+<P>
+<I>len,size</I>
+
+<BR> number of bytes to be read
+<P>
+<I>pos </I>
+
+<BR> current file offset <TT> </TT><BR>
+<P>
+<I>buf </I>
+
+<BR> the buf address
+<P>
+
+<DT><B>nfs.fop.read.return</B>
+
+<DD>
+<P>
+Fires whenever nfs read operation is done
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>size </I>
+
+<BR> number of bytes read
+<P>
+
+<DT><B>nfs.fop.write</B>
+
+<DD>
+<P>
+Fires whenever doing a write operation on nfs client side
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>dev </I>
+
+<BR> device identifier
+<P>
+<I>ino </I>
+
+<BR> inode number
+<P>
+<I>s_id</I>
+
+<BR> the pointer to s_id
+<P>
+<I>devname </I>
+
+<BR> the combination of server ip and the name of block device
+<BR> on server
+<P>
+<I>len,size</I>
+
+<BR> number of bytes to written
+<P>
+<I>pos </I>
+
+<BR> current file offset <TT> </TT><BR>
+<P>
+<I>buf </I>
+
+<BR> the buf address
+<P>
+
+<DT><B>nfs.fop.write.return</B>
+
+<DD>
+<P>
+Fires whenever nfs write operation is done
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>size </I>
+
+<BR> number of bytes written
+<P>
+
+<DT><B>nfs.fop.aio_read</B>
+
+<DD>
+<P>
+Fires whenever doing an aio_read operation on nfs client side
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>dev </I>
+
+<BR> device identifier
+<P>
+<I>ino </I>
+
+<BR> inode number
+<P>
+<I>s_id</I>
+
+<BR> the pointer to s_id
+<P>
+<I>devname </I>
+
+<BR> the combination of server ip and the name of block device
+<BR> on server
+<P>
+<I>count,size</I>
+
+<BR> number of bytes to be read
+<P>
+<I>pos </I>
+
+<BR> current file offset <TT> </TT><BR>
+<P>
+<I>buf </I>
+
+<BR> the buf address
+<P>
+<I>parent_name </I>
+
+<BR> parent dir name
+<P>
+<I>file_name</I>
+
+<BR> file name
+<P>
+<I>cache_valid </I>
+
+<BR> cache related bit mask flag
+<P>
+<I>cache_time </I>
+
+<BR> when we started read-caching this inode
+<P>
+<I>attrtimeo </I>
+
+<BR> how long the cached information is assumed to be valid.
+<P>
+<BR> The cached attrs for this inode needed to be revalidated if
+<BR> jiffies - read_cache_jiffies > attrtime
+<P>
+
+<DT><B>nfs.fop.aio_read.return</B>
+
+<DD>
+<P>
+Fires whenever nfs aio_read operation is done
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>size </I>
+
+<BR> number of bytes read
+<P>
+
+<DT><B>nfs.fop.aio_write</B>
+
+<DD>
+<P>
+Fires whenever doing an aio_write operation on nfs client side
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>dev </I>
+
+<BR> device identifier
+<P>
+<I>ino </I>
+
+<BR> inode number
+<P>
+<I>s_id</I>
+
+<BR> the pointer to s_id
+<P>
+<I>devname </I>
+
+<BR> the combination of server ip and the name of block device
+<BR> on server
+<P>
+<I>count,size</I>
+
+<BR> number of bytes to written
+<P>
+<I>pos </I>
+
+<BR> current file offset <TT> </TT><BR>
+<P>
+<I>buf </I>
+
+<BR> the buf address
+<P>
+<I>parent_name </I>
+
+<BR> parent dir name
+<P>
+<I>file_name</I>
+
+<BR> file name
+<P>
+
+<DT><B>nfs.fop.aio_write.return</B>
+
+<DD>
+<P>
+Fires whenever nfs aio_write operation is done
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>size </I>
+
+<BR> number of bytes written
+<P>
+
+<DT><B>nfs.fop.mmap</B>
+
+<DD>
+<P>
+Fires whenever doing an mmap operation on nfs client side
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>dev </I>
+
+<BR> device identifier
+<P>
+<I>ino </I>
+
+<BR> inode number
+<P>
+<I>s_id</I>
+
+<BR> the pointer to s_id
+<P>
+<I>devname </I>
+
+<BR> the combination of server ip and the name of block device
+<BR> on server
+<P>
+<I>vm_start</I>
+
+<BR> start address within vm_mm
+<P>
+<I>vm_end</I>
+
+<BR> the first byte after end address within vm_mm
+<P>
+<I>vm_flag </I>
+
+<BR> vm flags
+<P>
+<I>parent_name </I>
+
+<BR> parent dir name
+<P>
+<I>file_name</I>
+
+<BR> file name
+<P>
+<I>cache_valid </I>
+
+<BR> cache related bit mask flag
+<P>
+<I>cache_time </I>
+
+<BR> when we started read-caching this inode
+<P>
+<I>attrtimeo </I>
+
+<BR> how long the cached information is assumed to be valid.
+<P>
+<BR> The cached attrs for this inode needed to be revalidated if
+<BR> jiffies - read_cache_jiffies > attrtime
+<P>
+
+<DT><B>nfs.fop.open</B>
+
+<DD>
+<P>
+Fires whenever doing an open operation on nfs client side
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>dev </I>
+
+<BR> device identifier
+<P>
+<I>ino </I>
+
+<BR> inode number
+<P>
+<I>s_id</I>
+
+<BR> the pointer to s_id
+<P>
+<I>devname </I>
+
+<BR> the combination of server ip and the name of block device
+<BR> on server
+<P>
+<I>file_name</I>
+
+<BR> file name
+<P>
+<I>flag</I>
+
+<BR> file flag
+<P>
+<I>i_size</I>
+
+<BR> file length in bytes
+<P>
+
+<DT><B>nfs.fop.flush</B>
+
+<DD>
+<P>
+Fires whenever doing an flush operation on nfs client side
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>dev </I>
+
+<BR> device identifier
+<P>
+<I>ino </I>
+
+<BR> inode number
+<P>
+<I>s_id</I>
+
+<BR> the pointer to s_id
+<P>
+<I>devname </I>
+
+<BR> the combination of server ip and the name of block device
+<BR> on server
+<P>
+<I>mode </I>
+
+<BR> file mode
+<P>
+<I>ndirty </I>
+
+<BR> number of dirty page to be flushed
+<P>
+
+<DT><B>nfs.fop.release</B>
+
+<DD>
+<P>
+Fires whenever doing a release page operation on nfs client side
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>dev </I>
+
+<BR> device identifier
+<P>
+<I>ino </I>
+
+<BR> inode number
+<P>
+<I>s_id</I>
+
+<BR> the pointer to s_id
+<P>
+<I>devname </I>
+
+<BR> the combination of server ip and the name of block device
+<BR> on server
+<P>
+<I>mode </I>
+
+<BR> file mode
+<P>
+
+<DT><B>nfs.fop.fsync</B>
+
+<DD>
+<P>
+Fires whenever doing a fsync operation on nfs client side
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>dev </I>
+
+<BR> device identifier
+<P>
+<I>ino </I>
+
+<BR> inode number
+<P>
+<I>s_id</I>
+
+<BR> the pointer to s_id
+<P>
+<I>devname </I>
+
+<BR> the combination of server ip and the name of block device
+<BR> on server
+<P>
+<I>ndirty </I>
+
+<BR> number of dirty page to be flushed
+<P>
+
+<DT><B>nfs.fop.lock</B>
+
+<DD>
+<P>
+Fires whenever doing a file lock operation on nfs client side
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>dev </I>
+
+<BR> device identifier
+<P>
+<I>ino </I>
+
+<BR> inode number
+<P>
+<I>s_id</I>
+
+<BR> the pointer to s_id
+<P>
+<I>devname </I>
+
+<BR> the combination of server ip and the name of block device
+<BR> on server
+<P>
+<I>i_mode </I>
+
+<BR> file type and access rights
+<P>
+<I>cmd </I>
+
+<BR> cmd arguments
+<P>
+<I>fl_type </I>
+
+<BR> lock type
+<P>
+<I>fl_flag </I>
+
+<BR> lock flags
+<P>
+<I>fl_start </I>
+
+<BR> starting offset of locked region
+<P>
+<I>fl_end </I>
+
+<BR> ending offset of locked region
+<BR>
+
+<DT><B>nfs.fop.sendfile</B>
+
+<DD>
+<P>
+Fires whenever doing a send file operation on nfs client side
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>dev </I>
+
+<BR> device identifier
+<P>
+<I>ino </I>
+
+<BR> inode number
+<P>
+<I>s_id</I>
+
+<BR> the pointer to s_id
+<P>
+<I>devname </I>
+
+<BR> the combination of server ip and the name of block device
+<BR> on server
+<P>
+<I>count,size</I>
+
+<BR> number of bytes to sent
+<P>
+<I>ppos </I>
+
+<BR> current file offset <TT> </TT><BR>
+<P>
+<I>cache_valid </I>
+
+<BR> cache related bit mask flag
+<P>
+<I>cache_time </I>
+
+<BR> when we started read-caching this inode
+<P>
+<I>attrtimeo </I>
+
+<BR> how long the cached information is assumed to be valid.
+<P>
+<BR> The cached attrs for this inode needed to be revalidated if
+<BR> jiffies - read_cache_jiffies > attrtime
+<P>
+
+<DT><B>nfs.fop.sendfile.return</B>
+
+<DD>
+<P>
+Fires whenever nfs sendfile operation is done
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>size </I>
+
+<BR> number of bytes sent
+<P>
+
+<DT><B>nfs.fop.check_flags</B>
+
+<DD>
+<P>
+Fires whenever doing a check flag operation on nfs client side
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>flags</I>
+
+<BR> file flag
+<P>
+
+<DT><B>nfs.aop.readpage</B>
+
+<DD>
+<P>
+Fires when a previous async read operation failed
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>__page </I>
+
+<BR> the address of page
+<P>
+<I>dev </I>
+
+<BR> device identifier
+<P>
+<I>ino </I>
+
+<BR> inode number
+<P>
+<I>i_flag </I>
+
+<BR> file flags
+<P>
+<I>i_size </I>
+
+<BR> file length in bytes
+<P>
+<I>sb_flag </I>
+
+<BR> super block flags
+<P>
+<I>file </I>
+
+<BR> file argument
+<P>
+<I>page_index </I>
+
+<BR> offset within mapping
+<P>
+<I>rsize </I>
+
+<BR> read size (in bytes)
+<P>
+
+<DT><B>nfs.aop.readpages</B>
+
+<DD>
+<P>
+Fires when in readahead way, read several pages once
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>dev </I>
+
+<BR> device identifier
+<P>
+<I>ino </I>
+
+<BR> inode number
+<P>
+<I>nr_pages ,size </I>
+
+<BR> number of pages attempted to read in this execution
+<P>
+<I>file </I>
+
+<BR> filp argument
+<P>
+<I>rpages </I>
+
+<BR> read size (in pages)
+<P>
+<I>rsize </I>
+
+<BR> read size (in bytes)
+<P>
+
+<DT><B>nfs.aop.readpages.return</B>
+
+<DD>
+<P>
+Fires whenever a nfs read pages operation is done
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>size </I>
+
+<BR> number of pages read
+<P>
+
+<DT><B>nfs.aop.set_page_dirty</B>
+
+<DD>
+<P>
+Fires whenever set page dirty on nfs client side
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>__page</I>
+
+<BR> the address of page
+<P>
+<I>page_flag</I>
+
+<BR> page flags
+<P>
+
+<DT><B>nfs.aop.writepage</B>
+
+<DD>
+<P>
+Fires whenever writing an mapped page to the server from nfs client side
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>__page </I>
+
+<BR> the address of page
+<P>
+<I>dev </I>
+
+<BR> device identifier
+<P>
+<I>ino </I>
+
+<BR> inode number
+<P>
+<I>for_reclaim </I>
+
+<BR> a flag of writeback_control, indicates if it's invoked from the page allocator
+<P>
+<I>for_kupdate </I>
+
+<BR> a flag of writeback_control, indicates if it's a kupdate writeback
+<BR> The priority of wb is decided by above two flags
+<P>
+<I>i_flag </I>
+
+<BR> file flags
+<P>
+<I>i_size </I>
+
+<BR> file length in bytes
+<P>
+<I>i_state </I>
+
+<BR> inode state flags
+<P>
+<I>sb_flag </I>
+
+<BR> super block flags
+<P>
+<I>page_index </I>
+
+<BR> offset within mapping
+<P>
+<I>wsize </I>
+
+<BR> write size
+<P>
+
+<DT><B>nfs.aop.writepages</B>
+
+<DD>
+<P>
+Fires whenever writing several dirty pages to the server from nfs client sides
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>dev </I>
+
+<BR> device identifier
+<P>
+<I>ino </I>
+
+<BR> inode number
+<P>
+<I>for_reclaim </I>
+
+<BR> a flag of writeback_control, indicates if it's invoked from the page allocator
+<P>
+<I>for_kupdate </I>
+
+<BR> a flag of writeback_control, indicates if it's a kupdate writeback
+<BR> The priority of wb is decided by above two flags
+<P>
+<I>wpages </I>
+
+<BR> write size (in pages)
+<P>
+<I>wsize </I>
+
+<BR> write size
+<P>
+<I>nr_to_write ,size</I>
+
+<BR> number of pages attempted to be written in this execution
+<P>
+
+<DT><B>nfs.aop.prepare_write</B>
+
+<DD>
+<P>
+Fires whenever prepare a page for writing on nfs client sides
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>__page</I>
+
+<BR> the address of page
+<P>
+<I>dev </I>
+
+<BR> device identifier
+<P>
+<I>ino </I>
+
+<BR> inode number
+<P>
+<I>offset</I>
+
+<BR> start address of this write operation
+<P>
+<I>to </I>
+
+<BR> end address of this write operation
+<P>
+<I>page_index </I>
+
+<BR> offset within mapping
+<P>
+<I>size </I>
+
+<BR> read bytes
+<P>
+
+<DT><B>nfs.aop.commit_write</B>
+
+<DD>
+<P>
+Fires often after prepare write operation
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>__page</I>
+
+<BR> the address of page
+<P>
+<I>dev </I>
+
+<BR> device identifier
+<P>
+<I>ino </I>
+
+<BR> inode number
+<P>
+<I>offset</I>
+
+<BR> start address of this write operation
+<P>
+<I>to </I>
+
+<BR> end address of this write operation
+<P>
+<I>i_flag </I>
+
+<BR> file flags
+<P>
+<I>i_size </I>
+
+<BR> file length in bytes
+<P>
+<I>sb_flag </I>
+
+<BR> super block flag
+<P>
+<I>page_index </I>
+
+<BR> offset within mapping
+<P>
+<I>size </I>
+
+<BR> read bytes
+<P>
+
+<DT><B>nfs.aop.release_page</B>
+
+<DD>
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>__page </I>
+
+<BR> the address of page
+<P>
+<I>dev </I>
+
+<BR> device identifier
+<P>
+<I>ino </I>
+
+<BR> inode number
+<P>
+<I>page_index </I>
+
+<BR> offset within mapping
+<P>
+
+<DT><B>nfs.proc.lookup</B>
+
+<DD>
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>server_ip </I>
+
+<BR> ip address of server
+<P>
+<I>prot </I>
+
+<BR> transfer protocol
+<P>
+<I>version </I>
+
+<BR> nfs version
+<P>
+<I>filename </I>
+
+<BR> the name of file which client opens/searches on server
+<P>
+<I>name_len </I>
+
+<BR> the length of file name
+<P>
+<I>bitmask0, bitmask1 </I>
+
+<BR> V4 bitmask representing the set of attributes
+<BR> supported on this filesystem (only in probe nfs.proc4.lookup)
+<P>
+
+<DT><B>nfs.proc.read</B>
+
+<DD>
+<P>
+Fires when client synchronously reads file from server
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>server_ip </I>
+
+<BR> ip address of server
+<P>
+<I>prot </I>
+
+<BR> transfer protocol
+<P>
+<I>version </I>
+
+<BR> nfs version
+<P>
+<I>flags </I>
+
+<BR> used to set task->tk_flags in rpc_init_task function
+<P>
+<I>size,count </I>
+
+<BR> number of bytes to be read in this execution
+<P>
+<I>offset </I>
+
+<BR> the file offset
+<P>
+
+<DT><B>nfs.proc.read.return</B>
+
+<DD>
+<P>
+Fires when synchronously reading file from server is done
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>size </I>
+
+<BR> number of bytes read
+<P>
+
+<DT><B>nfs.proc.write</B>
+
+<DD>
+<P>
+Fires when client synchronously writes file to server
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>server_ip </I>
+
+<BR> ip address of server
+<P>
+<I>prot </I>
+
+<BR> transfer protocol
+<P>
+<I>version </I>
+
+<BR> nfs version
+<P>
+<I>flags </I>
+
+<BR> used to set task->tk_flags in rpc_init_task function
+<P>
+<I>size,count </I>
+
+<BR> number of bytes to be written in this execution
+<P>
+<I>offset </I>
+
+<BR> the file offset
+<P>
+<I>bitmask0, bitmask1 </I>
+
+<BR> V4 bitmask representing the set of attributes
+<BR> supported on this filesystem (only in probe nfs.proc4.lookup)
+<P>
+
+<DT><B>nfs.proc.write.return</B>
+
+<DD>
+<P>
+Fires when synchronously writing file from server is done
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>size </I>
+
+<BR> number of bytes written
+<P>
+
+<DT><B>nfs.proc.commit</B>
+
+<DD>
+<P>
+Fires when client writes the buffered data to disk, the buffered
+data is asynchronously written by client before(not exist in NFSV2)
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>server_ip </I>
+
+<BR> ip address of server
+<P>
+<I>prot </I>
+
+<BR> transfer protocol
+<P>
+<I>version </I>
+
+<BR> nfs version
+<P>
+<I>size,count </I>
+
+<BR> number of bytes to be written in this execution
+<P>
+<I>offset </I>
+
+<BR> the file offset
+<P>
+<I>bitmask0, bitmask1 </I>
+
+<BR> V4 bitmask representing the set of attributes
+<BR> supported on this filesystem (only in probe nfs.proc4.lookup)
+<P>
+
+<DT><B>nfs.proc.commit.return</B>
+
+<DD>
+<P>
+Fires when committing operation is done
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>size </I>
+
+<BR> number of bytes written
+<P>
+
+<DT><B>nfs.proc.read_setup</B>
+
+<DD>
+<P>
+Fires when client asynchronously reads file from server,
+this function is used to setup a read rpc task, not do
+a real read operation.
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>server_ip </I>
+
+<BR> ip address of server
+<P>
+<I>prot </I>
+
+<BR> transfer protocol
+<P>
+<I>version </I>
+
+<BR> nfs version
+<P>
+<I>size,count </I>
+
+<BR> number of bytes to be read in this execution
+<P>
+<I>offset </I>
+
+<BR> the file offset
+<P>
+
+<DT><B>nfs.proc.read_done</B>
+
+<DD>
+<P>
+Fires when a read reply is received or some read error occur
+(timeout or socket shutdown)
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>server_ip </I>
+
+<BR> ip address of server
+<P>
+<I>prot </I>
+
+<BR> transfer protocol
+<P>
+<I>version </I>
+
+<BR> nfs version
+<P>
+<I>status </I>
+
+<BR> result of last async read operation
+<P>
+<I>count </I>
+
+<BR> number of bytes read
+<P>
+<I>timestamp</I>
+
+<BR> time stamp, which is used for lease renewal (only
+<BR> in nfs.proc4.read_done)
+<P>
+
+<DT><B>nfs.proc.write_setup</B>
+
+<DD>
+<P>
+Fires when client asynchronously write data to server,
+this function is used to setup a write rpc task, not do
+a write read operation.
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>server_ip </I>
+
+<BR> ip address of server
+<P>
+<I>prot </I>
+
+<BR> transfer protocol
+<P>
+<I>version </I>
+
+<BR> nfs version
+<P>
+<I>size,count </I>
+
+<BR> number of bytes to be written in this execution
+<P>
+<I>offset </I>
+
+<BR> the file offset
+<P>
+<I>how</I>
+
+<BR> used to set args.stable, The possible value could be:
+<BR> NFS_UNSTABLE,
+<BR> NFS_DATA_SYNC,
+<BR> NFS_FILE_SYNC
+<BR> (only in nfs.proc3.write_setup and nfs.proc4.write_setup)
+<P>
+<I>bitmask0, bitmask1 </I>
+
+<BR> V4 bitmask representing the set of attributes supported
+<BR> on this filesystem (only in probe nfs.proc4.write_setup)
+<P>
+
+<DT><B>nfs.proc.write_done</B>
+
+<DD>
+<P>
+Fires when a write reply is received or some write error occur
+(timeout or socket shutdown)
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>server_ip </I>
+
+<BR> ip address of server
+<P>
+<I>prot </I>
+
+<BR> transfer protocol
+<P>
+<I>version </I>
+
+<BR> nfs version
+<P>
+<I>status </I>
+
+<BR> result of last async write operation
+<P>
+<I>valid </I>
+
+<BR> fattr->valid, indicates which fields are valid
+<P>
+<I>count </I>
+
+<BR> number of bytes written
+<P>
+<I>timestamp</I>
+
+<BR> time stamp, which is used for lease renewal (only
+<BR> in nfs.proc4.read_done)
+<P>
+
+<DT><B>nfs.proc.commit_setup</B>
+
+<DD>
+<P>
+Fires when client asynchronously do a commit operation,
+this function is used to setup a commit rpc task, not do
+a commit read operation.
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>server_ip </I>
+
+<BR> ip address of server
+<P>
+<I>prot </I>
+
+<BR> transfer protocol
+<P>
+<I>version </I>
+
+<BR> nfs version
+<P>
+<I>size,count </I>
+
+<BR> number of bytes to be written in this execution
+<P>
+<I>offset </I>
+
+<BR> the file offset
+<P>
+<I>bitmask0, bitmask1 </I>
+
+<BR> V4 bitmask representing the set of attributes supported
+<BR> on this filesystem (only in probe nfs.proc4.commit_setup)
+<P>
+
+<DT><B>nfs.proc.commit_done</B>
+
+<DD>
+<P>
+Fires when a commit reply is received or some commit error occur
+(timeout or socket shutdown)
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>server_ip </I>
+
+<BR> ip address of server
+<P>
+<I>prot </I>
+
+<BR> transfer protocol
+<P>
+<I>version </I>
+
+<BR> nfs version
+<P>
+<I>status </I>
+
+<BR> result of last async write operation
+<P>
+<I>valid </I>
+
+<BR> fattr->valid, indicates which fields are valid
+<P>
+<I>count </I>
+
+<BR> number of bytes written
+<P>
+<I>timestamp</I>
+
+<BR> time stamp, which is used for lease renewal (only
+<BR> in nfs.proc4.read_done)
+<P>
+
+<DT><B>nfs.proc.open</B>
+
+<DD>
+<P>
+Fires whenever doing a open operation on nfs client side,
+the nfs_open function is used to allocate file read/write
+context information
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>server_ip </I>
+
+<BR> ip address of server
+<P>
+<I>prot </I>
+
+<BR> transfer protocol
+<P>
+<I>version </I>
+
+<BR> nfs version
+<P>
+<I>filename</I>
+
+<BR> file name
+<P>
+<I>flag</I>
+
+<BR> file flag
+<P>
+<I>mode</I>
+
+<BR> file mode
+<P>
+
+<DT><B>nfs.proc.release</B>
+
+<DD>
+<P>
+Fires whenever doing a release operation on nfs client side,
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>server_ip </I>
+
+<BR> ip address of server
+<P>
+<I>prot </I>
+
+<BR> transfer protocol
+<P>
+<I>version </I>
+
+<BR> nfs version
+<P>
+<I>filename</I>
+
+<BR> file name
+<P>
+<I>flag</I>
+
+<BR> file flag
+<P>
+<I>mode</I>
+
+<BR> file mode
+<P>
+
+<DT><B>nfs.proc4.handle_exception</B>
+
+<DD>
+<P>
+Fires whenever doing the error handling, only exist in NFSV4
+<P>
+<I>errorcode </I>
+
+<BR> error code
+<P>
+
+<DT><B>nfs.proc.create</B>
+
+<DD>
+<P>
+Fires whenever nfs client creates a file on server
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>server_ip </I>
+
+<BR> ip address of server
+<P>
+<I>prot </I>
+
+<BR> transfer protocol
+<P>
+<I>version </I>
+
+<BR> nfs version
+<P>
+<I>fh </I>
+
+<BR> file handler of parent dir
+<P>
+<I>filename </I>
+
+<BR> file name
+<P>
+<I>filelen </I>
+
+<BR> length of file name
+<P>
+<I>flag </I>
+
+<BR> indicates create mode(only for NFSV3 and NFSV4)
+<P>
+
+<DT><B>nfs.proc.remove</B>
+
+<DD>
+<P>
+Fires whenever nfs client removes a file from server
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>server_ip </I>
+
+<BR> ip address of server
+<P>
+<I>prot </I>
+
+<BR> transfer protocol
+<P>
+<I>version </I>
+
+<BR> nfs version
+<P>
+<I>fh </I>
+
+<BR> file handler of parent dir
+<P>
+<I>filename </I>
+
+<BR> file name
+<P>
+<I>filelen </I>
+
+<BR> length of file name
+<P>
+
+<DT><B>nfs.proc.rename</B>
+
+<DD>
+<P>
+Fires whenever nfs client renames a file on server
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>server_ip </I>
+
+<BR> ip address of server
+<P>
+<I>prot </I>
+
+<BR> transfer protocol
+<P>
+<I>version </I>
+
+<BR> nfs version
+<P>
+<I>old_fh </I>
+
+<BR> file handler of old parent dir
+<P>
+<I>old_name </I>
+
+<BR> old file name
+<P>
+<I>old_filelen </I>
+
+<BR> length of old file name
+<P>
+<I>new_fh </I>
+
+<BR> file handler of new parent dir
+<P>
+<I>new_name </I>
+
+<BR> new file name
+<P>
+<I>new_filelen </I>
+
+<BR> length of new file name
+<P>
+</DL>
+<A NAME="lbAD"> </A>
+<H2>SEE ALSO</H2>
+
+<I><A HREF="stap.1.html">stap</A></I>(1),
+
+<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
+
+<P>
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
+<DT><A HREF="#lbAD">SEE ALSO</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of STAPPROBES.NFSD</TITLE>
+</HEAD><BODY>
+<H1>STAPPROBES.NFSD</H1>
+Section: Misc. Reference Manual Pages (3stap)<BR>Updated: 2009-11-17<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+stapprobes.nfsd - systemtap NFS server side probe points
+<P>
+
+
+
+<P>
+<A NAME="lbAC"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+This family of probe points is used to probe NFS activities on
+server side. Because there is only one function, i.e., nfsd4_proc_compound
+in proc level for NFSv4, all the following nfsd.proc probe points except
+nfsd.proc.compound are only for NFSv2 and NFSv3.
+<P>
+It contains the following probe points:
+<P>
+
+<DL COMPACT>
+<DT><B>nfsd.proc.lookup</B>
+
+<DD>
+<P>
+Fires whenever client opens/searches file on server
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>client_ip </I>
+
+<BR> the ip address of client
+<P>
+<I>proto </I>
+
+<BR> transfer protocol
+<P>
+<I>version </I>
+
+<BR> nfs version
+<P>
+<I>fh </I>
+
+<BR> the pointer to file handler of parent dir
+<P>
+<I>filename</I>
+
+<BR> file name
+<P>
+<I>filelen</I>
+
+<BR> the length of file name
+<P>
+
+<DT><B>nfsd.proc.read</B>
+
+<DD>
+<P>
+Fires whenever client reads file on server
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>client_ip </I>
+
+<BR> the ip address of client
+<P>
+<I>proto </I>
+
+<BR> transfer protocol
+<P>
+<I>version </I>
+
+<BR> nfs version
+<P>
+<I>fh </I>
+
+<BR> the pointer to file handler of file
+<P>
+<I>count,size </I>
+
+<BR> number of bytes to be read
+<P>
+<I>offset </I>
+
+<BR> the offset of file
+<P>
+<I>vec</I>
+
+<BR> struct kvec, includes buf address in kernel address
+<BR> and the length of each buffer
+<P>
+<I>vlen </I>
+
+<BR> number of blocks to be read
+<P>
+
+<DT><B>nfsd.proc.write</B>
+
+<DD>
+<P>
+Fires whenever client writes data to file on server
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>client_ip </I>
+
+<BR> the ip address of client
+<P>
+<I>proto </I>
+
+<BR> transfer protocol
+<P>
+<I>version </I>
+
+<BR> nfs version
+<P>
+<I>fh </I>
+
+<BR> the pointer to file handler of file
+<P>
+<I>count,size </I>
+
+<BR> number of bytes to written
+<P>
+<I>offset </I>
+
+<BR> the offset of file
+<P>
+<I>vec</I>
+
+<BR> struct kvec, includes buf address in kernel address
+<BR> and the length of each buffer
+<P>
+<I>vlen </I>
+
+<BR> number of blocks to written
+<P>
+<I>stable </I>
+
+<BR> argp->stable(only for nfs.proc3.write)
+<P>
+
+<DT><B>nfsd.proc.commit</B>
+
+<DD>
+<P>
+Fires whenever client does a commit operation
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>client_ip </I>
+
+<BR> the ip address of client
+<P>
+<I>proto </I>
+
+<BR> transfer protocol
+<P>
+<I>version </I>
+
+<BR> nfs version
+<P>
+<I>fh </I>
+
+<BR> the pointer to file handler of file
+<P>
+<I>count,size </I>
+
+<BR> number of bytes to written
+<P>
+<I>offset </I>
+
+<BR> the offset of file
+<P>
+
+<DT><B>nfsd.proc.create</B>
+
+<DD>
+<P>
+Fires whenever client creates a file on server
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>client_ip </I>
+
+<BR> the ip address of client
+<P>
+<I>proto </I>
+
+<BR> transfer protocol
+<P>
+<I>version </I>
+
+<BR> nfs version
+<P>
+<I>fh </I>
+
+<BR> the pointer to file handler of parent dir
+<P>
+<I>filename</I>
+
+<BR> file name
+<P>
+<I>filelen</I>
+
+<BR> the length of file name
+<P>
+
+<DT><B>nfsd.proc.remove</B>
+
+<DD>
+<P>
+Fires whenever client removes a file on server
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>client_ip </I>
+
+<BR> the ip address of client
+<P>
+<I>proto </I>
+
+<BR> transfer protocol
+<P>
+<I>version </I>
+
+<BR> nfs version
+<P>
+<I>fh </I>
+
+<BR> the pointer to file handler of file
+<P>
+<I>filename</I>
+
+<BR> file name
+<P>
+<I>filelen</I>
+
+<BR> the length of file name
+<P>
+
+<DT><B>nfsd.proc.rename</B>
+
+<DD>
+<P>
+Fires whenever client renames a file on server
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>client_ip </I>
+
+<BR> the ip address of client
+<P>
+<I>proto </I>
+
+<BR> transfer protocol
+<P>
+<I>version </I>
+
+<BR> nfs version
+<P>
+<I>fh </I>
+
+<BR> the pointer to file handler of old path
+<P>
+<I>tfh </I>
+
+<BR> the pointer to file handler of new path
+<P>
+<I>filename</I>
+
+<BR> old file name
+<P>
+<I>tname</I>
+
+<BR> new file name
+<P>
+<I>filelen</I>
+
+<BR> the length of old file name
+<P>
+<I>tlen</I>
+
+<BR> the length of new file name
+<P>
+
+<DT><B>nfsd.proc.compound</B>
+
+<DD>
+<P>
+Fires whenever server receives a NFSV4 operation from client
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>client_ip </I>
+
+<BR> the ip address of client
+<P>
+<I>proto </I>
+
+<BR> transfer protocol
+<P>
+<I>version </I>
+
+<BR> nfs version
+<P>
+<I>num</I>
+
+<BR> number of file operation
+<P>
+<I>op</I>
+
+<BR> head of operation list
+<P>
+
+<DT><B>nfsd.open</B>
+
+<DD>
+<P>
+Fires whenever server opens file
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>fh</I>
+
+<BR> file handle (the first part is the length of the file handle)
+<P>
+<I>access</I>
+
+<BR> type of open (read/write/commit/readdir...)
+<P>
+<I>type</I>
+
+<BR> type of file(regular file or dir)
+<P>
+
+<DT><B>nfsd.read</B>
+
+<DD>
+<P>
+Fires whenever server reads file
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>fh</I>
+
+<BR> file handle (the first part is the length of the file handle)
+<P>
+<I>file</I>
+
+<BR> argument :file, indicates if the file has been opened.
+<P>
+<I>count,size </I>
+
+<BR> number of bytes to be read
+<P>
+<I>offset </I>
+
+<BR> the offset of file
+<P>
+<I>vec</I>
+
+<BR> struct kvec, includes buf address in kernel address
+<BR> and the length of each buffer
+<P>
+<I>vlen </I>
+
+<BR> number of blocks to be read
+<P>
+
+<DT><B>nfsd.write</B>
+
+<DD>
+<P>
+Fires whenever server writes file
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>fh</I>
+
+<BR> file handle (the first part is the length of the file handle)
+<P>
+<I>file</I>
+
+<BR> argument :file, indicates if the file has been opened.
+<P>
+<I>count,size </I>
+
+<BR> number of bytes to be read
+<P>
+<I>offset </I>
+
+<BR> the offset of file
+<P>
+<I>vec</I>
+
+<BR> struct kvec, includes buf address in kernel address
+<BR> and the length of each buffer
+<P>
+<I>vlen </I>
+
+<BR> number of blocks to be written
+<P>
+
+<DT><B>nfsd.commit</B>
+
+<DD>
+<P>
+Fires when server commits all pending writes to stable storage
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>fh</I>
+
+<BR> file handle (the first part is the length of the file handle)
+<P>
+<I>count,size </I>
+
+<BR> number of bytes to be read
+<P>
+<I>offset </I>
+
+<BR> the offset of file
+<P>
+
+<DT><B>nfsd.lookup</B>
+
+<DD>
+<P>
+Fires whenever client opens/searches file on server
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>fh</I>
+
+<BR> file handle (the first part is the length of the file handle)
+<P>
+<I>filename</I>
+
+<BR> file name
+<P>
+<I>filelen</I>
+
+<BR> the length of file name
+<P>
+
+<DT><B>nfsd.create</B>
+
+<DD>
+<P>
+<BR> Fires when client creates a file(regular,dir,device,fifo) on
+<BR> server side, sometimes nfsd will call nfsd_create_v3 instead
+<BR> of this function
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>fh </I>
+
+<BR> file handle (the first part is the length of the file handle)
+<P>
+<I>filename </I>
+
+<BR> file name
+<P>
+<I>filelen </I>
+
+<BR> the length of file name
+<P>
+<I>type </I>
+
+<BR> file type(regular,dir,device,fifo ...)
+<P>
+<I>iap_valid</I>
+
+<BR> Attribute flags
+<P>
+<I>iap_mode </I>
+
+<BR> file access mod
+<P>
+
+<DT><B>nfsd.createv3</B>
+
+<DD>
+<P>
+Fires when client creates a regular file or set file attributes
+on server side, only called by nfsd3_proc_create and nfsd4_open
+(op_claim_type is NFS4_OPEN_CLAIM_NULL)
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>fh </I>
+
+<BR> file handle (the first part is the length of the file handle)
+<P>
+<I>filename </I>
+
+<BR> file name
+<P>
+<I>filelen </I>
+
+<BR> the length of file name
+<P>
+<I>iap_valid </I>
+
+<BR> Attribute flags
+<P>
+<I>iap_mode </I>
+
+<BR> file access mode
+<P>
+<I>createmode </I>
+
+<BR> create mode. The possible values could be:
+<BR> NFS3_CREATE_EXCLUSIVE,NFS3_CREATE_UNCHECKED,NFS3_CREATE_GUARDED
+<P>
+<I>truncp </I>
+
+<BR> trunp arguments, indicates if the file should be truncated
+<P>
+<I>verfier </I>
+
+<BR> file attributes (atime,mtime,mode). It's used to reset file
+<BR> attributes for CREATE_EXCLUSIVE
+<P>
+
+<DT><B>nfsd.unlink</B>
+
+<DD>
+<P>
+Fires when client removes a file or a dir on server side,
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>fh </I>
+
+<BR> file handle (the first part is the length of the file handle)
+<P>
+<I>filename </I>
+
+<BR> file name
+<P>
+<I>filelen </I>
+
+<BR> the length of file name
+<P>
+<I>type </I>
+
+<BR> file type(file or dir)
+<P>
+
+<DT><B>nfsd.rename</B>
+
+<DD>
+Fires when clients rename a file on server side
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>fh </I>
+
+<BR> file handler of old path
+<P>
+<I>tfh </I>
+
+<BR> file handler of new path
+<P>
+<I>filename </I>
+
+<BR> old file name
+<P>
+<I>tname </I>
+
+<BR> new file name
+<P>
+<I>flen </I>
+
+<BR> length of old file name
+<P>
+<I>tlen </I>
+
+<BR> length of new file name
+<P>
+
+<DT><B>nfsd.close</B>
+
+<DD>
+<P>
+Fires whenever server closes file
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>filename</I>
+
+<BR> file name
+<P>
+
+<DT><B>nfsd.dispatch</B>
+
+<DD>
+<P>
+Fires whenever server receives NFS operation from client
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>client_ip </I>
+
+<BR> the ip address of client
+<P>
+<I>proto </I>
+
+<BR> transfer protocol
+<P>
+<I>version </I>
+
+<BR> nfs version
+<P>
+<I>xid </I>
+
+<BR> transmission id
+<P>
+<I>prog </I>
+
+<BR> program number
+<P>
+<I>proc </I>
+
+<BR> procedure number
+<P>
+</DL>
+<A NAME="lbAD"> </A>
+<H2>SEE ALSO</H2>
+
+<I><A HREF="stap.1.html">stap</A></I>(1),
+
+<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
+
+<P>
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
+<DT><A HREF="#lbAD">SEE ALSO</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of STAPPROBES.PAGEFAULT</TITLE>
+</HEAD><BODY>
+<H1>STAPPROBES.PAGEFAULT</H1>
+Section: Misc. Reference Manual Pages (3stap)<BR>Updated: 2009-11-17<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+stapprobes.pagefault - systemtap pagefault probe points
+<P>
+
+
+
+<P>
+<A NAME="lbAC"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+This family of probe points is used to probe page fault events.
+It contains the following probe points:
+<P>
+
+<DL COMPACT>
+<DT><B>vm.pagefault</B>
+
+<DD>
+Fires when there is a pagefault
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>address</I>
+
+<BR> The address caused this page fault.
+<P>
+<I>write_access</I>
+
+<BR> 1 means this is a write access and 0 means this is a read access
+<P>
+</DL>
+<A NAME="lbAD"> </A>
+<H2>SEE ALSO</H2>
+
+<I><A HREF="stap.1.html">stap</A></I>(1),
+
+<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
+
+<P>
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
+<DT><A HREF="#lbAD">SEE ALSO</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of STAPPROBES.RPC</TITLE>
+</HEAD><BODY>
+<H1>STAPPROBES.RPC</H1>
+Section: Misc. Reference Manual Pages (3stap)<BR>Updated: 2009-11-17<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+stapprobes.rpc - systemtap SunRPC probe points
+<P>
+
+
+
+<P>
+<A NAME="lbAC"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+This family of probe points is used to probe the SUNRPC activities,
+including the client, the server and the sunrpc scheduler.
+<P>
+It contains the following probe points:
+<P>
+
+<DL COMPACT>
+<DT><B>sunrpc.clnt.create_client</B>
+
+<DD>
+Fires when an RPC client is to be created
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>servername</I>
+
+<BR> The name of the server machine
+<P>
+<I>progname</I>
+
+<BR> The name of the RPC program
+<P>
+<I>prog</I>
+
+<BR> The number of the RPC program
+<P>
+<I>vers</I>
+
+<BR> The version number of the RPC program
+<P>
+<I>prot</I>
+
+<BR> The number of the IP protocol
+<P>
+<I>authflavor</I>
+
+<BR> The authentication flavor
+<P>
+
+<DT><B>sunrpc.clnt.clone_client</B>
+
+<DD>
+Fires when an RPC client structure is to be cloned
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>servername</I>
+
+<BR> The name of the server machine
+<P>
+<I>progname</I>
+
+<BR> The name of the RPC program
+<P>
+<I>prog</I>
+
+<BR> The number of the RPC program
+<P>
+<I>vers</I>
+
+<BR> The version number of the RPC program
+<P>
+<I>prot</I>
+
+<BR> The number of the IP protocol
+<P>
+<I>authflavor</I>
+
+<BR> The authentication flavor
+<P>
+
+<DT><B>sunrpc.clnt.shutdown_client</B>
+
+<DD>
+Fires when an RPC client is to be shut down
+<P>
+<B>Arguments</B>
+
+<P>
+<I>servername</I>
+
+<BR> The name of the server machine
+<P>
+<I>progname</I>
+
+<BR> The name of the RPC program
+<P>
+<I>prog</I>
+
+<BR> The number of the RPC program
+<P>
+<I>vers</I>
+
+<BR> The version number of the RPC program
+<P>
+<I>prot</I>
+
+<BR> The number of the IP protocol
+<P>
+<I>authflavor</I>
+
+<BR> The authentication flavor
+<P>
+<I>clones</I>
+
+<BR> The number of clones
+<P>
+<I>tasks</I>
+
+<BR> The number of references
+<P>
+<I>netreconn</I>
+
+<BR> The count of reconnections
+<P>
+<I>rpccnt</I>
+
+<BR> The count of RPC calls
+<P>
+<I>om_ops</I>
+
+<BR> The count of operations
+<P>
+<I>om_ntrans</I>
+
+<BR> The count of RPC transmissions
+<P>
+<I>om_bytes_sent</I>
+
+<BR> The count of bytes out
+<P>
+<I>om_bytes_recv</I>
+
+<BR> The count of bytes in
+<P>
+<I>om_queue</I>
+
+<BR> The jiffies queued for transmission
+<P>
+<I>om_rtt</I>
+
+<BR> The RPC RTT jiffies
+<P>
+<I>om_execution</I>
+
+<BR> The RPC execution jiffies
+<P>
+
+<DT><B>sunrpc.clnt.bind_new_program</B>
+
+<DD>
+Fires when a new RPC program is to be bound an existing client
+<P>
+<B>Arguments</B>
+
+<P>
+<I>servername</I>
+
+<BR> The name of the server machine
+<P>
+<I>old_progname</I>
+
+<BR> The name of old RPC program
+<P>
+<I>old_prog</I>
+
+<BR> The number of old RPC program
+<P>
+<I>old_vers</I>
+
+<BR> The version of old RPC program
+<P>
+<I>progname</I>
+
+<BR> The name of new RPC program
+<P>
+<I>prog</I>
+
+<BR> The number of new RPC program
+<P>
+<I>vers</I>
+
+<BR> The version of new RPC program
+<P>
+
+<DT><B>sunrpc.clnt.call_sync</B>
+
+<DD>
+Fires when an RPC procedure is to be called synchronously
+<P>
+<B>Arguments</B>
+
+<P>
+<I>servername</I>
+
+<BR> The name of the server machine
+<P>
+<I>progname</I>
+
+<BR> The name of the RPC program
+<P>
+<I>prog</I>
+
+<BR> The number of the RPC program
+<P>
+<I>vers</I>
+
+<BR> The version number of the RPC program
+<P>
+<I>prot</I>
+
+<BR> The number of the IP protocol
+<P>
+<I>port</I>
+
+<BR> The port number
+<P>
+<I>xid</I>
+
+<BR> Current transmission id
+<P>
+<I>dead</I>
+
+<BR> Whether this client is abandoned
+<P>
+<I>procname</I>
+
+<BR> The procedure name in this RPC call
+<P>
+<I>proc</I>
+
+<BR> The procedure number in this RPC call
+<P>
+<I>flags</I>
+
+<BR> The flags of this RPC call
+<P>
+
+<DT><B>sunrpc.clnt.call_async</B>
+
+<DD>
+Fires when an RPC procedure is to be called asynchronously
+<P>
+<B>Arguments</B>
+
+<P>
+<I>servername</I>
+
+<BR> The name of the server machine
+<P>
+<I>progname</I>
+
+<BR> The name of the RPC program
+<P>
+<I>prog</I>
+
+<BR> The number of the RPC program
+<P>
+<I>vers</I>
+
+<BR> The version number of the RPC program
+<P>
+<I>prot</I>
+
+<BR> The number of the IP protocol
+<P>
+<I>port</I>
+
+<BR> The port number
+<P>
+<I>xid</I>
+
+<BR> Current transmission id
+<P>
+<I>dead</I>
+
+<BR> Whether this client is abandoned
+<P>
+<I>procname</I>
+
+<BR> The procedure name in this RPC call
+<P>
+<I>proc</I>
+
+<BR> The procedure number in this RPC call
+<P>
+<I>flags</I>
+
+<BR> The flags of this RPC call
+<P>
+
+<DT><B>sunrpc.clnt.restart_call</B>
+
+<DD>
+Fires when an (async) RPC client is to be restarted
+<P>
+<B>Arguments</B>
+
+<P>
+<I>servername</I>
+
+<BR> The name of the server machine
+<P>
+<I>prog</I>
+
+<BR> The number of the RPC program
+<P>
+<I>xid</I>
+
+<BR> The transmission id
+<P>
+<I>tk_pid</I>
+
+<BR> The debugging aid of this task
+<P>
+<I>tk_flags</I>
+
+<BR> The task flags
+<P>
+<I>tk_priority</I>
+
+<BR> The task priority
+<P>
+<I>tk_runstate</I>
+
+<BR> The task run status
+<P>
+
+<DT><B>sunrpc.svc.register</B>
+
+<DD>
+Fires when an RPC service is to be registered with the local portmapper.
+If proto and port == 0, it means to unregister a service.
+<P>
+<B>Arguments</B>
+
+<P>
+<I>sv_name</I>
+
+<BR> The name of the service
+<P>
+<I>progname</I>
+
+<BR> The name of the RPC program
+<P>
+<I>prog</I>
+
+<BR> The number of the RPC program
+<P>
+<I>prot</I>
+
+<BR> The number of the IP protocol
+<P>
+<I>port</I>
+
+<BR> The port number
+<P>
+
+<DT><B>sunrpc.svc.create</B>
+
+<DD>
+Fires when an RPC service is to be created
+<P>
+<B>Arguments</B>
+
+<P>
+<I>progname</I>
+
+<BR> The name of the RPC program
+<P>
+<I>prog</I>
+
+<BR> The number of the RPC program
+<P>
+<I>pg_nvers</I>
+
+<BR> The total of the supported versions
+<P>
+<I>bufsize</I>
+
+<BR> The buffer size
+<P>
+
+<DT><B>sunrpc.svc.destroy</B>
+
+<DD>
+Fires when an RPC client is to be destroyed
+<P>
+<B>Arguments</B>
+
+<P>
+<I>sv_name</I>
+
+<BR> The service name
+<P>
+<I>sv_progname</I>
+
+<BR> The name of the program
+<P>
+<I>sv_prog</I>
+
+<BR> The number of the program
+<P>
+<I>sv_nrthreads</I>
+
+<BR> The number of concurrent threads
+<P>
+<I>netcnt</I>
+
+<BR> The count of received RPC requests
+<P>
+<I>nettcpconn</I>
+
+<BR> The count of accepted TCP connections
+<P>
+<I>rpccnt</I>
+
+<BR> The count of valid RPC requests
+<P>
+<I>rpcbadfmt</I>
+
+<BR> The count of requests dropped for bad formats
+<P>
+<I>rpcbadauth</I>
+
+<BR> The count of requests drooped for authentication failure
+<P>
+
+<DT><B>sunrpc.svc.process</B>
+
+<DD>
+Fires when an RPC client is to be processed
+<P>
+<B>Arguments</B>
+
+<P>
+<I>sv_name</I>
+
+<BR> The service name
+<P>
+<I>sv_prog</I>
+
+<BR> The number of the program
+<P>
+<I>sv_nrthreads</I>
+
+<BR> The number of concurrent threads
+<P>
+<I>peer_ip</I>
+
+<BR> The peer address where the request is from
+<P>
+<I>rq_xid</I>
+
+<BR> The transmission id in the request
+<P>
+<I>rq_prog</I>
+
+<BR> The program number in the request
+<P>
+<I>rq_vers</I>
+
+<BR> The program version in the request
+<P>
+<I>rq_proc</I>
+
+<BR> The procedure number in the request
+<P>
+<I>rq_prot</I>
+
+<BR> The IP protocol of the request
+<P>
+
+<DT><B>sunrpc.svc.authorise</B>
+
+<DD>
+Fires when an RPC client is to be authorised
+<P>
+<B>Arguments</B>
+
+<P>
+<I>sv_name</I>
+
+<BR> The service name
+<P>
+<I>peer_ip</I>
+
+<BR> The peer address where the request is from
+<P>
+<I>rq_xid</I>
+
+<BR> The transmission id in the request
+<P>
+<I>rq_prog</I>
+
+<BR> The program number in the request
+<P>
+<I>rq_vers</I>
+
+<BR> The program version in the request
+<P>
+<I>rq_proc</I>
+
+<BR> The procedure number in the request
+<P>
+<I>rq_prot</I>
+
+<BR> The IP protocol of the request
+<P>
+
+<DT><B>sunrpc.svc.recv</B>
+
+<DD>
+Fires when the server is to receive the next request on any socket
+<P>
+<B>Arguments</B>
+
+<P>
+<I>sv_name</I>
+
+<BR> The service name
+<P>
+<I>sv_prog</I>
+
+<BR> The number of the program
+<P>
+<I>sv_nrthreads</I>
+
+<BR> The number of concurrent threads
+<P>
+<I>timeout</I>
+
+<BR> The timeout of waiting for data
+<P>
+
+<DT><B>sunrpc.svc.send</B>
+
+<DD>
+Fires when want to return reply to client
+<P>
+<B>Arguments</B>
+
+<P>
+<I>sv_name</I>
+
+<BR> The service name
+<P>
+<I>peer_ip</I>
+
+<BR> The peer address where the request is from
+<P>
+<I>rq_xid</I>
+
+<BR> The transmission id in the request
+<P>
+<I>rq_prog</I>
+
+<BR> The program number in the request
+<P>
+<I>rq_vers</I>
+
+<BR> The program version in the request
+<P>
+<I>rq_proc</I>
+
+<BR> The procedure number in the request
+<P>
+<I>rq_prot</I>
+
+<BR> The IP protocol of the request
+<P>
+
+<DT><B>sunrpc.svc.drop</B>
+
+<DD>
+Fires when a request is to be dropped
+<P>
+<B>Arguments</B>
+
+<P>
+<I>sv_name</I>
+
+<BR> The service name
+<P>
+<I>peer_ip</I>
+
+<BR> The peer address where the request is from
+<P>
+<I>rq_xid</I>
+
+<BR> The transmission id in the request
+<P>
+<I>rq_prog</I>
+
+<BR> The program number in the request
+<P>
+<I>rq_vers</I>
+
+<BR> The program version in the request
+<P>
+<I>rq_proc</I>
+
+<BR> The procedure number in the request
+<P>
+<I>rq_prot</I>
+
+<BR> The IP protocol of the request
+<P>
+
+<DT><B>sunrpc.sched.new_task</B>
+
+<DD>
+Fires when a new task is to be created for the specified client
+<P>
+<B>Arguments</B>
+
+<I>xid</I>
+
+<BR> The transmission id in the RPC call
+<P>
+<I>prog</I>
+
+<BR> The program number in the RPC call
+<P>
+<I>vers</I>
+
+<BR> The program version in the RPC call
+<P>
+<I>prot</I>
+
+<BR> The IP protocol in the RPC call
+<P>
+<I>tk_flags</I>
+
+<BR> The flags of the task
+<P>
+
+<DT><B>sunrpc.sched.release_task</B>
+
+<DD>
+Fires when all resources associated with a task are to be released
+<P>
+<B>Arguments</B>
+
+<P>
+<I>xid</I>
+
+<BR> The transmission id in the RPC call
+<P>
+<I>prog</I>
+
+<BR> The program number in the RPC call
+<P>
+<I>vers</I>
+
+<BR> The program version in the RPC call
+<P>
+<I>prot</I>
+
+<BR> The IP protocol in the RPC call
+<P>
+<I>tk_flags</I>
+
+<BR> The flags of the task
+<P>
+
+<DT><B>sunrpc.sched.execute</B>
+
+<DD>
+Fires when the RPC `scheduler'(or rather, the finite state machine)
+is to be executed
+<P>
+<B>Arguments</B>
+
+<P>
+<I>xid</I>
+
+<BR> The transmission id in the RPC call
+<P>
+<I>prog</I>
+
+<BR> The program number in the RPC call
+<P>
+<I>vers</I>
+
+<BR> The program version in the RPC call
+<P>
+<I>prot</I>
+
+<BR> The IP protocol in the RPC call
+<P>
+<I>tk_pid</I>
+
+<BR> The debugging id of the task
+<P>
+<I>tk_flags</I>
+
+<BR> The flags of the task
+<P>
+
+<DT><B>sunrpc.sched.delay</B>
+
+<DD>
+Fires when a task is to be delayed
+<P>
+<B>Arguments</B>
+
+<P>
+<I>xid</I>
+
+<BR> The transmission id in the RPC call
+<P>
+<I>prog</I>
+
+<BR> The program number in the RPC call
+<P>
+<I>vers</I>
+
+<BR> The program version in the RPC call
+<P>
+<I>prot</I>
+
+<BR> The IP protocol in the RPC call
+<P>
+<I>tk_pid</I>
+
+<BR> The debugging id of the task
+<P>
+<I>tk_flags</I>
+
+<BR> The flags of the task
+<P>
+<I>delay</I>
+
+<BR> The time delayed
+<P>
+</DL>
+<A NAME="lbAD"> </A>
+<H2>SEE ALSO</H2>
+
+<I><A HREF="stap.1.html">stap</A></I>(1),
+
+<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
+
+<P>
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
+<DT><A HREF="#lbAD">SEE ALSO</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of STAPPROBES.SCSI</TITLE>
+</HEAD><BODY>
+<H1>STAPPROBES.SCSI</H1>
+Section: Misc. Reference Manual Pages (3stap)<BR>Updated: 2009-11-17<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+stapprobes.scsi - systemtap scsi probe points
+<P>
+
+
+
+<P>
+<A NAME="lbAC"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+This family of probe points is used to probe the SCSI activities.
+It contains the following probe points:
+<P>
+
+<DL COMPACT>
+<DT><B>scsi.ioentry</B>
+
+<DD>
+Fires when SCSI mid layer prepares a SCSI request
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>disk_major</I>
+
+<BR> The major number of the disk
+<P>
+<I>disk_minor</I>
+
+<BR> The minor number of the disk
+<P>
+<I>device_state</I>
+
+<BR> The current state of the device. The possible values could be:
+<P>
+<BR> SDEV_CREATED = 1, /* device created but not added to sysfs
+<BR> * Only internal commands allowed (for inq) */
+<BR> SDEV_RUNNING = 2, /* device properly configured
+<BR> * All commands allowed */
+<BR> SDEV_CANCEL = 3, /* beginning to delete device
+<BR> * Only error handler commands allowed */
+<BR> SDEV_DEL = 4, /* device deleted
+<BR> * no commands allowed */
+<BR> SDEV_QUIESCE = 5, /* Device quiescent. No block commands
+<BR> * will be accepted, only specials (which
+<BR> * originate in the mid-layer) */
+<BR> SDEV_OFFLINE = 6, /* Device offlined (by error handling or
+<BR> * user request */
+<BR> SDEV_BLOCK = 7, /* Device blocked by scsi lld. No scsi
+<BR> * commands from user or midlayer should be issued
+<BR> * to the scsi lld. */
+<P>
+
+<DT><B>scsi.iodispatching</B>
+
+<DD>
+Fires when the SCSI mid layer dispatches a SCSI command to the low level driver
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>host_no</I>
+
+<BR> The host number
+<P>
+<I>channel</I>
+
+<BR> The channel number
+<P>
+<I>lun</I>
+
+<BR> The lun number
+<P>
+<I>dev_id</I>
+
+<BR> The scsi device id
+<P>
+<I>device_state</I>
+
+<BR> The current state of the device.
+<P>
+<I>data_direction</I>
+
+<BR> The data_direction specifies whether this command is from/to the device.
+<BR> The possible values could be:
+<P>
+<BR> DMA_BIDIRECTIONAL = 0,
+<BR> DMA_TO_DEVICE = 1,
+<BR> DMA_FROM_DEVICE = 2,
+<BR> DMA_NONE = 3,
+<P>
+<I>request_buffer</I>
+
+<BR> The request buffer address
+<P>
+<I>req_bufflen</I>
+
+<BR> The request buffer length
+<P>
+
+<DT><B>scsi.iodone</B>
+
+<DD>
+Fires when a SCSI command is done by low level driver and enqueued into the done queue.
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>host_no</I>
+
+<BR> The host number
+<P>
+<I>channel</I>
+
+<BR> The channel number
+<P>
+<I>lun</I>
+
+<BR> The lun number
+<P>
+<I>dev_id</I>
+
+<BR> The scsi device id
+<P>
+<I>device_state</I>
+
+<BR> The current state of the device
+<P>
+<I>data_direction</I>
+
+<BR> The data_direction specifies whether this command is from/to the device.
+<P>
+
+<DT><B>scsi.iocompleted</B>
+
+<DD>
+Fires when SCSI mid layer runs the completion processing for
+block device I/O requests
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>host_no</I>
+
+<BR> The host number
+<P>
+<I>channel</I>
+
+<BR> The channel number
+<P>
+<I>lun</I>
+
+<BR> The lun number
+<P>
+<I>dev_id</I>
+
+<BR> The scsi device id
+<P>
+<I>device_state</I>
+
+<BR> The current state of the device
+<P>
+<I>data_direction</I>
+
+<BR> The data_direction specifies whether this command is from/to the device.
+<P>
+<I>goodbytes</I>
+
+<BR> The bytes completed.
+<P>
+</DL>
+<A NAME="lbAD"> </A>
+<H2>SEE ALSO</H2>
+
+<I><A HREF="stap.1.html">stap</A></I>(1),
+
+<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
+
+<P>
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
+<DT><A HREF="#lbAD">SEE ALSO</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of STAPPROBES.SIGNAL</TITLE>
+</HEAD><BODY>
+<H1>STAPPROBES.SIGNAL</H1>
+Section: Misc. Reference Manual Pages (3stap)<BR>Updated: 2009-11-17<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+stapprobes.signal - systemtap signal probe points
+<P>
+
+
+
+<P>
+<A NAME="lbAC"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+This family of probe points is used to probe signal activities.
+It contains the following probe points:
+<P>
+
+<DL COMPACT>
+<DT><B>signal.send</B>
+
+<DD>
+<P>
+Fires when a signal is sent to a process
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>sig</I>
+
+<BR> signal number
+<P>
+<I>sig_name</I>
+
+<BR> a string representation of the signal
+<P>
+<I>sig_pid</I>
+
+<BR> pid of the signal recipient process
+<P>
+<I>pid_name</I>
+
+<BR> name of the signal recipient process
+<P>
+<I>si_code</I>
+
+<BR> indicates the signal type
+<P>
+<I>task</I>
+
+<BR> a task handle to the signal recipient
+<P>
+<I>sinfo</I>
+
+<BR> the address of siginfo struct
+<P>
+<I>shared</I>
+
+<BR> indicates whether this signal is shared by the thread group
+<P>
+<I>send2queue</I>
+
+<BR> indicates whether this signal is sent to an existing sigqueue
+<P>
+<I>name</I>
+
+<BR> name of the function used to send out this signal
+<P>
+
+<DT><B>signal.send.return</B>
+
+<DD>
+<P>
+Fires when return from sending a signal
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>retstr</I>
+
+<BR> the return value
+<P>
+<BR> Return values for "__group_send_sig_info" and "specific_send_sig_info"
+<P>
+<DL COMPACT><DT><DD>
+<DL COMPACT><DT><DD>
+- return 0 if the signal is successfully sent to a process,
+which means the following:
+<P>
+<1> the signal is ignored by receiving process
+<P>
+<2> this is a non-RT signal and we already have one queued
+<P>
+<3> the signal is successfully added into the sigqueue of receiving process
+<P>
+- return -EAGAIN if the sigqueue is overflow the signal was RT and sent
+by user using something other than kill()
+</DL>
+
+<P>
+<BR> Return values for "send_group_sigqueue"
+<P>
+<DL COMPACT><DT><DD>
+- return 0 if the signal is either successfully added into the
+sigqueue of receiving process or a SI_TIMER entry is already
+queued so just increment the overrun count
+<P>
+- return 1 if this signal is ignored by receiving process
+</DL>
+
+<P>
+<BR> Return values for "send_sigqueue"
+<P>
+<DL COMPACT><DT><DD>
+- return 0 if the signal is either successfully added into the
+sigqueue of receiving process or a SI_TIMER entry is already
+queued so just increment the overrun count
+<P>
+- return 1 if this signal is ignored by receiving process
+<P>
+- return -1 if the task is marked exiting, so posix_timer_event
+can redirect it to the group leader
+</DL>
+
+<P>
+<I>shared</I>
+
+<BR> indicates whether this signal is shared by the thread group
+<P>
+<I>send2queue</I>
+
+<BR> indicates whether this signal is sent to an existing sigqueue
+<P>
+<I>name</I>
+
+<BR> name of the function used to send out this signal
+<P>
+<P>
+</DL>
+
+
+
+<DT><B>signal.checkperm</B>
+
+<DD>
+<P>
+Fires when check permissions for sending the signal
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>sig</I>
+
+<BR> the number of the signal
+<P>
+<I>sig_name</I>
+
+<BR> a string representation of the signal
+<P>
+<I>sig_pid</I>
+
+<BR> pid of the signal recipient process
+<P>
+<I>pid_name</I>
+
+<BR> name of the signal recipient process
+<P>
+<I>si_code</I>
+
+<BR> indicates the signal type
+<P>
+<I>task</I>
+
+<BR> a task handle to the signal recipient
+<P>
+<I>sinfo</I>
+
+<BR> the address of siginfo struct
+<P>
+<I>name</I>
+
+<BR> name of the probe point, is set to "signal.checkperm"
+<P>
+
+<DT><B>signal.checkperm.return</B>
+
+<DD>
+<P>
+Fires when return from permissions check for sending a signal
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>retstr</I>
+
+<BR> the return value
+<P>
+<I>name</I>
+
+<BR> name of the probe point, is set to "signal.checkperm"
+<P>
+
+<DT><B>signal.wakeup</B>
+
+<DD>
+<P>
+Fires when wake up the process for new active signals
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>sig_pid</I>
+
+<BR> pid of the process to be woke up
+<P>
+<I>pid_name</I>
+
+<BR> name of the process to be woke up
+<P>
+<I>resume</I>
+
+<BR> indicate whether to wake up a task in STOPPED or TRACED state
+<P>
+<I>state_mask</I>
+
+<BR> a string representation indicate the mask of task states
+that can be woken. Possible values are
+(TASK_INTERRUPTIBLE|TASK_STOPPED|TASK_TRACED) and
+TASK_INTERRUPTIBLE.
+<P>
+
+<DT><B>signal.check_ignored</B>
+
+<DD>
+<P>
+Fires when check whether the signal is ignored or not
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>sig_pid</I>
+
+<BR> pid of the signal recipient process
+<P>
+<I>pid_name</I>
+
+<BR> name of the signal recipient process
+<P>
+<I>sig</I>
+
+<BR> the signal to be checked
+<P>
+<I>sig_name</I>
+
+<BR> name of the signal
+<P>
+
+<DT><B>signal.check_ignored.return</B>
+
+<DD>
+<P>
+Fires when return from signal.check_ignored
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>retstr</I>
+
+<BR> return value. 0 indicate the current signal isn't ignored.
+<P>
+
+<DT><B>signal.force_segv</B>
+
+<DD>
+<P>
+Forces SIGSEGV when there are some issues while handling
+signals for the process
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>sig_pid</I>
+
+<BR> pid of the signal recipient process
+<P>
+<I>pid_name</I>
+
+<BR> name of the signal recipient process
+<P>
+<I>sig</I>
+
+<BR> the signal being handled
+<P>
+<I>sig_name</I>
+
+<BR> name of this signal
+<P>
+
+<DT><B>signal.force_segv.return</B>
+
+<DD>
+<P>
+Fires when return from signal.force_segv
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>retstr</I>
+
+<BR> return value. Always return 0
+<P>
+
+<DT><B>signal.syskill</B>
+
+<DD>
+<P>
+Fires when sys_kill is called to send a signal to a process.
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>pid</I>
+
+<BR> pid of the recipient process
+<P>
+<I>sig</I>
+
+<BR> the signal to be sent
+<P>
+
+<DT><B>signal.syskill.return</B>
+
+<DD>
+<P>
+Fires when returning from sys_kill
+<P>
+
+<DT><B>signal.tgkill</B>
+
+<DD>
+<P>
+Fires when sys_tgkill is called to send a signal to one specific thread
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>pid</I>
+
+<BR> pid of the recipient thread
+<P>
+<I>tgid</I>
+
+<BR> thread group id which the target thread should have
+<P>
+<I>sig</I>
+
+<BR> the signal to be sent
+<P>
+
+<DT><B>signal.tgkill.return</B>
+
+<DD>
+<P>
+Fires when returning from sys_tgkill
+<P>
+
+<DT><B>signal.tkill</B>
+
+<DD>
+<P>
+Fires when sys_tkill is called to send a signal to a single process.
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>pid</I>
+
+<BR> pid of the recipient process
+<P>
+<I>sig</I>
+
+<BR> the signal to be sent
+<P>
+
+<DT><B>signal.tkill.return</B>
+
+<DD>
+<P>
+Fires when returning from sys_tkill
+<P>
+
+<DT><B>signal.send_sig_queue</B>
+
+<DD>
+<P>
+Fires when queue a signal to a process
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>sig</I>
+
+<BR> the signal to be queued
+<P>
+<I>sig_name</I>
+
+<BR> name of this signal
+<P>
+<I>sig_pid</I>
+
+<BR> pid of the process to which the signal is queued
+<P>
+<I>pid_name</I>
+
+<BR> name of the process to which the signal is queued
+<P>
+<I>sigqueue_addr</I>
+
+<BR> address of the signal queue
+<P>
+
+<DT><B>signal.send_sig_queue.return</B>
+
+<DD>
+<P>
+Fires when return from signal.send_sig_queue
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>retstr</I>
+
+<BR> return value
+<P>
+
+<DT><B>signal.pending</B>
+
+<DD>
+<P>
+Fires when examine the set of signals that are
+pending for delivery to the calling thread
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>sigset_add</I>
+
+<BR> address of user space sigset_t
+<P>
+<I>sigset_size</I>
+
+<BR> sigset size
+<P>
+
+<DT><B>signal.pending.return</B>
+
+<DD>
+<P>
+Fires when return from signal.pending
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>retstr</I>
+
+<BR> return value
+<P>
+
+<DT><B>signal.handle</B>
+
+<DD>
+<P>
+Fires when invoking the signal handler
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>sig</I>
+
+<BR> signal number
+<P>
+<I>sig_name</I>
+
+<BR> signal name
+<P>
+<I>sinfo</I>
+
+<BR> address of siginfo struct
+<P>
+<I>sig_code</I>
+
+<BR> the si_code of siginfo
+<P>
+<I>ka_addr</I>
+
+<BR> Address of the k_sigaction struct associated with the signal
+<P>
+<I>oldset_addr</I>
+
+<BR> Address of a bit mask array of blocked signals
+<P>
+<I>sig_mode</I>
+
+<BR> indicates whether the signal is a User Mode or Kernel mode Signal
+<P>
+
+<DT><B>signal.handle.return</B>
+
+<DD>
+<P>
+Fires when return from signal.handle
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>retstr</I>
+
+<BR> return value of handle_signal()
+<P>
+
+<DT><B>signal.do_action</B>
+
+<DD>
+<P>
+Fires by calling thread to examine and change a signal action
+<BR>
+<B>Arguments:</B>
+
+<P>
+<I>sig</I>
+
+<BR> signal number
+<P>
+<I>sigact_addr</I>
+
+<BR> address of the new sigaction struct associated with the signal
+<P>
+<I>oldsigact_addr</I>
+
+<BR> address of a previous sigaction struct associated with the signal
+<P>
+<I>sa_handler</I>
+
+<BR> the new handler of the signal
+<P>
+<I>sa_mask</I>
+
+<BR> the new mask of the signal
+<P>
+
+<DT><B>signal.do_action.return</B>
+
+<DD>
+<P>
+Fires when return from signal.do_action
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>retstr</I>
+
+<BR> return value of do_sigaction()
+<P>
+
+<DT><B>signal.procmask</B>
+
+<DD>
+<P>
+Fires by calling thread to examine and change blocked signals
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>how</I>
+
+<BR> indicates how to change the blocked signals.
+<BR> Possible values are:
+<BR> SIG_BLOCK=0 for blocking signals
+<BR> SIG_UNBLOCK=1 for unblocking signals
+<BR> SIG_SETMASK=2 for setting the signal mask
+<P>
+<I>sigset_addr</I>
+
+<BR> address of sigset_t to be set
+<P>
+<I>oldsigset_addr</I>
+
+<BR> address of the old sigset_t
+<P>
+<I>sigset</I>
+
+<BR> the actual sigset to be set
+<P>
+
+<DT><B>signal.procmask.return</B>
+
+<DD>
+<P>
+Fires when return from signal.procmask
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>retstr</I>
+
+<BR> return value of sigprocmask()
+<P>
+
+<DT><B>signal.flush</B>
+
+<DD>
+<P>
+Fires when flush all pending signals for a task
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>task</I>
+
+<BR> the task handler of the process
+<P>
+<I>sig_pid</I>
+
+<BR> pid of the task
+<P>
+<I>pid_name</I>
+
+<BR> name of the task
+<P>
+</DL>
+<A NAME="lbAD"> </A>
+<H2>SEE ALSO</H2>
+
+<I><A HREF="stap.1.html">stap</A></I>(1),
+
+<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
+
+<P>
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
+<DT><A HREF="#lbAD">SEE ALSO</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of STAPPROBES.SOCKET</TITLE>
+</HEAD><BODY>
+<H1>STAPPROBES.SOCKET</H1>
+Section: Misc. Reference Manual Pages (3stap)<BR>Updated: 2009-11-17<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+stapprobes.socket - systemtap socket probe points
+<P>
+
+
+
+<P>
+<A NAME="lbAC"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+This family of probe points is used to probe socket activities.
+It contains the following probe points:
+<P>
+
+<DL COMPACT>
+<DT><B>socket.send</B>
+
+<DD>
+<P>
+Fires at the conclusion of sending a message on a socket.
+This probe alias includes the
+<B>socket.sendmsg.return,</B>
+
+<B>socket.aio_write.return</B>
+
+and
+<B>socket.writev.return</B>
+
+probes (these probes should
+catch all messages sent on sockets). The arguments supplied at the beginning
+of the send are cached and made available in this probe.
+<P>
+<B>Context:</B>
+
+<P>
+The message sender.
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>name</I>
+
+<BR> Name of this probe.
+<P>
+<I>size</I>
+
+<BR> Size of message sent (in bytes) or error code if success == 0
+<P>
+<I>protocol</I>
+
+<BR> Protocol used on the socket. Use sock_prot_num2str(protocol)
+<BR> to convert to a string.
+<P>
+<BR> Common values include:
+<BR> 0 - IP (Internet Protocol, local interprocess communications)
+<BR> 6 - TCP (Transmission Control Protocol)
+<BR> 17 - UDP (User Datagram Protocol)
+<BR> 132 - SCTP (Stream Control Transmission Protocol)
+<P>
+<BR> Refer to /etc/protocols for a complete list of possible values.
+<P>
+<I>family</I>
+
+<BR> Protocol family of the socket (from include/linux/socket.h).
+<BR> Use sock_fam_num2str(family) to convert to a string.
+<P>
+<BR> Possible values are:
+<BR> 0 - UNSPEC (Unspecified)
+<BR> 1 - LOCAL (Unix domain/local sockets)
+<BR> 2 - INET (Internet Protocol (IP))
+<BR> 3 - AX25 (Amateur Radio AX.25)
+<BR> 4 - IPX (Novell IPX)
+<BR> 5 - APPLETALK (AppleTalk DDP)
+<BR> 6 - NETROM (Amateur Radio NET/ROM)
+<BR> 7 - BRIDGE (Multiprotocol bridge)
+<BR> 8 - ATMPVC (ATM PVCs)
+<BR> 9 - X25 (X.25)
+<BR> 10 - INET6 (IP version 6)
+<BR> 11 - ROSE (Amateur Radio X.25 PLP)
+<BR> 12 - DECNET (Reserved for DECnet project)
+<BR> 13 - NETBEUI (Reserved for 802.2LLC project)
+<BR> 14 - SECURITY (Security callback pseudo AF)
+<BR> 15 - KEY (key management API)
+<BR> 16 - NETLINK (Netlink protocol)
+<BR> 17 - PACKET (Packet family)
+<BR> 18 - ASH (Ash)
+<BR> 19 - ECONET (Acorn Econet)
+<BR> 20 - ATMSVC (ATM SVCs)
+<BR> 22 - SNA (Linux SNA Project)
+<BR> 23 - IRDA (IRDA sockets)
+<BR> 24 - PPP0X (PPPoX sockets)
+<BR> 25 - WANPIPE (Wanpipe API Sockets)
+<BR> 26 - LLC (Linux LLC)
+<BR> 30 - TIPC (TIPC sockets)
+<BR> 31 - BLUETOOTH (Bluetooth sockets)
+<P>
+<I>state</I>
+
+<BR> State of the socket. Use sock_state_num2str(state) to convert
+<BR> to a string.
+<P>
+<BR> Possible values are:
+<BR> 0 - FREE (not allocated)
+<BR> 1 - UNCONNECTED (unconnected to any socket)
+<BR> 2 - CONNECTING (in the process of connecting)
+<BR> 3 - CONNECTED (connected to a socket)
+<BR> 4 - DISCONNECTING (in the process of disconnecting)
+<P>
+<I>flags</I>
+
+<BR> Socket flags. Use sock_flags_num2str(flags) to convert
+<BR> to a string.
+<P>
+<BR> Possible values are:
+<BR> 0 - ASYNC_NOSPACE
+<BR> 1 - ASYNC_WAITDATA
+<BR> 2 - NOSPACE
+<BR> 3 - PASSCRED
+<BR> 4 - PASSSEC
+<P>
+<I>type</I>
+
+<BR> Socket type. Use sock_type_num2str(type) to convert
+<BR> to a string.
+<P>
+<BR> Possible values are:
+<BR> 1 - STREAM (stream connection socket)
+<BR> 2 - DGRAM (datagram connectionless socket)
+<BR> 3 - RAW (raw socket)
+<BR> 4 - RDM (reliably-deliverd message)
+<BR> 5 - SEQPACKET (sequential packet socket)
+<BR> 6 - DCCP (datagram congestion control protocol socket)
+<BR> 10 - PACKET (Linux-specific way of getting packets at device level)
+<P>
+<I>success</I>
+
+<BR> Was send successful?
+<P>
+<BR> Possible values are:
+<BR> 1 - Yes
+<BR> 0 - No
+<P>
+<DT><B>socket.receive</B>
+
+<DD>
+<P>
+Fires at the conclusion of receiving a message on a socket.
+This probe alias includes the
+<B>socket.recvmsg.return,</B>
+
+<B>socket.aio_read.return</B>
+
+and
+<B>socket.readv.return</B>
+
+probes (these probes should
+catch all messages received on sockets). The arguments supplied at
+the beginning of the receive are cached and made available in this probe.
+<P>
+<B>Context:</B>
+
+<P>
+The message receiver.
+<P>
+<B>Arguments:</B>
+
+<P>
+Same as
+<B>socket.send.</B>
+
+<P>
+<DT><B>socket.sendmsg</B>
+
+<DD>
+<P>
+Fires when the sock_sendmsg() kernel function is entered.
+<P>
+<B>Context:</B>
+
+<P>
+The message sender.
+<P>
+<B>Arguments:</B>
+
+<P>
+Same as
+<B>socket.send,</B>
+
+with the following exceptions:
+<P>
+<I>size</I>
+
+<P>
+<BR> Size of message being sent (in bytes).
+<P>
+<I>success</I>
+
+<P>
+<BR> Not used.
+<P>
+<DT><B>socket.sendmsg.return</B>
+
+<DD>
+<P>
+Fires when the sock_sendmsg() kernel function returns.
+<P>
+<B>Context:</B>
+
+<P>
+The message sender.
+<P>
+<B>Arguments:</B>
+
+<P>
+Same as
+<B>socket.send</B>
+
+<P>
+<DT><B>socket.recvmsg</B>
+
+<DD>
+<P>
+Fires when the sock_recvmsg() kernel function is entered.
+<P>
+<B>Context:</B>
+
+<P>
+The message receiver.
+<P>
+<B>Arguments:</B>
+
+<P>
+Same as
+<B>socket.receive,</B>
+
+with the following exceptions:
+<P>
+<I>size</I>
+
+<P>
+<BR> Size of message being received (in bytes).
+<P>
+<I>success</I>
+
+<P>
+<BR> Not used.
+<P>
+<DT><B>socket.recvmsg.return</B>
+
+<DD>
+<P>
+Fires when the sock_recvmsg() kernel function returns.
+<P>
+<B>Context:</B>
+
+<P>
+The message receiver.
+<P>
+<B>Arguments:</B>
+
+<P>
+Same as
+<B>socket.receive.</B>
+
+<P>
+<P>
+<P>
+<P>
+<P>
+<P>
+<DT><B>socket.aio_write</B>
+
+<DD>
+<P>
+Fires when the sock_aio_write() kernel function is entered.
+<P>
+<B>Context:</B>
+
+<P>
+The message sender.
+<P>
+<B>Arguments:</B>
+
+<P>
+Same as
+<B>socket.send,</B>
+
+with the following exceptions:
+<P>
+<I>size</I>
+
+<P>
+<BR> Size of message being sent (in bytes).
+<P>
+<I>success</I>
+
+<P>
+<BR> Not used.
+<P>
+<DT><B>socket.aio_write.return</B>
+
+<DD>
+<P>
+Fires when the sock_aio_write() kernel function returns.
+<P>
+<B>Context:</B>
+
+<P>
+The message sender.
+<P>
+<B>Arguments:</B>
+
+<P>
+Same as
+<B>socket.send.</B>
+
+<P>
+<DT><B>socket.aio_read</B>
+
+<DD>
+<P>
+Fires when the sock_aio_read() kernel function is entered.
+<P>
+<B>Context:</B>
+
+<P>
+The message receiver.
+<P>
+<B>Arguments:</B>
+
+<P>
+Same as
+<B>socket.receive,</B>
+
+with the following exceptions:
+<P>
+<I>size</I>
+
+<P>
+<BR> Size of message being received (in bytes).
+<P>
+<I>success</I>
+
+<P>
+<BR> Not used.
+<P>
+<DT><B>socket.aio_read.return</B>
+
+<DD>
+<P>
+Fires when the sock_aio_read() kernel function returns.
+<P>
+<B>Context:</B>
+
+<P>
+The message receiver.
+<P>
+<B>Arguments:</B>
+
+<P>
+Same as
+<B>socket.receive.</B>
+
+<P>
+<DT><B>socket.writev</B>
+
+<DD>
+<P>
+Fires when the sock_writev() kernel function is entered.
+<P>
+<B>Context:</B>
+
+<P>
+The message sender.
+<P>
+<B>Arguments:</B>
+
+<P>
+Same as
+<B>socket.send,</B>
+
+with the following exceptions:
+<P>
+<I>size</I>
+
+<P>
+<BR> Size of message being sent (in bytes).
+<P>
+<I>success</I>
+
+<P>
+<BR> Not used.
+<P>
+<DT><B>socket.writev.return</B>
+
+<DD>
+<P>
+Fires when the sock_writev() kernel function returns.
+<P>
+<B>Context:</B>
+
+<P>
+The message sender.
+<P>
+<B>Arguments:</B>
+
+<P>
+Same as
+<B>socket.send.</B>
+
+<P>
+<DT><B>socket.readv</B>
+
+<DD>
+<P>
+Fires when the sock_readv() kernel function is entered.
+<P>
+<B>Context:</B>
+
+<P>
+The message receiver.
+<P>
+<B>Arguments:</B>
+
+<P>
+Same as
+<B>socket.receive,</B>
+
+with the following exceptions:
+<P>
+<I>size</I>
+
+<P>
+<BR> Size of message being received (in bytes).
+<P>
+<I>success</I>
+
+<P>
+<BR> Not used.
+<P>
+<DT><B>socket.readv.return</B>
+
+<DD>
+<P>
+Fires when the sock_readv() kernel function returns.
+<P>
+<B>Context:</B>
+
+<P>
+The message receiver.
+<P>
+<B>Arguments:</B>
+
+<P>
+Same as
+<B>socket.receive.</B>
+
+<P>
+<DT><B>socket.create</B>
+
+<DD>
+<P>
+Fires at the beginning of creating a socket.
+<P>
+<B>Context:</B>
+
+<P>
+The socket creator.
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>name</I>
+
+<BR>
+
+<I>protocol</I>
+
+<BR>
+
+<I>family</I>
+
+<BR>
+
+<I>type</I>
+
+<BR> See
+<B>socket.send.</B>
+
+<P>
+<I>requester</I>
+
+<BR> Requester type.
+<P>
+<BR> Possible values are:
+<BR> 1 - kernel
+<BR> 0 - user
+<P>
+<DT><B>socket.create.return</B>
+
+<DD>
+<P>
+Fires at the end of creating a socket.
+<P>
+<B>Context:</B>
+
+<P>
+The socket creator.
+<P>
+<B>Arguments:</B>
+
+<P>
+Same as
+<B>socket.create,</B>
+
+plus:
+<P>
+<I>err</I>
+
+<BR> Return code.
+<P>
+<BR> Possible values are:
+<BR> 0 - success
+<BR> < 0 - error
+<P>
+<I>success</I>
+
+<BR> Was the socket created successfully?
+<P>
+<BR> Possible values are:
+<BR> 1 - Yes
+<BR> 0 - No
+<DT><B>socket.close</B>
+
+<DD>
+<P>
+Fires at the beginning of closing a socket.
+<P>
+<B>Context:</B>
+
+<P>
+The socket closer.
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>name</I>
+
+<BR>
+
+<I>protocol</I>
+
+<BR>
+
+<I>family</I>
+
+<BR>
+
+<I>state</I>
+
+<BR>
+
+<I>flags</I>
+
+<BR>
+
+<I>type</I>
+
+<BR> See
+<B>socket.send.</B>
+
+<P>
+<DT><B>socket.close.return</B>
+
+<DD>
+<P>
+Fires at the end of closing a socket.
+<P>
+<B>Context:</B>
+
+<P>
+The socket closer.
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>name</I>
+
+<BR> Name of this probe.
+<P>
+</DL>
+<A NAME="lbAD"> </A>
+<H2>SEE ALSO</H2>
+
+<I><A HREF="stap.1.html">stap</A></I>(1),
+
+<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap),
+
+<I><A HREF="stapfuncs.3stap.html">stapfuncs</A></I>(3stap)
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
+<DT><A HREF="#lbAD">SEE ALSO</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of STAPPROBES.TCP</TITLE>
+</HEAD><BODY>
+<H1>STAPPROBES.TCP</H1>
+Section: Misc. Reference Manual Pages (3stap)<BR>Updated: 2009-11-17<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+stapprobes.tcp - systemtap tcp probe points
+<P>
+
+
+
+<P>
+<A NAME="lbAC"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+This family of probe points is used to probe TCP layer activities.
+It contains the following probe points:
+<P>
+
+<DL COMPACT>
+<DT><B>tcp.sendmsg</B>
+
+<DD>
+<P>
+Fires whenever sending a tcp message
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>sock</I>
+
+<BR> network socket
+<P>
+<I>size</I>
+
+<BR> number of bytes to send
+<P>
+
+<DT><B>tcp.sendmsg.return</B>
+
+<DD>
+<P>
+Fires whenever sending message is done
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>size</I>
+
+<BR> number of bytes sent
+<P>
+
+<DT><B>tcp.recvmsg</B>
+
+<DD>
+<P>
+Fires whenever a message is received
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>sock</I>
+
+<BR> network socket
+<P>
+<I>size</I>
+
+<BR> number of bytes to be received
+<P>
+
+<DT><B>tcp.recvmsg.return</B>
+
+<DD>
+<P>
+Fires whenever message receiving is done
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>size</I>
+
+<BR> number of bytes received
+<P>
+
+<DT><B>tcp.disconnect</B>
+
+<DD>
+<P>
+Fires whenever tcp is disconnected
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>sock</I>
+
+<BR> network socket
+<P>
+<I>flags</I>
+
+<BR> TCP flags (e.g. FIN, etc)
+<P>
+
+<DT><B>tcp.disconnect.return</B>
+
+<DD>
+<P>
+Fires when returning from tcp.disconnect
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>ret</I>
+
+<BR> error code (0: no error)
+<P>
+</DL>
+<A NAME="lbAD"> </A>
+<H2>SEE ALSO</H2>
+
+<I><A HREF="stap.1.html">stap</A></I>(1),
+
+<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
+
+<P>
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
+<DT><A HREF="#lbAD">SEE ALSO</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of STAPPROBES.UDP</TITLE>
+</HEAD><BODY>
+<H1>STAPPROBES.UDP</H1>
+Section: Misc. Reference Manual Pages (3stap)<BR>Updated: 2009-11-17<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+stapprobes.udp - systemtap udp probe points
+<P>
+
+
+
+<P>
+<A NAME="lbAC"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+This family of probe points is used to probe UDP layer activities.
+It contains the following probe points:
+<P>
+
+<DL COMPACT>
+<DT><B>udp.sendmsg</B>
+
+<DD>
+<P>
+Fires whenever sending a udp message
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>sock</I>
+
+<BR> network socket
+<P>
+<I>size</I>
+
+<BR> number of bytes to send
+<P>
+
+<DT><B>udp.sendmsg.return</B>
+
+<DD>
+<P>
+Fires whenever sending message is done
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>size</I>
+
+<BR> number of bytes sent
+<P>
+
+<DT><B>udp.recvmsg</B>
+
+<DD>
+<P>
+Fires whenever a message is received
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>sock</I>
+
+<BR> network socket
+<P>
+<I>size</I>
+
+<BR> number of bytes to be received
+<P>
+
+<DT><B>udp.recvmsg.return</B>
+
+<DD>
+<P>
+Fires whenever message receiving is done
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>size</I>
+
+<BR> number of bytes received
+<P>
+
+<DT><B>udp.disconnect</B>
+
+<DD>
+<P>
+Fires whenever udp is disconnected
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>sock</I>
+
+<BR> network socket
+<P>
+<I>flags</I>
+
+<BR> flags (e.g. FIN, etc)
+<P>
+
+<DT><B>udp.disconnect.return</B>
+
+<DD>
+<P>
+Fires when returning from udp.disconnect
+<P>
+<B>Arguments:</B>
+
+<P>
+<I>ret</I>
+
+<BR> error code (0: no error)
+<P>
+</DL>
+<A NAME="lbAD"> </A>
+<H2>SEE ALSO</H2>
+
+<I><A HREF="stap.1.html">stap</A></I>(1),
+
+<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
+
+<P>
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
+<DT><A HREF="#lbAD">SEE ALSO</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of STAPRUN</TITLE>
+</HEAD><BODY>
+<H1>STAPRUN</H1>
+Section: Maintenance Commands (8)<BR>Updated: 2009-11-17<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+staprun - systemtap runtime
+<P>
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<BR>
+
+<B>staprun</B>
+
+[
+<I>OPTIONS</I>
+
+]
+<I>MODULE</I>
+
+[
+<I>MODULE-OPTIONS</I>
+
+]
+<P>
+<A NAME="lbAD"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+The
+<I>staprun</I>
+
+program is the back-end of the Systemtap tool. It expects a kernel
+module produced by the front-end
+<I>stap</I>
+
+tool.
+<P>
+
+Splitting the systemtap tool into a front-end and a back-end allows a
+user to compile a systemtap script on a development machine that has
+the kernel debugging information (need to compile the script) and then
+transfer the resulting kernel module to a production machine that
+doesn't have any development tools or kernel debugging information installed.
+<P>
+
+This manual corresponds to version 1.0.
+<P>
+<A NAME="lbAE"> </A>
+<H2>OPTIONS</H2>
+
+The
+<I>staprun</I>
+
+program supports the following options. Any other option
+prints a list of supported options.
+<DL COMPACT>
+<DT><B>-v</B>
+
+<DD>
+Verbose mode.
+<DT><B>-c CMD</B>
+
+<DD>
+Command CMD will be run and the
+<I>staprun</I>
+
+program will exit when CMD
+does. The '_stp_target' variable will contain the pid for CMD.
+<DT><B>-x PID</B>
+
+<DD>
+The '_stp_target' variable will be set to PID.
+<DT><B>-o FILE</B>
+
+<DD>
+Send output to FILE. If the module uses bulk mode, the output will
+be in percpu files FILE_x(FILE_cpux in background and bulk mode)
+where 'x' is the cpu number. This supports <A HREF="strftime.3.html">strftime</A>(3) formats
+for FILE.
+<DT><B>-b BUFFER_SIZE</B>
+
+<DD>
+The systemtap module will specify a buffer size.
+Setting one here will override that value. The value should be
+an integer between 1 and 4095 which be assumed to be the
+buffer size in MB. That value will be per-cpu if bulk mode is used.
+<DT><B>-L</B>
+
+<DD>
+Load module and start probes, then detach from the module leaving the
+probes running. The module can be attached to later by using the
+<B>-A</B>
+
+option.
+<DT><B>-A</B>
+
+<DD>
+Attach to loaded systemtap module.
+<DT><B>-d</B>
+
+<DD>
+Delete a module. Only detached or unused modules
+the user has permission to access will be deleted. Use "*"
+(quoted) to delete all unused modules.
+<DT><B>-D</B>
+
+<DD>
+Run staprun in background as a daemon and show it's pid.
+<DT><B>-S</B><I> size[,N]</I>
+
+<DD>
+Sets the maximum size of output file and the maximum number of output files.
+If the size of output file will exceed
+<B>size</B>
+
+, systemtap switches output file to the next file. And if the number of
+output files exceed
+<B>N</B>
+
+, systemtap removes the oldest output file. You can omit the second argument.
+<P>
+</DL>
+<A NAME="lbAF"> </A>
+<H2>ARGUMENTS</H2>
+
+<B>MODULE</B>
+
+is either a module path or a module name. If it is a module name,
+the module will be looked for in the following directory
+(where 'VERSION' is the output of "uname -r"):
+<DL COMPACT>
+<DT><DD>
+/lib/modules/VERSION/systemtap
+</DL>
+<P>
+
+
+Any additional arguments on the command line are passed to the
+module.
+<P>
+<A NAME="lbAG"> </A>
+<H2>EXAMPLES</H2>
+
+See the
+<I><A HREF="stapex.3stap.html">stapex</A></I>(3stap)
+
+manual page for a collection of sample scripts.
+<P>
+
+Here is a very basic example of how to use
+<I>staprun.</I>
+
+First, use
+<I>stap</I>
+
+to compile a script. The
+<I>stap</I>
+
+program will report the pathname to the resulting module.
+<P>
+
+ $ stap -p4 -e [aq]probe begin { printf("Hello World!\n"); exit() }[aq]
+<BR>
+
+ /home/user/.systemtap/cache/85/stap_8553d83f78c_265.ko
+<P>
+
+Run
+<I>staprun</I>
+
+with the pathname to the module as an argument.
+<P>
+
+ $ staprun /home/user/.systemtap/cache/85/stap_8553d83f78c_265.ko
+<BR>
+
+ Hello World!
+<A NAME="lbAH"> </A>
+<H2>MODULE DETACHING AND ATTACHING</H2>
+
+After the
+<I>staprun</I>
+
+program installs a Systemtap kernel module, users can detach from the
+kernel module and reattach to it later. The
+<B>-L</B>
+
+option loads the module and automatically detaches. Users can also
+detach from the kernel module interactively by sending the SIGQUIT
+signal from the keyboard (typically by typing Ctrl-\).
+<P>
+
+To reattach to a kernel module, the
+<I>staprun</I>
+
+<B>-A</B>
+
+option would be used.
+<P>
+<A NAME="lbAI"> </A>
+<H2>FILE SWITCHING BY SIGNAL</H2>
+
+After the
+<I>staprun</I>
+
+launched the
+<I>stapio</I>
+
+, users can command it to switch output file to next file when it
+outputs to file(s) (running staprun with
+<B>-o</B>
+
+option) by sending a
+<B>SIGUSR2</B>
+
+signal to the
+<I>stapio</I>
+
+process. When it receives SIGUSR2, it will switch output file to
+new file with suffix
+<I>.N</I>
+
+where N is the sequential number.
+For example,
+<P>
+
+ $ staprun -o foo ...
+<P>
+
+outputs trace logs to
+<I>foo</I>
+
+and if it receives
+<B>SIGUSR2</B>
+
+signal, it switches output to
+<I>foo.1</I>
+
+file. And receiving
+<B>SIGUSR2</B>
+
+again, it switches to
+<I>foo.2</I>
+
+file.
+<P>
+<A NAME="lbAJ"> </A>
+<H2>SAFETY AND SECURITY</H2>
+
+Systemtap is an administrative tool. It exposes kernel internal data
+structures and potentially private user information. See the
+<I><A HREF="stap.1.html">stap</A></I>(1)
+
+manual page for additional information on safety and security.
+<P>
+
+To increase system security, only the root user and members of the
+<I>stapdev</I>
+
+group can use
+<I>staprun</I>
+
+to insert systemtap modules (or attach to existing ones).
+Members of the
+<I>stapusr</I>
+
+group can use
+<I>staprun</I>
+
+to insert or remove systemtap modules (or attach to existing systemtap modules) that
+are located in the /lib/modules/VERSION/systemtap directory.
+<A NAME="lbAK"> </A>
+<H2>FILES</H2>
+
+<DL COMPACT>
+<DT>/lib/modules/VERSION/systemtap<DD>
+If MODULE is a module name, the module will be looked for in this directory.
+Users who are only in the
+<I>'stapusr'</I>
+
+group can only install modules
+located in this directory. This directory should be owned by the root
+user and not be world writable.
+</DL>
+<A NAME="lbAL"> </A>
+<H2>SEE ALSO</H2>
+
+<I><A HREF="stap.1.html">stap</A></I>(1),
+
+<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap),
+
+<I><A HREF="stapfuncs.3stap.html">stapfuncs</A></I>(3stap),
+
+<I><A HREF="stapex.3stap.html">stapex</A></I>(3stap),
+
+<P>
+<A NAME="lbAM"> </A>
+<H2>BUGS</H2>
+
+Use the Bugzilla link off of the project web page or our mailing list.
+
+<B><A HREF="http://sources.redhat.com/systemtap/">http://sources.redhat.com/systemtap/</A></B>, <B><<A HREF="mailto:systemtap@sources.redhat.com">systemtap@sources.redhat.com</A>></B>.
+
+
+<P>
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
+<DT><A HREF="#lbAE">OPTIONS</A><DD>
+<DT><A HREF="#lbAF">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAG">EXAMPLES</A><DD>
+<DT><A HREF="#lbAH">MODULE DETACHING AND ATTACHING</A><DD>
+<DT><A HREF="#lbAI">FILE SWITCHING BY SIGNAL</A><DD>
+<DT><A HREF="#lbAJ">SAFETY AND SECURITY</A><DD>
+<DT><A HREF="#lbAK">FILES</A><DD>
+<DT><A HREF="#lbAL">SEE ALSO</A><DD>
+<DT><A HREF="#lbAM">BUGS</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:55 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of STAPVARS</TITLE>
+</HEAD><BODY>
+<H1>STAPVARS</H1>
+Section: Misc. Reference Manual Pages (3stap)<BR>Updated: 2009-11-17<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+stapvars - systemtap variables
+<P>
+<A NAME="lbAC"> </A>
+<H2>DESCRIPTION</H2>
+
+The following sections enumerate the public variables provided by
+standard tapsets installed under share/systemtap/tapset. Each
+variable is described with a type, and its behavior/restrictions.
+The syntax is the same as printed with the
+<I>stap</I> option <I>-p2</I>.
+
+Examples:
+<P>
+<DL COMPACT>
+<DT>example1:long<DD>
+Variable "example1" contains an integer.
+<P>
+<DT>example2:string [long]<DD>
+Variable "example2" is an array of strings, indexed by integers.
+<P>
+</DL>
+<A NAME="lbAD"> </A>
+<H3>ARGV</H3>
+
+<P>
+<DL COMPACT>
+<DT>argc:long<DD>
+Contains the value of the
+<B>$#</B>
+
+value: the number of command line arguments passed to the systemtap script.
+It is initialized with an implicit begin(-1) probe.
+<P>
+<DT>argv:string [long]<DD>
+Contains each command line argument as a string. argv[1] will equal @1 if
+there was at least one command line argument. Arguments beyond #32 are not
+transcribed, and produce a warning message within the begin(-1) probe that
+initializes this array.
+<P>
+</DL>
+<A NAME="lbAE"> </A>
+<H3>NULL</H3>
+
+<P>
+<DL COMPACT>
+<DT>NULL:long<DD>
+Simply defined as the number 0.
+<P>
+</DL>
+<A NAME="lbAF"> </A>
+<H2>FILES</H2>
+
+
+<I>share/systemtap/tapset</I>
+
+
+<P>
+<A NAME="lbAG"> </A>
+<H2>SEE ALSO</H2>
+
+<I><A HREF="stap.1.html">stap</A></I>(1)
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
+<DL>
+<DT><A HREF="#lbAD">ARGV</A><DD>
+<DT><A HREF="#lbAE">NULL</A><DD>
+</DL>
+<DT><A HREF="#lbAF">FILES</A><DD>
+<DT><A HREF="#lbAG">SEE ALSO</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SYMDATA</TITLE>
+</HEAD><BODY>
+<H1>SYMDATA</H1>
+Section: Context Functions (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+symdata - Return the symbol and module offset for the address.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ symdata:string(addr:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>addr</I>
+<DL COMPACT><DT><DD>
+The address to translate.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Returns the (function) symbol name associated with the given address if known, plus the module name (between brackets) and the offset inside the module, plus the size of the symbol function. If any element is not known it will be omitted and if the symbol name is unknown it will return the hex string for the given address.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of SYMNAME</TITLE>
+</HEAD><BODY>
+<H1>SYMNAME</H1>
+Section: Context Functions (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+symname - Return the symbol associated with the given address.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ symname:string(addr:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>addr</I>
+<DL COMPACT><DT><DD>
+The address to translate.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Returns the (function) symbol name associated with the given address if known. If not known it will return the hex string representation of addr.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of TARGET</TITLE>
+</HEAD><BODY>
+<H1>TARGET</H1>
+Section: Context Functions (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+target - Return the process ID of the target process.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ target:long()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of TASK_BACKTRACE</TITLE>
+</HEAD><BODY>
+<H1>TASK_BACKTRACE</H1>
+Section: Context Functions (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+task_backtrace - Hex backtrace of an arbitrary task
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ task_backtrace:string(task:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>task</I>
+<DL COMPACT><DT><DD>
+pointer to task_struct
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Return a string of hex addresses that are a backtrace of the stack of a particular task. Output may be truncated as per maximum string length.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of TASK_STIME</TITLE>
+</HEAD><BODY>
+<H1>TASK_STIME</H1>
+Section: Task Time Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+task_stime - System time of the current task.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ task_stime:long()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Returns the system time of the current task in cputime. Does not include any time used by other tasks in this process, nor does it include any time of the children of this task.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of TASK_TIME_STRING</TITLE>
+</HEAD><BODY>
+<H1>TASK_TIME_STRING</H1>
+Section: Task Time Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+task_time_string - Human readable string of task time usage.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ task_time_string:string()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Returns a human readable string showing the user and system time the current task has used up to now. For example
+lqusr: 0m12.908s, sys: 1m6.851srq.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of TASK_UTIME</TITLE>
+</HEAD><BODY>
+<H1>TASK_UTIME</H1>
+Section: Task Time Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+task_utime - User time of the current task.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ task_utime:long()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Returns the user time of the current task in cputime. Does not include any time used by other tasks in this process, nor does it include any time of the children of this task.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of TCP\&.DISCONNECT</TITLE>
+</HEAD><BODY>
+<H1>TCP\&.DISCONNECT</H1>
+Section: Networking Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+tcp.disconnect - TCP socket disconnection
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+tcp.disconnect
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>saddr</I>
+<DL COMPACT><DT><DD>
+A string representing the source IP address
+</DL>
+
+<P>
+
+<I>daddr</I>
+<DL COMPACT><DT><DD>
+A string representing the destination IP address
+</DL>
+
+<P>
+
+<I>flags</I>
+<DL COMPACT><DT><DD>
+TCP flags (e.g. FIN, etc)
+</DL>
+
+<P>
+
+<I>name</I>
+<DL COMPACT><DT><DD>
+Name of this probe
+</DL>
+
+<P>
+
+<I>sport</I>
+<DL COMPACT><DT><DD>
+TCP source port
+</DL>
+
+<P>
+
+<I>dport</I>
+<DL COMPACT><DT><DD>
+TCP destination port
+</DL>
+
+<P>
+
+<I>sock</I>
+<DL COMPACT><DT><DD>
+Network socket
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The process which disconnects tcp
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of TCP\&.DISCONNECT\&.R</TITLE>
+</HEAD><BODY>
+<H1>TCP\&.DISCONNECT\&.R</H1>
+Section: Networking Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+tcp.disconnect.return - TCP socket disconnection complete
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+tcp.disconnect.return
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>ret</I>
+<DL COMPACT><DT><DD>
+Error code (0: no error)
+</DL>
+
+<P>
+
+<I>name</I>
+<DL COMPACT><DT><DD>
+Name of this probe
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The process which disconnects tcp
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of TCP\&.RECEIVE</TITLE>
+</HEAD><BODY>
+<H1>TCP\&.RECEIVE</H1>
+Section: Networking Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+tcp.receive - Called when a TCP packet is received
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+tcp.receive
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>urg</I>
+<DL COMPACT><DT><DD>
+TCP URG flag
+</DL>
+
+<P>
+
+<I>psh</I>
+<DL COMPACT><DT><DD>
+TCP PSH flag
+</DL>
+
+<P>
+
+<I>rst</I>
+<DL COMPACT><DT><DD>
+TCP RST flag
+</DL>
+
+<P>
+
+<I>dport</I>
+<DL COMPACT><DT><DD>
+TCP destination port
+</DL>
+
+<P>
+
+<I>saddr</I>
+<DL COMPACT><DT><DD>
+A string representing the source IP address
+</DL>
+
+<P>
+
+<I>daddr</I>
+<DL COMPACT><DT><DD>
+A string representing the destination IP address
+</DL>
+
+<P>
+
+<I>ack</I>
+<DL COMPACT><DT><DD>
+TCP ACK flag
+</DL>
+
+<P>
+
+<I>syn</I>
+<DL COMPACT><DT><DD>
+TCP SYN flag
+</DL>
+
+<P>
+
+<I>fin</I>
+<DL COMPACT><DT><DD>
+TCP FIN flag
+</DL>
+
+<P>
+
+<I>sport</I>
+<DL COMPACT><DT><DD>
+TCP source port
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of TCP\&.RECVMSG</TITLE>
+</HEAD><BODY>
+<H1>TCP\&.RECVMSG</H1>
+Section: Networking Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+tcp.recvmsg - Receiving TCP message
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+tcp.recvmsg
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>saddr</I>
+<DL COMPACT><DT><DD>
+A string representing the source IP address
+</DL>
+
+<P>
+
+<I>daddr</I>
+<DL COMPACT><DT><DD>
+A string representing the destination IP address
+</DL>
+
+<P>
+
+<I>name</I>
+<DL COMPACT><DT><DD>
+Name of this probe
+</DL>
+
+<P>
+
+<I>sport</I>
+<DL COMPACT><DT><DD>
+TCP source port
+</DL>
+
+<P>
+
+<I>dport</I>
+<DL COMPACT><DT><DD>
+TCP destination port
+</DL>
+
+<P>
+
+<I>size</I>
+<DL COMPACT><DT><DD>
+Number of bytes to be received
+</DL>
+
+<P>
+
+<I>sock</I>
+<DL COMPACT><DT><DD>
+Network socket
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The process which receives a tcp message
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of TCP\&.RECVMSG\&.RETU</TITLE>
+</HEAD><BODY>
+<H1>TCP\&.RECVMSG\&.RETU</H1>
+Section: Networking Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+tcp.recvmsg.return - Receiving TCP message complete
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+tcp.recvmsg.return
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>saddr</I>
+<DL COMPACT><DT><DD>
+A string representing the source IP address
+</DL>
+
+<P>
+
+<I>daddr</I>
+<DL COMPACT><DT><DD>
+A string representing the destination IP address
+</DL>
+
+<P>
+
+<I>name</I>
+<DL COMPACT><DT><DD>
+Name of this probe
+</DL>
+
+<P>
+
+<I>sport</I>
+<DL COMPACT><DT><DD>
+TCP source port
+</DL>
+
+<P>
+
+<I>dport</I>
+<DL COMPACT><DT><DD>
+TCP destination port
+</DL>
+
+<P>
+
+<I>size</I>
+<DL COMPACT><DT><DD>
+Number of bytes received or error code if an error occurred.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The process which receives a tcp message
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of TCP\&.SENDMSG</TITLE>
+</HEAD><BODY>
+<H1>TCP\&.SENDMSG</H1>
+Section: Networking Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+tcp.sendmsg - Sending a tcp message
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+tcp.sendmsg
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>name</I>
+<DL COMPACT><DT><DD>
+Name of this probe
+</DL>
+
+<P>
+
+<I>size</I>
+<DL COMPACT><DT><DD>
+Number of bytes to send
+</DL>
+
+<P>
+
+<I>sock</I>
+<DL COMPACT><DT><DD>
+Network socket
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The process which sends a tcp message
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of TCP\&.SENDMSG\&.RETU</TITLE>
+</HEAD><BODY>
+<H1>TCP\&.SENDMSG\&.RETU</H1>
+Section: Networking Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+tcp.sendmsg.return - Sending TCP message is done
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+tcp.sendmsg.return
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>name</I>
+<DL COMPACT><DT><DD>
+Name of this probe
+</DL>
+
+<P>
+
+<I>size</I>
+<DL COMPACT><DT><DD>
+Number of bytes sent or error code if an error occurred.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The process which sends a tcp message
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of TCP\&.SETSOCKOPT</TITLE>
+</HEAD><BODY>
+<H1>TCP\&.SETSOCKOPT</H1>
+Section: Networking Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+tcp.setsockopt - Call to <B>setsockopt</B>
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+tcp.setsockopt
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>optstr</I>
+<DL COMPACT><DT><DD>
+Resolves optname to a human-readable format
+</DL>
+
+<P>
+
+<I>level</I>
+<DL COMPACT><DT><DD>
+The level at which the socket options will be manipulated
+</DL>
+
+<P>
+
+<I>optlen</I>
+<DL COMPACT><DT><DD>
+Used to access values for
+<B>setsockopt</B>
+</DL>
+
+<P>
+
+<I>name</I>
+<DL COMPACT><DT><DD>
+Name of this probe
+</DL>
+
+<P>
+
+<I>optname</I>
+<DL COMPACT><DT><DD>
+TCP socket options (e.g. TCP_NODELAY, TCP_MAXSEG, etc)
+</DL>
+
+<P>
+
+<I>sock</I>
+<DL COMPACT><DT><DD>
+Network socket
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The process which calls setsockopt
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of TCP\&.SETSOCKOPT\&.R</TITLE>
+</HEAD><BODY>
+<H1>TCP\&.SETSOCKOPT\&.R</H1>
+Section: Networking Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+tcp.setsockopt.return - Return from <B>setsockopt</B>
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+tcp.setsockopt.return
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>ret</I>
+<DL COMPACT><DT><DD>
+Error code (0: no error)
+</DL>
+
+<P>
+
+<I>name</I>
+<DL COMPACT><DT><DD>
+Name of this probe
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The process which calls setsockopt
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of TID</TITLE>
+</HEAD><BODY>
+<H1>TID</H1>
+Section: Context Functions (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+tid - Returns the thread ID of a target process.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ tid:long()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of TTY\&.INIT</TITLE>
+</HEAD><BODY>
+<H1>TTY\&.INIT</H1>
+Section: TTY Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+tty.init - Called when a tty is being initalized
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+tty.init
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>driver_name</I>
+<DL COMPACT><DT><DD>
+the driver name
+</DL>
+
+<P>
+
+<I>name</I>
+<DL COMPACT><DT><DD>
+the driver .dev_name name
+</DL>
+
+<P>
+
+<I>module</I>
+<DL COMPACT><DT><DD>
+the module name
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of TTY\&.IOCTL</TITLE>
+</HEAD><BODY>
+<H1>TTY\&.IOCTL</H1>
+Section: TTY Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+tty.ioctl - called when a ioctl is request to the tty
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+tty.ioctl
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>cmd</I>
+<DL COMPACT><DT><DD>
+the ioctl command
+</DL>
+
+<P>
+
+<I>arg</I>
+<DL COMPACT><DT><DD>
+the ioctl argument
+</DL>
+
+<P>
+
+<I>name</I>
+<DL COMPACT><DT><DD>
+the file name
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of TTY\&.OPEN</TITLE>
+</HEAD><BODY>
+<H1>TTY\&.OPEN</H1>
+Section: TTY Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+tty.open - Called when a tty is opened
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+tty.open
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>inode_state</I>
+<DL COMPACT><DT><DD>
+the inode state
+</DL>
+
+<P>
+
+<I>file_name</I>
+<DL COMPACT><DT><DD>
+the file name
+</DL>
+
+<P>
+
+<I>file_mode</I>
+<DL COMPACT><DT><DD>
+the file mode
+</DL>
+
+<P>
+
+<I>file_flags</I>
+<DL COMPACT><DT><DD>
+the file flags
+</DL>
+
+<P>
+
+<I>inode_number</I>
+<DL COMPACT><DT><DD>
+the inode number
+</DL>
+
+<P>
+
+<I>inode_flags</I>
+<DL COMPACT><DT><DD>
+the inode flags
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of TTY\&.POLL</TITLE>
+</HEAD><BODY>
+<H1>TTY\&.POLL</H1>
+Section: TTY Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+tty.poll - Called when a tty device is being polled
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+tty.poll
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>file_name</I>
+<DL COMPACT><DT><DD>
+the tty file name
+</DL>
+
+<P>
+
+<I>wait_key</I>
+<DL COMPACT><DT><DD>
+the wait queue key
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of TTY\&.READ</TITLE>
+</HEAD><BODY>
+<H1>TTY\&.READ</H1>
+Section: TTY Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+tty.read - called when a tty line will be read
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+tty.read
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>driver_name</I>
+<DL COMPACT><DT><DD>
+the driver name
+</DL>
+
+<P>
+
+<I>buffer</I>
+<DL COMPACT><DT><DD>
+the buffer that will receive the characters
+</DL>
+
+<P>
+
+<I>file_name</I>
+<DL COMPACT><DT><DD>
+the file name lreated to the tty
+</DL>
+
+<P>
+
+<I>nr</I>
+<DL COMPACT><DT><DD>
+The amount of characters to be read
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of TTY\&.RECEIVE</TITLE>
+</HEAD><BODY>
+<H1>TTY\&.RECEIVE</H1>
+Section: TTY Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+tty.receive - called when a tty receives a message
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+tty.receive
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>driver_name</I>
+<DL COMPACT><DT><DD>
+the driver name
+</DL>
+
+<P>
+
+<I>count</I>
+<DL COMPACT><DT><DD>
+The amount of characters received
+</DL>
+
+<P>
+
+<I>name</I>
+<DL COMPACT><DT><DD>
+the name of the module file
+</DL>
+
+<P>
+
+<I>fp</I>
+<DL COMPACT><DT><DD>
+The flag buffer
+</DL>
+
+<P>
+
+<I>cp</I>
+<DL COMPACT><DT><DD>
+the buffer that was received
+</DL>
+
+<P>
+
+<I>index</I>
+<DL COMPACT><DT><DD>
+The tty Index
+</DL>
+
+<P>
+
+<I>id</I>
+<DL COMPACT><DT><DD>
+the tty id
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of TTY\&.REGISTER</TITLE>
+</HEAD><BODY>
+<H1>TTY\&.REGISTER</H1>
+Section: TTY Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+tty.register - Called when a tty device is registred
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+tty.register
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>driver_name</I>
+<DL COMPACT><DT><DD>
+the driver name
+</DL>
+
+<P>
+
+<I>name</I>
+<DL COMPACT><DT><DD>
+the driver .dev_name name
+</DL>
+
+<P>
+
+<I>index</I>
+<DL COMPACT><DT><DD>
+the tty index requested
+</DL>
+
+<P>
+
+<I>module</I>
+<DL COMPACT><DT><DD>
+the module name
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of TTY\&.RELEASE</TITLE>
+</HEAD><BODY>
+<H1>TTY\&.RELEASE</H1>
+Section: TTY Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+tty.release - Called when the tty is closed
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+tty.release
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>inode_state</I>
+<DL COMPACT><DT><DD>
+the inode state
+</DL>
+
+<P>
+
+<I>file_name</I>
+<DL COMPACT><DT><DD>
+the file name
+</DL>
+
+<P>
+
+<I>file_mode</I>
+<DL COMPACT><DT><DD>
+the file mode
+</DL>
+
+<P>
+
+<I>file_flags</I>
+<DL COMPACT><DT><DD>
+the file flags
+</DL>
+
+<P>
+
+<I>inode_number</I>
+<DL COMPACT><DT><DD>
+the inode number
+</DL>
+
+<P>
+
+<I>inode_flags</I>
+<DL COMPACT><DT><DD>
+the inode flags
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of TTY\&.RESIZE</TITLE>
+</HEAD><BODY>
+<H1>TTY\&.RESIZE</H1>
+Section: TTY Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+tty.resize - Called when a terminal resize happens
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+tty.resize
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>new_ypixel</I>
+<DL COMPACT><DT><DD>
+the new ypixel value
+</DL>
+
+<P>
+
+<I>old_col</I>
+<DL COMPACT><DT><DD>
+the old col value
+</DL>
+
+<P>
+
+<I>old_xpixel</I>
+<DL COMPACT><DT><DD>
+the old xpixel
+</DL>
+
+<P>
+
+<I>old_ypixel</I>
+<DL COMPACT><DT><DD>
+the old ypixel
+</DL>
+
+<P>
+
+<I>name</I>
+<DL COMPACT><DT><DD>
+the tty name
+</DL>
+
+<P>
+
+<I>old_row</I>
+<DL COMPACT><DT><DD>
+the old row value
+</DL>
+
+<P>
+
+<I>new_row</I>
+<DL COMPACT><DT><DD>
+the new row value
+</DL>
+
+<P>
+
+<I>new_xpixel</I>
+<DL COMPACT><DT><DD>
+the new xpixel value
+</DL>
+
+<P>
+
+<I>new_col</I>
+<DL COMPACT><DT><DD>
+the new col value
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of TTY\&.UNREGISTER</TITLE>
+</HEAD><BODY>
+<H1>TTY\&.UNREGISTER</H1>
+Section: TTY Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+tty.unregister - Called when a tty device is being unregistered
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+tty.unregister
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>driver_name</I>
+<DL COMPACT><DT><DD>
+the driver name
+</DL>
+
+<P>
+
+<I>name</I>
+<DL COMPACT><DT><DD>
+the driver .dev_name name
+</DL>
+
+<P>
+
+<I>index</I>
+<DL COMPACT><DT><DD>
+the tty index requested
+</DL>
+
+<P>
+
+<I>module</I>
+<DL COMPACT><DT><DD>
+the module name
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of TTY\&.WRITE</TITLE>
+</HEAD><BODY>
+<H1>TTY\&.WRITE</H1>
+Section: TTY Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+tty.write - write to the tty line
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+tty.write
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>driver_name</I>
+<DL COMPACT><DT><DD>
+the driver name
+</DL>
+
+<P>
+
+<I>buffer</I>
+<DL COMPACT><DT><DD>
+the buffer that will be written
+</DL>
+
+<P>
+
+<I>file_name</I>
+<DL COMPACT><DT><DD>
+the file name lreated to the tty
+</DL>
+
+<P>
+
+<I>nr</I>
+<DL COMPACT><DT><DD>
+The amount of characters
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of UADDR</TITLE>
+</HEAD><BODY>
+<H1>UADDR</H1>
+Section: Context Functions (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+uaddr - User space address of current running task. EXPERIMENTAL.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ uaddr:long()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Returns the address in userspace that the current task was at when the probe occurred. When the current running task isn't a user space thread, or the address cannot be found, zero is returned. Can be used to see where the current task is combined with
+<B>usymname</B>
+or
+<B>symdata</B>. Often the task will be in the VDSO where it entered the kernel. FIXME - need VDSO tracking support #10080.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of UBACKTRACE</TITLE>
+</HEAD><BODY>
+<H1>UBACKTRACE</H1>
+Section: Context Functions (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+ubacktrace - Hex backtrace of current task stack. EXPERIMENTAL!
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ ubacktrace:string()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+<P>
+
+Return a string of hex addresses that are a backtrace of the stack of the current task. Output may be truncated as per maximum string length. Returns empty string when current probe point cannot determine user backtrace.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of UDP\&.DISCONNECT</TITLE>
+</HEAD><BODY>
+<H1>UDP\&.DISCONNECT</H1>
+Section: Networking Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+udp.disconnect - Fires when a process requests for a UDP disconnection
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+udp.disconnect
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>flags</I>
+<DL COMPACT><DT><DD>
+Flags (e.g. FIN, etc)
+</DL>
+
+<P>
+
+<I>name</I>
+<DL COMPACT><DT><DD>
+The name of this probe
+</DL>
+
+<P>
+
+<I>sock</I>
+<DL COMPACT><DT><DD>
+Network socket used by the process
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The process which requests a UDP disconnection
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of UDP\&.DISCONNECT\&.R</TITLE>
+</HEAD><BODY>
+<H1>UDP\&.DISCONNECT\&.R</H1>
+Section: Networking Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+udp.disconnect.return - UDP has been disconnected successfully
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+udp.disconnect.return
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>ret</I>
+<DL COMPACT><DT><DD>
+Error code (0: no error)
+</DL>
+
+<P>
+
+<I>name</I>
+<DL COMPACT><DT><DD>
+The name of this probe
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The process which requested a UDP disconnection
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of UDP\&.RECVMSG</TITLE>
+</HEAD><BODY>
+<H1>UDP\&.RECVMSG</H1>
+Section: Networking Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+udp.recvmsg - Fires whenever a UDP message is received
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+udp.recvmsg
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>name</I>
+<DL COMPACT><DT><DD>
+The name of this probe
+</DL>
+
+<P>
+
+<I>size</I>
+<DL COMPACT><DT><DD>
+Number of bytes received by the process
+</DL>
+
+<P>
+
+<I>sock</I>
+<DL COMPACT><DT><DD>
+Network socket used by the process
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The process which received a UDP message
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of UDP\&.RECVMSG\&.RETU</TITLE>
+</HEAD><BODY>
+<H1>UDP\&.RECVMSG\&.RETU</H1>
+Section: Networking Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+udp.recvmsg.return - Fires whenever an attempt to receive a UDP message received is completed
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+udp.recvmsg.return
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>name</I>
+<DL COMPACT><DT><DD>
+The name of this probe
+</DL>
+
+<P>
+
+<I>size</I>
+<DL COMPACT><DT><DD>
+Number of bytes received by the process
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The process which received a UDP message
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of UDP\&.SENDMSG</TITLE>
+</HEAD><BODY>
+<H1>UDP\&.SENDMSG</H1>
+Section: Networking Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+udp.sendmsg - Fires whenever a process sends a UDP message
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+udp.sendmsg
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>name</I>
+<DL COMPACT><DT><DD>
+The name of this probe
+</DL>
+
+<P>
+
+<I>size</I>
+<DL COMPACT><DT><DD>
+Number of bytes sent by the process
+</DL>
+
+<P>
+
+<I>sock</I>
+<DL COMPACT><DT><DD>
+Network socket used by the process
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The process which sent a UDP message
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of UDP\&.SENDMSG\&.RETU</TITLE>
+</HEAD><BODY>
+<H1>UDP\&.SENDMSG\&.RETU</H1>
+Section: Networking Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+udp.sendmsg.return - Fires whenever an attempt to send a UDP message is completed
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+udp.sendmsg.return
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>name</I>
+<DL COMPACT><DT><DD>
+The name of this probe
+</DL>
+
+<P>
+
+<I>size</I>
+<DL COMPACT><DT><DD>
+Number of bytes sent by the process
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The process which sent a UDP message
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of UID</TITLE>
+</HEAD><BODY>
+<H1>UID</H1>
+Section: Context Functions (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+uid - Returns the user ID of a target process.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ uid:long()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of USER_CHAR</TITLE>
+</HEAD><BODY>
+<H1>USER_CHAR</H1>
+Section: String and data retrieving fun (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+user_char - Retrieves a char value stored in user space.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ user_char:long(addr:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>addr</I>
+<DL COMPACT><DT><DD>
+The user space address to retrieve the char from.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Returns the char value from a given user space address. Returns zero when user space data is not accessible.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of USER_CHAR_WARN</TITLE>
+</HEAD><BODY>
+<H1>USER_CHAR_WARN</H1>
+Section: String and data retrieving fun (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+user_char_warn - Retrieves a char value stored in user space.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ user_char_warn:long(addr:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>addr</I>
+<DL COMPACT><DT><DD>
+The user space address to retrieve the char from.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Returns the char value from a given user space address. Returns zero when user space and warns (but does not abort) about the failure.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of USER_INT</TITLE>
+</HEAD><BODY>
+<H1>USER_INT</H1>
+Section: String and data retrieving fun (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+user_int - Retrieves an int value stored in user space.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ user_int:long(addr:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>addr</I>
+<DL COMPACT><DT><DD>
+The user space address to retrieve the int from.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Returns the int value from a given user space address. Returns zero when user space data is not accessible.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of USER_INT_WARN</TITLE>
+</HEAD><BODY>
+<H1>USER_INT_WARN</H1>
+Section: String and data retrieving fun (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+user_int_warn - Retrieves an int value stored in user space.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ user_int_warn:long(addr:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>addr</I>
+<DL COMPACT><DT><DD>
+The user space address to retrieve the int from.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Returns the int value from a given user space address. Returns zero when user space and warns (but does not abort) about the failure.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of USER_LONG</TITLE>
+</HEAD><BODY>
+<H1>USER_LONG</H1>
+Section: String and data retrieving fun (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+user_long - Retrieves a long value stored in user space.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ user_long:long(addr:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>addr</I>
+<DL COMPACT><DT><DD>
+The user space address to retrieve the long from.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Returns the long value from a given user space address. Returns zero when user space data is not accessible.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of USER_LONG_WARN</TITLE>
+</HEAD><BODY>
+<H1>USER_LONG_WARN</H1>
+Section: String and data retrieving fun (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+user_long_warn - Retrieves a long value stored in user space.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ user_long_warn:long(addr:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>addr</I>
+<DL COMPACT><DT><DD>
+The user space address to retrieve the long from.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Returns the long value from a given user space address. Returns zero when user space and warns (but does not abort) about the failure.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of USER_MODE</TITLE>
+</HEAD><BODY>
+<H1>USER_MODE</H1>
+Section: Context Functions (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+user_mode - Determines if probe point occurs in user-mode.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ user_mode:long()
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+None
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+<P>
+
+Return 1 if the probe point occurred in user-mode.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of USER_SHORT</TITLE>
+</HEAD><BODY>
+<H1>USER_SHORT</H1>
+Section: String and data retrieving fun (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+user_short - Retrieves a short value stored in user space.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ user_short:long(addr:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>addr</I>
+<DL COMPACT><DT><DD>
+The user space address to retrieve the short from.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Returns the short value from a given user space address. Returns zero when user space data is not accessible.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of USER_SHORT_WARN</TITLE>
+</HEAD><BODY>
+<H1>USER_SHORT_WARN</H1>
+Section: String and data retrieving fun (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+user_short_warn - Retrieves a short value stored in user space.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ user_short_warn:long(addr:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>addr</I>
+<DL COMPACT><DT><DD>
+The user space address to retrieve the short from.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Returns the short value from a given user space address. Returns zero when user space and warns (but does not abort) about the failure.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of USER_STRING</TITLE>
+</HEAD><BODY>
+<H1>USER_STRING</H1>
+Section: String and data retrieving fun (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+user_string - Retrieves string from user space.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ user_string:string(addr:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>addr</I>
+<DL COMPACT><DT><DD>
+The user space address to retrieve the string from.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Returns the null terminated C string from a given user space memory address. Reports
+lq<unknown>rq
+on the rare cases when userspace data is not accessible.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of USER_STRING2</TITLE>
+</HEAD><BODY>
+<H1>USER_STRING2</H1>
+Section: String and data retrieving fun (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+user_string2 - Retrieves string from user space with alternative error string..
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ user_string2:string(addr:long,err_msg:string)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>addr</I>
+<DL COMPACT><DT><DD>
+The user space address to retrieve the string from.
+</DL>
+
+<P>
+
+<I>err_msg</I>
+<DL COMPACT><DT><DD>
+The error message to return when data isn't available.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Returns the null terminated C string from a given user space memory address. Reports the given error message on the rare cases when userspace data is not accessible.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of USER_STRING_N</TITLE>
+</HEAD><BODY>
+<H1>USER_STRING_N</H1>
+Section: String and data retrieving fun (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+user_string_n - Retrieves string of given length from user space.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ user_string_n:string(addr:long,n:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>addr</I>
+<DL COMPACT><DT><DD>
+The user space address to retrieve the string from.
+</DL>
+
+<P>
+
+<I>n</I>
+<DL COMPACT><DT><DD>
+The maximum length of the string (if not null terminated).
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Returns the C string of a maximum given length from a given user space address. Returns
+lq<unknown>rq
+on the rare cases when userspace data is not accessible at the given address.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of USER_STRING_N2</TITLE>
+</HEAD><BODY>
+<H1>USER_STRING_N2</H1>
+Section: String and data retrieving fun (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+user_string_n2 - Retrieves string of given length from user space.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ user_string_n2:string(addr:long,n:long,err_msg:string)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>addr</I>
+<DL COMPACT><DT><DD>
+The user space address to retrieve the string from.
+</DL>
+
+<P>
+
+<I>n</I>
+<DL COMPACT><DT><DD>
+The maximum length of the string (if not null terminated).
+</DL>
+
+<P>
+
+<I>err_msg</I>
+<DL COMPACT><DT><DD>
+The error message to return when data isn't available.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Returns the C string of a maximum given length from a given user space address. Returns the given error message string on the rare cases when userspace data is not accessible at the given address.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of USER_STRING_N_QUOTED</TITLE>
+</HEAD><BODY>
+<H1>USER_STRING_N_QUOTED</H1>
+Section: String and data retrieving fun (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+user_string_n_quoted - Retrieves and quotes string from user space.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ user_string_n_quoted:string(addr:long,n:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>addr</I>
+<DL COMPACT><DT><DD>
+The user space address to retrieve the string from.
+</DL>
+
+<P>
+
+<I>n</I>
+<DL COMPACT><DT><DD>
+The maximum length of the string (if not null terminated).
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Returns up to n characters of a C string from the given user space memory address where any ASCII characters that are not printable are replaced by the corresponding escape sequence in the returned string. Reports
+lqNULLrq
+for address zero. Returns
+lq<unknown>rq
+on the rare cases when userspace data is not accessible at the given address.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:54 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of USER_STRING_N_WARN</TITLE>
+</HEAD><BODY>
+<H1>USER_STRING_N_WARN</H1>
+Section: String and data retrieving fun (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+user_string_n_warn - Retrieves string from user space.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ user_string_n_warn:string(addr:long,n:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>addr</I>
+<DL COMPACT><DT><DD>
+The user space address to retrieve the string from.
+</DL>
+
+<P>
+
+<I>n</I>
+<DL COMPACT><DT><DD>
+The maximum length of the string (if not null terminated).
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Returns up to n characters of a C string from a given user space memory address. Reports
+lq<unknown>rq
+on the rare cases when userspace data is not accessible and warns (but does not abort) about the failure.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:55 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of USER_STRING_QUOTED</TITLE>
+</HEAD><BODY>
+<H1>USER_STRING_QUOTED</H1>
+Section: String and data retrieving fun (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+user_string_quoted - Retrieves and quotes string from user space.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ user_string_quoted:string(addr:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>addr</I>
+<DL COMPACT><DT><DD>
+The user space address to retrieve the string from.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Returns the null terminated C string from a given user space memory address where any ASCII characters that are not printable are replaced by the corresponding escape sequence in the returned string. Reports
+lqNULLrq
+for address zero. Returns
+lq<unknown>rq
+on the rare cases when userspace data is not accessible at the given address.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:55 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of USER_STRING_WARN</TITLE>
+</HEAD><BODY>
+<H1>USER_STRING_WARN</H1>
+Section: String and data retrieving fun (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+user_string_warn - Retrieves string from user space.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ user_string_warn:string(addr:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>addr</I>
+<DL COMPACT><DT><DD>
+The user space address to retrieve the string from.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Returns the null terminated C string from a given user space memory address. Reports
+lq<unknown>rq
+on the rare cases when userspace data is not accessible and warns (but does not abort) about the failure.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:55 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of USYMDATA</TITLE>
+</HEAD><BODY>
+<H1>USYMDATA</H1>
+Section: Context Functions (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+usymdata - Return the symbol and module offset of an address. EXPERIMENTAL!
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ usymdata:string(addr:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>addr</I>
+<DL COMPACT><DT><DD>
+The address to translate.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Returns the (function) symbol name associated with the given address in the current task if known, plus the module name (between brackets) and the offset inside the module (shared library), plus the size of the symbol function. If any element is not known it will be omitted and if the symbol name is unknown it will return the hex string for the given address.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:55 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of USYMNAME</TITLE>
+</HEAD><BODY>
+<H1>USYMNAME</H1>
+Section: Context Functions (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+usymname - Return the symbol of an address in the current task. EXPERIMENTAL!
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ usymname:string(addr:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>addr</I>
+<DL COMPACT><DT><DD>
+The address to translate.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Returns the (function) symbol name associated with the given address if known. If not known it will return the hex string representation of addr.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:55 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of VM\&.BRK</TITLE>
+</HEAD><BODY>
+<H1>VM\&.BRK</H1>
+Section: Memory Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+vm.brk - Fires when a brk is requested (i.e. the heap will be resized).
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+vm.brk
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>length</I>
+<DL COMPACT><DT><DD>
+The length of the memory segment
+</DL>
+
+<P>
+
+<I>address</I>
+<DL COMPACT><DT><DD>
+The requested address
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The process calling brk.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:55 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of VM\&.MMAP</TITLE>
+</HEAD><BODY>
+<H1>VM\&.MMAP</H1>
+Section: Memory Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+vm.mmap - Fires when an mmap is requested.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+vm.mmap
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>length</I>
+<DL COMPACT><DT><DD>
+The length of the memory segment
+</DL>
+
+<P>
+
+<I>address</I>
+<DL COMPACT><DT><DD>
+The requested address
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The process calling mmap.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:55 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of VM\&.MUNMAP</TITLE>
+</HEAD><BODY>
+<H1>VM\&.MUNMAP</H1>
+Section: Memory Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+vm.munmap - Fires when an munmap is requested.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+vm.munmap
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>length</I>
+<DL COMPACT><DT><DD>
+The length of the memory segment
+</DL>
+
+<P>
+
+<I>address</I>
+<DL COMPACT><DT><DD>
+The requested address
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The process calling munmap.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:55 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of VM\&.OOM_KILL</TITLE>
+</HEAD><BODY>
+<H1>VM\&.OOM_KILL</H1>
+Section: Memory Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+vm.oom_kill - Fires when a thread is selected for termination by the OOM killer.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+vm.oom_kill
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>task</I>
+<DL COMPACT><DT><DD>
+The task being killed
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The process that tried to consume excessive memory, and thus triggered the OOM.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:55 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of VM\&.PAGEFAULT</TITLE>
+</HEAD><BODY>
+<H1>VM\&.PAGEFAULT</H1>
+Section: Memory Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+vm.pagefault - Records that a page fault occurred.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+vm.pagefault
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>write_access</I>
+<DL COMPACT><DT><DD>
+Indicates whether this was a write or read access; 1 indicates a write, while 0 indicates a read.
+</DL>
+
+<P>
+
+<I>address</I>
+<DL COMPACT><DT><DD>
+The address of the faulting memory access; i.e. the address that caused the page fault.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The process which triggered the fault
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:55 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of VM\&.PAGEFAULT\&.RET</TITLE>
+</HEAD><BODY>
+<H1>VM\&.PAGEFAULT\&.RET</H1>
+Section: Memory Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+vm.pagefault.return - Indicates what type of fault occurred.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+vm.pagefault.return
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>fault_type</I>
+<DL COMPACT><DT><DD>
+Returns either 0 (VM_FAULT_OOM) for out of memory faults, 2 (VM_FAULT_MINOR) for minor faults, 3 (VM_FAULT_MAJOR) for major faults, or 1 (VM_FAULT_SIGBUS) if the fault was neither OOM, minor fault, nor major fault.
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:55 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of VM\&.WRITE_SHARED</TITLE>
+</HEAD><BODY>
+<H1>VM\&.WRITE_SHARED</H1>
+Section: Memory Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+vm.write_shared - Attempts at writing to a shared page.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+vm.write_shared
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>address</I>
+<DL COMPACT><DT><DD>
+The address of the shared write.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The context is the process attempting the write.
+<A NAME="lbAF"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Fires when a process attempts to write to a shared page. If a copy is necessary, this will be followed by a vm.write_shared_copy.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:55 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of VM\&.WRITE_SHARED_CO</TITLE>
+</HEAD><BODY>
+<H1>VM\&.WRITE_SHARED_CO</H1>
+Section: Memory Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+vm.write_shared_copy - Page copy for shared page write.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+vm.write_shared_copy
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>VALUES</H2>
+
+<P>
+
+<I>zero</I>
+<DL COMPACT><DT><DD>
+Boolean indicating whether it is a zero page (can do a clear instead of a copy).
+</DL>
+
+<P>
+
+<I>address</I>
+<DL COMPACT><DT><DD>
+The address of the shared write.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>CONTEXT</H2>
+
+<P>
+
+The process attempting the write.
+<A NAME="lbAF"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+Fires when a write to a shared page requires a page copy. This is always preceded by a vm.shared_write.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">VALUES</A><DD>
+<DT><A HREF="#lbAE">CONTEXT</A><DD>
+<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:55 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of VM_FAULT_CONTAINS</TITLE>
+</HEAD><BODY>
+<H1>VM_FAULT_CONTAINS</H1>
+Section: Memory Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+vm_fault_contains - Test return value for page fault reason
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ vm_fault_contains:long(value:long,test:long)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>value</I>
+<DL COMPACT><DT><DD>
+The fault_type returned by vm.page_fault.return
+</DL>
+
+<P>
+
+<I>test</I>
+<DL COMPACT><DT><DD>
+The type of fault to test for (VM_FAULT_OOM or similar)
+</DL>
+
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:55 GMT, November 19, 2009
+</BODY>
+</HTML>
--- /dev/null
+
+<HTML><HEAD><TITLE>Manpage of WARN</TITLE>
+</HEAD><BODY>
+<H1>WARN</H1>
+Section: Logging Tapset (3stap)<BR>Updated: November 2009<BR><A HREF="#index">Index</A>
+<A HREF="index.html">Return to Main Contents</A><HR>
+
+
+
+
+
+
+
+
+
+
+
+<A NAME="lbAB"> </A>
+<H2>NAME</H2>
+
+warn - Send a line to the warning stream.
+<A NAME="lbAC"> </A>
+<H2>SYNOPSIS</H2>
+
+<P>
+<PRE>
+ warn(msg:string)
+</PRE>
+
+<A NAME="lbAD"> </A>
+<H2>ARGUMENTS</H2>
+
+<P>
+
+<I>msg</I>
+<DL COMPACT><DT><DD>
+The formatted message string.
+</DL>
+
+<A NAME="lbAE"> </A>
+<H2>DESCRIPTION</H2>
+
+<P>
+
+An implicit end-of-line is added. staprun prepends the string
+lqWARNING:rq.
+<P>
+
+<HR>
+<A NAME="index"> </A><H2>Index</H2>
+<DL>
+<DT><A HREF="#lbAB">NAME</A><DD>
+<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
+<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
+<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
+</DL>
+<HR>
+This document was created by
+<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
+using the manual pages.<BR>
+Time: 00:23:55 GMT, November 19, 2009
+</BODY>
+</HTML>
git://sourceware.org / systemtap-htdocs.git / commitdiff