#firewall #windows #winapi #com #ffi

sys winfw

Interact with the Windows Firewall from Rust

8 releases

0.1.8 Nov 27, 2022
0.1.7 Nov 27, 2022
0.1.6 Aug 5, 2022
0.1.5 Jul 5, 2022
0.1.1 Jun 19, 2021

#59 in Windows APIs

Download history 7/week @ 2023-12-17 31/week @ 2023-12-31 54/week @ 2024-01-07 94/week @ 2024-01-14 110/week @ 2024-01-21 86/week @ 2024-01-28 71/week @ 2024-02-04 139/week @ 2024-02-11 109/week @ 2024-02-18 137/week @ 2024-02-25 71/week @ 2024-03-03 42/week @ 2024-03-10 46/week @ 2024-03-17 37/week @ 2024-03-24 174/week @ 2024-03-31

307 downloads per month

MIT/Apache

36KB
879 lines

Windows Firewall

Crates.io Documentation Crates.io

Interact with the Windows Firewall from Rust. Bindings for Windows Firewall, with clean & simple API for use with Rust.

This crate can perform the following:

  • Enumerate the Windows firewall rules
  • Add/Create a new Windows firewall rule
  • Delete an existing Windows firewall rule
  • Disable an existing Windows firewall rule

Usage

Cargo.toml:

[target.'cfg(windows)'.dependencies]
winfw = "0.1.8"

main.rs:

use winfw::get_fw_rules;

fn main() {
    // enumerating fw rules
    let rules = get_fw_rules();
    match rules {
        Err(rules) => println!("Error: {}", rules),
        Ok(rules) => {
            for rule in rules.iter() {
                println!("{}", rule);
            }
        }
    }
}

running the example

  • Show/list all configured firewall rules
cargo run --example list_all_rules
  • Add a new firewall rule
cargo run --example add_new_rule
  • Delete a firewall rule
cargo run --example del_rule
  • Disable a firewall rule
cargo run --example disable_rule

Requirements

  • Rust 1.50+
  • VS 2019 community edition

License: MIT/Apache 2.0

Dependencies

~0.5–1.3MB
~29K SLoC