From: "ordex (Code Review)" Date: Wed, 16 Jul 2025 13:42:52 +0000 In-Reply-To: References: Reply-To: antonio@...2726..., arne-openvpn@...1227..., openvpn-devel@lists.sourceforge.net, frank@...2641... Message-ID: <4a273fadba18535a50f05662e45b31d420b2efc7-EmailReplacePatchSet-HTML@...2715...> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Content-Disposition: inline Content-Type: multipart/alternative; boundary="6z0xsIgziTY="; charset=UTF-8 Subject: [Openvpn-devel] [S] Change in openvpn[master]: README.dco: update Linux instructions List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: plaisthos , flichtenheld Cc: openvpn-devel --6z0xsIgziTY= Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Attention is currently required from: flichtenheld, ordex, plaisthos. Hello flichtenheld, plaisthos, I'd like you to reexamine a change. Please visit http://gerrit.openvpn.net/c/openvpn/+/1087?usp=3Demail to look at the new patch set (#3). The following approvals got outdated and were removed: Code-Review+2 by flichtenheld The change is no longer submittable: Code-Review and checks~ChecksSubmitRul= e are unsatisfied now. Change subject: README.dco: update Linux instructions ...................................................................... README.dco: update Linux instructions Update the README.dco file by including instructions related to the new 'ovpn' linux kernel module. Change-Id: I22af9957b27785514d8c6d58fe4f2100d007fa5c Signed-off-by: Antonio Quartulli --- M README.dco.md 1 file changed, 14 insertions(+), 19 deletions(-) git pull ssh://gerrit.openvpn.net:29418/openvpn refs/changes/87/1087/3 diff --git a/README.dco.md b/README.dco.md index 3f7e00c..a93dc94 100644 --- a/README.dco.md +++ b/README.dco.md @@ -14,26 +14,22 @@ Getting started (Linux) ----------------------- -- Use a recent Linux kernel. Linux 5.4.0 and newer are known to work with - ovpn-dco. +The new DCO linux kernel module (namely `ovpn`) has been merged upstream +as of linux-6.16. From this kernel version onwards you directly get +the DCO module as shipped by your kernel. +NOTE: the new `ovpn` Linux kernel module is compatible only with OpenVPN +2.7 and greater. -Get the ovpn-dco module from one these urls and build it: +Alternatively, if you run an older kernel or if you want to use a more +recent DCO module than the one shipped by your kernel, you need to use +the ovpn-backports project. -* https://gitlab.com/openvpn/ovpn-dco -* https://github.com/OpenVPN/ovpn-dco +To learn how to use the ovpn-backports project and build your own DCO +kernel module, please refer to the README file available at: -e.g. + https://github.com/OpenVPN/ovpn-backports/blob/main/README.md - git clone https://github.com/OpenVPN/ovpn-dco - cd ovpn-dco - make - sudo make install - -If you want to report bugs please ensure to compile ovpn-dco with -`make DEBUG=3D1` and include any debug message being printed by the -kernel (you can view those messages with `dmesg`). - -Clone and build OpenVPN (or use OpenVPN 2.6+). For example: +Then clone and build OpenVPN (or use OpenVPN 2.7+). For example: git clone https://github.com/openvpn/openvpn.git cd openvpn @@ -48,8 +44,8 @@ data channel offloading, OpenVPN will automatically disable DCO support and warn the user. -Should OpenVPN be configured to use a feature that is not supported by ovp= n-dco -or should the ovpn-dco kernel module not be available on the system, you w= ill +Should OpenVPN be configured to use a feature that is not supported by ovpn +or should the ovpn kernel module not be available on the system, you will see a message like Note: Kernel support for ovpn-dco missing, disabling data channel offl= oad. @@ -131,4 +127,3 @@ - `--persist-tun` not tested; - IPv6 mapped IPv4 addresses need Linux 5.4.189+/5.10.110+/5.12+ to work; - some incompatible options may not properly fallback to non-dco; -- no per client statistics. Only total statistics available on the interfa= ce. -- To view, visit http://gerrit.openvpn.net/c/openvpn/+/1087?usp=3Demail To unsubscribe, or for help writing mail filters, visit http://gerrit.openv= pn.net/settings Gerrit-Project: openvpn Gerrit-Branch: master Gerrit-Change-Id: I22af9957b27785514d8c6d58fe4f2100d007fa5c Gerrit-Change-Number: 1087 Gerrit-PatchSet: 3 Gerrit-Owner: ordex Gerrit-Reviewer: flichtenheld Gerrit-Reviewer: plaisthos Gerrit-CC: openvpn-devel Gerrit-Attention: plaisthos Gerrit-Attention: flichtenheld Gerrit-Attention: ordex Gerrit-MessageType: newpatchset --6z0xsIgziTY= Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable

