Skip to main content

TapLink

microsandbox_network::host::linux

Struct TapLink

pub struct TapLink {
    pub tap_fd: OwnedFd,
    pub ifname: String,
    pub gateway_v4: Ipv4Addr,
    pub guest_v4: Ipv4Addr,
    pub prefix_v4: u8,
    pub gateway_v6: Ipv6Addr,
    pub guest_v6: Ipv6Addr,
    pub prefix_v6: u8,
    pub mtu: u16,
    pub mac: [u8; 6],
    pub subnet_v4: String,
    pub subnet_v6: String,
}

Expand description

TAP-based network backend for Linux.

Holds the TAP file descriptor and the resolved network parameters. On drop, cleans up nftables set elements and removes the TAP device.

Fields§

§tap_fd: OwnedFd

TAP device file descriptor.

§ifname: String

TAP interface name (e.g. msbtap42).

§gateway_v4: Ipv4Addr

Gateway IPv4 address (assigned to the TAP interface).

§guest_v4: Ipv4Addr

Guest IPv4 address.

§prefix_v4: u8

IPv4 prefix length.

§gateway_v6: Ipv6Addr

Gateway IPv6 address (assigned to the TAP interface).

§guest_v6: Ipv6Addr

Guest IPv6 address.

§prefix_v6: u8

IPv6 prefix length.

§mtu: u16

MTU.

§mac: [u8; 6]

Guest MAC address.

§subnet_v4: String

Sandbox IPv4 subnet registered in nftables.

§subnet_v6: String

Sandbox IPv6 subnet registered in nftables.

Implementations§

impl TapLink

pub fn create(slot: u32, interface: &InterfaceConfig) -> Result<Self>

Creates a new TAP device and configures host networking for the given sandbox slot.

Privileged operations (must run as root):

Create TAP device
Assign gateway IPv4/IPv6 addresses to the TAP interface
Set MTU
Bring interface up
Enable IP forwarding (sysctl)
Ensure shared nftables table/chains/sets exist
Register this sandbox in the nftables sets

pub fn ready_info(&self) -> MsbnetReady

Builds the MsbnetReady payload from the resolved parameters.

pub fn as_raw_fd(&self) -> RawFd

Returns the raw TAP file descriptor.

pub fn cleanup(&self)

Removes nftables set elements and deletes the TAP device.

Trait Implementations§

impl Drop for TapLink

fn drop(&mut self)

Executes the destructor for this type. Read more

impl FrameTransport for TapLink

fn ready_fd(&self) -> RawFd

Returns the fd used for readiness notifications.

fn read_frame(&self, buf: &mut [u8]) -> Result<usize>

Reads one ethernet frame from the backend.

fn write_frame(&self, buf: &[u8]) -> Result<()>

Writes one ethernet frame to the backend.

Auto Trait Implementations§

impl Freeze for TapLink

impl RefUnwindSafe for TapLink

impl Send for TapLink

impl Sync for TapLink

impl Unpin for TapLink

impl UnsafeUnpin for TapLink

impl UnwindSafe for TapLink

Blanket Implementations§

impl<T> Any for T
where T: 'static + ?Sized,

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

impl<'a, T, E> AsTaggedExplicit<'a, E> for T
where T: 'a,

fn explicit(self, class: Class, tag: u32) -> TaggedParser<'a, Explicit, Self, E>

impl<'a, T, E> AsTaggedImplicit<'a, E> for T
where T: 'a,

fn implicit( self, class: Class, constructed: bool, tag: u32, ) -> TaggedParser<'a, Implicit, Self, E>

impl<T> Borrow<T> for T
where T: ?Sized,

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for T
where T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

impl<T> From<T> for T

fn from(t: T) -> T

Returns the argument unchanged.

impl<T> Instrument for T

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

impl<T, U> Into<U> for T
where U: From<T>,

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

impl<T> Pointable for T

const ALIGN: usize

The alignment of pointer.

type Init = T

The type for initializers.

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more

impl<T, U> TryFrom<U> for T
where U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

fn vzip(self) -> V

impl<T> WithSubscriber for T

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more