summaryrefslogtreecommitdiffstats
path: root/man/resolvectl.xml
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--man/resolvectl.xml68
1 files changed, 39 insertions, 29 deletions
diff --git a/man/resolvectl.xml b/man/resolvectl.xml
index 4498732..ed656b4 100644
--- a/man/resolvectl.xml
+++ b/man/resolvectl.xml
@@ -1,6 +1,6 @@
<?xml version='1.0'?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
- "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
+ "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
<!-- SPDX-License-Identifier: LGPL-2.1-or-later -->
<refentry id="resolvectl" conditional='ENABLE_RESOLVE'
@@ -69,6 +69,9 @@
<option>--type=</option>/<option>--class=</option> is used IDNA translation is turned off and domain
names are processed as specified.</para>
+ <para>If combined with <option>--json=</option> (only supported in combination with
+ <option>--type=</option>) will output the resource record data in a JSON object.</para>
+
<xi:include href="version-info.xml" xpointer="v239"/></listitem>
</varlistentry>
@@ -275,7 +278,7 @@
<varlistentry>
<term><option>-i</option> <replaceable>INTERFACE</replaceable></term>
- <term><option>--interface=</option><replaceable>INTERFACE</replaceable></term>
+ <term><option>--interface=<replaceable>INTERFACE</replaceable></option></term>
<listitem><para>Specifies the network interface to execute the query on. This may either be specified as numeric
interface index or as network interface string (e.g. <literal>en0</literal>). Note that this option has no
@@ -287,7 +290,7 @@
<varlistentry>
<term><option>-p</option> <replaceable>PROTOCOL</replaceable></term>
- <term><option>--protocol=</option><replaceable>PROTOCOL</replaceable></term>
+ <term><option>--protocol=<replaceable>PROTOCOL</replaceable></option></term>
<listitem><para>Specifies the network protocol for the query. May be one of <literal>dns</literal>
(i.e. classic unicast DNS), <literal>llmnr</literal> (<ulink
@@ -309,9 +312,9 @@
<varlistentry>
<term><option>-t</option> <replaceable>TYPE</replaceable></term>
- <term><option>--type=</option><replaceable>TYPE</replaceable></term>
+ <term><option>--type=<replaceable>TYPE</replaceable></option></term>
<term><option>-c</option> <replaceable>CLASS</replaceable></term>
- <term><option>--class=</option><replaceable>CLASS</replaceable></term>
+ <term><option>--class=<replaceable>CLASS</replaceable></option></term>
<listitem><para>When used in conjunction with the <command>query</command> command, specifies the DNS
resource record type (e.g. <constant class='dns'>A</constant>, <constant class='dns'>AAAA</constant>,
@@ -332,7 +335,7 @@
</varlistentry>
<varlistentry>
- <term><option>--service-address=</option><replaceable>BOOL</replaceable></term>
+ <term><option>--service-address=<replaceable>BOOL</replaceable></option></term>
<listitem><para>Takes a boolean parameter. If true (the default), when doing a service lookup with
<option>--service</option> the hostnames contained in the <constant class='dns'>SRV</constant>
@@ -342,7 +345,7 @@
</varlistentry>
<varlistentry>
- <term><option>--service-txt=</option><replaceable>BOOL</replaceable></term>
+ <term><option>--service-txt=<replaceable>BOOL</replaceable></option></term>
<listitem><para>Takes a boolean parameter. If true (the default), when doing a DNS-SD service lookup
with <option>--service</option> the <constant class='dns'>TXT</constant> service metadata record is
@@ -352,7 +355,7 @@
</varlistentry>
<varlistentry>
- <term><option>--cname=</option><replaceable>BOOL</replaceable></term>
+ <term><option>--cname=<replaceable>BOOL</replaceable></option></term>
<listitem><para>Takes a boolean parameter. If true (the default), DNS <constant
class='dns'>CNAME</constant> or <constant class='dns'>DNAME</constant> redirections are
@@ -363,7 +366,7 @@
</varlistentry>
<varlistentry>
- <term><option>--validate=</option><replaceable>BOOL</replaceable></term>
+ <term><option>--validate=<replaceable>BOOL</replaceable></option></term>
<listitem><para>Takes a boolean parameter; used in conjunction with <command>query</command>. If true
(the default), DNSSEC validation is applied as usual — under the condition that it is enabled for the
@@ -377,7 +380,7 @@
</varlistentry>
<varlistentry>
- <term><option>--synthesize=</option><replaceable>BOOL</replaceable></term>
+ <term><option>--synthesize=<replaceable>BOOL</replaceable></option></term>
<listitem><para>Takes a boolean parameter; used in conjunction with <command>query</command>. If true
(the default), select domains are resolved on the local system, among them
@@ -392,7 +395,7 @@
</varlistentry>
<varlistentry>
- <term><option>--cache=</option><replaceable>BOOL</replaceable></term>
+ <term><option>--cache=<replaceable>BOOL</replaceable></option></term>
<listitem><para>Takes a boolean parameter; used in conjunction with <command>query</command>. If true
(the default), lookups use the local DNS resource record cache. If false, lookups are routed to the
@@ -402,7 +405,7 @@
</varlistentry>
<varlistentry>
- <term><option>--zone=</option><replaceable>BOOL</replaceable></term>
+ <term><option>--zone=<replaceable>BOOL</replaceable></option></term>
<listitem><para>Takes a boolean parameter; used in conjunction with <command>query</command>. If true
(the default), lookups are answered from locally registered LLMNR or mDNS resource records, if
@@ -413,7 +416,7 @@
</varlistentry>
<varlistentry>
- <term><option>--trust-anchor=</option><replaceable>BOOL</replaceable></term>
+ <term><option>--trust-anchor=<replaceable>BOOL</replaceable></option></term>
<listitem><para>Takes a boolean parameter; used in conjunction with <command>query</command>. If true
(the default), lookups for DS and DNSKEY are answered from the local DNSSEC trust anchors if
@@ -423,7 +426,7 @@
</varlistentry>
<varlistentry>
- <term><option>--network=</option><replaceable>BOOL</replaceable></term>
+ <term><option>--network=<replaceable>BOOL</replaceable></option></term>
<listitem><para>Takes a boolean parameter; used in conjunction with <command>query</command>. If true
(the default), lookups are answered via DNS, LLMNR or mDNS network requests if they cannot be
@@ -435,7 +438,7 @@
</varlistentry>
<varlistentry>
- <term><option>--search=</option><replaceable>BOOL</replaceable></term>
+ <term><option>--search=<replaceable>BOOL</replaceable></option></term>
<listitem><para>Takes a boolean parameter. If true (the default), any specified single-label
hostnames will be searched in the domains configured in the search domain list, if it is
@@ -459,7 +462,7 @@
</varlistentry>
<varlistentry>
- <term><option>--legend=</option><replaceable>BOOL</replaceable></term>
+ <term><option>--legend=<replaceable>BOOL</replaceable></option></term>
<listitem><para>Takes a boolean parameter. If true (the default), column headers and meta information about the
query response are shown. Otherwise, this output is suppressed.</para>
@@ -468,7 +471,7 @@
</varlistentry>
<varlistentry>
- <term><option>--stale-data=</option><replaceable>BOOL</replaceable></term>
+ <term><option>--stale-data=<replaceable>BOOL</replaceable></option></term>
<listitem><para>Takes a boolean parameter; used in conjunction with <command>query</command>. If true
(the default), lookups are answered with stale data (expired resource records) if
@@ -477,16 +480,23 @@
<xi:include href="version-info.xml" xpointer="v254"/></listitem>
</varlistentry>
- <xi:include href="standard-options.xml" xpointer="json" />
-
<varlistentry>
- <term><option>-j</option></term>
+ <term><option>--relax-single-label=<replaceable>BOOL</replaceable></option></term>
- <listitem><para>Short for <option>--json=auto</option></para>
+ <listitem><para>Takes a boolean parameter; used in conjunction with <command>query</command>. If
+ true, rules regarding routing of single-label names are relaxed. Defaults to false. By default,
+ lookups of single label names are assumed to refer to local hosts to be resolved via local resolution
+ such as LLMNR or via search domain qualification and are not routed to upstream servers as is. If
+ this option is enabled these rules are disabled and the queries are routed upstream anyway. Also see
+ the <varname>ResolveUnicastSingleLabel=</varname> option in
+ <citerefentry><refentrytitle>resolved.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+ which provides a system-wide option that controls this behaviour.</para>
- <xi:include href="version-info.xml" xpointer="v252"/></listitem>
+ <xi:include href="version-info.xml" xpointer="v256"/></listitem>
</varlistentry>
+ <xi:include href="standard-options.xml" xpointer="json" />
+ <xi:include href="standard-options.xml" xpointer="j" />
<xi:include href="standard-options.xml" xpointer="no-pager" />
<xi:include href="standard-options.xml" xpointer="help" />
<xi:include href="standard-options.xml" xpointer="version" />
@@ -669,12 +679,12 @@ _443._tcp.fedoraproject.org IN TLSA 0 0 1 19400be5b7a31fb733917700789d2f0a2471c0
<refsect1>
<title>See Also</title>
- <para>
- <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
- <citerefentry><refentrytitle>systemd-resolved.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
- <citerefentry><refentrytitle>systemd.dnssd</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
- <citerefentry><refentrytitle>systemd-networkd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
- <citerefentry><refentrytitle>resolvconf</refentrytitle><manvolnum>8</manvolnum></citerefentry>
- </para>
+ <para><simplelist type="inline">
+ <member><citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry></member>
+ <member><citerefentry><refentrytitle>systemd-resolved.service</refentrytitle><manvolnum>8</manvolnum></citerefentry></member>
+ <member><citerefentry><refentrytitle>systemd.dnssd</refentrytitle><manvolnum>5</manvolnum></citerefentry></member>
+ <member><citerefentry><refentrytitle>systemd-networkd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry></member>
+ <member><citerefentry><refentrytitle>resolvconf</refentrytitle><manvolnum>8</manvolnum></citerefentry></member>
+ </simplelist></para>
</refsect1>
</refentry>
generated by cgit v1.2.3 (git 2.39.1) at 2024-12-20 08:14:33 +0000