summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJelmer Vernooij <jelmer@samba.org>2003-08-15 06:11:33 +0000
committerJelmer Vernooij <jelmer@samba.org>2003-08-15 06:11:33 +0000
commitf6e3a61469ac7be9ffc3db2c57eeb7da04707bcd (patch)
tree7f9b43c97d0f1df212cc55fd47df34e020adaad6
parentf4dcc68e589d4ddd257080be89b624fcefca710d (diff)
downloadsamba-f6e3a61469ac7be9ffc3db2c57eeb7da04707bcd.tar.gz
samba-f6e3a61469ac7be9ffc3db2c57eeb7da04707bcd.tar.bz2
samba-f6e3a61469ac7be9ffc3db2c57eeb7da04707bcd.zip
Document modules changes
(This used to be commit b8ff07a3439864dc22cc1c501ebcdc117351d2cd)
-rw-r--r--docs/docbook/devdoc/modules.xml18
1 files changed, 13 insertions, 5 deletions
diff --git a/docs/docbook/devdoc/modules.xml b/docs/docbook/devdoc/modules.xml
index e2eb78d6c9..171ee27f90 100644
--- a/docs/docbook/devdoc/modules.xml
+++ b/docs/docbook/devdoc/modules.xml
@@ -136,13 +136,14 @@ for each module and SMB_SUBSYSTEM() for each subsystem.
<para><programlisting>
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>)
+SMB_SUBSYSTEM(<replaceable>subsystem</replaceable>,<replaceable>depfile</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
+<para>The depfile for a certain subsystem is the file that calls the
+initialisation functions for the statically built in modules.</para>
+
+<para>
+<replaceable>@SUBSYSTEM_MODULES@</replaceable> in Makefile.in will
be replaced with the names of the plugins to build.
</para>
@@ -151,6 +152,13 @@ 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>
+<note>
+<para>
+There currently also is a configure.in command called SMB_MODULE_PROVIVES().
+This is used for modules that register multiple things. It should not
+be used as probing will most likely disappear in the future.</para>
+</note>
+
</sect2>
</sect1>
</chapter>