From: "cron2 (Code Review)" Date: Wed, 29 Jan 2025 16:52:04 +0000 In-Reply-To: References: Reply-To: gert@...1296..., arne-openvpn@...1227..., openvpn-devel@lists.sourceforge.net, frank@...2641..., a@...2181... Message-ID: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Content-Disposition: inline Content-Type: multipart/alternative; boundary="bpOzOokxiMk="; charset=UTF-8 Subject: [Openvpn-devel] [XS] Change in openvpn[master]: man: extend --persist-tun section List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: plaisthos , flichtenheld Cc: openvpn-devel --bpOzOokxiMk= 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= ordex. ( http://gerrit.openvpn.net/c/openvpn/+/819?usp=3Demail ) The following approvals got outdated and were removed: Code-Review+2 by flichtenheld Change subject: man: extend --persist-tun section ...................................................................... man: extend --persist-tun section The current persist-tun section has no mention of retaining IP/routes and its potential usage in traffic leaking protection. Spell this out to allow the user to better understand when this option can play an important role. Change-Id: I6816f61b308ca9f6d1f9f687a6dc8e0aa2d044e0 Signed-off-by: Antonio Quartulli Acked-by: Frank Lichtenheld Message-Id: <20250129094125.13420-1-gert@...1296...> URL: https://www.mail-archive.com/openvpn-devel@lists.sourceforge.net/msg30= 684.html Signed-off-by: Gert Doering --- M doc/man-sections/vpn-network-options.rst 1 file changed, 9 insertions(+), 0 deletions(-) git pull ssh://gerrit.openvpn.net:29418/openvpn refs/changes/19/819/3 diff --git a/doc/man-sections/vpn-network-options.rst b/doc/man-sections/vp= n-network-options.rst index fc76939..67f7e1f 100644 --- a/doc/man-sections/vpn-network-options.rst +++ b/doc/man-sections/vpn-network-options.rst @@ -312,6 +312,15 @@ :code:`SIGUSR1` is a restart signal similar to :code:`SIGHUP`, but which offers finer-grained control over reset options. + On Linux, this option can be useful when OpenVPN is not executed as + root and the CAP_NET_ADMIN has not been granted, because the process + would otherwise not be allowed to bring the interface down and back up. + + Alongside the above, using ``--persist-tun`` allows the tunnel interface + to retain all IP/route settings, thus allowing the user to implement + any advanced traffic leaking protection (please note that for full + protection, extra route/firewall rules must be in place). + --redirect-gateway flags Automatically execute routing commands to cause all outgoing IP traffic to be redirected over the VPN. This is a client-side option. -- To view, visit http://gerrit.openvpn.net/c/openvpn/+/819?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: I6816f61b308ca9f6d1f9f687a6dc8e0aa2d044e0 Gerrit-Change-Number: 819 Gerrit-PatchSet: 3 Gerrit-Owner: ordex Gerrit-Reviewer: flichtenheld Gerrit-Reviewer: plaisthos Gerrit-CC: openvpn-devel Gerrit-MessageType: newpatchset --bpOzOokxiMk= Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable

cron2 uploaded patch set #3 to the change originally cr= eated by ordex.

View Change

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

man: extend --persist-tun section

The = current persist-tun section has no mention of
retaining IP/routes and it= s potential usage in traffic
leaking protection.

Spell this out t= o allow the user to better understand
when this option can play an impor= tant role.

Change-Id: I6816f61b308ca9f6d1f9f687a6dc8e0aa2d044e0
S= igned-off-by: Antonio Quartulli <antonio@...2726...>
Acked-by: Fra= nk Lichtenheld <frank@...2641...>
Message-Id: <20250129094125.1= 3420-1-gert@...1296...>
URL: https://www.mail-archive.com/openvpn-dev= el@lists.sourceforge.net/msg30684.html
Signed-off-by: Gert Doering <g= ert@...1296...>
---
M doc/man-sections/vpn-network-options.rst
= 1 file changed, 9 insertions(+), 0 deletions(-)

git pull ssh://ge=
rrit.openvpn.net:29418/openvpn refs/changes/19/819/3
diff --git a/d=
oc/man-sections/vpn-network-options.rst b/doc/man-sections/vpn-network-opti=
ons.rst
index fc76939..67f7e1f 100644
--- a= /doc/man-sections/vpn-network-options.rst
+++ b/doc/man-sec= tions/vpn-network-options.rst
@@ -312,6 +312,15 @@ :code:`SIGUSR1` is a restart signal similar to :code:`SIGHUP`, b= ut which
offers finer-grained control over reset options= .

+= On Linux, this option can be useful when OpenVPN is not executed as
+ root and the CAP_NET_AD= MIN has not been granted, because the process
+ would otherwise not be allowed to bring the int= erface down and back up.
+
+ Alongside th= e above, using ``--persist-tun`` allows the tunnel interface
+ to retain all IP/route settings,= thus allowing the user to implement

+ any advanced traffic leaking protection (please note tha= t for full
+ protect= ion, extra route/firewall rules must be in place).
+
--redirect-gateway flags
Automatically execute routing commands to cause all outgo= ing IP traffic
to be redirected over the VPN. This is a = client-side option.

To view, visit change 819. To unsubscribe, or for help writing mail filters, visit settings.

Gerrit-Project: openvpn
Gerrit-Branch: master
Gerrit-Change-Id: I6816f61b308ca9f6d1f9f687a6d= c8e0aa2d044e0
Gerrit-Change-Number: 819
Gerrit-PatchSet: 3
Gerrit-Owner: ordex <a@...2181...>
Gerrit-Reviewer: flichtenheld <frank@...2716...= 1...>
Gerrit-Reviewer: plaisthos <arne-openvpn@...1186...= .1227...>
Gerrit-CC: openvpn-devel <openvpn-devel@...1484...= ts.sourceforge.net>
Gerrit-MessageType: newpatchset
--bpOzOokxiMk=--