diff options
| author | Yu Watanabe <watanabe.yu+github@gmail.com> | 2020-07-19 06:57:51 +0200 |
|---|---|---|
| committer | Yu Watanabe <watanabe.yu+github@gmail.com> | 2020-07-20 21:12:16 +0200 |
| commit | 711dd5db9e1935a20158727f4a27d12a64ba48e7 (patch) | |
| tree | 5f812fceb0c8c1222bdd7cf6f84e80898bcefe11 /man/resolvectl.xml | |
| parent | resolvectl: use bus_message_read_in_addr_auto() (diff) | |
| download | systemd-711dd5db9e1935a20158727f4a27d12a64ba48e7.tar.xz systemd-711dd5db9e1935a20158727f4a27d12a64ba48e7.zip | |
man: update explanation about the format to specify DNS servers
Diffstat (limited to 'man/resolvectl.xml')
| -rw-r--r-- | man/resolvectl.xml | 23 |
1 files changed, 14 insertions, 9 deletions
diff --git a/man/resolvectl.xml b/man/resolvectl.xml index 0ae70dc34b..a4bd8f52d7 100644 --- a/man/resolvectl.xml +++ b/man/resolvectl.xml @@ -145,15 +145,20 @@ settings for network interfaces. These commands may be used to inform <command>systemd-resolved</command> or <command>systemd-networkd</command> about per-interface DNS configuration determined through external means. The <command>dns</command> command expects IPv4 or - IPv6 address specifications of DNS servers to use. The <command>domain</command> command expects - valid DNS domains, possibly prefixed with <literal>~</literal>, and configures a per-interface - search or route-only domain. The <command>default-route</command> command expects a boolean - parameter, and configures whether the link may be used as default route for DNS lookups, i.e. if it - is suitable for lookups on domains no other link explicitly is configured for. The - <command>llmnr</command>, <command>mdns</command>, <command>dnssec</command> and - <command>dnsovertls</command> commands may be used to configure the per-interface LLMNR, - MulticastDNS, DNSSEC and DNSOverTLS settings. Finally, <command>nta</command> command may be used - to configure additional per-interface DNSSEC NTA domains.</para> + IPv6 address specifications of DNS servers to use. Each address can optionally take a port number + separated with <literal>:</literal>, a network interface name or index separated with + <literal>%</literal>, and a Server Name Indication (SNI) separated with <literal>#</literal>. When + IPv6 address is specified with a port number, then the address must be in the square brackets. That + is, the acceptable full formats are <literal>111.222.333.444:9953%ifname#example.com</literal> for + IPv4 and <literal>[1111:2222::3333]:9953%ifname#example.com</literal> for IPv6. The + <command>domain</command> command expects valid DNS domains, possibly prefixed with + <literal>~</literal>, and configures a per-interface search or route-only domain. The + <command>default-route</command> command expects a boolean parameter, and configures whether the + link may be used as default route for DNS lookups, i.e. if it is suitable for lookups on domains no + other link explicitly is configured for. The <command>llmnr</command>, <command>mdns</command>, + <command>dnssec</command> and <command>dnsovertls</command> commands may be used to configure the + per-interface LLMNR, MulticastDNS, DNSSEC and DNSOverTLS settings. Finally, <command>nta</command> + command may be used to configure additional per-interface DNSSEC NTA domains.</para> <para>Commands <command>dns</command>, <command>domain</command> and <command>nta</command> can take a single empty string argument to clear their respective value lists.</para> |