Struct AsyncDevice

pub struct AsyncDevice(/* private fields */);

Available on crate feature tokio only.

Represents a non-blocking TUN/TAP device.

Contains the shared code between AsyncTun and AsyncTap.

Implementations

impl AsyncDevice

pub fn try_recv(&self, buf: &mut [u8]) -> Result<usize>

Tries to read data from the device and fill the buffer buf.

Arguments

• buf: Buffer to be filled with the data read from the device.

Returns

• Ok: Containing the number of bytes read from the device.
• Err: If the device was not ready to be read(a WOULDBLOCK err), or some other error occurred.

pub fn try_send(&self, buf: &[u8]) -> Result<usize>

Tries to write data from the buf to the device.

Arguments

• buf: Data to be written to the device.

Returns

• Ok: Containing the number of bytes written to the device.
• Err: If the device was not ready to be written to(a WOULDBLOCK err), or some other error occurred.

pub async fn recv(&self, buf: &mut [u8]) -> Result<usize>

Asyncronously reads data from the device and writes to the buf.

Arguments

• buf: Buffer to be filled with the data read from the device.

Returns

• Ok: Containing the number of bytes read from the device.
• Err: If reading data was unsuccessful.

pub async fn send(&self, buf: &[u8]) -> Result<usize>

Asyncronously writes data from buf to the device.

Arguments

• buf: Buffer to be written to the device.

Returns

• Ok: Containing the number of bytes written from the device.
• Err: If writting data was unsuccessful.

Methods from Deref<Target = Device>

pub fn name(&self) -> String

Returns The name of the device chosen by the kernel.

pub fn flags(&self) -> Result<Flags>

Returns the active flags of the interface.

pub fn bring_up(&self) -> Result<()>

Brings the device up which makes it ready to send and receive packets.

pub fn bring_down(&self) -> Result<()>

Brings the device down which makes it unable to send and receive packets.

pub fn set_mtu(&self, mtu: i32) -> Result<()>

Sets the MTU of the device.

pub fn get_mtu(&self) -> Result<i32>

Returns the MTU of the device.

pub fn set_netmask(&self, netmask: Ipv4Addr) -> Result<()>

Sets the netmask of the device.

pub fn get_netmask(&self) -> Result<Ipv4Addr>

Sets the netmask of the device.

pub fn get_index(&self) -> Result<i32>

Returns the index of the interface.

pub fn set_ipv6_addr(&self, addr: Ipv6Addr) -> Result<()>

Adds the specified addr to the list of IPv6 addresses of the interface.

pub fn get_ipv6_addrs(&self) -> Result<Vec<Ipv6Addr>>

Returns the list of IPv6 addresses of the interface.

pub fn del_ipv6_addr(&self, addr: Ipv6Addr) -> Result<()>

Deletes the specified IPv6 address from the interface.

pub fn set_addr(&self, addr: Ipv4Addr) -> Result<()>

Sets the IPv4 address of the device.

pub fn get_addr(&self) -> Result<Ipv4Addr>

Returns the IPv4 address of the device.

pub fn del_addr(&self) -> Result<()>

Deletes the IPv4 address of the interface.

pub fn set_brd_addr(&self, addr: Ipv4Addr) -> Result<()>

Sets the broadcast IPv4 address of the device.

pub fn get_brd_addr(&self) -> Result<Ipv4Addr>

Returns the broadcast IPv4 address of the device.

pub fn set_dst_addr(&self, addr: Ipv4Addr) -> Result<()>

Sets the destination IPv4 address of the device.

pub fn get_dst_addr(&self) -> Result<Ipv4Addr>

Returns the destination IPv4 address of the device.

pub fn send(&self, buf: &[u8]) -> Result<usize>

Writes the data in buf into the device.

pub fn recv(&self, buf: &mut [u8]) -> Result<usize>

Reads the data from device into buf.

Trait Implementations

impl AsyncRead for AsyncDevice

fn poll_read( self: Pin<&mut Self>, cx: &mut Context<'_>, buf: &mut ReadBuf<'_>, ) -> Poll<Result<()>>

Attempts to read from the AsyncRead into buf.

impl AsyncWrite for AsyncDevice

fn poll_write( self: Pin<&mut Self>, cx: &mut Context<'_>, buf: &[u8], ) -> Poll<Result<usize>>

Attempt to write bytes from buf into the object.

fn poll_flush(self: Pin<&mut Self>, _cx: &mut Context<'_>) -> Poll<Result<()>>

Attempts to flush the object, ensuring that any buffered data reach their destination.

fn poll_shutdown( self: Pin<&mut Self>, _cx: &mut Context<'_>, ) -> Poll<Result<()>>

Initiates or attempts to shut down this writer, returning success when the I/O connection has completely shut down.

fn poll_write_vectored( self: Pin<&mut Self>, cx: &mut Context<'_>, bufs: &[IoSlice<'_>], ) -> Poll<Result<usize, Error>>

Like poll_write, except that it writes from a slice of buffers.

fn is_write_vectored(&self) -> bool

Determines if this writer has an efficient poll_write_vectored implementation.

impl Debug for AsyncDevice

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Deref for AsyncDevice

type Target = Device

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl DerefMut for AsyncDevice

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.