Adding `winfw` library as a dependency

Run this command in a terminal, in your project's directory:

cargo add winfw

To add it manually, edit your project's Cargo.toml file and add to the [dependencies] section:

winfw = "0.1.8"

The winfw library will be automatically available globally. Read the winfw library documentation.

Back to the crate overview.

Readme

Windows Firewall

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

Adding winfw library as a dependency

Adding `winfw` library as a dependency