Skip to content

An async version of the helper to run nftables with JSON data.

Notifications You must be signed in to change notification settings

rust-firecracker/nftables-async

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

About

An async version of the helper to run nftables with JSON data.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages