From 33776f4955fa52ae3e4dc87ab6ac484a3ebc9a71 Mon Sep 17 00:00:00 2001 From: hunt Date: Mon, 21 Mar 2005 21:47:54 +0000 Subject: *** empty log message *** --- runtime/docs/html/map_8c.html | 257 +++++++++++++++++++++++++----------------- 1 file changed, 153 insertions(+), 104 deletions(-) (limited to 'runtime/docs/html/map_8c.html') diff --git a/runtime/docs/html/map_8c.html b/runtime/docs/html/map_8c.html index d4982cac..d69f77a8 100644 --- a/runtime/docs/html/map_8c.html +++ b/runtime/docs/html/map_8c.html @@ -5,7 +5,7 @@
Intro | Functions | Defines | Enumerations | Enumeration Values
- +

map.c File Reference

Go to the source code of this file. @@ -44,46 +44,49 @@ - + - - + + - - - - - + + - + - - + + - + + + + + + + - - + + - - + + - - + + - - + + - - + + - +
void _stp_map_key_long (MAP map, long key)
 Set the map's key to a long.
void _stp_map_set_int64 (MAP map, int64_t val)
void _stp_map_set_int64 (MAP map, int64_t val)
 Set the current element's value to an int64.
int64_t _stp_map_get_int64 (MAP map)
 Set the current element's value to an int64.
void _stp_map_add_int64 (MAP map, int64_t val)
 Gets the current element's value.
void _stp_map_set_str (MAP map, char *val)
 Set the current element's value to a string.
char * _stp_map_get_str (MAP map)
 Adds an int64 to the current element's value.
int64_t _stp_map_get_int64 (MAP map)
 Gets the current element's value.
void _stp_map_set_stat (MAP map, stat *stats)
void _stp_map_set_str (MAP map, char *val)
 Set the current element's value to a stat.
stat_stp_map_get_stat (MAP map)
 Set the current element's value to a string.
char * _stp_map_get_str (MAP map)
 Gets the current element's value.
void _stp_map_stat_add (MAP map, int64_t val)
void _stp_map_set_stat (MAP map, stat *stats)
 Set the current element's value to a stat.
stat_stp_map_get_stat (MAP map)
 Gets the current element's value.
void _stp_map_stat_add (MAP map, int64_t val)
 Add to the current element's statistics.
MAP _stp_list_new (unsigned max_entries, enum valtype type)
 Add to the current element's statistics.
MAP _stp_list_new (unsigned max_entries, enum valtype type)
 Create a new list.
void _stp_list_clear (MAP map)
 Create a new list.
void _stp_list_clear (MAP map)
 Clears a list.
void _stp_list_add_str (MAP map, char *str)
 Clears a list.
void _stp_list_add_str (MAP map, char *str)
 Adds a string to a list.
void _stp_list_add_int64 (MAP map, int64_t val)
 Adds a string to a list.
void _stp_list_add_int64 (MAP map, int64_t val)
 Adds an int64 to a list.
int _stp_list_size (MAP map)
 Adds an int64 to a list.
int _stp_list_size (MAP map)
 Get the number of elements in a list.
 Get the number of elements in a list.


Function Documentation

-

- +

+

@@ -126,13 +129,13 @@ Adds an int64 to a list.

-Definition at line 816 of file map.c. +Definition at line 839 of file map.c.

-References _stp_map_key_long(), _stp_map_set_int64(), MAP, and map_root::num. +References _stp_map_key_long(), _stp_map_set_int64(), and map_root::num.

-

- +

+

@@ -175,15 +178,15 @@ Adds a string to a list.

-Definition at line 805 of file map.c. +Definition at line 828 of file map.c.

-References _stp_map_key_long(), _stp_map_set_str(), MAP, and map_root::num. +References _stp_map_key_long(), _stp_map_set_str(), and map_root::num.

Referenced by _stp_copy_argv_from_user().

-

- +

+

@@ -216,13 +219,13 @@ All elements in the list are deleted.
Parameters:

-Definition at line 765 of file map.c. +Definition at line 788 of file map.c.

-References _stp_free(), dlog(), map_root::head, map_node::hnode, map_node::lnode, MAP, map_root::maxnum, map_root::num, and map_root::pool. +References _stp_free(), dlog(), map_root::head, map_node::hnode, map_node::lnode, map_root::maxnum, map_root::num, and map_root::pool.

-

- +

+

@@ -267,13 +270,13 @@ A list is a map that internally has an incrementing long key for each member. Li
See also:
foreach

-Definition at line 753 of file map.c. +Definition at line 776 of file map.c.

-References _stp_map_new(), MAP, and map_root::no_wrap. +References _stp_map_new(), and map_root::no_wrap.

-

- +

+

@@ -307,13 +310,61 @@ Get the number of elements in a list.
Returns:
The number of elements in a list.

-Definition at line 827 of file map.c. +Definition at line 850 of file map.c.

-References MAP, and map_root::num. +References map_root::num. + +

+

+ + + + +
+ + + + + + + + + + + + + + + + + + +
void _stp_map_add_int64 MAP  map,
int64_t  val
+
+ + + +
+   + + +

