From: "cron2 (Code Review)" Date: Thu, 7 May 2026 07:44:53 +0000 In-Reply-To: References: Reply-To: gert@...1296..., arne-openvpn@...1227..., selva.nair@...277..., openvpn-devel@lists.sourceforge.net, frank@...2641... Message-ID: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Content-Disposition: inline Content-Type: multipart/alternative; boundary="sN4CgPS989o="; charset=UTF-8 Subject: [Openvpn-devel] [S] Change in openvpn[master]: DNS server documentation update List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: selvanair , plaisthos , flichtenheld Cc: openvpn-devel --sN4CgPS989o= Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable cron2 has uploaded a new patch set (#3) to the change originally created by= selvanair. ( http://gerrit.openvpn.net/c/openvpn/+/1646?usp=3Demail ) The following approvals got outdated and were removed: Code-Review+2 by flichtenheld Change subject: DNS server documentation update ...................................................................... DNS server documentation update Github: OpenVPN/openvpn#937 Change-Id: I53b3f4c60897a1f4dd5efeb6575d525ffb082402 Signed-off-by: Selva Nair Acked-by: Frank Lichtenheld Gerrit URL: https://gerrit.openvpn.net/c/openvpn/+/1646 Message-Id: <20260430163249.13638-1-gert@...1296...> URL: https://www.mail-archive.com/openvpn-devel@lists.sourceforge.net/msg36= 816.html Signed-off-by: Gert Doering --- M doc/man-sections/client-options.rst 1 file changed, 15 insertions(+), 1 deletion(-) git pull ssh://gerrit.openvpn.net:29418/openvpn refs/changes/46/1646/3 diff --git a/doc/man-sections/client-options.rst b/doc/man-sections/client-= options.rst index 1664eed..3ad9104 100644 --- a/doc/man-sections/client-options.rst +++ b/doc/man-sections/client-options.rst @@ -216,7 +216,8 @@ DNS server options it must be between 0 and 127. The server id is used to group options and also for ordering the list of configured DNS server= s; lower numbers come first. DNS servers being pushed to a client replace - already configured DNS servers with the same server id. + already configured DNS servers with the same server id. Only the group of + options corresponding to the lowest server id is applied. The ``address`` option configures the IPv4 and / or IPv6 address(es) of the DNS server. Up to eight addresses can be specified per DNS server. @@ -249,6 +250,19 @@ so that ``--dns`` overrides ``--dhcp-option``. Thus, ``--dns`` can be us= ed today to migrate from ``--dhcp-option``. + Windows only: + + #. If tap-windows6 is in use, dns servers are set by DHCP by default. + In this case only ``--dns search-domains`` and ``--dns server n addre= ss ..`` + with the lowest value of ``n`` are interpreted. All other ``--dns`` o= ptions + are ignored. Use of the dco driver is the recommended way to make use= of these + new features. + + #. If ``--dns server n resolve-domains`` is in use, the DNS server addre= sses + corresponding to ``n`` are set on the interface only if ``search-doma= ins`` is + also specified. Otherwise these DNS addresses are used only for NRPT= rules for + split-DNS. + --explicit-exit-notify n In UDP client mode or point-to-point mode, send server/peer an exit notification if tunnel is restarted or OpenVPN process is exited. In -- To view, visit http://gerrit.openvpn.net/c/openvpn/+/1646?usp=3Demail To unsubscribe, or for help writing mail filters, visit http://gerrit.openv= pn.net/settings?usp=3Demail Gerrit-MessageType: newpatchset Gerrit-Project: openvpn Gerrit-Branch: master Gerrit-Change-Id: I53b3f4c60897a1f4dd5efeb6575d525ffb082402 Gerrit-Change-Number: 1646 Gerrit-PatchSet: 3 Gerrit-Owner: selvanair Gerrit-Reviewer: flichtenheld Gerrit-Reviewer: plaisthos Gerrit-CC: openvpn-devel --sN4CgPS989o= Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable

cron2 upl= oaded patch set #3 to the change originally created by selvanair.<= /p>

Vi= ew Change

The following approvals got outdated and were removed: Code-Review+2 by flichtenheld

DNS server documentation upd=
ate

Github: OpenVPN/openvpn#937

Change-Id: I53b3f4c60897a1f4d= d5efeb6575d525ffb082402
Signed-off-by: Selva Nair <selva.nair@...1354...= ..>
Acked-by: Frank Lichtenheld <frank@...2641...>
Gerrit UR= L: https://gerrit.openvpn.net/c/openvpn/+/1646
Message-Id: <202604301= 63249.13638-1-gert@...1296...>
URL: https://www.mail-archive.com/open= vpn-devel@lists.sourceforge.net/msg36816.html
Signed-off-by: Gert Doerin= g <gert@...1296...>
---
M doc/man-sections/client-options.rst1 file changed, 15 insertions(+), 1 deletion(-)

git pull ssh://gerrit.openvpn.net:29418/openvpn refs/changes/46/1646/3<=
/pre>
-  already configured DNS servers with the same server i=
d.
+ already configu= red DNS servers with the same server id. Only the group of
+ options corresponding to the lowes= t server id is applied.

The ``address`= ` option configures the IPv4 and / or IPv6 address(es) of
= the DNS server. Up to eight addresses can be specified per DNS server.
@@ -249,6 +250,19 @@
so that ``--dns`` ove= rrides ``--dhcp-option``. Thus, ``--dns`` can be used today
to migrate from ``--dhcp-option``.


+ Windows only:
+
+ #. If tap-windows6 is in use, dns servers are set by DHCP = by default.
+ In = this case only ``--dns search-domains`` and ``--dns server n address ..``
+ with the lowest = value of ``n`` are interpreted. All other ``--dns`` options
+ are ignored. Use of the dco dr= iver is the recommended way to make use of these

+ new features.
+
+ #. If ``--dns server n resolve-domains`` is in use, the DNS serv= er addresses
+ co= rresponding to ``n`` are set on the interface only if ``search-domains`` is=
+ also specified= . Otherwise these DNS addresses are used only for NRPT rules for+ split-DNS.
+
--explicit-exit= -notify n
In UDP client mode or point-to-point mode, sen= d server/peer an exit
notification if tunnel is restarte= d or OpenVPN process is exited. In

To v= iew, visit change 1646. To unsubscribe, or for help writing mail filters, visit= settings.

Gerrit-MessageType: newpatchset
Gerrit-Project: openvpn
Gerrit-Branch: master
Gerrit-Change-Id: I53b3f4c60897a1f4dd5efeb6575= d525ffb082402
Gerrit-Change-Number: 1646
Gerrit-PatchSet: 3
Gerrit-Owner: selvanair <selva.nair@...1354...= ..>
Gerrit-Reviewer: flichtenheld <frank@...2716...= 1...>
Gerrit-Reviewer: plaisthos <arne-openvpn@...1186...= .1227...>
Gerrit-CC: openvpn-devel <openvpn-devel@...1484...= ts.sourceforge.net>
= --sN4CgPS989o=--