summaryrefslogtreecommitdiff
path: root/man/resolved.conf.xml
diff options
context:
space:
mode:
authorYu Watanabe <watanabe.yu+github@gmail.com>2020-09-04 12:58:32 +0900
committerYu Watanabe <watanabe.yu+github@gmail.com>2020-09-04 20:05:54 +0900
commit6421194b31bfc1f4b96fdece8c753f045720f48b (patch)
tree1c05916941ead343c6dc50a6869e98e7b64dc89f /man/resolved.conf.xml
parent5b49641015adcc7e8edbb9e8e54d5ac5ddf3bf52 (diff)
downloadsystemd-6421194b31bfc1f4b96fdece8c753f045720f48b.tar.gz
man: update DNSStubListenerExtra=
Diffstat (limited to 'man/resolved.conf.xml')
-rw-r--r--man/resolved.conf.xml42
1 files changed, 21 insertions, 21 deletions
diff --git a/man/resolved.conf.xml b/man/resolved.conf.xml
index 338bee6c38..c3c6b26329 100644
--- a/man/resolved.conf.xml
+++ b/man/resolved.conf.xml
@@ -271,27 +271,27 @@
<varlistentry>
<term><varname>DNSStubListenerExtra=</varname></term>
- <listitem><para>Takes an IPv4 or IPv6 address to listen on. The address may optionally be prefixed by <literal>:</literal> and
- a protocol name (<literal>udp</literal> or <literal>tcp</literal>). When an IPv6 address is specified with a port number, then the
- address must be in the square brackets. This option can be specified multiple times. If an empty string is assigned, then the all
- previous assignments are cleared. It may also be optionally suffixed by a numeric port number with separator <literal>:</literal>.
- If the protocol is not specified, the service will listen on both <literal>UDP</literal> and <literal>TCP</literal>. If the port is not
- specified, then the service takes port as 53. This option may be used multiple times. Note that this is independent of the
- primary DNS stub configured with <varname>DNSStubListener=</varname>, and only configures <emphasis>additional</emphasis>
- sockets to listen on. Defaults to unset.</para>
-
- <para>If the string in the format <literal>udp</literal>:[<replaceable>x</replaceable>]:<replaceable>y</replaceable>,
- it is read as protocol <literal>udp</literal> and IPv6 address x on a port y.</para>
-
- <para>If the string in the format [<replaceable>x</replaceable>]:<replaceable>y</replaceable>, it is read as both protocol
- <literal>udp</literal> and <literal>tcp</literal>, IPv6 address x on a port y.</para>
-
- <para>If the string in the format <replaceable>x</replaceable>, it is read as protocol both <literal>udp</literal> and
- <literal>tcp</literal>, IPv6/IPv4 address x on a port 53.</para>
-
- <para>If the string in the format <literal>udp</literal>:<replaceable>x</replaceable>:<replaceable>y</replaceable>,
- it is read as protocol <literal>udp</literal> and IPv4 address x on a port y.</para>
- </listitem>
+ <listitem><para>Takes an IPv4 or IPv6 address to listen on. The address may be optionally
+ prefixed with a protocol name (<literal>udp</literal> or <literal>tcp</literal>) separated with
+ <literal>:</literal>. If the protocol is not specified, the service will listen on both UDP and
+ TCP. It may be also optionally suffixed by a numeric port number with separator
+ <literal>:</literal>. When an IPv6 address is specified with a port number, then the address
+ must be in the square brackets. If the port is not specified, then the service uses port 53.
+ Note that this is independent of the primary DNS stub configured with
+ <varname>DNSStubListener=</varname>, and only configures <emphasis>additional</emphasis>
+ sockets to listen on. This option can be specified multiple times. If an empty string is
+ assigned, then the all previous assignments are cleared. Defaults to unset.</para>
+
+ <para>Examples:
+ <programlisting>DNSStubListenerExtra=192.168.10.10
+DNSStubListenerExtra=2001:db8:0:f102::10
+DNSStubListenerExtra=192.168.10.11:9953
+DNSStubListenerExtra=[2001:db8:0:f102::11]:9953
+DNSStubListenerExtra=tcp:192.168.10.12
+DNSStubListenerExtra=udp:2001:db8:0:f102::12
+DNSStubListenerExtra=tcp:192.168.10.13:9953
+DNSStubListenerExtra=udp:[2001:db8:0:f102::13]:9953</programlisting>
+ </para></listitem>
</varlistentry>
<varlistentry>