Module: kamailio
Branch: 5.3
Commit: 4790825cc98068b07c1e0402bdea93f839a1fd77
URL:
https://github.com/kamailio/kamailio/commit/4790825cc98068b07c1e0402bdea93f…
Author: Daniel-Constantin Mierla <miconda(a)gmail.com>
Committer: Daniel-Constantin Mierla <miconda(a)gmail.com>
Date: 2020-05-06T11:57:22+02:00
htable: docs - more details about size attribute for htable
(cherry picked from commit 35f711e6ec74c6e67edf99adaa15cc353f2ce949)
---
Modified: src/modules/htable/doc/htable_admin.xml
---
Diff:
https://github.com/kamailio/kamailio/commit/4790825cc98068b07c1e0402bdea93f…
Patch:
https://github.com/kamailio/kamailio/commit/4790825cc98068b07c1e0402bdea93f…
---
diff --git a/src/modules/htable/doc/htable_admin.xml
b/src/modules/htable/doc/htable_admin.xml
index 17391626a1..f0b560cfd1 100644
--- a/src/modules/htable/doc/htable_admin.xml
+++ b/src/modules/htable/doc/htable_admin.xml
@@ -341,11 +341,17 @@ $ kamcmd htable.dump htable
</listitem>
<listitem>
<para>
- <emphasis>size</emphasis> - number specifying the size of hash
- table. Larger value means less collisions. The number of entries
- (aka slots or buckets) in the table is 2^size. The possible range
+ <emphasis>size</emphasis> - number to control how many slots
+ (buckets) to create for the hash table. Larger value means more
+ slots with higher probability for less collisions. The actual number
+ slots (or buckets) created for the table is 2^size. The possible range
for this value is from 2 to 31, smaller or larger values will be
- increased to 3 (8 slots) or decreased to 14 (16384 slots).
+ increased to 3 (8 slots) or decreased to 14 (16384 slots). Note
+ that each slot can store more than one item, when there are
+ collisions of hash ids computed for keys. The items in the same
+ slot are stored in a linked list. In other words, the size is not
+ setting a limit of how many items can be stored in a hash table, as
+ long as there is enough free shared memory, new items can be added.
</para>
</listitem>
<listitem>