Adding upstream version 4.23.0.upstream/4.23.0

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 40 insertions, 26 deletions

diff --git a/upstream/debian-unstable/man1/resolvectl.1 b/upstream/debian-unstable/man1/resolvectl.1
index 1a735d74..e67714a4 100644
--- a/upstream/debian-unstable/man1/resolvectl.1
+++ b/upstream/debian-unstable/man1/resolvectl.1
@@ -1,5 +1,5 @@
 '\" t
-.TH "RESOLVECTL" "1" "" "systemd 255" "resolvectl"
+.TH "RESOLVECTL" "1" "" "systemd 256~rc3" "resolvectl"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -55,6 +55,11 @@ If an international domain name is specified, it is automatically translated acc
 \fB\-\-type=\fR/\fB\-\-class=\fR
 is used IDNA translation is turned off and domain names are processed as specified\&.
 .sp
+If combined with
+\fB\-\-json=\fR
+(only supported in combination with
+\fB\-\-type=\fR) will output the resource record data in a JSON object\&.
+.sp
 Added in version 239\&.
 .RE
 .PP
@@ -266,7 +271,7 @@ only IPv6 addresses are requested\&.
 Added in version 239\&.
 .RE
 .PP
-\fB\-i\fR \fIINTERFACE\fR, \fB\-\-interface=\fR\fIINTERFACE\fR
+\fB\-i\fR \fIINTERFACE\fR, \fB\-\-interface=\fR\fB\fIINTERFACE\fR\fR
 .RS 4
 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\&.
 "en0")\&. Note that this option has no effect if system\-wide DNS configuration (as configured in
@@ -277,7 +282,7 @@ or
 Added in version 239\&.
 .RE
 .PP
-\fB\-p\fR \fIPROTOCOL\fR, \fB\-\-protocol=\fR\fIPROTOCOL\fR
+\fB\-p\fR \fIPROTOCOL\fR, \fB\-\-protocol=\fR\fB\fIPROTOCOL\fR\fR
 .RS 4
 Specifies the network protocol for the query\&. May be one of
 "dns"
@@ -303,7 +308,7 @@ may be used to list known values\&.
 Added in version 239\&.
 .RE
 .PP
-\fB\-t\fR \fITYPE\fR, \fB\-\-type=\fR\fITYPE\fR, \fB\-c\fR \fICLASS\fR, \fB\-\-class=\fR\fICLASS\fR
+\fB\-t\fR \fITYPE\fR, \fB\-\-type=\fR\fB\fITYPE\fR\fR, \fB\-c\fR \fICLASS\fR, \fB\-\-class=\fR\fB\fICLASS\fR\fR
 .RS 4
 When used in conjunction with the
 \fBquery\fR
@@ -327,7 +332,7 @@ notation, unless look\-up in MulticastDNS/LLMNR is desired, in which case UTF\-8
 Added in version 239\&.
 .RE
 .PP
-\fB\-\-service\-address=\fR\fIBOOL\fR
+\fB\-\-service\-address=\fR\fB\fIBOOL\fR\fR
 .RS 4
 Takes a boolean parameter\&. If true (the default), when doing a service lookup with
 \fB\-\-service\fR
@@ -338,7 +343,7 @@ resource records are resolved as well\&.
 Added in version 239\&.
 .RE
 .PP
-\fB\-\-service\-txt=\fR\fIBOOL\fR
+\fB\-\-service\-txt=\fR\fB\fIBOOL\fR\fR
 .RS 4
 Takes a boolean parameter\&. If true (the default), when doing a DNS\-SD service lookup with
 \fB\-\-service\fR
@@ -349,7 +354,7 @@ service metadata record is resolved as well\&.
 Added in version 239\&.
 .RE
 .PP
-\fB\-\-cname=\fR\fIBOOL\fR
+\fB\-\-cname=\fR\fB\fIBOOL\fR\fR
 .RS 4
 Takes a boolean parameter\&. If true (the default), DNS
 \fBCNAME\fR
@@ -360,7 +365,7 @@ redirections are followed\&. Otherwise, if a CNAME or DNAME record is encountere
 Added in version 239\&.
 .RE
 .PP
-\fB\-\-validate=\fR\fIBOOL\fR
+\fB\-\-validate=\fR\fB\fIBOOL\fR\fR
 .RS 4
 Takes a boolean parameter; used in conjunction with
 \fBquery\fR\&. If true (the default), DNSSEC validation is applied as usual \(em under the condition that it is enabled for the network and for
@@ -370,7 +375,7 @@ as a whole\&. If false, DNSSEC validation is disabled for the specific query, re
 Added in version 248\&.
 .RE
 .PP
-\fB\-\-synthesize=\fR\fIBOOL\fR
+\fB\-\-synthesize=\fR\fB\fIBOOL\fR\fR
 .RS 4
 Takes a boolean parameter; used in conjunction with
 \fBquery\fR\&. If true (the default), select domains are resolved on the local system, among them
@@ -393,7 +398,7 @@ entries)\&.
 Added in version 248\&.
 .RE
 .PP
-\fB\-\-cache=\fR\fIBOOL\fR
+\fB\-\-cache=\fR\fB\fIBOOL\fR\fR
 .RS 4
 Takes a boolean parameter; used in conjunction with
 \fBquery\fR\&. If true (the default), lookups use the local DNS resource record cache\&. If false, lookups are routed to the network instead, regardless if already available in the local cache\&.
@@ -401,7 +406,7 @@ Takes a boolean parameter; used in conjunction with
 Added in version 248\&.
 .RE
 .PP
-\fB\-\-zone=\fR\fIBOOL\fR
+\fB\-\-zone=\fR\fB\fIBOOL\fR\fR
 .RS 4
 Takes a boolean parameter; used in conjunction with
 \fBquery\fR\&. If true (the default), lookups are answered from locally registered LLMNR or mDNS resource records, if defined\&. If false, locally registered LLMNR/mDNS records are not considered for the lookup request\&.
@@ -409,7 +414,7 @@ Takes a boolean parameter; used in conjunction with
 Added in version 248\&.
 .RE
 .PP
-\fB\-\-trust\-anchor=\fR\fIBOOL\fR
+\fB\-\-trust\-anchor=\fR\fB\fIBOOL\fR\fR
 .RS 4
 Takes a boolean parameter; used in conjunction with
 \fBquery\fR\&. If true (the default), lookups for DS and DNSKEY are answered from the local DNSSEC trust anchors if possible\&. If false, the local trust store is not considered for the lookup request\&.
@@ -417,7 +422,7 @@ Takes a boolean parameter; used in conjunction with
 Added in version 248\&.
 .RE
 .PP
-\fB\-\-network=\fR\fIBOOL\fR
+\fB\-\-network=\fR\fB\fIBOOL\fR\fR
 .RS 4
 Takes a boolean parameter; used in conjunction with
 \fBquery\fR\&. If true (the default), lookups are answered via DNS, LLMNR or mDNS network requests if they cannot be synthesized locally, or be answered from the local cache, zone or trust anchors (see above)\&. If false, the request is not answered from the network and will thus fail if none of the indicated sources can answer them\&.
@@ -425,7 +430,7 @@ Takes a boolean parameter; used in conjunction with
 Added in version 248\&.
 .RE
 .PP
-\fB\-\-search=\fR\fIBOOL\fR
+\fB\-\-search=\fR\fB\fIBOOL\fR\fR
 .RS 4
 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 non\-empty\&. Otherwise, the search domain logic is disabled\&. Note that this option has no effect if
 \fB\-\-type=\fR
@@ -443,14 +448,14 @@ Dump the answer as binary data\&. If there is no argument or if the argument is
 Added in version 239\&.
 .RE
 .PP
-\fB\-\-legend=\fR\fIBOOL\fR
+\fB\-\-legend=\fR\fB\fIBOOL\fR\fR
 .RS 4
 Takes a boolean parameter\&. If true (the default), column headers and meta information about the query response are shown\&. Otherwise, this output is suppressed\&.
 .sp
 Added in version 239\&.
 .RE
 .PP
-\fB\-\-stale\-data=\fR\fIBOOL\fR
+\fB\-\-stale\-data=\fR\fB\fIBOOL\fR\fR
 .RS 4
 Takes a boolean parameter; used in conjunction with
 \fBquery\fR\&. If true (the default), lookups are answered with stale data (expired resource records) if possible\&. If false, the stale data is not considered for the lookup request\&.
@@ -458,7 +463,19 @@ Takes a boolean parameter; used in conjunction with
 Added in version 254\&.
 .RE
 .PP
-\fB\-\-json=\fR\fIMODE\fR
+\fB\-\-relax\-single\-label=\fR\fB\fIBOOL\fR\fR
+.RS 4
+Takes a boolean parameter; used in conjunction with
+\fBquery\fR\&. 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
+\fIResolveUnicastSingleLabel=\fR
+option in
+\fBresolved.conf\fR(5)
+which provides a system\-wide option that controls this behaviour\&.
+.sp
+Added in version 256\&.
+.RE
+.PP
+\fB\-\-json=\fR\fB\fIMODE\fR\fR
 .RS 4
 Shows output formatted as JSON\&. Expects one of
 "short"
@@ -471,10 +488,11 @@ Shows output formatted as JSON\&. Expects one of
 .PP
 \fB\-j\fR
 .RS 4
-Short for
-\fB\-\-json=auto\fR
-.sp
-Added in version 252\&.
+Equivalent to
+\fB\-\-json=pretty\fR
+if running on a terminal, and
+\fB\-\-json=short\fR
+otherwise\&.
 .RE
 .PP
 \fB\-\-no\-pager\fR
@@ -689,11 +707,7 @@ and
 are optional and could be skipped\&.
 .SH "SEE ALSO"
 .PP
-\fBsystemd\fR(1),
-\fBsystemd-resolved.service\fR(8),
-\fBsystemd.dnssd\fR(5),
-\fBsystemd-networkd.service\fR(8),
-\fBresolvconf\fR(8)
+\fBsystemd\fR(1), \fBsystemd-resolved.service\fR(8), \fBsystemd.dnssd\fR(5), \fBsystemd-networkd.service\fR(8), \fBresolvconf\fR(8)
 .SH "NOTES"
 .IP " 1." 4
 RFC 6763 DNS-SD