Struct Stack 

pub struct Stack<'d> { /* private fields */ }

A network stack.

This is a handle to the stack created by Stack::new. It’s Copy, so you can pass it by value instead of by reference.

Implementations

impl<'d> Stack<'d>

pub fn new( storage: &'d mut StackStorage<'d>, random_seed: u64, ) -> (Self, Runner<'d>)

Create a new network stack.

The stack starts out with no interfaces: add them with add_iface.

pub fn add_iface(&self, driver: &'d mut dyn Driver) -> Result<Iface<'d>, Full>

Add an interface to the stack, borrowing the driver.

The driver is borrowed for as long as the stack lives. With a StaticCell that is 'static; with a local, the enclosing scope.

Example

static ETH: StaticCell<Device> = StaticCell::new();
let eth = stack.add_iface(ETH.init(device)).unwrap();

pub fn iface(&self, handle: IfaceHandle) -> Iface<'d>

Get an interface by its handle.

Panics

Panics if the handle does not belong to an interface on this stack.

pub fn remove_iface(&self, handle: IfaceHandle)

Remove an interface from the stack.

Its addresses, routes and neighbor cache entries go with it. Sockets bound to one of its addresses are not closed, they just stop receiving.

Panics

Panics if the handle does not belong to an interface on this stack.

pub fn hostname<R>(&self, f: impl FnOnce(Option<&str>) -> R) -> R

The stack’s hostname, or None if not set.

pub fn set_hostname(&self, hostname: &str)

Set the stack’s hostname.

If set, it is sent to the DHCP server in outgoing DHCP messages, as the host name option.

An empty string clears the hostname.

Panics

Panics if hostname is longer than 63 bytes.

pub fn neighbor_cache(&self) -> NeighborCache<'d>

The stack’s neighbor cache, shared by all interfaces.

pub fn routes(&self) -> Routes<'d>

The stack’s routing table, shared by all interfaces.

pub fn set_dns_servers(&self, servers: &[IpAddress])

Set the DNS servers to use, on top of the ones learned from DHCPv4.

The runner keeps the DNS client’s server list in step with the DHCPv4 leases of every interface. The servers set here are used in addition to those, and come first.

pub async fn dns_query( &self, name: &str, qtype: DnsQueryType, ) -> Result<Vec<IpAddress, { xarxa::config::DNS_MAX_RESULT_COUNT }>, Error>

Make a query for a given name and return the corresponding IP addresses.

Trait Implementations

impl<'d> Clone for Stack<'d>

fn clone(&self) -> Stack<'d>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'d> Copy for Stack<'d>