#nftables #async #features

nftables-async

An async version of the helper to run nftables, providing full compatibility with the rest of the nftables crate

4 releases (2 breaking)

new 0.3.0 Mar 23, 2025
0.2.2 Dec 1, 2024
0.2.1 Nov 29, 2024
0.1.1 Oct 27, 2024

#1950 in Network programming

Download history 71/week @ 2024-12-04 48/week @ 2024-12-11 8/week @ 2024-12-18 13/week @ 2025-01-08 11/week @ 2025-01-15 3/week @ 2025-01-22 9/week @ 2025-02-05 14/week @ 2025-02-12 12/week @ 2025-02-19 7/week @ 2025-02-26 9/week @ 2025-03-12 117/week @ 2025-03-19

135 downloads per month
Used in 4 crates (via fcnet)

MIT license

13KB
185 lines

nftables-async

An async version of the helper to run nftables in the nftables crate. Simply add both nftables-async and nftables to your crate, then use the nftables_async::apply_ruleset or nftables_async::get_current_ruleset to perform manipulations. Everything is compatible with the sync helper, even the error types, the functions, however, return "true" async futures.

To provide the asynchronous I/O, an implementation of the Process trait in the crate is needed. Two implementations are provided built-in behind feature gates:

  1. TokioProcess using the Tokio stack, enabled via tokio-process feature
  2. AsyncProcess using the async-process crate (Smol stack), enabled via async-process feature.

Why not the async helpers in nftables >0.6?

nftables 0.6.0 introduced tokio and async-process features that are mostly equivalent to this crate, however, these have some disadvantages that make nftables-async still relevant:

  1. The support in nftables is not implemented via a trait (like nftables_async::Process), meaning third-party extensions for async platforms other than Tokio or the async-* stack are not easily possible.
  2. The two features are mutually exclusive, making it impossible to compile an nftables that has both enabled. This breaks the use-case of fcnet, that needs both when enabling multiple runtime features, and is generally inconvenient.

Dependencies

~2–13MB
~172K SLoC