From patchwork Mon Mar 20 16:55:38 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Arne Schwabe X-Patchwork-Id: 3141 Return-Path: Delivered-To: patchwork@openvpn.net Received: by 2002:a05:7300:2310:b0:9f:bfa4:120f with SMTP id r16csp1761770dye; Mon, 20 Mar 2023 09:56:48 -0700 (PDT) X-Google-Smtp-Source: AK7set9cb4S91LKgAqH2d+nVjJT3NFyTNZLJkfCUi73tOhfdZ9JKlyJdJLalffCnJLL0rB6+I0o0 X-Received: by 2002:a17:90b:3892:b0:23d:4ffc:43e with SMTP id mu18-20020a17090b389200b0023d4ffc043emr18783457pjb.38.1679331408699; Mon, 20 Mar 2023 09:56:48 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1679331408; cv=none; d=google.com; s=arc-20160816; b=XuoInGfllmxr5E0a3i9pEbGmXfTj7tsuXRPTl6R3S4GvUF+JXLMCGEska1cKruS0LU 8CUwWsihAIf3XSK1T73SDr5VF/1PVew8HFsZyGEteTlMY4DZ/9j5+KmE/KKx/9cTL2rl 4NWhRK6p58kTL+hsgYOJi+/hWcPDGQgq5je04ItNLfOBJ/g19eUBqdU94VJV74vdec5G 5+cOBmX3gwhgUKT/ANRQZy28g65Acu3dD2ETgU/HVjZgspRFc3XMF3RGeWK/+KaCtExE 7Z55LqpHmpW9AkYIUZGeP3nf4aYf2pCSvIYEzYGSvBCmlGP61hh4WUpel7iir7JaY4yH XV5A== 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; bh=zkn//eQqNacT+BwM8v/GNkF/i+0wwJCWbUifGTv6ot4=; b=0px3oKQxf2Ys1cyX9e1FEbdr4+VO8nvG829liL1QZG22uEn+lcwa+7Tgi3PZDJpcQm 77qyc4CSPVTfjgRsJWd6qKXbVqWkeWFmFzCim/0qWKe3ARRTWwxCSkp+fM4rcrhRGIvO hQolBjkr2g7MPtJYuA4qCdmhaF99ZwWbbv/SqckMkmDaxUgFB5UT9ZMulJS+HjPWOSlf r17AUIrEuBPqTGVvwrQ5hW67bntQLciqxVxXWNy/LLvmBIQvY7F1GqFBH12neYGSrdFU O82QSWdMKNBv9vRpFiw3/txZxJMM7fLsIXLn87g+l8pegiKKEzwMTEeREg7kAGwzzQQP Ha3A== ARC-Authentication-Results: i=1; mx.google.com; dkim=neutral (body hash did not verify) header.i=@sourceforge.net header.s=x header.b=ecDJ1irz; dkim=neutral (body hash did not verify) header.i=@sf.net header.s=x header.b=cDYVdqV8; 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 lr13-20020a17090b4b8d00b0023d2d9e0483si13036930pjb.109.2023.03.20.09.56.48 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Mon, 20 Mar 2023 09:56:48 -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=ecDJ1irz; dkim=neutral (body hash did not verify) header.i=@sf.net header.s=x header.b=cDYVdqV8; 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-1.v29.lw.sourceforge.com) by sfs-ml-1.v29.lw.sourceforge.com with esmtp (Exim 4.95) (envelope-from ) id 1peIne-000871-Nu; Mon, 20 Mar 2023 16:55:59 +0000 Received: from [172.30.20.202] (helo=mx.sourceforge.net) by sfs-ml-1.v29.lw.sourceforge.com with esmtps (TLS1.2) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.95) (envelope-from ) id 1peInc-00086h-As for openvpn-devel@lists.sourceforge.net; Mon, 20 Mar 2023 16:55: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:References: In-Reply-To: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:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=+UuTBh5RKaeXDj4JTc2GvB5DAR8h+Y14gND9SyVowKs=; b=ecDJ1irzs/7ElLIYyVwCeOsVYd 95U1WFum7s1cf0PRjmIEWM7JcphQPMvU8K1OXvkEXRoTvu+xM/y7kzRFHcm0JaYpF7BMBy6mFYJuA CBFKsTraDVm+u3RSWAlgqB1xmgqpD7LU6d5vB9eGM46yNfdo3kBMEZY+1sdRhAJwP5BU=; 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: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:List-Id:List-Help:List-Unsubscribe:List-Subscribe: List-Post:List-Owner:List-Archive; bh=+UuTBh5RKaeXDj4JTc2GvB5DAR8h+Y14gND9SyVowKs=; b=cDYVdqV8frRvskTZArQl8dGcru 1Xgqeii3zwFWOxSe4gH1rE+0ylnNVifkM0N+QlFEjHlYY3lzTeoYaciX0YjyRDBqY1wRgMO2iOPgR b3RM+YE1eMDb9Z/do0Z0/yBv0te4j5Msm1OaG1MsGPHEmfkDffFFbHfIkyvxcntSFFbc=; Received: from mail.blinkt.de ([192.26.174.232]) by sfi-mx-1.v28.lw.sourceforge.com with esmtps (TLS1.2:ECDHE-RSA-AES256-GCM-SHA384:256) (Exim 4.95) id 1peInX-00ERHO-EN for openvpn-devel@lists.sourceforge.net; Mon, 20 Mar 2023 16:55:56 +0000 Received: from kamera.blinkt.de ([2001:638:502:390:20c:29ff:fec8:535c]) by mail.blinkt.de with smtp (Exim 4.95 (FreeBSD)) (envelope-from ) id 1peInK-0001oy-Qr for openvpn-devel@lists.sourceforge.net; Mon, 20 Mar 2023 17:55:38 +0100 Received: (nullmailer pid 903011 invoked by uid 10006); Mon, 20 Mar 2023 16:55:38 -0000 From: Arne Schwabe To: openvpn-devel@lists.sourceforge.net Date: Mon, 20 Mar 2023 17:55:38 +0100 Message-Id: <20230320165538.902965-1-arne@rfc2549.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20230301134449.2810039-1-arne@rfc2549.org> References: <20230301134449.2810039-1-arne@rfc2549.org> MIME-Version: 1.0 X-Spam-Score: 0.3 (/) 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: Explicitly say that the version specified is the one of the peer and not the version we try to emulate. Patch v2: Improve grammar. Change-Id: I3bd27a8d34d8cb4896a3b78508b7d16911571543 Change-Id: If4fb45b3426f5e0dbe6c87d5bd05681b9d733827 Signed-off-by: Arne Schwabe --- doc/man-sections/generic-options.rst | 22 ++++++++++++++++------ 1 file changed, 16 insertions(+ [...] Content analysis details: (0.3 points, 6.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- 0.0 SPF_NONE SPF: sender does not publish an SPF Record 0.0 SPF_HELO_NONE SPF: HELO does not publish an SPF Record 0.2 HEADER_FROM_DIFFERENT_DOMAINS From and EnvelopeFrom 2nd level mail domains are different X-Headers-End: 1peInX-00ERHO-EN Subject: [Openvpn-devel] [PATCH v2] 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?1759173229643832306?= X-GMAIL-MSGID: =?utf-8?q?1760906610941776573?= Explicitly say that the version specified is the one of the peer and not the version we try to emulate. Patch v2: Improve grammar. Change-Id: I3bd27a8d34d8cb4896a3b78508b7d16911571543 Change-Id: If4fb45b3426f5e0dbe6c87d5bd05681b9d733827 Signed-off-by: Arne Schwabe Acked-By: Frank Lichtenheld --- doc/man-sections/generic-options.rst | 22 ++++++++++++++++------ 1 file changed, 16 insertions(+), 6 deletions(-) diff --git a/doc/man-sections/generic-options.rst b/doc/man-sections/generic-options.rst index c827651d6..97e1b5aa6 100644 --- a/doc/man-sections/generic-options.rst +++ b/doc/man-sections/generic-options.rst @@ -53,10 +53,17 @@ which mode OpenVPN is configured as. 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 @@ which mode OpenVPN is configured as. - 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.