]> git.ipfire.org Git - thirdparty/pdns.git/blob - pdns/recursordist/docs/upgrade.rst
configure: with-libsodium
[thirdparty/pdns.git] / pdns / recursordist / docs / upgrade.rst
1 Upgrade Guide
2 =============
3
4 Before upgrading, it is advised to read the :doc:`changelog/index`.
5 When upgrading several versions, please read **all** notes applying to the upgrade.
6
7 4.1.x to 4.2.0 or master
8 ------------------------
9
10 Two new settings have been added:
11
12 - :ref:`setting-xpf-allow-from` can contain a list of IP addresses ranges from which `XPF (X-Proxied-For) <https://datatracker.ietf.org/doc/draft-bellis-dnsop-xpf/>`_ records will be trusted.
13 - :ref:`setting-xpf-rr-code` should list the number of the XPF record to use (in lieu of an assigned code).
14
15 4.0.x to 4.1.0
16 --------------
17
18 :ref:`setting-loglevel` defaulted to 4 but was always overridden to 6 during
19 the startup. The issue has been fixed and the default value set to 6 to keep the behavior
20 consistent.
21
22 The ``--with-libsodium`` configure flag has changed from 'no' to 'auto'.
23 This means that if libsodium and its development header are installed, it will be linked in.
24
25 4.0.3 to 4.0.4
26 --------------
27
28 One setting has been added to limit the risk of overflowing the stack:
29
30 - :ref:`setting-max-recursion-depth`: defaults to 40 and was unlimited before
31
32 4.0.0 to 4.0.1
33 --------------
34
35 Two settings have changed defaults, these new defaults decrease CPU usage:
36
37 - :ref:`setting-root-nx-trust` changed from "no" to "yes"
38 - :ref:`setting-log-common-errors` changed from "yes" to "no"