TUN interfaces

This crate allows the creation and usage of TUN interfaces, the aim is to make this cross-platform but right now it only supports Linux.

Usage

First, add the following to your Cargo.toml:

toml [dependencies] tun = "0.3"

Next, add this to your crate root:

rust extern crate tun;

If you want to use the TUN interface with mio/tokio, you need to enable the mio feature:

toml [dependencies] tun = { version = "0.3", features = ["mio"] }

Example

The following example creates and configures a TUN interface and starts reading packets from it.

```rust use std::io::Read;

extern crate tun;

fn main() { let mut config = tun::Configuration::default(); config.address((10, 0, 0, 1)) .netmask((255, 255, 255, 0)) .up();

#[cfg(target_os = "linux")]
config.platform(|config| {
    config.packet_information(true);
});

let mut dev = tun::create(&config).unwrap();
let mut buf = [0; 4096];

loop {
    let amount = dev.read(&mut buf).unwrap();
    println!("{:?}", &buf[0 .. amount]);
}

} ```

Platforms

Not every platform is supported.

Linux

You will need the tun module to be loaded and root is required to create interfaces.

macOS

It just werks, but you have to set up routing manually.