Struct DnsServerWatcherSynchronousProxy

pub struct DnsServerWatcherSynchronousProxy { /* private fields */ }

Implementations

impl DnsServerWatcherSynchronousProxy

pub fn new(channel: Channel) -> Self

pub fn into_channel(self) -> Channel

pub fn wait_for_event( &self, deadline: MonotonicInstant, ) -> Result<DnsServerWatcherEvent, 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 watch_servers( &self, ___deadline: MonotonicInstant, ) -> Result<Vec<DnsServerList>, Error>

Returns a list of DNS servers registered with the socketproxy.

First call always returns a snapshot of the current list of servers or blocks if an empty list would be returned. Subsequent calls will block until the list of servers changes.

The list of servers changes over time by configuration or network topology changes, expiration, etc. Callers must repeatedly call WatchServers and replace any previously returned servers with new ones to avoid using stale or expired entries.

It is invalid to call this method while a previous call is pending. Doing so will cause the server end of the protocol to be closed.

• response servers The list of servers to use for DNS resolution, in priority order.

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

No-op method that allows checking for presence.

TODO(https://fxbug.dev/296283299): It’s not currently possible for a client with an optionally-provided protocol to check whether there’s someone on the other end without making a FIDL call . This method provides a workaround by giving a client a method that it can call to check for liveness.

Trait Implementations

impl Debug for DnsServerWatcherSynchronousProxy

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

Formats the value using the given formatter.

impl SynchronousProxy for DnsServerWatcherSynchronousProxy

type Proxy = DnsServerWatcherProxy

The async proxy for the same protocol.

type Protocol = DnsServerWatcherMarker

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.