From: "cron2 (Code Review)" Date: Wed, 29 Jan 2025 16:52:08 +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="+zT0X/M6Odg="; 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: , Cc: flichtenheld , plaisthos , openvpn-devel --+zT0X/M6Odg= Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable cron2 has submitted this change. ( http://gerrit.openvpn.net/c/openvpn/+/81= 9?usp=3Demail ) 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(-) 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: merged --+zT0X/M6Odg= Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable

cron2 submitted this change.

View Change

man: extend --persist-tun section

The c= urrent 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 import= ant role.

Change-Id: I6816f61b308ca9f6d1f9f687a6dc8e0aa2d044e0
Si= gned-off-by: Antonio Quartulli <antonio@...2726...>
Acked-by: Fran= k Lichtenheld <frank@...2641...>
Message-Id: <20250129094125.13= 420-1-gert@...1296...>
URL: https://www.mail-archive.com/openvpn-deve= l@lists.sourceforge.net/msg30684.html
Signed-off-by: Gert Doering <ge= rt@...1296...>
---
M doc/man-sections/vpn-network-options.rst
1= file changed, 9 insertions(+), 0 deletions(-)

diff --git a/doc/man-sections/vpn-network-options.rst b/doc/man-sections=
/vpn-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 +3= 12,15 @@
:code:`SIGUSR1` is a restart signal similar to = :code:`SIGHUP`, but which
offers finer-grained control o= ver reset options.

+ On Linux, this option can be useful when OpenVPN is not = executed as
+ root a= nd the CAP_NET_ADMIN has not been granted, because the process
+ would otherwise not be allowed= to bring the interface down and back up.

+
+ to retain all I= P/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).<= br>+
--redirec= t-gateway flags
Automatically execute routing commands t= o cause all outgoing IP traffic
to be redirected over th= e 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: merged
--+zT0X/M6Odg=--