Attention is currently required from: flichtenheld, ordex, plaisthos. <= /p>

ordex uploaded patch set #3 to this change.

View Change

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

The change is no longer submittable: Co= de-Review and checks~ChecksSubmitRule are unsatisfied now.

README.dco: upda=
te Linux instructions

Update the README.dco file by including instru= ctions related
to the new 'ovpn' linux kernel module.

Cha= nge-Id: I22af9957b27785514d8c6d58fe4f2100d007fa5c
Signed-off-by: Antonio= Quartulli <antonio@...2726...>
---
M README.dco.md
1 file c= hanged, 14 insertions(+), 19 deletions(-)

git pull ssh://gerrit.o=
penvpn.net:29418/openvpn refs/changes/87/1087/3
diff --git a/README=
.dco.md b/README.dco.md
index 3f7e00c..a93dc94 100644
--- a/README.dco.md
+++ b/README.dco.md@@ -14,26 +14,22 @@

Getting star= ted (Linux)
-----------------------
-- Use a recent Linux kernel. Linux 5.4.0 an= d newer are known to work with
- ovpn-dco.
= +The new DCO linux kernel module (namely `ovpn`) has been merged upstream
+as of linux-6.16. Fro= m this kernel version onwards you directly get
+the DCO module as shipped by your kernel.=
+NOTE: the new `ovpn` Linux= kernel module is compatible only with OpenVPN
+2.7 and greater.

-Get the ovpn-dco module from one th= ese urls and build it:

+recent DCO module tha= n the one shipped by your kernel, you need to use
+the ovpn-backports project.
=
-* https://gitlab.com/= openvpn/ovpn-dco
-* htt= ps://github.com/OpenVPN/ovpn-dco
+To learn how to use the ovpn-backports project and build your = own DCO
+kernel modul= e, please refer to the README file available at:
-e.g.
+ https://github.com/OpenVPN/ovpn-backports/b= lob/main/README.md

- git clone https://github.com/OpenVPN/ovpn-dco
= - cd ovpn-dco
- make
- sudo make install
-
-`make DEBUG=3D1` and include= any debug message being printed by the
-kernel (you can view those messages with `dmesg`).=
-
-Clone and build OpenVPN (or use OpenVPN 2.6+). Fo= r example:
+Then clon= e and build OpenVPN (or use OpenVPN 2.7+). For example:

git clone https://github.com/openvpn/openvpn.git=
cd openvpn
@@ -48,8 +44,8 @@
data channel offloading, OpenVPN will automatically disable DCO support a= nd

warn the user.

-Should OpenVPN be configured to use a featu= re that is not supported by ovpn-dco
-or should the ovpn-dco kernel module not be available on the= system, you will
+Sh= ould OpenVPN be configured to use a feature that is not supported by ovpn
+or should the ovpn ke= rnel module not be available on the system, you will
see a= message like

Note: Kernel support f= or ovpn-dco missing, disabling data channel offload.
@@ -13= 1,4 +127,3 @@
- `--persist-tun` not tested;
- IPv6 mapped IPv4 addresses need Linux 5.4.189+/5.10.110+/5.12+ to work= ;

- some incompatible options may not properly fallback to= non-dco;
-- no per cli= ent statistics. Only total statistics available on the interface.

To view, visit change 1087. To unsubscribe, or for h= elp writing mail filters, visit settings.

=
Gerrit-Project: openvpn
Gerrit-Branch: master
Gerrit-Change-Id: I22af9957b27785514d8c6d58fe4= f2100d007fa5c
Gerrit-Change-Number: 1087
Gerrit-PatchSet: 3
Gerrit-Owner: ordex <antonio@...2726...>=
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...>
Gerrit-Attention: ordex <antonio@...2726...= >
Gerrit-MessageType: newpatchset
--6z0xsIgziTY=--