From patchwork Mon Mar 9 13:05:40 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Gert Doering X-Patchwork-Id: 4811 Return-Path: Delivered-To: patchwork@openvpn.net Received: by 2002:a05:7000:1e24:b0:83c:d90d:321 with SMTP id ht36csp1205681mab; Mon, 9 Mar 2026 06:06:15 -0700 (PDT) X-Forwarded-Encrypted: i=2; AJvYcCU7wwi8pLUf7GANj5hjWoa/uaN5rDtpUhDxi+GvASTWW5xezZiVbtDpMCfjL97R7+zmekhvxNHADxI=@openvpn.net X-Received: by 2002:a05:6820:2226:b0:67b:a91f:8f1e with SMTP id 006d021491bc7-67ba91f944cmr3822765eaf.9.1773061574871; Mon, 09 Mar 2026 06:06:14 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1773061574; cv=none; d=google.com; s=arc-20240605; b=bXqNz9Z7FjJ7V8yur0Buzj4eFztJrX9kGDuTnfStttC35XzNJoSxIHRRJAJUIDnUCj a2FoxD63AeOKornfxfmVBrw00CWfhpzCqTyF+kij9Vcynz2GXodIBDPVHq0FHemL5+ym MW7oQPM2Kyl1khOwNCYYJ2leI8rZqSYHCRhi5WUtR4Ec87P7C6Lw9nbJ1cX86+H6JyPS v8aF3xkL89IODsLDBe35Pwh67Lm201WBplzPdRWvEBahQWXdArYa4Rb0wMdVhK8tCOA4 vZbXZLZvHhqfqH+hP+dzY54pUBRbTKDUSYryS152cjf6kPwpSsgh4jI/ajSmKyvG3+se gNwQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20240605; 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=CY+abR3AK1q6PyLjtfIFJZ1pvxj9frBbhRttgVAHgNc=; fh=4NbAC/LsuMLI0S0hprUlLSLCiHwg6SCAifhH718Jh0Q=; b=M6J3eLBTw2fGwkhHAiCi0vDv3+tRNW3BPkEXcQ5/vRlHw17qvXLAQsFeL2ZtURtQ8K HPhUx4V8k0L0sjmgKLCOFV5NU/yk8LQINVzcTwlIR/AOy3sdHJPQdy96q+UxReSXQe0Z HeLK+ilzlCSFPhiRGguEfPCKAyU8slcpDl68DGejd5NitgvauUxagBdq1rC7JmeGvZpL STC+x/hTiXh3uch0Q45maatk98y9wc8JvqyfMi+bqRQ31cI/fFBtzF4CCoqsdTXeLlGY ZZJ6XQiEECCdB0pdJbtoA17baOXGGqyxp8DFmqPzXY5wsEkYnbuASYTyOg4pVh9eaIdx LrxA==; dara=google.com ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@lists.sourceforge.net header.s=beta header.b=jw4iCjem; dkim=neutral (body hash did not verify) header.i=@sourceforge.net header.s=x header.b="ksbke6T/"; dkim=neutral (body hash did not verify) header.i=@sf.net header.s=x header.b=nLTU5SeW; 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; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=muc.de Received: from lists.sourceforge.net (lists.sourceforge.net. [216.105.38.7]) by mx.google.com with ESMTPS id 006d021491bc7-67bb37e8db3si1424809eaf.64.2026.03.09.06.06.14 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Mon, 09 Mar 2026 06:06:14 -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=pass header.i=@lists.sourceforge.net header.s=beta header.b=jw4iCjem; dkim=neutral (body hash did not verify) header.i=@sourceforge.net header.s=x header.b="ksbke6T/"; dkim=neutral (body hash did not verify) header.i=@sf.net header.s=x header.b=nLTU5SeW; 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; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=muc.de DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.sourceforge.net; s=beta; h=Content-Transfer-Encoding:Content-Type: List-Subscribe:List-Help:List-Post:List-Archive:List-Unsubscribe:List-Id: Subject:MIME-Version:References:In-Reply-To:Message-ID:Date:To:From:Sender: Reply-To:Cc:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Owner; bh=CY+abR3AK1q6PyLjtfIFJZ1pvxj9frBbhRttgVAHgNc=; b=jw4iCjemKM6ZS7op0wFkhtEYZr Rsyc6Ccr7B92HjcHAX8bQ6OyM5vq42VL/3fz1d7s20NCGijI/60R55WtY3BAo5c6rWkiJLJkitm6p zd7a9Ow5BfcniPnnZQgtg8O4/a0frRv6RLrlYAlWzJYj/HotJjGrhQxwwbL8brCr+vFw=; 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 1vzaJA-0002Ef-VX; Mon, 09 Mar 2026 13:06:04 +0000 Received: from [172.30.29.66] (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 1vzaJ9-0002EY-F9 for openvpn-devel@lists.sourceforge.net; Mon, 09 Mar 2026 13:06:03 +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=mJ40O9XnIiznQHSZto7ml07M7bbihvvi0k+yxvbavDo=; b=ksbke6T/nj+a7c2o/QhoNWizwg 2qOcyHIsN6AlMh6KJSOtnhJ7sGKYneLC36sR0lgPyp0Lp5qUoULwwbHxp2oLDlghEMS50ONV/kQcw /e9B3vE7fieuNmxTQLj/N2hyeqralkLf3eZ2fCMuFILXPnhOCOi1+xYBsU58YbXWaees=; 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=mJ40O9XnIiznQHSZto7ml07M7bbihvvi0k+yxvbavDo=; b=nLTU5SeWfIIeNnku1EW9DOWKnu WB/iFWNHnmLISUY9L9fUG04b3zg7z1d0wWbapn6XWYtENLBEychfM8cvHdre/6mPW1lnh6xB9uPwt Gb8KJbSwAT6laU466/ul8TD7R7/bYNhWfNXiWI7EdsX8AdFfNAlmxs8opZ8bXnnfLsF4=; Received: from [193.149.48.129] (helo=blue.greenie.muc.de) by sfi-mx-2.v28.lw.sourceforge.com with esmtps (TLS1.2:ECDHE-RSA-AES256-GCM-SHA384:256) (Exim 4.95) id 1vzaJ7-000802-1t for openvpn-devel@lists.sourceforge.net; Mon, 09 Mar 2026 13:06:03 +0000 Received: from blue.greenie.muc.de (localhost [127.0.0.1]) by blue.greenie.muc.de (8.18.1/8.18.1) with ESMTP id 629D5m4A007751 for ; Mon, 9 Mar 2026 14:05:48 +0100 Received: (from gert@localhost) by blue.greenie.muc.de (8.18.1/8.18.1/Submit) id 629D5meC007750 for openvpn-devel@lists.sourceforge.net; Mon, 9 Mar 2026 14:05:48 +0100 From: Gert Doering To: openvpn-devel@lists.sourceforge.net Date: Mon, 9 Mar 2026 14:05:40 +0100 Message-ID: <20260309130546.7735-1-gert@greenie.muc.de> X-Mailer: git-send-email 2.52.0 In-Reply-To: References: MIME-Version: 1.0 X-Spam-Score: 1.3 (+) X-Spam-Report: Spam detection software, running on the system "sfi-spamd-2.hosts.colo.sdot.me", 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: Ralf Lici The client-nat documentation uses an incorrect command form and incomplete examples. Document the actual syntax accepted by openvpn: client-nat snat|dnat network netmask alias Content analysis details: (1.3 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- 1.3 RDNS_NONE Delivered to internal network by a host with no rDNS X-Headers-End: 1vzaJ7-000802-1t Subject: [Openvpn-devel] [PATCH v2] doc: fix client-nat syntax and examples 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?1859189813758960756?= X-GMAIL-MSGID: =?utf-8?q?1859189813758960756?= From: Ralf Lici The client-nat documentation uses an incorrect command form and incomplete examples. Document the actual syntax accepted by openvpn: client-nat snat|dnat network netmask alias Update examples to include all required arguments and rewrite the explanatory text to describe 'network', 'netmask', and 'alias' separately. Documentation-only change; no behavior change. Change-Id: I89f0aa9a23915c7783ae03793080ee989a437208 Signed-off-by: Ralf Lici Acked-by: Frank Lichtenheld Gerrit URL: https://gerrit.openvpn.net/c/openvpn/+/1560 --- 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/+/1560 This mail reflects revision 2 of this Change. Acked-by according to Gerrit (reflected above): Frank Lichtenheld diff --git a/doc/man-sections/client-options.rst b/doc/man-sections/client-options.rst index b9ae7ce..85d25e5 100644 --- a/doc/man-sections/client-options.rst +++ b/doc/man-sections/client-options.rst @@ -132,16 +132,21 @@ ifconfig settings pushed to the client would create an IP numbering conflict. + Valid syntax: + :: + + client-nat snat|dnat network netmask alias + Examples: :: - client-nat snat 192.168.0.0/255.255.0.0 - client-nat dnat 10.64.0.0/255.255.0.0 + client-nat snat 192.168.0.0 255.255.0.0 10.64.0.0 + client-nat dnat 10.64.0.0 255.255.0.0 192.168.0.0 - ``network/netmask`` (for example :code:`192.168.0.0/255.255.0.0`) defines - the local view of a resource from the client perspective, while - ``alias/netmask`` (for example :code:`10.64.0.0/255.255.0.0`) defines the - remote view from the server perspective. + ``network`` and ``netmask`` (for example :code:`192.168.0.0 + 255.255.0.0`) define the local view of a resource from the client + perspective, while ``alias`` (for example :code:`10.64.0.0`) defines the + remote view from the server perspective using the same netmask. Use :code:`snat` (source NAT) for resources owned by the client and :code:`dnat` (destination NAT) for remote resources.