Docs: build notes for dynamic modules
authorJeremy Harris <jgh146exb@wizmail.org>
Tue, 20 Aug 2024 16:54:18 +0000 (17:54 +0100)
committerJeremy Harris <jgh146exb@wizmail.org>
Tue, 20 Aug 2024 16:54:51 +0000 (17:54 +0100)
doc/doc-docbook/spec.xfpt
src/src/EDITME

index f73792ac5f848c5cba8d615846a87a275f2fccdd..e505176fedd2d07279b667a0f3f689b89da79fa7 100644 (file)
@@ -2082,16 +2082,13 @@ on demand.
 This permits packagers to build Exim with support for lookups with extensive
 library dependencies without requiring all systems to install all of those
 dependencies.
 This permits packagers to build Exim with support for lookups with extensive
 library dependencies without requiring all systems to install all of those
 dependencies.
-Most, but not all, lookup types can be built this way.
-
 .new
 .new
-Similarly, authenticator, router and transport drivers can be built
-as external modules.
-This permits a smaller exim binary, growing only as needed for the
-runtime cofiguration.
+Any combination of lookup types can be built this way.
+All of the lookup modules found as an Exim process starts will be loaded.
 .wen
 
 .wen
 
-Set &`LOOKUP_MODULE_DIR`& to the directory into which the modules will be
+For building
+set &`LOOKUP_MODULE_DIR`& to the directory into which the modules will be
 installed; Exim will only load modules from that directory, as a security
 measure.  You will need to set &`CFLAGS_DYNAMIC`& if not already defined
 for your OS; see &_OS/Makefile-Linux_& for an example.
 installed; Exim will only load modules from that directory, as a security
 measure.  You will need to set &`CFLAGS_DYNAMIC`& if not already defined
 for your OS; see &_OS/Makefile-Linux_& for an example.
@@ -2107,6 +2104,19 @@ LOOKUP_LSEARCH=yes
 LOOKUP_SQLITE=2
 LOOKUP_MYSQL=2
 .endd
 LOOKUP_SQLITE=2
 LOOKUP_MYSQL=2
 .endd
+Set also &`LOOKUP_`&<&'lookup_type'&>&` INCLUDE`& and
+&`LOOKUP_`&<&'lookup_type'&>`_LIBS if needed for each lookup type,
+ensuring that duplicates are not present in more global values.
+
+.new
+Similarly, authenticator, router and transport drivers can be built
+as external modules.
+Modules will be searched for as demanded by the runtime configuration,
+permitting a smaller Exim binary.
+
+For building, as above but using
+&`AUTH_*`&, &`ROUTER_*`& and &`TRANSPORT_*`& instead of &`LOOKUP_*`&,
+.wen
 
 
 .section "The building process" "SECID29"
 
 
 .section "The building process" "SECID29"
index aeba7704abf715efd8bb8bffde95f7e2a4e3c14d..7d0b07331ac4480ac5d64dc9033443d853478eed 100644 (file)
@@ -1580,4 +1580,4 @@ EXIM_TMPDIR="/tmp"
 
 # DISABLE_CLIENT_CMD_LOG=yes
 
 
 # DISABLE_CLIENT_CMD_LOG=yes
 
-# End of EDITME for Exim 4.
+# End of EDITME for Exim.