summaryrefslogtreecommitdiff
path: root/docs/docbook
diff options
context:
space:
mode:
authorJelmer Vernooij <jelmer@samba.org>2003-03-25 22:51:38 +0000
committerJelmer Vernooij <jelmer@samba.org>2003-03-25 22:51:38 +0000
commit03414dcb267d27b157b14b76f43eeffd03f57762 (patch)
tree5034d8b29dfd01ec69b1a493b68b9bc9578e0082 /docs/docbook
parentdc16a6848b5c3da843046a75fbd30d1cc84dd98c (diff)
downloadsamba-03414dcb267d27b157b14b76f43eeffd03f57762.tar.gz
samba-03414dcb267d27b157b14b76f43eeffd03f57762.tar.bz2
samba-03414dcb267d27b157b14b76f43eeffd03f57762.zip
Add notes about the rebuilding of files
(This used to be commit 0ab6e96c9b32526936878da62b3cc00edd0ac27c)
Diffstat (limited to 'docs/docbook')
-rw-r--r--docs/docbook/devdoc/modules.sgml21
1 files changed, 15 insertions, 6 deletions
diff --git a/docs/docbook/devdoc/modules.sgml b/docs/docbook/devdoc/modules.sgml
index 99cba605bd..0bcdadc66c 100644
--- a/docs/docbook/devdoc/modules.sgml
+++ b/docs/docbook/devdoc/modules.sgml
@@ -63,11 +63,8 @@ it is here currently (from <filename>include/config.h</filename>):
</programlisting></para>
<para>
-These functions should be called before the subsystem is used. That can be
-done either from the executable that will be using the subsystem (
-static_init_rpc is called from the main() function of smbd), or
-from the subsystem itself when it's first used (like passdb's
-lazy_initialise_passdb does).
+These functions should be called before the subsystem is used. That
+should be done when the subsystem is initialised or first used.
</para>
</sect2>
@@ -138,10 +135,22 @@ for each module and SMB_SUBSYSTEM() for each subsystem.
<para>Syntax:</para>
<para><programlisting>
-SMB_MODULE($MODULE_<replaceable>subsystem</replaceable>_<replaceable>backend</replaceable>, <replaceable>subsystem</replaceable>_<replaceable>backend</replaceable>, <replaceable>object files</replaceable>, <replaceable>plugin name</replaceable>, <replaceable>subsystem name</replaceable>)
+SMB_MODULE(<replaceable>subsystem</replaceable>_<replaceable>backend</replaceable>, <replaceable>object files</replaceable>, <replaceable>plugin name</replaceable>, <replaceable>subsystem name</replaceable>, <replaceable>static_action</replaceable>, <replaceable>shared_action</replaceable>)
SMB_SUBSYSTEM(<replaceable>subsystem</replaceable>)
</programlisting></para>
+<para>Also, make sure to add the correct directives to
+<filename>Makefile.in</filename>. <replaceable>@SUBSYSTEM_STATIC@</replaceable>
+will be replaced with a list of objects files of the modules that need to
+be linked in statically. <replaceable>@SUBSYSTEM_MODULES@</replaceable> will
+be replaced with the names of the plugins to build.
+</para>
+
+<para>You must make sure all .c files that contain defines that can
+be changed by ./configure are rebuilded in the 'modules_clean' make target.
+Practically, this means all c files that contain <command>static_init_subsystem;</command> calls need to be rebuilded.
+</para>
+
</sect2>
</sect1>
</chapter>