From patchwork Tue Feb 6 17:47:45 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Frank Lichtenheld X-Patchwork-Id: 3604 Return-Path: Delivered-To: patchwork@openvpn.net Received: by 2002:a05:7000:e883:b0:554:adf7:68e6 with SMTP id oz3csp674893mab; Tue, 6 Feb 2024 09:48:23 -0800 (PST) X-Forwarded-Encrypted: i=2; AJvYcCVH+qFUwSsifaP2j/xjZpEfcp3S2jjbrbt+hn6VnZnKpHqJrMV66/grv05cVNpojkPxHlJPNxCM2Jms5nd55BJ28ApVWOI= X-Google-Smtp-Source: AGHT+IGSJRIdn+E8Pt2NxfSmd+FdDiGI4YwiW6pXZakFMWDAGGgWLaPr+LuMIUYvGk5GLSdR8jGg X-Received: by 2002:a05:6a21:19a:b0:19e:4007:46a7 with SMTP id le26-20020a056a21019a00b0019e400746a7mr3725753pzb.1.1707241703438; Tue, 06 Feb 2024 09:48:23 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1707241703; cv=none; d=google.com; s=arc-20160816; b=qul2gW5lXKD4ETTqtChkyp0ffHsu1Pkosnz/I0e90cFqMxSrNENshu/em+UyuBVgpO VCWxdmbcIKp7NrWDyX8SOkezibE3cWb459xYEBSKIU6B6i+a3zd12OMfe1IJwElajuuh 1ULw4UkxzY1DnWhyQXk4n5xzaE1TQtValzspGVlEoo/AMTu5KAOpFJxyNoHWFjQoYbl1 pfNEOwvEOqwI5TnNPpNgCg5g6KyseiwtSg+HlRO81xCguB7c4UkhIiFDJ2p8jxkrO6as N5k1Ns7ER25LTWKqw2xRQ6DTC9jAR2MsszeJyC6+o/Ad0HIT8KDbFmJmStvn47oUtcBU uPkw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=errors-to:content-transfer-encoding:list-subscribe:list-help :list-post:list-archive:list-unsubscribe:list-id:precedence:subject :mime-version:message-id:date:to:from:dkim-signature:dkim-signature :dkim-signature; bh=+ydRAxyhqjgRo5RjyFEZUXpf476AptrMD6cp/C5ByQ0=; fh=YQBaL4pRIvbeHI4Wg86oLJK08eqhKv+jgaL54GxuZ/U=; b=KjyVVzunCgIAHCpyesyRrj1JorNgwdhHwIVtxqqY8cu2Fd+Jxt7HF/C408yBK98+aV DbtqwJRDo+YDh8ZF0GdRjCbRs7SNocAT5Z1tccFUuSH8cVyaVJd6W7qKmG6UudlkIsuY 07mr7bhnbwFCF5SyoebgTFtCA/BrERilT8CIz1hfd+PBOg9TGORgsG8jAtEtTBntLlwj ATeQLBSp8Pyw7i2vgRGzxliuunnkyH7acPLux8OfA+8611s0jwEonXHOCHJFNQTTzXYO kHWgSpRwC+hWTS4ITNWOXQDBu7ejyEiW0K/VQG5yxayXiMoo+vDTXJ1Oi0CIzZsmF/TC a+IA==; darn=openvpn.net ARC-Authentication-Results: i=1; mx.google.com; dkim=neutral (body hash did not verify) header.i=@sourceforge.net header.s=x header.b=Yh+uZakZ; dkim=neutral (body hash did not verify) header.i=@sf.net header.s=x header.b=lhkDCvgF; dkim=neutral (body hash did not verify) header.i=@lichtenheld.com header.s=MBO0001 header.b=txNwDBjB; spf=pass (google.com: domain of openvpn-devel-bounces@lists.sourceforge.net designates 216.105.38.7 as permitted sender) smtp.mailfrom=openvpn-devel-bounces@lists.sourceforge.net X-Forwarded-Encrypted: i=0; AJvYcCUUd8dFAF1eA72wT5OFUwHgtC23eci9sXPRhLPuWwUzgNZdO8hbiLGKNJKwbusDM1Gju5uwTC20rqI5LSb31QMxdY68l40wxSID0wvfylSXxDDum8OdRb38HrJF4EzyKLmK1KN/n+CHmRZbs+MoxtnsxnpuJww= Received: from lists.sourceforge.net (lists.sourceforge.net. [216.105.38.7]) by mx.google.com with ESMTPS id x29-20020a056a00189d00b006e037bcaac3si1962380pfh.8.2024.02.06.09.48.23 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Tue, 06 Feb 2024 09:48:23 -0800 (PST) Received-SPF: pass (google.com: domain of openvpn-devel-bounces@lists.sourceforge.net designates 216.105.38.7 as permitted sender) client-ip=216.105.38.7; Authentication-Results: mx.google.com; dkim=neutral (body hash did not verify) header.i=@sourceforge.net header.s=x header.b=Yh+uZakZ; dkim=neutral (body hash did not verify) header.i=@sf.net header.s=x header.b=lhkDCvgF; dkim=neutral (body hash did not verify) header.i=@lichtenheld.com header.s=MBO0001 header.b=txNwDBjB; spf=pass (google.com: domain of openvpn-devel-bounces@lists.sourceforge.net designates 216.105.38.7 as permitted sender) smtp.mailfrom=openvpn-devel-bounces@lists.sourceforge.net Received: from [127.0.0.1] (helo=sfs-ml-3.v29.lw.sourceforge.com) by sfs-ml-3.v29.lw.sourceforge.com with esmtp (Exim 4.95) (envelope-from ) id 1rXPY5-0001zV-H5; Tue, 06 Feb 2024 17:47:58 +0000 Received: from [172.30.20.202] (helo=mx.sourceforge.net) by sfs-ml-3.v29.lw.sourceforge.com with esmtps (TLS1.2) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.95) (envelope-from ) id 1rXPY3-0001zK-Dx for openvpn-devel@lists.sourceforge.net; Tue, 06 Feb 2024 17:47:56 +0000 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=sourceforge.net; s=x; h=Content-Transfer-Encoding:MIME-Version:Message-Id: Date:Subject:To:From:Sender:Reply-To:Cc:Content-Type:Content-ID: Content-Description:Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc :Resent-Message-ID:In-Reply-To:References:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=WKzsNy9YHuK69IxCtpbo6WfaY/OySbGg61Oc3EOfsbU=; b=Yh+uZakZ7TfPu3udNu1kn1/Zzg kAYZ38xAJ+0xPkY2dcjSp0k9tY2Pdt8lZG/aATq3BOpLbhJqXx+YEpP3/nxXrPTcuynqtnvWN/56o wMcWa5UZ3/rLOXSbpQ5jTFaiwHUaQDeHiif6+ROIQWeXCFTa8pK8gdgSECvwO5f3enJE=; DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=sf.net; s=x ; h=Content-Transfer-Encoding:MIME-Version:Message-Id:Date:Subject:To:From: Sender:Reply-To:Cc:Content-Type:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:In-Reply-To: References:List-Id:List-Help:List-Unsubscribe:List-Subscribe:List-Post: List-Owner:List-Archive; bh=WKzsNy9YHuK69IxCtpbo6WfaY/OySbGg61Oc3EOfsbU=; b=l hkDCvgFxGn/ad3CQoR9KLM1HTak0UgVPTR8D2M+NehN2W8jpBJ257G3A++JDAZq9pc8o+e0KacNrk IoKbaUthcLIE7/Mi4FiV4KBAzEG6JaEn3dOgM1VY+D6qC6QffUFyeeG4D9hW3+smLz0zUpxDHnm61 3ad7Qp4lqbu6T59Q=; Received: from mout-p-202.mailbox.org ([80.241.56.172]) by sfi-mx-2.v28.lw.sourceforge.com with esmtps (TLS1.2:ECDHE-RSA-AES256-GCM-SHA384:256) (Exim 4.95) id 1rXPY1-00079C-Mh for openvpn-devel@lists.sourceforge.net; Tue, 06 Feb 2024 17:47:55 +0000 Received: from smtp102.mailbox.org (smtp102.mailbox.org [IPv6:2001:67c:2050:b231:465::102]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by mout-p-202.mailbox.org (Postfix) with ESMTPS id 4TTrLT6yJyz9sck for ; Tue, 6 Feb 2024 18:47:45 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lichtenheld.com; s=MBO0001; t=1707241665; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding; bh=WKzsNy9YHuK69IxCtpbo6WfaY/OySbGg61Oc3EOfsbU=; b=txNwDBjBaIYtFMoIl29Gut5kgkcaeJkpQlkbUVLU2nm5Do4j6/vR1mDXMG3S8fzFHVG3ck ae+VSN6hlSah21/RkZQIDFixGelVdytvLGtdsDQukqcP3r5rOJyjElh0Z6eLL3XLUzxKsu eFbK6x6vLsJNeU4fz9Q8LdMsVEDL7ts4fzKDZARKi9KgudqxwWeaQoibYH2PrQPC2ksY4v G14WEZ52m9ohLhTszTcjOXt90/8etcCIAh3H5FySgH9+i4ux80zx2klTNClP/HOd/UcpAC yItUHOZWVhIYdYgsnvwylphZ169PrElfql6qbC/U036gCcA4RSY8/vZxwe0EIQ== From: Frank Lichtenheld To: openvpn-devel@lists.sourceforge.net Date: Tue, 6 Feb 2024 18:47:45 +0100 Message-Id: <20240206174745.74828-1-frank@lichtenheld.com> MIME-Version: 1.0 X-Rspamd-Queue-Id: 4TTrLT6yJyz9sck X-Spam-Score: -0.9 (/) X-Spam-Report: Spam detection software, running on the system "util-spamd-1.v13.lw.sourceforge.com", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see the administrator of that system for details. Content preview: - Clarify compression IV_ settings - Clarify which settings might come from --setenv Change-Id: Id8615515c8df6e38e931e357396811234faad796 Signed-off-by: Frank Lichtenheld --- doc/man-sections/client-options.rst | 13 +++++++++---- 1 file changed, 9 insertions(+) [...] Content analysis details: (-0.9 points, 6.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -0.7 RCVD_IN_DNSWL_LOW RBL: Sender listed at https://www.dnswl.org/, low trust [80.241.56.172 listed in list.dnswl.org] -0.0 SPF_PASS SPF: sender matches SPF record 0.0 SPF_HELO_NONE SPF: HELO does not publish an SPF Record -0.1 DKIM_VALID_EF Message has a valid DKIM or DK signature from envelope-from domain -0.1 DKIM_VALID Message has at least one valid DKIM or DK signature 0.1 DKIM_SIGNED Message has a DKIM or DK signature, not necessarily valid -0.1 DKIM_VALID_AU Message has a valid DKIM or DK signature from author's domain -0.0 T_SCC_BODY_TEXT_LINE No description available. X-Headers-End: 1rXPY1-00079C-Mh Subject: [Openvpn-devel] [PATCH] documentation: Fixes for previous fixes to --push-peer-info X-BeenThere: openvpn-devel@lists.sourceforge.net X-Mailman-Version: 2.1.21 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: openvpn-devel-bounces@lists.sourceforge.net X-getmail-retrieved-from-mailbox: Inbox X-GMAIL-THRID: =?utf-8?q?1790172676148004605?= X-GMAIL-MSGID: =?utf-8?q?1790172676148004605?= - Clarify compression IV_ settings - Clarify which settings might come from --setenv Change-Id: Id8615515c8df6e38e931e357396811234faad796 Signed-off-by: Frank Lichtenheld Acked-By: Arne Schwabe --- doc/man-sections/client-options.rst | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) For master and release/2.6 diff --git a/doc/man-sections/client-options.rst b/doc/man-sections/client-options.rst index cd3e565f..b92b1a46 100644 --- a/doc/man-sections/client-options.rst +++ b/doc/man-sections/client-options.rst @@ -374,10 +374,11 @@ configuration. :code:`IV_GUI_VER= ` The UI version of a UI if one is running, for example :code:`de.blinkt.openvpn 0.5.47` for the Android app. + This may be set by the client UI/GUI using ``--setenv``. :code:`IV_SSO=[crtext,][openurl,][proxy_url]` Additional authentication methods supported by the client. - This may be set by the client UI/GUI using ``--setenv`` + This may be set by the client UI/GUI using ``--setenv``. The following flags depend on which compression formats are compiled in and whether compression is allowed by options. See `Protocol options`_ @@ -388,13 +389,15 @@ configuration. :code:`IV_LZO_STUB=1` If client was built with LZO stub capability. This is only sent if - ``IV_LZO=1`` is not sent. + ``IV_LZO=1`` is not sent. This means the client can talk to a server + configured with ``--comp-lzo no``. :code:`IV_LZ4=1` and :code:`IV_LZ4v2=1` If the client supports LZ4 compression. :code:`IV_COMP_STUB=1` and :code:`IV_COMP_STUBv2=1` - If the client supports stub compression. + If the client supports stub compression. This means the client can talk + to a server configured with ``--compress``. When ``--push-peer-info`` is enabled the additional information consists of the following data: @@ -414,7 +417,9 @@ configuration. :code:`IV_PLAT_VER=x.y` The version of the operating system, e.g. 6.1 for Windows 7. - This is only sent on Windows operating systems. + This may be set by the client UI/GUI using ``--setenv``. + On Windows systems it is automatically determined by openvpn + itself. :code:`UV_=` Client environment variables whose names start with