Struct DeviceSynchronousProxy

pub struct DeviceSynchronousProxy { /* private fields */ }

Implementations

impl DeviceSynchronousProxy

pub fn new(channel: Channel) -> Self

pub fn into_channel(self) -> Channel

pub fn wait_for_event( &self, deadline: MonotonicInstant, ) -> Result<DeviceEvent, Error>

Waits until an event arrives and returns it. It is safe for other threads to make concurrent requests while waiting for an event.

pub fn write_frame( &self, frame: &Frame, ___deadline: MonotonicInstant, ) -> Result<DeviceWriteFrameResult, Error>

Writes a frame to the device (data coming from network-end).

If the device was created with the [fuchsia.net.tun/DeviceConfig.blocking] option set to true, calls to WriteFrame block until there is one buffer available to fulfill the request.

• request frame inbound frame data and metadata.

• error ZX_ERR_NOT_FOUND if [Frame.port] references an unknown port.
• error ZX_ERR_INVALID_ARGS if frame is invalid.
• error ZX_ERR_BAD_STATE if the device is offline.
• error ZX_ERR_BAD_STATE if the device is offline.
• error ZX_ERR_NO_RESOURCES if more than [fuchsia.net.tun/MAX_PENDING_OPERATIONS] calls to WriteFrame are pending.
• error ZX_ERR_SHOULD_WAIT if blocking is set to false and there are no buffers available to fulfill the request.

pub fn read_frame( &self, ___deadline: MonotonicInstant, ) -> Result<DeviceReadFrameResult, Error>

Gets the next frame from the device (data coming from host-end).

If the device was created with the [fuchsia.net.tun/DeviceConfig.blocking] option set to true, calls to ReadFrame block until there is a frame available to be read.

• response frame outbound frame data and metadata.

• error ZX_ERR_NO_RESOURCES if more than [fuchsia.net.tun/MAX_PENDING_OPERATIONS] calls to ReadFrame are pending.
• error ZX_ERR_SHOULD_WAIT if blocking is set to false and there are no frames to be read.

pub fn get_signals( &self, ___deadline: MonotonicInstant, ) -> Result<EventPair, Error>

Retrieves signals eventpair.

• response signals an eventpair that is signalled with SIGNAL_READABLE and SIGNAL_WRITABLE when read and write buffers are available, respectively.

pub fn add_port( &self, config: &DevicePortConfig, port: ServerEnd<PortMarker>, ) -> Result<(), Error>

Creates a new port on this device.

• request config new port configuration.
• request port grants control over the port. Closed with an epitaph if config is not valid.

pub fn get_device(&self, device: ServerEnd<DeviceMarker>) -> Result<(), Error>

Connects to the underlying device endpoint.

• request device device handle.

pub fn delegate_rx_lease(&self, lease: DelegatedRxLease) -> Result<(), Error>

Delegates an rx lease through the tun device.

See documentation on [fuchsia.hardware.network/DelegatedRxLease] for proper usage.

Trait Implementations

impl Debug for DeviceSynchronousProxy

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

Formats the value using the given formatter.

impl SynchronousProxy for DeviceSynchronousProxy

type Proxy = DeviceProxy

The async proxy for the same protocol.

type Protocol = DeviceMarker

The protocol which this Proxy controls.

fn from_channel(inner: Channel) -> Self

Create a proxy over the given channel.

fn into_channel(self) -> Channel

Convert the proxy back into a channel.

fn as_channel(&self) -> &Channel

Get a reference to the proxy’s underlying channel.

fn is_closed(&self) -> Result<bool, Status>

Returns true if the proxy has received the PEER_CLOSED signal.