Uses old Rust 2015
0.1.2 |
|
---|
#20 in #tun-tap
22KB
217 lines
TunTap
TUN/TAP wrapper for Rust.
The TUN/TAP allows implementing a virtual network adapter in userspace. This provides the bindings for Rust.
Create an Iface
object and send
or recv
packets. Making some sense of the
packets is, however, out of scope, you need something else for that.
There's documentation and some examples.
Known issues
- Tested only on MacOS. Probably doesn't work anywhere else, but pull requests adding support for other OSes are welcome.
- The asynchronous interface is very minimal and probably inefficient. It'll need to be extended to allow more flexible or efficient use.
Testing
In order to run the tests correctly, a tun10
device with 10.10.10.1/24
needs
to be created first. You can simply run:
sh tests/setup.sh
To remove it:
sh tests/clean.sh
Sudo permission is required.
License
Licensed under either of
- Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
Dependencies
~0–1.4MB
~22K SLoC