From: "selvanair (Code Review)" Date: Thu, 30 Apr 2026 14:12:34 +0000 References: Reply-To: selva.nair@...277..., arne-openvpn@...1227..., openvpn-devel@lists.sourceforge.net Message-ID: <763a7dbee0ce5583f95a61a2d3721f91338be000-HTML@...2715...> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Content-Disposition: inline Content-Type: multipart/alternative; boundary="w8dDvDhf7uQ="; 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 Cc: openvpn-devel --w8dDvDhf7uQ= Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Attention is currently required from: plaisthos. Hello plaisthos, I'd like you to do a code review. Please visit http://gerrit.openvpn.net/c/openvpn/+/1646?usp=3Demail to review the following change. 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, 12 insertions(+), 1 deletion(-) git pull ssh://gerrit.openvpn.net:29418/openvpn refs/changes/46/1646/1 diff --git a/doc/man-sections/client-options.rst b/doc/man-sections/client-= options.rst index 1664eed..5df881d 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,16 @@ so that ``--dns`` overrides ``--dhcp-option``. Thus, ``--dns`` can be us= ed today to migrate from ``--dhcp-option``. + Windows only: (i) 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`` opti= ons + are ignored. Use of the dco driver is the recommended way to make use of= these + new features. + (ii) If ``--dns server n resolve-domains`` is in use, the DNS server add= resses + corresponding to ``n`` are set on the interface only if ``search-domains= `` is + also specified. Otherwise these DNS addresses are used only for NRPT ru= les 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: newchange Gerrit-Project: openvpn Gerrit-Branch: master Gerrit-Change-Id: I53b3f4c60897a1f4dd5efeb6575d525ffb082402 Gerrit-Change-Number: 1646 Gerrit-PatchSet: 1 Gerrit-Owner: selvanair Gerrit-Reviewer: plaisthos Gerrit-CC: openvpn-devel Gerrit-Attention: plaisthos --w8dDvDhf7uQ= Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable

Attention is cur= rently required from: plaisthos.

selvanair would like plaisthos to review this change.

V= iew Change

DNS server documentation update

Chan= ge-Id: I53b3f4c60897a1f4dd5efeb6575d525ffb082402
Signed-off-by: Selva Na= ir <selva.nair@...277...>
---
M doc/man-sections/client-options= .rst
1 file changed, 12 insertions(+), 1 deletion(-)

git pull ssh://gerrit.openvpn.net:29418/openvpn refs/changes/46/164=
6/1
diff --git a/doc/man-sections/client-options.rst b/doc/man-sect=
ions/client-options.rst
index 1664eed..5df881d 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 l= ist of configured DNS servers;
lower numbers come first.= DNS servers being pushed to a client replace
- already configured DNS servers with the same serv= er id.
+ already con= figured DNS servers with the same server id. Only the group of
+ options corresponding to the l= owest server id is applied.


The ``addr= ess`` 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,16 @@
so that ``--dns``= overrides ``--dhcp-option``. Thus, ``--dns`` can be used today
<= span> to migrate from ``--dhcp-option``.

+ Windows only: (i) If tap-windows= 6 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 othe= r ``--dns`` options
+= are ignored. Use of the dco driver is the recommended way to make use of = these
+ new features= .
+ (ii) If ``--dns = server n resolve-domains`` is in use, the DNS server addresses
+ corresponding to ``n`` are set= on the interface only if ``search-domains`` is
+ also specified. Otherwise these DNS addresse= s are used only for NRPT rules for
+ split-DNS.
+
--explicit-exit-notify n
In UD= P 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: newchange
Gerrit-Project: openvpn
Gerrit-Branch: master
Gerrit-Change-Id: I53b3f4c60897a1f4dd5efeb6575= d525ffb082402
Gerrit-Change-Number: 1646
Gerrit-PatchSet: 1
Gerrit-Owner: selvanair <selva.nair@...1354...= ..>
Gerrit-Reviewer: plaisthos <arne-openvpn@...1186...= .1227...>
Gerrit-CC: openvpn-devel <openvpn-devel@...1484...= ts.sourceforge.net>
Gerrit-Attention: plaisthos <arne-openvpn@...220...= ..1227...>
= --w8dDvDhf7uQ=--