[sr-dev] git:master:35f711e6: htable: docs - more details about size attribute for htable

[Daniel-Constantin Mierla]

Module: kamailio
Branch: master
Commit: 35f711e6ec74c6e67edf99adaa15cc353f2ce949
URL: https://github.com/kamailio/kamailio/commit/35f711e6ec74c6e67edf99adaa15cc353f2ce949

Author: Daniel-Constantin Mierla <miconda at gmail.com>
Committer: Daniel-Constantin Mierla <miconda at gmail.com>
Date: 2020-05-01T17:26:39+02:00

htable: docs - more details about size attribute for htable

---

Modified: src/modules/htable/doc/htable_admin.xml

---

Diff:  https://github.com/kamailio/kamailio/commit/35f711e6ec74c6e67edf99adaa15cc353f2ce949.diff
Patch: https://github.com/kamailio/kamailio/commit/35f711e6ec74c6e67edf99adaa15cc353f2ce949.patch

---

diff --git a/src/modules/htable/doc/htable_admin.xml b/src/modules/htable/doc/htable_admin.xml
index 408fb137d9..573d801bba 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>