Struct VCLTun 

pub struct VCLTun { /* private fields */ }

A TUN virtual network interface for capturing and injecting IP packets.

Requires root or CAP_NET_ADMIN. Linux only.

Implementations

impl VCLTun

pub fn create(config: TunConfig) -> Result<Self, VCLError>

Create and configure a new TUN interface.

Errors

Returns VCLError::IoError if:

• Not running as root / missing CAP_NET_ADMIN
• Interface name is invalid or already in use
• TUN driver not available

pub async fn read_packet(&mut self) -> Result<Vec<u8>, VCLError>

Read the next IP packet from the TUN interface.

Blocks asynchronously until a packet is available. Returns raw bytes including the IP header.

Errors

Returns VCLError::IoError on read failure.

pub async fn write_packet(&mut self, packet: &[u8]) -> Result<(), VCLError>

Write (inject) a raw IP packet into the TUN interface.

The packet will appear as if it came from the network and will be delivered to the appropriate local socket.

Errors

Returns VCLError::IoError on write failure.

pub fn name(&self) -> &str

Returns the name of the TUN interface (e.g. “vcl0”).

pub fn mtu(&self) -> u16

Returns the MTU configured for this interface.

pub fn address(&self) -> Ipv4Addr

Returns the local IP address of the TUN interface.

pub fn destination(&self) -> Ipv4Addr

Returns the remote destination IP of the TUN interface.

pub fn config(&self) -> &TunConfig

Returns a reference to the full TunConfig.