summaryrefslogtreecommitdiffstats
path: root/doc/nft.xml
diff options
context:
space:
mode:
authorPablo Neira Ayuso <pablo@netfilter.org>2018-01-22 11:17:10 +0100
committerPablo Neira Ayuso <pablo@netfilter.org>2018-01-22 11:47:58 +0100
commit30f667920601d01107398cbb85da45fdb1237212 (patch)
tree007eb0687d716a6cb2a33be255e283fdd483d4af /doc/nft.xml
parentb4c7117ef552d0d71bde1db4a047b4c005699951 (diff)
src: add 'auto-merge' option to sets
After discussions with Karel here: https://bugzilla.netfilter.org/show_bug.cgi?id=1184 And later on with Phil Sutter, we decided to disable the automatic merge feature in sets with intervals. This feature is problematic because it introduces an inconsistency between what we add and what we later on get. This is going to get worse with the upcoming timeout support for intervals. Therefore, we turned off this by default. However, Jeff Kletsky and folks like this feature, so let's restore this behaviour on demand with this new 'auto-merge' statement, that you can place on the set definition, eg. # nft list ruleset table ip x { ... set y { type ipv4_addr flags interval auto-merge } } # nft add element x z { 1.1.1.1-2.2.2.2, 1.1.1.2 } Regarding implementation details: Given this feature only makes sense from userspace, let's store this in the set user data area, so nft knows it has to do automatic merge of adjacent/overlapping elements as per user request. # nft add set x z { type ipv4_addr\; auto-merge\; } Error: auto-merge only works with interval sets add set x z { type ipv4_addr; auto-merge; } ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Fixes: https://bugzilla.netfilter.org/show_bug.cgi?id=1216 Signed-off-by: Pablo Neira Ayuso <pablo@netfilter.org>
Diffstat (limited to 'doc/nft.xml')
-rw-r--r--doc/nft.xml6
1 files changed, 6 insertions, 0 deletions
diff --git a/doc/nft.xml b/doc/nft.xml
index 9e979af3..6a95ea68 100644
--- a/doc/nft.xml
+++ b/doc/nft.xml
@@ -883,6 +883,7 @@ filter input iif $int_ifs accept
<arg choice="opt">elements = { <replaceable>element</replaceable>[,...] } ;</arg>
<arg choice="opt">size <replaceable>size</replaceable> ;</arg>
<arg choice="opt">policy <replaceable>policy</replaceable> ;</arg>
+ <arg choice="opt">auto-merge <replaceable>auto-merge</replaceable> ;</arg>
}
</cmdsynopsis>
<cmdsynopsis>
@@ -1013,6 +1014,11 @@ filter input iif $int_ifs accept
<entry>set policy</entry>
<entry>string: performance [default], memory</entry>
</row>
+ <row>
+ <entry>auto-merge</entry>
+ <entry>automatic merge of adjacent/overlapping set elements (only for interval sets)</entry>
+ <entry></entry>
+ </row>
</tbody>
</tgroup>
</table>