6 releases
0.3.0 | Jun 26, 2022 |
---|---|
0.2.0 | May 31, 2022 |
0.1.3 | May 11, 2022 |
#693 in Operating systems
38 downloads per month
45KB
1K
SLoC
Tunio
Create TUN/TAP interfaces in cross-platform and idiomatic Rust!
Features ⭐
- Tokio support (optional).
- TUN/TAP support.
- Extensible architecture for adding other platforms later.
Short example 📜
use std::io::{Read, Write};
use tunio::traits::{DriverT, InterfaceT};
use tunio::{DefaultDriver, DefaultInterface};
fn main() {
// DefaultDriver is an alias for a supported driver for current platform.
// It may be not optimal for your needs (for example, it can lack support of TAP),
// but it will work in some cases. If you need another driver, then import and use it instead.
let mut driver = DefaultDriver::new().unwrap();
// Preparing configuration for new interface. We use `Builder` pattern for this.
let if_config = DefaultDriver::if_config_builder()
.name("iface1".to_string())
.build()
.unwrap();
// Then, we create the interface using config and start it immediately.
let mut interface = DefaultInterface::new_up(&mut driver, if_config).unwrap();
// The interface is created and running.
// Write to interface using Write trait
let buf = [0u8; 4096];
let _ = interface.write(&buf);
// Read from interface using Read trait
let mut mut_buf = [0u8; 4096];
let _ = interface.read(&mut mut_buf);
}
Supported platforms 🖥️
- Windows, TUN only (using
Wintun
driver). - Linux
macOS support for utun and feth drivers is planned. Feel free to post a PR, it is always greatly appreciated 😉
Related projects 🔗
netconfig
: A high-level abstraction for gathering and changing network interface configuration.
Dependencies
~3–46MB
~674K SLoC