Struct ControlProxy 

pub struct ControlProxy { /* private fields */ }

Implementations

impl ControlProxy

pub fn new(channel: AsyncChannel) -> Self

Create a new Proxy for fuchsia.net.sockets/Control.

pub fn take_event_stream(&self) -> ControlEventStream

Get a Stream of events from the remote end of the protocol.

Panics

Panics if the event stream was already taken.

pub fn disconnect_ip( &self, payload: &ControlDisconnectIpRequest, ) -> QueryResponseFut<DisconnectIpResult, DefaultFuchsiaResourceDialect>

Disconnect the socket matched by the provided matchers. See Diagnostics.IterateIp for matcher semantics.

Disconnecting a socket depends on the transport protocol. In all cases, the next read or write operation will see ECONNABORTED.

• UDP: the behavior is equivalent to calling fuchsia.posix.socket/*.Disconnect. Any destination port and address, and bound device are removed. The socket may be reused.
• TCP LISTEN state: TCP moves to state CLOSE. All non-accepted sockets are closed and an RST is sent to the peer. The socket may be reused.
• TCP all other states: The TCP connection is put in state CLOSE and an RST is sent to the remote peer, if required. The socket may not be reused.

If no matchers are specified, or the provided matchers match all sockets, an error is returned and no action is taken.

NOTE: This operation is asynchronous. While the internal state of the socket is updated before this call returns, propagation of the error to an application is unsynchronized. Subsequent operations (such as TCP reads and writes) may not immediately see the error.

NOTE: For UDP sockets, the receive buffer is not cleared, so it’s possible for a socket to be interrupted, but still read pending datagrams. This is in order to maintain compatibility with Linux.

Trait Implementations

impl Clone for ControlProxy

fn clone(&self) -> ControlProxy

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl ControlProxyInterface for ControlProxy

type DisconnectIpResponseFut = QueryResponseFut<DisconnectIpResult>

fn disconnect_ip( &self, payload: &ControlDisconnectIpRequest, ) -> Self::DisconnectIpResponseFut

impl Debug for ControlProxy

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

Formats the value using the given formatter.

impl Proxy for ControlProxy

type Protocol = ControlMarker

The protocol which this Proxy controls.

fn from_channel(inner: AsyncChannel) -> Self

Create a proxy over the given channel.

fn into_channel(self) -> Result<AsyncChannel, Self>

Attempt to convert the proxy back into a channel.

fn as_channel(&self) -> &AsyncChannel

Get a reference to the proxy’s underlying channel.

fn into_client_end(self) -> Result<ClientEnd<Self::Protocol>, Self>

Attempt to convert the proxy back into a client end.

fn is_closed(&self) -> bool

Returns true if the proxy has received the PEER_CLOSED signal.

fn on_closed(&self) -> OnSignals<'_, Unowned<'_, NullableHandle>>

Returns a future that completes when the proxy receives the PEER_CLOSED signal.