Limits: Difference between revisions

From nftables wiki
Jump to navigation Jump to search
(Initial stub page for named limits.)
 
(Added named limit example.)
Line 10: Line 10:
= Named limits =
= Named limits =


'''FIXME: Need at least one example here!'''
== Declaring and using named limits ==
 
<source>
table inet limit_demo {
 
  limit lim_400ppm { rate 400/minute }
  limit lim_1kbps  { rate over 1024 bytes/second burst 512 bytes }
 
  chain IN {
      type filter hook input priority filter; policy drop;
 
      meta l4proto icmp limit name "lim_400ppm" accept
      tcp dport 25 limit name "lim_1kbps" accept
  }
}
</source>
 
The above ruleset defines a per-packet named limit ''lim_400ppm'' and a per-byte named limit ''lim_1kbps''. The rules in input chain ''IN'' use these named limits to:
* Accept icmp packets, of all icmp types, up to a maximum rate of 400 packets / minute.
* Accept traffic to port tcp/25 (smtp), up to a maximum rate of 1024 bytes / second. Up to 512 bytes of such traffic arriving faster than this is accepted.
* Drop all other traffic.


== Declaring and using named limits ==


== Listing named limits ==
== Listing named limits ==

Revision as of 17:57, 7 April 2021

A limit uses a token bucket filter to match packets:

  • only until its rate is exceeded; or
  • only after its rate is exceeded, if defined as an over limit.


Anonymous limits

Named limits

Declaring and using named limits

table inet limit_demo {

   limit lim_400ppm { rate 400/minute }
   limit lim_1kbps  { rate over 1024 bytes/second burst 512 bytes }

   chain IN { 
      type filter hook input priority filter; policy drop;

      meta l4proto icmp limit name "lim_400ppm" accept
      tcp dport 25 limit name "lim_1kbps" accept
   }
}

The above ruleset defines a per-packet named limit lim_400ppm and a per-byte named limit lim_1kbps. The rules in input chain IN use these named limits to:

  • Accept icmp packets, of all icmp types, up to a maximum rate of 400 packets / minute.
  • Accept traffic to port tcp/25 (smtp), up to a maximum rate of 1024 bytes / second. Up to 512 bytes of such traffic arriving faster than this is accepted.
  • Drop all other traffic.


Listing named limits

nft list [limit | limits] (as per below) returns the limit(s) with current byte count.

  • List a particular limit:
% nft list limit [family] [table_name] [limit_name]
  • List all limits in a particular table:
% nft list limits table [family] [table_name]
  • List all limits in ruleset:
% nft list limits