Struct IPTargets

pub struct IPTargets(/* private fields */);

Represents a list of IP targets

This wrapper is used to cut down on the memory needed to store entire network IP ranges. Rather than storing all 65536 IPs in a /16 CIDR block, or a range of IPS, this wrapper allows the storage of just CIDR or range in string form and then dynamically loops the IPs in that block when needed.

Panics

Panics if an item in the list is not a valid IP

Examples

let print_ip = |ip: net::Ipv4Addr| -> Result<(), ScanError> {
  println!("ip: {}", ip);
  Ok(())
};
let ips = IPTargets::new(
    vec![
      "192.168.0.1".to_string(),
      "172.17.0.1-172.17.0.24".to_string(),
      "192.168.68.1/24".to_string(),
    ]
);
ips.lazy_loop(print_ip).unwrap();

Implementations

impl IPTargets

pub fn new(list: Vec<String>) -> Arc<Self>

Returns a new instance of IPTargets using the provided list

pub fn len(&self) -> usize

Returns the true length of the target list. If the underlying Vec<String> is just ["192.168.0.1/24"], then a call to “len” will return 256

pub fn is_empty(&self) -> bool

Returns true if the list is empty

pub fn lazy_loop<F: FnMut(Ipv4Addr) -> Result<(), ScanError>>( &self, cb: F, ) -> Result<(), ScanError>

loops over all targets including those that are not explicitly in the list but fall within a range or CIDR block defined in the list

Trait Implementations

impl Debug for IPTargets

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

Formats the value using the given formatter.