diff options
author | Mathias Hall-Andersen <mathias@hall-andersen.dk> | 2019-08-17 16:31:08 +0200 |
---|---|---|
committer | Mathias Hall-Andersen <mathias@hall-andersen.dk> | 2019-08-17 16:31:08 +0200 |
commit | 78ab1a93e6d519bf404fbe61fc7ec3c3ab35a72a (patch) | |
tree | 75106e1ff89a03a6869184994b902a70315dfc30 /src/types/tun.rs | |
parent | Begin drafting cross-platform interface (diff) | |
download | wireguard-rs-78ab1a93e6d519bf404fbe61fc7ec3c3ab35a72a.tar.xz wireguard-rs-78ab1a93e6d519bf404fbe61fc7ec3c3ab35a72a.zip |
Remove peer from cryptkey router on drop
Diffstat (limited to '')
-rw-r--r-- | src/types/tun.rs | 43 |
1 files changed, 43 insertions, 0 deletions
diff --git a/src/types/tun.rs b/src/types/tun.rs new file mode 100644 index 0000000..72caa71 --- /dev/null +++ b/src/types/tun.rs @@ -0,0 +1,43 @@ +use std::error; + +pub trait Tun: Send + Sync { + type Error: error::Error; + + /// Returns the MTU of the device + /// + /// This function needs to be efficient (called for every read). + /// The goto implementation stragtegy is to .load an atomic variable, + /// then use e.g. netlink to update the variable in a seperate thread. + /// + /// # Returns + /// + /// The MTU of the interface in bytes + fn mtu(&self) -> usize; + + /// Reads an IP packet into dst[offset:] from the tunnel device + /// + /// The reason for providing space for a prefix + /// is to efficiently accommodate platforms on which the packet is prefaced by a header. + /// This space is later used to construct the transport message inplace. + /// + /// # Arguments + /// + /// - dst: Destination buffer (enough space for MTU bytes + header) + /// - offset: Offset for the beginning of the IP packet + /// + /// # Returns + /// + /// The size of the IP packet (ignoring the header) or an std::error::Error instance: + fn read(&self, dst: &mut [u8], offset: usize) -> Result<usize, Self::Error>; + + /// Writes an IP packet to the tunnel device + /// + /// # Arguments + /// + /// - src: Buffer containing the IP packet to be written + /// + /// # Returns + /// + /// Unit type or an error + fn write(&self, src: &[u8]) -> Result<(), Self::Error>; +} |