diff --git a/man/resolvectl.xml b/man/resolvectl.xml index 8c1d6e5de4..594e22c03f 100644 --- a/man/resolvectl.xml +++ b/man/resolvectl.xml @@ -53,13 +53,15 @@ - + query HOSTNAME|ADDRESS… Resolve domain names, IPv4 and IPv6 addresses. - + service + [[NAME] TYPE] + DOMAIN Resolve DNS-SD and SRV services, depending on the specified list of parameters. @@ -71,7 +73,7 @@ - + openpgp EMAIL@DOMAIN… Query PGP keys stored as OPENPGPKEY resource records. Specified e-mail addresses are converted to the corresponding DNS domain name, and any @@ -79,7 +81,9 @@ - + tlsa + [FAMILY] + DOMAIN[:PORT]… Query TLS public keys stored as TLSA resource records. A query will be performed for each of the specified names prefixed with the port and family @@ -89,28 +93,28 @@ - + status [LINK…] Shows the global and per-link DNS settings currently in effect. If no command is specified, this is the implied default. - + statistics Shows general resolver statistics, including information whether DNSSEC is enabled and available, as well as resolution and validation statistics. - + reset-statistics - Resets the statistics counters shown in to zero. + Resets the statistics counters shown in statistics to zero. This operation requires root privileges. - + flush-caches Flushes all DNS resource record caches the service maintains locally. This is mostly equivalent to sending the SIGUSR2 to the systemd-resolved @@ -118,7 +122,7 @@ - + reset-server-features Flushes all feature level information the resolver learnt about specific servers, and ensures that the server feature probing logic is started from the beginning with the next look-up request. This is @@ -127,46 +131,48 @@ - - - - - - - - + dns [LINK [SERVER…]] + domain [LINK [DOMAIN…]] + default-route [LINK [BOOL…]] + llmnr [LINK [MODE]] + mdns [LINK [MODE]] + dnssec [LINK [MODE]] + dnsovertls [LINK [MODE]] + nta [LINK [DOMAIN…]] - Get/set per-interface DNS configuration. These commands may be used to configure various DNS settings - for network interfaces. These commands may be used to inform systemd-resolved or - systemd-networkd about per-interface DNS configuration determined - through external means. The command expects IPv4 or IPv6 address specifications of DNS - servers to use. The command expects valid DNS domains, possibly prefixed with - ~, and configures a per-interface search or route-only domain. The - 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 , , and - commands may be used to configure the per-interface LLMNR, MulticastDNS, DNSSEC - and DNSOverTLS settings. Finally, command may be used to configure additional - per-interface DNSSEC NTA domains. + Get/set per-interface DNS configuration. These commands may be used to configure various DNS + settings for network interfaces. These commands may be used to inform + systemd-resolved or systemd-networkd about per-interface DNS + configuration determined through external means. The dns command expects IPv4 or + IPv6 address specifications of DNS servers to use. The domain command expects + valid DNS domains, possibly prefixed with ~, and configures a per-interface + search or route-only domain. The default-route 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 + llmnr, mdns, dnssec and + dnsovertls commands may be used to configure the per-interface LLMNR, + MulticastDNS, DNSSEC and DNSOverTLS settings. Finally, nta command may be used + to configure additional per-interface DNSSEC NTA domains. - Options , and can take + Commands dns, domain and nta can take a single empty string argument to clear their respective value lists. - For details about these settings, their possible values and their effect, see the corresponding options in + For details about these settings, their possible values and their effect, see the + corresponding settings in systemd.network5. - + revert LINK Revert the per-interface DNS configuration. If the DNS configuration is reverted all - per-interface DNS setting are reset to their defaults, undoing all effects of , - , , , , - , , . Note that when a network interface - disappears all configuration is lost automatically, an explicit reverting is not necessary in that - case. + per-interface DNS setting are reset to their defaults, undoing all effects of dns, + domain, default-route, llmnr, + mdns, dnssec, dnsovertls, + nta. Note that when a network interface disappears all configuration is lost + automatically, an explicit reverting is not necessary in that case.