+Adds an int64 to the current element's value. +

+This adds an int64 to the current element's value. The map must have been created to hold int64s using _stp_map_new()

+If the element doesn't exist, it is created. If no current element (key) is set for the map, this function does nothing.

Parameters:
+ + + +
map 
val value
+
+ +

+Definition at line 541 of file map.c.

- +
@@ -348,11 +399,11 @@ Deletes a map, freeing all memory in all elements. Normally done only when the m

Definition at line 190 of file map.c.

-References _stp_vfree(), map_root::head, map_node::lnode, MAP, and map_root::membuf. +References _stp_vfree(), map_root::head, map_node::lnode, and map_root::membuf.

-

- +

+

@@ -386,13 +437,13 @@ Gets the current element's value.
Returns:
The value. If the current element is not set or doesn't exist, returns 0.

-Definition at line 528 of file map.c. +Definition at line 551 of file map.c.

-References map_root::create, dbug, map_root::key, MAP, and map_node_int64::val. +References map_root::create, dbug, map_root::key, and map_node_int64::val.

-

- +

+

@@ -426,13 +477,13 @@ Gets the current element's value.
Returns:
A pointer to the stats struct. If the current element is not set or doesn't exist, returns NULL.

-Definition at line 692 of file map.c. +Definition at line 715 of file map.c.

-References map_root::create, dbug, map_root::key, MAP, and map_node_stat::stats. +References map_root::create, dbug, map_root::key, and map_node_stat::stats.

-

- +

+

@@ -466,13 +517,13 @@ Gets the current element's value.
Returns:
A string pointer. If the current element is not set or doesn't exist, returns NULL.

-Definition at line 609 of file map.c. +Definition at line 632 of file map.c.

-References map_root::create, dbug, map_root::key, MAP, and map_node_str::str. +References map_root::create, dbug, map_root::key, and map_node_str::str.

- +
@@ -519,11 +570,11 @@ Get the next element in a map.

Definition at line 172 of file map.c.

-References dbug, map_root::head, map_node::lnode, and MAP. +References dbug, map_root::head, and map_node::lnode.

- +
@@ -558,13 +609,13 @@ If no current element (key) for this map is set, this function does nothing.
Definition at line 104 of file map.c.

-References _stp_free(), map_root::create, dbug, map_node::hnode, map_root::key, map_node::lnode, MAP, map_root::maxnum, map_root::num, and map_root::pool. +References _stp_free(), dbug, map_node::hnode, and map_node::lnode.

-Referenced by _stp_map_set_int64(), _stp_map_set_stat(), and _stp_map_set_str(). +Referenced by _stp_map_set_stat(), and _stp_map_set_str().

- +
@@ -609,13 +660,13 @@ This sets the current element based on a long key. If the key is not found, a ne

Definition at line 415 of file map.c.

-References _stp_map_key_long_long(), and MAP. +References _stp_map_key_long_long(), map_root::c_key2type, and NONE.

-Referenced by _stp_list_add_int64(), and _stp_list_add_str(). +Referenced by _stp_list_add_int64(), and _stp_list_add_str().

- +
@@ -667,13 +718,13 @@ This sets the current element based on a key of two strings. If the keys are not

Definition at line 218 of file map.c.

-References map_root::c_key1, map_root::c_key2, map_root::c_keyhead, map_root::create, dbug, map_root::hashes, map_root::key, map_node::key1, MAP, and key_data::val. +References map_root::c_key1, map_root::c_key1type, map_root::c_key2, map_root::c_key2type, map_root::c_keyhead, map_root::create, dbug, map_root::hashes, map_root::key, map_node::key1, LONG, and key_data::val.

Referenced by _stp_map_key_long().

- +
@@ -725,11 +776,11 @@ This sets the current element based on a key of a long and a string. If the keys

Definition at line 358 of file map.c.

-References map_root::c_key1, map_root::c_key2, map_root::c_keyhead, map_root::create, dbug, map_root::hashes, map_root::key, map_node::key1, map_node::key2, MAP, key_data::str, and key_data::val. +References map_root::c_key1, map_root::c_key1type, map_root::c_key2, map_root::c_key2type, map_root::c_keyhead, map_root::create, dbug, map_root::hashes, map_root::key, map_node::key1, map_node::key2, LONG, STR, key_data::str, and key_data::val.

- +
@@ -774,11 +825,11 @@ This sets the current element based on a string key. If the key is not found, a

Definition at line 399 of file map.c.

-References _stp_map_key_str_str(), and MAP. +References _stp_map_key_str_str(), map_root::c_key2type, and NONE.

- +
@@ -830,11 +881,11 @@ This sets the current element based on a key of a string and a long. If the keys

Definition at line 310 of file map.c.

-References map_root::c_key1, map_root::c_key2, map_root::c_keyhead, map_root::create, dbug, map_root::hashes, map_root::key, map_node::key1, map_node::key2, MAP, key_data::str, and key_data::val. +References map_root::c_key1, map_root::c_key1type, map_root::c_key2, map_root::c_key2type, map_root::c_keyhead, map_root::create, dbug, map_root::hashes, map_root::key, map_node::key1, map_node::key2, LONG, STR, key_data::str, and key_data::val.

