Struct DnsServerWatcherProxy

pub struct DnsServerWatcherProxy { /* private fields */ }

Implementations

impl DnsServerWatcherProxy

pub fn new(channel: AsyncChannel) -> Self

Create a new Proxy for fuchsia.netpol.socketproxy/DnsServerWatcher.

pub fn take_event_stream(&self) -> DnsServerWatcherEventStream

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

Panics

Panics if the event stream was already taken.

pub fn watch_servers( &self, ) -> QueryResponseFut<Vec<DnsServerList>, DefaultFuchsiaResourceDialect>

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, ) -> QueryResponseFut<(), DefaultFuchsiaResourceDialect>

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 Clone for DnsServerWatcherProxy

fn clone(&self) -> DnsServerWatcherProxy

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for DnsServerWatcherProxy

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

Formats the value using the given formatter.

impl DnsServerWatcherProxyInterface for DnsServerWatcherProxy

type WatchServersResponseFut = QueryResponseFut<Vec<DnsServerList>>

type CheckPresenceResponseFut = QueryResponseFut<()>

fn watch_servers(&self) -> Self::WatchServersResponseFut

fn check_presence(&self) -> Self::CheckPresenceResponseFut

impl Proxy for DnsServerWatcherProxy

type Protocol = DnsServerWatcherMarker

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<'_, Handle>>

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