From patchwork Fri Sep 22 13:48:00 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Frank Lichtenheld X-Patchwork-Id: 3363 Return-Path: Delivered-To: patchwork@openvpn.net Received: by 2002:a05:7301:2697:b0:d7:3b0f:3938 with SMTP id ha23csp3764554dyb; Fri, 22 Sep 2023 06:49:06 -0700 (PDT) X-Google-Smtp-Source: AGHT+IGJPjOj5Vf/uJACRumBX3ZrS9CtVXs5jIICHYncjOG1iDw2oLFlz/3lzt3By2GE7270l/Bx X-Received: by 2002:a05:6a21:3294:b0:111:a0e5:d2b7 with SMTP id yt20-20020a056a21329400b00111a0e5d2b7mr8800224pzb.4.1695390546526; Fri, 22 Sep 2023 06:49:06 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1695390546; cv=none; d=google.com; s=arc-20160816; b=taTGMdJo8lemin70sZLMaj6NvMc34eshLlKg7WQwC1KTE609ASdbkTHYyYVxie3aF3 rV3HHYTLhuYfDpAZcx1F1bsDLoCaDlP4feQegkhJ53QRlRKID5OD9Tb+RSYQ8F0LwK/m cjFiMKRVExuJzQY3t9dPqFXmQypqD0gkXtmIdASYZBHqjfbNVk4h6mWmv75K1Ln+SjXK hKgckdTJAHLPwSaQPyyaiTKPMDWdBwyONx2fPwD9LOBvgMh26KnNOU0w3UrCgWrnntx0 fL8S3quYv6bmOqvKuvWneUgCU44pr7tScQjtSA9oaWbL207pcW9vrGDeyLVM/2QnHyAI EBSQ== 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:references:in-reply-to:message-id:date:to:from :dkim-signature:dkim-signature:dkim-signature; bh=IT76LfFqFnywCiMplwtwQOU6KnxP9Z9qlmTIeqWF38o=; fh=4NbAC/LsuMLI0S0hprUlLSLCiHwg6SCAifhH718Jh0Q=; b=it0bPz2lMnQV+XXCEVuuBZf0MzctGDxwOjYx36eHE4xyLxyYegRy5/P0tMZt5G733d 68lUxHLa7vYx2/a7lmXjpd9kO5F/hapu79MkX0F8xp7Cu8oSAKOr1pgIuUXadJ7+PD3O L1N64FbYPjXGbqAqDdL2XoXLhiTIx9irzMyUoZU5oahru0Mb9/6cq0iTiOiyCVPrWQFQ IORh//IfsUQMWRZdX0AaM//vjNbuBVRW8EN+2fptgMClCY5rmWIJTnagZ6nvWXIoUWCu OpXJU9DoNS9OlxA07hX+Nh9Dw6QWP0rS6hsCGtutS2+AqkrRvpKzwNpnefaWrJuIF1qx Zkhw== ARC-Authentication-Results: i=1; mx.google.com; dkim=neutral (body hash did not verify) header.i=@sourceforge.net header.s=x header.b=jAeZf7Sk; dkim=neutral (body hash did not verify) header.i=@sf.net header.s=x header.b=AJVOZocf; dkim=neutral (body hash did not verify) header.i=@lichtenheld.com header.s=MBO0001 header.b=BM7ctRzU; 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 lists.sourceforge.net (lists.sourceforge.net. [216.105.38.7]) by mx.google.com with ESMTPS id f5-20020a170902ce8500b001c446f12975si4062192plg.447.2023.09.22.06.49.06 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Fri, 22 Sep 2023 06:49:06 -0700 (PDT) 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=jAeZf7Sk; dkim=neutral (body hash did not verify) header.i=@sf.net header.s=x header.b=AJVOZocf; dkim=neutral (body hash did not verify) header.i=@lichtenheld.com header.s=MBO0001 header.b=BM7ctRzU; 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-4.v29.lw.sourceforge.com) by sfs-ml-4.v29.lw.sourceforge.com with esmtp (Exim 4.95) (envelope-from ) id 1qjgVy-0004DW-S3; Fri, 22 Sep 2023 13:48:15 +0000 Received: from [172.30.20.202] (helo=mx.sourceforge.net) by sfs-ml-4.v29.lw.sourceforge.com with esmtps (TLS1.2) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.95) (envelope-from ) id 1qjgVw-0004DP-Se for openvpn-devel@lists.sourceforge.net; Fri, 22 Sep 2023 13:48:14 +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:References: In-Reply-To:Message-Id:Date:Subject:Cc:To:From:Sender:Reply-To:Content-Type: Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender: Resent-To:Resent-Cc:Resent-Message-ID:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=gUFN4hVMVIaK04IwwDED2T+gMvCAyeYNi9j2tOkdKSA=; b=jAeZf7SkvVr+ckgapJV1iUHmce sNrnAelo1jjmLPosXEdCL2+Ev7dvbRmGxp+QIvYFg7XdCd1Df6ACkCBp073pM0gndt/jkH4ajoyXX tdlmEwC9CYa+nL/+5jlBwTkzChwkPeCWAEC+8TymZHZjaAYe3KLJUfWw4MsLMqldvqmc=; DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=sf.net; s=x ; h=Content-Transfer-Encoding:MIME-Version:References:In-Reply-To:Message-Id: Date:Subject:Cc:To:From:Sender:Reply-To:Content-Type:Content-ID: Content-Description:Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc :Resent-Message-ID:List-Id:List-Help:List-Unsubscribe:List-Subscribe: List-Post:List-Owner:List-Archive; bh=gUFN4hVMVIaK04IwwDED2T+gMvCAyeYNi9j2tOkdKSA=; b=AJVOZocfILQFYXaHTsxvrLP5hW ovhoJNGXGcqkxd+5slWA3FFR1K7VXCIEz3wLs/zV582uqwRfV5mSsZkxm4izGZHbNMXa9juWLBrKZ O+LI/GO2+QZmYaJAu63U8xyEhK8W5tHUTkfb2NFBZ4KbkKomqlvhN/ElkWHhFxffcw7I=; Received: from mout-p-201.mailbox.org ([80.241.56.171]) by sfi-mx-2.v28.lw.sourceforge.com with esmtps (TLS1.2:ECDHE-RSA-AES256-GCM-SHA384:256) (Exim 4.95) id 1qjgVv-0007b1-Ta for openvpn-devel@lists.sourceforge.net; Fri, 22 Sep 2023 13:48:13 +0000 Received: from smtp102.mailbox.org (smtp102.mailbox.org [10.196.197.102]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (P-384) server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by mout-p-201.mailbox.org (Postfix) with ESMTPS id 4RsYW7026Lz9sxV; Fri, 22 Sep 2023 15:48:03 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lichtenheld.com; s=MBO0001; t=1695390483; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=gUFN4hVMVIaK04IwwDED2T+gMvCAyeYNi9j2tOkdKSA=; b=BM7ctRzU4J67F4BYRJVqAvzdX2BnYP8+p+WaFrqSGMzxwc4IveacRxtMzzaUqCj6JmfJ0E 8LxapCYpxDQXYYoMc37fCdbTpvEN8x+NWXBLa18F/bbXGb7ClMrQHBZfhxTs9EzyBf9b48 6Dn6Dvh2sXXA5GElc5qJ9ql2N64j6+imVDwf6QcOSVjH2sx8WjSwrKfqP2QNaqhD8CjTjd zr965TFUaSni0e3fZ5WMkFXPO9gkCEvxNttR+TphWBgePKNzDZfp7YS+lC1uqoSNMjY+7i KExRFM/mJiK2AGn7liHeJ/5JYNeiASyPRatC8Xl/2KvSPW8jmJBDSV5NIJqthg== From: Frank Lichtenheld To: openvpn-devel@lists.sourceforge.net Date: Fri, 22 Sep 2023 15:48:00 +0200 Message-Id: <20230922134800.61755-1-frank@lichtenheld.com> In-Reply-To: References: MIME-Version: 1.0 X-Spam-Score: -0.9 (/) X-Spam-Report: Spam detection software, running on the system "util-spamd-2.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: From: Arne Schwabe Explicitly say that the version specified is the one of the peer and not the version we try to emulate. Change-Id: I3bd27a8d34d8cb4896a3b78508b7d16911571543 Acked-by: Frank Lichtenheld Signed-off-by: Arne Schwabe --- 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.171 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_AU Message has a valid DKIM or DK signature from author's domain 0.1 DKIM_SIGNED Message has a DKIM or DK signature, not necessarily valid -0.1 DKIM_VALID Message has at least one valid DKIM or DK signature X-Headers-End: 1qjgVv-0007b1-Ta Subject: [Openvpn-devel] [PATCH] Improve description of compat-mode 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?1777745837794104900?= X-GMAIL-MSGID: =?utf-8?q?1777745837794104900?= From: Arne Schwabe Explicitly say that the version specified is the one of the peer and not the version we try to emulate. Change-Id: I3bd27a8d34d8cb4896a3b78508b7d16911571543 Acked-by: Frank Lichtenheld Signed-off-by: Arne Schwabe --- This change was reviewed on Gerrit and approved by at least one developer. I request to merge it to master. Gerrit URL: https://gerrit.openvpn.net/c/openvpn/+/34 This mail reflects revision 3 of this Change. Acked-by according to Gerrit (reflected above): Frank Lichtenheld diff --git a/doc/man-sections/generic-options.rst b/doc/man-sections/generic-options.rst index c827651..97e1b5a 100644 --- a/doc/man-sections/generic-options.rst +++ b/doc/man-sections/generic-options.rst @@ -53,10 +53,17 @@ need for /dev/urandom to be available. --compat-mode version - This option provides a way to alter the default of OpenVPN to be more - compatible with the version ``version`` specified. All of the changes - this option does can also be achieved using individual configuration - options. + This option provides a convenient way to alter the defaults of OpenVPN + to be more compatible with the version ``version`` specified. All of + the changes this option applies can also be achieved using individual + configuration options. + + The version specified with this option is the version of OpenVPN peer + OpenVPN should try to be compatible with. In general OpenVPN should be + compatible with the last two previous version without this option. E.g. + OpenVPN 2.6.0 should be compatible with 2.5.x and 2.4.x without this option. + However, there might be some edge cases that still require this option even + in these cases. Note: Using this option reverts defaults to no longer recommended values and should be avoided if possible. @@ -67,12 +74,15 @@ - 2.5.x or lower: ``--allow-compression asym`` is automatically added to the configuration if no other compression options are present. - 2.4.x or lower: The cipher in ``--cipher`` is appended to - ``--data-ciphers`` + ``--data-ciphers``. - 2.3.x or lower: ``--data-cipher-fallback`` is automatically added with - the same cipher as ``--cipher`` + the same cipher as ``--cipher``. - 2.3.6 or lower: ``--tls-version-min 1.0`` is added to the configuration when ``--tls-version-min`` is not explicitly set. + If not required, this is option should be avoided. Setting this option can + lower security or disable features like data-channel offloading. + --config file Load additional config options from ``file`` where each line corresponds to one command line option, but with the leading :code:`--` removed.