lwip

Crates.iolwip
lib.rslwip
version0.3.15
sourcesrc
created_at2023-11-22 11:36:51.72421
updated_at2023-12-17 05:45:19.58353
descriptionRust bindings for the lwIP TCP/IP stack
homepagehttps://github.com/ssrlive/lwip
repository
max_upload_size
id1045106
size9,949,130
hev (heiher)

documentation

https://docs.rs/lwip

README

lwip - A Rust wrapper for lwIP

Version Documentation Download

A netstack for the special purpose of turning packets from/to a TUN interface into TCP streams and UDP packets. It uses lwIP as the backend netstack.

use futures::{SinkExt, StreamExt};

let (stack, mut tcp_listener, udp_socket) = ::lwip::NetStack::new().unwrap();
let (mut stack_sink, mut stack_stream) = stack.split();

// tun device is assumed implementing `Stream` and `Sink`
let (mut tun_sink, mut tun_stream) = tun.split();

// Reads packet from stack and sends to TUN.
tokio::spawn(async move {
    while let Some(pkt) = stack_stream.next().await {
        if let Ok(pkt) = pkt {
            tun_sink.send(pkt).await.unwrap();
        }
    }
});

// Reads packet from TUN and sends to stack.
tokio::spawn(async move {
    while let Some(pkt) = tun_stream.next().await {
        if let Ok(pkt) = pkt {
            stack_sink.send(pkt).await.unwrap();
        }
    }
});

// Extracts TCP connections from stack and sends them to the dispatcher.
tokio::spawn(async move {
    while let Some((stream, local_addr, remote_addr)) = tcp_listener.next().await {
        tokio::spawn(handle_inbound_stream(stream, local_addr, remote_addr));
    }
});

// Receive and send UDP packets between netstack and NAT manager. The NAT
// manager would maintain UDP sessions and send them to the dispatcher.
tokio::spawn(async move {
    handle_inbound_datagram(udp_socket).await;
});
Commit count: 0

cargo fmt