[sr-dev] git:master:e0dcb161: htable: docs - not about use of event_route[htable:mod-init]

[Daniel-Constantin Mierla]

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

Author: Daniel-Constantin Mierla <miconda at gmail.com>
Committer: Daniel-Constantin Mierla <miconda at gmail.com>
Date: 2021-02-11T17:33:14+01:00

htable: docs - not about use of event_route[htable:mod-init]

---

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

---

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

---

diff --git a/src/modules/htable/doc/htable_admin.xml b/src/modules/htable/doc/htable_admin.xml
index 573d801bba..3a7f101bca 100644
--- a/src/modules/htable/doc/htable_admin.xml
+++ b/src/modules/htable/doc/htable_admin.xml
@@ -1528,6 +1528,18 @@ kamcmd htable.stats
 			once, after core and module initialization, but before &kamailio; forks any
 			child processes.
 		</para>
+		<para>
+			Note: do not expect to use functions from all other modules here,
+			even if they are loaded before the htable module, because many of
+			them initialize their runtime structures inside child init callbacks,
+			which are executed after this moment, when forking child processes.
+			For example, sqlops cannot be used, connections to database are
+			initialized in child init. Even more, it is recommended not to use
+			functions from other modules, because it can mess up what they
+			created in mod init callback and expect in child init callback. It
+			should be ok to use functions from htable module or assignment
+			operations.
+		</para>
 <programlisting  format="linespecific">
 ...
 event_route[htable:mod-init] {