4 releases
new 0.2.0-alpha.2 | May 19, 2024 |
---|---|
0.1.1 | May 9, 2024 |
0.1.0 | May 5, 2024 |
#970 in Network programming
282 downloads per month
71KB
1.5K
SLoC
l3_extract
extract layer 4 connection from layer 3
This crate aim to provide a way to allow users manipulate TCP and UDP which is obtained from layer-3 protocol packet, like normal async TCP stream and async UDP socket.
This crate is based on smoltcp
, which is a single threaded, serial and event driven
userspace TCP network stack crate, but this crate allows users use TcpStream
,
UdpSocket
and others concurrently.
Notes:
In order to hide the smoltcp
single threaded, serial and event driven implement detail, the
TcpStream
will use channel to communicate with the TcpStack
, and to improve
performance, TcpStream
has an inner buffer to reduce channel send.
This crate put ease of use first, then performance, so it absolutely slower than kernel TCP
network stack, also slower than use smoltcp
with hand write event loop.
Examples:
use std::net::Ipv4Addr;
use std::str::FromStr;
use futures_util::{AsyncRead, AsyncWrite, StreamExt, TryStreamExt};
use futures_util::stream::FuturesUnordered;
use futures_util::task::SpawnExt;
use smoltcp::wire::Ipv4Cidr;
use l3_extract::{Connection, TcpStack, Timer};
use futures_timer::Delay;
#[derive(Default)]
struct MyTimer;
impl Timer for MyTimer {
async fn sleep(&mut self, dur: Duration) {
Delay::new(dur).await
}
}
async fn run() {
let connection = create_layer3_connection();
let (mut tcp_stack, mut tcp_acceptor, mut udp_acceptor) = TcpStack::builder()
.ipv4_addr(Ipv4Cidr::from_str("192.168.100.10/24").unwrap())
.ipv4_gateway(Ipv4Addr::new(192, 168, 100, 1))
.build(connection, MyTimer::default()).unwrap();
let mut futs = FuturesUnordered::new();
futs.spawn(async {
tcp_stack.run().await.unwrap()
}).unwrap();
futs.spawn(async {
let tcp_stream = tcp_acceptor.try_next().await.unwrap().unwrap();
// do something with tcp_stream
}).unwrap();
futs.spawn(async {
let udp_socket = udp_acceptor.try_next().await.unwrap().unwrap();
// do something with udp_socket
}).unwrap();
futs.collect::<Vec<_>>().await;
}
async fn create_layer3_connection() -> impl Connection {
// create a layer3 connection
}
Dependencies
~7MB
~138K SLoC