Struct DataPlane 

pub struct DataPlane { /* private fields */ }

Transforms packets to make tailscale happen.

Implementations

impl DataPlane

pub fn new(my_key: NodeKeyPair) -> Self

Create a new data plane for a wireguard node key.

The caller must configure overlay/underlay output queues for the data plane to be useful, otherwise all it can do is drop packets.

pub async fn new_underlay_transport( &self, ) -> (UnderlayTransportId, DataplaneFromUnderlay, DataplaneToUnderlay)

Allocate a new underlay transport.

pub async fn new_overlay_transport( &self, ) -> (OverlayTransportId, DataplaneToOverlay, DataplaneFromOverlay)

Allocate a new overlay transport.

pub async fn install_disco_key_sink( &self, sink: Option<DataplaneToDiscoKeySink>, )

Install (Some) or clear (None) the sink that receives peer disco keys learned from TSMP disco-key advertisements (Go packet.TSMPDiscoKeyAdvertisement).

Install this before run starts: an advertisement arrives immediately after a WireGuard session is established, so a sink installed later can miss the first one.

pub async fn run(&self) -> Infallible

Run the data plane forever, moving packets from the input queues to output queues.

pub async fn step(&self)

Run the data plane for a single step.

pub async fn inner(&self) -> impl DerefMut<Target = DataPlane>

Get a mutable reference to the inner crate::DataPlane.

Primarily intended for mutating the routing tables.

The returned value is a mutex guard, so limit how long it’s held.