Lg # S r SSKrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSK r SSK
r
SSK r SSK r
SSKJrJrJrJrJrJr SSKrSSKrSSKrSSKrSSKrSSKrSSK rSSK rSSK rSSK rSSK rSSK!rSSK"rS r#S r$\RJ RM S5 r'\'( aU SSK(r)SSK*r*\)RV r,\)RZ R\ R^ r0 " S S\,5 r1 " S S
\*Rd 5 r3O
" S S
5 r3\'r4 SSK5r5\ R r7 " S S\Rp Rr 5 r: " S S\Rp Rv 5 r< " S S\Rp Rr 5 r= " S S\Rp Rr 5 r>\R~ R r@S rAS rBS rCS rDS rES rF SrS jrGSsS jrHS \S S!S 4S" jrI " S# S$\R 5 rKSS%SSS&S&SS'S SS S\ R \KR 4S(\R R S)\PS*\\Q S+\RS,\\P S-\RS.\SS/\SS0\\ S1\PS2\SS3\\P S4\\S\P4 S \S S5\RS6\KS!\R R 4"S7 jjrTS8\R R S9\WS!\W4S: jrXS8\R R S;\PS<\WS!S4S= jrY StS(\R R S)\PS>\PS*\\Q S+\RS,\\P S-\RS.\SS/\SS4\\S\P4 S?\\P S2\SS!\R R 4S@ jjrZSA r[SB r\ SuSC\SD\\R R \W4 SE\SF\\Q S!\\R\Q4 4
SG jjr] SvSC\SE\\ SF\\Q SH\SS.\SSI\\\R R \R R 4 SJ\\W S/\SSK\SSL\SSM\\R R S!\4SN jjrb SwS(\R R S)\PS*\\Q S+\RS,\\P S-\RSH\SS.\SS/\SSK\SSC\\ SL\SS!\R R 4SP jjrc SxS(\R R S)\PS*\\Q S+\RS,\\P S-\RSH\SS.\SS/\SSQ\\ SR\\ SL\SS!\\R R \S4 4SS jjrdST reSU rf SuSC\SD\\R R \W4 SF\\Q S!\\R\Q4 4SV jjrg SySC\SF\\Q S.\SSI\\\R R \R R 4 SJ\\W S/\SS!\\R R \Q4 4SW jjrhSX ri SzS(\R R S)\PS*\\Q S+\RS,\\P S-\RS.\SS/\SSC\\ S!\R R 4SY jjrjSZ rkS[\\P S4\\S\P4 S!\5R 4S\ jrm S{S(\R R S)\PS*\\Q S+\RS,\\P S-\RS.\SS/\SSC\\5R S]\\5R S[\\P S4\\S\P4 S!\R R 4S^ jjro S|S(\R R S)\PS*\\Q S+\RS,\\P S-\RS.\SS/\SS_\\R R S4\\S\P4 S?\\P S[\\P S!\R R 4S` jjrU " Sa Sb\R 5 rqSc\R R Sd\ R SM\R R Se\\R S*\\Q SF\QS!\4Sf jrt\R R \R R SSOSSS SSSSS&\R R 4
S)\PSg\\R R \P4 Sh\\R R \P4 Si\\R R \P4 S*\\Q S+\RSI\\\R R \R R 4 Sj\\\R R \P4 Sk\SSl\\Q S,\\P S-\RSe\RSm\SSn\\R R \P4 S!\4 So jjr?SSOSSSS\qR 4S)\PSc\R R SM\\R R S+\RS*\\Q Sl\\Q S,\\P S-\RSp\qS!S4Sq jjr}g! \6 a " S S
5 r5 GN~f = f)}zTalk to a DNS server. N)AnyDictOptionalTupleUnioncastc ~ U c g U [ R " 5 -
nUS:: a [ R R eU$ )N )timedns exceptionTimeout)
expirationtimeouts +/usr/lib/python3/dist-packages/dns/query.py
_remainingr 1 s7 499;&G#~mm### N c N Uc g [ [ R " 5 U - U5 $ N)minr )r r s r _expiration_for_this_attemptr : s# tyy{W$j 11r dohc @ ^ \ rS rSrU 4S jr SS jr SS jrSrU =r$ )_NetworkBackendH c R > [ TU ] 5 X l Xl X0l X@l g r )super__init__ _local_port _resolver_bootstrap_address_family)selfresolver
local_portbootstrap_addressfamily __class__s r r _NetworkBackend.__init__I s$ G ) %N&7 #!Lr c ~ / n[ U5 u px[ R R U5 ( a UR U5 OU R
b UR U R
5 Og[
U5 nU R n U( a [ R R U5 n U R R XUS9n
U
R 5 nU H n [ R R U 5 n Uc U R S:w a, [ R R X@R 4U 5 n
OS n
[ U [ R U
5 n[# SU5 n [% U[ R R X4U 5 U5 [' U5 s $ [* R, e! [( a M f = f)N)r' lifetimer g @)_compute_timesr inet
is_addressappendr! r r" af_for_addressr resolve_name addressesr low_level_address_tuple _make_socketsocket SOCK_STREAMr _connect_CoreSyncStream Exceptionhttpcore ConnectError)r# hostportr
local_addresssocket_optionsr2 _r r' answersaddressafsourcesockattempt_expirations r connect_tcp_NetworkBackend.connect_tcpP s I *7 3MAxx""4(( &((4 !8!89$Z0 XX 4 4] CF ..55' 6 $ - - / $XX,,W5 ,0@0@A0E XX = =&(8(892 F "F#B(:(:FC%A#z%R" 88' "M*
+400! %& '' ' ! s #6F..
F<;F<c [ er NotImplementedError)r# pathr r? s r connect_unix_socket#_NetworkBackend.connect_unix_socketw s
& %r )r! r" r r r ) __name__
__module__ __qualname____firstlineno__r rG rM __static_attributes__
__classcell__r( s @r r r H s$ " FJ% (P 15 & &r r c J ^ \ rS rSrSSS\R
S.U 4S jjrSrU =r$ )_HTTPTransport| r N)r% r& r$ r' c > Uc! Uc SS K nUR R 5 n[ TU ] " U0 UD6 [ X1X$5 U R l g Nr ) dns.resolverr$ Resolverr r r _pool_network_backend) r# r% r& r$ r' argskwargsr r( s r r _HTTPTransport.__init__} sO $5$=# <<002 G d -f -*9&7+DJJ 'r ) rO rP rQ rR r5 AF_UNSPECr rS rT rU s @r rW rW | s! "##
r rW c \ rS rSrS rSrg)rW c [ er rJ )r# r< r= r r> s r rG _HTTPTransport.connect_tcp % %r rb N)rO rP rQ rR rG rS rb r r rW rW s &r c | \ rS rSrSr " S S\5 r " S S\5 r " S S5 r " S S
5 r \
S 5 r S r g
)ssl r c \ rS rSrSrg)ssl.WantReadException rb NrO rP rQ rR rS rb r r WantReadExceptionrm r rp c \ rS rSrSrg)ssl.WantWriteException rb Nro rb r r WantWriteExceptionrs rq r ru c \ rS rSrSrg)ssl.SSLContext rb Nro rb r r
SSLContextrw rq r ry c \ rS rSrSrg)
ssl.SSLSocket rb Nro rb r r SSLSocketr{ rq r r} c [ S5 e)Nzno ssl support)r9 )clsr_ r` s r create_default_contextssl.create_default_context s ,- -r rb N)
rO rP rQ rR CERT_NONEr9 rp ru ry r} classmethodr rS rb r r rj rj sG
.
.r rj c \ rS rSrSrSrg)UnexpectedSource z=A DNS query response came from an unexpected address or port.rb NrO rP rQ rR __doc__rS rb r r r r s Gr r c \ rS rSrSrSrg) BadResponse z--'' ' ::g mm### r c " [ U SSSU5 g )NTFr sr s r _wait_for_readabler s
audJ/r c " [ U SSSU5 g )NFTr r s r _wait_for_writabler s
adJ/r c [ R R XS 5 n[ R R XS 5 nX4:H =( a USS USS :H $ ! [ R R a gf = f)Nr F )r r- inet_ptonr
SyntaxError)rC a1a2n1n2s r _addresses_equalr su
XX
qE
*
XX
qE
* 8 (12"QR&(( == $ $ s AA A=<A=c U( d g[ XU5 ( d3 [ R R US 5 ( a
USS USS :X a gU( a g[ SU SU 35 e)NTr r Fzgot a response from z instead of )r r r- is_multicastr )rC from_address destinationignore_unexpecteds r _matches_destinationr sl +66 k!n--,qr2BkRSRTo2U
|nL[MJ r Tc 4 S nS n [ R R U 5 nU nU( a9 [ R R U5 nU( a Xu:w a [ S5 eOUnU( a' U( d [ R R U5 nU( a! [ R R
Xa4U5 nU( a! [ R R
X#4U5 nXVU4$ ! [ a U( a e Nf = f! [ a [ S5 ef = f)Nz5different address families for source and destinationz3source_port specified but address family is unknown)r r- r0 r9
ValueError
any_for_afr3 )wherer= rD source_portwhere_must_be_addressrC r safs r _destination_and_sourcer s
BK
XX
$
$U
+
hh%%f-
y K B6 TXX((,F hh66 7JBO
1162GL V $$? !, T RS S Ts !C) 6 D )C>=C>Dc [ X5 n UR S5 Ub UR U5 U( a UR USUS9$ U$ ! [ a UR 5 e f = f)NF)do_handshake_on_connectserver_hostname)socket_factory setblockingbind wrap_socketr9 close)rC typerD ssl_contextr r s r r4 r4 @ st r A
e
FF6N **(- / +
H
s U[ R
:X a SU SU U 3nO!U[ R :X a
SU SU U 3nOUn0 nU c [ R R W5 nUR c [ S5 e[ R R UR 5 ( a UR n UR US' UR b UR nU[ R :X d U[ R :X a [ ( dy U cc [# U
5 n
WR c eU
R% UR U5 n[& R( " [+ UR- 5 5 5 n [/ U U WUUUUUUU U
S 9 $ [ ( d [0 eU( a* [3 U[4 R6 5 ( d [ S
5 eU R9 5 nS S 0nU[ R: [ R 4; nU[ R< [ R 4; nUc SnS
n O
US
nUS n U( a [> R@ " U5 n O'[C UUUU U U U
US9n [4 R6 " UUU U S9n U nU
( a: URE S [G [I U5 5 S.5 URK WUUUUS9n OJ[L RN " U5 RQ S5 nURS 5 n URU WUUSU 0US9n SSS5 W RV S: d U RV S: a' [ U SU RV SU RX 35 e[ RZ R] U RX U R^ U R` UUS9n!U Rb Re 5 U!l3 U Ri U!5 ( d [j eU!$ ! , ( d f N= f)a Return the response obtained after sending a query via DNS-over-HTTPS.
*q*, a ``dns.message.Message``, the query to send.
*where*, a ``str``, the nameserver IP address or the full URL. If an IP address is
given, the URL will be constructed using the following schema:
https://:/.
*timeout*, a ``float`` or ``None``, the number of seconds to wait before the query
times out. If ``None``, the default, wait forever.
*port*, a ``int``, the port to send the query to. The default is 443.
*source*, a ``str`` containing an IPv4 or IPv6 address, specifying the source
address. The default is the wildcard address.
*source_port*, an ``int``, the port from which to send the message. The default is
0.
*one_rr_per_rrset*, a ``bool``. If ``True``, put each RR into its own RRset.
*ignore_trailing*, a ``bool``. If ``True``, ignore trailing junk at end of the
received message.
*session*, an ``httpx.Client``. If provided, the client session to use to send the
queries.
*path*, a ``str``. If *where* is an IP address, then *path* will be used to
construct the URL to send the DNS query to.
*post*, a ``bool``. If ``True``, the default, POST method will be used.
*bootstrap_address*, a ``str``, the IP address to use to bypass resolution.
*verify*, a ``bool`` or ``str``. If a ``True``, then TLS certificate verification
of the server is done using the default CA bundle; if ``False``, then no
verification is done; if a `str` then it specifies the path to a certificate file or
directory which will be used for verification.
*resolver*, a ``dns.resolver.Resolver`` or ``None``, the resolver to use for
resolution of hostnames in URLs. If not specified, a new resolver with a default
configuration will be used; note this is *not* the default resolver as that resolver
might have been configured to use DoH causing a chicken-and-egg problem. This
parameter only has an effect if the HTTP library is httpx.
*family*, an ``int``, the address family. If socket.AF_UNSPEC (the default), both A
and AAAA records will be retrieved.
*http_version*, a ``dns.query.HTTPVersion``, indicating which HTTP version to use.
Returns a ``dns.message.Message``.
FNzhttps://:z https://[z]:zno hostname in URL sni_hostname)r r z)session parameter must be an httpx.Clientacceptzapplication/dns-messager r )r> http1http2r r% r& r$ r' )r r r transport)z content-typezcontent-length)headerscontentr
extensions =r )r r paramsr + responded with status code z
Response body: keyring request_macr r )6r r r- r. r5 AF_INETAF_INET6urllibparseurlparsehostnamer r= r r r have_dohr r1 randomchoicelistr2 _http3r r httpxClientto_wirer r
contextlib nullcontextrW updatestrlenr base64urlsafe_b64encoderstripdecodeget status_coder message from_wirer r elapsed
total_secondsr is_responser )"r r r r= rD r r r r rL r r& r r$ r' r rC r@
the_sourceurlr parsedrA wirer h1h2r> r% cmr responsetwirers" r httpsr r s N 2
V%RJ
~#((--e44
UG1TF4&1C
6??
" eWBtfTF3CJ &&s+ ?? " 12 2 88 v / / & )/ J~ & ;; ";;D{~~% +++HH $*84H??. .. ++FOOVDG &
d73D3D3F.G H
8 z'5<<88DEE 99;D23G +..+*=*=> >B +..+*=*=> >B
"1
]
0:0F0Fw0O"'! /
\\"Vy
Q w NN$=&)#d)n
|| % $ H ++D188>DKKME {{ u~% # H)
< c!X%9%9C%?g1(2F2F1G 0 0 1
3
MM)' A
+
+
-AF == H[
s
8B P
P r namec H U c [ eU H u p#X!:X d M Us $ [ er )KeyError)r r headervalues r _find_headerr! 9 s)
>L ! Nr peerr c [ U S5 nUc [ S5 e[ U5 nUS: a [ S5 eUS: d US: a7 Sn[ U5 S: a SUR 5 - n[
U S U U 35 eg ! [
a N f = f)
Ns :statusz no :status header in responser zstatus is negativer r z: r )r! r intr r r9 r )r r" r r statuserrors r
_check_statusr( B s * -E }9::
ZF
z.//
|v| t9q=
t{{}, D6!=fXeWMNN $
s A; ;
BBr r c [ R R ( d [ S5 e[ R
R
U5 n U R n
U R b U R nSU l U R 5 n
[ R R XSS9nU UR XXV5 n[ U5 u nnUR U5 nUR X-U 5 UR! [# U5 5 n
[% UR' 5 X 5 S S S 5 [( R( " 5 nS S S 5 [ R* R- U
U R. U R0 UUS9n[3 WW-
S5 Ul U R5 U5 ( d [6 eU$ ! , ( d f N= f! , ( d f N= f)Nz DNS-over-HTTP3 is not available.r T) verify_mode server_nameh3r r
) r quic have_quicr r r r r r= idr SyncQuicManagerconnectr, make_streamsend_h3receiver r( r r r r
r r maxr r )r r r r r= rD r r r r r r url_partsr manager
connectionstartr streamfinishr s r r r S sm 88 677 %%c*I!!H~~!~~ AD 99;Dhh&&T ' G
__U&F
,W 5
#
#G
, NN3d +>>*Z"89D &..*E 8 -
MM)' A %
%AF == H -
,
s% &2F<AF+ F<+
F9 5F<<
G
c b U R U5 $ ! [ a [ X5 Of = fM/ )zReads a datagram from the socket.
A Timeout exception will be raised if the operation is not completed
by the expiration time.
)recvfromBlockingIOErrorr )rE max_sizer s r _udp_recvr@ s7
1==* * 1 t 0 1 s ,,c U( a U R X5 $ U R U5 $ ! [ a [ X5 Of = fMG )zSends the specified datagram to destination over the socket.
A Timeout exception will be raised if the operation is not completed
by the expiration time.
)sendtosendr> r )rE datar r s r _udp_sendrE sH
1{{455yy& 1 t 0 1
s , , AArE whatr r c [ U[ R R 5 ( a UR 5 n[
R
" 5 n[
XX#5 nXT4$ )a Send a DNS message to the specified UDP socket.
*sock*, a ``socket``.
*what*, a ``bytes`` or ``dns.message.Message``, the message to send.
*destination*, a destination tuple appropriate for the address family
of the socket, specifying where to send the query.
*expiration*, a ``float`` or ``None``, the absolute time at which
a timeout exception should be raised. If ``None``, no timeout will
occur.
Returns an ``(int, float)`` tuple of bytes sent and the sent time.
)r r r Messager r rE )rE rF r r sent_timens r send_udprK sE , $ ++,,||~ I$k6A
>r r r r raise_on_truncation
ignore_errorsqueryc Sn [ U SU5 u p[ U R XU5 ( d M. [ R " 5 n
[ R
R
U UUUUUS9nU ( a U
b U
R U5 ( d M U( a X4$ XU 4$ ! [ R
R a: nU ( a- U
b* U
R UR 5 5 ( d SnAM e SnAf[ a
U ( a GM e f = f)a Read a DNS message from a UDP socket.
*sock*, a ``socket``.
*destination*, a destination tuple appropriate for the address family
of the socket, specifying where the message is expected to arrive from.
When receiving a response, this would be where the associated query was
sent.
*expiration*, a ``float`` or ``None``, the absolute time at which
a timeout exception should be raised. If ``None``, no timeout will
occur.
*ignore_unexpected*, a ``bool``. If ``True``, ignore responses from
unexpected sources.
*one_rr_per_rrset*, a ``bool``. If ``True``, put each RR into its own
RRset.
*keyring*, a ``dict``, the keyring to use for TSIG.
*request_mac*, a ``bytes`` or ``None``, the MAC of the request (for TSIG).
*ignore_trailing*, a ``bool``. If ``True``, ignore trailing
junk at end of the received message.
*raise_on_truncation*, a ``bool``. If ``True``, raise an exception if
the TC bit is set.
Raises if the message is malformed, if network errors occur, of if
there is a timeout.
If *destination* is not ``None``, returns a ``(dns.message.Message, float)``
tuple of the received message and the received time.
If *destination* is ``None``, returns a
``(dns.message.Message, float, tuple)``
tuple of the received message, the received time, and the address where
the message arrived from.
*ignore_errors*, a ``bool``. If various format errors or response
mismatches occur, ignore them and keep listening for a valid response.
The default is ``False``.
*query*, a ``dns.message.Message`` or ``None``. If not ``None`` and
*ignore_errors* is ``True``, check that the received message is a response
to this query, and if not keep listening for a valid response.
r )r r r r rL N)
r@ r r' r r r r
Truncatedr r9 )rE r r r r r r r rL rM rN r r
received_timer es r receive_udprT s | D
(uj A # KK 4E
%% '!1 /$7
& A6 U .u7H7H7K7K % %l3 31 {{$$
% ))!))+66 s$ "B D7.C,+C,,DD5 c U R 5 n [ XXE5 u pn[ U5 u nnU
( a [ R " U
5 nO[ U
[ R U5 nU n[ UXU5 [ UUUUUU R U R UU U U 5 u nnUU-
Ul U ( d U R U5 ( d [ eUsSSS5 $ ! , ( d f O= f e)a Return the response obtained after sending a query via UDP.
*q*, a ``dns.message.Message``, the query to send
*where*, a ``str`` containing an IPv4 or IPv6 address, where
to send the message.
*timeout*, a ``float`` or ``None``, the number of seconds to wait before the
query times out. If ``None``, the default, wait forever.
*port*, an ``int``, the port send the message to. The default is 53.
*source*, a ``str`` containing an IPv4 or IPv6 address, specifying
the source address. The default is the wildcard address.
*source_port*, an ``int``, the port from which to send the message.
The default is 0.
*ignore_unexpected*, a ``bool``. If ``True``, ignore responses from
unexpected sources.
*one_rr_per_rrset*, a ``bool``. If ``True``, put each RR into its own
RRset.
*ignore_trailing*, a ``bool``. If ``True``, ignore trailing
junk at end of the received message.
*raise_on_truncation*, a ``bool``. If ``True``, raise an exception if
the TC bit is set.
*sock*, a ``socket.socket``, or ``None``, the socket to use for the
query. If ``None``, the default, a socket is created. Note that
if a socket is provided, it must be a nonblocking datagram socket,
and the *source* and *source_port* are ignored.
*ignore_errors*, a ``bool``. If various format errors or response
mismatches occur, ignore them and keep listening for a valid response.
The default is ``False``.
Returns a ``dns.message.Message``.
N)r r r, r r r4 r5
SOCK_DGRAMrK rT r macr r r )r r r r= rD r r r r rL rE rM r rC r
begin_timer r r r rR s r udprZ & s p
99;D 7
V! Rf .g 6 Z 0:0F0Ft0L
"f / /
8 qDz2 (
II
EE
M + q!1!1 )
,
s
)A(C
C)udp_socktcp_sockc [ U UUUUUUUUSU U 5 n U S4$ ! [ R R a [ U UUUUUUUU
5 n U S4s $ f = f)a Return the response to the query, trying UDP first and falling back
to TCP if UDP results in a truncated response.
*q*, a ``dns.message.Message``, the query to send
*where*, a ``str`` containing an IPv4 or IPv6 address, where to send the message.
*timeout*, a ``float`` or ``None``, the number of seconds to wait before the query
times out. If ``None``, the default, wait forever.
*port*, an ``int``, the port send the message to. The default is 53.
*source*, a ``str`` containing an IPv4 or IPv6 address, specifying the source
address. The default is the wildcard address.
*source_port*, an ``int``, the port from which to send the message. The default is
0.
*ignore_unexpected*, a ``bool``. If ``True``, ignore responses from unexpected
sources.
*one_rr_per_rrset*, a ``bool``. If ``True``, put each RR into its own RRset.
*ignore_trailing*, a ``bool``. If ``True``, ignore trailing junk at end of the
received message.
*udp_sock*, a ``socket.socket``, or ``None``, the socket to use for the UDP query.
If ``None``, the default, a socket is created. Note that if a socket is provided,
it must be a nonblocking datagram socket, and the *source* and *source_port* are
ignored for the UDP query.
*tcp_sock*, a ``socket.socket``, or ``None``, the connected socket to use for the
TCP query. If ``None``, the default, a socket is created. Note that if a socket is
provided, it must be a nonblocking connected stream socket, and *where*, *source*
and *source_port* are ignored for the TCP query.
*ignore_errors*, a ``bool``. If various format errors or response mismatches occur
while listening for UDP, ignore them and keep listening for a valid response. The
default is ``False``.
Returns a (``dns.message.Message``, tcp) tuple where tcp is ``True`` if and only if
TCP was used.
TF)rZ r r rQ tcp)
r r r r= rD r r r r r[ r\ rM r s
r udp_with_fallbackr_ s r
% ;;
$ s 5AAc & SnUS: a= U R U5 nUS:X a [ S5 eU[ U5 - nX4-
nUS: a M= U$ ! [ [ R
4 a [
X5 N1[ R a [ X5 NQf = f)zRead the specified number of bytes from sock. Keep trying until we
either get the desired amount, or we hit EOF.
A Timeout exception will be raised if the operation is not completed
by the expiration time.
r r EOF) recvEOFErrorr r> rj SSLWantReadErrorr SSLWantWriteErrorr )rE countr r rJ s r _net_readrg s A
!) 1 % ACx uo% SVOE
FA
!)
H !5!56 1 t 0$$ 1 t 0 1s 4A %B/ BBc Sn[ U5 nX4: a X0R XS 5 -
nX4: a M gg! [ [ R 4 a [ X5 N0[ R a [ X5 NPf = f)zWrite the specified data to the socket.
A Timeout exception will be raised if the operation is not completed
by the expiration time.
r N)r rC r> rj re r rd r )rE rD r currentls r
_net_writerk sr
G D A
+ 1 yyh 0 0G + !6!67 1 t 0## 1 t 0 1s 2 %A: A:9A:c [ U[ R R 5 ( a UR SS9nO [ U5 R
SS5 U- n[ R " 5 n[ XU5 [ U5 U4$ )a_ Send a DNS message to the specified TCP socket.
*sock*, a ``socket``.
*what*, a ``bytes`` or ``dns.message.Message``, the message to send.
*expiration*, a ``float`` or ``None``, the absolute time at which
a timeout exception should be raised. If ``None``, no timeout will
occur.
Returns an ``(int, float)`` tuple of bytes sent and the sent time.
T)prepend_lengthr big) r r r rH r r to_bytesr rk )rE rF r tcpmsgrI s r send_tcprq sl $ $ ++,, T 2
T##Au-4 ItZ( K ##r c [ U SU5 n[ R " SU5 u n[ XU5 n[ R " 5 n [ R
R
UUUUUS9n
X4$ )a Read a DNS message from a TCP socket.
*sock*, a ``socket``.
*expiration*, a ``float`` or ``None``, the absolute time at which
a timeout exception should be raised. If ``None``, no timeout will
occur.
*one_rr_per_rrset*, a ``bool``. If ``True``, put each RR into its own
RRset.
*keyring*, a ``dict``, the keyring to use for TSIG.
*request_mac*, a ``bytes`` or ``None``, the MAC of the request (for TSIG).
*ignore_trailing*, a ``bool``. If ``True``, ignore trailing
junk at end of the received message.
Raises if the message is malformed, if network errors occur, of if
there is a timeout.
Returns a ``(dns.message.Message, float)`` tuple of the received message
and the received time.
r !Hr )rg structunpackr r r r
) rE r r r r r ldatarj r rR r s r receive_tcprw so B
dAz *E ==u %DQ Tj )DIIKM )' A
r c X U R U5 nUS:X a g U[ R [ R [ R 4; a9 [ X5 U R
[ R [ R 5 nUS:w a [ U[ R " U5 5 eg rZ )
connect_exerrno EINPROGRESS EWOULDBLOCKEALREADYr
getsockoptr5
SOL_SOCKETSO_ERROROSErrorosstrerror)r rB r errs r r7 r7 K s}
,,w
C
ax
u %"3"3U^^DD1)ll6,,foo>
axc2;;s+,, r c U R 5 n [ U5 u pU( a [ R " U5 n O*[ XXE5 u pn[ U
[ R U5 n U nU( d
[ UWU 5 [ XU 5 [ XX`R U R U5 u nnUU
-
Ul
U R U5 ( d [ eUsSSS5 $ ! , ( d f O= f e)aU Return the response obtained after sending a query via TCP.
*q*, a ``dns.message.Message``, the query to send
*where*, a ``str`` containing an IPv4 or IPv6 address, where
to send the message.
*timeout*, a ``float`` or ``None``, the number of seconds to wait before the
query times out. If ``None``, the default, wait forever.
*port*, an ``int``, the port send the message to. The default is 53.
*source*, a ``str`` containing an IPv4 or IPv6 address, specifying
the source address. The default is the wildcard address.
*source_port*, an ``int``, the port from which to send the message.
The default is 0.
*one_rr_per_rrset*, a ``bool``. If ``True``, put each RR into its own
RRset.
*ignore_trailing*, a ``bool``. If ``True``, ignore trailing
junk at end of the received message.
*sock*, a ``socket.socket``, or ``None``, the connected socket to use for the
query. If ``None``, the default, a socket is created. Note that
if a socket is provided, it must be a nonblocking connected stream
socket, and *where*, *port*, *source* and *source_port* are ignored.
Returns a ``dns.message.Message``.
N)r r, r r r r4 r5 r6 r7 rq rw r rX r r r )r r r r= rD r r r rE r rY r r rC r r r rR s r r^ r^ V s V
99;D -g 6 Z 0:0F0Ft0L$; %
!& "f 0 0&
9 q Q Z 0*% (
+YY
M +}}Q
s
(A-C
C-c U R 5 g ! [ R a [ X5 O$[ R a [ X5 Of = fMY r ) do_handshakerj rd r re r r s r _tls_handshaker sO
.
NN ## . q -$$ . q - .
s A AAr c S nS n[ U[ 5 ( aY [ R R U5 ( a UnO2[ R R U5 ( a UnO [
S5 e[ R " X#S9n[ R R Ul U c SUl UR S/5 USL a [ R Ul U$ )Nzinvalid verify string)cafilecapathFdot)r r r rL isfileisdirr rj r
TLSVersionTLSv1_2minimum_versioncheck_hostnameset_alpn_protocolsr r* )r r r r r s r _make_dot_ssl_contextr s !F F&#
77>>& ! !F
WW]]6
"
"F 45 5,,FJK"%.."8"8K %* """E7+
"%-- r r c U( a [ U UUUUUUUU5 $ U R 5 n [ U5 u p[ XXE5 u nnnU c U( d [ X5 n [ U[ R UU U
S9 n[ UUU5 [ UU5 [ UX5 [ UXU R U R U5 u nnUU
-
Ul U R U5 ( d [ eUsSSS5 $ ! , ( d f O= f e)a Return the response obtained after sending a query via TLS.
*q*, a ``dns.message.Message``, the query to send
*where*, a ``str`` containing an IPv4 or IPv6 address, where
to send the message.
*timeout*, a ``float`` or ``None``, the number of seconds to wait before the
query times out. If ``None``, the default, wait forever.
*port*, an ``int``, the port send the message to. The default is 853.
*source*, a ``str`` containing an IPv4 or IPv6 address, specifying
the source address. The default is the wildcard address.
*source_port*, an ``int``, the port from which to send the message.
The default is 0.
*one_rr_per_rrset*, a ``bool``. If ``True``, put each RR into its own
RRset.
*ignore_trailing*, a ``bool``. If ``True``, ignore trailing
junk at end of the received message.
*sock*, an ``ssl.SSLSocket``, or ``None``, the socket to use for
the query. If ``None``, the default, a socket is created. Note
that if a socket is provided, it must be a nonblocking connected
SSL stream socket, and *where*, *port*, *source*, *source_port*,
and *ssl_context* are ignored.
*ssl_context*, an ``ssl.SSLContext``, the context to use when establishing
a TLS connection. If ``None``, the default, creates one with the default
configuration.
*server_hostname*, a ``str`` containing the server's hostname. The
default is ``None``, which means that no hostname is known, and if an
SSL context is created, hostname checking will be disabled.
*verify*, a ``bool`` or ``str``. If a ``True``, then TLS certificate verification
of the server is done using the default CA bundle; if ``False``, then no
verification is done; if a `str` then it specifies the path to a certificate file or
directory which will be used for verification.
Returns a ``dns.message.Message``.
N)r r )r^ r r, r r r4 r5 r6 r7 r rq rw r rX r r r )r r r r= rD r r r rE r r r r rY r rC r r r rR s r tlsr s z
99;D -g 6 Z 7
V! Rf 4+OD
'
K,q*%D% (
zQYY
M +}}Q !
$
s
8A3C55
Dr8 c > [ R R ( d [ S5 eU b U
c U n
SU l U R 5 n U( a [ R " S5 n
UnO [ R R XS9n
U
nU
U( d WR XXE5 n[ U5 u nnWR U5 nUR U S5 UR [ U5 5 n SSS5 [ R " 5 nSSS5 [ R R# U U R$ U R& UUS9n[) WW-
S5 Ul U R+ U5 ( d [, eU$ ! , ( d f N= f! , ( d f N= f)a+ Return the response obtained after sending a query via DNS-over-QUIC.
*q*, a ``dns.message.Message``, the query to send.
*where*, a ``str``, the nameserver IP address.
*timeout*, a ``float`` or ``None``, the number of seconds to wait before the query
times out. If ``None``, the default, wait forever.
*port*, a ``int``, the port to send the query to. The default is 853.
*source*, a ``str`` containing an IPv4 or IPv6 address, specifying the source
address. The default is the wildcard address.
*source_port*, an ``int``, the port from which to send the message. The default is
0.
*one_rr_per_rrset*, a ``bool``. If ``True``, put each RR into its own RRset.
*ignore_trailing*, a ``bool``. If ``True``, ignore trailing junk at end of the
received message.
*connection*, a ``dns.quic.SyncQuicConnection``. If provided, the connection to use
to send the query.
*verify*, a ``bool`` or ``str``. If a ``True``, then TLS certificate verification
of the server is done using the default CA bundle; if ``False``, then no
verification is done; if a `str` then it specifies the path to a certificate file or
directory which will be used for verification.
*hostname*, a ``str`` containing the server's hostname or ``None``. The default is
``None``, which means that no hostname is known, and if an SSL context is created,
hostname checking will be disabled. This value is ignored if *url* is not
``None``.
*server_hostname*, a ``str`` or ``None``. This item is for backwards compatibility
only, and has the same meaning as *hostname*.
Returns a ``dns.message.Message``.
z DNS-over-QUIC is not available.Nr )r* r+ Tr r
)r r- r. r r/ r r r r0 r1 r, r2 rC r4 r r r r
r r r5 r r )r r r r= rD r r r r8 r r r r r7 the_connection the_managerr9 r r: r; r s r r- r- ' sV n 88 566"x'7" AD 99;D 5?5K5KD5Q#((**v*T ( 0 0f RN ,W 5
'
'
0F KKd #>>*Z"89D 1
MM)' A %
%AF == H 1
0
s$ 9F-E=1 F=
F F
F c $ \ rS rSrSrSrSrSrSrg)UDPModei zHow should UDP be used in an IXFR from :py:func:`inbound_xfr()`?
NEVER means "never use UDP; always use TCP"
TRY_FIRST means "try to use UDP but fall back to TCP if needed"
ONLY means "raise ``dns.xfr.UseTCP`` if trying UDP does not succeed"
r r r rb N) rO rP rQ rR r NEVER TRY_FIRSTONLYrS rb r r r r s
EI Dr r txn_managerr serialc # " # UR S R nU[ R R :H nU R 5 nUR
5 n UR [ R :H n
U
( a [ XSU5 O/[ R " S[ U 5 5 U - n [ XU5 [ R R! XX:5 n Sn
SnU
( d [# U5 u nnUb Ub UU: a UnU
( a [% USU5 u nnO3[' USU5 n[ R( " SU5 u n[' UUU5 n[ R* R- UUR. UR0 SUUU
( + US9nU R3 U5 n
Uv UR4 nU
( d M UR. ( a0 WR6 ( d [ R8 R; S 5 eSSS5 g! , ( d f g= f7f)
z'Given a socket, does the zone transfer.r Nrs FrP r T)r r xfrorigintsig_ctxmultir z missing TSIG) questionrdtyper rdatatypeIXFRfrom_wire_originr r r5 rW rE rt packr rk r Inboundr, r@ rg ru r r
r rX process_messager had_tsigr
FormError)r r rN r r r r is_ixfrr r is_udprp inbounddoner r@ mexpirationrwirerv rj r s r _inbound_xfrr s ^^A
%
%F
***G
)
)
+F ==?D
VVv((
(F
!4,T3t9-41j) f = -g 6 Q "&;+C ( &q% =
!!Q 4 }}T51!!Q 4 %%
!II !!z!( & A **1-DGzzH1 $2 ==--)).9 9;
> = =s& CHCG>4AG>5 H>
H Hzoner rdclasskeyname
relativizer+ use_udp keyalgorithmc # H # " S S[ R R 5 n[ U[ 5 ( a [ R
R
U5 n[ R R R U5 n[ R R XU5 nU[ R R :X a UR UR U[ R R [ R R" SS9n[ R$ R
SSSU - 5 nUR' US5 Ub UR) XgUS
9 [+ XX5 u nnn
[- U 5 u nnU" X5 nU
( a) U[ R R :w a [/ S 5 eU
( a [0 R2 O[0 R4 n[7 UUU
5 n[9 UUU5 [; UUUXU5 S h vN S S S 5 g N
! , ( d f g = f7f) a/ Return a generator for the responses to a zone transfer.
*where*, a ``str`` containing an IPv4 or IPv6 address, where
to send the message.
*zone*, a ``dns.name.Name`` or ``str``, the name of the zone to transfer.
*rdtype*, an ``int`` or ``str``, the type of zone transfer. The
default is ``dns.rdatatype.AXFR``. ``dns.rdatatype.IXFR`` can be
used to do an incremental transfer instead.
*rdclass*, an ``int`` or ``str``, the class of the zone transfer.
The default is ``dns.rdataclass.IN``.
*timeout*, a ``float``, the number of seconds to wait for each
response message. If None, the default, wait forever.
*port*, an ``int``, the port send the message to. The default is 53.
*keyring*, a ``dict``, the keyring to use for TSIG.
*keyname*, a ``dns.name.Name`` or ``str``, the name of the TSIG
key to use.
*relativize*, a ``bool``. If ``True``, all names in the zone will be
relativized to the zone origin. It is essential that the
relativize setting matches the one specified to
``dns.zone.from_xfr()`` if using this generator to make a zone.
*lifetime*, a ``float``, the total number of seconds to spend
doing the transfer. If ``None``, the default, then there is no
limit on the time the transfer may take.
*source*, a ``str`` containing an IPv4 or IPv6 address, specifying
the source address. The default is the wildcard address.
*source_port*, an ``int``, the port from which to send the message.
The default is 0.
*serial*, an ``int``, the SOA serial number to use as the base for
an IXFR diff sequence (only meaningful if *rdtype* is
``dns.rdatatype.IXFR``).
*use_udp*, a ``bool``. If ``True``, use UDP (only meaningful for IXFR).
*keyalgorithm*, a ``dns.name.Name`` or ``str``, the TSIG algorithm to use.
Raises on errors, and so does the generator.
Returns a generator of ``dns.message.Message`` objects.
c \ rS rSrS rS rS\R R 4S jr S r
S S\ S\R R 4S jjrS rg
) $xfr..DummyTransactionManageri c X XU( a [ R R OU4U l g r )r r emptyinfo)r# r r s r r -xfr..DummyTransactionManager.__init__
s zSXX^^vVDIr c U R $ r r r# s r origin_information7xfr..DummyTransactionManager.origin_information
s 99 r r c [ er rJ r s r get_class.xfr..DummyTransactionManager.get_class rh r c [ er rJ r s r reader+xfr..DummyTransactionManager.reader rh r replacementc h " S S5 n[ [ R R U" 5 5 $ )Nc \ rS rSrS rS rSrg)Exfr..DummyTransactionManager.writer..DummyTransactioni c g r rb )r# r_ kws r nopIxfr..DummyTransactionManager.writer..DummyTransaction.nop s r c U R $ r )r )r# r@ s r __getattr__Qxfr..DummyTransactionManager.writer..DummyTransaction.__getattr__ s 88Or rb N)rO rP rQ rR r r rS rb r r DummyTransactionr s $r r )r r transaction Transaction)r# r r s r writer+xfr..DummyTransactionManager.writer s)
$
$ 335E5GH Hr r N)F)rO rP rQ rR r r r
rdataclass
RdataClassr r boolr r r rS rb r r DummyTransactionManagerr sN W &s~~ 8 8 & & Id Is7R7R I Ir r T)createINSOAz. . %u 0 0 0 0r N) algorithmzcannot do a UDP AXFR) r r TransactionManagerr r r from_textr RdataTypemaker
make_queryr
find_rrset authorityr r r rdataadduse_tsigr r, r r5 rW r6 r4 r7 r )r r r r r r= r r r r+ rD r r r r r r rrsetsoarC r r@ r tm sock_typer s r r r s JI#//"D"D I. $ xx!!$'
]]
$
$
)
)&
1F tW5A
###
KKs~~ 0 0#--2C2CD
ii!!$/?&/HI
#q
7|
< 7
V! Rf %X.OQ
2B6S]] / ///00%,!!&2D2DI b)V ,K, Aq&:FFF
- ,F
- ,s0 G H"! HHH H"H
H H"udp_modec 8 Uc" [ R R U5 u p)O [ R R U5 n [ XXg5 u pn[ U5 u pUR S R [ R R :X a[ U[ R :w aG [ U
[ R U5 n[ XU
5 [! X X)XM5 H n M SSS5 g[ U
[ R& U5 n[ XU
5 [! X X)XM5 H n M SSS5 g! [ R R" a U[ R$ :X a e Of = f SSS5 M ! , ( d f N= f! , ( d f g= f)a; Conduct an inbound transfer and apply it via a transaction from the
txn_manager.
*where*, a ``str`` containing an IPv4 or IPv6 address, where
to send the message.
*txn_manager*, a ``dns.transaction.TransactionManager``, the txn_manager
for this transfer (typically a ``dns.zone.Zone``).
*query*, the query to send. If not supplied, a default query is
constructed using information from the *txn_manager*.
*port*, an ``int``, the port send the message to. The default is 53.
*timeout*, a ``float``, the number of seconds to wait for each
response message. If None, the default, wait forever.
*lifetime*, a ``float``, the total number of seconds to spend
doing the transfer. If ``None``, the default, then there is no
limit on the time the transfer may take.
*source*, a ``str`` containing an IPv4 or IPv6 address, specifying
the source address. The default is the wildcard address.
*source_port*, an ``int``, the port from which to send the message.
The default is 0.
*udp_mode*, a ``dns.query.UDPMode``, determines how UDP is used
for IXFRs. The default is ``dns.UDPMode.NEVER``, i.e. only use
TCP. Other possibilities are ``dns.UDPMode.TRY_FIRST``, which
means "try UDP but fallback to TCP if needed", and
``dns.UDPMode.ONLY``, which means "try UDP and raise
``dns.xfr.UseTCP`` if it does not succeed.
Raises on errors.
Nr )r r r extract_serial_from_queryr r, r r r r r r r4 r5 rW r7 r UseTCPr r6 )r r rN r= r r+ rD r r r rC r r@ r r s r inbound_xfrr 9 sS ^
} '',,[92259 7
V! Rf %X.OQ ~~a 3==#5#55(gmm:S
"f / /
8A QZ 0
% E7A 9
8
b&,,f 5, keWQA R
6 5 77>>
w||+ ,
+ 9
8
8
6 5s6
E:D6 !F 63E,)E:+E,,E::
F
F)T)NN) NU Nr FFTNTr )
NNFFNr FFFN)
NrU Nr FFFFNF)
NrU Nr FFFNNF)NFNr F)NrU Nr FFN)
Nr Nr FFNNNT)
Nr Nr FFNTNN)~r r r enumrz r os.pathr r r5 rt r urllib.parser typingr r r r r r
dns._featuresr
dns.exceptiondns.inet dns.messagedns.namedns.quic dns.rcodedns.rdataclass
dns.rdatatype
dns.serialdns.transactiondns.tsigdns.xfrr r _featureshave _have_httpxhttpcore._backends.syncr: r NetworkBackend_CoreNetworkBackend _backendssync
SyncStreamr8 r
HTTPTransportrW r rj ImportErrorr r
DNSExceptionr r r r r r
TransferErrorr, r r r r r r r4 r IntEnumr rc r r rH r floatr% r r r- Headersbytesr! r( r r@ rE rK r NametsigKeyrT rZ r_ rg rk rq rw r7 r^ r ry r r} r SyncQuicConnectionr r r r r AXFRr r default_algorithmr r r r rb r r r# su
$
: : 2 mm ' ""11 ((--88O2&- 2&h,, ,& &
.2 Hs}}11 HG#--)) GCMM & &
CMM & & %%
$$800 )
" =A)%X( ./
$,,
& $ " ! ! '+ #26"" + 3 3!D
{{D
D
e_D
D
SM D
D
D
D
c]D
D
D
}D
$) D
./ D
D
!D
" [[#D
N#((** % E O388++ O3 Oe O O* $ " ! # ".
{{.
.
.
e_ .
.
SM
.
.
.
.
$) .
sm.
.
[[.
b 1 1& #'
##U*
+
3: > "&"& # ";?#& ! % +/g4
g4# g4 g4 g4
g4 d388==#((,,67
8
g4 % g4 g4 g4 g4 CKK'' (g4 g4Z $ # " ! % X
{{X X e_X X
SM X
X X X X X 3-X X [[X| $ # " ! " " U
{{U U e_U U
SM U
U U U U smU smU U 3;; $%U p
*
1& #'$
$
##U*
+$ $ 3: $@ #' ";?#& !
,
, , , d388==#((,,67
8 ,
% ,
, 3;; %&, ^- $ " ! B
{{B B e_B B
SM B
B B B 3-B [[BJ. c],1$),<^^2 $ " !$(,0%) #h
{{h h e_h h
SM h
h h h 3==
!h #..)h c]h
$) h [[h\ $ " !8< # "%)Z
{{Z
Z
e_Z
Z
SM Z
Z
Z
Z
445Z
$) Z
smZ
c]Z
[[Z
z
dll
0: 330:
}}0: ;; 0:
SM 0:
e_ 0:
0: 0:l 36--2D2D58^^5F5F #;?37 $ .1hh.H.H rG rG
s"
#rG
#--))3. /rG 3>>,,c1
2 rG
e_ rG
rG d388==#((,,67
8rG eCHHMM3 ./
0rG rG uorG
SMrG rG
rG rG
s*+ rG !rGp ,0 # $
H H 33H CKK'' (H H
e_ H uo
H
SMH H H
H}, .. ..s a0 0bb