From: "selvanair (Code Review)" Date: Thu, 30 Apr 2026 15:36:41 +0000 In-Reply-To: References: Reply-To: selva.nair@...277..., arne-openvpn@...1227..., openvpn-devel@lists.sourceforge.net, frank@...2641... Message-ID: <64b442850eea2f35185a1a2efed21a557ddf0277-EmailReplacePatchSet-HTML@...2715...> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Content-Disposition: inline Content-Type: multipart/alternative; boundary="cmIu/E+jQZA="; 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: plaisthos , flichtenheld Cc: openvpn-devel --cmIu/E+jQZA= Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Attention is currently required from: flichtenheld, plaisthos. Hello flichtenheld, plaisthos, I'd like you to reexamine a change. Please visit http://gerrit.openvpn.net/c/openvpn/+/1646?usp=3Demail to look at the new patch set (#2). The following approvals got outdated and were removed: Code-Review-1 by flichtenheld Change subject: DNS server documentation update ...................................................................... DNS server documentation update Change-Id: I53b3f4c60897a1f4dd5efeb6575d525ffb082402 Signed-off-by: Selva Nair --- 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/2 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: 2 Gerrit-Owner: selvanair Gerrit-Reviewer: flichtenheld Gerrit-Reviewer: plaisthos Gerrit-CC: openvpn-devel Gerrit-Attention: plaisthos Gerrit-Attention: flichtenheld --cmIu/E+jQZA= Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable

Attention is cur= rently required from: flichtenheld, plaisthos.

selvanair uploaded patch set #2 to this change.

<= a href=3D"http://gerrit.openvpn.net/c/openvpn/+/1646?usp=3Demail">View Chan= ge

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

DNS server documentation upd=
ate

Change-Id: I53b3f4c60897a1f4dd5efeb6575d525ffb082402
Signed-o= ff-by: Selva Nair <selva.nair@...277...>
---
M doc/man-sections= /client-options.rst
1 file changed, 15 insertions(+), 1 deletion(-)
<= br>
git pull ssh://gerrit.openvpn.net:29418/openvpn refs=
/changes/46/1646/2
diff --git a/doc/man-sections/client-options.rst=
 b/doc/man-sections/client-options.rst
index 1664eed..3ad91= 04 100644
--- a/doc/man-sections/client-options.rst<= br>+++ 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 servers;
lower numb= ers come first. DNS servers being pushed to a client replace
- already configured DNS servers wit= h the same server id.
+ already configured DNS servers with the same server id. Only the group = of
+ options corresp= onding to the lowest server id is applied.

The ``address`` option configures the IPv4 and / or IPv6 address(es) o= f
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 used to= day
to migrate from ``--dhcp-option``.
=
+ Windows only:
+
+ #. If tap-windows6 is in use, dns serve= rs are set by DHCP by default.
+ In this case only ``--dns search-domains`` and ``--dns serv= er n address ..``
+ = with the lowest value of ``n`` are interpreted. All other ``--dns`` opti= ons
+ are ignored= . Use of the dco driver is the recommended way to make use of these<= br>+ new features.+
+ #. If ``--dns server n resolve-domains`` is i= n use, the DNS server addresses
+ corresponding 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, send server/peer an exit
notification if= tunnel is restarted or OpenVPN process is exited. In

To view, 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: 2
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>
Gerrit-Attention: plaisthos <arne-openvpn@...220...= ..1227...>
Gerrit-Attention: flichtenheld <frank@...2375...= 41...>
= --cmIu/E+jQZA=--