- +
@@ -886,13 +937,13 @@ This sets the current element based on a key of two strings. If the keys are not

Definition at line 261 of file map.c.

-References map_root::c_key1, map_root::c_key2, map_root::c_keyhead, map_root::create, dbug, map_root::hashes, map_root::key, map_node::key1, map_node::key2, MAP, and key_data::str. +References map_root::c_key1, map_root::c_key1type, map_root::c_key2, map_root::c_key2type, map_root::c_keyhead, map_root::create, dbug, map_root::hashes, map_root::key, map_node::key1, map_node::key2, STR, and key_data::str.

Referenced by _stp_map_key_str().

- +
@@ -938,13 +989,13 @@ Maps must be created at module initialization time.
Parameter

Definition at line 43 of file map.c.

-References _stp_valloc(), dbug, map_root::head, MAP, map_root::maxnum, map_root::membuf, and map_root::pool. +References _stp_valloc(), dbug, END, map_root::head, map_root::maxnum, map_root::membuf, map_root::pool, and map_root::type.

-Referenced by _stp_list_new(). +Referenced by _stp_list_new().

-

- +

+

@@ -988,15 +1039,13 @@ If the element doesn't exist, it is created. If no current element (key) is set

-Definition at line 471 of file map.c. -

-References _stp_calloc(), _stp_map_key_del(), map_root::create, dbug, map_root::head, map_node::hnode, map_root::key, map_node::lnode, MAP, map_root::maxnum, map_node_int64::n, map_root::no_wrap, map_root::pool, and map_node_int64::val. +Definition at line 525 of file map.c.

-Referenced by _stp_list_add_int64(). +Referenced by _stp_list_add_int64().

-

- +

+

@@ -1031,7 +1080,7 @@ Referenced by _stp_list_add_int64

Set the current element's value to a stat.

-This sets the current element's value to an stat struct. The map must have been created to hold stats using _stp_map_new(xxx, STAT). 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.

See also:
_stp_map_stat_add
+This sets the current element's value to an stat struct. The map must have been created to hold stats using _stp_map_new(xxx, STAT). 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.
See also:
_stp_map_stat_add
If the element doesn't exist, it is created. If no current element (key) is set for the map, this function does nothing.
Parameters:
@@ -1041,15 +1090,15 @@ If the element doesn't exist, it is created. If no current element (key) is set
Todo:
Histograms don't work yet.

-Definition at line 633 of file map.c. +Definition at line 656 of file map.c.

-References _stp_calloc(), _stp_map_key_del(), map_root::create, dbug, map_root::head, map_node::hnode, map_root::key, map_node::lnode, MAP, map_root::maxnum, map_node_stat::n, map_root::no_wrap, map_root::pool, and map_node_stat::stats. +References _stp_calloc(), _stp_map_key_del(), map_root::create, dbug, map_root::head, map_node::hnode, map_root::key, map_node::lnode, map_root::maxnum, map_node_stat::n, map_root::no_wrap, map_root::pool, and map_node_stat::stats.

-Referenced by _stp_map_stat_add(). +Referenced by _stp_map_stat_add().

map 
-

- +

+

@@ -1093,15 +1142,15 @@ If the element doesn't exist, it is created. If no current element (key) is set

-Definition at line 548 of file map.c. +Definition at line 571 of file map.c.

-References _stp_alloc(), _stp_calloc(), _stp_free(), _stp_map_key_del(), map_root::create, dbug, map_root::head, map_node::hnode, map_root::key, map_node::lnode, MAP, map_root::maxnum, map_node_str::n, map_root::no_wrap, map_root::pool, and map_node_str::str. +References _stp_alloc(), _stp_calloc(), _stp_free(), _stp_map_key_del(), map_root::create, dbug, map_root::head, map_node::hnode, map_root::key, map_node::lnode, map_root::maxnum, map_node_str::n, map_root::no_wrap, map_root::pool, and map_node_str::str.

-Referenced by _stp_list_add_str(). +Referenced by _stp_list_add_str().

- +
@@ -1138,11 +1187,11 @@ Get the first element in a map.

Definition at line 149 of file map.c.

-References dbug, map_root::head, and MAP. +References dbug, and map_root::head.

-

- +

+

@@ -1187,13 +1236,13 @@ If the element doesn't exist, it is created. If no current element (key) is set
Todo:
Histograms don't work yet.

-Definition at line 713 of file map.c. +Definition at line 736 of file map.c.

-References _stp_map_set_stat(), stat::count, map_root::create, dbug, map_root::key, MAP, stat::max, stat::min, map_node_stat::stats, and stat::sum. +References _stp_map_set_stat(), stat::count, map_root::create, dbug, map_root::key, stat::max, stat::min, map_node_stat::stats, and stat::sum.

-
Generated on Wed Mar 9 13:21:28 2005 for SystemTap by  +
Generated on Mon Mar 21 13:29:45 2005 for SystemTap by  -doxygen 1.3.9.1
+doxygen 1.4.1
-- cgit