Changeset 90066bf for server

Timestamp:

11/21/2023 02:51:49 AM (5 months ago)

Author:

Xi Ruoyao <xry111@…>

Branches:

12.1, ken/TL2024, ken/tuningfonts, lazarus, plabs/newcss, python3.11, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, xry111/llvm18

Children:

61936ca3

Parents:

c94de90

git-author:

Xi Ruoyao <xry111@…> (11/21/2023 02:39:54 AM)

git-committer:

Xi Ruoyao <xry111@…> (11/21/2023 02:51:49 AM)

Message:

postfix: Switch from db to lmdb

DB is slated for remove in BLFS 12.1, so switch from it now.

Though postfix supports various DB formats, the only formats can be used
for postmap are btree, cdb, dbm, hash, lmdb, and sdbm. btree and hash
needs db; cdb, dbm, sdbm needs something out of BLFS. So lmdb should be
recommended or we'll have no postmap support.

File:

• server/mail/postfix.xml (modified) (11 diffs)

server/mail/postfix.xml

@@ -87 +87 @@
     <bridgehead renderas="sect4">Recommended</bridgehead>
     <para role="recommended">
-      <xref linkend="db"/>,
-      <xref linkend="cyrus-sasl"/>, and
-      <xref linkend="libnsl"/>
+      <xref linkend="cyrus-sasl"/>,
+      <xref linkend="libnsl"/>, and
+      <xref linkend="lmdb"/>
     </para>
 
     <bridgehead renderas="sect4">Optional</bridgehead>
     <para role="optional">
+      <xref linkend="db"/>,
       <xref linkend="icu"/> for Email Address Internationalization (SMTPUTF8) support,
       <xref linkend="mariadb"/> or <ulink url="https://www.mysql.com/">MySQL</ulink>,
@@ -162 +163 @@
         <para>
           For all variants of the CCARGS you should ensure that -DNO_NIS is
-          specified so that the build does not attempt to access an rpcsvc header
-          which does not exist in BLFS.
+          specified so that the build does not attempt to access an rpcsvc
+          header which do not exist in BLFS.  If <xref linkend='db'/> is
+          not installed, -DNO_DB needs to be specified as well.
         </para>
       </note>
@@ -179 +181 @@
         </para>
 
-<screen><literal>CCARGS='-DNO_NIS -DUSE_SASL_AUTH -DUSE_CYRUS_SASL -I/usr/include/sasl'
+<screen><literal>CCARGS="-DNO_NIS -DNO_DB \
+        -DUSE_SASL_AUTH -DUSE_CYRUS_SASL -I/usr/include/sasl"
 AUXLIBS='-lsasl2'</literal></screen>
-
+      </sect4>
+
+      <sect4>
+        <title>LMDB</title>
+        <para>
+          To use <application>LMDB</application> with
+          <application>Postfix</application>, use the following arguments:
+        </para>
+
+<screen><literal>CCARGS='-DNO_NIS -DNO_DB -DHAS_LMDB'
+AUXLIBS_LMDB='-llmdb'</literal></screen>
       </sect4>
 
@@ -192 +205 @@
         </para>
 
-<screen><literal>CCARGS='-DNO_NIS -DHAS_LDAP'
+<screen><literal>CCARGS='-DNO_NIS -DNO_DB -DHAS_LDAP'
 AUXLIBS='-lldap -llber'</literal></screen>
 
@@ -205 +218 @@
         </para>
 
-<screen><literal>CCARGS='-DNO_NIS -DHAS_SQLITE'
+<screen><literal>CCARGS='-DNO_NIS -DNO_DB -DHAS_SQLITE'
 AUXLIBS='-lsqlite3 -lpthread'</literal></screen>
 
@@ -218 +231 @@
         </para>
 
-<screen><literal>CCARGS='-DNO_NIS -DHAS_MYSQL -I/usr/include/mysql'
+<screen><literal>CCARGS='-DNO_NIS -DNO_DB -DHAS_MYSQL -I/usr/include/mysql'
 AUXLIBS='-lmysqlclient -lz -lm'</literal></screen>
 
@@ -231 +244 @@
         </para>
 
-<screen><literal>CCARGS='-DNO_NIS -DHAS_PGSQL -I/usr/include/postgresql'
+<screen><literal>CCARGS='-DNO_NIS -DNO_DB -DHAS_PGSQL -I/usr/include/postgresql'
 AUXLIBS='-lpq -lz -lm'</literal></screen>
 
@@ -245 +258 @@
         </para>
 
-<screen><literal>CCARGS='-DNO_NIS -DHAS_CDB'
+<screen><literal>CCARGS='-DNO_NIS -DNO_DB -DHAS_CDB'
 AUXLIBS='<replaceable>&lt;/path/to/CDB&gt;</replaceable>/libcdb.a'</literal></screen>
 
@@ -258 +271 @@
         </para>
 
-<screen><literal>CCARGS='-DNO_NIS -DUSE_TLS -I/usr/include/openssl/'
+<screen><literal>CCARGS='-DNO_NIS -DNO_DB -DUSE_TLS -I/usr/include/openssl/'
 AUXLIBS='-lssl -lcrypto'</literal></screen>
       </sect4>
@@ -269 +282 @@
       <para>
         Adjust the following according to your needs. For example,
-        if you have <application>Cyrus SASL</application>,
+        if you have <application>Cyrus SASL</application> and
+        <application>LMDB</application>,
         install <application>Postfix</application> by running the following
         commands:
       </para>
 
-<screen><userinput>make CCARGS="-DNO_NIS -DUSE_TLS -I/usr/include/openssl/            \
-             -DUSE_SASL_AUTH -DUSE_CYRUS_SASL -I/usr/include/sasl" \
+<screen><userinput>make CCARGS="-DNO_NIS -DNO_DB -DUSE_TLS -I/usr/include/openssl/    \
+             -DUSE_SASL_AUTH -DUSE_CYRUS_SASL -I/usr/include/sasl  \
+             -DHAS_LMDB"                                           \
      AUXLIBS="-lssl -lcrypto -lsasl2"                              \
+     AUXLIBS_LMDB="-llmdb"                                         \
      makefiles &amp;&amp;
 make</userinput></screen>
@@ -376 +392 @@
         the above command appends these aliases to it if it exists. This file
         should be checked and duplicate aliases removed, if present.
+      </para>
+
+      <para>
+        The BLFS editors recommend to use LMDB instead of Berkeley DB for
+        Postfix lookup tables.  Add a line into
+        <filename>/etc/postfix/main.cf</filename> to make
+        <command>postmap</command> to encode the lookup tables in the LMDB
+        format by default:
+      </para>
+
+<screen role="root"><userinput>echo 'default_database_type = lmdb' &gt;&gt; /etc/postfix/main.cf</userinput></screen>
+
+      <para>
+        Note that if you are following an online tutorial to configure
+        Postfix, the tutorial may refer to a lookup table with
+        <literal>hash:/path/to/lookup_table</literal>.  You should replace
+        <literal>hash</literal> with <literal>lmdb</literal> in order to use
+        a lookup table encoded in the LMDB format.
       </para>