Struct netsim::Ipv4Range

pub struct Ipv4Range { /* fields omitted */ }

A range of IPv4 addresses with a common prefix

Methods

impl Ipv4Range

pub fn new(addr: Ipv4Addr, bits: u8) -> Ipv4Range

Create an IPv4 range with the given base address and netmask prefix length.

Example

Create the subnet 192.168.0.0/24 with Ipv4Range::new(ipv4!("192.168.0.0"), 24)

pub fn global() -> Ipv4Range

Return the entire IPv4 range, eg. 0.0.0.0/0

pub fn local_subnet_10() -> Ipv4Range

Returns the local network subnet 10.0.0.0/8

pub fn local_subnet_172(block: u8) -> Ipv4Range

Returns a local network subnet 172.(16 | x).0.0/16 where x is a 4-bit number given by block

Panics

If block & 0xf0 != 0

pub fn local_subnet_192(block: u8) -> Ipv4Range

Returns the local subnet 192.168.x.0/24 where x is given by block.

pub fn random_local_subnet() -> Ipv4Range

Returns a random local network subnet from one of the ranges 10.0.0.0, 172.16.0.0 or 192.168.0.0

pub fn netmask(&self) -> Ipv4Addr

Get the netmask as an IP address

pub fn netmask_prefix_length(&self) -> u8

Get the number of netmask prefix bits

pub fn base_addr(&self) -> Ipv4Addr

Get the base address of the range, ie. the lowest IP address which is part of the range.

pub fn gateway_ip(&self) -> Ipv4Addr

Get a default IP address for the range's gateway. This is one higher than the base address of the range. eg. for 10.0.0.0/8, the default address for the gateway will be 10.0.0.1

pub fn random_client_addr(&self) -> Ipv4Addr

Get a random IP address from the range which is not the base address or the default for the gateway address.

pub fn contains(&self, ip: Ipv4Addr) -> bool

Check whether this range contains the given IP address

Important traits for Vec<u8>

impl Write for Vec<u8>

pub fn split(self, num: u32) -> Vec<Ipv4Range>

Split a range into num sub-ranges

Panics

If the range is too small to be split up that much.

Trait Implementations

impl Clone for Ipv4Range

fn clone(&self) -> Ipv4Range

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for Ipv4Range

impl Debug for Ipv4Range

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

Formats the value using the given formatter.

impl FromStr for Ipv4Range

type Err = IpRangeParseError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Ipv4Range, IpRangeParseError>

Parses a string s to return a value of this type.