SrSSKJr SSKJr SSKrSSKrSSKrSSK rSSK rSSK rSSK rSSK rSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSKJrJrJr "SS\R4R65r"S S \R4R65r"S S \R4R<5r"S S\R4R65r "SS\R4R65r!"SS\R4R<5r"Sr#Sr$Sr%Sr&"SS\'5r("SS\'5r)S!Sjr*"SS\'5r+Sr,Sr-\R\R^SSSSSS4Sjr0S"S jr1g)#z DNS Messages)absolute_import)StringION)longxrange string_typesc\rSrSrSrSrg) ShortHeader,z2The DNS packet passed to from_wire() is too short.N__name__ __module__ __qualname____firstlineno____doc____static_attributes__r lib/third_party/dns/message.pyr r ,szSA TSIG record occurred somewhere other than the end of the additional data section.r Nr r rrr!r!>rrr!c\rSrSrSrSrg)UnknownTSIGKeyCz(A TSIG with an unknown key was received.r Nr r rrr$r$Cs2rr$cB\rSrSrSrSSjrSrSrSSjrSr S r S r S r S r \RR SS S 4Sjr\RR SS S 4SjrSSjrSSSSS\R(R*4SjrSSjrS SjrSrSrSrSrSrg)!MessageSzA DNS message.NcUc$[RR5UlOXlSUl/Ul/Ul/Ul/UlSUl SUl SUl /Ul SUl SUlSUl[R R"UlSUlSUlSUlSUlURUlSUlSUlSUlSUlSUlSUlSUl0Ulg)Nrr,FT) dnsentropy random_16idflagsquestionanswer authority additionaledns ednsflagspayloadoptionsrequest_payloadkeyringkeynametsigdefault_algorithm keyalgorithm request_mac other_data tsig_errorfudge original_idmacxfrorigintsig_ctxhad_tsigmultifirstindex)selfr1s r__init__Message.__init__Vs :kk++-DGG         HH66 77      rc8S[UR5-S-$)Nz)reprr1rNs r__repr__Message.__repr__vs"T$'']2S88rc"UR5$N)to_textrTs r__str__Message.__str__ys||~rc [5nURSUR-5 URS[RR [RR UR55-5 [RR URUR5nURS[RR U5-5 URS[RR UR5-5 URS:aURSUR-5 URS:wa;URS[RRUR5-5 URSUR-5 URH%nURS UR 5-5 M' [RRUR5nU(aURS 5 OURS 5 URH6nURUR "X40UD65 URS 5 M8 U(aURS 5 OURS5 UR H6nURUR "X40UD65 URS 5 M8 U(aURS5 OURS5 UR"H6nURUR "X40UD65 URS 5 M8 URS5 UR$H6nURUR "X40UD65 URS 5 M8 UR'5SS$)zConvert the message to text. The *origin*, *relativize*, and any other keyword arguments are passed to the RRset ``to_wire()`` method. Returns a ``text``. zid %d z opcode %s z rcode %s z flags %s rzedns %s z eflags %s z payload %d z option %s z;ZONE z ;QUESTION  z;PREREQ z;ANSWER z;UPDATE z ;AUTHORITY z ;ADDITIONAL Nr,)rwriter1r.opcoderY from_flagsr2rcoder8r7 edns_to_textr9r: is_updater3r4r5r6getvalue) rNrH relativizekwsrcoptrcrrsets rrYMessage.to_text|s J  TWW$%  ""3::#8#8#DEF G YY ! !$**dnn =   1 1" 556   1 1$** ==> 99> GGL499, -~~" ..t~~>?@ GGOdll2 3<> ! z !?? "./ /rFc [U[5(aUn URU 5nOURU5n XX4XV4n U(dSURb!URR U 5n U bU $O%UHn U R X#XEU5(dMU s $ U(d[e[RRX#XEU5n URU 5 URbXRU 'U $)aFind the RRset with the given attributes in the specified section. *section*, an ``int`` section number, or one of the section attributes of this message. This specifies the the section of the message to search. For example:: my_message.find_rrset(my_message.answer, name, rdclass, rdtype) my_message.find_rrset(dns.message.ANSWER, name, rdclass, rdtype) *name*, a ``dns.name.Name``, the name of the RRset. *rdclass*, an ``int``, the class of the RRset. *rdtype*, an ``int``, the type of the RRset. *covers*, an ``int`` or ``None``, the covers value of the RRset. The default is ``None``. *deleting*, an ``int`` or ``None``, the deleting value of the RRset. The default is ``None``. *create*, a ``bool``. If ``True``, create the RRset if it is not found. The created RRset is appended to *section*. *force_unique*, a ``bool``. If ``True`` and *create* is also ``True``, create a new RRset regardless of whether a matching RRset exists already. The default is ``False``. This is useful when creating DDNS Update messages, as order matters for them. Raises ``KeyError`` if the RRset was not found and create was ``False``. Returns a ``dns.rrset.RRset object``. ) rmintrrrMgetmatchKeyErrorr.rjRRsetappend) rNrnamerdclassrdtypecoversdeletingcreate force_uniquerkeyrjs r find_rrsetMessage.find_rrsetsL gs # #$N..~>G!009NWfGzz% s+$ L%%E{{4&(KK$ %N vxHu :: !#JJsO rc XURXX4UXgU5n U $![a Sn U $f=f)aGet the RRset with the given attributes in the specified section. If the RRset is not found, None is returned. *section*, an ``int`` section number, or one of the section attributes of this message. This specifies the the section of the message to search. For example:: my_message.get_rrset(my_message.answer, name, rdclass, rdtype) my_message.get_rrset(dns.message.ANSWER, name, rdclass, rdtype) *name*, a ``dns.name.Name``, the name of the RRset. *rdclass*, an ``int``, the class of the RRset. *rdtype*, an ``int``, the type of the RRset. *covers*, an ``int`` or ``None``, the covers value of the RRset. The default is ``None``. *deleting*, an ``int`` or ``None``, the deleting value of the RRset. The default is ``None``. *create*, a ``bool``. If ``True``, create the RRset if it is not found. The created RRset is appended to *section*. *force_unique*, a ``bool``. If ``True`` and *create* is also ``True``, create a new RRset regardless of whether a matching RRset exists already. The default is ``False``. This is useful when creating DDNS Update messages, as order matters for them. Returns a ``dns.rrset.RRset object`` or ``None``. N)rr) rNrrrrrrrrrjs r get_rrsetMessage.get_rrset\sDJ OOG7F$,lDE  E  s  ))rc US:XaURS:wa URnOSnUS:aSnOUS:aSn[RRURUR X!5nUR H4nURURURUR5 M6 URH/nUR"[RRU40UD6 M1 URH/nUR"[RRU40UD6 M1 UR S:a<UR#UR UR$UR&UR(5 UR*H/nUR"[RR,U40UD6 M1 UR/5 UR0bUR3UR0UR4UR0UR6UR8UR:UR<UR>UR@5 URBUl!URE5$)aReturn a string containing the message in DNS compressed wire format. Additional keyword arguments are passed to the RRset ``to_wire()`` method. *origin*, a ``dns.name.Name`` or ``None``, the origin to be appended to any relative names. *max_size*, an ``int``, the maximum size of the wire format output; default is 0, which means "the message's request payload, if nonzero, or 65535". Raises ``dns.exception.TooBig`` if *max_size* was exceeded. Returns a ``binary``. rii)#r;r.rendererRendererr1r2r3 add_questionrrrr4 add_rrsetr~r5rr7add_ednsr8r9r:r6r write_headerr=add_tsigr<rDrErCrBrAr@rFget_wire)rNrHmax_sizerfrrjs rto_wireMessage.to_wires& q=##q(//  c>H  H LL ! !$''4::x H]]E NN5::u||U]] C#[[E KK ++U 9b 9!^^E KK .. < <$ 99> JJtyy$..$,, M__E KK // =" =%  << # JJt||T\\$,,%?zz4#3#3T__(8(8(( *uuDHzz|rr-rcHXlUc,[URR55SUlO:[ U[ 5(a[ RRU5nX lXpl X0l UcURUl OX@l XPl X`lg)aWhen sending, a TSIG signature using the specified keyring and keyname should be added. See the documentation of the Message class for a complete description of the keyring dictionary. *keyring*, a ``dict``, the TSIG keyring to use. If a *keyring* is specified but a *keyname* is not, then the key used will be the first key in the *keyring*. Note that the order of keys in a dictionary is not defined, so applications should supply a keyname when a keyring is used, unless they know the keyring contains only one key. *keyname*, a ``dns.name.Name`` or ``None``, the name of the TSIG key to use; defaults to ``None``. The key must be defined in the keyring. *fudge*, an ``int``, the TSIG time fudge. *original_id*, an ``int``, the TSIG original id. If ``None``, the message's id is used. *tsig_error*, an ``int``, the TSIG error code. *other_data*, a ``binary``, the TSIG other data. *algorithm*, a ``dns.name.Name``, the TSIG algorithm to use. Nr)r<listkeysr=rmrr.r from_textr@rDr1rErCrB)rNr<r=rDrErCrB algorithms ruse_tsigMessage.use_tsigs> ? 1 1 34Q7DL'<00((,,W5"L%  #wwD * $$rcUbUSLaSnUSLaSnUcUnUS:a SnSnSn/nOU[S5-nX!S--nUc/nXlX lX0lXPlX@lg)aConfigure EDNS behavior. *edns*, an ``int``, is the EDNS level to use. Specifying ``None``, ``False``, or ``-1`` means "do not use EDNS", and in this case the other parameters are ignored. Specifying ``True`` is equivalent to specifying 0, i.e. "use EDNS0". *ednsflags*, an ``int``, the EDNS flag values. *payload*, an ``int``, is the EDNS sender's payload field, which is the maximum size of UDP datagram the sender can handle. I.e. how big a response to this message can be. *request_payload*, an ``int``, is the EDNS payload size to use when sending this message. If not specified, defaults to the value of *payload*. *options*, a list of ``dns.edns.Option`` objects or ``None``, the EDNS options. NFr,Trl~)rr7r8r9r:r;)rNr7r8r9r;r:s ruse_ednsMessage.use_ednss. <45=D 4<D  "%O !8IGOG j) )I "* %I "  .rc,U(aNURS:aUR5 U=R[RR -slgURS:a/U=R[RR )-slgg)zEnable or disable 'DNSSEC desired' flag in requests. *wanted*, a ``bool``. If ``True``, then DNSSEC data is desired in the response, EDNS is enabled if required, and then the DO bit is set. If ``False``, the DO bit is cleared if EDNS is enabled. rN)r7rr8r.r2DO)rNwanteds r want_dnssecMessage.want_dnssecsY yy1}  NNciill *N YY!^ NNsyy||m +Nrcj[RRURUR5$)z'Return the rcode. Returns an ``int``. )r.rar`r2r8rTs rra Message.rcode%s# yy##DJJ??rcR[RRU5up#U=RS-slU=RU-slU=R[ S5-slU=RU-slURS:waUR S:aSUlggg)z:Set the rcode. *rcode*, an ``int``, is the rcode to set. iirN)r.rato_flagsr2r8rr7)rNravalueevalues r set_rcodeMessage.set_rcode,s| )),,U3 f  e  $z** &  >>Q 499q=DI$1 rcT[RRUR5$)z(Return the opcode. Returns an ``int``. )r.r_r`r2rTs rr_Message.opcode9s zz$$TZZ00rcU=RS-slU=R[RRU5-slg)z=Set the opcode. *opcode*, an ``int``, is the opcode to set. iN)r2r.r_r)rNr_s r set_opcodeMessage.set_opcode@s/ f  cjj))&11 r)r6r4r5r7r8rLr2rDrJr1rMr@r=r<rFrKr:rHrErBr9r3rAr;rIrCrGrX)NT)Nr)rriNN)T)rrrrrrOrUrZrYrqrtryrrr. rdatatypeNONErrrr>r?rrrrarr_rrr rrr)r)Ss@97!rB&00.00--,,tE %;|++d5$*X.`)-C!aC8855-%^KO,/\, @ 12rr)c8\rSrSrSrS SjrSrSrSrSr g) _WireReaderiIaWire format reader. wire: a binary, is the wire-format message. message: The message object being built current: When building a message object from wire format, this variable contains the offset from the beginning of wire of the next octet to be read. updating: Is the message a dynamic update? one_rr_per_rrset: Put each RR into its own RRset? ignore_trailing: Ignore trailing junk at end of request? zone_rdclass: The class of the zone in messages which are DNS dynamic updates. c[RRU5UlX lSUlSUl[RRUl X0l X@l XPl g)NrF) r.wiredata maybe_wrapwiremessagecurrentupdating rdataclassIN zone_rdclass question_onlyone_rr_per_rrsetignore_trailing)rNrrrrrs rrO_WireReader.__init__YsOLL++D1    NN--* 0.rc UR(a US:a[RRe[ SU5GH&n[R R URUR5up4URRb%URURR5nURU-Ul[R"SURURURS-5upVURS-UlURRURRUXeSSS9 UR(dGM X`lGM) g)zXRead the next *qcount* records from the wire data and add them to the question section. rrN!HHTrr)rr. exception FormErrorrr from_wirerrrrHrestructunpackrr3r)rNqcountiqnameusedrrs r _get_question_WireReader._get_questionds  ==VaZ--)) )6"AHH..tyy$,,GMU||"".(()<)<=<<$.DL e"ii T\\A5EFH V <get_algorithm_and_macr@rFvalidatertimerArIrKrLrJrANYrrr4rdatarrGSOAradd)rNrcountrseen_optrrr_startrr absolute_namerrttlrdlenroptslenotypeolenrisecretrrrdrjs r _get_section_WireReader._get_section{sl ==D11L L5!A||H88--diiFLT M||"".t||':':;<<$.DL g"ii T\\B5FGI *Vc <<",DL***,,"9"99X!M'. $), &%(8^$: !') $,,k e&*ii! &DF"UD&kG((33tyy'49CLL((//4%nG%kD0Gk 3==---<<#:#::ai(!M<<''/()MNN--11-@>();d)BCC'4 $HH22499dll38:>*DLL,<HH%%dii&3&,&)$))+&6&*ll&>&>&.&*ll&+&*ll&;&;&*ll&8&8&*ll&8&8 : %)- %7C==s~~1113>>#6#66&H"//G#Hs~~111 3 33<<#6#66 ]]//FB,,Wdii-1\\5-1\\-@-@BB YY[F<<###--2C2C(C#'L //0708$ N>IIb#&<<%/DLi"rc[UR5nUS:a[e[R"SURSS5uUR lUR lp#pESUl[RRUR R5(aSUl URU5 UR(agURUR R U5 URUR R"U5 URUR R$U5 UR&(dURU:wa[(eUR R*(ahUR R,(aLUR R.(d0UR R,R1UR5 gggg)zFRead a wire format DNS message and build a dns.message.Message object. z!HHHHHHNT)lenrr rrrr1r2rr.r_rcrrrrr4r5r6rrrKrIrJupdate)rNlrancountaucountadcounts rread_WireReader.readsO  N r6 #]]9diinE $,,,f  ::   2 2 3 3 DM 6"     $,,--w7 $,,00': $,,117;## (9  <<  $,,"7"7LL)) LL ! ! ( ( 3*#8 r)rrrrrrrrN)FFF) rrrrrrOrrr rr rrrrIs% 5:9> /,.a0F4rrFc [SS9n XlX+lX;lXKlX[lXklX{l[X XU 5n U R5 U $)aConvert a DNS wire format message into a message object. *keyring*, a ``dict``, the keyring to use if the message is signed. *request_mac*, a ``binary``. If the message is a response to a TSIG-signed request, *request_mac* should be set to the MAC of that request. *xfr*, a ``bool``, should be set to ``True`` if this message is part of a zone transfer. *origin*, a ``dns.name.Name`` or ``None``. If the message is part of a zone transfer, *origin* should be the origin name of the zone. *tsig_ctx*, a ``hmac.HMAC`` objext, the ongoing TSIG context, used when validating zone transfers. *multi*, a ``bool``, should be set to ``True`` if this message part of a multiple message sequence. *first*, a ``bool``, should be set to ``True`` if this message is stand-alone, or the first message in a multi-message sequence. *question_only*, a ``bool``. If ``True``, read only up to the end of the question section. *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 message. Raises ``dns.message.ShortHeader`` if the message is less than 12 octets long. Raises ``dns.messaage.TrailingJunk`` if there were octets in the message past the end of the proper DNS message, and *ignore_trailing* is ``False``. Raises ``dns.message.BadEDNS`` if an OPT record was in the wrong section, or occurred more than once. Raises ``dns.message.BadTSIG`` if a TSIG record was not the last record of the additional data section. Returns a ``dns.message.Message``. r)r1) r)r<rArGrHrIrKrLrr ) rr<rArGrHrIrKrLrrrmreaders rrrsPj 1 AIM EHJGG -(*F KKM Hrc6\rSrSrSrSrSrSrSrSr Sr g ) _TextReaderi<aText format reader. tok: the tokenizer. message: The message object being built. updating: Is the message a dynamic update? zone_rdclass: The class of the zone in messages which are DNS dynamic updates. last_name: The most recently read name when building a message object. cX l[RRU5UlSUl[R RUlSUl g)NF) rr. tokenizer Tokenizertok last_namerrrr)rNtextrs rrO_TextReader.__init__Hs= ==**40NN-- rcURR5nURnUS:Xa+URR5URlGO`US:XaURR5nUR 5(dURRU5 OQURR[RRUR5-URlM[RRURR5(aSUl GO|US:XajURR5URlURRURRS--URlGO US:XaURRS:aSURlURR5nUR 5(dURRU5 GOURR[RR!UR5-URlMUS:XaUURR5URlURRS:aSURlOUS :Xa}URR%5nURR[RR'[RRU55-URlO_US :XaSURR%5nURR)[R*RU55 O[,eURR/5 g ) z5Process one line from the text format header section.r1r2Tr7reflagsrr9r_raN)rrrget_intrr1 is_identifierungetr2r.rr_rcrr7r8edns_from_textr9 get_stringrrrarget_eol)rNrtokenwhatrs r _header_line_TextReader._header_lineOs {{ 4<"hh..0DLLO W_ **,,HHNN5)%)\\%7%7II'' 4&5 " zz##DLL$6$677 $ V^ $ 0 0 2DLL %)\\%;%;""b(&*DLL " X ||  1$$% ! **,,HHNN5))-)?)?II,,U[[9*: & Y #'88#3#3#5DLL ||  1$$% ! X 88&&(D!%!3!3 ##CJJ$8$8$>?"@DLL  W_88&&(D LL " "399#6#6t#< =$ $ rc (URRSS9nUR5(d/[RR UR S5UlURnURR5nUR5(d[RRe[RR UR 5nURR5nUR5(d[RRe[RR UR 5nURR!URR"UXESSS9 UR$(aX@lURR)5 g![RRa [RRe[a [RRnNf=f)z7Process one line from the text format question section.T want_leadingNr)rr is_whitespacer.rrrrrr SyntaxErrorr Exceptionrrrrr3rrr)rNrrrrrs r_question_line_TextReader._question_line}sr $ /""$$ XX// TBDN~~ ""$$--++ + (nn..u{{;GHHLLNE&&((mm///)((5  5 5t '-1  3 == '  }}(( ,--++ + (nn''G (s4A2F33AHHc SnURRSS9nUR5(d/[RR UR S5UlURnURR5nUR5(d[RRe[UR S5nURR5nUR5(d[RRe[RR UR 5nURR5nUR5(d[RReU[RR:XdU[RR:XaUnUR n[R$R UR 5nURR5nUR'5(dWURR)U5 [R*R XgURS5nUR-5n OSn[R$Rn UR.R1XXgU USUR25n UbU R5X5 gg![RRa [RRe[a SnGNf=f![RRa [RRe[a [RR"nGNf=f)zVProcess one line from the text format answer, authority, or additional data sections. NTr$r)rrr&r.rrrrrrr'rr(rrrrrr is_eol_or_eofrrrrrrr) rNrrrrrrrrrrjs r_rr_line_TextReader._rr_lines  $ /""$$ XX// TBDN~~ ""$$--++ + ekk1%CHHLLNE&&((mm///) (nn..u{{;GHHLLNE&&((mm///#..,,,3>>;N;N0N"++ ((5 ""$$ HHNN5 !$$WdhhEBYY[FB]]''F ''(/(0$ G > IIb  =}}(( ,--++ + C }}(( ,--++ + (nn''G (s(6AKBrasi$& //=#--))=P3==**P33 $cmm%%$ $cmm%%$ 3S]]//3     s2fs2lk4&k4\FJ0449#B Jp!&p!f 0 <'*nn&7&7$ D$#TJ ZAE%r