Google is committed to advancing racial equity for Black communities. See how.

fuchsia.net.name

PROTOCOLS

DnsServerWatcher

Defined in fuchsia.net.name/server_watcher.fidl

Provides a hanging get interface to watch for DNS servers configuration.

WatchServers

Returns a list of DNS servers.

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 WatchServers while a previous call is still pending. Doing so will cause the DnsServerWatcher channel to be closed.

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

Request

NameType

Response

NameType
servers vector<DnsServer>

LookupAdmin

Defined in fuchsia.net.name/lookup_admin.fidl

Provides administration controls over name resolution settings.

GetDnsServers

Gets the DNS servers currently in use to resolve name lookups.

  • response servers The list of servers in use by LookupAdmin, in priority order.

Request

NameType

Response

NameType
servers vector<fuchsia.net/SocketAddress>

SetDnsServers

Sets the DNS servers to servers

  • request servers The list of servers to use for domain name resolution, in priority order. An empty list means no servers will be used and name resolution may fail. Each SocketAddress in servers must be a valid unicast socket address. The list of servers will be deduplicated.
  • error Returns ZX_ERR_INVALID_ARGS if any of the provided addresses does not meet the conditions above.

Request

NameType
servers vector<fuchsia.net/SocketAddress>

Response

NameType
result LookupAdmin_SetDnsServers_Result

STRUCTS

LookupAdmin_SetDnsServers_Response

Defined in fuchsia.net.name/lookup_admin.fidl

NameTypeDescriptionDefault

TABLES

DhcpDnsServerSource

Defined in fuchsia.net.name/dns.fidl

Extra information about DNS servers discovered through DHCPv4.

OrdinalNameTypeDescription
1 source_interface uint64

The interface index over which this server was discovered.

Dhcpv6DnsServerSource

Defined in fuchsia.net.name/dns.fidl

Extra information about DNS servers discovered through DHCPv6.

OrdinalNameTypeDescription
1 source_interface uint64

The interface index over which this server was discovered.

DnsServer

Defined in fuchsia.net.name/dns.fidl

A DNS server configuration.

OrdinalNameTypeDescription
1 address fuchsia.net/SocketAddress

The server's address, must be provided.

2 source DnsServerSource

The configuration source for this server. Defaults to DnsServerSource.static_source.

NdpDnsServerSource

Defined in fuchsia.net.name/dns.fidl

Extra information about DNS servers discovered through NDP.

OrdinalNameTypeDescription
1 source_interface uint64

The interface index over which this server was discovered.

StaticDnsServerSource

Defined in fuchsia.net.name/dns.fidl

Extra information about statically set DNS servers.

OrdinalNameTypeDescription

UNIONS

DnsServerSource

Defined in fuchsia.net.name/dns.fidl

The configuration source for a DnsServer.

NameTypeDescription
static_source StaticDnsServerSource

The server is statically configured through LookupAdmin.SetDefaultServers.

dhcp DhcpDnsServerSource

The server was discovered through DHCPv4.

ndp NdpDnsServerSource

The server was discovered through an NDP Router Advertisement.

dhcpv6 Dhcpv6DnsServerSource

The server was discovered through DHCPv6.

LookupAdmin_SetDnsServers_Result

Defined in fuchsia.net.name/lookup_admin.fidl

NameTypeDescription
response LookupAdmin_SetDnsServers_Response
err zx/status