blob: 68f9437211cd8b03e44a2832ccabf746221a520c [file] [log] [blame]
// Copyright 2020 The Fuchsia Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
@available(added=11)
library fuchsia.net.name;
using fuchsia.net;
using zx;
/// Provides administration controls over name resolution settings.
@discoverable
protocol LookupAdmin {
/// 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.
SetDnsServers(struct {
servers vector<fuchsia.net.SocketAddress>:MAX;
}) -> () error zx.status;
/// Gets the DNS servers currently in use to resolve name lookups.
/// - response `servers` The list of servers in use by `LookupAdmin`, in priority order.
GetDnsServers() -> (struct {
servers vector<fuchsia.net.SocketAddress>:MAX;
});
};