Skip to content

Commit

Permalink
SSSD man: man_dns_resolver_parameter_modification
Browse files Browse the repository at this point in the history 
Adding parameter dns_resolver_server_timeout
and dns_resolver_op_timeout in sssd.conf

Resolves: #5616
  • Loading branch information
@DDDas7
DDDas7 committed May 22, 2021
2 parents 2f3c2b0 + 9ab6cc0 commit 6a60c15
Show file tree
Hide file tree
Showing 3 changed files with 57 additions and 113 deletions.
52 changes: 52 additions & 0 deletions src/man/include/dns_options.xml
View file
@@ -0,0 +1,52 @@
<variablelist>
<varlistentry>
<term>
dns_resolver_server_timeout (integer)
</term>
<listitem>
<para>
Defines the amount of time (in milliseconds) SSSD
would wait for a response from a DNS server before
trying the query via the next DNS server.
</para>
<para>
Default: 1000
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
dns_resolver_op_timeout (integer)
</term>
<listitem>
<para>
Defines the amount of time (in seconds) to
resolve a single DNS query (e.g. resolution of a
hostname or an SRV record) before trying the
next hostname or DNS discovery.
</para>
<para>
Default: 3
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
dns_resolver_timeout (integer)
</term>
<listitem>
<para>
Defines the amount of time (in seconds) to wait
for a reply from the internal failover service
before assuming that the service is unreachable.
If this timeout is reached, the domain will
continue to operate in offline mode.
</para>
<para>
Default: 6
</para>
</listitem>
</varlistentry>
</variablelist>
56 changes: 2 additions & 54 deletions src/man/include/failover.xml
View file
Expand Up @@ -64,60 +64,8 @@
you can consider changing the time outs.
</para>
<para>
This section lists the available tunables. Please refer to their
description in the
<citerefentry>
<refentrytitle>sssd.conf</refentrytitle><manvolnum>5</manvolnum>
</citerefentry>,
manual page.
<variablelist>
<varlistentry>
<term>
dns_resolver_server_timeout
</term>
<listitem>
<para>
Time in milliseconds that sets how long would SSSD
talk to a single DNS server before trying next one.
</para>
<para>
Default: 1000
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
dns_resolver_op_timeout
</term>
<listitem>
<para>
Time in seconds to tell how long would SSSD try
to resolve single DNS query (e.g. resolution of a
hostname or an SRV record) before trying the next
hostname or discovery domain.
</para>
<para>
Default: 3
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
dns_resolver_timeout
</term>
<listitem>
<para>
How long would SSSD try to resolve a failover
service. This service resolution internally might
include several steps, such as resolving DNS SRV
queries or locating the site.
</para>
<para>
Default: 6
</para>
</listitem>
</varlistentry>
</variablelist>
This section lists the available tunables.
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="dns_options.xml" />
</para>
<para>
For LDAP-based providers, the resolve operation is performed
Expand Down
62 changes: 3 additions & 59 deletions src/man/sssd.conf.5.xml
View file
Expand Up @@ -3405,67 +3405,11 @@ pam_gssapi_indicators_map = sudo:pkinit, sudo-i:pkinit
</para>
</listitem>
</varlistentry>
</variablelist>

<varlistentry>
<term>dns_resolver_server_timeout (integer)</term>
<listitem>
<para>
Defines the amount of time (in milliseconds)
SSSD would try to talk to DNS server before
trying next DNS server.
</para>
<para>
Please see the section <quote>FAILOVER</quote>
for more information about the service
resolution.
</para>
<para>
Default: 1000
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>dns_resolver_op_timeout (integer)</term>
<listitem>
<para>
Defines the amount of time (in seconds) to
wait to resolve single DNS query
(e.g. resolution of a hostname or an SRV record)
before try next hostname or DNS discovery.
</para>
<para>
Please see the section <quote>FAILOVER</quote>
for more information about the service
resolution.
</para>
<para>
Default: 3
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>dns_resolver_timeout (integer)</term>
<listitem>
<para>
Defines the amount of time (in seconds) to
wait for a reply from the internal fail over
service before assuming that the service is
unreachable. If this timeout is reached, the
domain will continue to operate in offline mode.
</para>
<para>
Please see the section <quote>FAILOVER</quote>
for more information about the service
resolution.
</para>
<para>
Default: 6
</para>
</listitem>
</varlistentry>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="include/dns_options.xml" />

<variablelist>
<varlistentry>
<term>dns_discovery_domain (string)</term>
<listitem>
Expand Down

0 comments on commit 6a60c15

Please sign in to comment.