/winfw-rs

Bindings for Windows Firewall from Rust

Primary LanguageC++Apache License 2.0Apache-2.0

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