Struct shadow_rs::host::network::namespace::NetworkNamespace

pub struct NetworkNamespace {
    pub unix: Arc<AtomicRefCell<AbstractUnixNamespace>>,
    pub localhost: RefCell<NetworkInterface>,
    pub internet: RefCell<NetworkInterface>,
    pub default_address: SyncSendPointer<Address>,
    pub default_ip: Ipv4Addr,
    /* private fields */
}

Represents a network namespace.

Can be thought of as roughly equivalent to a Linux struct net. Shadow doesn’t support multiple network namespaces, but this NetworkNamespace allows us to consolidate the host’s networking objects, and hopefully might make it easier to support multiple network namespaces if we want to in the future.

Fields

unix: Arc<AtomicRefCell<AbstractUnixNamespace>>

localhost: RefCell<NetworkInterface>

internet: RefCell<NetworkInterface>

default_address: SyncSendPointer<Address>

default_ip: Ipv4Addr

Implementations

impl NetworkNamespace

pub unsafe fn new( host_id: HostId, hostname: Vec<NonZeroU8>, public_ip: Ipv4Addr, pcap: Option<PcapOptions>, qdisc: QDiscMode, dns: *mut DNS, ) -> Self

Safety

dns must be a valid pointer.

pub fn cleanup(&self, dns: &DNS)

Clean up the network namespace. This should be called while Worker has the active host set. The dns object should be the same object that was originally provided to Self::new.

pub fn interface_borrow( &self, addr: Ipv4Addr, ) -> Option<impl Deref<Target = NetworkInterface> + '_>

Returns None if there is no such interface.

pub fn interface_borrow_mut( &self, addr: Ipv4Addr, ) -> Option<impl DerefMut<Target = NetworkInterface> + '_>

Returns None if there is no such interface.

pub fn is_addr_in_use( &self, protocol_type: ProtocolType, src: SocketAddrV4, dst: SocketAddrV4, ) -> Result<bool, NoInterface>

pub fn get_random_free_port( &self, protocol_type: ProtocolType, interface_ip: Ipv4Addr, peer: SocketAddrV4, rng: impl Rng, ) -> Option<u16>

Returns a random port in host byte order.

pub unsafe fn associate_interface( &self, socket: &InetSocket, protocol: ProtocolType, bind_addr: SocketAddrV4, peer_addr: SocketAddrV4, ) -> AssociationHandle

Associate the socket with any applicable network interfaces. The socket will be automatically disassociated when the returned handle is dropped.

Safety

Pointer args must be safely dereferenceable.

pub fn disassociate_interface( &self, protocol: ProtocolType, bind_addr: SocketAddrV4, peer_addr: SocketAddrV4, )

Disassociate the socket associated using the local and remote addresses from all network interfaces.

Is only public so that it can be called from host_disassociateInterface. Normally this should only be called from the AssociationHandle.

Trait Implementations

impl Drop for NetworkNamespace

fn drop(&mut self)

Executes the destructor for this type.