From: "cron2 (Code Review)" Date: Thu, 7 May 2026 07:44:55 +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="5TY6GW4IA6U="; 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 Cc: flichtenheld , plaisthos , openvpn-devel --5TY6GW4IA6U= Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable cron2 has submitted this change. ( http://gerrit.openvpn.net/c/openvpn/+/16= 46?usp=3Demail ) 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(-) 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: merged 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 --5TY6GW4IA6U= Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable

cron2 sub= mitted this change.

View Change

DNS server documentation update

Github: O= penVPN/openvpn#937

Change-Id: I53b3f4c60897a1f4dd5efeb6575d525ffb082= 402
Signed-off-by: Selva Nair <selva.nair@...277...>
Acked-by: = Frank Lichtenheld <frank@...2641...>
Gerrit URL: https://gerrit.op= envpn.net/c/openvpn/+/1646
Message-Id: <20260430163249.13638-1-gert@...220...= ..1296...>
URL: https://www.mail-archive.com/openvpn-devel@...1439...= ceforge.net/msg36816.html
Signed-off-by: Gert Doering <gert@...2132...= .>
---
M doc/man-sections/client-options.rst
1 file changed, 15= insertions(+), 1 deletion(-)

diff --git a/doc/man-sections/client-options.rst b/doc/man-sections/clie=
nt-options.rst
index 1664eed..3ad9104 100644
--- a/doc/man-sections/client-options.rst
+++ b/doc/man-s= ections/client-options.rst
@@ -216,7 +216,8 @@
DNS server options it must be between 0 and 127. The server id is us= ed
to group options and also for ordering the list of co= nfigured DNS servers;
lower numbers come first. DNS serv= ers being pushed to a client replace
- already configured DNS servers with the same server id.

+ already configured D= NS servers with the same server id. Only the group of
+ options corresponding to the lowest ser= ver id is applied.

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

+ Windows only:
+
+ #. If tap-windows6 is in use, dns servers are set by DHCP by d= efault.
+ In this= case only ``--dns search-domains`` and ``--dns server n address ..``
+ with the lowest valu= e of ``n`` are interpreted. All other ``--dns`` options
+ 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 a= ddresses
+ corres= ponding to ``n`` are set on the interface only if ``search-domains`` is

+ also specified. O= therwise these DNS addresses are used only for NRPT rules for
+ split-DNS.
+
--explicit-exit-not= ify n
In UDP client mode or point-to-point mode, send se= rver/peer an exit
notification if tunnel is restarted or= OpenVPN process is exited. In

To view,= visit c= hange 1646. To unsubscribe, or for help writing mail filters, visit settings.

<= meta itemprop=3D"name" content=3D"View Change"/>
Gerrit-MessageType: merged
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>
= --5TY6GW4IA6U=--