From patchwork Fri Sep 21 01:54:27 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Duncan Roe X-Patchwork-Id: 972803 X-Patchwork-Delegate: pablo@netfilter.org Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=none (mailfrom) smtp.mailfrom=vger.kernel.org (client-ip=209.132.180.67; helo=vger.kernel.org; envelope-from=netfilter-devel-owner@vger.kernel.org; receiver=) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=optusnet.com.au Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 42Gc9H3R8jz9sB5 for ; Fri, 21 Sep 2018 11:54:42 +1000 (AEST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1727474AbeIUHlI (ORCPT ); Fri, 21 Sep 2018 03:41:08 -0400 Received: from mail108.syd.optusnet.com.au ([211.29.132.59]:47724 "EHLO mail108.syd.optusnet.com.au" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1725855AbeIUHlI (ORCPT ); Fri, 21 Sep 2018 03:41:08 -0400 Received: from dimstar.local.net (unknown [210.49.74.88]) by mail108.syd.optusnet.com.au (Postfix) with SMTP id E6B691A1F8E for ; Fri, 21 Sep 2018 11:54:28 +1000 (AEST) Received: (qmail 4314 invoked by uid 501); 21 Sep 2018 01:54:27 -0000 From: Duncan Roe To: netfilter-devel@vger.kernel.org Subject: [PATCH] doc: Re-work RULES:add/insert/replace to read better. Date: Fri, 21 Sep 2018 11:54:27 +1000 Message-Id: <20180921015427.4273-1-duncan_roe@optusnet.com.au> X-Mailer: git-send-email 2.9.0 X-Optus-CM-Score: 0 X-Optus-CM-Analysis: v=2.2 cv=DZtnkrlW c=1 sm=1 tr=0 a=DRuhS6OGlO/VPiI5KpoYuA==:117 a=DRuhS6OGlO/VPiI5KpoYuA==:17 a=x7bEGLp0ZPQA:10 a=JBFolyDoGHsA:10 a=PO7r1zJSAAAA:8 a=ErZhZU6ej00tUvIkppYA:9 Sender: netfilter-devel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: netfilter-devel@vger.kernel.org It was tempting to remove "position" from the synopsis, but have left that for another patch. Signed-off-by: Duncan Roe Acked-by: Phil Sutter --- doc/nft.txt | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/doc/nft.txt b/doc/nft.txt index 9d04e43..2a76a6c 100644 --- a/doc/nft.txt +++ b/doc/nft.txt @@ -410,6 +410,8 @@ concurrent ruleset change happens after the translation was done: The effective rule index might change if a rule was inserted or deleted before the referred one. If the referred rule was deleted, the command is rejected by the kernel just as if an invalid 'handle' was given. +The old name "position" in place of "handle" is deprecated +and should not be used anymore. A 'comment' is a single word or a double-quoted (") multi-word string which can be used to make notes regarding the actual rule. *Note:* If you use bash for @@ -418,13 +420,11 @@ servers\") [horizontal] *add*:: Add a new rule described by the list of statements. The -rule is appended to the given chain unless a position is specified, in which -case the rule is appended to the rule given by the 'handle'. The alternative -name position is deprecated and should not be used anymore. -*insert*:: Similar to the *add* command, but the rule is prepended to the -beginning of the chain or before the rule with the given 'handle'. -*replace*:: Similar to the add command, but the rule replaces the specified -rule. +rule is appended to the given chain unless a location is specified, in which +case the rule is inserted after the specified rule. +*insert*:: Same as *add* except the rule is inserted at the +beginning of the chain or before the specified rule. +*replace*:: Similar to *add*, but the rule replaces the specified rule. *delete*:: Delete the specified rule. .*add a rule to ip table input chain*