diff options
| author | hunt <hunt> | 2005-05-26 07:18:22 +0000 |
|---|---|---|
| committer | hunt <hunt> | 2005-05-26 07:18:22 +0000 |
| commit | 849e99602e4b0487dad23e28cb6a94bf013f40a4 (patch) | |
| tree | b457af2da7d7d8b2cc8df0430e3bf54f3ab07cfa /runtime/docs | |
| parent | 45f880289dcfc06494885546750b42f4e59074a6 (diff) | |
| download | systemtap-steved-849e99602e4b0487dad23e28cb6a94bf013f40a4.tar.gz systemtap-steved-849e99602e4b0487dad23e28cb6a94bf013f40a4.tar.xz systemtap-steved-849e99602e4b0487dad23e28cb6a94bf013f40a4.zip | |
Remove all the generated html files.
Diffstat (limited to 'runtime/docs')
67 files changed, 0 insertions, 8911 deletions
diff --git a/runtime/docs/html/README-source.html b/runtime/docs/html/README-source.html deleted file mode 100644 index 1421d7e2..00000000 --- a/runtime/docs/html/README-source.html +++ /dev/null @@ -1,119 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: README Source File</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1>README</h1><div class="fragment"><pre class="fragment">00001 <span class="comment">/** @mainpage SystemTap Runtime</span> -00002 <span class="comment"></span> -00003 <span class="comment">@section intro_sec Introduction</span> -00004 <span class="comment"></span> -00005 <span class="comment">This document describes the implementation of the SystemTap Runtime. It is intended for developers</span> -00006 <span class="comment">of the SystemTap Language translator or, possibly TapSet authors. These functions are not directly</span> -00007 <span class="comment">available from the SystemTap Language.</span> -00008 <span class="comment"></span> -00009 <span class="comment">The SystemTap Runtime Library consists of all functions</span> -00010 <span class="comment">and code fragments needed by the compiler/translator to</span> -00011 <span class="comment">include in building a kernel module using kprobes. It</span> -00012 <span class="comment">also include I/O code to transmit its output from the kernel to userspace.</span> -00013 <span class="comment"> </span> -00014 <span class="comment">In addition to the library, the runtime includes a SystemTap user-space daemon</span> -00015 <span class="comment">(stpd). Stpd grabs data sent from the I/O code in the runtime and displays it</span> -00016 <span class="comment">and/or saves it to files. Stpd (or a script invoking it) will handle other issues like</span> -00017 <span class="comment">inserting and removing modules.</span> -00018 <span class="comment"></span> -00019 <span class="comment">Stpd and the I/O code make use of both relayfs and netlink for communication. For</span> -00020 <span class="comment">kernels without relayfs builtin, it is provided as a standalone module under the runtime directory.</span> -00021 <span class="comment"></span> -00022 <span class="comment">@section design_sec Design</span> -00023 <span class="comment">@subsection impl_sec Implementation</span> -00024 <span class="comment">The library is written in C and is really not a library but a collection of code</span> -00025 <span class="comment">That can be conditionally included in a modules. It may become a library later, but for now</span> -00026 <span class="comment">there are some advantages to being able to change the sizes of static items with simple #defines.</span> -00027 <span class="comment"></span> -00028 <span class="comment">@subsection map_sec Maps (Associative Arrays)</span> -00029 <span class="comment">Maps are implemented as hash lists. It is not expected that users will</span> -00030 <span class="comment">attempt to collect so much data in kernel space that performance problems will require</span> -00031 <span class="comment">more complex solutions such as AVL trees.</span> -00032 <span class="comment"></span> -00033 <span class="comment">Maps are created with _stp_map_new(). Each map can hold only one type of </span> -00034 <span class="comment">data; int64, string, or statistics. Each element belonging to a map can have up to 2 keys</span> -00035 <span class="comment">and a value. Implemented key types are strings and longs.</span> -00036 <span class="comment"> </span> -00037 <span class="comment">To simplify the implementation, the functions to set the key and the functions to set the data are separated.</span> -00038 <span class="comment">That means we need only 4 functions to set the key and 3 functions to set the value. </span> -00039 <span class="comment"></span> -00040 <span class="comment">For example:</span> -00041 <span class="comment">\code</span> -00042 <span class="comment">/* create a map with a max of 100 elements */</span> -00043 <a class="code" href="group__maps.html#ga1">MAP</a> mymap = map_new(100, INT64); -00044 -00045 <span class="comment">/* mymap[birth year] = 2000 */</span> -00046 map_key_str (mymap, <span class="stringliteral">"birth year"</span>); -00047 map_set_int64 (mymap, 2000); -00048 \endcode -00049 -00050 All elements have a <span class="keywordflow">default</span> value of 0 (or NULL). Elements are only saved to the map when their value is set -00051 to something nonzero. This means that querying <span class="keywordflow">for</span> the existance of a key is inexpensive because -00052 no element is created, just a hash table lookup. -00053 -00054 @subsection list_sec Lists -00055 A list is a special map which has internally ascending <span class="keywordtype">long</span> integer keys. Adding a value to -00056 a list does not require setting a key first. Create a list with <a class="code" href="group__lists.html#ga0">_stp_list_new</a>(). Add to it -00057 with <a class="code" href="group__lists.html#ga2">_stp_list_add_str</a>() and _stp_list_add_int64(). Clear it with _stp_list_clear(). -00058 -00059 @subsection string_sec Strings -00060 One of the biggest restrictions the library has is that it cannot allocate things like strings off the stack. -00061 It is also not a good idea to dynamically allocate space for strings with kmalloc(). That leaves us with -00062 statically allocated space for strings. This is what is implemented in the String module. Strings use -00063 preallocated per-cpu buffers and are safe to use (unlike C strings). -00064 -00065 @subsection io_sec I/O -00066 Generally things are written to a "print buffer" using the internal -00067 functions _stp_print_xxx(). -00068 \code -00069 _stp_print ("Output is: "); -00070 _stp_printf ("pid is %d ", current->pid); -00071 _stp_printf ("name is %s", current->comm); -00072 \endcode -00073 before the probe returns it must call _stp_print_flush(). This -00074 timestamps the accumulated print buffer and sends it to relayfs. -00075 When relayfs fills an internal buffer, the user-space daemon is notified -00076 data is ready and reads a bug per-cpu chunk, which contains a line like: -00077 \verbatim -00078 [123456.000002] Output is: pid is 1234 name is bash -00079 \endverbatim -00080 -00081 The user-daemon (stpd) saves this data to a file named something like -00082 "stpd_cpu2". When the user hits ^c, a timer expires, or the probe -00083 module notifies stpd (through a netlink command channel) that it wants -00084 to terminate, stpd does "system(rmmod)" then collects the last output -00085 before exiting. -00086 As an option, if we don't need bulk per-cpu data, we can put -00087 \code -00088 #define STP_NETLINK_ONLY -00089 \endcode -00090 at the top of the module and all output will go over a netlink channel. -00091 In the SystemTap language, we will provide some simple functions to control the buffering policy, which -00092 will control the use of netlink and parameters to relayfs and stpd. -00093 -00094 @section status_sec Status -00095 @li Maps are implemented and tested. Histograms are not yet finished. -00096 @li Copy_From_User functions are done. -00097 @li If maps overflow or memory runs out for some reason, globals are set but nothing is done yet. -00098 I expect to implement a function to tell the system to either ignore it or unload the module and quit. -00099 @li Stack functions need much improvement. -00100 -00101 @section probe_sec Example Probes -00102 -00103 Working sample probe code using the runtime is in runtime/probes. -00104 <a href="dir_000000.html"> Browse probes.</a> -00105 -00106 @section todo_sec ToDo -00107 \link todo Click Here for Complete List \endlink -00108 -00109 @section links Links -00110 <a href="http:<span class="comment">//sources.redhat.com/systemtap/">SystemTap Project Page</a></span> -00111 */ -</pre></div></body></html> diff --git a/runtime/docs/html/TODO-source.html b/runtime/docs/html/TODO-source.html deleted file mode 100644 index ff8d219b..00000000 --- a/runtime/docs/html/TODO-source.html +++ /dev/null @@ -1,42 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: TODO Source File</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1>TODO</h1><a href="TODO.html">Go to the documentation of this file.</a><div class="fragment"><pre class="fragment">00001 <span class="comment">/**</span> -00002 <span class="comment">@file TODO</span> -00003 <span class="comment">@brief To-Do List</span> -00004 <span class="comment"></span> -00005 <span class="comment">***** STPD *****</span> -00006 <span class="comment"></span> -00007 <span class="comment">@todo stpd needs an option to disable ANSI colors.</span> -00008 <span class="comment"></span> -00009 <span class="comment">@todo stpd needs to be able to write netlink REALTIME_DATA to a file.</span> -00010 <span class="comment"></span> -00011 <span class="comment">@todo stpd/stp/io.c stpd needs better startup/shutdown integration with io.c in runtime. </span> -00012 <span class="comment">Shutdown works, but isn't very clean. Currently the stp script loads the module, then</span> -00013 <span class="comment">starts stpd. Data is lost until stpd is active. Maybe stpd needs to load the module. </span> -00014 <span class="comment">Maybe it needs to signal the module that stpd is ready and the module can proceed to load the probes.</span> -00015 <span class="comment"></span> -00016 <span class="comment">@todo stpd/stp - What if there are multiple probes running? </span> -00017 <span class="comment"></span> -00018 <span class="comment">@todo stpd/stp - Need something to post-process relayfs files and integrate into a single file.</span> -00019 <span class="comment"></span> -00020 <span class="comment">@todo stpd - Implement command that runtime can send to stpd to tell it to fork a specified program and pass</span> -00021 <span class="comment">the output from the probe module to it. Create example probe to use it.</span> -00022 <span class="comment"></span> -00023 <span class="comment">***** relayfs *****</span> -00024 <span class="comment">@todo relayfs/build - figure out how to get rid of the linker warnings when building probes. </span> -00025 <span class="comment"></span> -00026 <span class="comment">***** runtime *****</span> -00027 <span class="comment">@todo runtime - Clean up #defines. Need to have a clearer way to have the probe writer (translator) </span> -00028 <span class="comment">see which defines affect what and all defines should have reasonable defaults.</span> -00029 <span class="comment"></span> -00030 <span class="comment">@todo runtime - current.c - implement a memory dump function. Does a hex dump into String or print buffer.</span> -00031 <span class="comment">@todo runtime - put wrappers around current task struct entries, like pid, ppid, comm, etc.</span> -00032 <span class="comment">@todo runtime - Implement stack functions for kprobes (not just jprobes)</span> -00033 <span class="comment"></span> -00034 <span class="comment">*/</span> -</pre></div></body></html> diff --git a/runtime/docs/html/TODO.html b/runtime/docs/html/TODO.html deleted file mode 100644 index e5771873..00000000 --- a/runtime/docs/html/TODO.html +++ /dev/null @@ -1,42 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: TODO File Reference</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1>TODO File Reference</h1>To-Do List. <a href="#_details">More...</a> -<p> - -<p> -<a href="TODO-source.html">Go to the source code of this file.</a><table border="0" cellpadding="0" cellspacing="0"> -<tr><td></td></tr> -</table> -<hr><a name="_details"></a><h2>Detailed Description</h2> -To-Do List. -<p> -STPD *****<p> -<dl compact><dt><b><a class="el" href="todo.html#_todo000010">Todo:</a></b></dt><dd>stpd needs an option to disable ANSI colors. </dd></dl> -<p> -<dl compact><dt><b><a class="el" href="todo.html#_todo000010">Todo:</a></b></dt><dd>stpd needs to be able to write netlink REALTIME_DATA to a file. </dd></dl> -<p> -<dl compact><dt><b><a class="el" href="todo.html#_todo000010">Todo:</a></b></dt><dd>stpd/stp/io.c stpd needs better startup/shutdown integration with <a class="el" href="io_8c.html">io.c</a> in runtime. Shutdown works, but isn't very clean. Currently the stp script loads the module, then starts stpd. Data is lost until stpd is active. Maybe stpd needs to load the module. Maybe it needs to signal the module that stpd is ready and the module can proceed to load the probes. </dd></dl> -<p> -<dl compact><dt><b><a class="el" href="todo.html#_todo000010">Todo:</a></b></dt><dd>stpd/stp - What if there are multiple probes running? </dd></dl> -<p> -<dl compact><dt><b><a class="el" href="todo.html#_todo000010">Todo:</a></b></dt><dd>stpd/stp - Need something to post-process relayfs files and integrate into a single file. </dd></dl> -<p> -<dl compact><dt><b><a class="el" href="todo.html#_todo000010">Todo:</a></b></dt><dd>stpd - Implement command that runtime can send to stpd to tell it to fork a specified program and pass the output from the probe module to it. Create example probe to use it. </dd></dl> -relayfs ***** <p> -<dl compact><dt><b><a class="el" href="todo.html#_todo000010">Todo:</a></b></dt><dd>relayfs/build - figure out how to get rid of the linker warnings when building probes. </dd></dl> -runtime ***** <p> -<dl compact><dt><b><a class="el" href="todo.html#_todo000010">Todo:</a></b></dt><dd>runtime - Clean up #defines. Need to have a clearer way to have the probe writer (translator) see which defines affect what and all defines should have reasonable defaults. </dd></dl> -<p> -<dl compact><dt><b><a class="el" href="todo.html#_todo000010">Todo:</a></b></dt><dd>runtime - <a class="el" href="current_8c.html">current.c</a> - implement a memory dump function. Does a hex dump into String or print buffer.</dd></dl> -<p> -<dl compact><dt><b><a class="el" href="todo.html#_todo000010">Todo:</a></b></dt><dd>runtime - put wrappers around current task struct entries, like pid, ppid, comm, etc.</dd></dl> -<p> -<dl compact><dt><b><a class="el" href="todo.html#_todo000010">Todo:</a></b></dt><dd>runtime - Implement stack functions for kprobes (not just jprobes) </dd></dl> - -<p> -Definition in file <a class="el" href="TODO-source.html">TODO</a>.</body></html> diff --git a/runtime/docs/html/alloc_8c-source.html b/runtime/docs/html/alloc_8c-source.html deleted file mode 100644 index 4e76adbb..00000000 --- a/runtime/docs/html/alloc_8c-source.html +++ /dev/null @@ -1,101 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: alloc.c Source File</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1>alloc.c</h1><a href="alloc_8c.html">Go to the documentation of this file.</a><div class="fragment"><pre class="fragment">00001 <span class="preprocessor">#ifndef _ALLOC_C_</span> -00002 <span class="preprocessor"></span><span class="preprocessor">#define _ALLOC_C_</span> -00003 <span class="preprocessor"></span> -00004 <span class="comment">/* -*- linux-c -*- */</span><span class="comment"></span> -00005 <span class="comment">/** @file alloc.c</span> -00006 <span class="comment"> * @brief Memory functions.</span> -00007 <span class="comment"> */</span><span class="comment"></span> -00008 <span class="comment">/** @addtogroup alloc Memory Functions</span> -00009 <span class="comment"> * Basic malloc/calloc/free functions. These will be changed so </span> -00010 <span class="comment"> * that memory allocation errors will call a handler. The default will</span> -00011 <span class="comment"> * send a signal to the user-space daemon that will trigger the module to</span> -00012 <span class="comment"> * be unloaded.</span> -00013 <span class="comment"> * @todo Need error handling for memory allocations</span> -00014 <span class="comment"> * @todo Some of these currently use kmalloc (GFP_ATOMIC) for</span> -00015 <span class="comment"> * small allocations. This should be evaluated for performance</span> -00016 <span class="comment"> * and stability.</span> -00017 <span class="comment"> * @{</span> -00018 <span class="comment"> */</span> -00019 -00020 <span class="keyword">enum</span> errorcode { ERR_NONE=0, ERR_NO_MEM }; -00021 <span class="keyword">enum</span> errorcode _stp_error = ERR_NONE; -00022 <span class="comment"></span> -00023 <span class="comment">/** Allocates memory within a probe.</span> -00024 <span class="comment"> * This is used for small allocations from within a running</span> -00025 <span class="comment"> * probe where the process cannot sleep. </span> -00026 <span class="comment"> * @param len Number of bytes to allocate.</span> -00027 <span class="comment"> * @return a valid pointer on success or NULL on failure.</span> -00028 <span class="comment"> * @bug Currently uses kmalloc (GFP_ATOMIC).</span> -00029 <span class="comment"> */</span> -00030 -<a name="l00031"></a><a class="code" href="group__alloc.html#ga1">00031</a> <span class="keywordtype">void</span> *<a class="code" href="group__alloc.html#ga1">_stp_alloc</a>(size_t len) -00032 { -00033 <span class="keywordtype">void</span> *ptr = kmalloc(len, GFP_ATOMIC); -00034 <span class="keywordflow">if</span> (unlikely(ptr == NULL)) -00035 _stp_error = ERR_NO_MEM; -00036 <span class="keywordflow">return</span> ptr; -00037 } -00038 <span class="comment"></span> -00039 <span class="comment">/** Allocates and clears memory within a probe.</span> -00040 <span class="comment"> * This is used for small allocations from within a running</span> -00041 <span class="comment"> * probe where the process cannot sleep. </span> -00042 <span class="comment"> * @param len Number of bytes to allocate.</span> -00043 <span class="comment"> * @return a valid pointer on success or NULL on failure.</span> -00044 <span class="comment"> * @bug Currently uses kmalloc (GFP_ATOMIC).</span> -00045 <span class="comment"> */</span> -00046 -<a name="l00047"></a><a class="code" href="group__alloc.html#ga2">00047</a> <span class="keywordtype">void</span> *<a class="code" href="group__alloc.html#ga2">_stp_calloc</a>(size_t len) -00048 { -00049 <span class="keywordtype">void</span> *ptr = <a class="code" href="group__alloc.html#ga1">_stp_alloc</a>(len); -00050 <span class="keywordflow">if</span> (likely(ptr)) -00051 memset(ptr, 0, len); -00052 <span class="keywordflow">return</span> ptr; -00053 } -00054 <span class="comment"></span> -00055 <span class="comment">/** Allocates and clears memory outside a probe.</span> -00056 <span class="comment"> * This is typically used in the module initialization to</span> -00057 <span class="comment"> * allocate new maps, lists, etc.</span> -00058 <span class="comment"> * @param len Number of bytes to allocate.</span> -00059 <span class="comment"> * @return a valid pointer on success or NULL on failure.</span> -00060 <span class="comment"> */</span> -00061 -<a name="l00062"></a><a class="code" href="group__alloc.html#ga3">00062</a> <span class="keywordtype">void</span> *<a class="code" href="group__alloc.html#ga3">_stp_valloc</a>(size_t len) -00063 { -00064 <span class="keywordtype">void</span> *ptr = vmalloc(len); -00065 <span class="keywordflow">if</span> (likely(ptr)) -00066 memset(ptr, 0, len); -00067 <span class="keywordflow">else</span> -00068 _stp_error = ERR_NO_MEM; -00069 <span class="keywordflow">return</span> ptr; -00070 } -00071 <span class="comment"></span> -00072 <span class="comment">/** Frees memory allocated by _stp_alloc or _stp_calloc.</span> -00073 <span class="comment"> * @param ptr pointer to memory to free</span> -00074 <span class="comment"> */</span> -00075 -<a name="l00076"></a><a class="code" href="group__alloc.html#ga4">00076</a> <span class="keywordtype">void</span> <a class="code" href="group__alloc.html#ga4">_stp_free</a>(<span class="keywordtype">void</span> *ptr) -00077 { -00078 <span class="keywordflow">if</span> (likely(ptr)) -00079 kfree(ptr); -00080 } -00081 <span class="comment"></span> -00082 <span class="comment">/** Frees memory allocated by _stp_valloc.</span> -00083 <span class="comment"> * @param ptr pointer to memory to free</span> -00084 <span class="comment"> */</span> -00085 -<a name="l00086"></a><a class="code" href="group__alloc.html#ga5">00086</a> <span class="keywordtype">void</span> <a class="code" href="group__alloc.html#ga5">_stp_vfree</a>(<span class="keywordtype">void</span> *ptr) -00087 { -00088 <span class="keywordflow">if</span> (likely(ptr)) -00089 vfree(ptr); -00090 } -00091 <span class="comment"></span> -00092 <span class="comment">/** @} */</span> -00093 <span class="preprocessor">#endif </span><span class="comment">/* _ALLOC_C_ */</span> -</pre></div></body></html> diff --git a/runtime/docs/html/alloc_8c.html b/runtime/docs/html/alloc_8c.html deleted file mode 100644 index 8e9f7d80..00000000 --- a/runtime/docs/html/alloc_8c.html +++ /dev/null @@ -1,45 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: alloc.c File Reference</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1>alloc.c File Reference</h1>Memory functions. <a href="#_details">More...</a> -<p> - -<p> -<a href="alloc_8c-source.html">Go to the source code of this file.</a><table border="0" cellpadding="0" cellspacing="0"> -<tr><td></td></tr> -<tr><td colspan="2"><br><h2>Enumerations</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">enum </td><td class="memItemRight" valign="bottom"><b>errorcode</b> { <b>ERR_NONE</b> = 0, -<b>ERR_NO_MEM</b> - }</td></tr> - -<tr><td colspan="2"><br><h2>Functions</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__alloc.html#ga1">_stp_alloc</a> (size_t len)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Allocates memory within a probe. <a href="group__alloc.html#ga1"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__alloc.html#ga2">_stp_calloc</a> (size_t len)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Allocates and clears memory within a probe. <a href="group__alloc.html#ga2"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__alloc.html#ga3">_stp_valloc</a> (size_t len)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Allocates and clears memory outside a probe. <a href="group__alloc.html#ga3"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__alloc.html#ga4">_stp_free</a> (void *ptr)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Frees memory allocated by _stp_alloc or _stp_calloc. <a href="group__alloc.html#ga4"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__alloc.html#ga5">_stp_vfree</a> (void *ptr)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Frees memory allocated by _stp_valloc. <a href="group__alloc.html#ga5"></a><br></td></tr> -<tr><td colspan="2"><br><h2>Variables</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="ga0" doxytag="alloc.c::_stp_error"></a> -enum errorcode </td><td class="memItemRight" valign="bottom"><b>_stp_error</b> = ERR_NONE</td></tr> - -</table> -<hr><a name="_details"></a><h2>Detailed Description</h2> -Memory functions. -<p> - -<p> -Definition in file <a class="el" href="alloc_8c-source.html">alloc.c</a>.</body></html> diff --git a/runtime/docs/html/bug.html b/runtime/docs/html/bug.html deleted file mode 100644 index e19f1b2e..00000000 --- a/runtime/docs/html/bug.html +++ /dev/null @@ -1,27 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: Bug List</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1><a class="anchor" name="bug">Bug List</a></h1><a class="anchor" name="_bug000001"></a> <dl> -<dt>Global <a class="el" href="group__alloc.html#ga1">_stp_alloc</a> (size_t len) </dt> -<dd>Currently uses kmalloc (GFP_ATOMIC). </dd> -</dl> -<p> -<a class="anchor" name="_bug000002"></a> <dl> -<dt>Global <a class="el" href="group__alloc.html#ga2">_stp_calloc</a> (size_t len) </dt> -<dd>Currently uses kmalloc (GFP_ATOMIC). </dd> -</dl> -<p> -<a class="anchor" name="_bug000003"></a> <dl> -<dt>Global <a class="el" href="group__stack.html#ga6">_stp_stack_print</a> (int verbose, int levels) </dt> -<dd>levels parameter is not functional </dd> -</dl> -<p> -<a class="anchor" name="_bug000004"></a> <dl> -<dt>Global <a class="el" href="group__stack.html#ga7">_stp_stack_sprint</a> (String str, int verbose, int levels) </dt> -<dd>levels parameter is not functional </dd> -</dl> -</body></html> diff --git a/runtime/docs/html/copy_8c-source.html b/runtime/docs/html/copy_8c-source.html deleted file mode 100644 index 273aa45c..00000000 --- a/runtime/docs/html/copy_8c-source.html +++ /dev/null @@ -1,186 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: copy.c Source File</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1>copy.c</h1><a href="copy_8c.html">Go to the documentation of this file.</a><div class="fragment"><pre class="fragment">00001 <span class="preprocessor">#ifndef _COPY_C_ </span><span class="comment">/* -*- linux-c -*- */</span> -00002 <span class="preprocessor">#define _COPY_C_</span> -00003 <span class="preprocessor"></span> -00004 <span class="preprocessor">#include "<a class="code" href="string_8c.html">string.c</a>"</span> -00005 <span class="comment"></span> -00006 <span class="comment">/** @file copy.c</span> -00007 <span class="comment"> * @brief Functions to copy from user space.</span> -00008 <span class="comment"> */</span> -00009 <span class="comment"></span> -00010 <span class="comment">/** @addtogroup copy Functions to copy from user space.</span> -00011 <span class="comment"> * Functions to copy from user space.</span> -00012 <span class="comment"> * None of these functions will sleep (for example to allow pages</span> -00013 <span class="comment"> * to be swapped in). It is possible (although rare) that the data</span> -00014 <span class="comment"> * in user space will not present and these functions will return an error.</span> -00015 <span class="comment"> * @{</span> -00016 <span class="comment"> */</span> -00017 -00018 <span class="keywordtype">long</span> <a class="code" href="group__copy.html#ga0">_stp_strncpy_from_user</a>(<span class="keywordtype">char</span> *dst, <span class="keyword">const</span> <span class="keywordtype">char</span> __user *src, <span class="keywordtype">long</span> count); -00019 <span class="comment">//static long __stp_strncpy_from_user(char *dst, const char __user *src, long count);</span> -00020 -00021 <span class="preprocessor">#if defined (__i386__)</span> -00022 <span class="preprocessor"></span><span class="preprocessor">#define __stp_strncpy_from_user(dst,src,count,res) \</span> -00023 <span class="preprocessor">do { \</span> -00024 <span class="preprocessor"> int __d0, __d1, __d2; \</span> -00025 <span class="preprocessor"> __asm__ __volatile__( \</span> -00026 <span class="preprocessor"> " testl %1,%1\n" \</span> -00027 <span class="preprocessor"> " jz 2f\n" \</span> -00028 <span class="preprocessor"> "0: lodsb\n" \</span> -00029 <span class="preprocessor"> " stosb\n" \</span> -00030 <span class="preprocessor"> " testb %%al,%%al\n" \</span> -00031 <span class="preprocessor"> " jz 1f\n" \</span> -00032 <span class="preprocessor"> " decl %1\n" \</span> -00033 <span class="preprocessor"> " jnz 0b\n" \</span> -00034 <span class="preprocessor"> "1: subl %1,%0\n" \</span> -00035 <span class="preprocessor"> "2:\n" \</span> -00036 <span class="preprocessor"> ".section .fixup,\"ax\"\n" \</span> -00037 <span class="preprocessor"> "3: movl %5,%0\n" \</span> -00038 <span class="preprocessor"> " jmp 2b\n" \</span> -00039 <span class="preprocessor"> ".previous\n" \</span> -00040 <span class="preprocessor"> ".section __ex_table,\"a\"\n" \</span> -00041 <span class="preprocessor"> " .align 4\n" \</span> -00042 <span class="preprocessor"> " .long 0b,3b\n" \</span> -00043 <span class="preprocessor"> ".previous" \</span> -00044 <span class="preprocessor"> : "=d"(res), "=c"(count), "=&a" (__d0), "=&S" (__d1), \</span> -00045 <span class="preprocessor"> "=&D" (__d2) \</span> -00046 <span class="preprocessor"> : "i"(-EFAULT), "0"(count), "1"(count), "3"(src), "4"(dst) \</span> -00047 <span class="preprocessor"> : "memory"); \</span> -00048 <span class="preprocessor">} while (0)</span> -00049 <span class="preprocessor"></span><span class="preprocessor">#elif defined (__x86_64__)</span> -00050 <span class="preprocessor"></span><span class="preprocessor">#define __stp_strncpy_from_user(dst,src,count,res) \</span> -00051 <span class="preprocessor">do { \</span> -00052 <span class="preprocessor"> long __d0, __d1, __d2; \</span> -00053 <span class="preprocessor"> __asm__ __volatile__( \</span> -00054 <span class="preprocessor"> " testq %1,%1\n" \</span> -00055 <span class="preprocessor"> " jz 2f\n" \</span> -00056 <span class="preprocessor"> "0: lodsb\n" \</span> -00057 <span class="preprocessor"> " stosb\n" \</span> -00058 <span class="preprocessor"> " testb %%al,%%al\n" \</span> -00059 <span class="preprocessor"> " jz 1f\n" \</span> -00060 <span class="preprocessor"> " decq %1\n" \</span> -00061 <span class="preprocessor"> " jnz 0b\n" \</span> -00062 <span class="preprocessor"> "1: subq %1,%0\n" \</span> -00063 <span class="preprocessor"> "2:\n" \</span> -00064 <span class="preprocessor"> ".section .fixup,\"ax\"\n" \</span> -00065 <span class="preprocessor"> "3: movq %5,%0\n" \</span> -00066 <span class="preprocessor"> " jmp 2b\n" \</span> -00067 <span class="preprocessor"> ".previous\n" \</span> -00068 <span class="preprocessor"> ".section __ex_table,\"a\"\n" \</span> -00069 <span class="preprocessor"> " .align 8\n" \</span> -00070 <span class="preprocessor"> " .quad 0b,3b\n" \</span> -00071 <span class="preprocessor"> ".previous" \</span> -00072 <span class="preprocessor"> : "=r"(res), "=c"(count), "=&a" (__d0), "=&S" (__d1), \</span> -00073 <span class="preprocessor"> "=&D" (__d2) \</span> -00074 <span class="preprocessor"> : "i"(-EFAULT), "0"(count), "1"(count), "3"(src), "4"(dst) \</span> -00075 <span class="preprocessor"> : "memory"); \</span> -00076 <span class="preprocessor">} while (0)</span> -00077 <span class="preprocessor"></span><span class="preprocessor">#endif</span> -00078 <span class="preprocessor"></span><span class="comment"></span> -00079 <span class="comment">/** Copy a NULL-terminated string from userspace.</span> -00080 <span class="comment"> * On success, returns the length of the string (not including the trailing</span> -00081 <span class="comment"> * NULL).</span> -00082 <span class="comment"> *</span> -00083 <span class="comment"> * If access to userspace fails, returns -EFAULT (some data may have been</span> -00084 <span class="comment"> * copied).</span> -00085 <span class="comment"> * @param dst Destination address, in kernel space. This buffer must be at</span> -00086 <span class="comment"> * least <i>count</i> bytes long.</span> -00087 <span class="comment"> * @param src Source address, in user space.</span> -00088 <span class="comment"> * @param count Maximum number of bytes to copy, including the trailing NULL.</span> -00089 <span class="comment"> * </span> -00090 <span class="comment"> * If <i>count</i> is smaller than the length of the string, copies </span> -00091 <span class="comment"> * <i>count</i> bytes and returns <i>count</i>.</span> -00092 <span class="comment"> * @deprecated I can't think of why you wouldn't use _stp_string_from_user() instead.</span> -00093 <span class="comment"> */</span> -00094 -00095 <span class="keywordtype">long</span> -<a name="l00096"></a><a class="code" href="group__copy.html#ga0">00096</a> <a class="code" href="group__copy.html#ga0">_stp_strncpy_from_user</a>(<span class="keywordtype">char</span> *dst, <span class="keyword">const</span> <span class="keywordtype">char</span> __user *src, <span class="keywordtype">long</span> count) -00097 { -00098 <span class="keywordtype">long</span> res; -00099 __stp_strncpy_from_user(dst, src, count, res); -00100 <span class="keywordflow">return</span> res; -00101 } -00102 <span class="comment"></span> -00103 <span class="comment">/** Copy a String from userspace.</span> -00104 <span class="comment"> * Copies a string of up to \e count bytes from userspace into a String. </span> -00105 <span class="comment"> * If access to userspace fails, returns -EFAULT (some data may have been</span> -00106 <span class="comment"> * copied).</span> -00107 <span class="comment"> * @param str Destination String.</span> -00108 <span class="comment"> * @param src Source address, in user space.</span> -00109 <span class="comment"> * @param count Maximum number of bytes to copy, including the trailing NULL.</span> -00110 <span class="comment"> * </span> -00111 <span class="comment"> */</span> -00112 -<a name="l00113"></a><a class="code" href="group__copy.html#ga1">00113</a> <span class="keywordtype">void</span> <a class="code" href="group__copy.html#ga1">_stp_string_from_user</a> (String str, <span class="keyword">const</span> <span class="keywordtype">char</span> __user *src, <span class="keywordtype">long</span> count) -00114 { -00115 <span class="keywordtype">long</span> res; -00116 <span class="keywordflow">if</span> (count > <a class="code" href="group__string.html#ga8">STP_STRING_SIZE</a> - str->len - 1) -00117 count = <a class="code" href="group__string.html#ga8">STP_STRING_SIZE</a> - str->len - 1; -00118 __stp_strncpy_from_user(str->buf + str->len, src, count, res); -00119 <span class="keywordflow">if</span> (res > 0) { -00120 str->len += res; -00121 str->buf[str->len] = <span class="charliteral">'\0'</span>; -00122 } -00123 } -00124 <span class="comment"></span> -00125 <span class="comment">/** Copy a block of data from user space.</span> -00126 <span class="comment"> *</span> -00127 <span class="comment"> * If some data could not be copied, this function will pad the copied</span> -00128 <span class="comment"> * data to the requested size using zero bytes.</span> -00129 <span class="comment"></span> -00130 <span class="comment"> * @param dst Destination address, in kernel space.</span> -00131 <span class="comment"> * @param src Source address, in user space.</span> -00132 <span class="comment"> * @param count Number of bytes to copy.</span> -00133 <span class="comment"> * @return number of bytes that could not be copied. On success, </span> -00134 <span class="comment"> * this will be zero.</span> -00135 <span class="comment"> *</span> -00136 <span class="comment"> */</span> -00137 -00138 <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> -<a name="l00139"></a><a class="code" href="group__copy.html#ga2">00139</a> <a class="code" href="group__copy.html#ga2">_stp_copy_from_user</a> (<span class="keywordtype">char</span> *dst, <span class="keyword">const</span> <span class="keywordtype">char</span> __user *src, <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> count) -00140 { -00141 <span class="keywordflow">return</span> __copy_from_user_inatomic(dst, src, count); -00142 } -00143 <span class="comment"></span> -00144 <span class="comment">/** Copy an argv from user space to a List.</span> -00145 <span class="comment"> *</span> -00146 <span class="comment"> * @param list A list.</span> -00147 <span class="comment"> * @param argv Source argv, in user space.</span> -00148 <span class="comment"> * @return number of elements in <i>list</i></span> -00149 <span class="comment"> *</span> -00150 <span class="comment"> * @b Example:</span> -00151 <span class="comment"> * @include argv.c</span> -00152 <span class="comment"> */</span> -00153 -<a name="l00154"></a><a class="code" href="group__copy.html#ga3">00154</a> <span class="keywordtype">int</span> <a class="code" href="group__copy.html#ga3">_stp_copy_argv_from_user</a> (<a class="code" href="group__maps.html#ga1">MAP</a> list, <span class="keywordtype">char</span> __user *__user *argv) -00155 { -00156 <span class="keywordtype">char</span> str[128]; -00157 <span class="keywordtype">char</span> __user *vstr; -00158 <span class="keywordtype">int</span> len; -00159 -00160 <span class="keywordflow">if</span> (argv) -00161 argv++; -00162 -00163 <span class="keywordflow">while</span> (argv != NULL) { -00164 <span class="keywordflow">if</span> (get_user (vstr, argv)) -00165 <span class="keywordflow">break</span>; -00166 -00167 <span class="keywordflow">if</span> (vstr == NULL) -00168 <span class="keywordflow">break</span>; -00169 -00170 len = <a class="code" href="group__copy.html#ga0">_stp_strncpy_from_user</a>(str, vstr, 128); -00171 str[len] = 0; -00172 <a class="code" href="group__lists.html#ga2">_stp_list_add_str</a> (list, str); -00173 argv++; -00174 } -00175 <span class="keywordflow">return</span> list->num; -00176 }<span class="comment"></span> -00177 <span class="comment">/** @} */</span> -00178 <span class="preprocessor">#endif </span><span class="comment">/* _COPY_C_ */</span> -</pre></div></body></html> diff --git a/runtime/docs/html/copy_8c.html b/runtime/docs/html/copy_8c.html deleted file mode 100644 index b9c4cc23..00000000 --- a/runtime/docs/html/copy_8c.html +++ /dev/null @@ -1,34 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: copy.c File Reference</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1>copy.c File Reference</h1>Functions to copy from user space. <a href="#_details">More...</a> -<p> -<code>#include "<a class="el" href="string_8c-source.html">string.c</a>"</code><br> - -<p> -<a href="copy_8c-source.html">Go to the source code of this file.</a><table border="0" cellpadding="0" cellspacing="0"> -<tr><td></td></tr> -<tr><td colspan="2"><br><h2>Functions</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">long </td><td class="memItemRight" valign="bottom"><a class="el" href="group__copy.html#ga0">_stp_strncpy_from_user</a> (char *dst, const char __user *src, long count)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Copy a NULL-terminated string from userspace. <a href="group__copy.html#ga0"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__copy.html#ga1">_stp_string_from_user</a> (String str, const char __user *src, long count)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Copy a String from userspace. <a href="group__copy.html#ga1"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">unsigned long </td><td class="memItemRight" valign="bottom"><a class="el" href="group__copy.html#ga2">_stp_copy_from_user</a> (char *dst, const char __user *src, unsigned long count)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Copy a block of data from user space. <a href="group__copy.html#ga2"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__copy.html#ga3">_stp_copy_argv_from_user</a> (<a class="el" href="group__maps.html#ga1">MAP</a> list, char __user *__user *argv)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Copy an argv from user space to a List. <a href="group__copy.html#ga3"></a><br></td></tr> -</table> -<hr><a name="_details"></a><h2>Detailed Description</h2> -Functions to copy from user space. -<p> - -<p> -Definition in file <a class="el" href="copy_8c-source.html">copy.c</a>.</body></html> diff --git a/runtime/docs/html/current_8c-source.html b/runtime/docs/html/current_8c-source.html deleted file mode 100644 index cbe1bca7..00000000 --- a/runtime/docs/html/current_8c-source.html +++ /dev/null @@ -1,42 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: current.c Source File</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1>current.c</h1><a href="current_8c.html">Go to the documentation of this file.</a><div class="fragment"><pre class="fragment">00001 <span class="preprocessor">#ifndef _CURRENT_C_</span> -00002 <span class="preprocessor"></span><span class="preprocessor">#define _CURRENT_C_</span> -00003 <span class="preprocessor"></span> -00004 <span class="comment">/* -*- linux-c -*- */</span><span class="comment"></span> -00005 <span class="comment">/** @file current.c</span> -00006 <span class="comment"> * @brief Functions to get the current state.</span> -00007 <span class="comment"> */</span><span class="comment"></span> -00008 <span class="comment">/** @addtogroup current Current State</span> -00009 <span class="comment"> * Functions to get the current state.</span> -00010 <span class="comment"> * @{</span> -00011 <span class="comment"> */</span> -00012 -00013 <span class="comment"></span> -00014 <span class="comment">/** Get the current return address.</span> -00015 <span class="comment"> * Call from kprobes (not jprobes).</span> -00016 <span class="comment"> * @param regs The pt_regs saved by the kprobe.</span> -00017 <span class="comment"> * @return The return address saved in esp or rsp.</span> -00018 <span class="comment"> * @note i386 and x86_64 only so far.</span> -00019 <span class="comment"> */</span> -00020 -<a name="l00021"></a><a class="code" href="group__current.html#ga0">00021</a> <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> <a class="code" href="group__current.html#ga0">_stp_ret_addr</a> (<span class="keyword">struct</span> pt_regs *regs) -00022 { -00023 <span class="preprocessor">#ifdef __x86_64__</span> -00024 <span class="preprocessor"></span> <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> *ra = (<span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> *)regs->rsp; -00025 <span class="preprocessor">#else</span> -00026 <span class="preprocessor"></span> <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> *ra = (<span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> *)regs->esp; -00027 <span class="preprocessor">#endif</span> -00028 <span class="preprocessor"></span> <span class="keywordflow">if</span> (ra) -00029 <span class="keywordflow">return</span> *ra; -00030 <span class="keywordflow">else</span> -00031 <span class="keywordflow">return</span> 0; -00032 }<span class="comment"></span> -00033 <span class="comment">/** @} */</span> -00034 <span class="preprocessor">#endif </span><span class="comment">/* _CURRENT_C_ */</span> -</pre></div></body></html> diff --git a/runtime/docs/html/current_8c.html b/runtime/docs/html/current_8c.html deleted file mode 100644 index 698a4467..00000000 --- a/runtime/docs/html/current_8c.html +++ /dev/null @@ -1,24 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: current.c File Reference</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1>current.c File Reference</h1>Functions to get the current state. <a href="#_details">More...</a> -<p> - -<p> -<a href="current_8c-source.html">Go to the source code of this file.</a><table border="0" cellpadding="0" cellspacing="0"> -<tr><td></td></tr> -<tr><td colspan="2"><br><h2>Functions</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">unsigned long </td><td class="memItemRight" valign="bottom"><a class="el" href="group__current.html#ga0">_stp_ret_addr</a> (struct pt_regs *regs)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the current return address. <a href="group__current.html#ga0"></a><br></td></tr> -</table> -<hr><a name="_details"></a><h2>Detailed Description</h2> -Functions to get the current state. -<p> - -<p> -Definition in file <a class="el" href="current_8c-source.html">current.c</a>.</body></html> diff --git a/runtime/docs/html/deprecated.html b/runtime/docs/html/deprecated.html deleted file mode 100644 index fbfbb5d0..00000000 --- a/runtime/docs/html/deprecated.html +++ /dev/null @@ -1,12 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: Deprecated List</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1><a class="anchor" name="deprecated">Deprecated List</a></h1><a class="anchor" name="_deprecated000001"></a> <dl> -<dt>Global <a class="el" href="group__copy.html#ga0">_stp_strncpy_from_user</a> (char *dst, const char __user *src, long count) </dt> -<dd>I can't think of why you wouldn't use <a class="el" href="group__copy.html#ga1">_stp_string_from_user()</a> instead. </dd> -</dl> -</body></html> diff --git a/runtime/docs/html/dir_000000.html b/runtime/docs/html/dir_000000.html deleted file mode 100644 index 9ee08412..00000000 --- a/runtime/docs/html/dir_000000.html +++ /dev/null @@ -1,41 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: probes/ Directory Reference</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<div class="nav"> -<a class="el" href="dir_000000.html">probes</a></div> -<h1>probes Directory Reference</h1>This directory contains working example probes that demonstrate and test the runtime library. -<a href="#_details">More...</a><table border="0" cellpadding="0" cellspacing="0"> -<tr><td></td></tr> -<tr><td colspan="2"><br><h2>Directories</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">directory </td><td class="memItemRight" valign="bottom"><a class="el" href="dir_000001.html">shellsnoop</a></td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Snoops on what commands are being run by shells. <br></td></tr> - -<p> -<tr><td class="memItemLeft" nowrap align="right" valign="top">directory </td><td class="memItemRight" valign="bottom"><a class="el" href="dir_000002.html">tasklet</a></td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Sample probe in a tasklet. <br></td></tr> - -<p> -<tr><td class="memItemLeft" nowrap align="right" valign="top">directory </td><td class="memItemRight" valign="bottom"><a class="el" href="dir_000003.html">test4</a></td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">This example probe tracks file opens, reads and writes. <br></td></tr> - -<p> -<tr><td class="memItemLeft" nowrap align="right" valign="top">directory </td><td class="memItemRight" valign="bottom"><a class="el" href="dir_000004.html">where_func</a></td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">This is a silly little instrumentation routine to instrument functions entry by name. <br></td></tr> - -<p> -<tr><td colspan="2"><br><h2>Files</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">file </td><td class="memItemRight" valign="bottom"><b>README</b> <a href="probes_2README-source.html">[code]</a></td></tr> - -</table> -<hr><a name="_details"></a><h2>Detailed Description</h2> -This directory contains working example probes that demonstrate and test the runtime library. -<p> -They are tested on i386 and x86_64. </body></html> diff --git a/runtime/docs/html/dir_000001.html b/runtime/docs/html/dir_000001.html deleted file mode 100644 index 3e97a453..00000000 --- a/runtime/docs/html/dir_000001.html +++ /dev/null @@ -1,89 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: probes/shellsnoop/ Directory Reference</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<div class="nav"> -<a class="el" href="dir_000000.html">probes</a> / <a class="el" href="dir_000001.html">shellsnoop</a></div> -<h1>shellsnoop Directory Reference</h1>Snoops on what commands are being run by shells. -<a href="#_details">More...</a><table border="0" cellpadding="0" cellspacing="0"> -<tr><td></td></tr> -<tr><td colspan="2"><br><h2>Files</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">file </td><td class="memItemRight" valign="bottom"><b>dtr.c</b> <a href="shellsnoop_2dtr_8c-source.html">[code]</a></td></tr> - -<tr><td class="memItemLeft" nowrap align="right" valign="top">file </td><td class="memItemRight" valign="bottom"><b>dtr.mod.c</b> <a href="dtr_8mod_8c-source.html">[code]</a></td></tr> - -<tr><td class="memItemLeft" nowrap align="right" valign="top">file </td><td class="memItemRight" valign="bottom"><b>README</b> <a href="probes_2shellsnoop_2README-source.html">[code]</a></td></tr> - -</table> -<hr><a name="_details"></a><h2>Detailed Description</h2> -Snoops on what commands are being run by shells. -<p> -This is a translation of on an old dtr probe. It demonstrates maps, lists, and how to use <a class="el" href="group__copy.html#ga3">_stp_copy_argv_from_user()</a> and <a class="el" href="group__copy.html#ga0">_stp_strncpy_from_user()</a>.<p> -Original dtr source:<p> -<div class="fragment"><pre class="fragment"> -# shellsnoop.probe - snoop shell execution as it occurs. -# clone of dtrace shellsnoop example - -global { - long @pids[long]; -} - -probe do_execve:entry { - char __user *vstr; - char str[256]; - int len; - - /* watch shells only */ - /* FIXME: detect more shells, like csh, tcsh, zsh */ - - if (!strcmp(current->comm,"bash") || !strcmp(current->comm,"sh") || !strcmp(current->comm, "zsh") - || !strcmp(current->comm, "tcsh") || !strcmp(current->comm, "pdksh")) - { - dlog ("%d\t%d\t%d\t%s ", current->uid, current->pid, current->parent->pid, filename); - @pids[current->pid] = 1; - - /* print out argv, ignoring argv[0] */ - if (argv) argv++; - while (argv != NULL) - { - if (get_user (vstr, argv)) - break; - if (!vstr) - break; - len = dtr_strncpy_from_user(str, vstr, 256); - str[len] = 0; - printk ("%s ", str); - argv++; - } - printk ("\n"); - } -} - -# use filp_open because copy_from_user not needed there -probe filp_open:entry { - if (@pids[current->pid]) - dlog ("%d\t%d\t%s\tO %s\n", current->pid, current->parent->pid, current->comm, filename); -} - -probe sys_read:entry { - if (@pids[current->pid]) - dlog ("%d\t%d\t%s\tR %d\n", current->pid, current->parent->pid, current->comm, fd); -} - -probe sys_write:entry { - size_t len; - char str[256]; - if (@pids[current->pid]) - { - if (count < 64) len = count; - else len = 64; - if (len = dtr_strncpy_from_user(str, buf, len)) { - str[len] = 0; - dlog ("%d\t%d\t%s\tW %s\n", current->pid, current->parent->pid, current->comm, str); - } - } -} -</pre></div> </body></html> diff --git a/runtime/docs/html/dir_000002.html b/runtime/docs/html/dir_000002.html deleted file mode 100644 index 0fe099ec..00000000 --- a/runtime/docs/html/dir_000002.html +++ /dev/null @@ -1,27 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: probes/tasklet/ Directory Reference</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<div class="nav"> -<a class="el" href="dir_000000.html">probes</a> / <a class="el" href="dir_000002.html">tasklet</a></div> -<h1>tasklet Directory Reference</h1>Sample probe in a tasklet. -<a href="#_details">More...</a><table border="0" cellpadding="0" cellspacing="0"> -<tr><td></td></tr> -<tr><td colspan="2"><br><h2>Files</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">file </td><td class="memItemRight" valign="bottom"><b>README</b> <a href="probes_2tasklet_2README-source.html">[code]</a></td></tr> - -<tr><td class="memItemLeft" nowrap align="right" valign="top">file </td><td class="memItemRight" valign="bottom"><b>stp_tasklet.c</b> <a href="stp__tasklet_8c-source.html">[code]</a></td></tr> - -</table> -<hr><a name="_details"></a><h2>Detailed Description</h2> -Sample probe in a tasklet. -<p> -Useful for interrupt context testing.<p> -<div class="fragment"><pre class="fragment"> -> ./build -> insmod stp_tasklet.ko -> rmmod stp_tasklet.ko -</pre></div> </body></html> diff --git a/runtime/docs/html/dir_000003.html b/runtime/docs/html/dir_000003.html deleted file mode 100644 index 497baf4d..00000000 --- a/runtime/docs/html/dir_000003.html +++ /dev/null @@ -1,40 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: probes/test4/ Directory Reference</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<div class="nav"> -<a class="el" href="dir_000000.html">probes</a> / <a class="el" href="dir_000003.html">test4</a></div> -<h1>test4 Directory Reference</h1>This example probe tracks file opens, reads and writes. -<a href="#_details">More...</a><table border="0" cellpadding="0" cellspacing="0"> -<tr><td></td></tr> -<tr><td colspan="2"><br><h2>Files</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">file </td><td class="memItemRight" valign="bottom"><b>dtr.c</b> <a href="test4_2dtr_8c-source.html">[code]</a></td></tr> - -<tr><td class="memItemLeft" nowrap align="right" valign="top">file </td><td class="memItemRight" valign="bottom"><b>README</b> <a href="probes_2test4_2README-source.html">[code]</a></td></tr> - -</table> -<hr><a name="_details"></a><h2>Detailed Description</h2> -This example probe tracks file opens, reads and writes. -<p> -It demonstrates maps, stats, and iterators.<p> -This is a translation of on an old dtr probe. Original source is <div class="fragment"><pre class="fragment"> -global { - long @opens[string]; - sum @reads[string], @writes[string]; -} - -probe sys_open:entry { - @opens[current->comm]++; -} - -probe sys_read:entry { - @reads[current->comm] << count; -} - -probe sys_write:entry { - @writes[current->comm] << count; -} -</pre></div> </body></html> diff --git a/runtime/docs/html/dir_000004.html b/runtime/docs/html/dir_000004.html deleted file mode 100644 index 4eeb55a8..00000000 --- a/runtime/docs/html/dir_000004.html +++ /dev/null @@ -1,28 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: probes/where_func/ Directory Reference</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<div class="nav"> -<a class="el" href="dir_000000.html">probes</a> / <a class="el" href="dir_000004.html">where_func</a></div> -<h1>where_func Directory Reference</h1>This is a silly little instrumentation routine to instrument functions entry by name. -<a href="#_details">More...</a><table border="0" cellpadding="0" cellspacing="0"> -<tr><td></td></tr> -<tr><td colspan="2"><br><h2>Files</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">file </td><td class="memItemRight" valign="bottom"><b>kprobe_where_funct.c</b> <a href="kprobe__where__funct_8c-source.html">[code]</a></td></tr> - -<tr><td class="memItemLeft" nowrap align="right" valign="top">file </td><td class="memItemRight" valign="bottom"><b>README</b> <a href="probes_2where__func_2README-source.html">[code]</a></td></tr> - -</table> -<hr><a name="_details"></a><h2>Detailed Description</h2> -This is a silly little instrumentation routine to instrument functions entry by name. -<p> -It makes use of the SystemTap runtime libraries to break down the number of times the function by caller.<p> -It demonstrates kprobes, passing a module parameter, using the print buffer, and using _stp_print_symbol() to map the addresses back to locations in functions.<p> -By default it instruments schedule().<p> -The instrumentation module is built by having the kernel that is going to be instrumented currently on the machine and doing <div class="fragment"><pre class="fragment">./build -</pre></div> The instrumentation is inserted as root with: <div class="fragment"><pre class="fragment">/sbin/insmod kprobe_funct_where.ko funct_name=function_name -</pre></div> The instrumentation is removed as root with: <div class="fragment"><pre class="fragment">/sbin/rmmod kprobe_funct_where -</pre></div> -Will Cohen </body></html> diff --git a/runtime/docs/html/dirs.html b/runtime/docs/html/dirs.html deleted file mode 100644 index 9cc73aaf..00000000 --- a/runtime/docs/html/dirs.html +++ /dev/null @@ -1,17 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: Directory Hierarchy</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindexHL" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1>SystemTap Directories</h1>This directory hierarchy is sorted roughly, but not completely, alphabetically:<ul> -<li><a class="el" href="dir_000000.html">probes</a> -<ul> -<li><a class="el" href="dir_000001.html">shellsnoop</a> -<li><a class="el" href="dir_000002.html">tasklet</a> -<li><a class="el" href="dir_000003.html">test4</a> -<li><a class="el" href="dir_000004.html">where_func</a> -</ul> -</ul> -</body></html> diff --git a/runtime/docs/html/doxygen.css b/runtime/docs/html/doxygen.css deleted file mode 100644 index e5272cd1..00000000 --- a/runtime/docs/html/doxygen.css +++ /dev/null @@ -1,297 +0,0 @@ -BODY,H1,H2,H3,H4,H5,H6,P,CENTER,TD,TH,UL,DL,DIV { - font-family: Geneva, Arial, Helvetica, sans-serif; -} -BODY,TD { - font-size: 90%; -} -H1 { - text-align: center; - font-size: 160%; -} -H2 { - font-size: 120%; -} -H3 { - font-size: 110%; -} -CAPTION { font-weight: bold } -DIV.qindex { - width: 100%; - background-color: #eeeeff; - border: 1px solid #b0b0b0; - text-align: center; - margin: 2px; - padding: 2px; - line-height: 140%; -} -DIV.nav { - width: 100%; - background-color: #eeeeff; - border: 1px solid #b0b0b0; - text-align: center; - margin: 2px; - padding: 2px; - line-height: 140%; -} -A.qindex { - text-decoration: none; - font-weight: bold; - color: #1A419D; -} -A.qindex:visited { - text-decoration: none; - font-weight: bold; - color: #1A419D -} -A.qindex:hover { - text-decoration: none; - background-color: #ddddff; -} -A.qindexHL { - text-decoration: none; - font-weight: bold; - background-color: #6666cc; - color: #ffffff; - border: 1px double #9295C2; -} -A.qindexHL:hover { - text-decoration: none; - background-color: #6666cc; - color: #ffffff; -} -A.qindexHL:visited { text-decoration: none; background-color: #6666cc; color: #ffffff } -A.el { text-decoration: none; font-weight: bold } -A.elRef { font-weight: bold } -A.code:link { text-decoration: none; font-weight: normal; color: #0000FF} -A.code:visited { text-decoration: none; font-weight: normal; color: #0000FF} -A.codeRef:link { font-weight: normal; color: #0000FF} -A.codeRef:visited { font-weight: normal; color: #0000FF} -A:hover { text-decoration: none; background-color: #f2f2ff } -DL.el { margin-left: -1cm } -.fragment { - font-family: monospace -} -PRE.fragment { - border: 1px solid #CCCCCC; - background-color: #f5f5f5; - margin-top: 4px; - margin-bottom: 4px; - margin-left: 2px; - margin-right: 8px; - padding-left: 6px; - padding-right: 6px; - padding-top: 4px; - padding-bottom: 4px; -} -DIV.ah { background-color: black; font-weight: bold; color: #ffffff; margin-bottom: 3px; margin-top: 3px } -TD.md { background-color: #F4F4FB; font-weight: bold; } -TD.mdPrefix { - background-color: #F4F4FB; - color: #606060; - font-size: 80%; -} -TD.mdname1 { background-color: #F4F4FB; font-weight: bold; color: #602020; } -TD.mdname { background-color: #F4F4FB; font-weight: bold; color: #602020; width: 600px; } -DIV.groupHeader { - margin-left: 16px; - margin-top: 12px; - margin-bottom: 6px; - font-weight: bold; -} -DIV.groupText { margin-left: 16px; font-style: italic; font-size: 90% } -BODY { - background: white; - color: black; - margin-right: 20px; - margin-left: 20px; -} -TD.indexkey { - background-color: #eeeeff; - font-weight: bold; - padding-right : 10px; - padding-top : 2px; - padding-left : 10px; - padding-bottom : 2px; - margin-left : 0px; - margin-right : 0px; - margin-top : 2px; - margin-bottom : 2px; - border: 1px solid #CCCCCC; -} -TD.indexvalue { - background-color: #eeeeff; - font-style: italic; - padding-right : 10px; - padding-top : 2px; - padding-left : 10px; - padding-bottom : 2px; - margin-left : 0px; - margin-right : 0px; - margin-top : 2px; - margin-bottom : 2px; - border: 1px solid #CCCCCC; -} -TR.memlist { - background-color: #f0f0f0; -} -P.formulaDsp { text-align: center; } -IMG.formulaDsp { } -IMG.formulaInl { vertical-align: middle; } -SPAN.keyword { color: #008000 } -SPAN.keywordtype { color: #604020 } -SPAN.keywordflow { color: #e08000 } -SPAN.comment { color: #800000 } -SPAN.preprocessor { color: #806020 } -SPAN.stringliteral { color: #002080 } -SPAN.charliteral { color: #008080 } -.mdTable { - border: 1px solid #868686; - background-color: #F4F4FB; -} -.mdRow { - padding: 8px 10px; -} -.mdescLeft { - padding: 0px 8px 4px 8px; - font-size: 80%; - font-style: italic; - background-color: #FAFAFA; - border-top: 1px none #E0E0E0; - border-right: 1px none #E0E0E0; - border-bottom: 1px none #E0E0E0; - border-left: 1px none #E0E0E0; - margin: 0px; -} -.mdescRight { - padding: 0px 8px 4px 8px; - font-size: 80%; - font-style: italic; - background-color: #FAFAFA; - border-top: 1px none #E0E0E0; - border-right: 1px none #E0E0E0; - border-bottom: 1px none #E0E0E0; - border-left: 1px none #E0E0E0; - margin: 0px; -} -.memItemLeft { - padding: 1px 0px 0px 8px; - margin: 4px; - border-top-width: 1px; - border-right-width: 1px; - border-bottom-width: 1px; - border-left-width: 1px; - border-top-color: #E0E0E0; - border-right-color: #E0E0E0; - border-bottom-color: #E0E0E0; - border-left-color: #E0E0E0; - border-top-style: solid; - border-right-style: none; - border-bottom-style: none; - border-left-style: none; - background-color: #FAFAFA; - font-size: 80%; -} -.memItemRight { - padding: 1px 8px 0px 8px; - margin: 4px; - border-top-width: 1px; - border-right-width: 1px; - border-bottom-width: 1px; - border-left-width: 1px; - border-top-color: #E0E0E0; - border-right-color: #E0E0E0; - border-bottom-color: #E0E0E0; - border-left-color: #E0E0E0; - border-top-style: solid; - border-right-style: none; - border-bottom-style: none; - border-left-style: none; - background-color: #FAFAFA; - font-size: 80%; -} -.memTemplItemLeft { - padding: 1px 0px 0px 8px; - margin: 4px; - border-top-width: 1px; - border-right-width: 1px; - border-bottom-width: 1px; - border-left-width: 1px; - border-top-color: #E0E0E0; - border-right-color: #E0E0E0; - border-bottom-color: #E0E0E0; - border-left-color: #E0E0E0; - border-top-style: none; - border-right-style: none; - border-bottom-style: none; - border-left-style: none; - background-color: #FAFAFA; - font-size: 80%; -} -.memTemplItemRight { - padding: 1px 8px 0px 8px; - margin: 4px; - border-top-width: 1px; - border-right-width: 1px; - border-bottom-width: 1px; - border-left-width: 1px; - border-top-color: #E0E0E0; - border-right-color: #E0E0E0; - border-bottom-color: #E0E0E0; - border-left-color: #E0E0E0; - border-top-style: none; - border-right-style: none; - border-bottom-style: none; - border-left-style: none; - background-color: #FAFAFA; - font-size: 80%; -} -.memTemplParams { - padding: 1px 0px 0px 8px; - margin: 4px; - border-top-width: 1px; - border-right-width: 1px; - border-bottom-width: 1px; - border-left-width: 1px; - border-top-color: #E0E0E0; - border-right-color: #E0E0E0; - border-bottom-color: #E0E0E0; - border-left-color: #E0E0E0; - border-top-style: solid; - border-right-style: none; - border-bottom-style: none; - border-left-style: none; - color: #606060; - background-color: #FAFAFA; - font-size: 80%; -} -.search { color: #003399; - font-weight: bold; -} -FORM.search { - margin-bottom: 0px; - margin-top: 0px; -} -INPUT.search { font-size: 75%; - color: #000080; - font-weight: normal; - background-color: #eeeeff; -} -TD.tiny { font-size: 75%; -} -a { - color: #252E78; -} -a:visited { - color: #3D2185; -} -.dirtab { padding: 4px; - border-collapse: collapse; - border: 1px solid #b0b0b0; -} -TH.dirtab { background: #eeeeff; - font-weight: bold; -} -HR { height: 1px; - border: none; - border-top: 1px solid black; -} diff --git a/runtime/docs/html/doxygen.png b/runtime/docs/html/doxygen.png Binary files differdeleted file mode 100644 index f0a274bb..00000000 --- a/runtime/docs/html/doxygen.png +++ /dev/null diff --git a/runtime/docs/html/dtr_8mod_8c-source.html b/runtime/docs/html/dtr_8mod_8c-source.html deleted file mode 100644 index c1483735..00000000 --- a/runtime/docs/html/dtr_8mod_8c-source.html +++ /dev/null @@ -1,65 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: probes/shellsnoop/dtr.mod.c Source File</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<div class="nav"> -<a class="el" href="dir_000000.html">probes</a> / <a class="el" href="dir_000001.html">shellsnoop</a></div> -<h1>dtr.mod.c</h1><div class="fragment"><pre class="fragment">00001 <span class="preprocessor">#include <linux/module.h></span> -00002 <span class="preprocessor">#include <linux/vermagic.h></span> -00003 <span class="preprocessor">#include <linux/compiler.h></span> -00004 -00005 MODULE_INFO(vermagic, VERMAGIC_STRING); -00006 -00007 <span class="preprocessor">#undef unix</span> -00008 <span class="preprocessor"></span><span class="keyword">struct </span>module __this_module -00009 __attribute__((section(".gnu.linkonce.this_module"))) = { -00010 .name = __stringify(KBUILD_MODNAME), -00011 .init = init_module, -00012 <span class="preprocessor">#ifdef CONFIG_MODULE_UNLOAD</span> -00013 <span class="preprocessor"></span> .exit = cleanup_module, -00014 <span class="preprocessor">#endif</span> -00015 <span class="preprocessor"></span>}; -00016 -00017 <span class="keyword">static</span> <span class="keyword">const</span> <span class="keyword">struct </span>modversion_info ____versions[] -00018 __attribute_used__ -00019 __attribute__((section("__versions"))) = { -00020 { 0x506abef7, <span class="stringliteral">"struct_module"</span> }, -00021 { 0x1b9aca3f, <span class="stringliteral">"jprobe_return"</span> }, -00022 { 0x45e5f47f, <span class="stringliteral">"register_kprobe"</span> }, -00023 { 0x1e736243, <span class="stringliteral">"unregister_kprobe"</span> }, -00024 { 0xdd03a51e, <span class="stringliteral">"register_jprobe"</span> }, -00025 { 0x49a83d3a, <span class="stringliteral">"unregister_jprobe"</span> }, -00026 { 0xaa27f890, <span class="stringliteral">"__get_user_8"</span> }, -00027 { 0x21e5679c, <span class="stringliteral">"copy_user_generic"</span> }, -00028 { 0x3fa03a97, <span class="stringliteral">"memset"</span> }, -00029 { 0xc16fe12d, <span class="stringliteral">"__memcpy"</span> }, -00030 { 0xe914e41e, <span class="stringliteral">"strcpy"</span> }, -00031 { 0xe2d5255a, <span class="stringliteral">"strcmp"</span> }, -00032 { 0x2fd1d81c, <span class="stringliteral">"vfree"</span> }, -00033 { 0x37a0cba, <span class="stringliteral">"kfree"</span> }, -00034 { 0xd6ee688f, <span class="stringliteral">"vmalloc"</span> }, -00035 { 0x8ce16b3f, <span class="stringliteral">"__kmalloc"</span> }, -00036 { 0xfcdec747, <span class="stringliteral">"sock_release"</span> }, -00037 { 0x8968634b, <span class="stringliteral">"netlink_kernel_create"</span> }, -00038 { 0x7ec9bfbc, <span class="stringliteral">"strncpy"</span> }, -00039 { 0xe3b0192b, <span class="stringliteral">"vscnprintf"</span> }, -00040 { 0x757b6858, <span class="stringliteral">"skb_dequeue"</span> }, -00041 { 0xd4aed67a, <span class="stringliteral">"netlink_ack"</span> }, -00042 { 0xdd132261, <span class="stringliteral">"printk"</span> }, -00043 { 0x5fc0695e, <span class="stringliteral">"__kfree_skb"</span> }, -00044 { 0xaa1449d7, <span class="stringliteral">"netlink_unicast"</span> }, -00045 { 0x3958414f, <span class="stringliteral">"skb_over_panic"</span> }, -00046 { 0x559dbbb8, <span class="stringliteral">"alloc_skb"</span> }, -00047 }; -00048 -00049 <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">char</span> __module_depends[] -00050 __attribute_used__ -00051 __attribute__((section(<span class="stringliteral">".modinfo"</span>))) = -00052 <span class="stringliteral">"depends="</span>; -00053 -00054 -00055 MODULE_INFO(srcversion, <span class="stringliteral">"F330A962246F179FE15E94B"</span>); -</pre></div></body></html> diff --git a/runtime/docs/html/files.html b/runtime/docs/html/files.html deleted file mode 100644 index 0099797e..00000000 --- a/runtime/docs/html/files.html +++ /dev/null @@ -1,35 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: File Index</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindexHL" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1>SystemTap File List</h1>Here is a list of all documented files with brief descriptions:<table> - <tr><td class="indexkey"><a class="el" href="alloc_8c.html">alloc.c</a> <a href="alloc_8c-source.html">[code]</a></td><td class="indexvalue">Memory functions </td></tr> - <tr><td class="indexkey"><a class="el" href="copy_8c.html">copy.c</a> <a href="copy_8c-source.html">[code]</a></td><td class="indexvalue">Functions to copy from user space </td></tr> - <tr><td class="indexkey"><a class="el" href="current_8c.html">current.c</a> <a href="current_8c-source.html">[code]</a></td><td class="indexvalue">Functions to get the current state </td></tr> - <tr><td class="indexkey"><a class="el" href="io_8c.html">io.c</a> <a href="io_8c-source.html">[code]</a></td><td class="indexvalue">I/O functions </td></tr> - <tr><td class="indexkey"><a class="el" href="map_8c.html">map.c</a> <a href="map_8c-source.html">[code]</a></td><td class="indexvalue">Implements maps (associative arrays) and lists </td></tr> - <tr><td class="indexkey"><a class="el" href="map_8h.html">map.h</a> <a href="map_8h-source.html">[code]</a></td><td class="indexvalue">Header file for maps and lists </td></tr> - <tr><td class="indexkey"><b>print.c</b> <a href="print_8c-source.html">[code]</a></td><td class="indexvalue"></td></tr> - <tr><td class="indexkey"><a class="el" href="probes_8c.html">probes.c</a> <a href="probes_8c-source.html">[code]</a></td><td class="indexvalue">Functions to assist loading and unloading groups of probes </td></tr> - <tr><td class="indexkey"><b>README</b> <a href="README-source.html">[code]</a></td><td class="indexvalue"></td></tr> - <tr><td class="indexkey"><b>relay-app.h</b> <a href="relay-app_8h-source.html">[code]</a></td><td class="indexvalue"></td></tr> - <tr><td class="indexkey"><a class="el" href="runtime_8h.html">runtime.h</a> <a href="runtime_8h-source.html">[code]</a></td><td class="indexvalue">Main include file for runtime functions </td></tr> - <tr><td class="indexkey"><a class="el" href="stack_8c.html">stack.c</a> <a href="stack_8c-source.html">[code]</a></td><td class="indexvalue">Stack Tracing Functions </td></tr> - <tr><td class="indexkey"><a class="el" href="string_8c.html">string.c</a> <a href="string_8c-source.html">[code]</a></td><td class="indexvalue">Implements String type </td></tr> - <tr><td class="indexkey"><b>sym.c</b> <a href="sym_8c-source.html">[code]</a></td><td class="indexvalue"></td></tr> - <tr><td class="indexkey"><a class="el" href="TODO.html">TODO</a> <a href="TODO-source.html">[code]</a></td><td class="indexvalue">To-Do List </td></tr> - <tr><td class="indexkey">probes/<b>README</b> <a href="probes_2README-source.html">[code]</a></td><td class="indexvalue"></td></tr> - <tr><td class="indexkey">probes/shellsnoop/<b>dtr.c</b> <a href="shellsnoop_2dtr_8c-source.html">[code]</a></td><td class="indexvalue"></td></tr> - <tr><td class="indexkey">probes/shellsnoop/<b>dtr.mod.c</b> <a href="dtr_8mod_8c-source.html">[code]</a></td><td class="indexvalue"></td></tr> - <tr><td class="indexkey">probes/shellsnoop/<b>README</b> <a href="probes_2shellsnoop_2README-source.html">[code]</a></td><td class="indexvalue"></td></tr> - <tr><td class="indexkey">probes/tasklet/<b>README</b> <a href="probes_2tasklet_2README-source.html">[code]</a></td><td class="indexvalue"></td></tr> - <tr><td class="indexkey">probes/tasklet/<b>stp_tasklet.c</b> <a href="stp__tasklet_8c-source.html">[code]</a></td><td class="indexvalue"></td></tr> - <tr><td class="indexkey">probes/test4/<b>dtr.c</b> <a href="test4_2dtr_8c-source.html">[code]</a></td><td class="indexvalue"></td></tr> - <tr><td class="indexkey">probes/test4/<b>README</b> <a href="probes_2test4_2README-source.html">[code]</a></td><td class="indexvalue"></td></tr> - <tr><td class="indexkey">probes/where_func/<b>kprobe_where_funct.c</b> <a href="kprobe__where__funct_8c-source.html">[code]</a></td><td class="indexvalue"></td></tr> - <tr><td class="indexkey">probes/where_func/<b>README</b> <a href="probes_2where__func_2README-source.html">[code]</a></td><td class="indexvalue"></td></tr> -</table> -</body></html> diff --git a/runtime/docs/html/globals.html b/runtime/docs/html/globals.html deleted file mode 100644 index bc04b2aa..00000000 --- a/runtime/docs/html/globals.html +++ /dev/null @@ -1,95 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: Globals</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindexHL" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<div class="qindex"><a class="qindexHL" href="globals.html">All</a> | <a class="qindex" href="globals_func.html">Functions</a> | <a class="qindex" href="globals_vars.html">Variables</a> | <a class="qindex" href="globals_type.html">Typedefs</a> | <a class="qindex" href="globals_enum.html">Enumerations</a> | <a class="qindex" href="globals_defs.html">Defines</a></div> -<div class="qindex"><a class="qindex" href="#index__">_</a> | <a class="qindex" href="#index_f">f</a> | <a class="qindex" href="#index_k">k</a> | <a class="qindex" href="#index_m">m</a> | <a class="qindex" href="#index_p">p</a> | <a class="qindex" href="#index_s">s</a> | <a class="qindex" href="#index_v">v</a></div> - -<p> - -<p> -Here is a list of all documented functions, variables, defines, enums, and typedefs with links to the documentation:<h3><a class="anchor" name="index__">- _ -</a></h3><ul> -<li>_stp_alloc() -: <a class="el" href="group__alloc.html#ga1">alloc.c</a><li>_stp_calloc() -: <a class="el" href="group__alloc.html#ga2">alloc.c</a><li>_stp_copy_argv_from_user() -: <a class="el" href="group__copy.html#ga3">copy.c</a><li>_stp_copy_from_user() -: <a class="el" href="group__copy.html#ga2">copy.c</a><li>_stp_free() -: <a class="el" href="group__alloc.html#ga4">alloc.c</a><li>_stp_list_add -: <a class="el" href="group__lists.html#ga6">map.h</a><li>_stp_list_add_int64() -: <a class="el" href="group__lists.html#ga4">map.c</a><li>_stp_list_add_str() -: <a class="el" href="group__lists.html#ga2">map.c</a><li>_stp_list_add_string() -: <a class="el" href="group__lists.html#ga3">map.c</a><li>_stp_list_clear() -: <a class="el" href="group__lists.html#ga1">map.c</a><li>_stp_list_new() -: <a class="el" href="group__lists.html#ga0">map.c</a><li>_stp_list_size() -: <a class="el" href="group__lists.html#ga5">map.c</a><li>_stp_log() -: <a class="el" href="group__io.html#ga2">io.c</a><li>_stp_map_add_int64() -: <a class="el" href="group__maps.html#ga17">map.c</a><li>_stp_map_del() -: <a class="el" href="group__maps.html#ga7">map.c</a><li>_stp_map_get_int64() -: <a class="el" href="group__maps.html#ga18">map.c</a><li>_stp_map_get_stat() -: <a class="el" href="group__maps.html#ga23">map.c</a><li>_stp_map_get_str() -: <a class="el" href="group__maps.html#ga21">map.c</a><li>_stp_map_iter() -: <a class="el" href="group__maps.html#ga6">map.c</a><li>_stp_map_key -: <a class="el" href="group__maps.html#ga30">map.h</a><li>_stp_map_key2 -: <a class="el" href="group__maps.html#ga29">map.h</a><li>_stp_map_key_del() -: <a class="el" href="group__maps.html#ga4">map.c</a><li>_stp_map_key_long() -: <a class="el" href="group__maps.html#ga13">map.c</a><li>_stp_map_key_long_long() -: <a class="el" href="group__maps.html#ga8">map.c</a><li>_stp_map_key_long_str() -: <a class="el" href="group__maps.html#ga11">map.c</a><li>_stp_map_key_str() -: <a class="el" href="group__maps.html#ga12">map.c</a><li>_stp_map_key_str_long() -: <a class="el" href="group__maps.html#ga10">map.c</a><li>_stp_map_key_str_str() -: <a class="el" href="group__maps.html#ga9">map.c</a><li>_stp_map_new() -: <a class="el" href="group__maps.html#ga2">map.c</a><li>_stp_map_set -: <a class="el" href="group__maps.html#ga31">map.h</a><li>_stp_map_set_int64() -: <a class="el" href="group__maps.html#ga16">map.c</a><li>_stp_map_set_stat() -: <a class="el" href="group__maps.html#ga22">map.c</a><li>_stp_map_set_str() -: <a class="el" href="group__maps.html#ga19">map.c</a><li>_stp_map_set_string() -: <a class="el" href="group__maps.html#ga20">map.c</a><li>_stp_map_start() -: <a class="el" href="group__maps.html#ga5">map.c</a><li>_stp_map_stat_add() -: <a class="el" href="group__maps.html#ga24">map.c</a><li>_stp_netlink_close() -: <a class="el" href="group__io.html#ga8">io.c</a><li>_stp_netlink_open() -: <a class="el" href="group__io.html#ga7">io.c</a><li>_stp_register_jprobes() -: <a class="el" href="probes_8c.html#a3">probes.c</a><li>_stp_register_kprobes() -: <a class="el" href="probes_8c.html#a5">probes.c</a><li>_stp_ret_addr() -: <a class="el" href="group__current.html#ga0">current.c</a><li>_stp_sprintf() -: <a class="el" href="group__string.html#ga3">string.c</a><li>_stp_stack_print() -: <a class="el" href="group__stack.html#ga6">stack.c</a><li>_stp_stack_sprint() -: <a class="el" href="group__stack.html#ga7">stack.c</a><li>_stp_string_cat -: <a class="el" href="group__string.html#ga9">string.c</a><li>_stp_string_cat_cstr() -: <a class="el" href="group__string.html#ga5">string.c</a><li>_stp_string_cat_string() -: <a class="el" href="group__string.html#ga6">string.c</a><li>_stp_string_from_user() -: <a class="el" href="group__copy.html#ga1">copy.c</a><li>_stp_string_init() -: <a class="el" href="group__string.html#ga2">string.c</a><li>_stp_string_ptr() -: <a class="el" href="group__string.html#ga7">string.c</a><li>_stp_strncpy_from_user() -: <a class="el" href="group__copy.html#ga0">copy.c</a><li>_stp_unregister_jprobes() -: <a class="el" href="probes_8c.html#a2">probes.c</a><li>_stp_unregister_kprobes() -: <a class="el" href="probes_8c.html#a4">probes.c</a><li>_stp_valloc() -: <a class="el" href="group__alloc.html#ga3">alloc.c</a><li>_stp_vfree() -: <a class="el" href="group__alloc.html#ga5">alloc.c</a><li>_stp_vsprintf() -: <a class="el" href="group__string.html#ga4">string.c</a></ul> -<h3><a class="anchor" name="index_f">- f -</a></h3><ul> -<li>foreach -: <a class="el" href="group__maps.html#ga32">map.h</a></ul> -<h3><a class="anchor" name="index_k">- k -</a></h3><ul> -<li>key1int -: <a class="el" href="group__maps.html#ga27">map.h</a><li>key1str -: <a class="el" href="group__maps.html#ga25">map.h</a><li>key2int -: <a class="el" href="group__maps.html#ga28">map.h</a><li>key2str -: <a class="el" href="group__maps.html#ga26">map.h</a><li>keytype -: <a class="el" href="group__maps.html#ga33">map.h</a></ul> -<h3><a class="anchor" name="index_m">- m -</a></h3><ul> -<li>MAP -: <a class="el" href="group__maps.html#ga1">map.h</a></ul> -<h3><a class="anchor" name="index_p">- p -</a></h3><ul> -<li>packed -: <a class="el" href="group__maps.html#ga0">map.h</a></ul> -<h3><a class="anchor" name="index_s">- s -</a></h3><ul> -<li>STP_LOG_BUF_LEN -: <a class="el" href="group__io.html#ga9">io.c</a><li>STP_STRING_SIZE -: <a class="el" href="group__string.html#ga8">string.c</a></ul> -<h3><a class="anchor" name="index_v">- v -</a></h3><ul> -<li>valtype -: <a class="el" href="group__maps.html#ga34">map.h</a></ul> -</body></html> diff --git a/runtime/docs/html/globals_defs.html b/runtime/docs/html/globals_defs.html deleted file mode 100644 index 93e7a777..00000000 --- a/runtime/docs/html/globals_defs.html +++ /dev/null @@ -1,25 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: Globals - Defines</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindexHL" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<div class="qindex"><a class="qindex" href="globals.html">All</a> | <a class="qindex" href="globals_func.html">Functions</a> | <a class="qindex" href="globals_vars.html">Variables</a> | <a class="qindex" href="globals_type.html">Typedefs</a> | <a class="qindex" href="globals_enum.html">Enumerations</a> | <a class="qindexHL" href="globals_defs.html">Defines</a></div> - -<p> -<ul> -<li>_stp_list_add -: <a class="el" href="group__lists.html#ga6">map.h</a><li>_stp_map_key -: <a class="el" href="group__maps.html#ga30">map.h</a><li>_stp_map_key2 -: <a class="el" href="group__maps.html#ga29">map.h</a><li>_stp_map_set -: <a class="el" href="group__maps.html#ga31">map.h</a><li>_stp_string_cat -: <a class="el" href="group__string.html#ga9">string.c</a><li>foreach -: <a class="el" href="group__maps.html#ga32">map.h</a><li>key1int -: <a class="el" href="group__maps.html#ga27">map.h</a><li>key1str -: <a class="el" href="group__maps.html#ga25">map.h</a><li>key2int -: <a class="el" href="group__maps.html#ga28">map.h</a><li>key2str -: <a class="el" href="group__maps.html#ga26">map.h</a><li>STP_LOG_BUF_LEN -: <a class="el" href="group__io.html#ga9">io.c</a><li>STP_STRING_SIZE -: <a class="el" href="group__string.html#ga8">string.c</a></ul> -</body></html> diff --git a/runtime/docs/html/globals_enum.html b/runtime/docs/html/globals_enum.html deleted file mode 100644 index f283f502..00000000 --- a/runtime/docs/html/globals_enum.html +++ /dev/null @@ -1,15 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: Globals - Enumerations</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindexHL" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<div class="qindex"><a class="qindex" href="globals.html">All</a> | <a class="qindex" href="globals_func.html">Functions</a> | <a class="qindex" href="globals_vars.html">Variables</a> | <a class="qindex" href="globals_type.html">Typedefs</a> | <a class="qindexHL" href="globals_enum.html">Enumerations</a> | <a class="qindex" href="globals_defs.html">Defines</a></div> - -<p> -<ul> -<li>keytype -: <a class="el" href="group__maps.html#ga33">map.h</a><li>valtype -: <a class="el" href="group__maps.html#ga34">map.h</a></ul> -</body></html> diff --git a/runtime/docs/html/globals_func.html b/runtime/docs/html/globals_func.html deleted file mode 100644 index a74e4ad0..00000000 --- a/runtime/docs/html/globals_func.html +++ /dev/null @@ -1,67 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: Globals - Functions</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindexHL" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<div class="qindex"><a class="qindex" href="globals.html">All</a> | <a class="qindexHL" href="globals_func.html">Functions</a> | <a class="qindex" href="globals_vars.html">Variables</a> | <a class="qindex" href="globals_type.html">Typedefs</a> | <a class="qindex" href="globals_enum.html">Enumerations</a> | <a class="qindex" href="globals_defs.html">Defines</a></div> -<div class="qindex"><a class="qindex" href="#index__">_</a></div> - -<p> - -<p> -<h3><a class="anchor" name="index__">- _ -</a></h3><ul> -<li>_stp_alloc() -: <a class="el" href="group__alloc.html#ga1">alloc.c</a><li>_stp_calloc() -: <a class="el" href="group__alloc.html#ga2">alloc.c</a><li>_stp_copy_argv_from_user() -: <a class="el" href="group__copy.html#ga3">copy.c</a><li>_stp_copy_from_user() -: <a class="el" href="group__copy.html#ga2">copy.c</a><li>_stp_free() -: <a class="el" href="group__alloc.html#ga4">alloc.c</a><li>_stp_list_add_int64() -: <a class="el" href="group__lists.html#ga4">map.c</a><li>_stp_list_add_str() -: <a class="el" href="group__lists.html#ga2">map.c</a><li>_stp_list_add_string() -: <a class="el" href="group__lists.html#ga3">map.c</a><li>_stp_list_clear() -: <a class="el" href="group__lists.html#ga1">map.c</a><li>_stp_list_new() -: <a class="el" href="group__lists.html#ga0">map.c</a><li>_stp_list_size() -: <a class="el" href="group__lists.html#ga5">map.c</a><li>_stp_log() -: <a class="el" href="group__io.html#ga2">io.c</a><li>_stp_map_add_int64() -: <a class="el" href="group__maps.html#ga17">map.c</a><li>_stp_map_del() -: <a class="el" href="group__maps.html#ga7">map.c</a><li>_stp_map_get_int64() -: <a class="el" href="group__maps.html#ga18">map.c</a><li>_stp_map_get_stat() -: <a class="el" href="group__maps.html#ga23">map.c</a><li>_stp_map_get_str() -: <a class="el" href="group__maps.html#ga21">map.c</a><li>_stp_map_iter() -: <a class="el" href="group__maps.html#ga6">map.c</a><li>_stp_map_key_del() -: <a class="el" href="group__maps.html#ga4">map.c</a><li>_stp_map_key_long() -: <a class="el" href="group__maps.html#ga13">map.c</a><li>_stp_map_key_long_long() -: <a class="el" href="group__maps.html#ga8">map.c</a><li>_stp_map_key_long_str() -: <a class="el" href="group__maps.html#ga11">map.c</a><li>_stp_map_key_str() -: <a class="el" href="group__maps.html#ga12">map.c</a><li>_stp_map_key_str_long() -: <a class="el" href="group__maps.html#ga10">map.c</a><li>_stp_map_key_str_str() -: <a class="el" href="group__maps.html#ga9">map.c</a><li>_stp_map_new() -: <a class="el" href="group__maps.html#ga2">map.c</a><li>_stp_map_set_int64() -: <a class="el" href="group__maps.html#ga16">map.c</a><li>_stp_map_set_stat() -: <a class="el" href="group__maps.html#ga22">map.c</a><li>_stp_map_set_str() -: <a class="el" href="group__maps.html#ga19">map.c</a><li>_stp_map_set_string() -: <a class="el" href="group__maps.html#ga20">map.c</a><li>_stp_map_start() -: <a class="el" href="group__maps.html#ga5">map.c</a><li>_stp_map_stat_add() -: <a class="el" href="group__maps.html#ga24">map.c</a><li>_stp_netlink_close() -: <a class="el" href="group__io.html#ga8">io.c</a><li>_stp_netlink_open() -: <a class="el" href="group__io.html#ga7">io.c</a><li>_stp_register_jprobes() -: <a class="el" href="probes_8c.html#a3">probes.c</a><li>_stp_register_kprobes() -: <a class="el" href="probes_8c.html#a5">probes.c</a><li>_stp_ret_addr() -: <a class="el" href="group__current.html#ga0">current.c</a><li>_stp_sprintf() -: <a class="el" href="group__string.html#ga3">string.c</a><li>_stp_stack_print() -: <a class="el" href="group__stack.html#ga6">stack.c</a><li>_stp_stack_sprint() -: <a class="el" href="group__stack.html#ga7">stack.c</a><li>_stp_string_cat_cstr() -: <a class="el" href="group__string.html#ga5">string.c</a><li>_stp_string_cat_string() -: <a class="el" href="group__string.html#ga6">string.c</a><li>_stp_string_from_user() -: <a class="el" href="group__copy.html#ga1">copy.c</a><li>_stp_string_init() -: <a class="el" href="group__string.html#ga2">string.c</a><li>_stp_string_ptr() -: <a class="el" href="group__string.html#ga7">string.c</a><li>_stp_strncpy_from_user() -: <a class="el" href="group__copy.html#ga0">copy.c</a><li>_stp_unregister_jprobes() -: <a class="el" href="probes_8c.html#a2">probes.c</a><li>_stp_unregister_kprobes() -: <a class="el" href="probes_8c.html#a4">probes.c</a><li>_stp_valloc() -: <a class="el" href="group__alloc.html#ga3">alloc.c</a><li>_stp_vfree() -: <a class="el" href="group__alloc.html#ga5">alloc.c</a><li>_stp_vsprintf() -: <a class="el" href="group__string.html#ga4">string.c</a></ul> -</body></html> diff --git a/runtime/docs/html/globals_type.html b/runtime/docs/html/globals_type.html deleted file mode 100644 index 87f1e8a8..00000000 --- a/runtime/docs/html/globals_type.html +++ /dev/null @@ -1,14 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: Globals - Typedefs</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindexHL" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<div class="qindex"><a class="qindex" href="globals.html">All</a> | <a class="qindex" href="globals_func.html">Functions</a> | <a class="qindex" href="globals_vars.html">Variables</a> | <a class="qindexHL" href="globals_type.html">Typedefs</a> | <a class="qindex" href="globals_enum.html">Enumerations</a> | <a class="qindex" href="globals_defs.html">Defines</a></div> - -<p> -<ul> -<li>MAP -: <a class="el" href="group__maps.html#ga1">map.h</a></ul> -</body></html> diff --git a/runtime/docs/html/globals_vars.html b/runtime/docs/html/globals_vars.html deleted file mode 100644 index 8c4140c4..00000000 --- a/runtime/docs/html/globals_vars.html +++ /dev/null @@ -1,14 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: Globals - Variables</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindexHL" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<div class="qindex"><a class="qindex" href="globals.html">All</a> | <a class="qindex" href="globals_func.html">Functions</a> | <a class="qindexHL" href="globals_vars.html">Variables</a> | <a class="qindex" href="globals_type.html">Typedefs</a> | <a class="qindex" href="globals_enum.html">Enumerations</a> | <a class="qindex" href="globals_defs.html">Defines</a></div> - -<p> -<ul> -<li>packed -: <a class="el" href="group__maps.html#ga0">map.h</a></ul> -</body></html> diff --git a/runtime/docs/html/group__alloc.html b/runtime/docs/html/group__alloc.html deleted file mode 100644 index b1151b86..00000000 --- a/runtime/docs/html/group__alloc.html +++ /dev/null @@ -1,247 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: Memory Functions</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1>Memory Functions</h1>Basic malloc/calloc/free functions. -<a href="#_details">More...</a><table border="0" cellpadding="0" cellspacing="0"> -<tr><td></td></tr> -<tr><td colspan="2"><br><h2>Enumerations</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">enum </td><td class="memItemRight" valign="bottom"><b>errorcode</b> { <b>ERR_NONE</b> = 0, -<b>ERR_NO_MEM</b> - }</td></tr> - -<tr><td colspan="2"><br><h2>Functions</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__alloc.html#ga1">_stp_alloc</a> (size_t len)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Allocates memory within a probe. <a href="#ga1"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__alloc.html#ga2">_stp_calloc</a> (size_t len)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Allocates and clears memory within a probe. <a href="#ga2"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__alloc.html#ga3">_stp_valloc</a> (size_t len)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Allocates and clears memory outside a probe. <a href="#ga3"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__alloc.html#ga4">_stp_free</a> (void *ptr)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Frees memory allocated by _stp_alloc or _stp_calloc. <a href="#ga4"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__alloc.html#ga5">_stp_vfree</a> (void *ptr)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Frees memory allocated by _stp_valloc. <a href="#ga5"></a><br></td></tr> -<tr><td colspan="2"><br><h2>Variables</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="ga0" doxytag="alloc::_stp_error"></a> -enum errorcode </td><td class="memItemRight" valign="bottom"><b>_stp_error</b> = ERR_NONE</td></tr> - -</table> -<hr><a name="_details"></a><h2>Detailed Description</h2> -Basic malloc/calloc/free functions. -<p> -These will be changed so that memory allocation errors will call a handler. The default will send a signal to the user-space daemon that will trigger the module to be unloaded. <p> -<dl compact><dt><b><a class="el" href="todo.html#_todo000001">Todo:</a></b></dt><dd>Need error handling for memory allocations</dd></dl> -<p> -<dl compact><dt><b><a class="el" href="todo.html#_todo000001">Todo:</a></b></dt><dd>Some of these currently use kmalloc (GFP_ATOMIC) for small allocations. This should be evaluated for performance and stability.</dd></dl> -<hr><h2>Function Documentation</h2> -<a class="anchor" name="ga1" doxytag="alloc.c::_stp_alloc"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">void* _stp_alloc </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top">size_t </td> - <td class="mdname1" valign="top" nowrap> <em>len</em> </td> - <td class="md" valign="top"> ) </td> - <td class="md" nowrap></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Allocates memory within a probe. -<p> -This is used for small allocations from within a running probe where the process cannot sleep. <dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>len</em> </td><td>Number of bytes to allocate. </td></tr> - </table> -</dl> -<dl compact><dt><b>Returns:</b></dt><dd>a valid pointer on success or NULL on failure. </dd></dl> -<dl compact><dt><b><a class="el" href="bug.html#_bug000001">Bug:</a></b></dt><dd>Currently uses kmalloc (GFP_ATOMIC). </dd></dl> - -<p> -Definition at line <a class="el" href="alloc_8c-source.html#l00031">31</a> of file <a class="el" href="alloc_8c-source.html">alloc.c</a>. -<p> -Referenced by <a class="el" href="alloc_8c-source.html#l00047">_stp_calloc()</a>, and <a class="el" href="map_8c-source.html#l00590">_stp_map_set_str()</a>. </td> - </tr> -</table> -<a class="anchor" name="ga2" doxytag="alloc.c::_stp_calloc"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">void* _stp_calloc </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top">size_t </td> - <td class="mdname1" valign="top" nowrap> <em>len</em> </td> - <td class="md" valign="top"> ) </td> - <td class="md" nowrap></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Allocates and clears memory within a probe. -<p> -This is used for small allocations from within a running probe where the process cannot sleep. <dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>len</em> </td><td>Number of bytes to allocate. </td></tr> - </table> -</dl> -<dl compact><dt><b>Returns:</b></dt><dd>a valid pointer on success or NULL on failure. </dd></dl> -<dl compact><dt><b><a class="el" href="bug.html#_bug000002">Bug:</a></b></dt><dd>Currently uses kmalloc (GFP_ATOMIC). </dd></dl> - -<p> -Definition at line <a class="el" href="alloc_8c-source.html#l00047">47</a> of file <a class="el" href="alloc_8c-source.html">alloc.c</a>. -<p> -References <a class="el" href="alloc_8c-source.html#l00031">_stp_alloc()</a>. -<p> -Referenced by <a class="el" href="map_8c-source.html#l00691">_stp_map_set_stat()</a>, and <a class="el" href="map_8c-source.html#l00590">_stp_map_set_str()</a>. </td> - </tr> -</table> -<a class="anchor" name="ga4" doxytag="alloc.c::_stp_free"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">void _stp_free </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top">void * </td> - <td class="mdname1" valign="top" nowrap> <em>ptr</em> </td> - <td class="md" valign="top"> ) </td> - <td class="md" nowrap></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Frees memory allocated by _stp_alloc or _stp_calloc. -<p> -<dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>ptr</em> </td><td>pointer to memory to free </td></tr> - </table> -</dl> - -<p> -Definition at line <a class="el" href="alloc_8c-source.html#l00076">76</a> of file <a class="el" href="alloc_8c-source.html">alloc.c</a>. -<p> -Referenced by <a class="el" href="map_8c-source.html#l00831">_stp_list_clear()</a>, <a class="el" href="map_8c-source.html#l00118">_stp_map_key_del()</a>, and <a class="el" href="map_8c-source.html#l00590">_stp_map_set_str()</a>. </td> - </tr> -</table> -<a class="anchor" name="ga3" doxytag="alloc.c::_stp_valloc"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">void* _stp_valloc </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top">size_t </td> - <td class="mdname1" valign="top" nowrap> <em>len</em> </td> - <td class="md" valign="top"> ) </td> - <td class="md" nowrap></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Allocates and clears memory outside a probe. -<p> -This is typically used in the module initialization to allocate new maps, lists, etc. <dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>len</em> </td><td>Number of bytes to allocate. </td></tr> - </table> -</dl> -<dl compact><dt><b>Returns:</b></dt><dd>a valid pointer on success or NULL on failure. </dd></dl> - -<p> -Definition at line <a class="el" href="alloc_8c-source.html#l00062">62</a> of file <a class="el" href="alloc_8c-source.html">alloc.c</a>. -<p> -Referenced by <a class="el" href="map_8c-source.html#l00057">_stp_map_new()</a>. </td> - </tr> -</table> -<a class="anchor" name="ga5" doxytag="alloc.c::_stp_vfree"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">void _stp_vfree </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top">void * </td> - <td class="mdname1" valign="top" nowrap> <em>ptr</em> </td> - <td class="md" valign="top"> ) </td> - <td class="md" nowrap></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Frees memory allocated by _stp_valloc. -<p> -<dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>ptr</em> </td><td>pointer to memory to free </td></tr> - </table> -</dl> - -<p> -Definition at line <a class="el" href="alloc_8c-source.html#l00086">86</a> of file <a class="el" href="alloc_8c-source.html">alloc.c</a>. -<p> -Referenced by <a class="el" href="map_8c-source.html#l00205">_stp_map_del()</a>. </td> - </tr> -</table> -</body></html> diff --git a/runtime/docs/html/group__copy.html b/runtime/docs/html/group__copy.html deleted file mode 100644 index 72321187..00000000 --- a/runtime/docs/html/group__copy.html +++ /dev/null @@ -1,263 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: Functions to copy from user space.</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1>Functions to copy from user space.</h1>Functions to copy from user space. -<a href="#_details">More...</a><table border="0" cellpadding="0" cellspacing="0"> -<tr><td></td></tr> -<tr><td colspan="2"><br><h2>Functions</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">long </td><td class="memItemRight" valign="bottom"><a class="el" href="group__copy.html#ga0">_stp_strncpy_from_user</a> (char *dst, const char __user *src, long count)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Copy a NULL-terminated string from userspace. <a href="#ga0"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__copy.html#ga1">_stp_string_from_user</a> (String str, const char __user *src, long count)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Copy a String from userspace. <a href="#ga1"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">unsigned long </td><td class="memItemRight" valign="bottom"><a class="el" href="group__copy.html#ga2">_stp_copy_from_user</a> (char *dst, const char __user *src, unsigned long count)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Copy a block of data from user space. <a href="#ga2"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__copy.html#ga3">_stp_copy_argv_from_user</a> (<a class="el" href="group__maps.html#ga1">MAP</a> list, char __user *__user *argv)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Copy an argv from user space to a List. <a href="#ga3"></a><br></td></tr> -</table> -<hr><a name="_details"></a><h2>Detailed Description</h2> -Functions to copy from user space. -<p> -None of these functions will sleep (for example to allow pages to be swapped in). It is possible (although rare) that the data in user space will not present and these functions will return an error. <hr><h2>Function Documentation</h2> -<a class="anchor" name="ga3" doxytag="copy.c::_stp_copy_argv_from_user"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">int _stp_copy_argv_from_user </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top"><a class="el" href="group__maps.html#ga1">MAP</a> </td> - <td class="mdname" nowrap> <em>list</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>char __user *__user * </td> - <td class="mdname" nowrap> <em>argv</em></td> - </tr> - <tr> - <td class="md"></td> - <td class="md">) </td> - <td class="md" colspan="2"></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Copy an argv from user space to a List. -<p> -<dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>list</em> </td><td>A list. </td></tr> - <tr><td valign="top"></td><td valign="top"><em>argv</em> </td><td>Source argv, in user space. </td></tr> - </table> -</dl> -<dl compact><dt><b>Returns:</b></dt><dd>number of elements in <em>list</em></dd></dl> -<b>Example:</b> <div class="fragment"><pre class="fragment"><a class="code" href="group__maps.html#ga1">MAP</a> arglist ; - -<span class="keywordtype">int</span> inst_do_execve (<span class="keywordtype">char</span> * filename, <span class="keywordtype">char</span> __user *__user *argv, <span class="keywordtype">char</span> __user *__user *envp, <span class="keyword">struct</span> pt_regs * regs) -{ - <span class="keyword">struct </span>map_node_str *ptr; - - <a class="code" href="group__lists.html#ga1">_stp_list_clear</a> (arglist); - <a class="code" href="group__copy.html#ga3">_stp_copy_argv_from_user</a> (arglist, argv); - - <a class="code" href="group__maps.html#ga32">foreach</a> (arglist, ptr) - printk ("%s ", ptr->str); - printk ("\n"); -} -</pre></div> -<p> -Definition at line <a class="el" href="copy_8c-source.html#l00154">154</a> of file <a class="el" href="copy_8c-source.html">copy.c</a>. -<p> -References <a class="el" href="map_8c-source.html#l00872">_stp_list_add_str()</a>, and <a class="el" href="copy_8c-source.html#l00096">_stp_strncpy_from_user()</a>. </td> - </tr> -</table> -<a class="anchor" name="ga2" doxytag="copy.c::_stp_copy_from_user"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">unsigned long _stp_copy_from_user </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top">char * </td> - <td class="mdname" nowrap> <em>dst</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>const char __user * </td> - <td class="mdname" nowrap> <em>src</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>unsigned long </td> - <td class="mdname" nowrap> <em>count</em></td> - </tr> - <tr> - <td class="md"></td> - <td class="md">) </td> - <td class="md" colspan="2"></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Copy a block of data from user space. -<p> -If some data could not be copied, this function will pad the copied data to the requested size using zero bytes.<p> -<dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>dst</em> </td><td>Destination address, in kernel space. </td></tr> - <tr><td valign="top"></td><td valign="top"><em>src</em> </td><td>Source address, in user space. </td></tr> - <tr><td valign="top"></td><td valign="top"><em>count</em> </td><td>Number of bytes to copy. </td></tr> - </table> -</dl> -<dl compact><dt><b>Returns:</b></dt><dd>number of bytes that could not be copied. On success, this will be zero. </dd></dl> - -<p> -Definition at line <a class="el" href="copy_8c-source.html#l00139">139</a> of file <a class="el" href="copy_8c-source.html">copy.c</a>. </td> - </tr> -</table> -<a class="anchor" name="ga1" doxytag="copy.c::_stp_string_from_user"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">void _stp_string_from_user </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top">String </td> - <td class="mdname" nowrap> <em>str</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>const char __user * </td> - <td class="mdname" nowrap> <em>src</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>long </td> - <td class="mdname" nowrap> <em>count</em></td> - </tr> - <tr> - <td class="md"></td> - <td class="md">) </td> - <td class="md" colspan="2"></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Copy a String from userspace. -<p> -Copies a string of up to <em>count</em> bytes from userspace into a String. If access to userspace fails, returns -EFAULT (some data may have been copied). <dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>str</em> </td><td>Destination String. </td></tr> - <tr><td valign="top"></td><td valign="top"><em>src</em> </td><td>Source address, in user space. </td></tr> - <tr><td valign="top"></td><td valign="top"><em>count</em> </td><td>Maximum number of bytes to copy, including the trailing NULL. </td></tr> - </table> -</dl> - -<p> -Definition at line <a class="el" href="copy_8c-source.html#l00113">113</a> of file <a class="el" href="copy_8c-source.html">copy.c</a>. -<p> -References <a class="el" href="string_8c-source.html#l00020">STP_STRING_SIZE</a>. </td> - </tr> -</table> -<a class="anchor" name="ga0" doxytag="copy.c::_stp_strncpy_from_user"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">long _stp_strncpy_from_user </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top">char * </td> - <td class="mdname" nowrap> <em>dst</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>const char __user * </td> - <td class="mdname" nowrap> <em>src</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>long </td> - <td class="mdname" nowrap> <em>count</em></td> - </tr> - <tr> - <td class="md"></td> - <td class="md">) </td> - <td class="md" colspan="2"></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Copy a NULL-terminated string from userspace. -<p> -On success, returns the length of the string (not including the trailing NULL).<p> -If access to userspace fails, returns -EFAULT (some data may have been copied). <dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>dst</em> </td><td>Destination address, in kernel space. This buffer must be at least <em>count</em> bytes long. </td></tr> - <tr><td valign="top"></td><td valign="top"><em>src</em> </td><td>Source address, in user space. </td></tr> - <tr><td valign="top"></td><td valign="top"><em>count</em> </td><td>Maximum number of bytes to copy, including the trailing NULL.</td></tr> - </table> -</dl> -If <em>count</em> is smaller than the length of the string, copies <em>count</em> bytes and returns <em>count</em>. <p> -<dl compact><dt><b><a class="el" href="deprecated.html#_deprecated000001">Deprecated:</a></b></dt><dd>I can't think of why you wouldn't use <a class="el" href="group__copy.html#ga1">_stp_string_from_user()</a> instead. </dd></dl> - -<p> -Definition at line <a class="el" href="copy_8c-source.html#l00096">96</a> of file <a class="el" href="copy_8c-source.html">copy.c</a>. -<p> -Referenced by <a class="el" href="copy_8c-source.html#l00154">_stp_copy_argv_from_user()</a>. </td> - </tr> -</table> -</body></html> diff --git a/runtime/docs/html/group__current.html b/runtime/docs/html/group__current.html deleted file mode 100644 index 03008852..00000000 --- a/runtime/docs/html/group__current.html +++ /dev/null @@ -1,59 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: Current State</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1>Current State</h1>Functions to get the current state. -<a href="#_details">More...</a><table border="0" cellpadding="0" cellspacing="0"> -<tr><td></td></tr> -<tr><td colspan="2"><br><h2>Functions</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">unsigned long </td><td class="memItemRight" valign="bottom"><a class="el" href="group__current.html#ga0">_stp_ret_addr</a> (struct pt_regs *regs)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the current return address. <a href="#ga0"></a><br></td></tr> -</table> -<hr><a name="_details"></a><h2>Detailed Description</h2> -Functions to get the current state. -<p> -<hr><h2>Function Documentation</h2> -<a class="anchor" name="ga0" doxytag="current.c::_stp_ret_addr"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">unsigned long _stp_ret_addr </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top">struct pt_regs * </td> - <td class="mdname1" valign="top" nowrap> <em>regs</em> </td> - <td class="md" valign="top"> ) </td> - <td class="md" nowrap></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Get the current return address. -<p> -Call from kprobes (not jprobes). <dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>regs</em> </td><td>The pt_regs saved by the kprobe. </td></tr> - </table> -</dl> -<dl compact><dt><b>Returns:</b></dt><dd>The return address saved in esp or rsp. </dd></dl> -<dl compact><dt><b>Note:</b></dt><dd>i386 and x86_64 only so far. </dd></dl> - -<p> -Definition at line <a class="el" href="current_8c-source.html#l00021">21</a> of file <a class="el" href="current_8c-source.html">current.c</a>. </td> - </tr> -</table> -</body></html> diff --git a/runtime/docs/html/group__io.html b/runtime/docs/html/group__io.html deleted file mode 100644 index 76051d30..00000000 --- a/runtime/docs/html/group__io.html +++ /dev/null @@ -1,148 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: I/O</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1>I/O</h1>I/O functions. -<a href="#_details">More...</a><table border="0" cellpadding="0" cellspacing="0"> -<tr><td></td></tr> -<tr><td colspan="2"><br><h2>Defines</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="ga9" doxytag="io::STP_LOG_BUF_LEN"></a> -#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__io.html#ga9">STP_LOG_BUF_LEN</a> 2047</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">private buffer for <a class="el" href="group__io.html#ga2">_stp_log()</a> <br></td></tr> -<tr><td colspan="2"><br><h2>Functions</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__io.html#ga2">_stp_log</a> (const char *fmt,...)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Logs Data. <a href="#ga2"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__io.html#ga7">_stp_netlink_open</a> (void)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Opens netlink and relayfs connections to stpd. <a href="#ga7"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__io.html#ga8">_stp_netlink_close</a> (void)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Closes netlink and relayfs connections to stpd. <a href="#ga8"></a><br></td></tr> -</table> -<hr><a name="_details"></a><h2>Detailed Description</h2> -I/O functions. -<p> -<hr><h2>Function Documentation</h2> -<a class="anchor" name="ga2" doxytag="io.c::_stp_log"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">void _stp_log </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top">const char * </td> - <td class="mdname" nowrap> <em>fmt</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap> </td> - <td class="mdname" nowrap> <em>...</em></td> - </tr> - <tr> - <td class="md"></td> - <td class="md">) </td> - <td class="md" colspan="2"></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Logs Data. -<p> -This function prints to the system log if stpd has not connected yet. Otherwise it sends the message immediately to stpd. <dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>fmt</em> </td><td>A variable number of args. </td></tr> - </table> -</dl> -<dl compact><dt><b>Note:</b></dt><dd>Lines are limited in length by printk buffer. If there is no newline in the format string, then other syslog output could get appended to the SystemTap line. </dd></dl> -<dl compact><dt><b><a class="el" href="todo.html#_todo000003">Todo:</a></b></dt><dd>Evaluate if this function is necessary. </dd></dl> - -<p> -Definition at line <a class="el" href="io_8c-source.html#l00029">29</a> of file <a class="el" href="io_8c-source.html">io.c</a>. -<p> -References <a class="el" href="io_8c-source.html#l00016">STP_LOG_BUF_LEN</a>. -<p> -Referenced by <a class="el" href="map_8c-source.html#l00831">_stp_list_clear()</a>, <a class="el" href="probes_8c-source.html#l00034">_stp_register_jprobes()</a>, <a class="el" href="probes_8c-source.html#l00079">_stp_register_kprobes()</a>, <a class="el" href="stack_8c-source.html#l00171">_stp_stack_sprint()</a>, <a class="el" href="string_8c-source.html#l00042">_stp_string_init()</a>, <a class="el" href="probes_8c-source.html#l00020">_stp_unregister_jprobes()</a>, and <a class="el" href="probes_8c-source.html#l00065">_stp_unregister_kprobes()</a>. </td> - </tr> -</table> -<a class="anchor" name="ga8" doxytag="io.c::_stp_netlink_close"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">void _stp_netlink_close </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top">void </td> - <td class="mdname1" valign="top" nowrap> </td> - <td class="md" valign="top"> ) </td> - <td class="md" nowrap></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Closes netlink and relayfs connections to stpd. -<p> -This must be called after all I/O is done, probably at the end of module cleanup. <dl compact><dt><b>Returns:</b></dt><dd>0 on success. -1 if there is a problem establishing a connection. </dd></dl> - -<p> -Definition at line <a class="el" href="io_8c-source.html#l00103">103</a> of file <a class="el" href="io_8c-source.html">io.c</a>. </td> - </tr> -</table> -<a class="anchor" name="ga7" doxytag="io.c::_stp_netlink_open"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">int _stp_netlink_open </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top">void </td> - <td class="mdname1" valign="top" nowrap> </td> - <td class="md" valign="top"> ) </td> - <td class="md" nowrap></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Opens netlink and relayfs connections to stpd. -<p> -This must be called before any I/O is done, probably at the start of module initialization. -<p> -Definition at line <a class="el" href="io_8c-source.html#l00087">87</a> of file <a class="el" href="io_8c-source.html">io.c</a>. </td> - </tr> -</table> -</body></html> diff --git a/runtime/docs/html/group__lists.html b/runtime/docs/html/group__lists.html deleted file mode 100644 index 30b83a00..00000000 --- a/runtime/docs/html/group__lists.html +++ /dev/null @@ -1,378 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: Lists</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1>Lists</h1>Lists are special cases of maps. -<a href="#_details">More...</a><table border="0" cellpadding="0" cellspacing="0"> -<tr><td></td></tr> -<tr><td colspan="2"><br><h2>Defines</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__lists.html#ga6">_stp_list_add</a>(map, val)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Macro to call the proper _stp_list_add function based on the types of the argument. <a href="#ga6"></a><br></td></tr> -<tr><td colspan="2"><br><h2>Functions</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="group__maps.html#ga1">MAP</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__lists.html#ga0">_stp_list_new</a> (unsigned max_entries, enum <a class="el" href="group__maps.html#ga34">valtype</a> type)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Create a new list. <a href="#ga0"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__lists.html#ga1">_stp_list_clear</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Clears a list. <a href="#ga1"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__lists.html#ga2">_stp_list_add_str</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map, char *str)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Adds a C string to a list. <a href="#ga2"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__lists.html#ga3">_stp_list_add_string</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map, String str)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Adds a String to a list. <a href="#ga3"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__lists.html#ga4">_stp_list_add_int64</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map, int64_t val)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Adds an int64 to a list. <a href="#ga4"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__lists.html#ga5">_stp_list_size</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the number of elements in a list. <a href="#ga5"></a><br></td></tr> -</table> -<hr><a name="_details"></a><h2>Detailed Description</h2> -Lists are special cases of maps. -<p> -<b>Example:</b> <div class="fragment"><pre class="fragment"> -<span class="keyword">struct </span>map_node_str *ptr; - -<a class="code" href="group__maps.html#ga1">MAP</a> map = <a class="code" href="group__lists.html#ga0">_stp_list_new</a>(10, STRING); - -<span class="keywordflow">for</span> (i = 0; i < 10; i++) { - sprintf (buf, <span class="stringliteral">"Item%d"</span>, i); - <a class="code" href="group__lists.html#ga6">_stp_list_add</a> (map, buf); - } - -<a class="code" href="group__maps.html#ga32">foreach</a> (map, ptr) - printf ("map[%ld] = %s\n", key1int(ptr), ptr->str); - - -</pre></div> <hr><h2>Define Documentation</h2> -<a class="anchor" name="ga6" doxytag="map.h::_stp_list_add"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">#define _stp_list_add </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top">map, <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>val </td> - <td class="mdname1" valign="top" nowrap> </td> - <td class="md" valign="top"> ) </td> - <td class="md" nowrap></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -<b>Value:</b><div class="fragment"><pre class="fragment">({ \ - <span class="keywordflow">if</span> (__builtin_types_compatible_p (typeof (val), <span class="keywordtype">char</span>[])) \ - <a class="code" href="group__lists.html#ga2">_stp_list_add_str</a> (map, (<span class="keywordtype">char</span> *)(val)); \ - <span class="keywordflow">else</span> <span class="keywordflow">if</span> (__builtin_types_compatible_p (typeof (val), String)) \ - <a class="code" href="group__lists.html#ga3">_stp_list_add_string</a> (map, (String)(val)); \ - <span class="keywordflow">else</span> \ - <a class="code" href="group__lists.html#ga4">_stp_list_add_int64</a> (map, (int64_t)(val)); \ - }) -</pre></div>Macro to call the proper _stp_list_add function based on the types of the argument. -<p> -<dl compact><dt><b>Note:</b></dt><dd>May cause compiler warning on some GCCs </dd></dl> - -<p> -Definition at line <a class="el" href="map_8h-source.html#l00183">183</a> of file <a class="el" href="map_8h-source.html">map.h</a>. </td> - </tr> -</table> -<hr><h2>Function Documentation</h2> -<a class="anchor" name="ga4" doxytag="map.c::_stp_list_add_int64"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">void _stp_list_add_int64 </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top"><a class="el" href="group__maps.html#ga1">MAP</a> </td> - <td class="mdname" nowrap> <em>map</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>int64_t </td> - <td class="mdname" nowrap> <em>val</em></td> - </tr> - <tr> - <td class="md"></td> - <td class="md">) </td> - <td class="md" colspan="2"><code> [inline]</code></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Adds an int64 to a list. -<p> -<dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>map</em> </td><td></td></tr> - <tr><td valign="top"></td><td valign="top"><em>val</em> </td><td></td></tr> - </table> -</dl> -<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__lists.html#ga6">_stp_list_add()</a> </dd></dl> - -<p> -Definition at line <a class="el" href="map_8c-source.html#l00896">896</a> of file <a class="el" href="map_8c-source.html">map.c</a>. -<p> -References <a class="el" href="map_8c-source.html#l00430">_stp_map_key_long()</a>, and <a class="el" href="map_8c-source.html#l00542">_stp_map_set_int64()</a>. </td> - </tr> -</table> -<a class="anchor" name="ga2" doxytag="map.c::_stp_list_add_str"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">void _stp_list_add_str </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top"><a class="el" href="group__maps.html#ga1">MAP</a> </td> - <td class="mdname" nowrap> <em>map</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>char * </td> - <td class="mdname" nowrap> <em>str</em></td> - </tr> - <tr> - <td class="md"></td> - <td class="md">) </td> - <td class="md" colspan="2"><code> [inline]</code></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Adds a C string to a list. -<p> -<dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>map</em> </td><td></td></tr> - <tr><td valign="top"></td><td valign="top"><em>str</em> </td><td></td></tr> - </table> -</dl> -<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__lists.html#ga6">_stp_list_add()</a> </dd></dl> - -<p> -Definition at line <a class="el" href="map_8c-source.html#l00872">872</a> of file <a class="el" href="map_8c-source.html">map.c</a>. -<p> -References <a class="el" href="map_8c-source.html#l00430">_stp_map_key_long()</a>, and <a class="el" href="map_8c-source.html#l00590">_stp_map_set_str()</a>. -<p> -Referenced by <a class="el" href="copy_8c-source.html#l00154">_stp_copy_argv_from_user()</a>. </td> - </tr> -</table> -<a class="anchor" name="ga3" doxytag="map.c::_stp_list_add_string"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">void _stp_list_add_string </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top"><a class="el" href="group__maps.html#ga1">MAP</a> </td> - <td class="mdname" nowrap> <em>map</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>String </td> - <td class="mdname" nowrap> <em>str</em></td> - </tr> - <tr> - <td class="md"></td> - <td class="md">) </td> - <td class="md" colspan="2"><code> [inline]</code></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Adds a String to a list. -<p> -<dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>map</em> </td><td></td></tr> - <tr><td valign="top"></td><td valign="top"><em>str</em> </td><td>String to add. </td></tr> - </table> -</dl> -<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__lists.html#ga6">_stp_list_add()</a> </dd></dl> - -<p> -Definition at line <a class="el" href="map_8c-source.html#l00884">884</a> of file <a class="el" href="map_8c-source.html">map.c</a>. -<p> -References <a class="el" href="map_8c-source.html#l00430">_stp_map_key_long()</a>, and <a class="el" href="map_8c-source.html#l00590">_stp_map_set_str()</a>. </td> - </tr> -</table> -<a class="anchor" name="ga1" doxytag="map.c::_stp_list_clear"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">void _stp_list_clear </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top"><a class="el" href="group__maps.html#ga1">MAP</a> </td> - <td class="mdname1" valign="top" nowrap> <em>map</em> </td> - <td class="md" valign="top"> ) </td> - <td class="md" nowrap></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Clears a list. -<p> -All elements in the list are deleted. <dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>map</em> </td><td></td></tr> - </table> -</dl> - -<p> -Definition at line <a class="el" href="map_8c-source.html#l00831">831</a> of file <a class="el" href="map_8c-source.html">map.c</a>. -<p> -References <a class="el" href="alloc_8c-source.html#l00076">_stp_free()</a>, and <a class="el" href="io_8c-source.html#l00029">_stp_log()</a>. </td> - </tr> -</table> -<a class="anchor" name="ga0" doxytag="map.c::_stp_list_new"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top"><a class="el" href="group__maps.html#ga1">MAP</a> _stp_list_new </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top">unsigned </td> - <td class="mdname" nowrap> <em>max_entries</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>enum <a class="el" href="group__maps.html#ga34">valtype</a> </td> - <td class="mdname" nowrap> <em>type</em></td> - </tr> - <tr> - <td class="md"></td> - <td class="md">) </td> - <td class="md" colspan="2"></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Create a new list. -<p> -A list is a map that internally has an incrementing long key for each member. Lists do not wrap if elements are added to exceed their maximum size. <dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>max_entries</em> </td><td>The maximum number of entries allowed. Currently that number will be preallocated. If max_entries is 0, there will be no maximum and entries will be allocated dynamically. </td></tr> - <tr><td valign="top"></td><td valign="top"><em>type</em> </td><td>Type of values stored in this list. </td></tr> - </table> -</dl> -<dl compact><dt><b>Returns:</b></dt><dd>A MAP on success or NULL on failure. </dd></dl> -<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__maps.html#ga32">foreach</a> </dd></dl> - -<p> -Definition at line <a class="el" href="map_8c-source.html#l00819">819</a> of file <a class="el" href="map_8c-source.html">map.c</a>. -<p> -References <a class="el" href="map_8c-source.html#l00057">_stp_map_new()</a>. </td> - </tr> -</table> -<a class="anchor" name="ga5" doxytag="map.c::_stp_list_size"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">int _stp_list_size </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top"><a class="el" href="group__maps.html#ga1">MAP</a> </td> - <td class="mdname1" valign="top" nowrap> <em>map</em> </td> - <td class="md" valign="top"> ) </td> - <td class="md" nowrap><code> [inline]</code></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Get the number of elements in a list. -<p> -<dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>map</em> </td><td></td></tr> - </table> -</dl> -<dl compact><dt><b>Returns:</b></dt><dd>The number of elements in a list. </dd></dl> - -<p> -Definition at line <a class="el" href="map_8c-source.html#l00907">907</a> of file <a class="el" href="map_8c-source.html">map.c</a>. </td> - </tr> -</table> -</body></html> diff --git a/runtime/docs/html/group__maps.html b/runtime/docs/html/group__maps.html deleted file mode 100644 index 1b6e170e..00000000 --- a/runtime/docs/html/group__maps.html +++ /dev/null @@ -1,1299 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: Maps</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1>Maps</h1>Implements maps (associative arrays) and lists. -<a href="#_details">More...</a><table border="0" cellpadding="0" cellspacing="0"> -<tr><td></td></tr> -<tr><td colspan="2"><br><h2>Data Structures</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">struct </td><td class="memItemRight" valign="bottom"><b>stat</b></td></tr> - -<tr><td class="memItemLeft" nowrap align="right" valign="top">union </td><td class="memItemRight" valign="bottom"><b>key_data</b></td></tr> - -<tr><td class="memItemLeft" nowrap align="right" valign="top">struct </td><td class="memItemRight" valign="bottom"><b>map_node</b></td></tr> - -<tr><td class="memItemLeft" nowrap align="right" valign="top">struct </td><td class="memItemRight" valign="bottom"><b>map_node_int64</b></td></tr> - -<tr><td class="memItemLeft" nowrap align="right" valign="top">struct </td><td class="memItemRight" valign="bottom"><b>map_node_str</b></td></tr> - -<tr><td class="memItemLeft" nowrap align="right" valign="top">struct </td><td class="memItemRight" valign="bottom"><b>map_node_stat</b></td></tr> - -<tr><td class="memItemLeft" nowrap align="right" valign="top">struct </td><td class="memItemRight" valign="bottom"><b>map_root</b></td></tr> - -<tr><td colspan="2"><br><h2>Defines</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="ga25" doxytag="maps::key1str"></a> -#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga25">key1str</a>(ptr) (ptr->n.key1.str)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Extracts string from key1 union. <br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="ga26" doxytag="maps::key2str"></a> -#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga26">key2str</a>(ptr) (ptr->n.key2.str)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Extracts string from key2 union. <br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="ga27" doxytag="maps::key1int"></a> -#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga27">key1int</a>(ptr) (ptr->n.key1.val)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Extracts int from key1 union. <br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="ga28" doxytag="maps::key2int"></a> -#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga28">key2int</a>(ptr) (ptr->n.key2.val)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Extracts int from key2 union. <br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga29">_stp_map_key2</a>(map, key1, key2)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Macro to call the proper _stp_map_key functions based on the types of the arguments. <a href="#ga29"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga30">_stp_map_key</a>(map, key)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Macro to call the proper _stp_map_key function based on the type of the argument. <a href="#ga30"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga31">_stp_map_set</a>(map, val)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Macro to call the proper _stp_map_set function based on the type of the argument. <a href="#ga31"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga32">foreach</a>(map, ptr)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Loop through all elements of a map or list. <a href="#ga32"></a><br></td></tr> -<tr><td colspan="2"><br><h2>Typedefs</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="ga1" doxytag="maps::MAP"></a> -typedef map_root * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga1">MAP</a></td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">All maps are of this type. <br></td></tr> -<tr><td colspan="2"><br><h2>Enumerations</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">enum </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga33">keytype</a> { <b>NONE</b>, -<b>LONG</b>, -<b>STR</b> - }</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">keys can be longs or strings <br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">enum </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga34">valtype</a> { <b>INT64</b>, -<b>STAT</b>, -<b>STRING</b>, -<b>END</b> - }</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">values can be either int64, stats or strings <br></td></tr> -<tr><td colspan="2"><br><h2>Functions</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="group__maps.html#ga1">MAP</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga2">_stp_map_new</a> (unsigned max_entries, enum <a class="el" href="group__maps.html#ga34">valtype</a> type)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Create a new map. <a href="#ga2"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga4">_stp_map_key_del</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Deletes the current element. <a href="#ga4"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">map_node * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga5">_stp_map_start</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the first element in a map. <a href="#ga5"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">map_node * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga6">_stp_map_iter</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map, struct map_node *m)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the next element in a map. <a href="#ga6"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga7">_stp_map_del</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Deletes a map. <a href="#ga7"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga8">_stp_map_key_long_long</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map, long key1, long key2)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the map's key to two longs. <a href="#ga8"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga9">_stp_map_key_str_str</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map, char *key1, char *key2)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the map's key to two strings. <a href="#ga9"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga10">_stp_map_key_str_long</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map, char *key1, long key2)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the map's key to a string and a long. <a href="#ga10"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga11">_stp_map_key_long_str</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map, long key1, char *key2)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the map's key to a long and a string. <a href="#ga11"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga12">_stp_map_key_str</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map, char *key)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the map's key to a string. <a href="#ga12"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga13">_stp_map_key_long</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map, long key)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the map's key to a long. <a href="#ga13"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga16">_stp_map_set_int64</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map, int64_t val)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the current element's value to an int64. <a href="#ga16"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga17">_stp_map_add_int64</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map, int64_t val)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Adds an int64 to the current element's value. <a href="#ga17"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">int64_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga18">_stp_map_get_int64</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the current element's value. <a href="#ga18"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga19">_stp_map_set_str</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map, char *val)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the current element's value to a C string. <a href="#ga19"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga20">_stp_map_set_string</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map, String str)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the current element's value to String. <a href="#ga20"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga21">_stp_map_get_str</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the current element's value. <a href="#ga21"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga22">_stp_map_set_stat</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map, stat *stats)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the current element's value to a stat. <a href="#ga22"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">stat * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga23">_stp_map_get_stat</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the current element's value. <a href="#ga23"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga24">_stp_map_stat_add</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map, int64_t val)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Add to the current element's statistics. <a href="#ga24"></a><br></td></tr> -<tr><td colspan="2"><br><h2>Variables</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="ga0" doxytag="maps::packed"></a> -enum <a class="el" href="group__maps.html#ga33">keytype</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga0">packed</a></td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">keys can be longs or strings <br></td></tr> -</table> -<hr><a name="_details"></a><h2>Detailed Description</h2> -Implements maps (associative arrays) and lists. -<p> -<dl compact><dt><b><a class="el" href="todo.html#_todo000006">Todo:</a></b></dt><dd>Needs to be made SMP-safe for when the big lock is removed from kprobes.</dd></dl> -<hr><h2>Define Documentation</h2> -<a class="anchor" name="ga30" doxytag="map.h::_stp_map_key"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">#define _stp_map_key </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top">map, <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>key </td> - <td class="mdname1" valign="top" nowrap> </td> - <td class="md" valign="top"> ) </td> - <td class="md" nowrap></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -<b>Value:</b><div class="fragment"><pre class="fragment">({ \ - <span class="keywordflow">if</span> (__builtin_types_compatible_p (typeof (key), <span class="keywordtype">char</span>[])) \ - <a class="code" href="group__maps.html#ga12">_stp_map_key_str</a> (map, (<span class="keywordtype">char</span> *)(key)); \ - <span class="keywordflow">else</span> \ - <a class="code" href="group__maps.html#ga13">_stp_map_key_long</a> (map, (<span class="keywordtype">long</span>)(key)); \ - }) -</pre></div>Macro to call the proper _stp_map_key function based on the type of the argument. -<p> -<dl compact><dt><b>Note:</b></dt><dd>May cause compiler warning on some GCCs </dd></dl> - -<p> -Definition at line <a class="el" href="map_8h-source.html#l00141">141</a> of file <a class="el" href="map_8h-source.html">map.h</a>. </td> - </tr> -</table> -<a class="anchor" name="ga29" doxytag="map.h::_stp_map_key2"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">#define _stp_map_key2 </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top">map, <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>key1, <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>key2 </td> - <td class="mdname1" valign="top" nowrap> </td> - <td class="md" valign="top"> ) </td> - <td class="md" nowrap></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -<b>Value:</b><div class="fragment"><pre class="fragment">({ \ - <span class="keywordflow">if</span> (__builtin_types_compatible_p (typeof (key1), <span class="keywordtype">char</span>[])) \ - <span class="keywordflow">if</span> (__builtin_types_compatible_p (typeof (key2), <span class="keywordtype">char</span>[])) \ - <a class="code" href="group__maps.html#ga9">_stp_map_key_str_str</a> (map, (<span class="keywordtype">char</span> *)(key1), (<span class="keywordtype">char</span> *)(key2)); \ - <span class="keywordflow">else</span> \ - <a class="code" href="group__maps.html#ga10">_stp_map_key_str_long</a> (map, (<span class="keywordtype">char</span> *)(key1), (<span class="keywordtype">long</span>)(key2)); \ - <span class="keywordflow">else</span> \ - <span class="keywordflow">if</span> (__builtin_types_compatible_p (typeof (key2), <span class="keywordtype">char</span>[])) \ - <a class="code" href="group__maps.html#ga11">_stp_map_key_long_str</a> (map, (<span class="keywordtype">long</span>)(key1), (<span class="keywordtype">char</span> *)(key2)); \ - <span class="keywordflow">else</span> \ - <a class="code" href="group__maps.html#ga8">_stp_map_key_long_long</a> (map, (<span class="keywordtype">long</span>)(key1), (<span class="keywordtype">long</span>)(key2)); \ - }) -</pre></div>Macro to call the proper _stp_map_key functions based on the types of the arguments. -<p> -<dl compact><dt><b>Note:</b></dt><dd>May cause compiler warning on some GCCs </dd></dl> - -<p> -Definition at line <a class="el" href="map_8h-source.html#l00123">123</a> of file <a class="el" href="map_8h-source.html">map.h</a>. </td> - </tr> -</table> -<a class="anchor" name="ga31" doxytag="map.h::_stp_map_set"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">#define _stp_map_set </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top">map, <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>val </td> - <td class="mdname1" valign="top" nowrap> </td> - <td class="md" valign="top"> ) </td> - <td class="md" nowrap></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -<b>Value:</b><div class="fragment"><pre class="fragment">({ \ - <span class="keywordflow">if</span> (__builtin_types_compatible_p (typeof (val), <span class="keywordtype">char</span>[])) \ - <a class="code" href="group__maps.html#ga19">_stp_map_set_str</a> (map, (<span class="keywordtype">char</span> *)(val)); \ - <span class="keywordflow">else</span> <span class="keywordflow">if</span> (__builtin_types_compatible_p (typeof (val), String)) \ - <a class="code" href="group__maps.html#ga20">_stp_map_set_string</a> (map, (String)(val)); \ - <span class="keywordflow">else</span> \ - <a class="code" href="group__maps.html#ga16">_stp_map_set_int64</a> (map, (int64_t)(val)); \ - }) -</pre></div>Macro to call the proper _stp_map_set function based on the type of the argument. -<p> -<dl compact><dt><b>Note:</b></dt><dd>May cause compiler warning on some GCCs </dd></dl> - -<p> -Definition at line <a class="el" href="map_8h-source.html#l00153">153</a> of file <a class="el" href="map_8h-source.html">map.h</a>. </td> - </tr> -</table> -<a class="anchor" name="ga32" doxytag="map.h::foreach"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">#define foreach </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top">map, <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>ptr </td> - <td class="mdname1" valign="top" nowrap> </td> - <td class="md" valign="top"> ) </td> - <td class="md" nowrap></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -<b>Value:</b><div class="fragment"><pre class="fragment"><span class="keywordflow">for</span> (ptr = (typeof(ptr))<a class="code" href="group__maps.html#ga5">_stp_map_start</a>(map); ptr; \ - ptr = (typeof(ptr))_stp_map_iter (map, (<span class="keyword">struct</span> map_node *)ptr)) -</pre></div>Loop through all elements of a map or list. -<p> -<dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>map</em> </td><td></td></tr> - <tr><td valign="top"></td><td valign="top"><em>ptr</em> </td><td>pointer to a map_node_stat, map_node_int64 or map_node_str</td></tr> - </table> -</dl> -<b>Example:</b> <div class="fragment"><pre class="fragment"><span class="comment">/* example showing how to print all the stats in a map using foreach() */</span> - -<span class="keyword">struct </span>map_node_stat *ptr; - -<a class="code" href="group__maps.html#ga32">foreach</a> (map, ptr) - printf ("map[%s,%ld] = [c=%lld s=%lld min=%lld max=%lld]\n", key1str(ptr), - key2int(ptr), ptr->stats.count, ptr->stats.sum, ptr->stats.min, - ptr->stats.max); - -</pre></div> -<p> -Definition at line <a class="el" href="map_8h-source.html#l00171">171</a> of file <a class="el" href="map_8h-source.html">map.h</a>. </td> - </tr> -</table> -<hr><h2>Function Documentation</h2> -<a class="anchor" name="ga17" doxytag="map.c::_stp_map_add_int64"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">void _stp_map_add_int64 </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top"><a class="el" href="group__maps.html#ga1">MAP</a> </td> - <td class="mdname" nowrap> <em>map</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>int64_t </td> - <td class="mdname" nowrap> <em>val</em></td> - </tr> - <tr> - <td class="md"></td> - <td class="md">) </td> - <td class="md" colspan="2"></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Adds an int64 to the current element's value. -<p> -This adds an int64 to the current element's value. The map must have been created to hold int64s using <a class="el" href="group__maps.html#ga2">_stp_map_new()</a><p> -If the element doesn't exist, it is created. If no current element (key) is set for the map, this function does nothing. <dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>map</em> </td><td></td></tr> - <tr><td valign="top"></td><td valign="top"><em>val</em> </td><td>value </td></tr> - </table> -</dl> -<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__maps.html#ga16">_stp_map_set_int64</a> </dd></dl> - -<p> -Definition at line <a class="el" href="map_8c-source.html#l00559">559</a> of file <a class="el" href="map_8c-source.html">map.c</a>. </td> - </tr> -</table> -<a class="anchor" name="ga7" doxytag="map.c::_stp_map_del"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">void _stp_map_del </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top"><a class="el" href="group__maps.html#ga1">MAP</a> </td> - <td class="mdname1" valign="top" nowrap> <em>map</em> </td> - <td class="md" valign="top"> ) </td> - <td class="md" nowrap></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Deletes a map. -<p> -Deletes a map, freeing all memory in all elements. Normally done only when the module exits. <dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>map</em> </td><td></td></tr> - </table> -</dl> - -<p> -Definition at line <a class="el" href="map_8c-source.html#l00205">205</a> of file <a class="el" href="map_8c-source.html">map.c</a>. -<p> -References <a class="el" href="alloc_8c-source.html#l00086">_stp_vfree()</a>. </td> - </tr> -</table> -<a class="anchor" name="ga18" doxytag="map.c::_stp_map_get_int64"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">int64_t _stp_map_get_int64 </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top"><a class="el" href="group__maps.html#ga1">MAP</a> </td> - <td class="mdname1" valign="top" nowrap> <em>map</em> </td> - <td class="md" valign="top"> ) </td> - <td class="md" nowrap></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Gets the current element's value. -<p> -<dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>map</em> </td><td></td></tr> - </table> -</dl> -<dl compact><dt><b>Returns:</b></dt><dd>The value. If the current element is not set or doesn't exist, returns 0. </dd></dl> - -<p> -Definition at line <a class="el" href="map_8c-source.html#l00569">569</a> of file <a class="el" href="map_8c-source.html">map.c</a>. </td> - </tr> -</table> -<a class="anchor" name="ga23" doxytag="map.c::_stp_map_get_stat"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">stat* _stp_map_get_stat </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top"><a class="el" href="group__maps.html#ga1">MAP</a> </td> - <td class="mdname1" valign="top" nowrap> <em>map</em> </td> - <td class="md" valign="top"> ) </td> - <td class="md" nowrap></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Gets the current element's value. -<p> -<dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>map</em> </td><td></td></tr> - </table> -</dl> -<dl compact><dt><b>Returns:</b></dt><dd>A pointer to the stats struct. If the current element is not set or doesn't exist, returns NULL. </dd></dl> - -<p> -Definition at line <a class="el" href="map_8c-source.html#l00750">750</a> of file <a class="el" href="map_8c-source.html">map.c</a>. </td> - </tr> -</table> -<a class="anchor" name="ga21" doxytag="map.c::_stp_map_get_str"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">char* _stp_map_get_str </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top"><a class="el" href="group__maps.html#ga1">MAP</a> </td> - <td class="mdname1" valign="top" nowrap> <em>map</em> </td> - <td class="md" valign="top"> ) </td> - <td class="md" nowrap></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Gets the current element's value. -<p> -<dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>map</em> </td><td></td></tr> - </table> -</dl> -<dl compact><dt><b>Returns:</b></dt><dd>A string pointer. If the current element is not set or doesn't exist, returns NULL. </dd></dl> - -<p> -Definition at line <a class="el" href="map_8c-source.html#l00667">667</a> of file <a class="el" href="map_8c-source.html">map.c</a>. </td> - </tr> -</table> -<a class="anchor" name="ga6" doxytag="map.c::_stp_map_iter"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">struct map_node* _stp_map_iter </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top"><a class="el" href="group__maps.html#ga1">MAP</a> </td> - <td class="mdname" nowrap> <em>map</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>struct map_node * </td> - <td class="mdname" nowrap> <em>m</em></td> - </tr> - <tr> - <td class="md"></td> - <td class="md">) </td> - <td class="md" colspan="2"></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Get the next element in a map. -<p> -<dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>map</em> </td><td></td></tr> - <tr><td valign="top"></td><td valign="top"><em>m</em> </td><td>a pointer to the current element, returned from <a class="el" href="group__maps.html#ga5">_stp_map_start()</a> or <a class="el" href="group__maps.html#ga6">_stp_map_iter()</a>. </td></tr> - </table> -</dl> -<dl compact><dt><b>Returns:</b></dt><dd>a pointer to the next element. This is typically used with <a class="el" href="group__maps.html#ga5">_stp_map_start()</a>. See the <a class="el" href="group__maps.html#ga32">foreach()</a> macro for typical usage. It probably does what you want anyway. </dd></dl> -<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__maps.html#ga32">foreach</a> </dd></dl> - -<p> -Definition at line <a class="el" href="map_8c-source.html#l00186">186</a> of file <a class="el" href="map_8c-source.html">map.c</a>. </td> - </tr> -</table> -<a class="anchor" name="ga4" doxytag="map.c::_stp_map_key_del"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">void _stp_map_key_del </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top"><a class="el" href="group__maps.html#ga1">MAP</a> </td> - <td class="mdname1" valign="top" nowrap> <em>map</em> </td> - <td class="md" valign="top"> ) </td> - <td class="md" nowrap></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Deletes the current element. -<p> -If no current element (key) for this map is set, this function does nothing. <dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>map</em> </td><td></td></tr> - </table> -</dl> - -<p> -Definition at line <a class="el" href="map_8c-source.html#l00118">118</a> of file <a class="el" href="map_8c-source.html">map.c</a>. -<p> -References <a class="el" href="alloc_8c-source.html#l00076">_stp_free()</a>. -<p> -Referenced by <a class="el" href="map_8c-source.html#l00691">_stp_map_set_stat()</a>, and <a class="el" href="map_8c-source.html#l00590">_stp_map_set_str()</a>. </td> - </tr> -</table> -<a class="anchor" name="ga13" doxytag="map.c::_stp_map_key_long"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">void _stp_map_key_long </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top"><a class="el" href="group__maps.html#ga1">MAP</a> </td> - <td class="mdname" nowrap> <em>map</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>long </td> - <td class="mdname" nowrap> <em>key</em></td> - </tr> - <tr> - <td class="md"></td> - <td class="md">) </td> - <td class="md" colspan="2"></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Set the map's key to a long. -<p> -This sets the current element based on a long key. If the key is not found, a new element will not be created until a <em>_stp_map_set_xxx</em> call. <dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>map</em> </td><td></td></tr> - <tr><td valign="top"></td><td valign="top"><em>key</em> </td><td></td></tr> - </table> -</dl> - -<p> -Definition at line <a class="el" href="map_8c-source.html#l00430">430</a> of file <a class="el" href="map_8c-source.html">map.c</a>. -<p> -References <a class="el" href="map_8c-source.html#l00233">_stp_map_key_long_long()</a>. -<p> -Referenced by <a class="el" href="map_8c-source.html#l00896">_stp_list_add_int64()</a>, <a class="el" href="map_8c-source.html#l00872">_stp_list_add_str()</a>, and <a class="el" href="map_8c-source.html#l00884">_stp_list_add_string()</a>. </td> - </tr> -</table> -<a class="anchor" name="ga8" doxytag="map.c::_stp_map_key_long_long"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">void _stp_map_key_long_long </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top"><a class="el" href="group__maps.html#ga1">MAP</a> </td> - <td class="mdname" nowrap> <em>map</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>long </td> - <td class="mdname" nowrap> <em>key1</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>long </td> - <td class="mdname" nowrap> <em>key2</em></td> - </tr> - <tr> - <td class="md"></td> - <td class="md">) </td> - <td class="md" colspan="2"></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Set the map's key to two longs. -<p> -This sets the current element based on a key of two strings. If the keys are not found, a new element will not be created until a <em>_stp_map_set_xxx</em> call. <dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>map</em> </td><td></td></tr> - <tr><td valign="top"></td><td valign="top"><em>key1</em> </td><td>first key </td></tr> - <tr><td valign="top"></td><td valign="top"><em>key2</em> </td><td>second key </td></tr> - </table> -</dl> - -<p> -Definition at line <a class="el" href="map_8c-source.html#l00233">233</a> of file <a class="el" href="map_8c-source.html">map.c</a>. -<p> -Referenced by <a class="el" href="map_8c-source.html#l00430">_stp_map_key_long()</a>. </td> - </tr> -</table> -<a class="anchor" name="ga11" doxytag="map.c::_stp_map_key_long_str"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">void _stp_map_key_long_str </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top"><a class="el" href="group__maps.html#ga1">MAP</a> </td> - <td class="mdname" nowrap> <em>map</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>long </td> - <td class="mdname" nowrap> <em>key1</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>char * </td> - <td class="mdname" nowrap> <em>key2</em></td> - </tr> - <tr> - <td class="md"></td> - <td class="md">) </td> - <td class="md" colspan="2"></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Set the map's key to a long and a string. -<p> -This sets the current element based on a key of a long and a string. If the keys are not found, a new element will not be created until a <em>_stp_map_set_xxx</em> call. <dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>map</em> </td><td></td></tr> - <tr><td valign="top"></td><td valign="top"><em>key1</em> </td><td>first key </td></tr> - <tr><td valign="top"></td><td valign="top"><em>key2</em> </td><td>second key </td></tr> - </table> -</dl> - -<p> -Definition at line <a class="el" href="map_8c-source.html#l00373">373</a> of file <a class="el" href="map_8c-source.html">map.c</a>. </td> - </tr> -</table> -<a class="anchor" name="ga12" doxytag="map.c::_stp_map_key_str"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">void _stp_map_key_str </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top"><a class="el" href="group__maps.html#ga1">MAP</a> </td> - <td class="mdname" nowrap> <em>map</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>char * </td> - <td class="mdname" nowrap> <em>key</em></td> - </tr> - <tr> - <td class="md"></td> - <td class="md">) </td> - <td class="md" colspan="2"></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Set the map's key to a string. -<p> -This sets the current element based on a string key. If the key is not found, a new element will not be created until a <em>_stp_map_set_xxx</em> call. <dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>map</em> </td><td></td></tr> - <tr><td valign="top"></td><td valign="top"><em>key</em> </td><td></td></tr> - </table> -</dl> - -<p> -Definition at line <a class="el" href="map_8c-source.html#l00414">414</a> of file <a class="el" href="map_8c-source.html">map.c</a>. -<p> -References <a class="el" href="map_8c-source.html#l00276">_stp_map_key_str_str()</a>. </td> - </tr> -</table> -<a class="anchor" name="ga10" doxytag="map.c::_stp_map_key_str_long"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">void _stp_map_key_str_long </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top"><a class="el" href="group__maps.html#ga1">MAP</a> </td> - <td class="mdname" nowrap> <em>map</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>char * </td> - <td class="mdname" nowrap> <em>key1</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>long </td> - <td class="mdname" nowrap> <em>key2</em></td> - </tr> - <tr> - <td class="md"></td> - <td class="md">) </td> - <td class="md" colspan="2"></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Set the map's key to a string and a long. -<p> -This sets the current element based on a key of a string and a long. If the keys are not found, a new element will not be created until a <em>_stp_map_set_xxx</em> call. <dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>map</em> </td><td></td></tr> - <tr><td valign="top"></td><td valign="top"><em>key1</em> </td><td>first key </td></tr> - <tr><td valign="top"></td><td valign="top"><em>key2</em> </td><td>second key </td></tr> - </table> -</dl> - -<p> -Definition at line <a class="el" href="map_8c-source.html#l00325">325</a> of file <a class="el" href="map_8c-source.html">map.c</a>. </td> - </tr> -</table> -<a class="anchor" name="ga9" doxytag="map.c::_stp_map_key_str_str"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">void _stp_map_key_str_str </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top"><a class="el" href="group__maps.html#ga1">MAP</a> </td> - <td class="mdname" nowrap> <em>map</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>char * </td> - <td class="mdname" nowrap> <em>key1</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>char * </td> - <td class="mdname" nowrap> <em>key2</em></td> - </tr> - <tr> - <td class="md"></td> - <td class="md">) </td> - <td class="md" colspan="2"></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Set the map's key to two strings. -<p> -This sets the current element based on a key of two strings. If the keys are not found, a new element will not be created until a <em>_stp_map_set_xxx</em> call. <dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>map</em> </td><td></td></tr> - <tr><td valign="top"></td><td valign="top"><em>key1</em> </td><td>first key </td></tr> - <tr><td valign="top"></td><td valign="top"><em>key2</em> </td><td>second key </td></tr> - </table> -</dl> - -<p> -Definition at line <a class="el" href="map_8c-source.html#l00276">276</a> of file <a class="el" href="map_8c-source.html">map.c</a>. -<p> -Referenced by <a class="el" href="map_8c-source.html#l00414">_stp_map_key_str()</a>. </td> - </tr> -</table> -<a class="anchor" name="ga2" doxytag="map.c::_stp_map_new"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top"><a class="el" href="group__maps.html#ga1">MAP</a> _stp_map_new </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top">unsigned </td> - <td class="mdname" nowrap> <em>max_entries</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>enum <a class="el" href="group__maps.html#ga34">valtype</a> </td> - <td class="mdname" nowrap> <em>type</em></td> - </tr> - <tr> - <td class="md"></td> - <td class="md">) </td> - <td class="md" colspan="2"></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Create a new map. -<p> -Maps must be created at module initialization time. <dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>max_entries</em> </td><td>The maximum number of entries allowed. Currently that number will be preallocated. If more entries are required, the oldest ones will be deleted. This makes it effectively a circular buffer. If max_entries is 0, there will be no maximum and entries will be allocated dynamically. </td></tr> - <tr><td valign="top"></td><td valign="top"><em>type</em> </td><td>Type of values stored in this map. </td></tr> - </table> -</dl> -<dl compact><dt><b>Returns:</b></dt><dd>A MAP on success or NULL on failure. </dd></dl> - -<p> -Definition at line <a class="el" href="map_8c-source.html#l00057">57</a> of file <a class="el" href="map_8c-source.html">map.c</a>. -<p> -References <a class="el" href="alloc_8c-source.html#l00062">_stp_valloc()</a>. -<p> -Referenced by <a class="el" href="map_8c-source.html#l00819">_stp_list_new()</a>. </td> - </tr> -</table> -<a class="anchor" name="ga16" doxytag="map.c::_stp_map_set_int64"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">void _stp_map_set_int64 </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top"><a class="el" href="group__maps.html#ga1">MAP</a> </td> - <td class="mdname" nowrap> <em>map</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>int64_t </td> - <td class="mdname" nowrap> <em>val</em></td> - </tr> - <tr> - <td class="md"></td> - <td class="md">) </td> - <td class="md" colspan="2"></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Set the current element's value to an int64. -<p> -This sets the current element's value to an int64. The map must have been created to hold int64s using <a class="el" href="group__maps.html#ga2">_stp_map_new()</a><p> -If the element doesn't exist, it is created. If no current element (key) is set for the map, this function does nothing. <dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>map</em> </td><td></td></tr> - <tr><td valign="top"></td><td valign="top"><em>val</em> </td><td>new value </td></tr> - </table> -</dl> -<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__maps.html#ga17">_stp_map_add_int64</a> <p> -<a class="el" href="group__maps.html#ga31">_stp_map_set()</a> </dd></dl> - -<p> -Definition at line <a class="el" href="map_8c-source.html#l00542">542</a> of file <a class="el" href="map_8c-source.html">map.c</a>. -<p> -Referenced by <a class="el" href="map_8c-source.html#l00896">_stp_list_add_int64()</a>. </td> - </tr> -</table> -<a class="anchor" name="ga22" doxytag="map.c::_stp_map_set_stat"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">void _stp_map_set_stat </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top"><a class="el" href="group__maps.html#ga1">MAP</a> </td> - <td class="mdname" nowrap> <em>map</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>stat * </td> - <td class="mdname" nowrap> <em>stats</em></td> - </tr> - <tr> - <td class="md"></td> - <td class="md">) </td> - <td class="md" colspan="2"></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Set the current element's value to a stat. -<p> -This sets the current element's value to an stat struct. The map must have been created to hold stats using <em>_stp_map_new(xxx, STAT)</em>. This function would only be used if we wanted to set stats to something other than the normal initial values (count = 0, sum = 0, etc). It may be deleted if it doesn't turn out to be useful. <dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__maps.html#ga24">_stp_map_stat_add</a></dd></dl> -If the element doesn't exist, it is created. If no current element (key) is set for the map, this function does nothing. <dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>map</em> </td><td></td></tr> - <tr><td valign="top"></td><td valign="top"><em>stats</em> </td><td>pointer to stats struct. </td></tr> - </table> -</dl> -<dl compact><dt><b><a class="el" href="todo.html#_todo000004">Todo:</a></b></dt><dd>Histograms don't work yet. </dd></dl> - -<p> -Definition at line <a class="el" href="map_8c-source.html#l00691">691</a> of file <a class="el" href="map_8c-source.html">map.c</a>. -<p> -References <a class="el" href="alloc_8c-source.html#l00047">_stp_calloc()</a>, and <a class="el" href="map_8c-source.html#l00118">_stp_map_key_del()</a>. -<p> -Referenced by <a class="el" href="map_8c-source.html#l00771">_stp_map_stat_add()</a>. </td> - </tr> -</table> -<a class="anchor" name="ga19" doxytag="map.c::_stp_map_set_str"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">void _stp_map_set_str </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top"><a class="el" href="group__maps.html#ga1">MAP</a> </td> - <td class="mdname" nowrap> <em>map</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>char * </td> - <td class="mdname" nowrap> <em>val</em></td> - </tr> - <tr> - <td class="md"></td> - <td class="md">) </td> - <td class="md" colspan="2"></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Set the current element's value to a C string. -<p> -This sets the current element's value to an C string. The map must have been created to hold int64s using <em>_stp_map_new(xxx, STRING)</em><p> -If the element doesn't exist, it is created. If no current element (key) is set for the map, this function does nothing. <dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>map</em> </td><td></td></tr> - <tr><td valign="top"></td><td valign="top"><em>val</em> </td><td>new string </td></tr> - </table> -</dl> -<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__maps.html#ga31">_stp_map_set()</a> </dd></dl> - -<p> -Definition at line <a class="el" href="map_8c-source.html#l00590">590</a> of file <a class="el" href="map_8c-source.html">map.c</a>. -<p> -References <a class="el" href="alloc_8c-source.html#l00031">_stp_alloc()</a>, <a class="el" href="alloc_8c-source.html#l00047">_stp_calloc()</a>, <a class="el" href="alloc_8c-source.html#l00076">_stp_free()</a>, and <a class="el" href="map_8c-source.html#l00118">_stp_map_key_del()</a>. -<p> -Referenced by <a class="el" href="map_8c-source.html#l00872">_stp_list_add_str()</a>, <a class="el" href="map_8c-source.html#l00884">_stp_list_add_string()</a>, and <a class="el" href="map_8c-source.html#l00657">_stp_map_set_string()</a>. </td> - </tr> -</table> -<a class="anchor" name="ga20" doxytag="map.c::_stp_map_set_string"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">void _stp_map_set_string </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top"><a class="el" href="group__maps.html#ga1">MAP</a> </td> - <td class="mdname" nowrap> <em>map</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>String </td> - <td class="mdname" nowrap> <em>str</em></td> - </tr> - <tr> - <td class="md"></td> - <td class="md">) </td> - <td class="md" colspan="2"></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Set the current element's value to String. -<p> -This sets the current element's value to a String. The map must have been created to hold int64s using <em>_stp_map_new(xxx, STRING)</em><p> -If the element doesn't exist, it is created. If no current element (key) is set for the map, this function does nothing. <dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>map</em> </td><td></td></tr> - <tr><td valign="top"></td><td valign="top"><em>str</em> </td><td>String containing new value. </td></tr> - </table> -</dl> -<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__maps.html#ga31">_stp_map_set()</a> </dd></dl> - -<p> -Definition at line <a class="el" href="map_8c-source.html#l00657">657</a> of file <a class="el" href="map_8c-source.html">map.c</a>. -<p> -References <a class="el" href="map_8c-source.html#l00590">_stp_map_set_str()</a>. </td> - </tr> -</table> -<a class="anchor" name="ga5" doxytag="map.c::_stp_map_start"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">struct map_node* _stp_map_start </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top"><a class="el" href="group__maps.html#ga1">MAP</a> </td> - <td class="mdname1" valign="top" nowrap> <em>map</em> </td> - <td class="md" valign="top"> ) </td> - <td class="md" nowrap></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Get the first element in a map. -<p> -<dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>map</em> </td><td></td></tr> - </table> -</dl> -<dl compact><dt><b>Returns:</b></dt><dd>a pointer to the first element. This is typically used with <a class="el" href="group__maps.html#ga6">_stp_map_iter()</a>. See the <a class="el" href="group__maps.html#ga32">foreach()</a> macro for typical usage. It probably does what you want anyway. </dd></dl> -<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__maps.html#ga32">foreach</a> </dd></dl> - -<p> -Definition at line <a class="el" href="map_8c-source.html#l00163">163</a> of file <a class="el" href="map_8c-source.html">map.c</a>. </td> - </tr> -</table> -<a class="anchor" name="ga24" doxytag="map.c::_stp_map_stat_add"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">void _stp_map_stat_add </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top"><a class="el" href="group__maps.html#ga1">MAP</a> </td> - <td class="mdname" nowrap> <em>map</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>int64_t </td> - <td class="mdname" nowrap> <em>val</em></td> - </tr> - <tr> - <td class="md"></td> - <td class="md">) </td> - <td class="md" colspan="2"></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Add to the current element's statistics. -<p> -Increments the statistics counter by one and the sum by <em>val</em>. Adjusts minimum, maximum, and histogram.<p> -If the element doesn't exist, it is created. If no current element (key) is set for the map, this function does nothing. <dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>map</em> </td><td></td></tr> - <tr><td valign="top"></td><td valign="top"><em>val</em> </td><td>value to add to the statistics </td></tr> - </table> -</dl> -<dl compact><dt><b><a class="el" href="todo.html#_todo000005">Todo:</a></b></dt><dd>Histograms don't work yet. </dd></dl> - -<p> -Definition at line <a class="el" href="map_8c-source.html#l00771">771</a> of file <a class="el" href="map_8c-source.html">map.c</a>. -<p> -References <a class="el" href="map_8c-source.html#l00691">_stp_map_set_stat()</a>. </td> - </tr> -</table> -</body></html> diff --git a/runtime/docs/html/group__print.html b/runtime/docs/html/group__print.html deleted file mode 100644 index f18a05bf..00000000 --- a/runtime/docs/html/group__print.html +++ /dev/null @@ -1,342 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: Print Buffer</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1>Print Buffer</h1>Print Buffer Functions. -<a href="#_details">More...</a><table border="0" cellpadding="0" cellspacing="0"> -<tr><td></td></tr> -<tr><td colspan="2"><br><h2>Defines</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="ga8" doxytag="print::STP_PRINT_BUF_LEN"></a> -#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__print.html#ga8">STP_PRINT_BUF_LEN</a> 8000</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Size of buffer, not including terminating NULL. <br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="ga9" doxytag="print::TIMESTAMP_SIZE"></a> -#define </td><td class="memItemRight" valign="bottom"><b>TIMESTAMP_SIZE</b> 19</td></tr> - -<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="ga10" doxytag="print::STP_PRINT_BUF_START"></a> -#define </td><td class="memItemRight" valign="bottom"><b>STP_PRINT_BUF_START</b> (TIMESTAMP_SIZE + 1)</td></tr> - -<tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__print.html#ga11">_stp_print</a>(str)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Write a String or C string into the print buffer. <a href="#ga11"></a><br></td></tr> -<tr><td colspan="2"><br><h2>Functions</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__print.html#ga2">_stp_print_flush</a> (void)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Send the print buffer now. <a href="#ga2"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__print.html#ga3">_stp_printf</a> (const char *fmt,...)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Print into the print buffer. <a href="#ga3"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__print.html#ga4">_stp_vprintf</a> (const char *fmt, va_list args)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Print into the print buffer. <a href="#ga4"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__print.html#ga5">_stp_print_cstr</a> (const char *str)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Write a C string into the print buffer. <a href="#ga5"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__print.html#ga6">_stp_print_clear</a> (void)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Clear the scratch buffer. <a href="#ga6"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__print.html#ga7">_stp_print_string</a> (String str)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Write a String into the print buffer. <a href="#ga7"></a><br></td></tr> -</table> -<hr><a name="_details"></a><h2>Detailed Description</h2> -Print Buffer Functions. -<p> -The print buffer is for collecting output to send to the user daemon. This is a per-cpu static buffer. The buffer is sent when <a class="el" href="group__print.html#ga2">_stp_print_flush()</a> is called.<p> -The reason to do this is to allow multiple small prints to be combined then timestamped and sent together to stpd. It could flush automatically on newlines, but what about stack traces which span many lines? So try this and see how it works for us. <hr><h2>Define Documentation</h2> -<a class="anchor" name="ga11" doxytag="print.c::_stp_print"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">#define _stp_print </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top">str </td> - <td class="mdname1" valign="top" nowrap> </td> - <td class="md" valign="top"> ) </td> - <td class="md" nowrap></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -<b>Value:</b><div class="fragment"><pre class="fragment">({ \ - <span class="keywordflow">if</span> (__builtin_types_compatible_p (typeof (str), <span class="keywordtype">char</span>[])) { \ - <span class="keywordtype">char</span> *x = (<span class="keywordtype">char</span> *)str; \ - <a class="code" href="group__print.html#ga5">_stp_print_cstr</a>(x); \ - } <span class="keywordflow">else</span> { \ - String x = (String)str; \ - <a class="code" href="group__print.html#ga7">_stp_print_string</a>(x); \ - } \ - }) -</pre></div>Write a String or C string into the print buffer. -<p> -This macro selects the proper function to call. <dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>str</em> </td><td>A String or C string (char *) </td></tr> - </table> -</dl> -<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__print.html#ga5">_stp_print_cstr</a> <a class="el" href="group__print.html#ga7">_stp_print_string</a> </dd></dl> - -<p> -Definition at line <a class="el" href="print_8c-source.html#l00188">188</a> of file <a class="el" href="print_8c-source.html">print.c</a>. </td> - </tr> -</table> -<hr><h2>Function Documentation</h2> -<a class="anchor" name="ga6" doxytag="print.c::_stp_print_clear"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">char* _stp_print_clear </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top">void </td> - <td class="mdname1" valign="top" nowrap> </td> - <td class="md" valign="top"> ) </td> - <td class="md" nowrap></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Clear the scratch buffer. -<p> -This function should be called before anything is written to the scratch buffer. Output will accumulate in the buffer until this function is called again. <dl compact><dt><b>Returns:</b></dt><dd>A pointer to the buffer. </dd></dl> - -<p> -Definition at line <a class="el" href="print_8c-source.html#l00156">156</a> of file <a class="el" href="print_8c-source.html">print.c</a>. </td> - </tr> -</table> -<a class="anchor" name="ga5" doxytag="print.c::_stp_print_cstr"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">void _stp_print_cstr </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top">const char * </td> - <td class="mdname1" valign="top" nowrap> <em>str</em> </td> - <td class="md" valign="top"> ) </td> - <td class="md" nowrap></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Write a C string into the print buffer. -<p> -Copies a string into a print buffer. Safe because overflowing the buffer is not allowed. Size is limited by length of print buffer, <a class="el" href="group__print.html#ga8">STP_PRINT_BUF_LEN</a>. This is more efficient than using <a class="el" href="group__print.html#ga3">_stp_printf()</a> if you don't need fancy formatting.<p> -<dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>str</em> </td><td>A C string. </td></tr> - </table> -</dl> -<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__print.html#ga11">_stp_print</a> </dd></dl> - -<p> -Definition at line <a class="el" href="print_8c-source.html#l00138">138</a> of file <a class="el" href="print_8c-source.html">print.c</a>. -<p> -References <a class="el" href="print_8c-source.html#l00022">STP_PRINT_BUF_LEN</a>. -<p> -Referenced by <a class="el" href="print_8c-source.html#l00176">_stp_print_string()</a>. </td> - </tr> -</table> -<a class="anchor" name="ga2" doxytag="print.c::_stp_print_flush"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">void _stp_print_flush </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top">void </td> - <td class="mdname1" valign="top" nowrap> </td> - <td class="md" valign="top"> ) </td> - <td class="md" nowrap></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Send the print buffer now. -<p> -Output accumulates in the print buffer until this is called. Size is limited by length of print buffer, <a class="el" href="group__print.html#ga8">STP_PRINT_BUF_LEN</a>. -<p> -Definition at line <a class="el" href="print_8c-source.html#l00065">65</a> of file <a class="el" href="print_8c-source.html">print.c</a>. </td> - </tr> -</table> -<a class="anchor" name="ga7" doxytag="print.c::_stp_print_string"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">void _stp_print_string </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top">String </td> - <td class="mdname1" valign="top" nowrap> <em>str</em> </td> - <td class="md" valign="top"> ) </td> - <td class="md" nowrap></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Write a String into the print buffer. -<p> -Copies a String into a print buffer. Safe because overflowing the buffer is not allowed. Size is limited by length of print buffer, <a class="el" href="group__print.html#ga8">STP_PRINT_BUF_LEN</a>. This is more efficient than using <a class="el" href="group__print.html#ga3">_stp_printf()</a> if you don't need fancy formatting.<p> -<dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>str</em> </td><td>A String. </td></tr> - </table> -</dl> -<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__print.html#ga11">_stp_print</a> </dd></dl> - -<p> -Definition at line <a class="el" href="print_8c-source.html#l00176">176</a> of file <a class="el" href="print_8c-source.html">print.c</a>. -<p> -References <a class="el" href="print_8c-source.html#l00138">_stp_print_cstr()</a>. </td> - </tr> -</table> -<a class="anchor" name="ga3" doxytag="print.c::_stp_printf"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">void _stp_printf </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top">const char * </td> - <td class="mdname" nowrap> <em>fmt</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap> </td> - <td class="mdname" nowrap> <em>...</em></td> - </tr> - <tr> - <td class="md"></td> - <td class="md">) </td> - <td class="md" colspan="2"></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Print into the print buffer. -<p> -Like printf, except output goes to the print buffer. Safe because overflowing the buffer is not allowed. Size is limited by length of print buffer, <a class="el" href="group__print.html#ga8">STP_PRINT_BUF_LEN</a>.<p> -<dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>fmt</em> </td><td>A printf-style format string followed by a variable number of args. </td></tr> - </table> -</dl> -<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__print.html#ga2">_stp_print_flush()</a> </dd></dl> - -<p> -Definition at line <a class="el" href="print_8c-source.html#l00099">99</a> of file <a class="el" href="print_8c-source.html">print.c</a>. -<p> -References <a class="el" href="print_8c-source.html#l00022">STP_PRINT_BUF_LEN</a>. -<p> -Referenced by <a class="el" href="sym_8c-source.html#l00054">_stp_symbol_print()</a>. </td> - </tr> -</table> -<a class="anchor" name="ga4" doxytag="print.c::_stp_vprintf"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">void _stp_vprintf </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top">const char * </td> - <td class="mdname" nowrap> <em>fmt</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>va_list </td> - <td class="mdname" nowrap> <em>args</em></td> - </tr> - <tr> - <td class="md"></td> - <td class="md">) </td> - <td class="md" colspan="2"></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Print into the print buffer. -<p> -Use this if your function already has a va_list. You probably want <a class="el" href="group__print.html#ga3">_stp_printf()</a>. -<p> -Definition at line <a class="el" href="print_8c-source.html#l00117">117</a> of file <a class="el" href="print_8c-source.html">print.c</a>. -<p> -References <a class="el" href="print_8c-source.html#l00022">STP_PRINT_BUF_LEN</a>. </td> - </tr> -</table> -</body></html> diff --git a/runtime/docs/html/group__stack.html b/runtime/docs/html/group__stack.html deleted file mode 100644 index ab4922e5..00000000 --- a/runtime/docs/html/group__stack.html +++ /dev/null @@ -1,129 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: Stack Tracing Functions</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1>Stack Tracing Functions</h1><table border="0" cellpadding="0" cellspacing="0"> -<tr><td></td></tr> -<tr><td colspan="2"><br><h2>Functions</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__stack.html#ga6">_stp_stack_print</a> (int verbose, int levels)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Print stack dump. <a href="#ga6"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">String </td><td class="memItemRight" valign="bottom"><a class="el" href="group__stack.html#ga7">_stp_stack_sprint</a> (String str, int verbose, int levels)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Writes stack dump to a String. <a href="#ga7"></a><br></td></tr> -</table> -<hr><h2>Function Documentation</h2> -<a class="anchor" name="ga6" doxytag="stack.c::_stp_stack_print"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">void _stp_stack_print </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top">int </td> - <td class="mdname" nowrap> <em>verbose</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>int </td> - <td class="mdname" nowrap> <em>levels</em></td> - </tr> - <tr> - <td class="md"></td> - <td class="md">) </td> - <td class="md" colspan="2"></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Print stack dump. -<p> -Prints a stack dump to the print buffer. <dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>verbose</em> </td><td>Verbosity </td></tr> - <tr><td valign="top"></td><td valign="top"><em>levels</em> </td><td>Number of levels to trace. </td></tr> - </table> -</dl> -<dl compact><dt><b><a class="el" href="todo.html#_todo000007">Todo:</a></b></dt><dd>Implement verbosity and levels parameters.</dd></dl> -<p> -<dl compact><dt><b><a class="el" href="bug.html#_bug000003">Bug:</a></b></dt><dd>levels parameter is not functional </dd></dl> - -<p> -Definition at line <a class="el" href="stack_8c-source.html#l00155">155</a> of file <a class="el" href="stack_8c-source.html">stack.c</a>. </td> - </tr> -</table> -<a class="anchor" name="ga7" doxytag="stack.c::_stp_stack_sprint"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">String _stp_stack_sprint </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top">String </td> - <td class="mdname" nowrap> <em>str</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>int </td> - <td class="mdname" nowrap> <em>verbose</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>int </td> - <td class="mdname" nowrap> <em>levels</em></td> - </tr> - <tr> - <td class="md"></td> - <td class="md">) </td> - <td class="md" colspan="2"></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Writes stack dump to a String. -<p> -<dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>str</em> </td><td>String </td></tr> - <tr><td valign="top"></td><td valign="top"><em>verbose</em> </td><td>Verbosity </td></tr> - <tr><td valign="top"></td><td valign="top"><em>levels</em> </td><td>Number of levels to trace. </td></tr> - </table> -</dl> -<dl compact><dt><b>Returns:</b></dt><dd>Same String as was input. </dd></dl> -<dl compact><dt><b><a class="el" href="todo.html#_todo000008">Todo:</a></b></dt><dd>Implement verbosity and levels parameters.</dd></dl> -<p> -<dl compact><dt><b><a class="el" href="bug.html#_bug000004">Bug:</a></b></dt><dd>levels parameter is not functional </dd></dl> - -<p> -Definition at line <a class="el" href="stack_8c-source.html#l00171">171</a> of file <a class="el" href="stack_8c-source.html">stack.c</a>. -<p> -References <a class="el" href="io_8c-source.html#l00029">_stp_log()</a>. </td> - </tr> -</table> -</body></html> diff --git a/runtime/docs/html/group__string.html b/runtime/docs/html/group__string.html deleted file mode 100644 index 834b7513..00000000 --- a/runtime/docs/html/group__string.html +++ /dev/null @@ -1,389 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: String Functions</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1>String Functions</h1>One of the biggest restrictions the library has is that it cannot allocate things like strings off the stack. -<a href="#_details">More...</a><table border="0" cellpadding="0" cellspacing="0"> -<tr><td></td></tr> -<tr><td colspan="2"><br><h2>Data Structures</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">struct </td><td class="memItemRight" valign="bottom"><b>string</b></td></tr> - -<tr><td colspan="2"><br><h2>Defines</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="ga8" doxytag="string::STP_STRING_SIZE"></a> -#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__string.html#ga8">STP_STRING_SIZE</a> 2048</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Maximum string size allowed in Strings. <br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__string.html#ga9">_stp_string_cat</a>(str1, str2)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">ConCATenate (append) a String or C string to a String. <a href="#ga9"></a><br></td></tr> -<tr><td colspan="2"><br><h2>Typedefs</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="ga1" doxytag="string::String"></a> -typedef string * </td><td class="memItemRight" valign="bottom"><b>String</b></td></tr> - -<tr><td colspan="2"><br><h2>Functions</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">String </td><td class="memItemRight" valign="bottom"><a class="el" href="group__string.html#ga2">_stp_string_init</a> (int num)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Initialize a String for our use. <a href="#ga2"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__string.html#ga3">_stp_sprintf</a> (String str, const char *fmt,...)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Sprintf into a String. <a href="#ga3"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__string.html#ga4">_stp_vsprintf</a> (String str, const char *fmt, va_list args)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Vsprintf into a String Use this if your function already has a va_list. <a href="#ga4"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__string.html#ga5">_stp_string_cat_cstr</a> (String str1, const char *str2)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">ConCATenate (append) a C string to a String. <a href="#ga5"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__string.html#ga6">_stp_string_cat_string</a> (String str1, String str2)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">ConCATenate (append) a String to a String. <a href="#ga6"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__string.html#ga7">_stp_string_ptr</a> (String str)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Get a pointer to String's buffer For rare cases when a C string is needed and you have a String. <a href="#ga7"></a><br></td></tr> -</table> -<hr><a name="_details"></a><h2>Detailed Description</h2> -One of the biggest restrictions the library has is that it cannot allocate things like strings off the stack. -<p> -It is also not a good idea to dynamically allocate space for strings with kmalloc(). That leaves us with statically allocated space for strings. This is what is implemented in the String module. Strings use preallocated per-cpu buffers and are safe to use (unlike C strings). <hr><h2>Define Documentation</h2> -<a class="anchor" name="ga9" doxytag="string.c::_stp_string_cat"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">#define _stp_string_cat </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top">str1, <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>str2 </td> - <td class="mdname1" valign="top" nowrap> </td> - <td class="md" valign="top"> ) </td> - <td class="md" nowrap></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -<b>Value:</b><div class="fragment"><pre class="fragment">({ \ - <span class="keywordflow">if</span> (__builtin_types_compatible_p (typeof (str2), <span class="keywordtype">char</span>[])) { \ - <span class="keywordtype">char</span> *x = (<span class="keywordtype">char</span> *)str2; \ - _str_string_cat_cstr(str1,x); \ - } <span class="keywordflow">else</span> { \ - String x = (String)str2; \ - _str_string_cat_string(str1,x); \ - } \ - }) -</pre></div>ConCATenate (append) a String or C string to a String. -<p> -This macro selects the proper function to call. <dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>str1</em> </td><td>A String </td></tr> - <tr><td valign="top"></td><td valign="top"><em>str2</em> </td><td>A String or C string (char *) </td></tr> - </table> -</dl> -<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__string.html#ga5">_stp_string_cat_cstr</a> <a class="el" href="group__string.html#ga6">_stp_string_cat_string</a> </dd></dl> - -<p> -Definition at line <a class="el" href="string_8c-source.html#l00150">150</a> of file <a class="el" href="string_8c-source.html">string.c</a>. </td> - </tr> -</table> -<hr><h2>Function Documentation</h2> -<a class="anchor" name="ga3" doxytag="string.c::_stp_sprintf"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">void _stp_sprintf </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top">String </td> - <td class="mdname" nowrap> <em>str</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>const char * </td> - <td class="mdname" nowrap> <em>fmt</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap> </td> - <td class="mdname" nowrap> <em>...</em></td> - </tr> - <tr> - <td class="md"></td> - <td class="md">) </td> - <td class="md" colspan="2"></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Sprintf into a String. -<p> -Like printf, except output goes into a String. Safe because overflowing the buffer is not allowed. Size is limited by length of String, <a class="el" href="group__string.html#ga8">STP_STRING_SIZE</a>.<p> -<dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>str</em> </td><td>String </td></tr> - <tr><td valign="top"></td><td valign="top"><em>fmt</em> </td><td>A printf-style format string followed by a variable number of args. </td></tr> - </table> -</dl> - -<p> -Definition at line <a class="el" href="string_8c-source.html#l00077">77</a> of file <a class="el" href="string_8c-source.html">string.c</a>. -<p> -References <a class="el" href="string_8c-source.html#l00020">STP_STRING_SIZE</a>. -<p> -Referenced by <a class="el" href="sym_8c-source.html#l00030">_stp_symbol_sprint()</a>. </td> - </tr> -</table> -<a class="anchor" name="ga5" doxytag="string.c::_stp_string_cat_cstr"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">void _stp_string_cat_cstr </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top">String </td> - <td class="mdname" nowrap> <em>str1</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>const char * </td> - <td class="mdname" nowrap> <em>str2</em></td> - </tr> - <tr> - <td class="md"></td> - <td class="md">) </td> - <td class="md" colspan="2"></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -ConCATenate (append) a C string to a String. -<p> -Like strcat(). <dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>str1</em> </td><td>String </td></tr> - <tr><td valign="top"></td><td valign="top"><em>str2</em> </td><td>C string (char *) </td></tr> - </table> -</dl> -<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__string.html#ga9">_stp_string_cat</a> </dd></dl> - -<p> -Definition at line <a class="el" href="string_8c-source.html#l00106">106</a> of file <a class="el" href="string_8c-source.html">string.c</a>. -<p> -References <a class="el" href="string_8c-source.html#l00020">STP_STRING_SIZE</a>. </td> - </tr> -</table> -<a class="anchor" name="ga6" doxytag="string.c::_stp_string_cat_string"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">void _stp_string_cat_string </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top">String </td> - <td class="mdname" nowrap> <em>str1</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>String </td> - <td class="mdname" nowrap> <em>str2</em></td> - </tr> - <tr> - <td class="md"></td> - <td class="md">) </td> - <td class="md" colspan="2"></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -ConCATenate (append) a String to a String. -<p> -Like strcat(). <dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>str1</em> </td><td>String </td></tr> - <tr><td valign="top"></td><td valign="top"><em>str2</em> </td><td>String </td></tr> - </table> -</dl> -<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="group__string.html#ga9">_stp_string_cat</a> </dd></dl> - -<p> -Definition at line <a class="el" href="string_8c-source.html#l00121">121</a> of file <a class="el" href="string_8c-source.html">string.c</a>. -<p> -References <a class="el" href="string_8c-source.html#l00020">STP_STRING_SIZE</a>. </td> - </tr> -</table> -<a class="anchor" name="ga2" doxytag="string.c::_stp_string_init"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">String _stp_string_init </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top">int </td> - <td class="mdname1" valign="top" nowrap> <em>num</em> </td> - <td class="md" valign="top"> ) </td> - <td class="md" nowrap></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Initialize a String for our use. -<p> -This grabs one of the global Strings for our use.<p> -<dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>num</em> </td><td>Number of the preallocated String to use. #STP_NUM_STRINGS are statically allocated for our use. The translator (or author) should be sure to grab a free one. </td></tr> - </table> -</dl> -<dl compact><dt><b><a class="el" href="todo.html#_todo000009">Todo:</a></b></dt><dd>Global (and static) Strings not implemented yet. </dd></dl> - -<p> -Definition at line <a class="el" href="string_8c-source.html#l00042">42</a> of file <a class="el" href="string_8c-source.html">string.c</a>. -<p> -References <a class="el" href="io_8c-source.html#l00029">_stp_log()</a>. </td> - </tr> -</table> -<a class="anchor" name="ga7" doxytag="string.c::_stp_string_ptr"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">char* _stp_string_ptr </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top">String </td> - <td class="mdname1" valign="top" nowrap> <em>str</em> </td> - <td class="md" valign="top"> ) </td> - <td class="md" nowrap></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Get a pointer to String's buffer For rare cases when a C string is needed and you have a String. -<p> -One example is when you want to print a String with <a class="el" href="group__print.html#ga3">_stp_printf()</a>. <dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>str</em> </td><td>String </td></tr> - </table> -</dl> -<dl compact><dt><b>Returns:</b></dt><dd>A C string (char *) </dd></dl> -<dl compact><dt><b>Note:</b></dt><dd>Readonly. Don't write to this pointer or it will mess up the internal String state and probably mess up your output or crash something. </dd></dl> - -<p> -Definition at line <a class="el" href="string_8c-source.html#l00138">138</a> of file <a class="el" href="string_8c-source.html">string.c</a>. </td> - </tr> -</table> -<a class="anchor" name="ga4" doxytag="string.c::_stp_vsprintf"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">void _stp_vsprintf </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top">String </td> - <td class="mdname" nowrap> <em>str</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>const char * </td> - <td class="mdname" nowrap> <em>fmt</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>va_list </td> - <td class="mdname" nowrap> <em>args</em></td> - </tr> - <tr> - <td class="md"></td> - <td class="md">) </td> - <td class="md" colspan="2"></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Vsprintf into a String Use this if your function already has a va_list. -<p> -You probably want <a class="el" href="group__string.html#ga3">_stp_sprintf()</a>. -<p> -Definition at line <a class="el" href="string_8c-source.html#l00092">92</a> of file <a class="el" href="string_8c-source.html">string.c</a>. -<p> -References <a class="el" href="string_8c-source.html#l00020">STP_STRING_SIZE</a>. </td> - </tr> -</table> -</body></html> diff --git a/runtime/docs/html/group__sym.html b/runtime/docs/html/group__sym.html deleted file mode 100644 index d5b24087..00000000 --- a/runtime/docs/html/group__sym.html +++ /dev/null @@ -1,113 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: Symbolic Functions</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1>Symbolic Functions</h1>Symbolic Lookup Functions. -<a href="#_details">More...</a><table border="0" cellpadding="0" cellspacing="0"> -<tr><td></td></tr> -<tr><td colspan="2"><br><h2>Functions</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">String </td><td class="memItemRight" valign="bottom"><a class="el" href="group__sym.html#ga1">_stp_symbol_sprint</a> (String str, unsigned long address)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Write addresses symbolically into a String. <a href="#ga1"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__sym.html#ga2">_stp_symbol_print</a> (unsigned long address)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Print addresses symbolically to the print buffer. <a href="#ga2"></a><br></td></tr> -</table> -<hr><a name="_details"></a><h2>Detailed Description</h2> -Symbolic Lookup Functions. -<p> -<hr><h2>Function Documentation</h2> -<a class="anchor" name="ga2" doxytag="sym.c::_stp_symbol_print"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">void _stp_symbol_print </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top">unsigned long </td> - <td class="mdname1" valign="top" nowrap> <em>address</em> </td> - <td class="md" valign="top"> ) </td> - <td class="md" nowrap></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Print addresses symbolically to the print buffer. -<p> -<dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>address</em> </td><td>The address to lookup. </td></tr> - </table> -</dl> -<dl compact><dt><b>Note:</b></dt><dd>Symbolic lookups should not normally be done within a probe because it is too time-consuming. Use at module exit time. </dd></dl> - -<p> -Definition at line <a class="el" href="sym_8c-source.html#l00054">54</a> of file <a class="el" href="sym_8c-source.html">sym.c</a>. -<p> -References <a class="el" href="print_8c-source.html#l00099">_stp_printf()</a>. </td> - </tr> -</table> -<a class="anchor" name="ga1" doxytag="sym.c::_stp_symbol_sprint"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">String _stp_symbol_sprint </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top">String </td> - <td class="mdname" nowrap> <em>str</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>unsigned long </td> - <td class="mdname" nowrap> <em>address</em></td> - </tr> - <tr> - <td class="md"></td> - <td class="md">) </td> - <td class="md" colspan="2"></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Write addresses symbolically into a String. -<p> -<dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>str</em> </td><td>String </td></tr> - <tr><td valign="top"></td><td valign="top"><em>address</em> </td><td>The address to lookup. </td></tr> - </table> -</dl> -<dl compact><dt><b>Note:</b></dt><dd>Symbolic lookups should not normally be done within a probe because it is too time-consuming. Use at module exit time. </dd></dl> - -<p> -Definition at line <a class="el" href="sym_8c-source.html#l00030">30</a> of file <a class="el" href="sym_8c-source.html">sym.c</a>. -<p> -References <a class="el" href="string_8c-source.html#l00077">_stp_sprintf()</a>. </td> - </tr> -</table> -</body></html> diff --git a/runtime/docs/html/index.html b/runtime/docs/html/index.html deleted file mode 100644 index e51162e4..00000000 --- a/runtime/docs/html/index.html +++ /dev/null @@ -1,58 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: SystemTap Runtime</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindexHL" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1>SystemTap Runtime </h1> -<p> -<h3 align="center">0.2 </h3><h2><a class="anchor" name="intro_sec"> -Introduction</a></h2> -This document describes the implementation of the SystemTap Runtime. It is intended for developers of the SystemTap Language translator or, possibly TapSet authors. These functions are not directly available from the SystemTap Language.<p> -The SystemTap Runtime Library consists of all functions and code fragments needed by the compiler/translator to include in building a kernel module using kprobes. It also include I/O code to transmit its output from the kernel to userspace.<p> -In addition to the library, the runtime includes a SystemTap user-space daemon (stpd). Stpd grabs data sent from the I/O code in the runtime and displays it and/or saves it to files. Stpd (or a script invoking it) will handle other issues like inserting and removing modules.<p> -Stpd and the I/O code make use of both relayfs and netlink for communication. For kernels without relayfs builtin, it is provided as a standalone module under the runtime directory.<h2><a class="anchor" name="design_sec"> -Design</a></h2> -<h3><a class="anchor" name="impl_sec"> -Implementation</a></h3> -The library is written in C and is really not a library but a collection of code That can be conditionally included in a modules. It may become a library later, but for now there are some advantages to being able to change the sizes of static items with simple #defines.<h3><a class="anchor" name="map_sec"> -Maps (Associative Arrays)</a></h3> -Maps are implemented as hash lists. It is not expected that users will attempt to collect so much data in kernel space that performance problems will require more complex solutions such as AVL trees.<p> -Maps are created with <a class="el" href="group__maps.html#ga2">_stp_map_new()</a>. Each map can hold only one type of data; int64, string, or statistics. Each element belonging to a map can have up to 2 keys and a value. Implemented key types are strings and longs.<p> -To simplify the implementation, the functions to set the key and the functions to set the data are separated. That means we need only 4 functions to set the key and 3 functions to set the value.<p> -For example: <div class="fragment"><pre class="fragment"><span class="comment">/* create a map with a max of 100 elements */</span> -<a class="code" href="group__maps.html#ga1">MAP</a> mymap = map_new(100, INT64); - -<span class="comment">/* mymap[birth year] = 2000 */</span> -map_key_str (mymap, <span class="stringliteral">"birth year"</span>); -map_set_int64 (mymap, 2000); -</pre></div><p> -All elements have a default value of 0 (or NULL). Elements are only saved to the map when their value is set to something nonzero. This means that querying for the existance of a key is inexpensive because no element is created, just a hash table lookup.<h3><a class="anchor" name="list_sec"> -Lists</a></h3> -A list is a special map which has internally ascending long integer keys. Adding a value to a list does not require setting a key first. Create a list with <a class="el" href="group__lists.html#ga0">_stp_list_new()</a>. Add to it with <a class="el" href="group__lists.html#ga2">_stp_list_add_str()</a> and <a class="el" href="group__lists.html#ga4">_stp_list_add_int64()</a>. Clear it with <a class="el" href="group__lists.html#ga1">_stp_list_clear()</a>.<h3><a class="anchor" name="string_sec"> -Strings</a></h3> -One of the biggest restrictions the library has is that it cannot allocate things like strings off the stack. It is also not a good idea to dynamically allocate space for strings with kmalloc(). That leaves us with statically allocated space for strings. This is what is implemented in the String module. Strings use preallocated per-cpu buffers and are safe to use (unlike C strings).<h3><a class="anchor" name="io_sec"> -I/O</a></h3> -Generally things are written to a "print buffer" using the internal functions _stp_print_xxx(). <div class="fragment"><pre class="fragment"><a class="code" href="group__print.html#ga11">_stp_print</a> (<span class="stringliteral">"Output is: "</span>); -<a class="code" href="group__print.html#ga3">_stp_printf</a> (<span class="stringliteral">"pid is %d "</span>, current->pid); -<a class="code" href="group__print.html#ga3">_stp_printf</a> (<span class="stringliteral">"name is %s"</span>, current->comm); -</pre></div> before the probe returns it must call <a class="el" href="group__print.html#ga2">_stp_print_flush()</a>. This timestamps the accumulated print buffer and sends it to relayfs. When relayfs fills an internal buffer, the user-space daemon is notified data is ready and reads a bug per-cpu chunk, which contains a line like: <div class="fragment"><pre class="fragment"> -[123456.000002] Output is: pid is 1234 name is bash -</pre></div><p> -The user-daemon (stpd) saves this data to a file named something like "stpd_cpu2". When the user hits ^c, a timer expires, or the probe module notifies stpd (through a netlink command channel) that it wants to terminate, stpd does "system(rmmod)" then collects the last output before exiting. As an option, if we don't need bulk per-cpu data, we can put <div class="fragment"><pre class="fragment"><span class="preprocessor">#define STP_NETLINK_ONLY</span> -</pre></div> at the top of the module and all output will go over a netlink channel. In the SystemTap language, we will provide some simple functions to control the buffering policy, which will control the use of netlink and parameters to relayfs and stpd.<h2><a class="anchor" name="status_sec"> -Status</a></h2> -<ul> -<li>Maps are implemented and tested. Histograms are not yet finished. </li> -<li>Copy_From_User functions are done. </li> -<li>If maps overflow or memory runs out for some reason, globals are set but nothing is done yet. I expect to implement a function to tell the system to either ignore it or unload the module and quit. </li> -<li>Stack functions need much improvement.</li> -</ul> -<h2><a class="anchor" name="probe_sec"> -Example Probes</a></h2> -Working sample probe code using the runtime is in runtime/probes. <a href="dir_000000.html">Browse probes.</a><h2><a class="anchor" name="todo_sec"> -ToDo</a></h2> -<a class="el" href="todo.html">Click Here for Complete List </a><h2><a class="anchor" name="links"> -Links</a></h2> -<a href="http://sources.redhat.com/systemtap/">SystemTap Project Page</a> </body></html> diff --git a/runtime/docs/html/io_8c-source.html b/runtime/docs/html/io_8c-source.html deleted file mode 100644 index 82721232..00000000 --- a/runtime/docs/html/io_8c-source.html +++ /dev/null @@ -1,118 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: io.c Source File</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1>io.c</h1><a href="io_8c.html">Go to the documentation of this file.</a><div class="fragment"><pre class="fragment">00001 <span class="preprocessor">#ifndef _IO_C_ </span><span class="comment">/* -*- linux-c -*- */</span> -00002 <span class="preprocessor">#define _IO_C_</span> -00003 <span class="preprocessor"></span> -00004 <span class="preprocessor">#include "relay-app.h"</span> -00005 <span class="preprocessor">#include "print.c"</span> -00006 <span class="comment"></span> -00007 <span class="comment">/** @file io.c</span> -00008 <span class="comment"> * @brief I/O functions</span> -00009 <span class="comment"> */</span><span class="comment"></span> -00010 <span class="comment">/** @addtogroup io I/O</span> -00011 <span class="comment"> * I/O functions</span> -00012 <span class="comment"> * @{</span> -00013 <span class="comment"> */</span> -00014 <span class="comment"></span> -00015 <span class="comment">/** private buffer for _stp_log() */</span> -<a name="l00016"></a><a class="code" href="group__io.html#ga9">00016</a> <span class="preprocessor">#define STP_LOG_BUF_LEN 2047</span> -00017 <span class="preprocessor"></span><span class="keyword">static</span> <span class="keywordtype">char</span> _stp_lbuf[NR_CPUS][<a class="code" href="group__io.html#ga9">STP_LOG_BUF_LEN</a> + 1]; -00018 <span class="comment"></span> -00019 <span class="comment">/** Logs Data.</span> -00020 <span class="comment"> * This function prints to the system log if stpd has not connected</span> -00021 <span class="comment"> * yet. Otherwise it sends the message immediately to stpd.</span> -00022 <span class="comment"> * @param fmt A variable number of args.</span> -00023 <span class="comment"> * @note Lines are limited in length by printk buffer. If there is</span> -00024 <span class="comment"> * no newline in the format string, then other syslog output could</span> -00025 <span class="comment"> * get appended to the SystemTap line.</span> -00026 <span class="comment"> * @todo Evaluate if this function is necessary.</span> -00027 <span class="comment"> */</span> -00028 -<a name="l00029"></a><a class="code" href="group__io.html#ga2">00029</a> <span class="keywordtype">void</span> <a class="code" href="group__io.html#ga2">_stp_log</a> (<span class="keyword">const</span> <span class="keywordtype">char</span> *fmt, ...) -00030 { -00031 <span class="keywordtype">int</span> num; -00032 <span class="keywordtype">char</span> *buf = &_stp_lbuf[smp_processor_id()][0]; -00033 va_list args; -00034 va_start(args, fmt); -00035 num = vscnprintf (buf, <a class="code" href="group__io.html#ga9">STP_LOG_BUF_LEN</a>, fmt, args); -00036 va_end(args); -00037 buf[num] = <span class="charliteral">'\0'</span>; -00038 -00039 <span class="keywordflow">if</span> (app.logging) -00040 send_reply (STP_REALTIME_DATA, buf, num + 1, stpd_pid); -00041 <span class="keywordflow">else</span> -00042 printk(<span class="stringliteral">"STP: %s"</span>, buf); -00043 } -00044 -00045 <span class="keyword">static</span> <span class="keywordtype">void</span> stpd_app_started(<span class="keywordtype">void</span>) -00046 { -00047 printk (<span class="stringliteral">"stpd has started.\n"</span>); -00048 } -00049 -00050 <span class="keyword">static</span> <span class="keywordtype">void</span> stpd_app_stopped(<span class="keywordtype">void</span>) -00051 { -00052 printk (<span class="stringliteral">"stpd has stopped.\n"</span>); -00053 } -00054 -00055 <span class="keyword">static</span> <span class="keywordtype">void</span> probe_exit(<span class="keywordtype">void</span>); -00056 -00057 <span class="preprocessor">#include <linux/delay.h></span> -00058 <span class="keyword">static</span> <span class="keywordtype">int</span> stpd_command (<span class="keywordtype">int</span> type, <span class="keywordtype">void</span> *data) -00059 { -00060 <span class="keywordflow">if</span> (type == STP_EXIT) { -00061 printk (<span class="stringliteral">"STP_EXIT received\n"</span>); -00062 probe_exit(); -00063 <span class="preprocessor">#ifndef STP_NETLINK_ONLY</span> -00064 <span class="preprocessor"></span> relay_flush(app.chan); -00065 ssleep(2); <span class="comment">/* FIXME: time for data to be flushed */</span> -00066 <span class="preprocessor">#endif</span> -00067 <span class="preprocessor"></span> send_reply (STP_EXIT, __this_module.name, strlen(__this_module.name) + 1, stpd_pid); -00068 <span class="keywordflow">return</span> 1; -00069 } -00070 <span class="keywordflow">return</span> 0; -00071 } -00072 -00073 <span class="comment">/*</span> -00074 <span class="comment"> * relay-app callbacks</span> -00075 <span class="comment"> */</span> -00076 <span class="keyword">static</span> <span class="keyword">struct </span>relay_app_callbacks stp_callbacks = -00077 { -00078 .app_started = stpd_app_started, -00079 .app_stopped = stpd_app_stopped, -00080 .user_command = stpd_command -00081 }; -00082 <span class="comment"></span> -00083 <span class="comment">/** Opens netlink and relayfs connections to stpd.</span> -00084 <span class="comment"> * This must be called before any I/O is done, probably </span> -00085 <span class="comment"> * at the start of module initialization.</span> -00086 <span class="comment"> */</span> -<a name="l00087"></a><a class="code" href="group__io.html#ga7">00087</a> <span class="keywordtype">int</span> <a class="code" href="group__io.html#ga7">_stp_netlink_open</a>(<span class="keywordtype">void</span>) -00088 { -00089 <span class="keywordflow">if</span> (init_relay_app(<span class="stringliteral">"stpd"</span>, <span class="stringliteral">"cpu"</span>, &stp_callbacks)) { -00090 printk (<span class="stringliteral">"STP: couldn't init relay app\n"</span>); -00091 <span class="keywordflow">return</span> -1; -00092 } -00093 <span class="keywordflow">return</span> 0; -00094 } -00095 <span class="comment"></span> -00096 <span class="comment">/** Closes netlink and relayfs connections to stpd.</span> -00097 <span class="comment"> * This must be called after all I/O is done, probably </span> -00098 <span class="comment"> * at the end of module cleanup.</span> -00099 <span class="comment"> * @returns 0 on success. -1 if there is a problem establishing</span> -00100 <span class="comment"> * a connection.</span> -00101 <span class="comment"> */</span> -00102 -<a name="l00103"></a><a class="code" href="group__io.html#ga8">00103</a> <span class="keywordtype">void</span> <a class="code" href="group__io.html#ga8">_stp_netlink_close</a> (<span class="keywordtype">void</span>) -00104 { -00105 send_reply (STP_DONE, NULL, 0, stpd_pid); -00106 close_relay_app(); -00107 } -00108 <span class="comment"></span> -00109 <span class="comment">/** @} */</span> -00110 <span class="preprocessor">#endif </span><span class="comment">/* _IO_C_ */</span> -</pre></div></body></html> diff --git a/runtime/docs/html/io_8c.html b/runtime/docs/html/io_8c.html deleted file mode 100644 index 1aca24d7..00000000 --- a/runtime/docs/html/io_8c.html +++ /dev/null @@ -1,38 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: io.c File Reference</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1>io.c File Reference</h1>I/O functions. <a href="#_details">More...</a> -<p> -<code>#include "relay-app.h"</code><br> -<code>#include "print.c"</code><br> -<code>#include <linux/delay.h></code><br> - -<p> -<a href="io_8c-source.html">Go to the source code of this file.</a><table border="0" cellpadding="0" cellspacing="0"> -<tr><td></td></tr> -<tr><td colspan="2"><br><h2>Defines</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="ga9" doxytag="io.c::STP_LOG_BUF_LEN"></a> -#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__io.html#ga9">STP_LOG_BUF_LEN</a> 2047</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">private buffer for <a class="el" href="group__io.html#ga2">_stp_log()</a> <br></td></tr> -<tr><td colspan="2"><br><h2>Functions</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__io.html#ga2">_stp_log</a> (const char *fmt,...)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Logs Data. <a href="group__io.html#ga2"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__io.html#ga7">_stp_netlink_open</a> (void)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Opens netlink and relayfs connections to stpd. <a href="group__io.html#ga7"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__io.html#ga8">_stp_netlink_close</a> (void)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Closes netlink and relayfs connections to stpd. <a href="group__io.html#ga8"></a><br></td></tr> -</table> -<hr><a name="_details"></a><h2>Detailed Description</h2> -I/O functions. -<p> - -<p> -Definition in file <a class="el" href="io_8c-source.html">io.c</a>.</body></html> diff --git a/runtime/docs/html/kprobe__where__funct_8c-source.html b/runtime/docs/html/kprobe__where__funct_8c-source.html deleted file mode 100644 index a1d096a5..00000000 --- a/runtime/docs/html/kprobe__where__funct_8c-source.html +++ /dev/null @@ -1,99 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: probes/where_func/kprobe_where_funct.c Source File</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<div class="nav"> -<a class="el" href="dir_000000.html">probes</a> / <a class="el" href="dir_000004.html">where_func</a></div> -<h1>kprobe_where_funct.c</h1><div class="fragment"><pre class="fragment">00001 <span class="comment">/* kprobe_where_funct.c</span> -00002 <span class="comment"> this is a simple module to get information about calls to a function that is passed as a module option</span> -00003 <span class="comment"> Will Cohen</span> -00004 <span class="comment">*/</span> -00005 -00006 <span class="preprocessor">#define HASH_TABLE_BITS 8</span> -00007 <span class="preprocessor"></span><span class="preprocessor">#define HASH_TABLE_SIZE (1<<HASH_TABLE_BITS)</span> -00008 <span class="preprocessor"></span><span class="preprocessor">#define BUCKETS 16 </span><span class="comment">/* largest histogram width */</span> -00009 <span class="preprocessor">#define STP_NETLINK_ONLY</span> -00010 <span class="preprocessor"></span><span class="preprocessor">#define STP_NUM_STRINGS 1</span> -00011 <span class="preprocessor"></span> -00012 <span class="preprocessor">#include "<a class="code" href="runtime_8h.html">runtime.h</a>"</span> -00013 <span class="preprocessor">#include "<a class="code" href="map_8c.html">map.c</a>"</span> -00014 <span class="preprocessor">#include "<a class="code" href="probes_8c.html">probes.c</a>"</span> -00015 <span class="preprocessor">#include "<a class="code" href="current_8c.html">current.c</a>"</span> -00016 <span class="preprocessor">#include "sym.c"</span> -00017 -00018 MODULE_DESCRIPTION(<span class="stringliteral">"SystemTap probe: where_func"</span>); -00019 MODULE_AUTHOR(<span class="stringliteral">"Will Cohen and Martin Hunt"</span>); -00020 -00021 <span class="keyword">static</span> <span class="keywordtype">char</span> default_name[] = <span class="stringliteral">"schedule"</span>; -00022 <span class="keyword">static</span> <span class="keywordtype">char</span> *funct_name = default_name; -00023 module_param(funct_name, charp, 0); -00024 MODULE_PARM_DESC(funct_name, <span class="stringliteral">"function entry name.\n"</span>); -00025 -00026 <span class="keyword">static</span> <span class="keywordtype">int</span> count_funct = 0; -00027 -00028 <a class="code" href="group__maps.html#ga1">MAP</a> funct_locations; -00029 -00030 <span class="keyword">static</span> <span class="keywordtype">int</span> inst_funct(<span class="keyword">struct</span> kprobe *p, <span class="keyword">struct</span> pt_regs *regs) -00031 { -00032 <span class="keywordtype">long</span> ret_addr = <a class="code" href="group__current.html#ga0">_stp_ret_addr</a>(regs); -00033 ++count_funct; -00034 <a class="code" href="group__maps.html#ga13">_stp_map_key_long</a>(funct_locations, ret_addr); -00035 <a class="code" href="group__maps.html#ga17">_stp_map_add_int64</a>(funct_locations, 1); -00036 <span class="keywordflow">return</span> 0; -00037 } -00038 -00039 <span class="comment">/*For each probe you need to allocate a kprobe structure*/</span> -00040 <span class="keyword">static</span> <span class="keyword">struct </span>kprobe kp[] = { -00041 { -00042 .addr = default_name, -00043 .pre_handler = inst_funct, -00044 } -00045 }; -00046 <span class="preprocessor">#define MAX_KPROBES (sizeof(kp)/sizeof(struct kprobe))</span> -00047 <span class="preprocessor"></span> -00048 <span class="keywordtype">int</span> init_module(<span class="keywordtype">void</span>) -00049 { -00050 <span class="keywordtype">int</span> ret; -00051 -00052 <span class="keywordflow">if</span> (<a class="code" href="group__io.html#ga7">_stp_netlink_open</a>() < 0) -00053 return -1; -00054 -00055 funct_locations = _stp_map_new(1000, INT64); -00056 -00057 if (funct_name) -00058 kp[0].addr = funct_name; -00059 -00060 ret = _stp_register_kprobes (kp, MAX_KPROBES); -00061 -00062 return ret; -00063 } -00064 -00065 static <span class="keywordtype">void</span> probe_exit (<span class="keywordtype">void</span>) -00066 { -00067 <span class="keyword">struct </span>map_node_int64 *ptr; -00068 -00069 <a class="code" href="probes_8c.html#a4">_stp_unregister_kprobes</a> (kp, MAX_KPROBES); -00070 -00071 <a class="code" href="group__print.html#ga3">_stp_printf</a>(<span class="stringliteral">"%s() called %d times.\n"</span>, funct_name, count_funct); -00072 <a class="code" href="group__print.html#ga3">_stp_printf</a>(<span class="stringliteral">"NUM\tCaller\n"</span>, funct_name); -00073 -00074 <span class="comment">/* now walk the hash table and print out all the information */</span> -00075 <a class="code" href="group__maps.html#ga32">foreach</a>(funct_locations, ptr) { -00076 <a class="code" href="group__print.html#ga3">_stp_printf</a>(<span class="stringliteral">"%lld\t"</span>, ptr->val); -00077 <a class="code" href="group__sym.html#ga2">_stp_symbol_print</a> (<a class="code" href="group__maps.html#ga27">key1int</a>(ptr)); -00078 <a class="code" href="group__print.html#ga2">_stp_print_flush</a>(); -00079 } -00080 -00081 <a class="code" href="group__maps.html#ga7">_stp_map_del</a>(funct_locations); -00082 } -00083 -00084 <span class="keywordtype">void</span> cleanup_module(<span class="keywordtype">void</span>) -00085 { -00086 <a class="code" href="group__io.html#ga8">_stp_netlink_close</a>(); -00087 } -00088 -00089 MODULE_LICENSE(<span class="stringliteral">"GPL"</span>); -</pre></div></body></html> diff --git a/runtime/docs/html/map_8c-source.html b/runtime/docs/html/map_8c-source.html deleted file mode 100644 index 4dac0d8f..00000000 --- a/runtime/docs/html/map_8c-source.html +++ /dev/null @@ -1,920 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: map.c Source File</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1>map.c</h1><a href="map_8c.html">Go to the documentation of this file.</a><div class="fragment"><pre class="fragment">00001 <span class="preprocessor">#ifndef _MAP_C_ </span><span class="comment">/* -*- linux-c -*- */</span> -00002 <span class="preprocessor">#define _MAP_C_</span> -00003 <span class="preprocessor"></span><span class="comment"></span> -00004 <span class="comment">/** @file map.c</span> -00005 <span class="comment"> * @brief Implements maps (associative arrays) and lists</span> -00006 <span class="comment"> */</span> -00007 -00008 <span class="preprocessor">#include "<a class="code" href="map_8h.html">map.h</a>"</span> -00009 <span class="preprocessor">#include "<a class="code" href="alloc_8c.html">alloc.c</a>"</span> -00010 <span class="preprocessor">#include "<a class="code" href="string_8c.html">string.c</a>"</span> -00011 -00012 <span class="keyword">static</span> <span class="keywordtype">int</span> map_sizes[] = { -00013 <span class="keyword">sizeof</span>(<span class="keyword">struct </span>map_node_int64), -00014 sizeof(struct map_node_stat), -00015 sizeof(struct map_node_str), -00016 0 -00017 }; -00018 -00019 <span class="keyword">static</span> <span class="keywordtype">unsigned</span> string_hash(<span class="keyword">const</span> <span class="keywordtype">char</span> *key1, <span class="keyword">const</span> <span class="keywordtype">char</span> *key2) -00020 { -00021 <span class="keywordtype">int</span> hash = 0, count = 0; -00022 <span class="keywordtype">char</span> *v1 = (<span class="keywordtype">char</span> *)key1; -00023 <span class="keywordtype">char</span> *v2 = (<span class="keywordtype">char</span> *)key2; -00024 <span class="keywordflow">while</span> (*v1 && count++ < 5) { -00025 hash += *v1++; -00026 } -00027 <span class="keywordflow">while</span> (v2 && *v2 && count++ < 5) { -00028 hash += *v2++; -00029 } -00030 <span class="keywordflow">return</span> hash_long((<span class="keywordtype">unsigned</span> <span class="keywordtype">long</span>)hash, HASH_TABLE_BITS); -00031 } -00032 -00033 <span class="keyword">static</span> <span class="keywordtype">unsigned</span> mixed_hash(<span class="keyword">const</span> <span class="keywordtype">char</span> *key1, <span class="keywordtype">long</span> key2) -00034 { -00035 <span class="keywordtype">int</span> hash = 0, count = 0; -00036 <span class="keywordtype">char</span> *v = (<span class="keywordtype">char</span> *)key1; -00037 <span class="keywordflow">while</span> (v && *v && count++ < 5) -00038 hash += *v++; -00039 return hash_long((<span class="keywordtype">unsigned</span> <span class="keywordtype">long</span>)(hash ^ key2), HASH_TABLE_BITS); -00040 } -00041 <span class="comment"></span> -00042 <span class="comment">/** @addtogroup maps </span> -00043 <span class="comment"> * Implements maps (associative arrays) and lists</span> -00044 <span class="comment"> * @{ </span> -00045 <span class="comment"> */</span> -00046 <span class="comment"></span> -00047 <span class="comment">/** Create a new map.</span> -00048 <span class="comment"> * Maps must be created at module initialization time.</span> -00049 <span class="comment"> * @param max_entries The maximum number of entries allowed. Currently that number will</span> -00050 <span class="comment"> * be preallocated. If more entries are required, the oldest ones will be deleted. This makes</span> -00051 <span class="comment"> * it effectively a circular buffer. If max_entries is 0, there will be no maximum and entries</span> -00052 <span class="comment"> * will be allocated dynamically.</span> -00053 <span class="comment"> * @param type Type of values stored in this map. </span> -00054 <span class="comment"> * @return A MAP on success or NULL on failure.</span> -00055 <span class="comment"> */</span> -00056 -<a name="l00057"></a><a class="code" href="group__maps.html#ga2">00057</a> <a class="code" href="group__maps.html#ga1">MAP</a> _stp_map_new(<span class="keywordtype">unsigned</span> max_entries, enum valtype type) -00058 { -00059 size_t size; -00060 <a class="code" href="group__maps.html#ga1">MAP</a> m = (<a class="code" href="group__maps.html#ga1">MAP</a>) <a class="code" href="group__alloc.html#ga3">_stp_valloc</a>(<span class="keyword">sizeof</span>(<span class="keyword">struct</span> map_root)); -00061 <span class="keywordflow">if</span> (m == NULL) -00062 <span class="keywordflow">return</span> NULL; -00063 -00064 INIT_LIST_HEAD(&m->head); -00065 -00066 m->maxnum = max_entries; -00067 m->type = type; -00068 <span class="keywordflow">if</span> (type >= END) { -00069 dbug (<span class="stringliteral">"map_new: unknown type %d\n"</span>, type); -00070 <span class="keywordflow">return</span> NULL; -00071 } -00072 -00073 <span class="keywordflow">if</span> (max_entries) { -00074 <span class="keywordtype">void</span> *tmp; -00075 <span class="keywordtype">int</span> i; -00076 <span class="keyword">struct </span>list_head *e; -00077 -00078 INIT_LIST_HEAD(&m->pool); -00079 size = map_sizes[type]; -00080 tmp = <a class="code" href="group__alloc.html#ga3">_stp_valloc</a>(max_entries * size); -00081 -00082 <span class="keywordflow">for</span> (i = max_entries - 1; i >= 0; i--) { -00083 e = i * size + tmp; -00084 dbug (<span class="stringliteral">"e=%lx\n"</span>, (<span class="keywordtype">long</span>)e); -00085 list_add(e, &m->pool); -00086 } -00087 m->membuf = tmp; -00088 } -00089 <span class="keywordflow">return</span> m; -00090 } -00091 -00092 <span class="keyword">static</span> <span class="keywordtype">void</span> map_free_strings(<a class="code" href="group__maps.html#ga1">MAP</a> map, <span class="keyword">struct</span> map_node *n) -00093 { -00094 <span class="keyword">struct </span>map_node_str *m = (<span class="keyword">struct </span>map_node_str *)n; -00095 dbug (<span class="stringliteral">"n = %lx\n"</span>, (<span class="keywordtype">long</span>)n); -00096 <span class="keywordflow">if</span> (map->type == STRING) { -00097 dbug (<span class="stringliteral">"val STRING %lx\n"</span>, (<span class="keywordtype">long</span>)m->str); -00098 <span class="keywordflow">if</span> (m->str) -00099 _stp_free(m->str); -00100 } -00101 if (m->n.key1type == STR) { -00102 dbug (<span class="stringliteral">"key1 STR %lx\n"</span>, (<span class="keywordtype">long</span>)<a class="code" href="group__maps.html#ga25">key1str</a>(m)); -00103 <span class="keywordflow">if</span> (<a class="code" href="group__maps.html#ga25">key1str</a>(m)) -00104 _stp_free(key1str(m)); -00105 } -00106 if (m->n.key2type == STR) { -00107 dbug (<span class="stringliteral">"key2 STR %lx\n"</span>, (<span class="keywordtype">long</span>)<a class="code" href="group__maps.html#ga26">key2str</a>(m)); -00108 <span class="keywordflow">if</span> (<a class="code" href="group__maps.html#ga26">key2str</a>(m)) -00109 _stp_free(key2str(m)); -00110 } -00111 } -00112 <span class="comment"></span> -00113 <span class="comment">/** Deletes the current element.</span> -00114 <span class="comment"> * If no current element (key) for this map is set, this function does nothing.</span> -00115 <span class="comment"> * @param map </span> -00116 <span class="comment"> */</span> -00117 -<a name="l00118"></a><a class="code" href="group__maps.html#ga4">00118</a> <span class="keywordtype">void</span> _stp_map_key_del(<a class="code" href="group__maps.html#ga1">MAP</a> map) -00119 { -00120 <span class="keyword">struct </span>map_node *m; -00121 -00122 dbug (<span class="stringliteral">"create=%d key=%lx\n"</span>, map->create, (<span class="keywordtype">long</span>)map->key); -00123 <span class="keywordflow">if</span> (map == NULL) -00124 <span class="keywordflow">return</span>; -00125 -00126 <span class="keywordflow">if</span> (map->create) { -00127 map->create = 0; -00128 map->key = NULL; -00129 <span class="keywordflow">return</span>; -00130 } -00131 -00132 <span class="keywordflow">if</span> (map->key == NULL) -00133 <span class="keywordflow">return</span>; -00134 -00135 m = (<span class="keyword">struct </span>map_node *)map->key; -00136 -00137 <span class="comment">/* remove node from old hash list */</span> -00138 hlist_del_init(&m->hnode); -00139 -00140 <span class="comment">/* remove from entry list */</span> -00141 list_del(&m->lnode); -00142 -00143 <span class="comment">/* remove any allocated string storage */</span> -00144 map_free_strings(map, (<span class="keyword">struct</span> map_node *)map->key); -00145 -00146 <span class="keywordflow">if</span> (map->maxnum) -00147 list_add(&m->lnode, &map->pool); -00148 <span class="keywordflow">else</span> -00149 <a class="code" href="group__alloc.html#ga4">_stp_free</a>(m); -00150 -00151 map->key = NULL; -00152 map->num--; -00153 } -00154 <span class="comment"></span> -00155 <span class="comment">/** Get the first element in a map.</span> -00156 <span class="comment"> * @param map </span> -00157 <span class="comment"> * @returns a pointer to the first element.</span> -00158 <span class="comment"> * This is typically used with _stp_map_iter(). See the foreach() macro</span> -00159 <span class="comment"> * for typical usage. It probably does what you want anyway.</span> -00160 <span class="comment"> * @sa foreach</span> -00161 <span class="comment"> */</span> -00162 -<a name="l00163"></a><a class="code" href="group__maps.html#ga5">00163</a> <span class="keyword">struct </span>map_node *<a class="code" href="group__maps.html#ga5">_stp_map_start</a>(<a class="code" href="group__maps.html#ga1">MAP</a> map) -00164 { -00165 <span class="keywordflow">if</span> (map == NULL) -00166 <span class="keywordflow">return</span> NULL; -00167 -00168 dbug (<span class="stringliteral">"%lx\n"</span>, (<span class="keywordtype">long</span>)map->head.next); -00169 -00170 <span class="keywordflow">if</span> (list_empty(&map->head)) -00171 <span class="keywordflow">return</span> NULL; -00172 -00173 <span class="keywordflow">return</span> (<span class="keyword">struct</span> map_node *)map->head.next; -00174 } -00175 <span class="comment"></span> -00176 <span class="comment">/** Get the next element in a map.</span> -00177 <span class="comment"> * @param map </span> -00178 <span class="comment"> * @param m a pointer to the current element, returned from _stp_map_start()</span> -00179 <span class="comment"> * or _stp_map_iter().</span> -00180 <span class="comment"> * @returns a pointer to the next element.</span> -00181 <span class="comment"> * This is typically used with _stp_map_start(). See the foreach() macro</span> -00182 <span class="comment"> * for typical usage. It probably does what you want anyway.</span> -00183 <span class="comment"> * @sa foreach</span> -00184 <span class="comment"> */</span> -00185 -<a name="l00186"></a><a class="code" href="group__maps.html#ga6">00186</a> <span class="keyword">struct </span>map_node *<a class="code" href="group__maps.html#ga6">_stp_map_iter</a>(<a class="code" href="group__maps.html#ga1">MAP</a> map, <span class="keyword">struct</span> map_node *m) -00187 { -00188 <span class="keywordflow">if</span> (map == NULL) -00189 <span class="keywordflow">return</span> NULL; -00190 -00191 dbug (<span class="stringliteral">"%lx next=%lx prev=%lx map->head.next=%lx\n"</span>, (<span class="keywordtype">long</span>)m, -00192 (<span class="keywordtype">long</span>)m->lnode.next, (<span class="keywordtype">long</span>)m->lnode.prev, (<span class="keywordtype">long</span>)map->head.next); -00193 -00194 <span class="keywordflow">if</span> (m->lnode.next == &map->head) -00195 <span class="keywordflow">return</span> NULL; -00196 -00197 <span class="keywordflow">return</span> (<span class="keyword">struct</span> map_node *)m->lnode.next; -00198 } -00199 <span class="comment"></span> -00200 <span class="comment">/** Deletes a map.</span> -00201 <span class="comment"> * Deletes a map, freeing all memory in all elements. Normally done only when the module exits.</span> -00202 <span class="comment"> * @param map</span> -00203 <span class="comment"> */</span> -00204 -<a name="l00205"></a><a class="code" href="group__maps.html#ga7">00205</a> <span class="keywordtype">void</span> <a class="code" href="group__maps.html#ga7">_stp_map_del</a>(<a class="code" href="group__maps.html#ga1">MAP</a> map) -00206 { -00207 <span class="keywordflow">if</span> (map == NULL) -00208 <span class="keywordflow">return</span>; -00209 -00210 <span class="keywordflow">if</span> (!list_empty(&map->head)) { -00211 <span class="keyword">struct </span>map_node *ptr = (<span class="keyword">struct </span>map_node *)map->head.next; -00212 <span class="keywordflow">while</span> (ptr && ptr != (<span class="keyword">struct</span> map_node *)&map->head) { -00213 map_free_strings(map, ptr); -00214 ptr = (<span class="keyword">struct </span>map_node *)ptr->lnode.next; -00215 } -00216 } -00217 <a class="code" href="group__alloc.html#ga5">_stp_vfree</a>(map->membuf); -00218 <a class="code" href="group__alloc.html#ga5">_stp_vfree</a>(map); -00219 } -00220 -00221 <span class="comment">/********************** KEY FUNCTIONS *********************/</span> -00222 -00223 <span class="comment"></span> -00224 <span class="comment">/** Set the map's key to two longs.</span> -00225 <span class="comment"> * This sets the current element based on a key of two strings. If the keys are</span> -00226 <span class="comment"> * not found, a new element will not be created until a <i>_stp_map_set_xxx</i></span> -00227 <span class="comment"> * call.</span> -00228 <span class="comment"> * @param map</span> -00229 <span class="comment"> * @param key1 first key</span> -00230 <span class="comment"> * @param key2 second key</span> -00231 <span class="comment"> */</span> -00232 -<a name="l00233"></a><a class="code" href="group__maps.html#ga8">00233</a> <span class="keywordtype">void</span> <a class="code" href="group__maps.html#ga8">_stp_map_key_long_long</a>(<a class="code" href="group__maps.html#ga1">MAP</a> map, <span class="keywordtype">long</span> key1, <span class="keywordtype">long</span> key2) -00234 { -00235 <span class="keywordtype">unsigned</span> hv; -00236 <span class="keyword">struct </span>hlist_head *head; -00237 <span class="keyword">struct </span>hlist_node *e; -00238 -00239 <span class="keywordflow">if</span> (map == NULL) -00240 <span class="keywordflow">return</span>; -00241 -00242 hv = hash_long(key1 ^ key2, HASH_TABLE_BITS); -00243 head = &map->hashes[hv]; -00244 -00245 dbug (<span class="stringliteral">"hash for %ld,%ld is %d\n"</span>, key1, key2, hv); -00246 -00247 hlist_for_each(e, head) { -00248 <span class="keyword">struct </span>map_node *n = -00249 (<span class="keyword">struct </span>map_node *)((long)e - <span class="keyword">sizeof</span>(<span class="keyword">struct </span>hlist_node)); -00250 dbug (<span class="stringliteral">"n =%lx key=%ld,%ld\n"</span>, (<span class="keywordtype">long</span>)n, n->key1.val, n->key2.val); -00251 <span class="keywordflow">if</span> (key1 == n->key1.val && key2 == n->key2.val) { -00252 map->key = n; -00253 dbug (<span class="stringliteral">"saving key %lx\n"</span>, (<span class="keywordtype">long</span>)map->key); -00254 map->create = 0; -00255 <span class="keywordflow">return</span>; -00256 } -00257 } -00258 -00259 map->c_key1.val = key1; -00260 map->c_key2.val = key2; -00261 map->c_key1type = LONG; -00262 map->c_key2type = LONG; -00263 map->c_keyhead = head; -00264 map->create = 1; -00265 } -00266 <span class="comment"></span> -00267 <span class="comment">/** Set the map's key to two strings.</span> -00268 <span class="comment"> * This sets the current element based on a key of two strings. If the keys are</span> -00269 <span class="comment"> * not found, a new element will not be created until a <i>_stp_map_set_xxx</i></span> -00270 <span class="comment"> * call.</span> -00271 <span class="comment"> * @param map</span> -00272 <span class="comment"> * @param key1 first key</span> -00273 <span class="comment"> * @param key2 second key</span> -00274 <span class="comment"> */</span> -00275 -<a name="l00276"></a><a class="code" href="group__maps.html#ga9">00276</a> <span class="keywordtype">void</span> <a class="code" href="group__maps.html#ga9">_stp_map_key_str_str</a>(<a class="code" href="group__maps.html#ga1">MAP</a> map, <span class="keywordtype">char</span> *key1, <span class="keywordtype">char</span> *key2) -00277 { -00278 <span class="keywordtype">unsigned</span> hv; -00279 <span class="keyword">struct </span>hlist_head *head; -00280 <span class="keyword">struct </span>hlist_node *e; -00281 -00282 <span class="keywordflow">if</span> (map == NULL) -00283 <span class="keywordflow">return</span>; -00284 -00285 <span class="keywordflow">if</span> (key1 == NULL) { -00286 map->key = NULL; -00287 <span class="keywordflow">return</span>; -00288 } -00289 -00290 hv = string_hash(key1, key2); -00291 head = &map->hashes[hv]; -00292 -00293 dbug (<span class="stringliteral">"hash for %s,%s is %d\n"</span>, key1, key2, hv); -00294 -00295 hlist_for_each(e, head) { -00296 <span class="keyword">struct </span>map_node *n = -00297 (<span class="keyword">struct </span>map_node *)((long)e - <span class="keyword">sizeof</span>(<span class="keyword">struct </span>hlist_node)); -00298 dbug (<span class="stringliteral">"e =%lx key=%s,%s\n"</span>, (<span class="keywordtype">long</span>)e, n->key1.str,n->key2.str); -00299 <span class="keywordflow">if</span> (strcmp(key1, n->key1.str) == 0 -00300 && (key2 == NULL || strcmp(key2, n->key2.str) == 0)) { -00301 map->key = n; -00302 dbug (<span class="stringliteral">"saving key %lx\n"</span>, (<span class="keywordtype">long</span>)map->key); -00303 map->create = 0; -00304 <span class="keywordflow">return</span>; -00305 } -00306 } -00307 -00308 map->c_key1.str = key1; -00309 map->c_key2.str = key2; -00310 map->c_key1type = STR; -00311 map->c_key2type = STR; -00312 map->c_keyhead = head; -00313 map->create = 1; -00314 } -00315 <span class="comment"></span> -00316 <span class="comment">/** Set the map's key to a string and a long.</span> -00317 <span class="comment"> * This sets the current element based on a key of a string and a long. If the keys are</span> -00318 <span class="comment"> * not found, a new element will not be created until a <i>_stp_map_set_xxx</i></span> -00319 <span class="comment"> * call.</span> -00320 <span class="comment"> * @param map</span> -00321 <span class="comment"> * @param key1 first key</span> -00322 <span class="comment"> * @param key2 second key</span> -00323 <span class="comment"> */</span> -00324 -<a name="l00325"></a><a class="code" href="group__maps.html#ga10">00325</a> <span class="keywordtype">void</span> <a class="code" href="group__maps.html#ga10">_stp_map_key_str_long</a>(<a class="code" href="group__maps.html#ga1">MAP</a> map, <span class="keywordtype">char</span> *key1, <span class="keywordtype">long</span> key2) -00326 { -00327 <span class="keywordtype">unsigned</span> hv; -00328 <span class="keyword">struct </span>hlist_head *head; -00329 <span class="keyword">struct </span>hlist_node *e; -00330 -00331 <span class="keywordflow">if</span> (map == NULL) -00332 <span class="keywordflow">return</span>; -00333 -00334 <span class="keywordflow">if</span> (key1 == NULL) { -00335 map->key = NULL; -00336 <span class="keywordflow">return</span>; -00337 } -00338 -00339 hv = mixed_hash(key1, key2); -00340 head = &map->hashes[hv]; -00341 -00342 dbug (<span class="stringliteral">"hash for %s,%ld is %d\n"</span>, key1, key2, hv); -00343 -00344 hlist_for_each(e, head) { -00345 <span class="keyword">struct </span>map_node *n = -00346 (<span class="keyword">struct </span>map_node *)((long)e - <span class="keyword">sizeof</span>(<span class="keyword">struct </span>hlist_node)); -00347 dbug (<span class="stringliteral">"e =%lx key=%s,%ld\n"</span>, (<span class="keywordtype">long</span>)e, n->key1.str,(<span class="keywordtype">long</span>)n->key2.val); -00348 <span class="keywordflow">if</span> (strcmp(key1, n->key1.str) == 0 && key2 == n->key2.val) { -00349 map->key = n; -00350 dbug (<span class="stringliteral">"saving key %lx\n"</span>, (<span class="keywordtype">long</span>)map->key); -00351 map->create = 0; -00352 <span class="keywordflow">return</span>; -00353 } -00354 } -00355 -00356 map->c_key1.str = key1; -00357 map->c_key2.val = key2; -00358 map->c_key1type = STR; -00359 map->c_key2type = LONG; -00360 map->c_keyhead = head; -00361 map->create = 1; -00362 } -00363 <span class="comment"></span> -00364 <span class="comment">/** Set the map's key to a long and a string.</span> -00365 <span class="comment"> * This sets the current element based on a key of a long and a string. If the keys are</span> -00366 <span class="comment"> * not found, a new element will not be created until a <i>_stp_map_set_xxx</i></span> -00367 <span class="comment"> * call.</span> -00368 <span class="comment"> * @param map</span> -00369 <span class="comment"> * @param key1 first key</span> -00370 <span class="comment"> * @param key2 second key</span> -00371 <span class="comment"> */</span> -00372 -<a name="l00373"></a><a class="code" href="group__maps.html#ga11">00373</a> <span class="keywordtype">void</span> <a class="code" href="group__maps.html#ga11">_stp_map_key_long_str</a>(<a class="code" href="group__maps.html#ga1">MAP</a> map, <span class="keywordtype">long</span> key1, <span class="keywordtype">char</span> *key2) -00374 { -00375 <span class="keywordtype">unsigned</span> hv; -00376 <span class="keyword">struct </span>hlist_head *head; -00377 <span class="keyword">struct </span>hlist_node *e; -00378 -00379 <span class="keywordflow">if</span> (map == NULL) -00380 <span class="keywordflow">return</span>; -00381 -00382 hv = mixed_hash(key2, key1); -00383 head = &map->hashes[hv]; -00384 dbug (<span class="stringliteral">"hash for %ld,%s is %d\n"</span>, key1, key2, hv); -00385 -00386 hlist_for_each(e, head) { -00387 <span class="keyword">struct </span>map_node *n = -00388 (<span class="keyword">struct </span>map_node *)((long)e - <span class="keyword">sizeof</span>(<span class="keyword">struct </span>hlist_node)); -00389 dbug (<span class="stringliteral">"e =%lx key=%ld,%s\n"</span>, (<span class="keywordtype">long</span>)e, n->key1.val,n->key2.str); -00390 <span class="keywordflow">if</span> (key1 == n->key1.val && strcmp(key2, n->key2.str) == 0) { -00391 map->key = n; -00392 dbug (<span class="stringliteral">"saving key %lx\n"</span>, (<span class="keywordtype">long</span>)map->key); -00393 map->create = 0; -00394 <span class="keywordflow">return</span>; -00395 } -00396 } -00397 -00398 map->c_key1.val = key1; -00399 map->c_key2.str = key2; -00400 map->c_key1type = LONG; -00401 map->c_key2type = STR; -00402 map->c_keyhead = head; -00403 map->create = 1; -00404 } -00405 <span class="comment"></span> -00406 <span class="comment">/** Set the map's key to a string.</span> -00407 <span class="comment"> * This sets the current element based on a string key. If the key is</span> -00408 <span class="comment"> * not found, a new element will not be created until a <i>_stp_map_set_xxx</i></span> -00409 <span class="comment"> * call.</span> -00410 <span class="comment"> * @param map</span> -00411 <span class="comment"> * @param key</span> -00412 <span class="comment"> */</span> -00413 -<a name="l00414"></a><a class="code" href="group__maps.html#ga12">00414</a> <span class="keywordtype">void</span> <a class="code" href="group__maps.html#ga12">_stp_map_key_str</a>(<a class="code" href="group__maps.html#ga1">MAP</a> map, <span class="keywordtype">char</span> *key) -00415 { -00416 <span class="keywordflow">if</span> (map == NULL) -00417 <span class="keywordflow">return</span>; -00418 <a class="code" href="group__maps.html#ga9">_stp_map_key_str_str</a>(map, key, NULL); -00419 map->c_key2type = NONE; -00420 } -00421 <span class="comment"></span> -00422 <span class="comment">/** Set the map's key to a long.</span> -00423 <span class="comment"> * This sets the current element based on a long key. If the key is</span> -00424 <span class="comment"> * not found, a new element will not be created until a <i>_stp_map_set_xxx</i></span> -00425 <span class="comment"> * call.</span> -00426 <span class="comment"> * @param map</span> -00427 <span class="comment"> * @param key </span> -00428 <span class="comment"> */</span> -00429 -<a name="l00430"></a><a class="code" href="group__maps.html#ga13">00430</a> <span class="keywordtype">void</span> <a class="code" href="group__maps.html#ga13">_stp_map_key_long</a>(<a class="code" href="group__maps.html#ga1">MAP</a> map, <span class="keywordtype">long</span> key) -00431 { -00432 <span class="keywordflow">if</span> (map == NULL) -00433 <span class="keywordflow">return</span>; -00434 <a class="code" href="group__maps.html#ga8">_stp_map_key_long_long</a>(map, key, 0); -00435 map->c_key2type = NONE; -00436 } -00437 -00438 <span class="comment">/********************** SET/GET VALUES *********************/</span> -00439 -00440 <span class="keyword">static</span> <span class="keywordtype">void</span> map_copy_keys(<a class="code" href="group__maps.html#ga1">MAP</a> map, <span class="keyword">struct</span> map_node *m) -00441 { -00442 m->key1type = map->c_key1type; -00443 m->key2type = map->c_key2type; -00444 <span class="keywordflow">switch</span> (map->c_key1type) { -00445 <span class="keywordflow">case</span> STR: -00446 m->key1.str = <a class="code" href="group__alloc.html#ga1">_stp_alloc</a>(strlen(map->c_key1.str) + 1); -00447 strcpy(m->key1.str, map->c_key1.str); -00448 <span class="keywordflow">break</span>; -00449 <span class="keywordflow">case</span> LONG: -00450 m->key1.val = map->c_key1.val; -00451 <span class="keywordflow">break</span>; -00452 <span class="keywordflow">case</span> NONE: -00453 <span class="comment">/* ERROR */</span> -00454 <span class="keywordflow">break</span>; -00455 } -00456 <span class="keywordflow">switch</span> (map->c_key2type) { -00457 <span class="keywordflow">case</span> STR: -00458 m->key2.str = <a class="code" href="group__alloc.html#ga1">_stp_alloc</a>(strlen(map->c_key2.str) + 1); -00459 strcpy(m->key2.str, map->c_key2.str); -00460 <span class="keywordflow">break</span>; -00461 <span class="keywordflow">case</span> LONG: -00462 m->key2.val = map->c_key2.val; -00463 <span class="keywordflow">break</span>; -00464 <span class="keywordflow">case</span> NONE: -00465 <span class="keywordflow">break</span>; -00466 } -00467 -00468 <span class="comment">/* add node to new hash list */</span> -00469 hlist_add_head(&m->hnode, map->c_keyhead); -00470 -00471 map->key = m; -00472 map->create = 0; -00473 map->num++; -00474 } -00475 -00476 <span class="keyword">static</span> <span class="keywordtype">void</span> __stp_map_set_int64(<a class="code" href="group__maps.html#ga1">MAP</a> map, int64_t val, <span class="keywordtype">int</span> add) -00477 { -00478 <span class="keyword">struct </span>map_node_int64 *m; -00479 -00480 <span class="keywordflow">if</span> (map == NULL) -00481 return; -00482 -00483 if (map->create) { -00484 <span class="keywordflow">if</span> (val == 0) -00485 return; -00486 -00487 if (map->maxnum) { -00488 <span class="keywordflow">if</span> (list_empty(&map->pool)) { -00489 <span class="keywordflow">if</span> (map->no_wrap) { -00490 <span class="comment">/* ERROR. FIXME */</span> -00491 <span class="keywordflow">return</span>; -00492 } -00493 m = (<span class="keyword">struct </span>map_node_int64 *)map->head.next; -00494 hlist_del_init(&m->n.hnode); -00495 map_free_strings(map, (<span class="keyword">struct</span> map_node *)m); -00496 dbug (<span class="stringliteral">"got %lx off head\n"</span>, (<span class="keywordtype">long</span>)m); -00497 } <span class="keywordflow">else</span> { -00498 m = (<span class="keyword">struct </span>map_node_int64 *)map->pool.next; -00499 dbug (<span class="stringliteral">"got %lx off pool\n"</span>, (<span class="keywordtype">long</span>)m); -00500 } -00501 list_move_tail(&m->n.lnode, &map->head); -00502 } <span class="keywordflow">else</span> { -00503 m = (<span class="keyword">struct </span>map_node_int64 *) -00504 <a class="code" href="group__alloc.html#ga2">_stp_calloc</a>(<span class="keyword">sizeof</span>(<span class="keyword">struct</span> map_node_int64)); -00505 <span class="comment">/* add node to list */</span> -00506 list_add_tail(&m->n.lnode, &map->head); -00507 } -00508 -00509 <span class="comment">/* copy the key(s) */</span> -00510 map_copy_keys(map, &m->n); -00511 -00512 <span class="comment">/* set the value */</span> -00513 m->val = val; -00514 } <span class="keywordflow">else</span> { -00515 <span class="keywordflow">if</span> (map->key == NULL) -00516 return; -00517 -00518 if (val) { -00519 m = (<span class="keyword">struct </span>map_node_int64 *)map->key; -00520 <span class="keywordflow">if</span> (add) -00521 m->val += val; -00522 else -00523 m->val = val; -00524 } else if (!add) { -00525 <span class="comment">/* setting value to 0 is the same as deleting */</span> -00526 <a class="code" href="group__maps.html#ga4">_stp_map_key_del</a>(map); -00527 } -00528 } -00529 } -00530 <span class="comment"></span> -00531 <span class="comment">/** Set the current element's value to an int64.</span> -00532 <span class="comment"> * This sets the current element's value to an int64. The map must have been created</span> -00533 <span class="comment"> * to hold int64s using _stp_map_new()</span> -00534 <span class="comment"> *</span> -00535 <span class="comment"> * If the element doesn't exist, it is created. If no current element (key)</span> -00536 <span class="comment"> * is set for the map, this function does nothing.</span> -00537 <span class="comment"> * @param map</span> -00538 <span class="comment"> * @param val new value</span> -00539 <span class="comment"> * @sa _stp_map_add_int64</span> -00540 <span class="comment"> * @sa _stp_map_set()</span> -00541 <span class="comment"> */</span> -<a name="l00542"></a><a class="code" href="group__maps.html#ga16">00542</a> <span class="keywordtype">void</span> <a class="code" href="group__maps.html#ga16">_stp_map_set_int64</a>(<a class="code" href="group__maps.html#ga1">MAP</a> map, int64_t val) -00543 { -00544 __stp_map_set_int64 (map, val, 0); -00545 } -00546 -00547 <span class="comment"></span> -00548 <span class="comment">/** Adds an int64 to the current element's value.</span> -00549 <span class="comment"> * This adds an int64 to the current element's value. The map must have been created</span> -00550 <span class="comment"> * to hold int64s using _stp_map_new()</span> -00551 <span class="comment"> *</span> -00552 <span class="comment"> * If the element doesn't exist, it is created. If no current element (key)</span> -00553 <span class="comment"> * is set for the map, this function does nothing.</span> -00554 <span class="comment"> * @param map</span> -00555 <span class="comment"> * @param val value</span> -00556 <span class="comment"> * @sa _stp_map_set_int64</span> -00557 <span class="comment"> */</span> -00558 -<a name="l00559"></a><a class="code" href="group__maps.html#ga17">00559</a> <span class="keywordtype">void</span> <a class="code" href="group__maps.html#ga17">_stp_map_add_int64</a>(<a class="code" href="group__maps.html#ga1">MAP</a> map, int64_t val) -00560 { -00561 __stp_map_set_int64 (map, val, 1); -00562 } -00563 <span class="comment"></span> -00564 <span class="comment">/** Gets the current element's value.</span> -00565 <span class="comment"> * @param map</span> -00566 <span class="comment"> * @returns The value. If the current element is not set or doesn't exist, returns 0.</span> -00567 <span class="comment"> */</span> -00568 -<a name="l00569"></a><a class="code" href="group__maps.html#ga18">00569</a> int64_t <a class="code" href="group__maps.html#ga18">_stp_map_get_int64</a>(<a class="code" href="group__maps.html#ga1">MAP</a> map) -00570 { -00571 <span class="keyword">struct </span>map_node_int64 *m; -00572 <span class="keywordflow">if</span> (map == NULL || map->create || map->key == NULL) -00573 <span class="keywordflow">return</span> 0; -00574 dbug (<span class="stringliteral">"%lx\n"</span>, (<span class="keywordtype">long</span>)map->key); -00575 m = (<span class="keyword">struct </span>map_node_int64 *)map->key; -00576 <span class="keywordflow">return</span> m->val; -00577 } -00578 <span class="comment"></span> -00579 <span class="comment">/** Set the current element's value to a C string.</span> -00580 <span class="comment"> * This sets the current element's value to an C string. The map must have been created</span> -00581 <span class="comment"> * to hold int64s using <i>_stp_map_new(xxx, STRING)</i></span> -00582 <span class="comment"> *</span> -00583 <span class="comment"> * If the element doesn't exist, it is created. If no current element (key)</span> -00584 <span class="comment"> * is set for the map, this function does nothing.</span> -00585 <span class="comment"> * @param map</span> -00586 <span class="comment"> * @param val new string</span> -00587 <span class="comment"> * @sa _stp_map_set()</span> -00588 <span class="comment"> */</span> -00589 -<a name="l00590"></a><a class="code" href="group__maps.html#ga19">00590</a> <span class="keywordtype">void</span> <a class="code" href="group__maps.html#ga19">_stp_map_set_str</a>(<a class="code" href="group__maps.html#ga1">MAP</a> map, <span class="keywordtype">char</span> *val) -00591 { -00592 <span class="keyword">struct </span>map_node_str *m; -00593 -00594 <span class="keywordflow">if</span> (map == NULL) -00595 <span class="keywordflow">return</span>; -00596 -00597 <span class="keywordflow">if</span> (map->create) { -00598 <span class="keywordflow">if</span> (val == NULL) -00599 <span class="keywordflow">return</span>; -00600 -00601 <span class="keywordflow">if</span> (map->maxnum) { -00602 <span class="keywordflow">if</span> (list_empty(&map->pool)) { -00603 <span class="keywordflow">if</span> (map->no_wrap) { -00604 <span class="comment">/* ERROR. FIXME */</span> -00605 <span class="keywordflow">return</span>; -00606 } -00607 m = (<span class="keyword">struct </span>map_node_str *)map->head.next; -00608 hlist_del_init(&m->n.hnode); -00609 map_free_strings(map, (<span class="keyword">struct</span> map_node *)m); -00610 dbug (<span class="stringliteral">"got %lx off head\n"</span>, (<span class="keywordtype">long</span>)m); -00611 } <span class="keywordflow">else</span> { -00612 m = (<span class="keyword">struct </span>map_node_str *)map->pool.next; -00613 dbug (<span class="stringliteral">"got %lx off pool\n"</span>, (<span class="keywordtype">long</span>)m); -00614 } -00615 list_move_tail(&m->n.lnode, &map->head); -00616 } <span class="keywordflow">else</span> { -00617 m = (<span class="keyword">struct </span>map_node_str *) -00618 <a class="code" href="group__alloc.html#ga2">_stp_calloc</a>(<span class="keyword">sizeof</span>(<span class="keyword">struct</span> map_node_str)); -00619 <span class="comment">/* add node to list */</span> -00620 list_add_tail(&m->n.lnode, &map->head); -00621 } -00622 -00623 <span class="comment">/* copy the key(s) */</span> -00624 map_copy_keys(map, &m->n); -00625 -00626 <span class="comment">/* set the value */</span> -00627 m->str = <a class="code" href="group__alloc.html#ga1">_stp_alloc</a>(strlen(val) + 1); -00628 strcpy(m->str, val); -00629 } <span class="keywordflow">else</span> { -00630 <span class="keywordflow">if</span> (map->key == NULL) -00631 <span class="keywordflow">return</span>; -00632 -00633 <span class="keywordflow">if</span> (val) { -00634 m = (<span class="keyword">struct </span>map_node_str *)map->key; -00635 <span class="keywordflow">if</span> (m->str) -00636 <a class="code" href="group__alloc.html#ga4">_stp_free</a>(m->str); -00637 m->str = <a class="code" href="group__alloc.html#ga1">_stp_alloc</a>(strlen(val) + 1); -00638 strcpy(m->str, val); -00639 } <span class="keywordflow">else</span> { -00640 <span class="comment">/* setting value to 0 is the same as deleting */</span> -00641 <a class="code" href="group__maps.html#ga4">_stp_map_key_del</a>(map); -00642 } -00643 } -00644 } -00645 <span class="comment"></span> -00646 <span class="comment">/** Set the current element's value to String.</span> -00647 <span class="comment"> * This sets the current element's value to a String. The map must have been created</span> -00648 <span class="comment"> * to hold int64s using <i>_stp_map_new(xxx, STRING)</i></span> -00649 <span class="comment"> *</span> -00650 <span class="comment"> * If the element doesn't exist, it is created. If no current element (key)</span> -00651 <span class="comment"> * is set for the map, this function does nothing.</span> -00652 <span class="comment"> * @param map</span> -00653 <span class="comment"> * @param str String containing new value.</span> -00654 <span class="comment"> * @sa _stp_map_set()</span> -00655 <span class="comment"> */</span> -00656 -<a name="l00657"></a><a class="code" href="group__maps.html#ga20">00657</a> <span class="keywordtype">void</span> <a class="code" href="group__maps.html#ga20">_stp_map_set_string</a> (<a class="code" href="group__maps.html#ga1">MAP</a> map, String str) -00658 { -00659 <a class="code" href="group__maps.html#ga19">_stp_map_set_str</a> (map, str->buf); -00660 } -00661 <span class="comment"></span> -00662 <span class="comment">/** Gets the current element's value.</span> -00663 <span class="comment"> * @param map</span> -00664 <span class="comment"> * @returns A string pointer. If the current element is not set or doesn't exist, returns NULL.</span> -00665 <span class="comment"> */</span> -00666 -<a name="l00667"></a><a class="code" href="group__maps.html#ga21">00667</a> <span class="keywordtype">char</span> *<a class="code" href="group__maps.html#ga21">_stp_map_get_str</a>(<a class="code" href="group__maps.html#ga1">MAP</a> map) -00668 { -00669 <span class="keyword">struct </span>map_node_str *m; -00670 <span class="keywordflow">if</span> (map == NULL || map->create || map->key == NULL) -00671 <span class="keywordflow">return</span> NULL; -00672 dbug (<span class="stringliteral">"%lx\n"</span>, (<span class="keywordtype">long</span>)map->key); -00673 m = (<span class="keyword">struct </span>map_node_str *)map->key; -00674 <span class="keywordflow">return</span> m->str; -00675 } -00676 <span class="comment"></span> -00677 <span class="comment">/** Set the current element's value to a stat.</span> -00678 <span class="comment"> * This sets the current element's value to an stat struct. The map must have been created</span> -00679 <span class="comment"> * to hold stats using <i>_stp_map_new(xxx, STAT)</i>. This function would only be used</span> -00680 <span class="comment"> * if we wanted to set stats to something other than the normal initial values (count = 0,</span> -00681 <span class="comment"> * sum = 0, etc). It may be deleted if it doesn't turn out to be useful.</span> -00682 <span class="comment"> * @sa _stp_map_stat_add </span> -00683 <span class="comment"> *</span> -00684 <span class="comment"> * If the element doesn't exist, it is created. If no current element (key)</span> -00685 <span class="comment"> * is set for the map, this function does nothing.</span> -00686 <span class="comment"> * @param map</span> -00687 <span class="comment"> * @param stats pointer to stats struct.</span> -00688 <span class="comment"> * @todo Histograms don't work yet.</span> -00689 <span class="comment"> */</span> -00690 -<a name="l00691"></a><a class="code" href="group__maps.html#ga22">00691</a> <span class="keywordtype">void</span> <a class="code" href="group__maps.html#ga22">_stp_map_set_stat</a>(<a class="code" href="group__maps.html#ga1">MAP</a> map, stat * stats) -00692 { -00693 <span class="keyword">struct </span>map_node_stat *m; -00694 -00695 <span class="keywordflow">if</span> (map == NULL) -00696 <span class="keywordflow">return</span>; -00697 dbug (<span class="stringliteral">"set_stat %lx\n"</span>, (<span class="keywordtype">long</span>)map->key); -00698 -00699 <span class="keywordflow">if</span> (map->create) { -00700 <span class="keywordflow">if</span> (stats == NULL) -00701 <span class="keywordflow">return</span>; -00702 -00703 <span class="keywordflow">if</span> (map->maxnum) { -00704 <span class="keywordflow">if</span> (list_empty(&map->pool)) { -00705 <span class="keywordflow">if</span> (map->no_wrap) { -00706 <span class="comment">/* ERROR. FIXME */</span> -00707 <span class="keywordflow">return</span>; -00708 } -00709 m = (<span class="keyword">struct </span>map_node_stat *)map->head.next; -00710 hlist_del_init(&m->n.hnode); -00711 map_free_strings(map, (<span class="keyword">struct</span> map_node *)m); -00712 dbug (<span class="stringliteral">"got %lx off head\n"</span>, (<span class="keywordtype">long</span>)m); -00713 } <span class="keywordflow">else</span> { -00714 m = (<span class="keyword">struct </span>map_node_stat *)map->pool.next; -00715 dbug (<span class="stringliteral">"got %lx off pool\n"</span>, (<span class="keywordtype">long</span>)m); -00716 } -00717 list_move_tail(&m->n.lnode, &map->head); -00718 } <span class="keywordflow">else</span> { -00719 m = (<span class="keyword">struct </span>map_node_stat *) -00720 <a class="code" href="group__alloc.html#ga2">_stp_calloc</a>(<span class="keyword">sizeof</span>(<span class="keyword">struct</span> map_node_stat)); -00721 <span class="comment">/* add node to list */</span> -00722 list_add_tail(&m->n.lnode, &map->head); -00723 } -00724 -00725 <span class="comment">/* copy the key(s) */</span> -00726 map_copy_keys(map, &m->n); -00727 -00728 <span class="comment">/* set the value */</span> -00729 memcpy(&m->stats, stats, <span class="keyword">sizeof</span>(stat)); -00730 } <span class="keywordflow">else</span> { -00731 <span class="keywordflow">if</span> (map->key == NULL) -00732 <span class="keywordflow">return</span>; -00733 -00734 <span class="keywordflow">if</span> (stats) { -00735 m = (<span class="keyword">struct </span>map_node_stat *)map->key; -00736 memcpy(&m->stats, stats, <span class="keyword">sizeof</span>(stat)); -00737 } <span class="keywordflow">else</span> { -00738 <span class="comment">/* setting value to NULL is the same as deleting */</span> -00739 <a class="code" href="group__maps.html#ga4">_stp_map_key_del</a>(map); -00740 } -00741 } -00742 } -00743 <span class="comment"></span> -00744 <span class="comment">/** Gets the current element's value.</span> -00745 <span class="comment"> * @param map</span> -00746 <span class="comment"> * @returns A pointer to the stats struct. If the current element is not set </span> -00747 <span class="comment"> * or doesn't exist, returns NULL.</span> -00748 <span class="comment"> */</span> -00749 -<a name="l00750"></a><a class="code" href="group__maps.html#ga23">00750</a> stat *<a class="code" href="group__maps.html#ga23">_stp_map_get_stat</a>(<a class="code" href="group__maps.html#ga1">MAP</a> map) -00751 { -00752 <span class="keyword">struct </span>map_node_stat *m; -00753 <span class="keywordflow">if</span> (map == NULL || map->create || map->key == NULL) -00754 <span class="keywordflow">return</span> NULL; -00755 dbug (<span class="stringliteral">"%lx\n"</span>, (<span class="keywordtype">long</span>)map->key); -00756 m = (<span class="keyword">struct </span>map_node_stat *)map->key; -00757 <span class="keywordflow">return</span> &m->stats; -00758 } -00759 <span class="comment"></span> -00760 <span class="comment">/** Add to the current element's statistics.</span> -00761 <span class="comment"> * Increments the statistics counter by one and the sum by <i>val</i>.</span> -00762 <span class="comment"> * Adjusts minimum, maximum, and histogram.</span> -00763 <span class="comment"> *</span> -00764 <span class="comment"> * If the element doesn't exist, it is created. If no current element (key)</span> -00765 <span class="comment"> * is set for the map, this function does nothing.</span> -00766 <span class="comment"> * @param map</span> -00767 <span class="comment"> * @param val value to add to the statistics</span> -00768 <span class="comment"> * @todo Histograms don't work yet.</span> -00769 <span class="comment"> */</span> -00770 -<a name="l00771"></a><a class="code" href="group__maps.html#ga24">00771</a> <span class="keywordtype">void</span> <a class="code" href="group__maps.html#ga24">_stp_map_stat_add</a>(<a class="code" href="group__maps.html#ga1">MAP</a> map, int64_t val) -00772 { -00773 <span class="keyword">struct </span>map_node_stat *m; -00774 <span class="keywordflow">if</span> (map == NULL) -00775 <span class="keywordflow">return</span>; -00776 -00777 <span class="keywordflow">if</span> (map->create) { -00778 stat st = { 1, val, val, val }; -00779 <span class="comment">/* histogram */</span> -00780 <a class="code" href="group__maps.html#ga22">_stp_map_set_stat</a>(map, &st); -00781 <span class="keywordflow">return</span>; -00782 } -00783 -00784 <span class="keywordflow">if</span> (map->key == NULL) -00785 <span class="keywordflow">return</span>; -00786 -00787 dbug (<span class="stringliteral">"add_stat %lx\n"</span>, (<span class="keywordtype">long</span>)map->key); -00788 m = (<span class="keyword">struct </span>map_node_stat *)map->key; -00789 m->stats.count++; -00790 m->stats.sum += val; -00791 <span class="keywordflow">if</span> (val > m->stats.max) -00792 m->stats.max = val; -00793 <span class="keywordflow">if</span> (val < m->stats.min) -00794 m->stats.min = val; -00795 <span class="comment">/* histogram */</span> -00796 } -00797 <span class="comment"></span> -00798 <span class="comment">/** @} */</span> -00799 -00800 <span class="comment">/********************** List Functions *********************/</span> -00801 <span class="comment"></span> -00802 <span class="comment">/** @addtogroup lists</span> -00803 <span class="comment"> * Lists are special cases of maps.</span> -00804 <span class="comment"> * @b Example:</span> -00805 <span class="comment"> * @include list.c</span> -00806 <span class="comment"> * @{ */</span> -00807 <span class="comment"></span> -00808 <span class="comment">/** Create a new list.</span> -00809 <span class="comment"> * A list is a map that internally has an incrementing long key for each member.</span> -00810 <span class="comment"> * Lists do not wrap if elements are added to exceed their maximum size.</span> -00811 <span class="comment"> * @param max_entries The maximum number of entries allowed. Currently that number will</span> -00812 <span class="comment"> * be preallocated. If max_entries is 0, there will be no maximum and entries</span> -00813 <span class="comment"> * will be allocated dynamically.</span> -00814 <span class="comment"> * @param type Type of values stored in this list. </span> -00815 <span class="comment"> * @return A MAP on success or NULL on failure.</span> -00816 <span class="comment"> * @sa foreach</span> -00817 <span class="comment"> */</span> -00818 -<a name="l00819"></a><a class="code" href="group__lists.html#ga0">00819</a> <a class="code" href="group__maps.html#ga1">MAP</a> <a class="code" href="group__lists.html#ga0">_stp_list_new</a>(<span class="keywordtype">unsigned</span> max_entries, <span class="keyword">enum</span> valtype type) -00820 { -00821 <a class="code" href="group__maps.html#ga1">MAP</a> map = <a class="code" href="group__maps.html#ga2">_stp_map_new</a> (max_entries, type); -00822 map->no_wrap = 1; -00823 <span class="keywordflow">return</span> map; -00824 } -00825 <span class="comment"></span> -00826 <span class="comment">/** Clears a list.</span> -00827 <span class="comment"> * All elements in the list are deleted.</span> -00828 <span class="comment"> * @param map </span> -00829 <span class="comment"> */</span> -00830 -<a name="l00831"></a><a class="code" href="group__lists.html#ga1">00831</a> <span class="keywordtype">void</span> <a class="code" href="group__lists.html#ga1">_stp_list_clear</a>(<a class="code" href="group__maps.html#ga1">MAP</a> map) -00832 { -00833 <span class="keywordflow">if</span> (map == NULL) -00834 <span class="keywordflow">return</span>; -00835 -00836 <span class="keywordflow">if</span> (!list_empty(&map->head)) { -00837 <span class="keyword">struct </span>map_node *ptr = (<span class="keyword">struct </span>map_node *)map->head.next; -00838 -00839 <span class="keywordflow">while</span> (ptr && ptr != (<span class="keyword">struct</span> map_node *)&map->head) { -00840 <span class="keyword">struct </span>map_node *next = (<span class="keyword">struct </span>map_node *)ptr->lnode.next; -00841 -00842 <span class="comment">/* remove node from old hash list */</span> -00843 hlist_del_init(&ptr->hnode); -00844 -00845 <span class="comment">/* remove from entry list */</span> -00846 list_del(&ptr->lnode); -00847 -00848 <span class="comment">/* remove any allocated string storage */</span> -00849 map_free_strings(map, ptr); -00850 -00851 <span class="keywordflow">if</span> (map->maxnum) -00852 list_add(&ptr->lnode, &map->pool); -00853 <span class="keywordflow">else</span> -00854 <a class="code" href="group__alloc.html#ga4">_stp_free</a>(ptr); -00855 -00856 map->num--; -00857 ptr = next; -00858 } -00859 } -00860 -00861 <span class="keywordflow">if</span> (map->num != 0) { -00862 <a class="code" href="group__io.html#ga2">_stp_log</a> (<span class="stringliteral">"ERROR: list is supposed to be empty (has %d)\n"</span>, map->num); -00863 } -00864 } -00865 <span class="comment"></span> -00866 <span class="comment">/** Adds a C string to a list.</span> -00867 <span class="comment"> * @param map</span> -00868 <span class="comment"> * @param str</span> -00869 <span class="comment"> * @sa _stp_list_add()</span> -00870 <span class="comment"> */</span> -00871 -<a name="l00872"></a><a class="code" href="group__lists.html#ga2">00872</a> <span class="keyword">inline</span> <span class="keywordtype">void</span> <a class="code" href="group__lists.html#ga2">_stp_list_add_str</a>(<a class="code" href="group__maps.html#ga1">MAP</a> map, <span class="keywordtype">char</span> *str) -00873 { -00874 <a class="code" href="group__maps.html#ga13">_stp_map_key_long</a>(map, map->num); -00875 <a class="code" href="group__maps.html#ga19">_stp_map_set_str</a>(map, str); -00876 } -00877 <span class="comment"></span> -00878 <span class="comment">/** Adds a String to a list.</span> -00879 <span class="comment"> * @param map</span> -00880 <span class="comment"> * @param str String to add.</span> -00881 <span class="comment"> * @sa _stp_list_add()</span> -00882 <span class="comment"> */</span> -00883 -<a name="l00884"></a><a class="code" href="group__lists.html#ga3">00884</a> <span class="keyword">inline</span> <span class="keywordtype">void</span> <a class="code" href="group__lists.html#ga3">_stp_list_add_string</a> (<a class="code" href="group__maps.html#ga1">MAP</a> map, String str) -00885 { -00886 <a class="code" href="group__maps.html#ga13">_stp_map_key_long</a>(map, map->num); -00887 <a class="code" href="group__maps.html#ga19">_stp_map_set_str</a>(map, str->buf); -00888 } -00889 <span class="comment"></span> -00890 <span class="comment">/** Adds an int64 to a list.</span> -00891 <span class="comment"> * @param map</span> -00892 <span class="comment"> * @param val</span> -00893 <span class="comment"> * @sa _stp_list_add()</span> -00894 <span class="comment"> */</span> -00895 -<a name="l00896"></a><a class="code" href="group__lists.html#ga4">00896</a> <span class="keyword">inline</span> <span class="keywordtype">void</span> <a class="code" href="group__lists.html#ga4">_stp_list_add_int64</a>(<a class="code" href="group__maps.html#ga1">MAP</a> map, int64_t val) -00897 { -00898 <a class="code" href="group__maps.html#ga13">_stp_map_key_long</a>(map, map->num); -00899 <a class="code" href="group__maps.html#ga16">_stp_map_set_int64</a>(map, val); -00900 } -00901 <span class="comment"></span> -00902 <span class="comment">/** Get the number of elements in a list.</span> -00903 <span class="comment"> * @param map</span> -00904 <span class="comment"> * @returns The number of elements in a list.</span> -00905 <span class="comment"> */</span> -00906 -<a name="l00907"></a><a class="code" href="group__lists.html#ga5">00907</a> <span class="keyword">inline</span> <span class="keywordtype">int</span> <a class="code" href="group__lists.html#ga5">_stp_list_size</a>(<a class="code" href="group__maps.html#ga1">MAP</a> map) -00908 { -00909 <span class="keywordflow">return</span> map->num; -00910 }<span class="comment"></span> -00911 <span class="comment">/** @} */</span> -00912 <span class="preprocessor">#endif </span><span class="comment">/* _MAP_C_ */</span> -</pre></div></body></html> diff --git a/runtime/docs/html/map_8c.html b/runtime/docs/html/map_8c.html deleted file mode 100644 index 5193f3f0..00000000 --- a/runtime/docs/html/map_8c.html +++ /dev/null @@ -1,102 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: map.c File Reference</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1>map.c File Reference</h1>Implements maps (associative arrays) and lists. <a href="#_details">More...</a> -<p> -<code>#include "<a class="el" href="map_8h-source.html">map.h</a>"</code><br> -<code>#include "<a class="el" href="alloc_8c-source.html">alloc.c</a>"</code><br> -<code>#include "<a class="el" href="string_8c-source.html">string.c</a>"</code><br> - -<p> -<a href="map_8c-source.html">Go to the source code of this file.</a><table border="0" cellpadding="0" cellspacing="0"> -<tr><td></td></tr> -<tr><td colspan="2"><br><h2>Functions</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="group__maps.html#ga1">MAP</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga2">_stp_map_new</a> (unsigned max_entries, enum <a class="el" href="group__maps.html#ga34">valtype</a> type)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Create a new map. <a href="group__maps.html#ga2"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga4">_stp_map_key_del</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Deletes the current element. <a href="group__maps.html#ga4"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">map_node * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga5">_stp_map_start</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the first element in a map. <a href="group__maps.html#ga5"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">map_node * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga6">_stp_map_iter</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map, struct map_node *m)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the next element in a map. <a href="group__maps.html#ga6"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga7">_stp_map_del</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Deletes a map. <a href="group__maps.html#ga7"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga8">_stp_map_key_long_long</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map, long key1, long key2)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the map's key to two longs. <a href="group__maps.html#ga8"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga9">_stp_map_key_str_str</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map, char *key1, char *key2)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the map's key to two strings. <a href="group__maps.html#ga9"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga10">_stp_map_key_str_long</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map, char *key1, long key2)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the map's key to a string and a long. <a href="group__maps.html#ga10"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga11">_stp_map_key_long_str</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map, long key1, char *key2)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the map's key to a long and a string. <a href="group__maps.html#ga11"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga12">_stp_map_key_str</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map, char *key)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the map's key to a string. <a href="group__maps.html#ga12"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga13">_stp_map_key_long</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map, long key)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the map's key to a long. <a href="group__maps.html#ga13"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga16">_stp_map_set_int64</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map, int64_t val)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the current element's value to an int64. <a href="group__maps.html#ga16"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga17">_stp_map_add_int64</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map, int64_t val)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Adds an int64 to the current element's value. <a href="group__maps.html#ga17"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">int64_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga18">_stp_map_get_int64</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the current element's value. <a href="group__maps.html#ga18"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga19">_stp_map_set_str</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map, char *val)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the current element's value to a C string. <a href="group__maps.html#ga19"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga20">_stp_map_set_string</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map, String str)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the current element's value to String. <a href="group__maps.html#ga20"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga21">_stp_map_get_str</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the current element's value. <a href="group__maps.html#ga21"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga22">_stp_map_set_stat</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map, stat *stats)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the current element's value to a stat. <a href="group__maps.html#ga22"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">stat * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga23">_stp_map_get_stat</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the current element's value. <a href="group__maps.html#ga23"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga24">_stp_map_stat_add</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map, int64_t val)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Add to the current element's statistics. <a href="group__maps.html#ga24"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="group__maps.html#ga1">MAP</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__lists.html#ga0">_stp_list_new</a> (unsigned max_entries, enum <a class="el" href="group__maps.html#ga34">valtype</a> type)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Create a new list. <a href="group__lists.html#ga0"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__lists.html#ga1">_stp_list_clear</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Clears a list. <a href="group__lists.html#ga1"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__lists.html#ga2">_stp_list_add_str</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map, char *str)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Adds a C string to a list. <a href="group__lists.html#ga2"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__lists.html#ga3">_stp_list_add_string</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map, String str)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Adds a String to a list. <a href="group__lists.html#ga3"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__lists.html#ga4">_stp_list_add_int64</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map, int64_t val)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Adds an int64 to a list. <a href="group__lists.html#ga4"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__lists.html#ga5">_stp_list_size</a> (<a class="el" href="group__maps.html#ga1">MAP</a> map)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the number of elements in a list. <a href="group__lists.html#ga5"></a><br></td></tr> -</table> -<hr><a name="_details"></a><h2>Detailed Description</h2> -Implements maps (associative arrays) and lists. -<p> - -<p> -Definition in file <a class="el" href="map_8c-source.html">map.c</a>.</body></html> diff --git a/runtime/docs/html/map_8h-source.html b/runtime/docs/html/map_8h-source.html deleted file mode 100644 index 956ac200..00000000 --- a/runtime/docs/html/map_8h-source.html +++ /dev/null @@ -1,201 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: map.h Source File</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1>map.h</h1><a href="map_8h.html">Go to the documentation of this file.</a><div class="fragment"><pre class="fragment">00001 <span class="preprocessor">#ifndef _MAP_H_ </span><span class="comment">/* -*- linux-c -*- */</span> -00002 <span class="preprocessor">#define _MAP_H_</span> -00003 <span class="preprocessor"></span><span class="comment"></span> -00004 <span class="comment">/** @file map.h</span> -00005 <span class="comment"> * @brief Header file for maps and lists </span> -00006 <span class="comment"> */</span><span class="comment"></span> -00007 <span class="comment">/** @addtogroup maps </span> -00008 <span class="comment"> * @todo Needs to be made SMP-safe for when the big lock is removed from kprobes.</span> -00009 <span class="comment"> * @{ </span> -00010 <span class="comment"> */</span> -00011 -00012 <span class="preprocessor">#include <linux/types.h></span> -00013 -00014 <span class="comment">/* Statistics are stored in this struct */</span> -00015 <span class="keyword">typedef</span> <span class="keyword">struct </span>{ -00016 int64_t count; -00017 int64_t sum; -00018 int64_t min, max; -00019 int64_t histogram[BUCKETS]; -00020 } stat; -00021 -00022 <span class="comment">/* Keys are either longs or char * */</span> -00023 <span class="keyword">union </span>key_data { -00024 <span class="keywordtype">long</span> val; -00025 <span class="keywordtype">char</span> *str; -00026 }; -00027 <span class="comment"></span> -00028 <span class="comment">/** keys can be longs or strings */</span> -<a name="l00029"></a><a class="code" href="group__maps.html#ga33">00029</a> <span class="keyword">enum</span> <a class="code" href="group__maps.html#ga33">keytype</a> { NONE, LONG, STR } __attribute__ ((packed));<span class="comment"></span> -00030 <span class="comment">/** values can be either int64, stats or strings */</span> -<a name="l00031"></a><a class="code" href="group__maps.html#ga34">00031</a> <span class="keyword">enum</span> <a class="code" href="group__maps.html#ga34">valtype</a> { INT64, STAT, STRING, END }; -00032 -00033 -00034 <span class="comment">/* basic map element */</span> -00035 <span class="keyword">struct </span>map_node { -00036 <span class="comment">/* list of other nodes in the map */</span> -00037 <span class="keyword">struct </span>list_head lnode; -00038 <span class="comment">/* list of nodes with the same hash value */</span> -00039 <span class="keyword">struct </span>hlist_node hnode; -00040 <span class="keyword">union </span>key_data key1; -00041 <span class="keyword">union </span>key_data key2; -00042 <span class="keyword">enum</span> <a class="code" href="group__maps.html#ga33">keytype</a> key1type; -00043 <span class="keyword">enum</span> <a class="code" href="group__maps.html#ga33">keytype</a> key2type; -00044 }; -00045 -00046 <span class="comment">/* map element containing int64 */</span> -00047 <span class="keyword">struct </span>map_node_int64 { -00048 <span class="keyword">struct </span>map_node n; -00049 int64_t val; -00050 }; -00051 -00052 <span class="comment">/* map element containing string */</span> -00053 <span class="keyword">struct </span>map_node_str { -00054 <span class="keyword">struct </span>map_node n; -00055 <span class="keywordtype">char</span> *str; -00056 }; -00057 -00058 <span class="comment">/* map element containing stats */</span> -00059 <span class="keyword">struct </span>map_node_stat { -00060 <span class="keyword">struct </span>map_node n; -00061 stat stats; -00062 }; -00063 -00064 <span class="comment">/* This structure contains all information about a map.</span> -00065 <span class="comment"> * It is allocated once when _stp_map_new() is called. </span> -00066 <span class="comment"> */</span> -00067 <span class="keyword">struct </span>map_root { -00068 <span class="comment">/* type of the values stored in the array */</span> -00069 <span class="keyword">enum</span> <a class="code" href="group__maps.html#ga34">valtype</a> type; -00070 -00071 <span class="comment">/* maximum number of elements allowed in the array. */</span> -00072 <span class="keywordtype">int</span> maxnum; -00073 -00074 <span class="comment">/* current number of used elements */</span> -00075 <span class="keywordtype">int</span> num; -00076 -00077 <span class="comment">/* when more than maxnum elements, wrap or discard? */</span> -00078 <span class="keywordtype">int</span> no_wrap; -00079 -00080 <span class="comment">/* linked list of current entries */</span> -00081 <span class="keyword">struct </span>list_head head; -00082 -00083 <span class="comment">/* pool of unused entries. Used only when entries are statically allocated</span> -00084 <span class="comment"> at startup. */</span> -00085 <span class="keyword">struct </span>list_head pool; -00086 -00087 <span class="comment">/* saved key entry for lookups */</span> -00088 <span class="keyword">struct </span>map_node *key; -00089 <span class="comment"></span> -00090 <span class="comment"> /** this is the creation data saved between the key functions and the</span> -00091 <span class="comment"> set/get functions </span> -00092 <span class="comment"> @todo Needs to be per-cpu data for SMP support */</span> -00093 u_int8_t create; -00094 <span class="keyword">enum</span> <a class="code" href="group__maps.html#ga33">keytype</a> c_key1type; -00095 <span class="keyword">enum</span> <a class="code" href="group__maps.html#ga33">keytype</a> c_key2type; -00096 <span class="keyword">struct </span>hlist_head *c_keyhead; -00097 <span class="keyword">union </span>key_data c_key1; -00098 <span class="keyword">union </span>key_data c_key2; -00099 <span class="comment"></span> -00100 <span class="comment"> /** the hash table for this array */</span> -00101 <span class="keyword">struct </span>hlist_head hashes[HASH_TABLE_SIZE]; -00102 <span class="comment"></span> -00103 <span class="comment"> /** pointer to allocated memory space. Used for freeing memory. */</span> -00104 <span class="keywordtype">void</span> *membuf; -00105 }; -00106 <span class="comment"></span> -00107 <span class="comment">/** All maps are of this type. */</span> -<a name="l00108"></a><a class="code" href="group__maps.html#ga1">00108</a> <span class="keyword">typedef</span> <span class="keyword">struct </span>map_root *<a class="code" href="group__maps.html#ga1">MAP</a>; -00109 <span class="comment"></span> -00110 <span class="comment">/** Extracts string from key1 union */</span> -<a name="l00111"></a><a class="code" href="group__maps.html#ga25">00111</a> <span class="preprocessor">#define key1str(ptr) (ptr->n.key1.str)</span> -00112 <span class="preprocessor"></span><span class="comment">/** Extracts string from key2 union */</span> -<a name="l00113"></a><a class="code" href="group__maps.html#ga26">00113</a> <span class="preprocessor">#define key2str(ptr) (ptr->n.key2.str)</span> -00114 <span class="preprocessor"></span><span class="comment">/** Extracts int from key1 union */</span> -<a name="l00115"></a><a class="code" href="group__maps.html#ga27">00115</a> <span class="preprocessor">#define key1int(ptr) (ptr->n.key1.val)</span> -00116 <span class="preprocessor"></span><span class="comment">/** Extracts int from key2 union */</span> -<a name="l00117"></a><a class="code" href="group__maps.html#ga28">00117</a> <span class="preprocessor">#define key2int(ptr) (ptr->n.key2.val)</span> -00118 <span class="preprocessor"></span><span class="comment"></span> -00119 <span class="comment">/** Macro to call the proper _stp_map_key functions based on the</span> -00120 <span class="comment"> * types of the arguments. </span> -00121 <span class="comment"> * @note May cause compiler warning on some GCCs </span> -00122 <span class="comment"> */</span> -<a name="l00123"></a><a class="code" href="group__maps.html#ga29">00123</a> <span class="preprocessor">#define _stp_map_key2(map, key1, key2) \</span> -00124 <span class="preprocessor"> ({ \</span> -00125 <span class="preprocessor"> if (__builtin_types_compatible_p (typeof (key1), char[])) \</span> -00126 <span class="preprocessor"> if (__builtin_types_compatible_p (typeof (key2), char[])) \</span> -00127 <span class="preprocessor"> _stp_map_key_str_str (map, (char *)(key1), (char *)(key2)); \</span> -00128 <span class="preprocessor"> else \</span> -00129 <span class="preprocessor"> _stp_map_key_str_long (map, (char *)(key1), (long)(key2)); \</span> -00130 <span class="preprocessor"> else \</span> -00131 <span class="preprocessor"> if (__builtin_types_compatible_p (typeof (key2), char[])) \</span> -00132 <span class="preprocessor"> _stp_map_key_long_str (map, (long)(key1), (char *)(key2)); \</span> -00133 <span class="preprocessor"> else \</span> -00134 <span class="preprocessor"> _stp_map_key_long_long (map, (long)(key1), (long)(key2)); \</span> -00135 <span class="preprocessor"> })</span> -00136 <span class="preprocessor"></span><span class="comment"></span> -00137 <span class="comment">/** Macro to call the proper _stp_map_key function based on the</span> -00138 <span class="comment"> * type of the argument. </span> -00139 <span class="comment"> * @note May cause compiler warning on some GCCs </span> -00140 <span class="comment"> */</span> -<a name="l00141"></a><a class="code" href="group__maps.html#ga30">00141</a> <span class="preprocessor">#define _stp_map_key(map, key) \</span> -00142 <span class="preprocessor"> ({ \</span> -00143 <span class="preprocessor"> if (__builtin_types_compatible_p (typeof (key), char[])) \</span> -00144 <span class="preprocessor"> _stp_map_key_str (map, (char *)(key)); \</span> -00145 <span class="preprocessor"> else \</span> -00146 <span class="preprocessor"> _stp_map_key_long (map, (long)(key)); \</span> -00147 <span class="preprocessor"> })</span> -00148 <span class="preprocessor"></span><span class="comment"></span> -00149 <span class="comment">/** Macro to call the proper _stp_map_set function based on the</span> -00150 <span class="comment"> * type of the argument. </span> -00151 <span class="comment"> * @note May cause compiler warning on some GCCs </span> -00152 <span class="comment"> */</span> -<a name="l00153"></a><a class="code" href="group__maps.html#ga31">00153</a> <span class="preprocessor">#define _stp_map_set(map, val) \</span> -00154 <span class="preprocessor"> ({ \</span> -00155 <span class="preprocessor"> if (__builtin_types_compatible_p (typeof (val), char[])) \</span> -00156 <span class="preprocessor"> _stp_map_set_str (map, (char *)(val)); \</span> -00157 <span class="preprocessor"> else if (__builtin_types_compatible_p (typeof (val), String)) \</span> -00158 <span class="preprocessor"> _stp_map_set_string (map, (String)(val)); \</span> -00159 <span class="preprocessor"> else \</span> -00160 <span class="preprocessor"> _stp_map_set_int64 (map, (int64_t)(val)); \</span> -00161 <span class="preprocessor"> })</span> -00162 <span class="preprocessor"></span><span class="comment"></span> -00163 <span class="comment">/** Loop through all elements of a map or list.</span> -00164 <span class="comment"> * @param map </span> -00165 <span class="comment"> * @param ptr pointer to a map_node_stat, map_node_int64 or map_node_str</span> -00166 <span class="comment"> *</span> -00167 <span class="comment"> * @b Example:</span> -00168 <span class="comment"> * @include foreach.c</span> -00169 <span class="comment"> */</span> -00170 -<a name="l00171"></a><a class="code" href="group__maps.html#ga32">00171</a> <span class="preprocessor">#define foreach(map, ptr) \</span> -00172 <span class="preprocessor"> for (ptr = (typeof(ptr))_stp_map_start(map); ptr; \</span> -00173 <span class="preprocessor"> ptr = (typeof(ptr))_stp_map_iter (map, (struct map_node *)ptr))</span> -00174 <span class="preprocessor"></span><span class="comment"></span> -00175 <span class="comment">/** @} */</span> -00176 <span class="comment"></span> -00177 <span class="comment">/** @ingroup lists</span> -00178 <span class="comment"> * @brief Macro to call the proper _stp_list_add function based on the</span> -00179 <span class="comment"> * types of the argument. </span> -00180 <span class="comment"> *</span> -00181 <span class="comment"> * @note May cause compiler warning on some GCCs </span> -00182 <span class="comment"> */</span> -<a name="l00183"></a><a class="code" href="group__lists.html#ga6">00183</a> <span class="preprocessor">#define _stp_list_add(map, val) \</span> -00184 <span class="preprocessor"> ({ \</span> -00185 <span class="preprocessor"> if (__builtin_types_compatible_p (typeof (val), char[])) \</span> -00186 <span class="preprocessor"> _stp_list_add_str (map, (char *)(val)); \</span> -00187 <span class="preprocessor"> else if (__builtin_types_compatible_p (typeof (val), String)) \</span> -00188 <span class="preprocessor"> _stp_list_add_string (map, (String)(val)); \</span> -00189 <span class="preprocessor"> else \</span> -00190 <span class="preprocessor"> _stp_list_add_int64 (map, (int64_t)(val)); \</span> -00191 <span class="preprocessor"> })</span> -00192 <span class="preprocessor"></span> -00193 <span class="preprocessor">#endif </span><span class="comment">/* _MAP_H_ */</span> -</pre></div></body></html> diff --git a/runtime/docs/html/map_8h.html b/runtime/docs/html/map_8h.html deleted file mode 100644 index 23b5430b..00000000 --- a/runtime/docs/html/map_8h.html +++ /dev/null @@ -1,77 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: map.h File Reference</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1>map.h File Reference</h1>Header file for maps and lists. <a href="#_details">More...</a> -<p> -<code>#include <linux/types.h></code><br> - -<p> -<a href="map_8h-source.html">Go to the source code of this file.</a><table border="0" cellpadding="0" cellspacing="0"> -<tr><td></td></tr> -<tr><td colspan="2"><br><h2>Defines</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="ga25" doxytag="map.h::key1str"></a> -#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga25">key1str</a>(ptr) (ptr->n.key1.str)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Extracts string from key1 union. <br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="ga26" doxytag="map.h::key2str"></a> -#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga26">key2str</a>(ptr) (ptr->n.key2.str)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Extracts string from key2 union. <br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="ga27" doxytag="map.h::key1int"></a> -#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga27">key1int</a>(ptr) (ptr->n.key1.val)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Extracts int from key1 union. <br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="ga28" doxytag="map.h::key2int"></a> -#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga28">key2int</a>(ptr) (ptr->n.key2.val)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Extracts int from key2 union. <br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga29">_stp_map_key2</a>(map, key1, key2)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Macro to call the proper _stp_map_key functions based on the types of the arguments. <a href="group__maps.html#ga29"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga30">_stp_map_key</a>(map, key)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Macro to call the proper _stp_map_key function based on the type of the argument. <a href="group__maps.html#ga30"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga31">_stp_map_set</a>(map, val)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Macro to call the proper _stp_map_set function based on the type of the argument. <a href="group__maps.html#ga31"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga32">foreach</a>(map, ptr)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Loop through all elements of a map or list. <a href="group__maps.html#ga32"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__lists.html#ga6">_stp_list_add</a>(map, val)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Macro to call the proper _stp_list_add function based on the types of the argument. <a href="group__lists.html#ga6"></a><br></td></tr> -<tr><td colspan="2"><br><h2>Typedefs</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="ga1" doxytag="map.h::MAP"></a> -typedef map_root * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga1">MAP</a></td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">All maps are of this type. <br></td></tr> -<tr><td colspan="2"><br><h2>Enumerations</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">enum </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga33">keytype</a> { <b>NONE</b>, -<b>LONG</b>, -<b>STR</b> - }</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">keys can be longs or strings <br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">enum </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga34">valtype</a> { <b>INT64</b>, -<b>STAT</b>, -<b>STRING</b>, -<b>END</b> - }</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">values can be either int64, stats or strings <br></td></tr> -<tr><td colspan="2"><br><h2>Variables</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="ga0" doxytag="map.h::packed"></a> -enum <a class="el" href="group__maps.html#ga33">keytype</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__maps.html#ga0">packed</a></td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">keys can be longs or strings <br></td></tr> -</table> -<hr><a name="_details"></a><h2>Detailed Description</h2> -Header file for maps and lists. -<p> - -<p> -Definition in file <a class="el" href="map_8h-source.html">map.h</a>.</body></html> diff --git a/runtime/docs/html/modules.html b/runtime/docs/html/modules.html deleted file mode 100644 index 1c46a1f7..00000000 --- a/runtime/docs/html/modules.html +++ /dev/null @@ -1,20 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: Module Index</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindexHL" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1>SystemTap Modules</h1>Here is a list of all modules:<ul> -<li><a class="el" href="group__alloc.html">Memory Functions</a> -<li><a class="el" href="group__copy.html">Functions to copy from user space.</a> -<li><a class="el" href="group__current.html">Current State</a> -<li><a class="el" href="group__io.html">I/O</a> -<li><a class="el" href="group__maps.html">Maps</a> -<li><a class="el" href="group__lists.html">Lists</a> -<li><a class="el" href="group__print.html">Print Buffer</a> -<li><a class="el" href="group__stack.html">Stack Tracing Functions</a> -<li><a class="el" href="group__string.html">String Functions</a> -<li><a class="el" href="group__sym.html">Symbolic Functions</a> -</ul> -</body></html> diff --git a/runtime/docs/html/pages.html b/runtime/docs/html/pages.html deleted file mode 100644 index e1ceb057..00000000 --- a/runtime/docs/html/pages.html +++ /dev/null @@ -1,16 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: Page Index</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindexHL" href="pages.html">Related Pages</a></div> -<h1>SystemTap Related Pages</h1>Here is a list of all related documentation pages:<ul> -<li><a class="el" href="todo.html">Todo List</a> - -<li><a class="el" href="bug.html">Bug List</a> - -<li><a class="el" href="deprecated.html">Deprecated List</a> - -</ul> -</body></html> diff --git a/runtime/docs/html/print_8c-source.html b/runtime/docs/html/print_8c-source.html deleted file mode 100644 index c020fff3..00000000 --- a/runtime/docs/html/print_8c-source.html +++ /dev/null @@ -1,208 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: print.c Source File</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1>print.c</h1><div class="fragment"><pre class="fragment">00001 <span class="preprocessor">#ifndef _PRINT_C_ </span><span class="comment">/* -*- linux-c -*- */</span> -00002 <span class="preprocessor">#define _PRINT_C_</span> -00003 <span class="preprocessor"></span> -00004 <span class="preprocessor">#include <linux/config.h></span> -00005 -00006 <span class="preprocessor">#include "<a class="code" href="io_8c.html">io.c</a>"</span> -00007 <span class="comment"></span> -00008 <span class="comment">/** @file print.c</span> -00009 <span class="comment"> * @addtogroup print Print Buffer</span> -00010 <span class="comment"> * Print Buffer Functions.</span> -00011 <span class="comment"> * The print buffer is for collecting output to send to the user daemon.</span> -00012 <span class="comment"> * This is a per-cpu static buffer. The buffer is sent when</span> -00013 <span class="comment"> * _stp_print_flush() is called.</span> -00014 <span class="comment"> *</span> -00015 <span class="comment"> * The reason to do this is to allow multiple small prints to be combined then</span> -00016 <span class="comment"> * timestamped and sent together to stpd. It could flush automatically on newlines,</span> -00017 <span class="comment"> * but what about stack traces which span many lines? So try this and see how it works for us.</span> -00018 <span class="comment"> * @{</span> -00019 <span class="comment"> */</span> -00020 <span class="comment"></span> -00021 <span class="comment">/** Size of buffer, not including terminating NULL */</span> -<a name="l00022"></a><a class="code" href="group__print.html#ga8">00022</a> <span class="preprocessor">#define STP_PRINT_BUF_LEN 8000</span> -00023 <span class="preprocessor"></span> -00024 <span class="keyword">static</span> <span class="keywordtype">int</span> _stp_pbuf_len[NR_CPUS]; -00025 -00026 <span class="preprocessor">#ifdef STP_NETLINK_ONLY</span> -00027 <span class="preprocessor"></span><span class="preprocessor">#define STP_PRINT_BUF_START 0</span> -00028 <span class="preprocessor"></span><span class="keyword">static</span> <span class="keywordtype">char</span> _stp_pbuf[NR_CPUS][<a class="code" href="group__print.html#ga8">STP_PRINT_BUF_LEN</a> + 1]; -00029 -00030 <span class="keywordtype">void</span> <a class="code" href="group__print.html#ga2">_stp_print_flush</a> (<span class="keywordtype">void</span>) -00031 { -00032 <span class="keywordtype">int</span> cpu = smp_processor_id(); -00033 <span class="keywordtype">char</span> *buf = &_stp_pbuf[cpu][0]; -00034 <span class="keywordtype">int</span> len = _stp_pbuf_len[cpu]; -00035 -00036 <span class="keywordflow">if</span> (len == 0) -00037 <span class="keywordflow">return</span>; -00038 -00039 <span class="keywordflow">if</span> ( app.logging == 0) { -00040 _stp_pbuf_len[cpu] = 0; -00041 <span class="keywordflow">return</span>; -00042 } -00043 -00044 <span class="comment">/* enforce newline at end */</span> -00045 <span class="keywordflow">if</span> (buf[len - 1] != <span class="charliteral">'\n'</span>) { -00046 buf[len++] = <span class="charliteral">'\n'</span>; -00047 buf[len] = <span class="charliteral">'\0'</span>; -00048 } -00049 -00050 send_reply (STP_REALTIME_DATA, buf, len + 1, stpd_pid); -00051 _stp_pbuf_len[cpu] = 0; -00052 } -00053 -00054 <span class="preprocessor">#else </span><span class="comment">/* ! STP_NETLINK_ONLY */</span> -00055 <span class="comment">/* size of timestamp, in bytes, including space */</span> -00056 <span class="preprocessor">#define TIMESTAMP_SIZE 19</span> -00057 <span class="preprocessor"></span><span class="preprocessor">#define STP_PRINT_BUF_START (TIMESTAMP_SIZE + 1)</span> -00058 <span class="preprocessor"></span><span class="keyword">static</span> <span class="keywordtype">char</span> _stp_pbuf[NR_CPUS][<a class="code" href="group__print.html#ga8">STP_PRINT_BUF_LEN</a> + STP_PRINT_BUF_START + 1]; -00059 <span class="comment"></span> -00060 <span class="comment">/** Send the print buffer now.</span> -00061 <span class="comment"> * Output accumulates in the print buffer until this is called.</span> -00062 <span class="comment"> * Size is limited by length of print buffer, #STP_PRINT_BUF_LEN.</span> -00063 <span class="comment"> */</span> -00064 -<a name="l00065"></a><a class="code" href="group__print.html#ga2">00065</a> <span class="keywordtype">void</span> <a class="code" href="group__print.html#ga2">_stp_print_flush</a> (<span class="keywordtype">void</span>) -00066 { -00067 <span class="keywordtype">int</span> cpu = smp_processor_id(); -00068 <span class="keywordtype">char</span> *buf = &_stp_pbuf[cpu][0]; -00069 <span class="keywordtype">char</span> *ptr = buf + STP_PRINT_BUF_START; -00070 <span class="keyword">struct </span>timeval tv; -00071 -00072 <span class="keywordflow">if</span> (_stp_pbuf_len[cpu] == 0) -00073 <span class="keywordflow">return</span>; -00074 -00075 <span class="comment">/* enforce newline at end */</span> -00076 <span class="keywordflow">if</span> (ptr[_stp_pbuf_len[cpu]-1] != <span class="charliteral">'\n'</span>) { -00077 ptr[_stp_pbuf_len[cpu]++] = <span class="charliteral">'\n'</span>; -00078 ptr[_stp_pbuf_len[cpu]] = <span class="charliteral">'\0'</span>; -00079 } -00080 -00081 do_gettimeofday(&tv); -00082 scnprintf (buf, TIMESTAMP_SIZE+1, <span class="stringliteral">"[%li.%06li] "</span>, tv.tv_sec, tv.tv_usec); -00083 buf[TIMESTAMP_SIZE] = <span class="charliteral">' '</span>; -00084 relayapp_write(buf, _stp_pbuf_len[cpu] + TIMESTAMP_SIZE + 2); -00085 _stp_pbuf_len[cpu] = 0; -00086 } -00087 <span class="preprocessor">#endif </span><span class="comment">/* STP_NETLINK_ONLY */</span> -00088 <span class="comment"></span> -00089 <span class="comment">/** Print into the print buffer.</span> -00090 <span class="comment"> * Like printf, except output goes to the print buffer.</span> -00091 <span class="comment"> * Safe because overflowing the buffer is not allowed.</span> -00092 <span class="comment"> * Size is limited by length of print buffer, #STP_PRINT_BUF_LEN.</span> -00093 <span class="comment"> * </span> -00094 <span class="comment"> * @param fmt A printf-style format string followed by a </span> -00095 <span class="comment"> * variable number of args.</span> -00096 <span class="comment"> * @sa _stp_print_flush()</span> -00097 <span class="comment"> */</span> -00098 -<a name="l00099"></a><a class="code" href="group__print.html#ga3">00099</a> <span class="keywordtype">void</span> <a class="code" href="group__print.html#ga3">_stp_printf</a> (<span class="keyword">const</span> <span class="keywordtype">char</span> *fmt, ...) -00100 { -00101 <span class="keywordtype">int</span> num; -00102 va_list args; -00103 <span class="keywordtype">int</span> cpu = smp_processor_id(); -00104 <span class="keywordtype">char</span> *buf = &_stp_pbuf[cpu][STP_PRINT_BUF_START] + _stp_pbuf_len[cpu]; -00105 va_start(args, fmt); -00106 num = vscnprintf(buf, <a class="code" href="group__print.html#ga8">STP_PRINT_BUF_LEN</a> - _stp_pbuf_len[cpu], fmt, args); -00107 va_end(args); -00108 <span class="keywordflow">if</span> (num > 0) -00109 _stp_pbuf_len[cpu] += num; -00110 } -00111 <span class="comment"></span> -00112 <span class="comment">/** Print into the print buffer.</span> -00113 <span class="comment"> * Use this if your function already has a va_list.</span> -00114 <span class="comment"> * You probably want _stp_printf().</span> -00115 <span class="comment"> */</span> -00116 -<a name="l00117"></a><a class="code" href="group__print.html#ga4">00117</a> <span class="keywordtype">void</span> <a class="code" href="group__print.html#ga4">_stp_vprintf</a> (<span class="keyword">const</span> <span class="keywordtype">char</span> *fmt, va_list args) -00118 { -00119 <span class="keywordtype">int</span> num; -00120 <span class="keywordtype">int</span> cpu = smp_processor_id(); -00121 <span class="keywordtype">char</span> *buf = &_stp_pbuf[cpu][STP_PRINT_BUF_START] + _stp_pbuf_len[cpu]; -00122 num = vscnprintf(buf, <a class="code" href="group__print.html#ga8">STP_PRINT_BUF_LEN</a> -_stp_pbuf_len[cpu], fmt, args); -00123 <span class="keywordflow">if</span> (num > 0) -00124 _stp_pbuf_len[cpu] += num; -00125 } -00126 <span class="comment"></span> -00127 <span class="comment">/** Write a C string into the print buffer.</span> -00128 <span class="comment"> * Copies a string into a print buffer.</span> -00129 <span class="comment"> * Safe because overflowing the buffer is not allowed.</span> -00130 <span class="comment"> * Size is limited by length of print buffer, #STP_PRINT_BUF_LEN.</span> -00131 <span class="comment"> * This is more efficient than using _stp_printf() if you don't</span> -00132 <span class="comment"> * need fancy formatting.</span> -00133 <span class="comment"> *</span> -00134 <span class="comment"> * @param str A C string.</span> -00135 <span class="comment"> * @sa _stp_print</span> -00136 <span class="comment"> */</span> -00137 -<a name="l00138"></a><a class="code" href="group__print.html#ga5">00138</a> <span class="keywordtype">void</span> <a class="code" href="group__print.html#ga5">_stp_print_cstr</a> (<span class="keyword">const</span> <span class="keywordtype">char</span> *str) -00139 { -00140 <span class="keywordtype">int</span> cpu = smp_processor_id(); -00141 <span class="keywordtype">char</span> *buf = &_stp_pbuf[cpu][STP_PRINT_BUF_START] + _stp_pbuf_len[cpu]; -00142 <span class="keywordtype">int</span> num = strlen (str); -00143 <span class="keywordflow">if</span> (num > <a class="code" href="group__print.html#ga8">STP_PRINT_BUF_LEN</a> - _stp_pbuf_len[cpu]) -00144 num = <a class="code" href="group__print.html#ga8">STP_PRINT_BUF_LEN</a> - _stp_pbuf_len[cpu]; -00145 strncpy (buf, str, num+1); -00146 _stp_pbuf_len[cpu] += num; -00147 } -00148 <span class="comment"></span> -00149 <span class="comment">/** Clear the scratch buffer.</span> -00150 <span class="comment"> * This function should be called before anything is written to </span> -00151 <span class="comment"> * the scratch buffer. Output will accumulate in the buffer</span> -00152 <span class="comment"> * until this function is called again. </span> -00153 <span class="comment"> * @returns A pointer to the buffer.</span> -00154 <span class="comment"> */</span> -00155 -<a name="l00156"></a><a class="code" href="group__print.html#ga6">00156</a> <span class="keywordtype">char</span> *<a class="code" href="group__print.html#ga6">_stp_print_clear</a> (<span class="keywordtype">void</span>) -00157 { -00158 <span class="keywordtype">int</span> cpu = smp_processor_id(); -00159 _stp_pbuf_len[cpu] = 0; -00160 <span class="keywordflow">return</span> &_stp_pbuf[cpu][STP_PRINT_BUF_START]; -00161 } -00162 -00163 <span class="preprocessor">#include "<a class="code" href="string_8c.html">string.c</a>"</span> -00164 <span class="comment"></span> -00165 <span class="comment">/** Write a String into the print buffer.</span> -00166 <span class="comment"> * Copies a String into a print buffer.</span> -00167 <span class="comment"> * Safe because overflowing the buffer is not allowed.</span> -00168 <span class="comment"> * Size is limited by length of print buffer, #STP_PRINT_BUF_LEN.</span> -00169 <span class="comment"> * This is more efficient than using _stp_printf() if you don't</span> -00170 <span class="comment"> * need fancy formatting.</span> -00171 <span class="comment"> *</span> -00172 <span class="comment"> * @param str A String.</span> -00173 <span class="comment"> * @sa _stp_print</span> -00174 <span class="comment"> */</span> -00175 -<a name="l00176"></a><a class="code" href="group__print.html#ga7">00176</a> <span class="keywordtype">void</span> <a class="code" href="group__print.html#ga7">_stp_print_string</a> (String str) -00177 { -00178 <span class="keywordflow">if</span> (str->len) -00179 <a class="code" href="group__print.html#ga5">_stp_print_cstr</a> (str->buf); -00180 } -00181 <span class="comment"></span> -00182 <span class="comment">/** Write a String or C string into the print buffer.</span> -00183 <span class="comment"> * This macro selects the proper function to call.</span> -00184 <span class="comment"> * @param str A String or C string (char *)</span> -00185 <span class="comment"> * @sa _stp_print_cstr _stp_print_string</span> -00186 <span class="comment"> */</span> -00187 -<a name="l00188"></a><a class="code" href="group__print.html#ga11">00188</a> <span class="preprocessor">#define _stp_print(str) \</span> -00189 <span class="preprocessor"> ({ \</span> -00190 <span class="preprocessor"> if (__builtin_types_compatible_p (typeof (str), char[])) { \</span> -00191 <span class="preprocessor"> char *x = (char *)str; \</span> -00192 <span class="preprocessor"> _stp_print_cstr(x); \</span> -00193 <span class="preprocessor"> } else { \</span> -00194 <span class="preprocessor"> String x = (String)str; \</span> -00195 <span class="preprocessor"> _stp_print_string(x); \</span> -00196 <span class="preprocessor"> } \</span> -00197 <span class="preprocessor"> })</span> -00198 <span class="preprocessor"></span><span class="comment"></span> -00199 <span class="comment">/** @} */</span> -00200 <span class="preprocessor">#endif </span><span class="comment">/* _PRINT_C_ */</span> -</pre></div></body></html> diff --git a/runtime/docs/html/probes_2README-source.html b/runtime/docs/html/probes_2README-source.html deleted file mode 100644 index ee82281f..00000000 --- a/runtime/docs/html/probes_2README-source.html +++ /dev/null @@ -1,14 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: probes/README Source File</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<div class="nav"> -<a class="el" href="dir_000000.html">probes</a></div> -<h1>README</h1><div class="fragment"><pre class="fragment">00001 <span class="comment">/** @dir probes</span> -00002 <span class="comment">This directory contains working example probes that demonstrate and test</span> -00003 <span class="comment">the runtime library. They are tested on i386 and x86_64.</span> -00004 <span class="comment">*/</span> -</pre></div></body></html> diff --git a/runtime/docs/html/probes_2shellsnoop_2README-source.html b/runtime/docs/html/probes_2shellsnoop_2README-source.html deleted file mode 100644 index e7384ecb..00000000 --- a/runtime/docs/html/probes_2shellsnoop_2README-source.html +++ /dev/null @@ -1,83 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: probes/shellsnoop/README Source File</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<div class="nav"> -<a class="el" href="dir_000000.html">probes</a> / <a class="el" href="dir_000001.html">shellsnoop</a></div> -<h1>README</h1><div class="fragment"><pre class="fragment">00001 <span class="comment">/** @dir shellsnoop</span> -00002 <span class="comment">Snoops on what commands are being run by shells.</span> -00003 <span class="comment"></span> -00004 <span class="comment">This is a translation of on an old dtr probe. It demonstrates maps,</span> -00005 <span class="comment">lists, and how to use _stp_copy_argv_from_user() and _stp_strncpy_from_user().</span> -00006 <span class="comment"></span> -00007 <span class="comment">Original dtr source:</span> -00008 <span class="comment"></span> -00009 <span class="comment">\verbatim</span> -00010 <span class="comment"># shellsnoop.probe - snoop shell execution as it occurs.</span> -00011 <span class="comment"># clone of dtrace shellsnoop example</span> -00012 <span class="comment"></span> -00013 <span class="comment">global {</span> -00014 <span class="comment"> long @pids[long];</span> -00015 <span class="comment">}</span> -00016 <span class="comment"></span> -00017 <span class="comment">probe do_execve:entry {</span> -00018 <span class="comment"> char __user *vstr;</span> -00019 <span class="comment"> char str[256];</span> -00020 <span class="comment"> int len;</span> -00021 <span class="comment"></span> -00022 <span class="comment"> /* watch shells only */</span> -00023 <span class="comment">/* FIXME: detect more shells, like csh, tcsh, zsh */</span> -00024 -00025 <span class="keywordflow">if</span> (!strcmp(current->comm,<span class="stringliteral">"bash"</span>) || !strcmp(current->comm,<span class="stringliteral">"sh"</span>) || !strcmp(current->comm, <span class="stringliteral">"zsh"</span>) -00026 || !strcmp(current->comm, <span class="stringliteral">"tcsh"</span>) || !strcmp(current->comm, <span class="stringliteral">"pdksh"</span>)) -00027 { -00028 dlog (<span class="stringliteral">"%d\t%d\t%d\t%s "</span>, current->uid, current->pid, current->parent->pid, filename); -00029 @pids[current->pid] = 1; -00030 -00031 <span class="comment">/* print out argv, ignoring argv[0] */</span> -00032 <span class="keywordflow">if</span> (argv) argv++; -00033 while (argv != NULL) -00034 { -00035 <span class="keywordflow">if</span> (get_user (vstr, argv)) -00036 break; -00037 if (!vstr) -00038 break; -00039 len = dtr_strncpy_from_user(str, vstr, 256); -00040 str[len] = 0; -00041 printk ("%s ", str); -00042 argv++; -00043 } -00044 printk ("\n"); -00045 } -00046 } -00047 -00048 # use filp_open because copy_from_user not needed there -00049 probe filp_open:entry { -00050 <span class="keywordflow">if</span> (@pids[current->pid]) -00051 dlog ("%d\t%d\t%s\tO %s\n", current->pid, current->parent->pid, current->comm, filename); -00052 } -00053 -00054 probe sys_read:entry { -00055 <span class="keywordflow">if</span> (@pids[current->pid]) -00056 dlog ("%d\t%d\t%s\tR %d\n", current->pid, current->parent->pid, current->comm, fd); -00057 } -00058 -00059 probe sys_write:entry { -00060 size_t len; -00061 <span class="keywordtype">char</span> str[256]; -00062 <span class="keywordflow">if</span> (@pids[current->pid]) -00063 { -00064 <span class="keywordflow">if</span> (count < 64) len = count; -00065 else len = 64; -00066 if (len = dtr_strncpy_from_user(str, buf, len)) { -00067 str[len] = 0; -00068 dlog (<span class="stringliteral">"%d\t%d\t%s\tW %s\n"</span>, current->pid, current->parent->pid, current->comm, str); -00069 } -00070 } -00071 } -00072 \endverbatim -00073 */ -</pre></div></body></html> diff --git a/runtime/docs/html/probes_2tasklet_2README-source.html b/runtime/docs/html/probes_2tasklet_2README-source.html deleted file mode 100644 index d49f0a1f..00000000 --- a/runtime/docs/html/probes_2tasklet_2README-source.html +++ /dev/null @@ -1,20 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: probes/tasklet/README Source File</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<div class="nav"> -<a class="el" href="dir_000000.html">probes</a> / <a class="el" href="dir_000002.html">tasklet</a></div> -<h1>README</h1><div class="fragment"><pre class="fragment">00001 <span class="comment">/** @dir tasklet</span> -00002 <span class="comment">Sample probe in a tasklet. Useful for interrupt context testing.</span> -00003 <span class="comment"></span> -00004 <span class="comment">\verbatim</span> -00005 <span class="comment">> ./build</span> -00006 <span class="comment">> insmod stp_tasklet.ko</span> -00007 <span class="comment">> rmmod stp_tasklet.ko</span> -00008 <span class="comment">\endverbatim</span> -00009 <span class="comment"></span> -00010 <span class="comment">*/</span> -</pre></div></body></html> diff --git a/runtime/docs/html/probes_2test4_2README-source.html b/runtime/docs/html/probes_2test4_2README-source.html deleted file mode 100644 index 20ebcf80..00000000 --- a/runtime/docs/html/probes_2test4_2README-source.html +++ /dev/null @@ -1,34 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: probes/test4/README Source File</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<div class="nav"> -<a class="el" href="dir_000000.html">probes</a> / <a class="el" href="dir_000003.html">test4</a></div> -<h1>README</h1><div class="fragment"><pre class="fragment">00001 <span class="comment">/** @dir test4</span> -00002 <span class="comment">This example probe tracks file opens, reads and writes.</span> -00003 <span class="comment">It demonstrates maps, stats, and iterators.</span> -00004 <span class="comment"></span> -00005 <span class="comment">This is a translation of on an old dtr probe. Original source is</span> -00006 <span class="comment">\verbatim</span> -00007 <span class="comment">global {</span> -00008 <span class="comment"> long @opens[string];</span> -00009 <span class="comment"> sum @reads[string], @writes[string];</span> -00010 <span class="comment">}</span> -00011 <span class="comment"></span> -00012 <span class="comment">probe sys_open:entry {</span> -00013 <span class="comment"> @opens[current->comm]++;</span> -00014 <span class="comment">}</span> -00015 <span class="comment"></span> -00016 <span class="comment">probe sys_read:entry {</span> -00017 <span class="comment"> @reads[current->comm] << count;</span> -00018 <span class="comment">}</span> -00019 <span class="comment"></span> -00020 <span class="comment">probe sys_write:entry {</span> -00021 <span class="comment"> @writes[current->comm] << count;</span> -00022 <span class="comment">}</span> -00023 <span class="comment">\endverbatim</span> -00024 <span class="comment">*/</span> -</pre></div></body></html> diff --git a/runtime/docs/html/probes_2where__func_2README-source.html b/runtime/docs/html/probes_2where__func_2README-source.html deleted file mode 100644 index eb81beda..00000000 --- a/runtime/docs/html/probes_2where__func_2README-source.html +++ /dev/null @@ -1,36 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: probes/where_func/README Source File</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<div class="nav"> -<a class="el" href="dir_000000.html">probes</a> / <a class="el" href="dir_000004.html">where_func</a></div> -<h1>README</h1><div class="fragment"><pre class="fragment">00001 <span class="comment">/** @dir where_func</span> -00002 <span class="comment">This is a silly little instrumentation routine to instrument functions</span> -00003 <span class="comment">entry by name. It makes use of the SystemTap runtime libraries to break</span> -00004 <span class="comment">down the number of times the function by caller. </span> -00005 <span class="comment"></span> -00006 <span class="comment">It demonstrates kprobes, passing a module parameter, using the print buffer,</span> -00007 <span class="comment">and using _stp_print_symbol() to map the addresses back to locations </span> -00008 <span class="comment">in functions.</span> -00009 <span class="comment"></span> -00010 <span class="comment">By default it instruments schedule().</span> -00011 <span class="comment"></span> -00012 <span class="comment">The instrumentation module is built by having the kernel that is going</span> -00013 <span class="comment">to be instrumented currently on the machine and doing </span> -00014 <span class="comment">\code</span> -00015 <span class="comment">./build</span> -00016 <span class="comment">\endcode</span> -00017 <span class="comment">The instrumentation is inserted as root with:</span> -00018 <span class="comment">\code</span> -00019 <span class="comment">/sbin/insmod kprobe_funct_where.ko funct_name=function_name</span> -00020 <span class="comment">\endcode</span> -00021 <span class="comment">The instrumentation is removed as root with:</span> -00022 <span class="comment">\code</span> -00023 <span class="comment">/sbin/rmmod kprobe_funct_where</span> -00024 <span class="comment">\endcode</span> -00025 <span class="comment">-Will Cohen</span> -00026 <span class="comment">*/</span> -</pre></div></body></html> diff --git a/runtime/docs/html/probes_8c-source.html b/runtime/docs/html/probes_8c-source.html deleted file mode 100644 index 6084bad3..00000000 --- a/runtime/docs/html/probes_8c-source.html +++ /dev/null @@ -1,113 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: probes.c Source File</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1>probes.c</h1><a href="probes_8c.html">Go to the documentation of this file.</a><div class="fragment"><pre class="fragment">00001 <span class="preprocessor">#ifndef _PROBES_C_ </span><span class="comment">/* -*- linux-c -*- */</span> -00002 <span class="preprocessor">#define _PROBES_C</span> -00003 <span class="preprocessor"></span><span class="comment"></span> -00004 <span class="comment">/** @file probes.c</span> -00005 <span class="comment"> * @brief Functions to assist loading and unloading groups of probes.</span> -00006 <span class="comment"> */</span> -00007 <span class="comment"></span> -00008 <span class="comment">/** Lookup name.</span> -00009 <span class="comment"> * This simply calls the kernel function kallsyms_lookup_name().</span> -00010 <span class="comment"> * That function is not exported, so this workaround is required.</span> -00011 <span class="comment"> * See the kernel source, kernel/kallsyms.c for more information.</span> -00012 <span class="comment"> */</span> -00013 <span class="keyword">static</span> <span class="keywordtype">unsigned</span> long (*_stp_lookup_name)(<span class="keywordtype">char</span> *name)=(<span class="keywordtype">void</span> *)KALLSYMS_LOOKUP_NAME; -00014 <span class="comment"></span> -00015 <span class="comment">/** Unregister a group of jprobes.</span> -00016 <span class="comment"> * @param probes Pointer to an array of struct jprobe.</span> -00017 <span class="comment"> * @param num_probes Number of probes in the array.</span> -00018 <span class="comment"> */</span> -00019 -<a name="l00020"></a><a class="code" href="probes_8c.html#a2">00020</a> <span class="keywordtype">void</span> <a class="code" href="probes_8c.html#a2">_stp_unregister_jprobes</a> (<span class="keyword">struct</span> jprobe *probes, <span class="keywordtype">int</span> num_probes) -00021 { -00022 <span class="keywordtype">int</span> i; -00023 <span class="keywordflow">for</span> (i = 0; i < num_probes; i++) -00024 unregister_jprobe(&probes[i]); -00025 <a class="code" href="group__io.html#ga2">_stp_log</a> (<span class="stringliteral">"All jprobes removed\n"</span>); -00026 } -00027 <span class="comment"></span> -00028 <span class="comment">/** Register a group of jprobes.</span> -00029 <span class="comment"> * @param probes Pointer to an array of struct jprobe.</span> -00030 <span class="comment"> * @param num_probes Number of probes in the array.</span> -00031 <span class="comment"> * @return 0 on success.</span> -00032 <span class="comment"> */</span> -00033 -<a name="l00034"></a><a class="code" href="probes_8c.html#a3">00034</a> <span class="keywordtype">int</span> <a class="code" href="probes_8c.html#a3">_stp_register_jprobes</a> (<span class="keyword">struct</span> jprobe *probes, <span class="keywordtype">int</span> num_probes) -00035 { -00036 <span class="keywordtype">int</span> i, ret ; -00037 <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> addr; -00038 -00039 <span class="keywordflow">for</span> (i = 0; i < num_probes; i++) { -00040 addr =_stp_lookup_name((<span class="keywordtype">char</span> *)probes[i].kp.addr); -00041 <span class="keywordflow">if</span> (addr == 0) { -00042 <a class="code" href="group__io.html#ga2">_stp_log</a> (<span class="stringliteral">"ERROR: function %s not found!\n"</span>, -00043 (<span class="keywordtype">char</span> *)probes[i].kp.addr); -00044 ret = -1; <span class="comment">/* FIXME */</span> -00045 <span class="keywordflow">goto</span> out; -00046 } -00047 <a class="code" href="group__io.html#ga2">_stp_log</a>(<span class="stringliteral">"inserting jprobe at %s (%p)\n"</span>, probes[i].kp.addr, addr); -00048 probes[i].kp.addr = (kprobe_opcode_t *)addr; -00049 ret = register_jprobe(&probes[i]); -00050 <span class="keywordflow">if</span> (ret) -00051 <span class="keywordflow">goto</span> out; -00052 } -00053 <span class="keywordflow">return</span> 0; -00054 out: -00055 <a class="code" href="group__io.html#ga2">_stp_log</a> (<span class="stringliteral">"probe module initialization failed. Exiting...\n"</span>); -00056 <a class="code" href="probes_8c.html#a2">_stp_unregister_jprobes</a>(probes, i); -00057 <span class="keywordflow">return</span> ret; -00058 } -00059 <span class="comment"></span> -00060 <span class="comment">/** Unregister a group of kprobes.</span> -00061 <span class="comment"> * @param probes Pointer to an array of struct kprobe.</span> -00062 <span class="comment"> * @param num_probes Number of probes in the array.</span> -00063 <span class="comment"> */</span> -00064 -<a name="l00065"></a><a class="code" href="probes_8c.html#a4">00065</a> <span class="keywordtype">void</span> <a class="code" href="probes_8c.html#a4">_stp_unregister_kprobes</a> (<span class="keyword">struct</span> kprobe *probes, <span class="keywordtype">int</span> num_probes) -00066 { -00067 <span class="keywordtype">int</span> i; -00068 <span class="keywordflow">for</span> (i = 0; i < num_probes; i++) -00069 unregister_kprobe(&probes[i]); -00070 <a class="code" href="group__io.html#ga2">_stp_log</a> (<span class="stringliteral">"All kprobes removed\n"</span>); -00071 } -00072 <span class="comment"></span> -00073 <span class="comment">/** Register a group of kprobes.</span> -00074 <span class="comment"> * @param probes Pointer to an array of struct kprobe.</span> -00075 <span class="comment"> * @param num_probes Number of probes in the array.</span> -00076 <span class="comment"> * @return 0 on success.</span> -00077 <span class="comment"> */</span> -00078 -<a name="l00079"></a><a class="code" href="probes_8c.html#a5">00079</a> <span class="keywordtype">int</span> <a class="code" href="probes_8c.html#a5">_stp_register_kprobes</a> (<span class="keyword">struct</span> kprobe *probes, <span class="keywordtype">int</span> num_probes) -00080 { -00081 <span class="keywordtype">int</span> i, ret ; -00082 <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> addr; -00083 -00084 <span class="keywordflow">for</span> (i = 0; i < num_probes; i++) { -00085 addr =_stp_lookup_name((<span class="keywordtype">char</span> *)probes[i].addr); -00086 <span class="keywordflow">if</span> (addr == 0) { -00087 <a class="code" href="group__io.html#ga2">_stp_log</a> (<span class="stringliteral">"ERROR: function %s not found!\n"</span>, -00088 (<span class="keywordtype">char</span> *)probes[i].addr); -00089 ret = -1; <span class="comment">/* FIXME */</span> -00090 <span class="keywordflow">goto</span> out; -00091 } -00092 <a class="code" href="group__io.html#ga2">_stp_log</a>(<span class="stringliteral">"inserting kprobe at %s (%p)\n"</span>, probes[i].addr, addr); -00093 probes[i].addr = (kprobe_opcode_t *)addr; -00094 ret = register_kprobe(&probes[i]); -00095 <span class="keywordflow">if</span> (ret) -00096 <span class="keywordflow">goto</span> out; -00097 } -00098 <span class="keywordflow">return</span> 0; -00099 out: -00100 <a class="code" href="group__io.html#ga2">_stp_log</a> (<span class="stringliteral">"probe module initialization failed. Exiting...\n"</span>); -00101 <a class="code" href="probes_8c.html#a4">_stp_unregister_kprobes</a>(probes, i); -00102 <span class="keywordflow">return</span> ret; -00103 } -00104 -00105 <span class="preprocessor">#endif </span><span class="comment">/* _PROBES_C */</span> -</pre></div></body></html> diff --git a/runtime/docs/html/probes_8c.html b/runtime/docs/html/probes_8c.html deleted file mode 100644 index a43b04af..00000000 --- a/runtime/docs/html/probes_8c.html +++ /dev/null @@ -1,236 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: probes.c File Reference</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1>probes.c File Reference</h1>Functions to assist loading and unloading groups of probes. <a href="#_details">More...</a> -<p> - -<p> -<a href="probes_8c-source.html">Go to the source code of this file.</a><table border="0" cellpadding="0" cellspacing="0"> -<tr><td></td></tr> -<tr><td colspan="2"><br><h2>Functions</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="probes_8c.html#a2">_stp_unregister_jprobes</a> (struct jprobe *probes, int num_probes)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Unregister a group of jprobes. <a href="#a2"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="probes_8c.html#a3">_stp_register_jprobes</a> (struct jprobe *probes, int num_probes)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Register a group of jprobes. <a href="#a3"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="probes_8c.html#a4">_stp_unregister_kprobes</a> (struct kprobe *probes, int num_probes)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Unregister a group of kprobes. <a href="#a4"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="probes_8c.html#a5">_stp_register_kprobes</a> (struct kprobe *probes, int num_probes)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Register a group of kprobes. <a href="#a5"></a><br></td></tr> -</table> -<hr><a name="_details"></a><h2>Detailed Description</h2> -Functions to assist loading and unloading groups of probes. -<p> - -<p> -Definition in file <a class="el" href="probes_8c-source.html">probes.c</a>.<hr><h2>Function Documentation</h2> -<a class="anchor" name="a3" doxytag="probes.c::_stp_register_jprobes"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">int _stp_register_jprobes </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top">struct jprobe * </td> - <td class="mdname" nowrap> <em>probes</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>int </td> - <td class="mdname" nowrap> <em>num_probes</em></td> - </tr> - <tr> - <td class="md"></td> - <td class="md">) </td> - <td class="md" colspan="2"></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Register a group of jprobes. -<p> -<dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>probes</em> </td><td>Pointer to an array of struct jprobe. </td></tr> - <tr><td valign="top"></td><td valign="top"><em>num_probes</em> </td><td>Number of probes in the array. </td></tr> - </table> -</dl> -<dl compact><dt><b>Returns:</b></dt><dd>0 on success. </dd></dl> - -<p> -Definition at line <a class="el" href="probes_8c-source.html#l00034">34</a> of file <a class="el" href="probes_8c-source.html">probes.c</a>. -<p> -References <a class="el" href="io_8c-source.html#l00029">_stp_log()</a>, and <a class="el" href="probes_8c-source.html#l00020">_stp_unregister_jprobes()</a>. </td> - </tr> -</table> -<a class="anchor" name="a5" doxytag="probes.c::_stp_register_kprobes"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">int _stp_register_kprobes </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top">struct kprobe * </td> - <td class="mdname" nowrap> <em>probes</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>int </td> - <td class="mdname" nowrap> <em>num_probes</em></td> - </tr> - <tr> - <td class="md"></td> - <td class="md">) </td> - <td class="md" colspan="2"></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Register a group of kprobes. -<p> -<dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>probes</em> </td><td>Pointer to an array of struct kprobe. </td></tr> - <tr><td valign="top"></td><td valign="top"><em>num_probes</em> </td><td>Number of probes in the array. </td></tr> - </table> -</dl> -<dl compact><dt><b>Returns:</b></dt><dd>0 on success. </dd></dl> - -<p> -Definition at line <a class="el" href="probes_8c-source.html#l00079">79</a> of file <a class="el" href="probes_8c-source.html">probes.c</a>. -<p> -References <a class="el" href="io_8c-source.html#l00029">_stp_log()</a>, and <a class="el" href="probes_8c-source.html#l00065">_stp_unregister_kprobes()</a>. </td> - </tr> -</table> -<a class="anchor" name="a2" doxytag="probes.c::_stp_unregister_jprobes"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">void _stp_unregister_jprobes </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top">struct jprobe * </td> - <td class="mdname" nowrap> <em>probes</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>int </td> - <td class="mdname" nowrap> <em>num_probes</em></td> - </tr> - <tr> - <td class="md"></td> - <td class="md">) </td> - <td class="md" colspan="2"></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Unregister a group of jprobes. -<p> -<dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>probes</em> </td><td>Pointer to an array of struct jprobe. </td></tr> - <tr><td valign="top"></td><td valign="top"><em>num_probes</em> </td><td>Number of probes in the array. </td></tr> - </table> -</dl> - -<p> -Definition at line <a class="el" href="probes_8c-source.html#l00020">20</a> of file <a class="el" href="probes_8c-source.html">probes.c</a>. -<p> -References <a class="el" href="io_8c-source.html#l00029">_stp_log()</a>. -<p> -Referenced by <a class="el" href="probes_8c-source.html#l00034">_stp_register_jprobes()</a>. </td> - </tr> -</table> -<a class="anchor" name="a4" doxytag="probes.c::_stp_unregister_kprobes"></a><p> -<table class="mdTable" cellpadding="2" cellspacing="0"> - <tr> - <td class="mdRow"> - <table cellpadding="0" cellspacing="0" border="0"> - <tr> - <td class="md" nowrap valign="top">void _stp_unregister_kprobes </td> - <td class="md" valign="top">( </td> - <td class="md" nowrap valign="top">struct kprobe * </td> - <td class="mdname" nowrap> <em>probes</em>, </td> - </tr> - <tr> - <td class="md" nowrap align="right"></td> - <td class="md"></td> - <td class="md" nowrap>int </td> - <td class="mdname" nowrap> <em>num_probes</em></td> - </tr> - <tr> - <td class="md"></td> - <td class="md">) </td> - <td class="md" colspan="2"></td> - </tr> - </table> - </td> - </tr> -</table> -<table cellspacing="5" cellpadding="0" border="0"> - <tr> - <td> - - </td> - <td> - -<p> -Unregister a group of kprobes. -<p> -<dl compact><dt><b>Parameters:</b></dt><dd> - <table border="0" cellspacing="2" cellpadding="0"> - <tr><td valign="top"></td><td valign="top"><em>probes</em> </td><td>Pointer to an array of struct kprobe. </td></tr> - <tr><td valign="top"></td><td valign="top"><em>num_probes</em> </td><td>Number of probes in the array. </td></tr> - </table> -</dl> - -<p> -Definition at line <a class="el" href="probes_8c-source.html#l00065">65</a> of file <a class="el" href="probes_8c-source.html">probes.c</a>. -<p> -References <a class="el" href="io_8c-source.html#l00029">_stp_log()</a>. -<p> -Referenced by <a class="el" href="probes_8c-source.html#l00079">_stp_register_kprobes()</a>. </td> - </tr> -</table> -</body></html> diff --git a/runtime/docs/html/relay-app_8h-source.html b/runtime/docs/html/relay-app_8h-source.html deleted file mode 100644 index 16feefe0..00000000 --- a/runtime/docs/html/relay-app_8h-source.html +++ /dev/null @@ -1,542 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: relay-app.h Source File</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1>relay-app.h</h1><div class="fragment"><pre class="fragment">00001 <span class="comment">/*</span> -00002 <span class="comment"> * relay-app.h - kernel 'library' functions for typical relayfs applications</span> -00003 <span class="comment"> *</span> -00004 <span class="comment"> * This program is free software; you can redistribute it and/or modify</span> -00005 <span class="comment"> * it under the terms of the GNU General Public License as published by</span> -00006 <span class="comment"> * the Free Software Foundation; either version 2 of the License, or</span> -00007 <span class="comment"> * (at your option) any later version.</span> -00008 <span class="comment"> *</span> -00009 <span class="comment"> * This program is distributed in the hope that it will be useful,</span> -00010 <span class="comment"> * but WITHOUT ANY WARRANTY; without even the implied warranty of</span> -00011 <span class="comment"> * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the</span> -00012 <span class="comment"> * GNU General Public License for more details.</span> -00013 <span class="comment"> *</span> -00014 <span class="comment"> * You should have received a copy of the GNU General Public License</span> -00015 <span class="comment"> * along with this program; if not, write to the Free Software</span> -00016 <span class="comment"> * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.</span> -00017 <span class="comment"> *</span> -00018 <span class="comment"> * Copyright (C) IBM Corporation, 2005</span> -00019 <span class="comment"> *</span> -00020 <span class="comment"> * 2005-Feb Created by Tom Zanussi <zanussi@us.ibm.com></span> -00021 <span class="comment"> *</span> -00022 <span class="comment"> * This header file encapsulates the details of channel setup and</span> -00023 <span class="comment"> * teardown and communication between the kernel and user parts of a</span> -00024 <span class="comment"> * typical and common type of relayfs application, which is that</span> -00025 <span class="comment"> * kernel logging is kicked off when a userspace data collection</span> -00026 <span class="comment"> * application starts and stopped when the collection app exits, and</span> -00027 <span class="comment"> * data is automatically logged to disk in-between. Channels are</span> -00028 <span class="comment"> * created when the collection app is started and destroyed when it</span> -00029 <span class="comment"> * exits, not when the kernel module is inserted, so different channel</span> -00030 <span class="comment"> * buffer sizes can be specified for each separate run via</span> -00031 <span class="comment"> * command-line options for instance.</span> -00032 <span class="comment"> *</span> -00033 <span class="comment"> * Writing to the channel is done using 2 macros, relayapp_write() and</span> -00034 <span class="comment"> * _relayapp_write(), which are just wrappers around relay_write() and</span> -00035 <span class="comment"> * _relay_write() but without the channel param. You can safely call</span> -00036 <span class="comment"> * these at any time - if there's no channel yet, they'll just be</span> -00037 <span class="comment"> * ignored.</span> -00038 <span class="comment"> *</span> -00039 <span class="comment"> * To create a relay-app application, do the following:</span> -00040 <span class="comment"> *</span> -00041 <span class="comment"> * In your kernel module:</span> -00042 <span class="comment"> *</span> -00043 <span class="comment"> * - #include "relay-app.h"</span> -00044 <span class="comment"> *</span> -00045 <span class="comment"> * - Call init_relay_app() in your module_init function, with the</span> -00046 <span class="comment"> * names of the directory to create relayfs files in and the base name</span> -00047 <span class="comment"> * of the per-cpu relayfs files e.g. to have /mnt/relay/myapp/cpuXXX</span> -00048 <span class="comment"> * created call init_relay_app("myapp", "cpu", callbacks).</span> -00049 <span class="comment"> *</span> -00050 <span class="comment"> * NOTE: The callbacks are entirely optional - pass NULL if you</span> -00051 <span class="comment"> * don't want to define any. If you want to define some but not</span> -00052 <span class="comment"> * others, just set the ones you want, and ignore or NULL out the</span> -00053 <span class="comment"> * others.</span> -00054 <span class="comment"> *</span> -00055 <span class="comment"> * NOTE: This won't actually create the relayfs files - that will</span> -00056 <span class="comment"> * happen when the userspace application starts (i.e. you can supply</span> -00057 <span class="comment"> * the buffer sizes on the application command-line for each new run</span> -00058 <span class="comment"> * of your program).</span> -00059 <span class="comment"> *</span> -00060 <span class="comment"> * NOTE: If you pass in NULL for the directory name, the relay files</span> -00061 <span class="comment"> * will be created in the root directory of the relayfs filesystem.</span> -00062 <span class="comment"> *</span> -00063 <span class="comment"> * - Call close_relay_app() in your module_exit function - this cleans</span> -00064 <span class="comment"> * up the control channel and the relay files from the previous run,</span> -00065 <span class="comment"> * if any.</span> -00066 <span class="comment"> *</span> -00067 <span class="comment"> * - relay-apps use a control channel to communicate initialization</span> -00068 <span class="comment"> * and status information between the kernel module and user space</span> -00069 <span class="comment"> * program. This is hidden beneath the API so you normally don't need</span> -00070 <span class="comment"> * to know anything about it, but if you want you can also use it to</span> -00071 <span class="comment"> * send user-defined commands from your user space application. To do</span> -00072 <span class="comment"> * this, you need to define a definition for the user_command()</span> -00073 <span class="comment"> * callback and in the callback sort out and handle handle the</span> -00074 <span class="comment"> * commands you send from user space (via send_request()). The</span> -00075 <span class="comment"> * callback must return 1 if the command was handled, or 0 if not</span> -00076 <span class="comment"> * (which will result in a send_error in the user space program,</span> -00077 <span class="comment"> * alerting you to the fact that you're sending something bogus).</span> -00078 <span class="comment"> *</span> -00079 <span class="comment"> * NOTE: Currently commands can only be sent before the user space</span> -00080 <span class="comment"> * application enters relay_app_main_loop() i.e. for initialization</span> -00081 <span class="comment"> * purposes only.</span> -00082 <span class="comment"> *</span> -00083 <span class="comment"> * - the app_started() and app_stopped() callbacks provide an</span> -00084 <span class="comment"> * opportunity for your kernel module to perform app-specific</span> -00085 <span class="comment"> * initialization and cleanup, if desired. They are purely</span> -00086 <span class="comment"> * informational. app_started() is called when the user space</span> -00087 <span class="comment"> * application has started and app_stopped() is called when the user</span> -00088 <span class="comment"> * space application has stopped.</span> -00089 <span class="comment"> *</span> -00090 <span class="comment"> * In your user space application do the following:</span> -00091 <span class="comment"> *</span> -00092 <span class="comment"> * - Call init_relay_app() with the names of the relayfs file base</span> -00093 <span class="comment"> * name and the base filename of the output files that will be</span> -00094 <span class="comment"> * created, as well as the sub-buffer size and count for the current</span> -00095 <span class="comment"> * run (which can be passed in on the command-line if you want). This</span> -00096 <span class="comment"> * will create the channel and set up the ouptut files and buffer</span> -00097 <span class="comment"> * mappings. e.g. to set up reading from the relayfs files specified in the</span> -00098 <span class="comment"> * above example and write them to a set of per-cpu output files named</span> -00099 <span class="comment"> * myoutputXXX:</span> -00100 <span class="comment"> * </span> -00101 <span class="comment"> * init_relay_app("/mnt/relay/myapp/cpu", "myoutput",</span> -00102 <span class="comment"> * subbuf_size_opt, n_subbufs_opt, 1);</span> -00103 <span class="comment"> *</span> -00104 <span class="comment"> * (the last parameter just specifies whether or not to print out a</span> -00105 <span class="comment"> * summary of the number of buffers processed, and the maximum backlog</span> -00106 <span class="comment"> * of sub-buffers encountered e.g. if you have 4 sub-buffers, a</span> -00107 <span class="comment"> * maximum backlog of 3 would mean that you came close to having a</span> -00108 <span class="comment"> * full buffer, so you might want to use more or bigger sub-buffers</span> -00109 <span class="comment"> * next time. Of course, if the buffers actually filled up, the</span> -00110 <span class="comment"> * maximum backlog would be 4 and you'd have lost data).</span> -00111 <span class="comment"> *</span> -00112 <span class="comment"> * - Call relay_app_main_loop(). This will set up an infinite loop</span> -00113 <span class="comment"> * (press Control-C to break out and finalize the data) which</span> -00114 <span class="comment"> * automatically reads the data from the relayfs buffers as it becomes</span> -00115 <span class="comment"> * available and and writes it out to per-cpu output files.</span> -00116 <span class="comment"> *</span> -00117 <span class="comment"> * NOTE: The control channel is implemented as a netlink socket.</span> -00118 <span class="comment"> * relay-app defaults to using NETLINK_USERSOCK for all</span> -00119 <span class="comment"> * applications, which means that you can't have more than 1</span> -00120 <span class="comment"> * relay-app in use at a time, unless you use different netlink</span> -00121 <span class="comment"> * 'units' for each one. If you want to have more than one</span> -00122 <span class="comment"> * relay-app in use at a time, you can specify a different netlink</span> -00123 <span class="comment"> * 'unit' by using the _init_relay_app() versions of the</span> -00124 <span class="comment"> * init_relay_app() functions, on both the kernel and user sides,</span> -00125 <span class="comment"> * which are the same as the init_relay_app() functions but add a</span> -00126 <span class="comment"> * netlink unit param. See netlink.h for the currently unused</span> -00127 <span class="comment"> * numbers.</span> -00128 <span class="comment"> */</span> -00129 -00130 <span class="preprocessor">#include <linux/inet.h></span> -00131 <span class="preprocessor">#include <linux/ip.h></span> -00132 <span class="preprocessor">#include <linux/netlink.h></span> -00133 <span class="preprocessor">#include <linux/relayfs_fs.h></span> -00134 -00135 <span class="comment">/* relay-app pseudo-API */</span> -00136 -00137 <span class="comment">/*</span> -00138 <span class="comment"> * relay-app callbacks</span> -00139 <span class="comment"> */</span> -00140 <span class="keyword">struct </span>relay_app_callbacks -00141 { -00142 <span class="comment">/*</span> -00143 <span class="comment"> * user_command - app-specific command callback</span> -00144 <span class="comment"> * @command: user-defined command id</span> -00145 <span class="comment"> * @data: user-defined data associated with the command</span> -00146 <span class="comment"> *</span> -00147 <span class="comment"> * Return value: 1 if this callback handled it, 0 if not</span> -00148 <span class="comment"> *</span> -00149 <span class="comment"> * define this callback to handle user-defined commands sent</span> -00150 <span class="comment"> * from the user space application via send_request()</span> -00151 <span class="comment"> *</span> -00152 <span class="comment"> * NOTE: user commands must be >= RELAY_APP_USERCMD_START</span> -00153 <span class="comment"> */</span> -00154 int (*user_command) (<span class="keywordtype">int</span> command, <span class="keywordtype">void</span> *data); -00155 -00156 <span class="comment">/*</span> -00157 <span class="comment"> * app_started - the user-space application has started</span> -00158 <span class="comment"> *</span> -00159 <span class="comment"> * Do app-specific initializations now, if desired</span> -00160 <span class="comment"> */</span> -00161 void (*app_started) (void); -00162 -00163 <span class="comment">/*</span> -00164 <span class="comment"> * app_stopped - the user-space application has stopped</span> -00165 <span class="comment"> *</span> -00166 <span class="comment"> * Do app-specific cleanup now, if desired</span> -00167 <span class="comment"> */</span> -00168 void (*app_stopped) (void); -00169 }; -00170 -00171 <span class="comment">/*</span> -00172 <span class="comment"> * relay-app API functions</span> -00173 <span class="comment"> */</span> -00174 <span class="keyword">static</span> <span class="keywordtype">int</span> init_relay_app(<span class="keyword">const</span> <span class="keywordtype">char</span> *dirname, -00175 <span class="keyword">const</span> <span class="keywordtype">char</span> *file_basename, -00176 <span class="keyword">struct</span> relay_app_callbacks *callbacks); -00177 <span class="keyword">static</span> <span class="keywordtype">void</span> close_relay_app(<span class="keywordtype">void</span>); -00178 -00179 <span class="comment">/*</span> -00180 <span class="comment"> * relay-app write wrapper macros - use these instead of directly</span> -00181 <span class="comment"> * using relay_write() and _relay_write() relayfs functions.</span> -00182 <span class="comment"> */</span> -00183 <span class="preprocessor">#define relayapp_write(data, len) \</span> -00184 <span class="preprocessor"> if (app.logging) relay_write(app.chan, data, len)</span> -00185 <span class="preprocessor"></span> -00186 <span class="preprocessor">#define _relayapp_write(data, len) \</span> -00187 <span class="preprocessor"> if (app.logging) _relay_write(app.chan, data, len)</span> -00188 <span class="preprocessor"></span> -00189 <span class="comment">/* relay-app control channel command values */</span> -00190 <span class="keyword">enum</span> -00191 { -00192 RELAY_APP_BUF_INFO = 1, -00193 RELAY_APP_SUBBUFS_CONSUMED, -00194 RELAY_APP_START, -00195 RELAY_APP_STOP, -00196 RELAY_APP_CHAN_CREATE, -00197 RELAY_APP_CHAN_DESTROY, -00198 RELAY_APP_USERCMD_START = 32 -00199 }; -00200 -00201 <span class="comment">/* SystemTap extensions */</span> -00202 <span class="keyword">enum</span> -00203 { -00204 STP_REALTIME_DATA = RELAY_APP_USERCMD_START, -00205 STP_EXIT, -00206 STP_DONE -00207 }; -00208 -00209 <span class="comment">/* internal stuff below here */</span> -00210 -00211 <span class="comment">/* netlink control channel */</span> -00212 <span class="keyword">static</span> <span class="keyword">struct </span>sock *control; -00213 <span class="keyword">static</span> <span class="keywordtype">int</span> seq; -00214 <span class="keyword">static</span> <span class="keywordtype">int</span> stpd_pid = 0; -00215 -00216 <span class="comment">/* info for this application */</span> -00217 <span class="keyword">static</span> <span class="keyword">struct </span>relay_app -00218 { -00219 <span class="keywordtype">char</span> dirname[1024]; -00220 <span class="keywordtype">char</span> file_basename[1024]; -00221 <span class="keyword">struct </span>relay_app_callbacks *cb; -00222 <span class="keyword">struct </span>rchan *chan; -00223 <span class="keyword">struct </span>dentry *dir; -00224 <span class="keywordtype">int</span> logging; -00225 <span class="keywordtype">int</span> mappings; -00226 } app; -00227 -00228 <span class="comment">/*</span> -00229 <span class="comment"> * subbuf_start() relayfs callback.</span> -00230 <span class="comment"> */</span> -00231 <span class="keyword">static</span> <span class="keywordtype">int</span> relay_app_subbuf_start(<span class="keyword">struct</span> rchan_buf *buf, -00232 <span class="keywordtype">void</span> *subbuf, -00233 <span class="keywordtype">unsigned</span> prev_subbuf_idx, -00234 <span class="keywordtype">void</span> *prev_subbuf) -00235 { -00236 <span class="keywordtype">unsigned</span> padding = buf->padding[prev_subbuf_idx]; -00237 <span class="keywordflow">if</span> (prev_subbuf) -00238 *((<span class="keywordtype">unsigned</span> *)prev_subbuf) = padding; -00239 -00240 <span class="keywordflow">return</span> <span class="keyword">sizeof</span>(padding); <span class="comment">/* reserve space for padding */</span> -00241 } -00242 -00243 <span class="comment">/*</span> -00244 <span class="comment"> * buf_full() relayfs callback.</span> -00245 <span class="comment"> */</span> -00246 <span class="keyword">static</span> <span class="keywordtype">void</span> relay_app_buf_full(<span class="keyword">struct</span> rchan_buf *buf, -00247 <span class="keywordtype">unsigned</span> subbuf_idx, -00248 <span class="keywordtype">void</span> *subbuf) -00249 { -00250 <span class="keywordtype">unsigned</span> padding = buf->padding[subbuf_idx]; -00251 *((<span class="keywordtype">unsigned</span> *)subbuf) = padding; -00252 } -00253 -00254 <span class="keyword">static</span> <span class="keywordtype">void</span> relay_app_buf_mapped(<span class="keyword">struct</span> rchan_buf *buf, <span class="keyword">struct</span> file *filp) -00255 { -00256 <span class="keywordflow">if</span> (app.cb && app.cb->app_started && !app.mappings++) -00257 app.cb->app_started(); -00258 } -00259 -00260 static <span class="keywordtype">void</span> relay_app_buf_unmapped(struct rchan_buf *buf, struct file *filp) -00261 { -00262 <span class="keywordflow">if</span> (app.cb && app.cb->app_started && !--app.mappings) -00263 app.cb->app_stopped(); -00264 } -00265 -00266 static struct rchan_callbacks app_rchan_callbacks = -00267 { -00268 .subbuf_start = relay_app_subbuf_start, -00269 .buf_full = relay_app_buf_full, -00270 .buf_mapped = relay_app_buf_mapped, -00271 .buf_unmapped = relay_app_buf_unmapped -00272 }; -00273 <span class="comment"></span> -00274 <span class="comment">/**</span> -00275 <span class="comment"> * create_app_chan - creates channel /mnt/relay/dirname/filebaseXXX</span> -00276 <span class="comment"> *</span> -00277 <span class="comment"> * Returns channel on success, NULL otherwise.</span> -00278 <span class="comment"> */</span> -00279 <span class="keyword">static</span> <span class="keyword">struct </span>rchan *create_app_chan(<span class="keywordtype">unsigned</span> subbuf_size, -00280 <span class="keywordtype">unsigned</span> n_subbufs) -00281 { -00282 <span class="keyword">struct </span>rchan *chan; -00283 -00284 <span class="keywordflow">if</span> (strlen(app.dirname)) { -00285 app.dir = relayfs_create_dir(app.dirname, NULL); -00286 <span class="keywordflow">if</span> (!app.dir) { -00287 printk(<span class="stringliteral">"Couldn't create relayfs app directory %s.\n"</span>, app.dirname); -00288 <span class="keywordflow">return</span> NULL; -00289 } -00290 } -00291 -00292 chan = relay_open(app.file_basename, app.dir, subbuf_size, -00293 n_subbufs, 0, &app_rchan_callbacks); -00294 -00295 <span class="keywordflow">if</span> (!chan) { -00296 printk(<span class="stringliteral">"relay app channel creation failed\n"</span>); -00297 <span class="keywordflow">if</span> (app.dir) -00298 relayfs_remove_dir(app.dir); -00299 return NULL; -00300 } -00301 -00302 return chan; -00303 } -00304 <span class="comment"></span> -00305 <span class="comment">/**</span> -00306 <span class="comment"> * destroy_app_chan - destroys channel /mnt/relay/dirname/filebaseXXX</span> -00307 <span class="comment"> */</span> -00308 static <span class="keywordtype">void</span> destroy_app_chan(struct rchan *chan) -00309 { -00310 <span class="keywordflow">if</span> (chan) -00311 relay_close(chan); -00312 if (app.dir) -00313 relayfs_remove_dir(app.dir); -00314 -00315 app.chan = NULL; -00316 app.dir = NULL; -00317 } -00318 -00319 <span class="comment">/* netlink control channel communication with userspace */</span> -00320 -00321 struct buf_info -00322 { -00323 <span class="keywordtype">int</span> cpu; -00324 <span class="keywordtype">unsigned</span> produced; -00325 <span class="keywordtype">unsigned</span> consumed; -00326 }; -00327 -00328 <span class="keyword">struct </span>consumed_info -00329 { -00330 <span class="keywordtype">int</span> cpu; -00331 <span class="keywordtype">unsigned</span> consumed; -00332 }; -00333 -00334 <span class="keyword">struct </span>channel_create_info -00335 { -00336 <span class="keywordtype">unsigned</span> subbuf_size; -00337 <span class="keywordtype">unsigned</span> n_subbufs; -00338 }; -00339 -00340 <span class="comment">/*</span> -00341 <span class="comment"> * send_reply - send reply to userspace over netlink control channel</span> -00342 <span class="comment"> */</span> -00343 <span class="keyword">static</span> <span class="keywordtype">int</span> send_reply(<span class="keywordtype">int</span> type, <span class="keywordtype">void</span> *reply, <span class="keywordtype">int</span> len, <span class="keywordtype">int</span> pid) -00344 { -00345 <span class="keyword">struct </span>sk_buff *skb; -00346 <span class="keyword">struct </span>nlmsghdr *nlh; -00347 <span class="keywordtype">void</span> *data; -00348 <span class="keywordtype">int</span> size; -00349 <span class="keywordtype">int</span> err; -00350 -00351 size = NLMSG_SPACE(len); -00352 skb = alloc_skb(size, GFP_ATOMIC); -00353 <span class="keywordflow">if</span> (!skb) -00354 return -1; -00355 nlh = NLMSG_PUT(skb, pid, seq++, type, size - sizeof(*nlh)); -00356 nlh->nlmsg_flags = 0; -00357 data = NLMSG_DATA(nlh); -00358 memcpy(data, reply, len); -00359 err = netlink_unicast(control, skb, pid, MSG_DONTWAIT); -00360 -00361 return 0; -00362 -00363 nlmsg_failure: -00364 if (skb) -00365 kfree_skb(skb); -00366 -00367 return -1; -00368 } -00369 -00370 static <span class="keywordtype">void</span> handle_buf_info(struct buf_info *in, <span class="keywordtype">int</span> pid) -00371 { -00372 <span class="keyword">struct </span>buf_info out; -00373 -00374 <span class="keywordflow">if</span> (!app.chan) -00375 return; -00376 -00377 out.cpu = in->cpu; -00378 out.produced = atomic_read(&app.chan->buf[in->cpu]->subbufs_produced); -00379 out.consumed = atomic_read(&app.chan->buf[in->cpu]->subbufs_consumed); -00380 -00381 send_reply(RELAY_APP_BUF_INFO, &out, sizeof(out), pid); -00382 } -00383 -00384 static inline <span class="keywordtype">void</span> handle_subbufs_consumed(struct consumed_info *info) -00385 { -00386 <span class="keywordflow">if</span> (!app.chan) -00387 return; -00388 -00389 relay_subbufs_consumed(app.chan, info->cpu, info->consumed); -00390 } -00391 -00392 static inline <span class="keywordtype">void</span> handle_create(struct channel_create_info *info) -00393 { -00394 destroy_app_chan(app.chan); -00395 app.chan = create_app_chan(info->subbuf_size, info->n_subbufs); -00396 <span class="keywordflow">if</span>(!app.chan) -00397 <span class="keywordflow">return</span>; -00398 app.mappings = 0; -00399 } -00400 -00401 <span class="comment">/*</span> -00402 <span class="comment"> * msg_rcv_skb - dispatch userspace requests from netlink control channel</span> -00403 <span class="comment"> */</span> -00404 <span class="keyword">static</span> <span class="keywordtype">void</span> msg_rcv_skb(<span class="keyword">struct</span> sk_buff *skb) -00405 { -00406 <span class="keyword">struct </span>nlmsghdr *nlh = NULL; -00407 <span class="keywordtype">int</span> pid, flags; -00408 <span class="keywordtype">int</span> nlmsglen, skblen; -00409 <span class="keywordtype">void</span> *data; -00410 -00411 skblen = skb->len; -00412 -00413 <span class="keywordflow">if</span> (skblen < <span class="keyword">sizeof</span> (*nlh)) -00414 return; -00415 -00416 nlh = (struct nlmsghdr *)skb->data; -00417 nlmsglen = nlh->nlmsg_len; -00418 -00419 if (nlmsglen < sizeof(*nlh) || skblen < nlmsglen) -00420 return; -00421 -00422 stpd_pid = pid = nlh->nlmsg_pid; -00423 flags = nlh->nlmsg_flags; -00424 -00425 if (pid <= 0 || !(flags & NLM_F_REQUEST)) { -00426 netlink_ack(skb, nlh, -EINVAL); -00427 <span class="keywordflow">return</span>; -00428 } -00429 -00430 <span class="keywordflow">if</span> (flags & MSG_TRUNC) { -00431 netlink_ack(skb, nlh, -ECOMM); -00432 <span class="keywordflow">return</span>; -00433 } -00434 -00435 data = NLMSG_DATA(nlh); -00436 -00437 <span class="keywordflow">switch</span> (nlh->nlmsg_type) { -00438 <span class="keywordflow">case</span> RELAY_APP_CHAN_CREATE: -00439 handle_create(data); -00440 <span class="keywordflow">break</span>; -00441 <span class="keywordflow">case</span> RELAY_APP_CHAN_DESTROY: -00442 destroy_app_chan(app.chan); -00443 <span class="keywordflow">break</span>; -00444 <span class="keywordflow">case</span> RELAY_APP_START: -00445 app.logging = 1; -00446 <span class="keywordflow">break</span>; -00447 <span class="keywordflow">case</span> RELAY_APP_STOP: -00448 app.logging = 0; -00449 relay_flush(app.chan); -00450 <span class="keywordflow">break</span>; -00451 <span class="keywordflow">case</span> RELAY_APP_BUF_INFO: -00452 handle_buf_info(data, pid); -00453 <span class="keywordflow">break</span>; -00454 <span class="keywordflow">case</span> RELAY_APP_SUBBUFS_CONSUMED: -00455 handle_subbufs_consumed(data); -00456 <span class="keywordflow">break</span>; -00457 <span class="keywordflow">default</span>: -00458 <span class="keywordflow">if</span> (!app.cb || !app.cb->user_command || -00459 !app.cb->user_command(nlh->nlmsg_type, data)) -00460 netlink_ack(skb, nlh, -EINVAL); -00461 <span class="keywordflow">return</span>; -00462 } -00463 -00464 <span class="keywordflow">if</span> (flags & NLM_F_ACK) -00465 netlink_ack(skb, nlh, 0); -00466 } -00467 -00468 <span class="comment">/*</span> -00469 <span class="comment"> * msg_rcv - handle netlink control channel requests</span> -00470 <span class="comment"> */</span> -00471 static <span class="keywordtype">void</span> msg_rcv(struct sock *sk, <span class="keywordtype">int</span> len) -00472 { -00473 <span class="keyword">struct </span>sk_buff *skb; -00474 -00475 <span class="keywordflow">while</span> ((skb = skb_dequeue(&sk->sk_receive_queue))) { -00476 msg_rcv_skb(skb); -00477 kfree_skb(skb); -00478 } -00479 } -00480 -00481 <span class="comment">/*</span> -00482 <span class="comment"> * _init_relay_app - adds netlink 'unit' if other than NETLINK_USERSOCK wanted</span> -00483 <span class="comment"> */</span> -00484 <span class="keyword">static</span> <span class="keywordtype">int</span> _init_relay_app(<span class="keyword">const</span> <span class="keywordtype">char</span> *dirname, -00485 <span class="keyword">const</span> <span class="keywordtype">char</span> *file_basename, -00486 <span class="keyword">struct</span> relay_app_callbacks *callbacks, -00487 <span class="keywordtype">int</span> unit) -00488 { -00489 <span class="keywordflow">if</span> (!file_basename) -00490 return -1; -00491 -00492 if (dirname) -00493 strncpy(app.dirname, dirname, 1024); -00494 strncpy(app.file_basename, file_basename, 1024); -00495 app.cb = callbacks; -00496 -00497 control = netlink_kernel_create(unit, msg_rcv); -00498 if (!control) { -00499 printk(<span class="stringliteral">"Couldn't create control channel\n"</span>); -00500 <span class="keywordflow">return</span> -1; -00501 } -00502 -00503 <span class="keywordflow">return</span> 0; -00504 } -00505 <span class="comment"></span> -00506 <span class="comment">/**</span> -00507 <span class="comment"> * init_relay_app - initialize /mnt/relay/dirname/file_basenameXXX</span> -00508 <span class="comment"> * @dirname: the directory to contain relayfs files for this app</span> -00509 <span class="comment"> * @file_basename: the base filename of the relayfs files for this app</span> -00510 <span class="comment"> * @callbacks: the relay_app_callbacks implemented for this app</span> -00511 <span class="comment"> *</span> -00512 <span class="comment"> * Returns 0 on success, -1 otherwise.</span> -00513 <span class="comment"> *</span> -00514 <span class="comment"> * NOTE: this doesn't create the relayfs files. That happens via the</span> -00515 <span class="comment"> * control channel protocol.</span> -00516 <span class="comment"> */</span> -00517 <span class="keyword">static</span> <span class="keywordtype">int</span> init_relay_app(<span class="keyword">const</span> <span class="keywordtype">char</span> *dirname, -00518 <span class="keyword">const</span> <span class="keywordtype">char</span> *file_basename, -00519 <span class="keyword">struct</span> relay_app_callbacks *callbacks) -00520 { -00521 <span class="keywordflow">return</span> _init_relay_app(dirname, file_basename, callbacks, NETLINK_USERSOCK); -00522 } -00523 <span class="comment"></span> -00524 <span class="comment">/**</span> -00525 <span class="comment"> * close_relay_app - close netlink socket and destroy channel if it exists</span> -00526 <span class="comment"> *</span> -00527 <span class="comment"> * Returns 0 on success, -1 otherwise.</span> -00528 <span class="comment"> */</span> -00529 <span class="keyword">static</span> <span class="keywordtype">void</span> close_relay_app(<span class="keywordtype">void</span>) -00530 { -00531 <span class="keywordflow">if</span> (control) -00532 sock_release(control->sk_socket); -00533 destroy_app_chan(app.chan); -00534 } -</pre></div></body></html> diff --git a/runtime/docs/html/runtime_8h-source.html b/runtime/docs/html/runtime_8h-source.html deleted file mode 100644 index 76c74dec..00000000 --- a/runtime/docs/html/runtime_8h-source.html +++ /dev/null @@ -1,34 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: runtime.h Source File</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1>runtime.h</h1><a href="runtime_8h.html">Go to the documentation of this file.</a><div class="fragment"><pre class="fragment">00001 <span class="preprocessor">#ifndef _RUNTIME_H_</span> -00002 <span class="preprocessor"></span><span class="preprocessor">#define _RUNTIME_H_</span> -00003 <span class="preprocessor"></span><span class="comment">/** @file runtime.h</span> -00004 <span class="comment"> * @brief Main include file for runtime functions.</span> -00005 <span class="comment"> */</span> -00006 -00007 <span class="preprocessor">#include <linux/module.h></span> -00008 <span class="preprocessor">#include <linux/kernel.h></span> -00009 <span class="preprocessor">#include <linux/miscdevice.h></span> -00010 <span class="preprocessor">#include <linux/init.h></span> -00011 <span class="preprocessor">#include <linux/hash.h></span> -00012 <span class="preprocessor">#include <linux/string.h></span> -00013 <span class="preprocessor">#include <linux/kprobes.h></span> -00014 <span class="preprocessor">#include <linux/proc_fs.h></span> -00015 <span class="preprocessor">#include <linux/vmalloc.h></span> -00016 <span class="preprocessor">#include <linux/time.h></span> -00017 <span class="preprocessor">#include <linux/spinlock.h></span> -00018 <span class="preprocessor">#include <linux/hardirq.h></span> -00019 <span class="preprocessor">#include <asm/uaccess.h></span> -00020 <span class="preprocessor">#include <linux/kallsyms.h></span> -00021 -00022 <span class="preprocessor">#define dbug(args...) ;</span> -00023 <span class="preprocessor"></span> -00024 <span class="preprocessor">#include "print.c"</span> -00025 -00026 <span class="preprocessor">#endif </span><span class="comment">/* _RUNTIME_H_ */</span> -</pre></div></body></html> diff --git a/runtime/docs/html/runtime_8h.html b/runtime/docs/html/runtime_8h.html deleted file mode 100644 index a11057b4..00000000 --- a/runtime/docs/html/runtime_8h.html +++ /dev/null @@ -1,39 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: runtime.h File Reference</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1>runtime.h File Reference</h1>Main include file for runtime functions. <a href="#_details">More...</a> -<p> -<code>#include <linux/module.h></code><br> -<code>#include <linux/kernel.h></code><br> -<code>#include <linux/miscdevice.h></code><br> -<code>#include <linux/init.h></code><br> -<code>#include <linux/hash.h></code><br> -<code>#include <linux/string.h></code><br> -<code>#include <linux/kprobes.h></code><br> -<code>#include <linux/proc_fs.h></code><br> -<code>#include <linux/vmalloc.h></code><br> -<code>#include <linux/time.h></code><br> -<code>#include <linux/spinlock.h></code><br> -<code>#include <linux/hardirq.h></code><br> -<code>#include <asm/uaccess.h></code><br> -<code>#include <linux/kallsyms.h></code><br> -<code>#include "print.c"</code><br> - -<p> -<a href="runtime_8h-source.html">Go to the source code of this file.</a><table border="0" cellpadding="0" cellspacing="0"> -<tr><td></td></tr> -<tr><td colspan="2"><br><h2>Defines</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="a0" doxytag="runtime.h::dbug"></a> -#define </td><td class="memItemRight" valign="bottom"><b>dbug</b>(args...) ;</td></tr> - -</table> -<hr><a name="_details"></a><h2>Detailed Description</h2> -Main include file for runtime functions. -<p> - -<p> -Definition in file <a class="el" href="runtime_8h-source.html">runtime.h</a>.</body></html> diff --git a/runtime/docs/html/shellsnoop_2dtr_8c-source.html b/runtime/docs/html/shellsnoop_2dtr_8c-source.html deleted file mode 100644 index bbc55f7e..00000000 --- a/runtime/docs/html/shellsnoop_2dtr_8c-source.html +++ /dev/null @@ -1,148 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: probes/shellsnoop/dtr.c Source File</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<div class="nav"> -<a class="el" href="dir_000000.html">probes</a> / <a class="el" href="dir_000001.html">shellsnoop</a></div> -<h1>dtr.c</h1><div class="fragment"><pre class="fragment">00001 <span class="preprocessor">#define HASH_TABLE_BITS 8</span> -00002 <span class="preprocessor"></span><span class="preprocessor">#define HASH_TABLE_SIZE (1<<HASH_TABLE_BITS)</span> -00003 <span class="preprocessor"></span><span class="preprocessor">#define BUCKETS 16 </span><span class="comment">/* largest histogram width */</span> -00004 -00005 <span class="preprocessor">#define STP_NETLINK_ONLY</span> -00006 <span class="preprocessor"></span><span class="preprocessor">#define STP_NUM_STRINGS 1</span> -00007 <span class="preprocessor"></span> -00008 <span class="preprocessor">#include "<a class="code" href="runtime_8h.html">runtime.h</a>"</span> -00009 <span class="preprocessor">#include "<a class="code" href="map_8c.html">map.c</a>"</span> -00010 <span class="preprocessor">#include "<a class="code" href="copy_8c.html">copy.c</a>"</span> -00011 <span class="preprocessor">#include "<a class="code" href="probes_8c.html">probes.c</a>"</span> -00012 -00013 MODULE_DESCRIPTION(<span class="stringliteral">"SystemTap probe: shellsnoop"</span>); -00014 MODULE_AUTHOR(<span class="stringliteral">"Martin Hunt <hunt@redhat.com>"</span>); -00015 -00016 <a class="code" href="group__maps.html#ga1">MAP</a> pids, arglist ; -00017 -00018 <span class="keywordtype">int</span> inst_do_execve (<span class="keywordtype">char</span> * filename, <span class="keywordtype">char</span> __user *__user *argv, <span class="keywordtype">char</span> __user *__user *envp, <span class="keyword">struct</span> pt_regs * regs) -00019 { -00020 <span class="keyword">struct </span>map_node_str *ptr; -00021 -00022 <span class="comment">/* watch shells only */</span> -00023 <span class="comment">/* FIXME: detect more shells, like csh, tcsh, zsh */</span> -00024 -00025 <span class="keywordflow">if</span> (!strcmp(current->comm,<span class="stringliteral">"bash"</span>) || !strcmp(current->comm,<span class="stringliteral">"sh"</span>) || !strcmp(current->comm, <span class="stringliteral">"zsh"</span>) -00026 || !strcmp(current->comm, <span class="stringliteral">"tcsh"</span>) || !strcmp(current->comm, <span class="stringliteral">"pdksh"</span>)) -00027 { -00028 <a class="code" href="group__print.html#ga3">_stp_printf</a> (<span class="stringliteral">"%d\t%d\t%d\t%s "</span>, current->uid, current->pid, current->parent->pid, filename); -00029 -00030 <a class="code" href="group__maps.html#ga13">_stp_map_key_long</a> (pids, current->pid); -00031 <a class="code" href="group__maps.html#ga16">_stp_map_set_int64</a> (pids, 1); -00032 -00033 <a class="code" href="group__lists.html#ga1">_stp_list_clear</a> (arglist); -00034 <a class="code" href="group__copy.html#ga3">_stp_copy_argv_from_user</a> (arglist, argv); -00035 -00036 <a class="code" href="group__maps.html#ga32">foreach</a> (arglist, ptr) -00037 _stp_printf ("%s ", ptr->str); -00038 -00039 _stp_print_flush(); -00040 } -00041 jprobe_return(); -00042 return 0; -00043 } -00044 -00045 struct file * inst_filp_open (const <span class="keywordtype">char</span> * filename, <span class="keywordtype">int</span> flags, <span class="keywordtype">int</span> mode) -00046 { -00047 <a class="code" href="group__maps.html#ga13">_stp_map_key_long</a> (pids, current->pid); -00048 <span class="keywordflow">if</span> (_stp_map_get_int64 (pids)) -00049 <a class="code" href="group__print.html#ga3">_stp_printf</a> (<span class="stringliteral">"%d\t%d\t%s\tO %s"</span>, current->pid, current->parent->pid, current->comm, filename); -00050 -00051 <a class="code" href="group__print.html#ga2">_stp_print_flush</a>(); -00052 jprobe_return(); -00053 <span class="keywordflow">return</span> 0; -00054 } -00055 -00056 asmlinkage ssize_t inst_sys_read (<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> fd, <span class="keywordtype">char</span> __user * buf, size_t count) -00057 { -00058 <a class="code" href="group__maps.html#ga13">_stp_map_key_long</a> (pids, current->pid); -00059 <span class="keywordflow">if</span> (_stp_map_get_int64 (pids)) -00060 <a class="code" href="group__print.html#ga3">_stp_printf</a> (<span class="stringliteral">"%d\t%d\t%s\tR %d"</span>, current->pid, current->parent->pid, current->comm, fd); -00061 -00062 <a class="code" href="group__print.html#ga2">_stp_print_flush</a>(); -00063 jprobe_return(); -00064 <span class="keywordflow">return</span> 0; -00065 } -00066 -00067 asmlinkage ssize_t inst_sys_write (<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> fd, <span class="keyword">const</span> <span class="keywordtype">char</span> __user * buf, size_t count) -00068 { -00069 <a class="code" href="group__maps.html#ga13">_stp_map_key_long</a> (pids, current->pid); -00070 <span class="keywordflow">if</span> (_stp_map_get_int64 (pids)) -00071 { -00072 String str = <a class="code" href="group__string.html#ga2">_stp_string_init</a> (0); -00073 <a class="code" href="group__copy.html#ga1">_stp_string_from_user</a>(str, buf, count); -00074 <a class="code" href="group__print.html#ga3">_stp_printf</a> (<span class="stringliteral">"%d\t%d\t%s\tW %s"</span>, current->pid, current->parent->pid, current->comm, str->buf); -00075 <a class="code" href="group__print.html#ga2">_stp_print_flush</a>(); -00076 } -00077 -00078 jprobe_return(); -00079 <span class="keywordflow">return</span> 0; -00080 } -00081 -00082 <span class="keyword">static</span> <span class="keyword">struct </span>jprobe dtr_probes[] = { -00083 { -00084 .kp.addr = (kprobe_opcode_t *)<span class="stringliteral">"do_execve"</span>, -00085 .entry = (kprobe_opcode_t *) inst_do_execve -00086 }, -00087 { -00088 .kp.addr = (kprobe_opcode_t *)<span class="stringliteral">"filp_open"</span>, -00089 .entry = (kprobe_opcode_t *) inst_filp_open -00090 }, -00091 { -00092 .kp.addr = (kprobe_opcode_t *)<span class="stringliteral">"sys_read"</span>, -00093 .entry = (kprobe_opcode_t *) inst_sys_read -00094 }, -00095 { -00096 .kp.addr = (kprobe_opcode_t *)<span class="stringliteral">"sys_write"</span>, -00097 .entry = (kprobe_opcode_t *) inst_sys_write -00098 }, -00099 }; -00100 -00101 <span class="preprocessor">#define MAX_DTR_ROUTINE (sizeof(dtr_probes)/sizeof(struct jprobe))</span> -00102 <span class="preprocessor"></span> -00103 <span class="keyword">static</span> <span class="keywordtype">int</span> init_dtr(<span class="keywordtype">void</span>) -00104 { -00105 <span class="keywordtype">int</span> ret; -00106 -00107 <span class="keywordflow">if</span> (<a class="code" href="group__io.html#ga7">_stp_netlink_open</a>() < 0) -00108 return -1; -00109 -00110 pids = _stp_map_new (10000, INT64); -00111 arglist = _stp_list_new (10, STRING); -00112 -00113 ret = _stp_register_jprobes (dtr_probes, MAX_DTR_ROUTINE); -00114 -00115 _stp_log("instrumentation is enabled... %s\n", __this_module.name); -00116 return ret; -00117 } -00118 -00119 static <span class="keywordtype">void</span> probe_exit (<span class="keywordtype">void</span>) -00120 { -00121 <a class="code" href="probes_8c.html#a2">_stp_unregister_jprobes</a> (dtr_probes, MAX_DTR_ROUTINE); -00122 -00123 <a class="code" href="group__print.html#ga11">_stp_print</a> (<span class="stringliteral">"In probe_exit now."</span>); -00124 <a class="code" href="group__maps.html#ga7">_stp_map_del</a> (pids); -00125 <a class="code" href="group__print.html#ga2">_stp_print_flush</a>(); -00126 } -00127 -00128 -00129 <span class="keyword">static</span> <span class="keywordtype">void</span> cleanup_dtr(<span class="keywordtype">void</span>) -00130 { -00131 <a class="code" href="group__io.html#ga8">_stp_netlink_close</a>(); -00132 -00133 } -00134 -00135 module_init(init_dtr); -00136 module_exit(cleanup_dtr); -00137 MODULE_LICENSE(<span class="stringliteral">"GPL"</span>); -00138 -</pre></div></body></html> diff --git a/runtime/docs/html/stack_8c-source.html b/runtime/docs/html/stack_8c-source.html deleted file mode 100644 index eda90dc4..00000000 --- a/runtime/docs/html/stack_8c-source.html +++ /dev/null @@ -1,188 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: stack.c Source File</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1>stack.c</h1><a href="stack_8c.html">Go to the documentation of this file.</a><div class="fragment"><pre class="fragment">00001 <span class="preprocessor">#ifndef _STACK_C_ </span><span class="comment">/* -*- linux-c -*- */</span> -00002 <span class="preprocessor">#define _STACK_C_</span> -00003 <span class="preprocessor"></span> -00004 <span class="comment"></span> -00005 <span class="comment">/** @file stack.c</span> -00006 <span class="comment"> * @brief Stack Tracing Functions</span> -00007 <span class="comment"> */</span> -00008 <span class="comment"></span> -00009 <span class="comment">/** @addtogroup stack Stack Tracing Functions</span> -00010 <span class="comment"> * @{</span> -00011 <span class="comment"> */</span> -00012 -00013 <span class="preprocessor">#include "sym.c"</span> -00014 -00015 <span class="keyword">static</span> int (*_stp_kta)(<span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> addr)=(<span class="keywordtype">void</span> *)KTA; -00016 -00017 <span class="preprocessor">#ifdef __x86_64__</span> -00018 <span class="preprocessor"></span><span class="keyword">static</span> <span class="keywordtype">void</span> __stp_stack_print (<span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> *stack, <span class="keywordtype">int</span> verbose, <span class="keywordtype">int</span> levels) -00019 { -00020 <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> addr; -00021 -00022 <span class="keywordflow">if</span> (verbose) -00023 _stp_printf ("trace for %d (%s)\n", current->pid, current->comm); -00024 -00025 while (((<span class="keywordtype">long</span>) stack & (THREAD_SIZE-1)) != 0) { -00026 addr = *stack++; -00027 <span class="keywordflow">if</span> (_stp_kta(addr)) { -00028 <span class="keywordflow">if</span> (verbose) { -00029 <a class="code" href="group__sym.html#ga2">_stp_symbol_print</a> (addr); -00030 <a class="code" href="group__print.html#ga11">_stp_print</a> (<span class="stringliteral">"\n"</span>); -00031 } <span class="keywordflow">else</span> -00032 <a class="code" href="group__print.html#ga3">_stp_printf</a> (<span class="stringliteral">"0x%lx "</span>, addr); -00033 } -00034 } -00035 <a class="code" href="group__print.html#ga2">_stp_print_flush</a>(); -00036 } -00037 -00038 -00039 <span class="keyword">static</span> <span class="keywordtype">void</span> __stp_stack_sprint (String str, <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> *stack, <span class="keywordtype">int</span> verbose, <span class="keywordtype">int</span> levels) -00040 { -00041 <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> addr; -00042 <span class="keywordflow">while</span> (((<span class="keywordtype">long</span>) stack & (THREAD_SIZE-1)) != 0) { -00043 addr = *stack++; -00044 <span class="keywordflow">if</span> (_stp_kta(addr)) { -00045 <span class="keywordflow">if</span> (verbose) -00046 _stp_symbol_sprint (str, addr); -00047 else -00048 _stp_sprintf (str, "0x%lx ", addr); -00049 } -00050 } -00051 } -00052 -00053 #else <span class="comment">/* i386 */</span> -00054 -00055 static inline <span class="keywordtype">int</span> valid_stack_ptr (struct thread_info *tinfo, <span class="keywordtype">void</span> *p) -00056 { -00057 <span class="keywordflow">return</span> p > (<span class="keywordtype">void</span> *)tinfo && -00058 p < (<span class="keywordtype">void</span> *)tinfo + THREAD_SIZE - 3; -00059 } -00060 -00061 <span class="keyword">static</span> <span class="keyword">inline</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> _stp_print_context_stack ( -00062 <span class="keyword">struct</span> thread_info *tinfo, -00063 <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> *stack, -00064 <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> ebp ) -00065 { -00066 <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> addr; -00067 -00068 <span class="preprocessor">#ifdef CONFIG_FRAME_POINTER</span> -00069 <span class="preprocessor"></span> <span class="keywordflow">while</span> (valid_stack_ptr(tinfo, (<span class="keywordtype">void</span> *)ebp)) { -00070 addr = *(<span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> *)(ebp + 4); -00071 <a class="code" href="group__sym.html#ga2">_stp_symbol_print</a> (addr); -00072 <a class="code" href="group__print.html#ga5">_stp_print_cstr</a>(<span class="stringliteral">"\n"</span>); -00073 ebp = *(<span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> *)ebp; -00074 } -00075 <span class="preprocessor">#else</span> -00076 <span class="preprocessor"></span> <span class="keywordflow">while</span> (valid_stack_ptr(tinfo, stack)) { -00077 addr = *stack++; -00078 <span class="keywordflow">if</span> (_stp_kta (addr)) { -00079 <a class="code" href="group__sym.html#ga2">_stp_symbol_print</a> (addr); -00080 <a class="code" href="group__print.html#ga5">_stp_print_cstr</a> (<span class="stringliteral">"\n"</span>); -00081 } -00082 } -00083 <span class="preprocessor">#endif</span> -00084 <span class="preprocessor"></span> <a class="code" href="group__print.html#ga2">_stp_print_flush</a>(); -00085 <span class="keywordflow">return</span> ebp; -00086 } -00087 -00088 <span class="keyword">static</span> <span class="keyword">inline</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> _stp_sprint_context_stack ( -00089 String str, -00090 <span class="keyword">struct</span> thread_info *tinfo, -00091 <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> *stack, -00092 <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> ebp ) -00093 { -00094 <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> addr; -00095 -00096 <span class="preprocessor">#ifdef CONFIG_FRAME_POINTER</span> -00097 <span class="preprocessor"></span> <span class="keywordflow">while</span> (valid_stack_ptr(tinfo, (<span class="keywordtype">void</span> *)ebp)) { -00098 addr = *(<span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> *)(ebp + 4); -00099 <a class="code" href="group__sym.html#ga1">_stp_symbol_sprint</a> (str, addr); -00100 <a class="code" href="group__string.html#ga9">_stp_string_cat</a> (<span class="stringliteral">"\n"</span>); -00101 ebp = *(<span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> *)ebp; -00102 } -00103 <span class="preprocessor">#else</span> -00104 <span class="preprocessor"></span> <span class="keywordflow">while</span> (valid_stack_ptr(tinfo, stack)) { -00105 addr = *stack++; -00106 <span class="keywordflow">if</span> (_stp_kta (addr)) { -00107 <a class="code" href="group__sym.html#ga1">_stp_symbol_sprint</a> (addr); -00108 <a class="code" href="group__string.html#ga9">_stp_string_cat</a> (<span class="stringliteral">"\n"</span>); -00109 } -00110 } -00111 <span class="preprocessor">#endif</span> -00112 <span class="preprocessor"></span> <span class="keywordflow">return</span> ebp; -00113 } -00114 -00115 <span class="keyword">static</span> <span class="keywordtype">void</span> __stp_stack_print (<span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> *stack, <span class="keywordtype">int</span> verbose, <span class="keywordtype">int</span> levels) -00116 { -00117 <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> ebp; -00118 -00119 <span class="comment">/* Grab ebp right from our regs */</span> -00120 <span class="keyword">asm</span> (<span class="stringliteral">"movl %%ebp, %0"</span> : <span class="stringliteral">"=r"</span> (ebp) : ); -00121 -00122 <span class="keywordflow">while</span> (stack) { -00123 <span class="keyword">struct </span>thread_info *context = (<span class="keyword">struct </span>thread_info *) -00124 ((<span class="keywordtype">unsigned</span> long)stack & (~(THREAD_SIZE - 1))); -00125 ebp = _stp_print_context_stack (context, stack, ebp); -00126 stack = (<span class="keywordtype">unsigned</span> <span class="keywordtype">long</span>*)context->previous_esp; -00127 } -00128 } -00129 -00130 <span class="keyword">static</span> <span class="keywordtype">void</span> __stp_stack_sprint (String str, <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> *stack, <span class="keywordtype">int</span> verbose, <span class="keywordtype">int</span> levels) -00131 { -00132 <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> ebp; -00133 -00134 <span class="comment">/* Grab ebp right from our regs */</span> -00135 <span class="keyword">asm</span> (<span class="stringliteral">"movl %%ebp, %0"</span> : <span class="stringliteral">"=r"</span> (ebp) : ); -00136 -00137 <span class="keywordflow">while</span> (stack) { -00138 <span class="keyword">struct </span>thread_info *context = (<span class="keyword">struct </span>thread_info *) -00139 ((<span class="keywordtype">unsigned</span> long)stack & (~(THREAD_SIZE - 1))); -00140 ebp = _stp_sprint_context_stack (str, context, stack, ebp); -00141 stack = (<span class="keywordtype">unsigned</span> <span class="keywordtype">long</span>*)context->previous_esp; -00142 } -00143 } -00144 -00145 <span class="preprocessor">#endif </span><span class="comment">/* i386 */</span> -00146 <span class="comment"></span> -00147 <span class="comment">/** Print stack dump.</span> -00148 <span class="comment"> * Prints a stack dump to the print buffer.</span> -00149 <span class="comment"> * @param verbose Verbosity</span> -00150 <span class="comment"> * @param levels Number of levels to trace.</span> -00151 <span class="comment"> * @todo Implement verbosity and levels parameters.</span> -00152 <span class="comment"> * @bug levels parameter is not functional</span> -00153 <span class="comment"> */</span> -00154 -<a name="l00155"></a><a class="code" href="group__stack.html#ga6">00155</a> <span class="keywordtype">void</span> <a class="code" href="group__stack.html#ga6">_stp_stack_print</a> (<span class="keywordtype">int</span> verbose, <span class="keywordtype">int</span> levels) -00156 { -00157 <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> stack; -00158 __stp_stack_print (&stack, verbose, levels); -00159 } -00160 <span class="comment"></span> -00161 <span class="comment">/** Writes stack dump to a String</span> -00162 <span class="comment"> *</span> -00163 <span class="comment"> * @param str String</span> -00164 <span class="comment"> * @param verbose Verbosity</span> -00165 <span class="comment"> * @param levels Number of levels to trace.</span> -00166 <span class="comment"> * @returns Same String as was input.</span> -00167 <span class="comment"> * @todo Implement verbosity and levels parameters.</span> -00168 <span class="comment"> * @bug levels parameter is not functional</span> -00169 <span class="comment"> */</span> -00170 -<a name="l00171"></a><a class="code" href="group__stack.html#ga7">00171</a> String <a class="code" href="group__stack.html#ga7">_stp_stack_sprint</a> (String str, <span class="keywordtype">int</span> verbose, <span class="keywordtype">int</span> levels) -00172 { -00173 <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> stack; -00174 __stp_stack_sprint (str, &stack, verbose, levels); -00175 <a class="code" href="group__io.html#ga2">_stp_log</a> (<span class="stringliteral">"sss: str=%s\n"</span>, str->buf); -00176 <span class="keywordflow">return</span> str; -00177 } -00178 <span class="comment"></span> -00179 <span class="comment">/** @} */</span> -00180 <span class="preprocessor">#endif </span><span class="comment">/* _STACK_C_ */</span> -</pre></div></body></html> diff --git a/runtime/docs/html/stack_8c.html b/runtime/docs/html/stack_8c.html deleted file mode 100644 index 4c769ce8..00000000 --- a/runtime/docs/html/stack_8c.html +++ /dev/null @@ -1,28 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: stack.c File Reference</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1>stack.c File Reference</h1>Stack Tracing Functions. <a href="#_details">More...</a> -<p> -<code>#include "sym.c"</code><br> - -<p> -<a href="stack_8c-source.html">Go to the source code of this file.</a><table border="0" cellpadding="0" cellspacing="0"> -<tr><td></td></tr> -<tr><td colspan="2"><br><h2>Functions</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__stack.html#ga6">_stp_stack_print</a> (int verbose, int levels)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Print stack dump. <a href="group__stack.html#ga6"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">String </td><td class="memItemRight" valign="bottom"><a class="el" href="group__stack.html#ga7">_stp_stack_sprint</a> (String str, int verbose, int levels)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Writes stack dump to a String. <a href="group__stack.html#ga7"></a><br></td></tr> -</table> -<hr><a name="_details"></a><h2>Detailed Description</h2> -Stack Tracing Functions. -<p> - -<p> -Definition in file <a class="el" href="stack_8c-source.html">stack.c</a>.</body></html> diff --git a/runtime/docs/html/stp__tasklet_8c-source.html b/runtime/docs/html/stp__tasklet_8c-source.html deleted file mode 100644 index 16fdfdf7..00000000 --- a/runtime/docs/html/stp__tasklet_8c-source.html +++ /dev/null @@ -1,69 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: probes/tasklet/stp_tasklet.c Source File</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<div class="nav"> -<a class="el" href="dir_000000.html">probes</a> / <a class="el" href="dir_000002.html">tasklet</a></div> -<h1>stp_tasklet.c</h1><div class="fragment"><pre class="fragment">00001 <span class="comment">/* Framework for putting a jprobe in a tasklet. */</span> -00002 <span class="comment">/* Useful for testing probes in interrupt context. */</span> -00003 <span class="comment">/* Doesn't do anything useful as is. Put test code in the inst func */</span> -00004 -00005 <span class="preprocessor">#define HASH_TABLE_BITS 8</span> -00006 <span class="preprocessor"></span><span class="preprocessor">#define HASH_TABLE_SIZE (1<<HASH_TABLE_BITS)</span> -00007 <span class="preprocessor"></span><span class="preprocessor">#define BUCKETS 16 </span><span class="comment">/* largest histogram width */</span> -00008 -00009 <span class="preprocessor">#define STP_NETLINK_ONLY</span> -00010 <span class="preprocessor"></span><span class="preprocessor">#define STP_NUM_STRINGS 1</span> -00011 <span class="preprocessor"></span> -00012 <span class="preprocessor">#include "<a class="code" href="runtime_8h.html">runtime.h</a>"</span> -00013 <span class="preprocessor">#include "<a class="code" href="probes_8c.html">probes.c</a>"</span> -00014 -00015 MODULE_DESCRIPTION(<span class="stringliteral">"test jprobes of tasklets"</span>); -00016 MODULE_AUTHOR(<span class="stringliteral">"Martin Hunt <hunt@redhat.com>"</span>); -00017 -00018 <span class="keywordtype">void</span> inst__rcu_process_callbacks(<span class="keyword">struct</span> rcu_ctrlblk *rcp, -00019 <span class="keyword">struct</span> rcu_state *rsp, <span class="keyword">struct</span> rcu_data *rdp) -00020 { -00021 <a class="code" href="group__io.html#ga2">_stp_log</a> (<span class="stringliteral">"interrupt=%d\n"</span>, in_interrupt()); -00022 jprobe_return(); -00023 } -00024 -00025 <span class="keyword">static</span> <span class="keyword">struct </span>jprobe stp_probes[] = { -00026 { -00027 .kp.addr = (kprobe_opcode_t *)<span class="stringliteral">"__rcu_process_callbacks"</span>, -00028 .entry = (kprobe_opcode_t *) inst__rcu_process_callbacks -00029 }, -00030 }; -00031 <span class="preprocessor">#define MAX_STP_PROBES (sizeof(stp_probes)/sizeof(struct jprobe))</span> -00032 <span class="preprocessor"></span> -00033 -00034 <span class="keyword">static</span> <span class="keywordtype">int</span> init_stp(<span class="keywordtype">void</span>) -00035 { -00036 <span class="keywordtype">int</span> ret; -00037 -00038 <span class="keywordflow">if</span> (<a class="code" href="group__io.html#ga7">_stp_netlink_open</a>() < 0) -00039 return -1; -00040 ret = _stp_register_jprobes (stp_probes, MAX_STP_PROBES); -00041 _stp_log ("instrumentation is enabled...\n"); -00042 return ret; -00043 } -00044 -00045 static <span class="keywordtype">void</span> probe_exit (<span class="keywordtype">void</span>) -00046 { -00047 <a class="code" href="probes_8c.html#a2">_stp_unregister_jprobes</a> (stp_probes, MAX_STP_PROBES); -00048 <a class="code" href="group__io.html#ga2">_stp_log</a> (<span class="stringliteral">"EXIT\n"</span>); -00049 -00050 } -00051 <span class="keyword">static</span> <span class="keywordtype">void</span> cleanup_stp(<span class="keywordtype">void</span>) -00052 { -00053 <a class="code" href="group__io.html#ga8">_stp_netlink_close</a>(); -00054 } -00055 -00056 module_init(init_stp); -00057 module_exit(cleanup_stp); -00058 MODULE_LICENSE(<span class="stringliteral">"GPL"</span>); -00059 -</pre></div></body></html> diff --git a/runtime/docs/html/string_8c-source.html b/runtime/docs/html/string_8c-source.html deleted file mode 100644 index 462913e3..00000000 --- a/runtime/docs/html/string_8c-source.html +++ /dev/null @@ -1,170 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: string.c Source File</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1>string.c</h1><a href="string_8c.html">Go to the documentation of this file.</a><div class="fragment"><pre class="fragment">00001 <span class="preprocessor">#ifndef _STRING_C_ </span><span class="comment">/* -*- linux-c -*- */</span> -00002 <span class="preprocessor">#define _STRING_C_</span> -00003 <span class="preprocessor"></span> -00004 <span class="preprocessor">#include <linux/config.h></span> -00005 <span class="comment"></span> -00006 <span class="comment">/** @file string.c</span> -00007 <span class="comment"> * @brief Implements String type.</span> -00008 <span class="comment"> */</span><span class="comment"></span> -00009 <span class="comment">/** @addtogroup string String Functions</span> -00010 <span class="comment"> *</span> -00011 <span class="comment"> * One of the biggest restrictions the library has is that it cannot allocate things like strings off the stack.</span> -00012 <span class="comment"> * It is also not a good idea to dynamically allocate space for strings with kmalloc(). That leaves us with </span> -00013 <span class="comment"> * statically allocated space for strings. This is what is implemented in the String module. Strings use</span> -00014 <span class="comment"> * preallocated per-cpu buffers and are safe to use (unlike C strings).</span> -00015 <span class="comment"> * @{</span> -00016 <span class="comment"> */</span> -00017 <span class="comment"></span> -00018 <span class="comment">/** Maximum string size allowed in Strings */</span> -00019 <span class="preprocessor">#ifndef STP_STRING_SIZE</span> -<a name="l00020"></a><a class="code" href="group__string.html#ga8">00020</a> <span class="preprocessor"></span><span class="preprocessor">#define STP_STRING_SIZE 2048</span> -00021 <span class="preprocessor"></span><span class="preprocessor">#endif</span> -00022 <span class="preprocessor"></span> -00023 <span class="keyword">struct </span>string { -00024 <span class="keywordtype">short</span> len; -00025 <span class="keywordtype">short</span> global; -00026 <span class="keywordtype">char</span> buf[<a class="code" href="group__string.html#ga8">STP_STRING_SIZE</a>]; -00027 }; -00028 -00029 <span class="keyword">static</span> <span class="keyword">struct </span>string _stp_string[STP_NUM_STRINGS][NR_CPUS]; -00030 -00031 <span class="keyword">typedef</span> <span class="keyword">struct </span>string *String; -00032 <span class="comment"></span> -00033 <span class="comment">/** Initialize a String for our use.</span> -00034 <span class="comment"> * This grabs one of the global Strings for our use.</span> -00035 <span class="comment"> *</span> -00036 <span class="comment"> * @param num Number of the preallocated String to use. </span> -00037 <span class="comment"> * #STP_NUM_STRINGS are statically allocated for our use. The</span> -00038 <span class="comment"> * translator (or author) should be sure to grab a free one.</span> -00039 <span class="comment"> * @todo Global (and static) Strings not implemented yet. </span> -00040 <span class="comment"> */</span> -00041 -<a name="l00042"></a><a class="code" href="group__string.html#ga2">00042</a> String <a class="code" href="group__string.html#ga2">_stp_string_init</a> (<span class="keywordtype">int</span> num) -00043 { -00044 <span class="keywordtype">int</span> global = 0; -00045 String str; -00046 -00047 <span class="keywordflow">if</span> (num < 0) { -00048 num = -num; -00049 global = 1; -00050 } -00051 -00052 <span class="keywordflow">if</span> (num >= STP_NUM_STRINGS) { -00053 <a class="code" href="group__io.html#ga2">_stp_log</a> (<span class="stringliteral">"_stp_string_init internal error: requested string exceeded allocated number"</span>); -00054 <span class="keywordflow">return</span> NULL; -00055 } -00056 -00057 <span class="keywordflow">if</span> (global) -00058 str = &_stp_string[num][0]; -00059 <span class="keywordflow">else</span> -00060 str = &_stp_string[num][smp_processor_id()]; -00061 -00062 str->global = global; -00063 str->len = 0; -00064 <span class="keywordflow">return</span> str; -00065 } -00066 -00067 <span class="comment"></span> -00068 <span class="comment">/** Sprintf into a String.</span> -00069 <span class="comment"> * Like printf, except output goes into a String.</span> -00070 <span class="comment"> * Safe because overflowing the buffer is not allowed.</span> -00071 <span class="comment"> * Size is limited by length of String, #STP_STRING_SIZE.</span> -00072 <span class="comment"> *</span> -00073 <span class="comment"> * @param str String</span> -00074 <span class="comment"> * @param fmt A printf-style format string followed by a </span> -00075 <span class="comment"> * variable number of args.</span> -00076 <span class="comment"> */</span> -<a name="l00077"></a><a class="code" href="group__string.html#ga3">00077</a> <span class="keywordtype">void</span> <a class="code" href="group__string.html#ga3">_stp_sprintf</a> (String str, <span class="keyword">const</span> <span class="keywordtype">char</span> *fmt, ...) -00078 { -00079 <span class="keywordtype">int</span> num; -00080 va_list args; -00081 va_start(args, fmt); -00082 num = vscnprintf(str->buf + str->len, <a class="code" href="group__string.html#ga8">STP_STRING_SIZE</a> - str->len - 1, fmt, args); -00083 va_end(args); -00084 <span class="keywordflow">if</span> (num > 0) -00085 str->len += num; -00086 } -00087 <span class="comment"></span> -00088 <span class="comment">/** Vsprintf into a String</span> -00089 <span class="comment"> * Use this if your function already has a va_list.</span> -00090 <span class="comment"> * You probably want _stp_sprintf().</span> -00091 <span class="comment"> */</span> -<a name="l00092"></a><a class="code" href="group__string.html#ga4">00092</a> <span class="keywordtype">void</span> <a class="code" href="group__string.html#ga4">_stp_vsprintf</a> (String str, <span class="keyword">const</span> <span class="keywordtype">char</span> *fmt, va_list args) -00093 { -00094 <span class="keywordtype">int</span> num; -00095 num = vscnprintf(str->buf + str->len, <a class="code" href="group__string.html#ga8">STP_STRING_SIZE</a> - str->len - 1, fmt, args); -00096 <span class="keywordflow">if</span> (num > 0) -00097 str->len += num; -00098 } -00099 <span class="comment"></span> -00100 <span class="comment">/** ConCATenate (append) a C string to a String.</span> -00101 <span class="comment"> * Like strcat().</span> -00102 <span class="comment"> * @param str1 String</span> -00103 <span class="comment"> * @param str2 C string (char *)</span> -00104 <span class="comment"> * @sa _stp_string_cat</span> -00105 <span class="comment"> */</span> -<a name="l00106"></a><a class="code" href="group__string.html#ga5">00106</a> <span class="keywordtype">void</span> <a class="code" href="group__string.html#ga5">_stp_string_cat_cstr</a> (String str1, <span class="keyword">const</span> <span class="keywordtype">char</span> *str2) -00107 { -00108 <span class="keywordtype">int</span> num = strlen (str2); -00109 <span class="keywordflow">if</span> (num > <a class="code" href="group__string.html#ga8">STP_STRING_SIZE</a> - str1->len - 1) -00110 num = <a class="code" href="group__string.html#ga8">STP_STRING_SIZE</a> - str1->len - 1; -00111 strncpy (str1->buf + str1->len, str2, num+1); -00112 str1->len += num; -00113 } -00114 <span class="comment"></span> -00115 <span class="comment">/** ConCATenate (append) a String to a String.</span> -00116 <span class="comment"> * Like strcat().</span> -00117 <span class="comment"> * @param str1 String</span> -00118 <span class="comment"> * @param str2 String</span> -00119 <span class="comment"> * @sa _stp_string_cat</span> -00120 <span class="comment"> */</span> -<a name="l00121"></a><a class="code" href="group__string.html#ga6">00121</a> <span class="keywordtype">void</span> <a class="code" href="group__string.html#ga6">_stp_string_cat_string</a> (String str1, String str2) -00122 { -00123 <span class="keywordtype">int</span> num = str2->len; -00124 <span class="keywordflow">if</span> (num > <a class="code" href="group__string.html#ga8">STP_STRING_SIZE</a> - str1->len - 1) -00125 num = <a class="code" href="group__string.html#ga8">STP_STRING_SIZE</a> - str1->len - 1; -00126 strncpy (str1->buf + str1->len, str2->buf, num); -00127 str1->len += num; -00128 } -00129 <span class="comment"></span> -00130 <span class="comment">/** Get a pointer to String's buffer</span> -00131 <span class="comment"> * For rare cases when a C string is needed and you have a String.</span> -00132 <span class="comment"> * One example is when you want to print a String with _stp_printf().</span> -00133 <span class="comment"> * @param str String</span> -00134 <span class="comment"> * @returns A C string (char *)</span> -00135 <span class="comment"> * @note Readonly. Don't write to this pointer or it will mess up</span> -00136 <span class="comment"> * the internal String state and probably mess up your output or crash something.</span> -00137 <span class="comment"> */</span> -<a name="l00138"></a><a class="code" href="group__string.html#ga7">00138</a> <span class="keywordtype">char</span> * <a class="code" href="group__string.html#ga7">_stp_string_ptr</a> (String str) -00139 { -00140 <span class="keywordflow">return</span> str->buf; -00141 } -00142 -00143 <span class="comment"></span> -00144 <span class="comment">/** ConCATenate (append) a String or C string to a String.</span> -00145 <span class="comment"> * This macro selects the proper function to call.</span> -00146 <span class="comment"> * @param str1 A String</span> -00147 <span class="comment"> * @param str2 A String or C string (char *)</span> -00148 <span class="comment"> * @sa _stp_string_cat_cstr _stp_string_cat_string</span> -00149 <span class="comment"> */</span> -<a name="l00150"></a><a class="code" href="group__string.html#ga9">00150</a> <span class="preprocessor">#define _stp_string_cat(str1, str2) \</span> -00151 <span class="preprocessor"> ({ \</span> -00152 <span class="preprocessor"> if (__builtin_types_compatible_p (typeof (str2), char[])) { \</span> -00153 <span class="preprocessor"> char *x = (char *)str2; \</span> -00154 <span class="preprocessor"> _str_string_cat_cstr(str1,x); \</span> -00155 <span class="preprocessor"> } else { \</span> -00156 <span class="preprocessor"> String x = (String)str2; \</span> -00157 <span class="preprocessor"> _str_string_cat_string(str1,x); \</span> -00158 <span class="preprocessor"> } \</span> -00159 <span class="preprocessor"> })</span> -00160 <span class="preprocessor"></span><span class="comment"></span> -00161 <span class="comment">/** @} */</span> -00162 <span class="preprocessor">#endif </span><span class="comment">/* _STRING_C_ */</span> -</pre></div></body></html> diff --git a/runtime/docs/html/string_8c.html b/runtime/docs/html/string_8c.html deleted file mode 100644 index 07151c62..00000000 --- a/runtime/docs/html/string_8c.html +++ /dev/null @@ -1,52 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: string.c File Reference</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1>string.c File Reference</h1>Implements String type. <a href="#_details">More...</a> -<p> -<code>#include <linux/config.h></code><br> - -<p> -<a href="string_8c-source.html">Go to the source code of this file.</a><table border="0" cellpadding="0" cellspacing="0"> -<tr><td></td></tr> -<tr><td colspan="2"><br><h2>Defines</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="ga8" doxytag="string.c::STP_STRING_SIZE"></a> -#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__string.html#ga8">STP_STRING_SIZE</a> 2048</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Maximum string size allowed in Strings. <br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__string.html#ga9">_stp_string_cat</a>(str1, str2)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">ConCATenate (append) a String or C string to a String. <a href="group__string.html#ga9"></a><br></td></tr> -<tr><td colspan="2"><br><h2>Typedefs</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="ga1" doxytag="string.c::String"></a> -typedef string * </td><td class="memItemRight" valign="bottom"><b>String</b></td></tr> - -<tr><td colspan="2"><br><h2>Functions</h2></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">String </td><td class="memItemRight" valign="bottom"><a class="el" href="group__string.html#ga2">_stp_string_init</a> (int num)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Initialize a String for our use. <a href="group__string.html#ga2"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__string.html#ga3">_stp_sprintf</a> (String str, const char *fmt,...)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Sprintf into a String. <a href="group__string.html#ga3"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__string.html#ga4">_stp_vsprintf</a> (String str, const char *fmt, va_list args)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Vsprintf into a String Use this if your function already has a va_list. <a href="group__string.html#ga4"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__string.html#ga5">_stp_string_cat_cstr</a> (String str1, const char *str2)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">ConCATenate (append) a C string to a String. <a href="group__string.html#ga5"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__string.html#ga6">_stp_string_cat_string</a> (String str1, String str2)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">ConCATenate (append) a String to a String. <a href="group__string.html#ga6"></a><br></td></tr> -<tr><td class="memItemLeft" nowrap align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__string.html#ga7">_stp_string_ptr</a> (String str)</td></tr> - -<tr><td class="mdescLeft"> </td><td class="mdescRight">Get a pointer to String's buffer For rare cases when a C string is needed and you have a String. <a href="group__string.html#ga7"></a><br></td></tr> -</table> -<hr><a name="_details"></a><h2>Detailed Description</h2> -Implements String type. -<p> - -<p> -Definition in file <a class="el" href="string_8c-source.html">string.c</a>.</body></html> diff --git a/runtime/docs/html/sym_8c-source.html b/runtime/docs/html/sym_8c-source.html deleted file mode 100644 index 8e7f21b8..00000000 --- a/runtime/docs/html/sym_8c-source.html +++ /dev/null @@ -1,79 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: sym.c Source File</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1>sym.c</h1><div class="fragment"><pre class="fragment">00001 <span class="preprocessor">#ifndef _SYM_C_ </span><span class="comment">/* -*- linux-c -*- */</span> -00002 <span class="preprocessor">#define _SYM_C_</span> -00003 <span class="preprocessor"></span> -00004 <span class="preprocessor">#include "<a class="code" href="string_8c.html">string.c</a>"</span> -00005 <span class="comment"></span> -00006 <span class="comment">/** @file sym.c</span> -00007 <span class="comment"> * @addtogroup sym Symbolic Functions</span> -00008 <span class="comment"> * Symbolic Lookup Functions</span> -00009 <span class="comment"> * @{</span> -00010 <span class="comment"> */</span> -00011 <span class="comment"></span> -00012 <span class="comment">/** Lookup symbol.</span> -00013 <span class="comment"> * This simply calls the kernel function kallsyms_lookup().</span> -00014 <span class="comment"> * That function is not exported, so this workaround is required.</span> -00015 <span class="comment"> * See the kernel source, kernel/kallsyms.c for more information.</span> -00016 <span class="comment"> */</span> -00017 <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">char</span> * (*_stp_kallsyms_lookup)(<span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> addr, -00018 <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> *symbolsize, -00019 <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> *offset, -00020 <span class="keywordtype">char</span> **modname, <span class="keywordtype">char</span> *namebuf)=(<span class="keywordtype">void</span> *)KALLSYMS_LOOKUP; -00021 -00022 <span class="comment"></span> -00023 <span class="comment">/** Write addresses symbolically into a String</span> -00024 <span class="comment"> * @param str String</span> -00025 <span class="comment"> * @param address The address to lookup.</span> -00026 <span class="comment"> * @note Symbolic lookups should not normally be done within</span> -00027 <span class="comment"> * a probe because it is too time-consuming. Use at module exit time.</span> -00028 <span class="comment"> */</span> -00029 -<a name="l00030"></a><a class="code" href="group__sym.html#ga1">00030</a> String <a class="code" href="group__sym.html#ga1">_stp_symbol_sprint</a> (String str, <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> address) -00031 { -00032 <span class="keywordtype">char</span> *modname; -00033 <span class="keyword">const</span> <span class="keywordtype">char</span> *name; -00034 <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> offset, size; -00035 <span class="keywordtype">char</span> namebuf[KSYM_NAME_LEN+1]; -00036 -00037 name = _stp_kallsyms_lookup(address, &size, &offset, &modname, namebuf); -00038 -00039 <a class="code" href="group__string.html#ga3">_stp_sprintf</a> (str, <span class="stringliteral">"0x%lx : "</span>, address); -00040 <span class="keywordflow">if</span> (modname) -00041 <a class="code" href="group__string.html#ga3">_stp_sprintf</a> (str, <span class="stringliteral">"%s+%#lx/%#lx [%s]"</span>, name, offset, size, modname); -00042 <span class="keywordflow">else</span> -00043 <a class="code" href="group__string.html#ga3">_stp_sprintf</a> (str, <span class="stringliteral">"%s+%#lx/%#lx"</span>, name, offset, size); -00044 <span class="keywordflow">return</span> str; -00045 } -00046 -00047 <span class="comment"></span> -00048 <span class="comment">/** Print addresses symbolically to the print buffer.</span> -00049 <span class="comment"> * @param address The address to lookup.</span> -00050 <span class="comment"> * @note Symbolic lookups should not normally be done within</span> -00051 <span class="comment"> * a probe because it is too time-consuming. Use at module exit time.</span> -00052 <span class="comment"> */</span> -00053 -<a name="l00054"></a><a class="code" href="group__sym.html#ga2">00054</a> <span class="keywordtype">void</span> <a class="code" href="group__sym.html#ga2">_stp_symbol_print</a> (<span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> address) -00055 { -00056 <span class="keywordtype">char</span> *modname; -00057 <span class="keyword">const</span> <span class="keywordtype">char</span> *name; -00058 <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> offset, size; -00059 <span class="keywordtype">char</span> namebuf[KSYM_NAME_LEN+1]; -00060 -00061 name = _stp_kallsyms_lookup(address, &size, &offset, &modname, namebuf); -00062 -00063 <a class="code" href="group__print.html#ga3">_stp_printf</a> (<span class="stringliteral">"0x%lx : "</span>, address); -00064 <span class="keywordflow">if</span> (modname) -00065 <a class="code" href="group__print.html#ga3">_stp_printf</a> (<span class="stringliteral">"%s+%#lx/%#lx [%s]"</span>, name, offset, size, modname); -00066 <span class="keywordflow">else</span> -00067 <a class="code" href="group__print.html#ga3">_stp_printf</a> (<span class="stringliteral">"%s+%#lx/%#lx"</span>, name, offset, size); -00068 } -00069 <span class="comment"></span> -00070 <span class="comment">/** @} */</span> -00071 <span class="preprocessor">#endif </span><span class="comment">/* _SYM_C_ */</span> -</pre></div></body></html> diff --git a/runtime/docs/html/test4_2dtr_8c-source.html b/runtime/docs/html/test4_2dtr_8c-source.html deleted file mode 100644 index c3d65197..00000000 --- a/runtime/docs/html/test4_2dtr_8c-source.html +++ /dev/null @@ -1,152 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: probes/test4/dtr.c Source File</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<div class="nav"> -<a class="el" href="dir_000000.html">probes</a> / <a class="el" href="dir_000003.html">test4</a></div> -<h1>dtr.c</h1><div class="fragment"><pre class="fragment">00001 <span class="preprocessor">#define HASH_TABLE_BITS 8</span> -00002 <span class="preprocessor"></span><span class="preprocessor">#define HASH_TABLE_SIZE (1<<HASH_TABLE_BITS)</span> -00003 <span class="preprocessor"></span><span class="preprocessor">#define BUCKETS 16 </span><span class="comment">/* largest histogram width */</span> -00004 -00005 <span class="preprocessor">#define STP_NETLINK_ONLY</span> -00006 <span class="preprocessor"></span><span class="preprocessor">#define STP_NUM_STRINGS 1</span> -00007 <span class="preprocessor"></span> -00008 <span class="preprocessor">#include <linux/module.h></span> -00009 <span class="preprocessor">#include <linux/interrupt.h></span> -00010 <span class="preprocessor">#include <net/sock.h></span> -00011 <span class="preprocessor">#include <linux/netlink.h></span> -00012 -00013 <span class="preprocessor">#include "<a class="code" href="runtime_8h.html">runtime.h</a>"</span> -00014 <span class="preprocessor">#include "<a class="code" href="map_8c.html">map.c</a>"</span> -00015 <span class="preprocessor">#include "<a class="code" href="probes_8c.html">probes.c</a>"</span> -00016 <span class="preprocessor">#include "<a class="code" href="stack_8c.html">stack.c</a>"</span> -00017 -00018 MODULE_DESCRIPTION(<span class="stringliteral">"SystemTap probe: test4"</span>); -00019 MODULE_AUTHOR(<span class="stringliteral">"Martin Hunt <hunt@redhat.com>"</span>); -00020 -00021 -00022 <a class="code" href="group__maps.html#ga1">MAP</a> opens, reads, writes, traces; -00023 -00024 asmlinkage <span class="keywordtype">long</span> inst_sys_open (<span class="keyword">const</span> <span class="keywordtype">char</span> __user * filename, <span class="keywordtype">int</span> flags, <span class="keywordtype">int</span> mode) -00025 { -00026 <a class="code" href="group__maps.html#ga12">_stp_map_key_str</a> (opens, current->comm); -00027 <a class="code" href="group__maps.html#ga17">_stp_map_add_int64</a> (opens, 1); -00028 jprobe_return(); -00029 <span class="keywordflow">return</span> 0; -00030 } -00031 -00032 asmlinkage ssize_t inst_sys_read (<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> fd, <span class="keywordtype">char</span> __user * buf, size_t count) -00033 { -00034 <a class="code" href="group__maps.html#ga12">_stp_map_key_str</a> (reads, current->comm); -00035 <a class="code" href="group__maps.html#ga24">_stp_map_stat_add</a> (reads, count); -00036 jprobe_return(); -00037 <span class="keywordflow">return</span> 0; -00038 } -00039 -00040 asmlinkage ssize_t inst_sys_write (<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> fd, <span class="keyword">const</span> <span class="keywordtype">char</span> __user * buf, size_t count) -00041 { -00042 <a class="code" href="group__maps.html#ga12">_stp_map_key_str</a> (writes, current->comm); -00043 <a class="code" href="group__maps.html#ga24">_stp_map_stat_add</a> (writes, count); -00044 jprobe_return(); -00045 <span class="keywordflow">return</span> 0; -00046 } -00047 -00048 <span class="keywordtype">int</span> inst_show_cpuinfo(<span class="keyword">struct</span> seq_file *m, <span class="keywordtype">void</span> *v) -00049 { -00050 String str = <a class="code" href="group__string.html#ga2">_stp_string_init</a> (0); -00051 <a class="code" href="group__stack.html#ga6">_stp_stack_print</a> (0,0); -00052 <a class="code" href="group__stack.html#ga6">_stp_stack_print</a> (1,0); -00053 <a class="code" href="group__lists.html#ga6">_stp_list_add</a> (traces, <a class="code" href="group__stack.html#ga7">_stp_stack_sprint</a>(str, 0, 0)); -00054 -00055 jprobe_return(); -00056 <span class="keywordflow">return</span> 0; -00057 } -00058 -00059 -00060 <span class="keyword">static</span> <span class="keyword">struct </span>jprobe dtr_probes[] = { -00061 { -00062 .kp.addr = (kprobe_opcode_t *)<span class="stringliteral">"sys_open"</span>, -00063 .entry = (kprobe_opcode_t *) inst_sys_open -00064 }, -00065 { -00066 .kp.addr = (kprobe_opcode_t *)<span class="stringliteral">"sys_read"</span>, -00067 .entry = (kprobe_opcode_t *) inst_sys_read -00068 }, -00069 { -00070 .kp.addr = (kprobe_opcode_t *)<span class="stringliteral">"sys_write"</span>, -00071 .entry = (kprobe_opcode_t *) inst_sys_write -00072 }, -00073 { -00074 .kp.addr = (kprobe_opcode_t *)<span class="stringliteral">"show_cpuinfo"</span>, -00075 .entry = (kprobe_opcode_t *) inst_show_cpuinfo, -00076 }, -00077 }; -00078 -00079 <span class="preprocessor">#define MAX_DTR_ROUTINE (sizeof(dtr_probes)/sizeof(struct jprobe))</span> -00080 <span class="preprocessor"></span> -00081 <span class="keyword">static</span> <span class="keywordtype">int</span> init_dtr(<span class="keywordtype">void</span>) -00082 { -00083 <span class="keywordtype">int</span> ret; -00084 -00085 <span class="keywordflow">if</span> (<a class="code" href="group__io.html#ga7">_stp_netlink_open</a>() < 0) -00086 return -1; -00087 -00088 opens = _stp_map_new (1000, INT64); -00089 reads = _stp_map_new (1000, STAT); -00090 writes = _stp_map_new (1000, STAT); -00091 traces = _stp_list_new (1000, STRING); -00092 -00093 ret = _stp_register_jprobes (dtr_probes, MAX_DTR_ROUTINE); -00094 -00095 _stp_log("instrumentation is enabled...\n"); -00096 return ret; -00097 } -00098 -00099 static <span class="keywordtype">void</span> probe_exit (<span class="keywordtype">void</span>) -00100 { -00101 <span class="keyword">struct </span>map_node_stat *st; -00102 <span class="keyword">struct </span>map_node_int64 *ptr; -00103 <span class="keyword">struct </span>map_node_str *sptr; -00104 -00105 <a class="code" href="probes_8c.html#a2">_stp_unregister_jprobes</a> (dtr_probes, MAX_DTR_ROUTINE); -00106 -00107 <a class="code" href="group__maps.html#ga32">foreach</a> (traces, sptr) { -00108 <a class="code" href="group__print.html#ga3">_stp_printf</a> (<span class="stringliteral">"trace: %s\n"</span>, sptr->str); -00109 <a class="code" href="group__print.html#ga2">_stp_print_flush</a> (); -00110 } -00111 -00112 <a class="code" href="group__maps.html#ga32">foreach</a> (opens, ptr) { -00113 <a class="code" href="group__print.html#ga3">_stp_printf</a> (<span class="stringliteral">"opens[%s] = %lld\n"</span>, <a class="code" href="group__maps.html#ga25">key1str</a>(ptr), ptr->val); -00114 <a class="code" href="group__print.html#ga2">_stp_print_flush</a> (); -00115 } -00116 -00117 <a class="code" href="group__maps.html#ga32">foreach</a> (reads, st) { -00118 <a class="code" href="group__print.html#ga3">_stp_printf</a> (<span class="stringliteral">"reads[%s] = [count=%lld sum=%lld min=%lld max=%lld]\n"</span>, <a class="code" href="group__maps.html#ga25">key1str</a>(st), -00119 st->stats.count, st->stats.sum, st->stats.min, st->stats.max); -00120 <a class="code" href="group__print.html#ga2">_stp_print_flush</a> (); -00121 } -00122 -00123 <a class="code" href="group__maps.html#ga32">foreach</a> (writes, st) { -00124 <a class="code" href="group__print.html#ga3">_stp_printf</a> (<span class="stringliteral">"writes[%s] = [count=%lld sum=%lld min=%lld max=%lld]\n"</span>, <a class="code" href="group__maps.html#ga25">key1str</a>(st), -00125 st->stats.count, st->stats.sum, st->stats.min, st->stats.max); -00126 <a class="code" href="group__print.html#ga2">_stp_print_flush</a>(); -00127 } -00128 -00129 <a class="code" href="group__maps.html#ga7">_stp_map_del</a> (opens); -00130 <a class="code" href="group__maps.html#ga7">_stp_map_del</a> (reads); -00131 <a class="code" href="group__maps.html#ga7">_stp_map_del</a> (writes); -00132 } -00133 -00134 <span class="keyword">static</span> <span class="keywordtype">void</span> cleanup_dtr(<span class="keywordtype">void</span>) -00135 { -00136 <a class="code" href="group__io.html#ga8">_stp_netlink_close</a>(); -00137 } -00138 -00139 module_init(init_dtr); -00140 module_exit(cleanup_dtr); -00141 MODULE_LICENSE(<span class="stringliteral">"GPL"</span>); -00142 -</pre></div></body></html> diff --git a/runtime/docs/html/todo.html b/runtime/docs/html/todo.html deleted file mode 100644 index 8b147af8..00000000 --- a/runtime/docs/html/todo.html +++ /dev/null @@ -1,107 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> -<title>SystemTap: Todo List</title> -<link href="doxygen.css" rel="stylesheet" type="text/css"> -</head><body> -<!-- Generated by Doxygen 1.4.1 --> -<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div> -<h1><a class="anchor" name="todo">Todo List</a></h1><a class="anchor" name="_todo000010"></a> <dl> -<dt>File <a class="el" href="TODO.html">TODO</a> </dt> -<dd>stpd needs an option to disable ANSI colors. </dd> -</dl> -<p> -<a class="anchor" name="_todo000010"></a> <dl> -<dt>File <a class="el" href="TODO.html">TODO</a> </dt> -<dd>stpd needs to be able to write netlink REALTIME_DATA to a file. </dd> -</dl> -<p> -<a class="anchor" name="_todo000010"></a> <dl> -<dt>File <a class="el" href="TODO.html">TODO</a> </dt> -<dd>stpd/stp/io.c stpd needs better startup/shutdown integration with <a class="el" href="io_8c.html">io.c</a> in runtime. Shutdown works, but isn't very clean. Currently the stp script loads the module, then starts stpd. Data is lost until stpd is active. Maybe stpd needs to load the module. Maybe it needs to signal the module that stpd is ready and the module can proceed to load the probes. </dd> -</dl> -<p> -<a class="anchor" name="_todo000010"></a> <dl> -<dt>File <a class="el" href="TODO.html">TODO</a> </dt> -<dd>stpd/stp - What if there are multiple probes running? </dd> -</dl> -<p> -<a class="anchor" name="_todo000010"></a> <dl> -<dt>File <a class="el" href="TODO.html">TODO</a> </dt> -<dd>stpd/stp - Need something to post-process relayfs files and integrate into a single file. </dd> -</dl> -<p> -<a class="anchor" name="_todo000010"></a> <dl> -<dt>File <a class="el" href="TODO.html">TODO</a> </dt> -<dd>stpd - Implement command that runtime can send to stpd to tell it to fork a specified program and pass the output from the probe module to it. Create example probe to use it. </dd> -</dl> -<p> -<a class="anchor" name="_todo000010"></a> <dl> -<dt>File <a class="el" href="TODO.html">TODO</a> </dt> -<dd>relayfs/build - figure out how to get rid of the linker warnings when building probes. </dd> -</dl> -<p> -<a class="anchor" name="_todo000010"></a> <dl> -<dt>File <a class="el" href="TODO.html">TODO</a> </dt> -<dd>runtime - Clean up #defines. Need to have a clearer way to have the probe writer (translator) see which defines affect what and all defines should have reasonable defaults. </dd> -</dl> -<p> -<a class="anchor" name="_todo000010"></a> <dl> -<dt>File <a class="el" href="TODO.html">TODO</a> </dt> -<dd>runtime - <a class="el" href="current_8c.html">current.c</a> - implement a memory dump function. Does a hex dump into String or print buffer.</dd> -</dl> -<p> -<a class="anchor" name="_todo000010"></a> <dl> -<dt>File <a class="el" href="TODO.html">TODO</a> </dt> -<dd>runtime - put wrappers around current task struct entries, like pid, ppid, comm, etc.</dd> -</dl> -<p> -<a class="anchor" name="_todo000010"></a> <dl> -<dt>File <a class="el" href="TODO.html">TODO</a> </dt> -<dd>runtime - Implement stack functions for kprobes (not just jprobes) </dd> -</dl> -<p> -<a class="anchor" name="_todo000001"></a> <dl> -<dt>Group <a class="el" href="group__alloc.html">alloc</a> </dt> -<dd>Need error handling for memory allocations</dd> -</dl> -<p> -<a class="anchor" name="_todo000001"></a> <dl> -<dt>Group <a class="el" href="group__alloc.html">alloc</a> </dt> -<dd>Some of these currently use kmalloc (GFP_ATOMIC) for small allocations. This should be evaluated for performance and stability.</dd> -</dl> -<p> -<a class="anchor" name="_todo000003"></a> <dl> -<dt>Global <a class="el" href="group__io.html#ga2">_stp_log</a> (const char *fmt,...) </dt> -<dd>Evaluate if this function is necessary. </dd> -</dl> -<p> -<a class="anchor" name="_todo000006"></a> <dl> -<dt>Group <a class="el" href="group__maps.html">maps</a> </dt> -<dd>Needs to be made SMP-safe for when the big lock is removed from kprobes.</dd> -</dl> -<p> -<a class="anchor" name="_todo000004"></a> <dl> -<dt>Global <a class="el" href="group__maps.html#ga22">_stp_map_set_stat</a> (MAP map, stat *stats) </dt> -<dd>Histograms don't work yet. </dd> -</dl> -<p> -<a class="anchor" name="_todo000005"></a> <dl> -<dt>Global <a class="el" href="group__maps.html#ga24">_stp_map_stat_add</a> (MAP map, int64_t val) </dt> -<dd>Histograms don't work yet. </dd> -</dl> -<p> -<a class="anchor" name="_todo000007"></a> <dl> -<dt>Global <a class="el" href="group__stack.html#ga6">_stp_stack_print</a> (int verbose, int levels) </dt> -<dd>Implement verbosity and levels parameters.</dd> -</dl> -<p> -<a class="anchor" name="_todo000008"></a> <dl> -<dt>Global <a class="el" href="group__stack.html#ga7">_stp_stack_sprint</a> (String str, int verbose, int levels) </dt> -<dd>Implement verbosity and levels parameters.</dd> -</dl> -<p> -<a class="anchor" name="_todo000009"></a> <dl> -<dt>Global <a class="el" href="group__string.html#ga2">_stp_string_init</a> (int num) </dt> -<dd>Global (and static) Strings not implemented yet. </dd> -</dl> -</body></html> |
