Struct PfTable 

pub struct PfTable {
    pub name: String,
}

A high-level struct representing a pf table containing addresses

Fields

name: String

Implementations

impl PfTable

pub fn new(name: &str) -> PfTable

Prepares a new PfTable with a provided name

Examples found in repository

examples/my_table.rs (line 18)

fn main() -> Result<(), Box<dyn Error>> {
    let fd = fs::OpenOptions::new()
        .write(true)
        .open("/dev/pf")?;

    let mut addrs = vec![
        PfrAddr::new_host(IpAddr::V4("127.0.0.1".parse()?)),
        PfrAddr::new_host(IpAddr::V4("127.0.0.2".parse()?)),
        PfrAddr::new_host(IpAddr::V4("127.0.0.3".parse()?)),
        PfrAddr::new_host(IpAddr::V6("::1".parse()?)),
    ];

    let mut table = PfTable::new("my_table");

    // Add a list of addresses to table
    table.add_addrs(&fd, addrs.clone())?;

    // Delete a list of addresses from table
    let last = addrs.pop().unwrap();
    table.del_addrs(&fd, vec![last])?;

    // Print contents of table
    for addr in table.get_addrs(&fd)? {
        println!("{}", addr);
    }

    // Clear all addresses from table
    table.clr_addrs(&fd)?;

    Ok(())
}

pub fn get_addrs(&self, fd: &File) -> Result<Vec<PfrAddr>, PfError>

Asks the kernel for a list of addresses in the table

Examples found in repository

examples/my_table.rs (line 28)

fn main() -> Result<(), Box<dyn Error>> {
    let fd = fs::OpenOptions::new()
        .write(true)
        .open("/dev/pf")?;

    let mut addrs = vec![
        PfrAddr::new_host(IpAddr::V4("127.0.0.1".parse()?)),
        PfrAddr::new_host(IpAddr::V4("127.0.0.2".parse()?)),
        PfrAddr::new_host(IpAddr::V4("127.0.0.3".parse()?)),
        PfrAddr::new_host(IpAddr::V6("::1".parse()?)),
    ];

    let mut table = PfTable::new("my_table");

    // Add a list of addresses to table
    table.add_addrs(&fd, addrs.clone())?;

    // Delete a list of addresses from table
    let last = addrs.pop().unwrap();
    table.del_addrs(&fd, vec![last])?;

    // Print contents of table
    for addr in table.get_addrs(&fd)? {
        println!("{}", addr);
    }

    // Clear all addresses from table
    table.clr_addrs(&fd)?;

    Ok(())
}

pub fn add_addrs(&self, fd: &File, addrs: Vec<PfrAddr>) -> Result<(), PfError>

Asks the kernel to add a list of addresses to the table

Examples found in repository

examples/my_table.rs (line 21)

fn main() -> Result<(), Box<dyn Error>> {
    let fd = fs::OpenOptions::new()
        .write(true)
        .open("/dev/pf")?;

    let mut addrs = vec![
        PfrAddr::new_host(IpAddr::V4("127.0.0.1".parse()?)),
        PfrAddr::new_host(IpAddr::V4("127.0.0.2".parse()?)),
        PfrAddr::new_host(IpAddr::V4("127.0.0.3".parse()?)),
        PfrAddr::new_host(IpAddr::V6("::1".parse()?)),
    ];

    let mut table = PfTable::new("my_table");

    // Add a list of addresses to table
    table.add_addrs(&fd, addrs.clone())?;

    // Delete a list of addresses from table
    let last = addrs.pop().unwrap();
    table.del_addrs(&fd, vec![last])?;

    // Print contents of table
    for addr in table.get_addrs(&fd)? {
        println!("{}", addr);
    }

    // Clear all addresses from table
    table.clr_addrs(&fd)?;

    Ok(())
}

pub fn del_addrs(&self, fd: &File, addrs: Vec<PfrAddr>) -> Result<(), PfError>

Asks the kernel to delete a list of addresses from the table

Examples found in repository

examples/my_table.rs (line 25)

fn main() -> Result<(), Box<dyn Error>> {
    let fd = fs::OpenOptions::new()
        .write(true)
        .open("/dev/pf")?;

    let mut addrs = vec![
        PfrAddr::new_host(IpAddr::V4("127.0.0.1".parse()?)),
        PfrAddr::new_host(IpAddr::V4("127.0.0.2".parse()?)),
        PfrAddr::new_host(IpAddr::V4("127.0.0.3".parse()?)),
        PfrAddr::new_host(IpAddr::V6("::1".parse()?)),
    ];

    let mut table = PfTable::new("my_table");

    // Add a list of addresses to table
    table.add_addrs(&fd, addrs.clone())?;

    // Delete a list of addresses from table
    let last = addrs.pop().unwrap();
    table.del_addrs(&fd, vec![last])?;

    // Print contents of table
    for addr in table.get_addrs(&fd)? {
        println!("{}", addr);
    }

    // Clear all addresses from table
    table.clr_addrs(&fd)?;

    Ok(())
}

pub fn clr_addrs(&self, fd: &File) -> Result<(), PfError>

Asks the kernel to remove every address from the table

Examples found in repository

examples/my_table.rs (line 33)

fn main() -> Result<(), Box<dyn Error>> {
    let fd = fs::OpenOptions::new()
        .write(true)
        .open("/dev/pf")?;

    let mut addrs = vec![
        PfrAddr::new_host(IpAddr::V4("127.0.0.1".parse()?)),
        PfrAddr::new_host(IpAddr::V4("127.0.0.2".parse()?)),
        PfrAddr::new_host(IpAddr::V4("127.0.0.3".parse()?)),
        PfrAddr::new_host(IpAddr::V6("::1".parse()?)),
    ];

    let mut table = PfTable::new("my_table");

    // Add a list of addresses to table
    table.add_addrs(&fd, addrs.clone())?;

    // Delete a list of addresses from table
    let last = addrs.pop().unwrap();
    table.del_addrs(&fd, vec![last])?;

    // Print contents of table
    for addr in table.get_addrs(&fd)? {
        println!("{}", addr);
    }

    // Clear all addresses from table
    table.clr_addrs(&fd)?;

    Ok(())
}

Trait Implementations

impl Clone for PfTable

fn clone(&self) -> PfTable

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PfTable

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.