€•øL      Œsphinx.addnodes”Œdocument”“”)”}”(Œ	rawsource”Œ ”Œchildren”]”(Œtranslations”ŒLanguagesNode”“”)”}”(hhh]”(h Œpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ	refdomain”Œstd”Œreftype”Œdoc”Œ	reftarget”Œ+/translations/zh_CN/networking/dns_resolver”Œmodname”NŒ	classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ+/translations/zh_TW/networking/dns_resolver”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ+/translations/it_IT/networking/dns_resolver”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ+/translations/ja_JP/networking/dns_resolver”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ+/translations/ko_KR/networking/dns_resolver”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒPortuguese (Brazilian)”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ+/translations/pt_BR/networking/dns_resolver”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒSpanish”…””}”hh–sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ+/translations/sp_SP/networking/dns_resolver”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h
hhŒ	_document”hŒsource”NŒline”NubhŒcomment”“”)”}”(hŒ SPDX-License-Identifier: GPL-2.0”h]”hŒ SPDX-License-Identifier: GPL-2.0”…””}”hh·sbah}”(h]”h ]”h"]”h$]”h&]”Œ	xml:space”Œpreserve”uh1hµhhh²hh³ŒE/var/lib/git/docbuild/linux/Documentation/networking/dns_resolver.rst”h´KubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒDNS Resolver Module”h]”hŒDNS Resolver Module”…””}”(hhÏh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhhÊh²hh³hÇh´Kubh¶)”}”(hŒVContents:

- Overview.
- Compilation.
- Setting up.
- Usage.
- Mechanism.
- Debugging.”h]”hŒVContents:

