winfw

Crates.iowinfw
lib.rswinfw
version0.1.8
sourcesrc
created_at2021-06-19 04:04:37.348429
updated_at2022-11-27 11:00:35.135072
descriptionInteract with the Windows Firewall from Rust
homepage
repositoryhttps://github.com/marirs/winfw-rs
max_upload_size
id411981
size52,269
SG (marirs)

documentation

README

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

Commit count: 43

cargo fmt