summaryrefslogtreecommitdiffstats
path: root/debian/libmariadb3.symbols.README
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-13 12:24:44 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-13 12:24:44 +0000
commitbf772a107fc4511b6e3e5aafddb762ca3fa74f0b (patch)
tree8d994c2f3d8e9f01da4d334f90a20798760d9318 /debian/libmariadb3.symbols.README
parentAdding upstream version 1:10.11.6. (diff)
downloadmariadb-7b4a2bd557f2d08cbffa445f3af0e354c445babd.tar.xz
mariadb-7b4a2bd557f2d08cbffa445f3af0e354c445babd.zip
Adding debian version 1:10.11.6-2.debian/1%10.11.6-2
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'debian/libmariadb3.symbols.README')
-rw-r--r--debian/libmariadb3.symbols.README42
1 files changed, 42 insertions, 0 deletions
diff --git a/debian/libmariadb3.symbols.README b/debian/libmariadb3.symbols.README
new file mode 100644
index 00000000..b6e8c95e
--- /dev/null
+++ b/debian/libmariadb3.symbols.README
@@ -0,0 +1,42 @@
+The libmariadb3.symbols files is used to track the libmariadb3 ABI.
+
+If a symbol is removed or changed, the Debian build will fail unless the same change has also explicitly been made in the libmariadb3.symbols file.
+
+If a symbol is added, the Debian build will issue a warning like:
+
+ dh_makeshlibs -O--parallel
+ rm -f debian/libmariadb3/DEBIAN/shlibs
+ echo "libmariadb 3 libmariadb3" >> debian/libmariadb3/DEBIAN/shlibs
+ chmod 0644 -- debian/libmariadb3/DEBIAN/shlibs
+ chown 0:0 -- debian/libmariadb3/DEBIAN/shlibs
+ dpkg-gensymbols -plibmariadb3 -Idebian/libmariadb3.symbols -Pdebian/libmariadb3 -edebian/libmariadb3/usr/lib/x86_64-linux-gnu/libmariadb.so.3
+ dpkg-gensymbols: warning: some new symbols appeared in the symbols file: see diff output below
+ dpkg-gensymbols: warning: debian/libmariadb3/DEBIAN/symbols doesn't match completely debian/libmariadb3.symbols
+ --- debian/libmariadb3.symbols (libmariadb3_10.2.32+maria~sid_amd64)
+ +++ dpkg-gensymbolsUfTky5 2020-02-20 11:27:03.815551573 +0000
+ @@ -12,6 +12,7 @@
+ mariadb_get_charset_by_name@libmariadb_3 3.0.0
+ mariadb_get_charset_by_nr@libmariadb_3 3.0.0
+ mariadb_get_info@libmariadb_3 3.0.0
+ + mariadb_get_infov@libmariadb_3 10.2.32+maria~sid
+ mariadb_reconnect@libmariadb_3 3.0.0
+ mariadb_rpl_close@libmariadb_3 3.1.0
+ mariadb_rpl_fetch@libmariadb_3 3.1.0
+
+
+When this happens, please add the symbol to the libmariadb3.symbols file.
+Unlike the automatic diff above, don't use the server version for the symbols.
+
+Instead use the client library version, which can be viewed with:
+
+ $ grep 'SET(CPACK_PACKAGE_VERSION_' libmariadb/CMakeLists.txt
+ SET(CPACK_PACKAGE_VERSION_MAJOR 3)
+ SET(CPACK_PACKAGE_VERSION_MINOR 1)
+ SET(CPACK_PACKAGE_VERSION_PATCH 7)
+
+In this example, the line to add would be:
+
+ mariadb_get_infov@libmariadb_3 3.1.7
+
+
+Remember to not break the ABI in a stable release!