- Overview.
- Compilation.
- Setting up.
- Usage.
- Mechanism.
- Debugging.”…””}”hhÝsbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1hµhhÊh²hh³hÇh´KubhÉ)”}”(hhh]”(hÎ)”}”(hŒOverview”h]”hŒOverview”…””}”(hhîh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhhëh²hh³hÇh´KubhŒ	paragraph”“”)”}”(hŒÇThe DNS resolver module provides a way for kernel services to make DNS queries
by way of requesting a key of key type dns_resolver.  These queries are
upcalled to userspace through /sbin/request-key.”h]”hŒÇThe DNS resolver module provides a way for kernel services to make DNS queries
by way of requesting a key of key type dns_resolver.  These queries are
upcalled to userspace through /sbin/request-key.”…””}”(hhþh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hüh³hÇh´Khhëh²hubhý)”}”(hŒËThese routines must be supported by userspace tools dns.upcall, cifs.upcall and
request-key.  It is under development and does not yet provide the full feature
set.  The features it does support include:”h]”hŒËThese routines must be supported by userspace tools dns.upcall, cifs.upcall and
request-key.  It is under development and does not yet provide the full feature
set.  The features it does support include:”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hüh³hÇh´Khhëh²hubhŒblock_quote”“”)”}”(hŒ=* Implements the dns_resolver key_type to contact userspace.
”h]”hŒbullet_list”“”)”}”(hhh]”hŒ	list_item”“”)”}”(hŒ;Implements the dns_resolver key_type to contact userspace.
”h]”hý)”}”(hŒ:Implements the dns_resolver key_type to contact userspace.”h]”hŒ:Implements the dns_resolver key_type to contact userspace.”…””}”(hj+  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hüh³hÇh´Khj'  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j%  hj"  ubah}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ*”uh1j   h³hÇh´Khj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÇh´Khhëh²hubhý)”}”(hŒ3It does not yet support the following AFS features:”h]”hŒ3It does not yet support the following AFS features:”…””}”(hjM  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hüh³hÇh´Khhëh²hubj  )”}”(hŒ/* DNS query support for AFSDB resource record.
”h]”j!  )”}”(hhh]”j&  )”}”(hŒ-DNS query support for AFSDB resource record.
”h]”hý)”}”(hŒ,DNS query support for AFSDB resource record.”h]”hŒ,DNS query support for AFSDB resource record.”…””}”(hjf  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hüh³hÇh´K hjb  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j%  hj_  ubah}”(h]”h ]”h"]”h$]”h&]”jE  jF  uh1j   h³hÇh´K hj[  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÇh´K hhëh²hubhý)”}”(hŒ0This code is extracted from the CIFS filesystem.”h]”hŒ0This code is extracted from the CIFS filesystem.”…””}”(hj†  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hüh³hÇh´K"hhëh²hubeh}”(h]”Œoverview”ah ]”h"]”Œoverview”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´KubhÉ)”}”(hhh]”(hÎ)”}”(hŒCompilation”h]”hŒCompilation”…””}”(hjŸ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjœ  h²hh³hÇh´K&ubhý)”}”(hŒMThe module should be enabled by turning on the kernel configuration options::”h]”hŒLThe module should be enabled by turning on the kernel configuration options:”…””}”(hj­  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hüh³hÇh´K(hjœ  h²hubhŒliteral_block”“”)”}”(hŒ9CONFIG_DNS_RESOLVER     - tristate "DNS Resolver support"”h]”hŒ9CONFIG_DNS_RESOLVER     - tristate "DNS Resolver support"”…””}”hj½  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j»  h³hÇh´K*hjœ  h²hubeh}”(h]”Œcompilation”ah ]”h"]”Œcompilation”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´K&ubhÉ)”}”(hhh]”(hÎ)”}”(hŒ
Setting up”h]”hŒ
Setting up”…””}”(hjÖ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjÓ  h²hh³hÇh´K.ubhý)”}”(hŒñTo set up this facility, the /etc/request-key.conf file must be altered so that
/sbin/request-key can appropriately direct the upcalls.  For example, to handle
basic dname to IPv4/IPv6 address resolution, the following line should be
added::”h]”hŒðTo set up this facility, the /etc/request-key.conf file must be altered so that
/sbin/request-key can appropriately direct the upcalls.  For example, to handle
basic dname to IPv4/IPv6 address resolution, the following line should be
added:”…””}”(hjä  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hüh³hÇh´K0hjÓ  h²hubj¼  )”}”(hŒÆ#OP     TYPE            DESC    CO-INFO PROGRAM ARG1 ARG2 ARG3 ...
#====== ============    ======= ======= ==========================
create  dns_resolver    *       *       /usr/sbin/cifs.upcall %k”h]”hŒÆ#OP     TYPE            DESC    CO-INFO PROGRAM ARG1 ARG2 ARG3 ...
#====== ============    ======= ======= ==========================
create  dns_resolver    *       *       /usr/sbin/cifs.upcall %k”…””}”hjò  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j»  h³hÇh´K6hjÓ  h²hubhý)”}”(hŒžTo direct a query for query type 'foo', a line of the following should be added
before the more general line given above as the first match is the one taken::”h]”hŒ¡To direct a query for query type â€˜fooâ€™, a line of the following should be added
before the more general line given above as the first match is the one taken:”…””}”(hj   h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hüh³hÇh´K:hjÓ  h²hubj¼  )”}”(hŒ<create  dns_resolver    foo:*   *       /usr/sbin/dns.foo %k”h]”hŒ<create  dns_resolver    foo:*   *       /usr/sbin/dns.foo %k”…””}”hj  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j»  h³hÇh´K=hjÓ  h²hubeh}”(h]”Œ
setting-up”ah ]”h"]”Œ
setting up”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´K.ubhÉ)”}”(hhh]”(hÎ)”}”(hŒUsage”h]”hŒUsage”…””}”(hj'  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj$  h²hh³hÇh´KAubhý)”}”(hŒITo make use of this facility, first ``dns_resolver.h`` must be included::”h]”(hŒ$To make use of this facility, first ”…””}”(hj5  h²hh³Nh´NubhŒliteral”“”)”}”(hŒ``dns_resolver.h``”h]”hŒdns_resolver.h”…””}”(hj?  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j=  hj5  ubhŒ must be included:”…””}”(hj5  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hüh³hÇh´KChj$  h²hubj¼  )”}”(hŒ#include <linux/dns_resolver.h>”h]”hŒ#include <linux/dns_resolver.h>”…””}”hjW  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j»  h³hÇh´KEhj$  h²hubhý)”}”(hŒ%Then queries may be made by calling::”h]”hŒ$Then queries may be made by calling:”…””}”(hje  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hüh³hÇh´KGhj$  h²hubj¼  )”}”(hŒ…int dns_query(const char *type, const char *name, size_t namelen,
             const char *options, char **_result, time_t *_expiry);”h]”hŒ…int dns_query(const char *type, const char *name, size_t namelen,
             const char *options, char **_result, time_t *_expiry);”…””}”hjs  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j»  h³hÇh´KIhj$  h²hubhý)”}”(hŒçThis is the basic access function.  It looks for a cached DNS query and if
it doesn't find it, it upcalls to userspace to make a new DNS query, which
may then be cached.  The key description is constructed as a string of the
form::”h]”hŒèThis is the basic access function.  It looks for a cached DNS query and if
it doesnâ€™t find it, it upcalls to userspace to make a new DNS query, which
may then be cached.  The key description is constructed as a string of the
form:”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hüh³hÇh´KLhj$  h²hubj¼  )”}”(hŒ[<type>:]<name>”h]”hŒ[<type>:]<name>”…””}”hj  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j»  h³hÇh´KQhj$  h²hubhý)”}”(hŒßwhere <type> optionally specifies the particular upcall program to invoke,
and thus the type of query, and <name> specifies the string to be looked up.
The default query type is a straight hostname to IP address set lookup.”h]”hŒßwhere <type> optionally specifies the particular upcall program to invoke,
and thus the type of query, and <name> specifies the string to be looked up.
The default query type is a straight hostname to IP address set lookup.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hüh³hÇh´KShj$  h²hubhý)”}”(hŒyThe name parameter is not required to be a NUL-terminated string, and its
length should be given by the namelen argument.”h]”hŒyThe name parameter is not required to be a NUL-terminated string, and its
length should be given by the namelen argument.”…””}”(hj«  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hüh³hÇh´KWhj$  h²hubhý)”}”(hŒ^The options parameter may be NULL or it may be a set of options
appropriate to the query type.”h]”hŒ^The options parameter may be NULL or it may be a set of options
appropriate to the query type.”…””}”(hj¹  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hüh³hÇh´KZhj$  h²hubhý)”}”(hŒÅThe return value is a string appropriate to the query type.  For instance,
for the default query type it is just a list of comma-separated IPv4 and
IPv6 addresses.  The caller must free the result.”h]”hŒÅThe return value is a string appropriate to the query type.  For instance,
for the default query type it is just a list of comma-separated IPv4 and
IPv6 addresses.  The caller must free the result.”…””}”(hjÇ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hüh³hÇh´K]hj$  h²hubhý)”}”(hŒ¢The length of the result string is returned on success, and a negative
error code is returned otherwise.  -EKEYREJECTED will be returned if the
DNS lookup failed.”h]”hŒ¢The length of the result string is returned on success, and a negative
error code is returned otherwise.  -EKEYREJECTED will be returned if the
DNS lookup failed.”…””}”(hjÕ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hüh³hÇh´Kahj$  h²hubhý)”}”(hŒRIf _expiry is non-NULL, the expiry time (TTL) of the result will be
returned also.”h]”hŒRIf _expiry is non-NULL, the expiry time (TTL) of the result will be
returned also.”…””}”(hjã  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hüh³hÇh´Kehj$  h²hubhý)”}”(hŒÊThe kernel maintains an internal keyring in which it caches looked up keys.
This can be cleared by any process that has the CAP_SYS_ADMIN capability by
the use of KEYCTL_KEYRING_CLEAR on the keyring ID.”h]”hŒÊThe kernel maintains an internal keyring in which it caches looked up keys.
This can be cleared by any process that has the CAP_SYS_ADMIN capability by
the use of KEYCTL_KEYRING_CLEAR on the keyring ID.”…””}”(hjñ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hüh³hÇh´Khhj$  h²hubeh}”(h]”Œusage”ah ]”h"]”Œusage”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´KAubhÉ)”}”(hhh]”(hÎ)”}”(hŒReading DNS Keys from Userspace”h]”hŒReading DNS Keys from Userspace”…””}”(hj
  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj  h²hh³hÇh´Knubhý)”}”(hŒeKeys of dns_resolver type can be read from userspace using keyctl_read() or
"keyctl read/print/pipe".”h]”hŒiKeys of dns_resolver type can be read from userspace using keyctl_read() or
â€œkeyctl read/print/pipeâ€.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hüh³hÇh´Kphj  h²hubeh}”(h]”Œreading-dns-keys-from-userspace”ah ]”h"]”Œreading dns keys from userspace”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´KnubhÉ)”}”(hhh]”(hÎ)”}”(hŒ	Mechanism”h]”hŒ	Mechanism”…””}”(hj1  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj.  h²hh³hÇh´Kuubhý)”}”(hŒ™The dns_resolver module registers a key type called "dns_resolver".  Keys of
this type are used to transport and cache DNS lookup results from userspace.”h]”hŒThe dns_resolver module registers a key type called â€œdns_resolverâ€.  Keys of
this type are used to transport and cache DNS lookup results from userspace.”…””}”(hj?  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hüh³hÇh´Kwhj.  h²hubhý)”}”(hŒ²When dns_query() is invoked, it calls request_key() to search the local
keyrings for a cached DNS result.  If that fails to find one, it upcalls to
userspace to get a new result.”h]”hŒ²When dns_query() is invoked, it calls request_key() to search the local
keyrings for a cached DNS result.  If that fails to find one, it upcalls to
userspace to get a new result.”…””}”(hjM  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hüh³hÇh´Kzhj.  h²hubhý)”}”(hŒØUpcalls to userspace are made through the request_key() upcall vector, and are
directed by means of configuration lines in /etc/request-key.conf that tell
/sbin/request-key what program to run to instantiate the key.”h]”hŒØUpcalls to userspace are made through the request_key() upcall vector, and are
directed by means of configuration lines in /etc/request-key.conf that tell
/sbin/request-key what program to run to instantiate the key.”…””}”(hj[  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hüh³hÇh´K~hj.  h²hubhý)”}”(hXb  The upcall handler program is responsible for querying the DNS, processing the
result into a form suitable for passing to the keyctl_instantiate_key()
routine.  This then passes the data to dns_resolver_instantiate() which strips
off and processes any options included in the data, and then attaches the
remainder of the string to the key as its payload.”h]”hXb  The upcall handler program is responsible for querying the DNS, processing the
result into a form suitable for passing to the keyctl_instantiate_key()
routine.  This then passes the data to dns_resolver_instantiate() which strips
off and processes any options included in the data, and then attaches the
remainder of the string to the key as its payload.”…””}”(hji  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hüh³hÇh´K‚hj.  h²hubhý)”}”(hŒêThe upcall handler program should set the expiry time on the key to that of the
lowest TTL of all the records it has extracted a result from.  This means that
the key will be discarded and recreated when the data it holds has expired.”h]”hŒêThe upcall handler program should set the expiry time on the key to that of the
lowest TTL of all the records it has extracted a result from.  This means that
the key will be discarded and recreated when the data it holds has expired.”…””}”(hjw  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hüh³hÇh´Kˆhj.  h²hubhý)”}”(hŒfdns_query() returns a copy of the value attached to the key, or an error if
that is indicated instead.”h]”hŒfdns_query() returns a copy of the value attached to the key, or an error if
that is indicated instead.”…””}”(hj…  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hüh³hÇh´KŒhj.  h²hubhý)”}”(hŒcSee Documentation/security/keys/request-key.rst for further information about
request-key function.”h]”hŒcSee Documentation/security/keys/request-key.rst for further information about
request-key function.”…””}”(hj“  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hüh³hÇh´Khj.  h²hubeh}”(h]”Œ	mechanism”ah ]”h"]”Œ	mechanism”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´KuubhÉ)”}”(hhh]”(hÎ)”}”(hŒ	Debugging”h]”hŒ	Debugging”…””}”(hj¬  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj©  h²hh³hÇh´K”ubhý)”}”(hŒXDebugging messages can be turned on dynamically by writing a 1 into the
following file::”h]”hŒWDebugging messages can be turned on dynamically by writing a 1 into the
following file:”…””}”(hjº  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hüh³hÇh´K–hj©  h²hubj¼  )”}”(hŒ)/sys/module/dns_resolver/parameters/debug”h]”hŒ)/sys/module/dns_resolver/parameters/debug”…””}”hjÈ  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j»  h³hÇh´K™hj©  h²hubeh}”(h]”Œ	debugging”ah ]”h"]”Œ	debugging”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´K”ubeh}”(h]”Œdns-resolver-module”ah ]”h"]”Œdns resolver module”ah$]”h&]”uh1hÈhhh²hh³hÇh´Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”hÇuh1hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(hÍNŒ	generator”NŒ	datestamp”NŒsource_link”NŒ
source_url”NŒtoc_backlinks”Œentry”Œfootnote_backlinks”KŒsectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒstrip_classes”NŒreport_level”KŒ
halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ	traceback”ˆŒinput_encoding”Œ	utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”j	  Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œlanguage_code”Œen”Œrecord_dependencies”NŒconfig”NŒ	id_prefix”hŒauto_id_prefix”Œid”Œdump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”hÇŒ_destination”NŒ_config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒraw_enabled”KŒline_length_limit”M'Œpep_references”NŒpep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ	tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œdocinfo_xform”KŒsectsubtitle_xform”‰Œimage_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(jã  jà  j™  j–  jÐ  jÍ  j!  j  j  j  j+  j(  j¦  j£  jÛ  jØ  uŒ	nametypes”}”(jã  ‰j™  ‰jÐ  ‰j!  ‰j  ‰j+  ‰j¦  ‰jÛ  ‰uh}”(jà  hÊj–  hëjÍ  jœ  j  jÓ  j  j$  j(  j  j£  j.  jØ  j©  uŒfootnote_refs”}”Œcitation_refs”}”Œautofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ	footnotes”]”Œ	citations”]”Œautofootnote_start”KŒsymbol_footnote_start”K Œ
id_counter”Œcollections”ŒCounter”“”}”…”R”Œparse_messages”]”Œtransform_messages”]”Œtransformer”NŒinclude_log”]”Œ
decoration”Nh²hub.