[exim-cvs] Docs: build notes for dynamic modules

Top Page
Delete this message
Reply to this message
Author: Exim Git Commits Mailing List
Date:  
To: exim-cvs
Subject: [exim-cvs] Docs: build notes for dynamic modules
Gitweb: https://git.exim.org/exim.git/commitdiff/34598166349129b6bcefd0a7bff722d79bb1dd9b
Commit:     34598166349129b6bcefd0a7bff722d79bb1dd9b
Parent:     ede1cf66682ae379346aa4681c5f6294f2b7e6a5
Author:     Jeremy Harris <jgh146exb@???>
AuthorDate: Tue Aug 20 17:54:18 2024 +0100
Committer:  Jeremy Harris <jgh146exb@???>
CommitDate: Tue Aug 20 17:54:51 2024 +0100


    Docs: build notes for dynamic modules
---
 doc/doc-docbook/spec.xfpt | 24 +++++++++++++++++-------
 src/src/EDITME            |  2 +-
 2 files changed, 18 insertions(+), 8 deletions(-)


diff --git a/doc/doc-docbook/spec.xfpt b/doc/doc-docbook/spec.xfpt
index f73792ac5..e505176fe 100644
--- a/doc/doc-docbook/spec.xfpt
+++ b/doc/doc-docbook/spec.xfpt
@@ -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.
-Most, but not all, lookup types can be built this way.
-
.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

-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.
@@ -2107,6 +2104,19 @@ LOOKUP_LSEARCH=yes
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"
diff --git a/src/src/EDITME b/src/src/EDITME
index aeba7704a..7d0b07331 100644
--- a/src/src/EDITME
+++ b/src/src/EDITME
@@ -1580,4 +1580,4 @@ EXIM_TMPDIR="/tmp"

# DISABLE_CLIENT_CMD_LOG=yes

-# End of EDITME for Exim 4.
+# End of EDITME for Exim.

--
## subscription configuration (requires account):
## https://lists.exim.org/mailman3/postorius/lists/exim-cvs.lists.exim.org/
## unsubscribe (doesn't require an account):
## exim-cvs-unsubscribe@???
## Exim details at http://www.exim.org/
## Please use the Wiki with this list - http://wiki.exim.org/