Local_scan: bump the ABI major version number
authorJeremy Harris <jgh146exb@wizmail.org>
Mon, 25 Nov 2019 15:21:56 +0000 (15:21 +0000)
committerJeremy Harris <jgh146exb@wizmail.org>
Mon, 25 Nov 2019 15:31:04 +0000 (15:31 +0000)
Broken-by: 925ac8e4f1
doc/doc-docbook/spec.xfpt
doc/doc-txt/ChangeLog
src/src/local_scan.h

index 452d76434010ad2e8b585fd386fb950519349335..483aa965648f294b6bdd24e4e39bd3a09af04fb3 100644 (file)
@@ -34359,9 +34359,9 @@ The second argument is used to request that the data be buffered
 This is advisory only, but likely to save on system-calls and packets
 sent when a sequence of calls to the function are made.
 
-The argument was added in Exim version 4.90 - changing the API.
-Nobody noticed until 4.93 was imminent.
-A decision on the way forward has not yet been made.
+The argument was added in Exim version 4.90 - changing the API/ABI.
+Nobody noticed until 4.93 was imminent, at which point the
+ABI version number was incremented.
 .wen
 
 Strings that are written by &'smtp_printf()'& from within &[local_scan()]&
index faf6914cab572b04de1d4919c05665e095afcaa3..64198944a5c23df51daff3a0eb69af3bc290af8e 100644 (file)
@@ -206,6 +206,12 @@ JH/44 With OpenSSL 1.1.1 (onwards) disable renegotiation for TLS1.2 and below;
 
 JH/45 local_scan API: documented the current smtp_printf() call. This changed
       for version 4.90 - adding a "more data" boolean to the arguments.
+      Bumped the ABI version number also, this having been missed previously;
+      release versions 4.90 to 4.92.3 inclusive were effectively broken in
+      respect of usage of smtp_printf() by either local_scan code or libraries
+      accessed via the ${dlfunc } expansion item.  Both will need coding
+      adjustment for any calls to smtp_printf() to match the new function
+      signature; a FALSE value for the new argument is always safe.
 
 
 Exim version 4.92
index 41a17a35cd576053b55e0cc675fcb8d470650245..e0a97088f37b7087b9332ecf6c6c1f161115feb6 100644 (file)
@@ -98,7 +98,7 @@ ABI is changed in a non backward compatible way. The minor number is increased
 each time a new feature is added (in a way that doesn't break backward
 compatibility). */
 
-#define LOCAL_SCAN_ABI_VERSION_MAJOR 2
+#define LOCAL_SCAN_ABI_VERSION_MAJOR 3
 #define LOCAL_SCAN_ABI_VERSION_MINOR 1
 #define LOCAL_SCAN_ABI_VERSION \
   LOCAL_SCAN_ABI_VERSION_MAJOR.LOCAL_SCAN_ABI_VERSION_MINOR