h  SrSSKJr SSKrSSKrSSKrSSKrSSKJr SSK J r SSK J r J r JrJrJr SSKJrJrJr SSKJrJr SS KJr SS KJrJrJrJr SS K J!r!J"r"J#r# /S Qr$\RJr%S r&Sr'Sr(Sr)Sr*\+"SS5ur,r-r.r/r0r1r2r3r4r5r6r7r8r9r:r;rSr?Sr@SrASrBSrCSrDSrESrFSrG0\,S_\-S_\.S _\/S!_\0S"_\1S#_\2S$_\3S%_\4S&_\5S'_\6S(_\7S)_\8S*_\9S+_\:S,_\;S-_\S0\?S1\@S2\AS3\BS4\CS5\DS6\ES7\FS8\GS90 ErH\+"S:S;5urIrJrKrLrM\IS<\JS=\KS>\LS?\MS@0rN\ "\HR5\NR55VVs0sHupX_M snnrP\+"SSA5urQrRrSrTSBrU\QSC\RSD\SSE\TSF\USG0rV\VR5VVs0sHupX_M snnrW\+"SH5urXrYrZSIr[SAr\\+"SJ5ur]r^r_r`rarbSKrc\+"SKS5urdrerf"SLSM\5rgSSNKhJiriJjrjJkrk SOrlSSPjrmSQrnSSRjro\SSSj5rp\SSTj5rpSSUjrpSVrq"SWSX\5rr"SYSZ\r\g5rs\"\r5"S[S\55rt\"\r5"S]S^55ru\"\"\r5"S_S`555rv\"\r5"SaSb\R\R55ry\"\r5"ScSd\R\R55rz\"\r5"SeSf\R55r{\"\s5"SgSh\R\R55r|"SiSj\|5r}"SkSl\|5r~"SmSn\|5r"SoSp\|5r"SqSr\|5r"SsSt\|5r"SuSv\|5r"SwSx\|5r"SySz\|5r\"\s5"S{S|\R55r\"\s5"S}S~\R\R55r\"\s5"SS\R\R55r\"\s5"SS\R\R55r\"\s5"SS\R\R55r\"\s5"SS\R\R55r\"\s5"SS\R\R55r\"\s5"SS\R\R55r\"\s5"SS\R\R55r\"\s5"SS\R\R55r\"\s5"SS\R\R55r\"\s5"SS\R\R55r\"\s5"SS\R\R55r\"\s5"SS\R\R55r\"\s5"SS\R\R55r\"\s5"SS\R\R55r"SS\5r\"\s5"SS\R\R55rSrSrSSSjjr"SS\R5r"SS\R5r"SS5r"SS\\GR<5r"SS\\GR@5rgs snnfs snnf)zU DNS protocol implementation. Future Plans: - Get rid of some toplevels, maybe. ) annotationsN)BytesIO)chain)OptionalSequence SupportsIntUnionoverload) Attribute Interface implementer)deferprotocol)CannotListenError)failurelog randbytesutil)cmp comparable nativeString)d IEncodableIRecordIEncodableRecordAA6AAAAAFSDBCNAMEDNAMEHINFOMAILAMAILBMBMDMFMGMINFOMRMXNAPTRNSNULLOPTPTRRPSOASPFSRVTXTSSHFPTSIGWKSANYCHCSHSIN ALL_RECORDSAXFRIXFREFORMATENAMEENOTIMPEREFUSEDESERVER EBADVERSIONEBADSIGEBADKEYEBADTIMERecord_A Record_A6 Record_AAAA Record_AFSDB Record_CNAME Record_DNAME Record_HINFO Record_MB Record_MD Record_MF Record_MG Record_MINFO Record_MR Record_MX Record_NAPTR Record_NS Record_NULL Record_PTR Record_RP Record_SOA Record_SPF Record_SRV Record_SSHFP Record_TSIG Record_TXT Record_WKS UnknownRecord QUERY_CLASSES QUERY_TYPES REV_CLASSES REV_TYPES EXT_QUERIESCharstrMessageNameQueryRRHeader SimpleRecordDNSDatagramProtocolDNSMixin DNSProtocolOK OP_INVERSE OP_NOTIFYOP_QUERY OP_STATUS OP_UPDATEPORTAuthoritativeDomainErrorDNSQueryTimeoutError DomainErrorc[U/5$)z{ Construct a bytes object representing a single byte with the given ordinal value. @type ordinal: L{int} @rtype: L{bytes} bytes)ordinals X/root/1688_scrapy/alibaba-scraper/venv/lib/python3.13/site-packages/twisted/names/dns.py _ord2bytesrs ' c[U5SS$)z Represent a mostly textful bytes object in a way suitable for presentation to an end user. @param bytes: The bytes to represent. @rtype: L{str} N)reprr}s r _nicebytesrs ;qr?rc SRSRUVs/sHn[U5PM sn55$s snf)z Represent a list of mostly textful bytes objects in a way suitable for presentation to an end user. @param list: The list of bytes to represent. @rtype: L{str} z[{}], )formatjoinr)listbs r_nicebyteslistrs2 ==4#@4aJqM4#@A BB#@s; c\[R"S[R"SSS95S$)zs Wrapper around L{twisted.python.randbytes.RandomFactory.secureRandom} to return 2 random bytes. @rtype: L{bytes} HT)fallbackr)structunpackr secureRandomrr randomSourcers' ==i44QF G JJr5r!#&'),crr,r%r&rr1r$r'r)r-r7r/r!r(r*r4r0rrr3r+rr r.r5r2TKEYr6r?r>r#r"r=r<r:r9r;r8c(\rSrSrSr\"S5rSrg)riz( A single entry in a zone of authority. z,An indicator of what kind of record this is.rN)__name__ __module__ __qualname____firstlineno____doc__r TYPE__static_attributes__rrrrrs C DDrr)ryrzr{cnUS;aS/$URS5nUSS:waURS5 U$)a Split a domain name into its constituent labels. @type name: L{bytes} @param name: A fully qualified domain name (with or without a trailing dot). @return: A L{list} of labels ending with an empty label representing the DNS root zone. @rtype: L{list} of L{bytes} )r.rr)splitappend)namelabelss r _nameToLabelsr+s> {u ZZ F bzS c Mrc [U[5(aURS5n[U[5(dB[ SR [R [R U[U555eU$)a Coerce a domain name string to bytes. L{twisted.names} represents domain names as L{bytes}, but many interfaces accept L{bytes} or a text string (L{unicode} on Python 2, L{str} on Python 3). This function coerces text strings using IDNA encoding --- see L{encodings.idna}. Note that DNS is I{case insensitive} but I{case preserving}. This function doesn't normalize case, so you'll still need to do that whenever comparing the strings it returns. @param domain: A domain name. If passed as a text string it will be C{idna} encoded. @type domain: L{bytes} or L{str} @returns: L{bytes} suitable for network transmission. @rtype: L{bytes} @since: Twisted 20.3.0 idnaz+Expected {} or {} but found {!r} of type {}) isinstancestrencoder~ TypeErrorrrtype)domains r domainStringr?sc,&#v& fe $ $ 9 @ @ fd6l   Mrc[UR55n[UR55nU[U5*SU:H$)a Test whether C{descendantName} is equal to or is a I{subdomain} of C{ancestorName}. The names are compared case-insensitively. The names are treated as byte strings containing one or more DNS labels separated by B{.}. C{descendantName} is considered equal if its sequence of labels exactly matches the labels of C{ancestorName}. C{descendantName} is considered a I{subdomain} if its sequence of labels ends with the labels of C{ancestorName}. @type descendantName: L{bytes} @param descendantName: The DNS subdomain name. @type ancestorName: L{bytes} @param ancestorName: The DNS parent or ancestor domain name. @return: C{True} if C{descendantName} is equal to or if it is a subdomain of C{ancestorName}. Otherwise returns C{False}. N)rlowerlen)descendantName ancestorNamedescendantLabelsancestorLabelss r_isSubdomainOfr`sF2%^%9%9%;<"<#5#5#78N S002 3~ EErc SnUR5R5nUH7up#URU5(dM[[ USS5U-5s $ [U5$![ a [ SU-5ef=f)ze mypy doesn't like type-punning str | bytes | int | None into a str so we have this helper function. ))Sr)M<)ri)DiQ)Wi: )Yi3Nrz!Invalid time interval specifier: )upperstripendswithintfloat ValueError)ssuffixessuffmults r _str2timer~sH  A  ::d  uQsV}t+, ,B1v B?@ @ rNcURn[U5nUR[U55 URU5 g)z Encode this Character string into the appropriate byte format. @type strio: file @param strio: The byte representation of this Charstr will be written to this file. N)rrwriter)rrrrinds rrCharstr.encodes2&k JsO$ Frc\SUl[[US55n[X5Ulg)z Decode a byte string into this Charstr. @type strio: file @param strio: Bytes will be read from this file until the full string is decoded. @raise EOFError: Raised when there are not enough bytes available from C{strio}. rrN)rordr)rrrrs rrCharstr.decodes(  eQ' (#E- rcj[U[5(aURUR:H$[$r)rrirNotImplementedrothers r__eq__Charstr.__eq__s( eW % %;;%,,. .rc,[UR5$r)hashrrs r__hash__Charstr.__hash__sDKK  rc,[UR5$)z9 Represent this L{Charstr} instance by its string value. )rrrs r__str__Charstr.__str__sDKK((r)rr)rr~rr objectreturnboolrr) rrrrrrrr rrrrrrriris   . !)rricT\rSrSrSrS S SjjrS SjrS SjrSSjrSr SS jr S r g)rki z A name in the domain name system, made up of multiple labels. For example, I{twistedmatrix.com}. @ivar name: A byte string giving the name. @type name: L{bytes} c$[U5Ulg)z5 @param name: A name. @type name: L{bytes} or L{str} N)rr)rrs rr Name.__init__*s !& rNcURnU(aUbTX2;a,UR[R"SSX#-55 gUR 5[ R -X#'URS5nUS:a USUX4S-Sp5OUnSn[U5nUR[U55 URU5 U(aMURS5 g)aY Encode this Name into the appropriate byte format. @type strio: file @param strio: The byte representation of this Name will be written to this file. @type compDict: dict @param compDict: dictionary of Names that have already been encoded and whose addresses may be backreferenced by this Name (for the purpose of reducing the message size). N!Hirrr) rrrpacktellrj headerSizefindrr)rrrrrlabels rr Name.encode1syy##KK D&8>2I JK%*ZZ\G4F4F%FHN))D/CQw"4Cj$Qwy/t%j KK 3 ( KK !d"  Grc[5nSUlSn[[US55nUS:XaUS:aUR U5 gUS- S:XahUS-S-[[US55-nXc;a [ S 5eUR U5 US:XaUR5nUR U5 M[X5nURS:XaXplOURS -U-UlM) aE Decode a byte string into this Name. @type strio: file @param strio: Bytes will be read from this file until the full Name is decoded. @raise EOFError: Raised when there are not enough bytes available from C{strio}. @raise ValueError: Raised when the name cannot be decoded (for example, because it contains a loop). rrrNrr?z Compression loop in encoded namer)setrrrseekraddr!)rrrvisitedoffrnew_offr$s rr Name.decodeRs% M%+,AAv7JJsOQ1}r6a-#mE1.E*FF%$%GHH G$!8**,C 7#!%+EyyC!  II,u4 'rc[U[5(a5URR5URR5:H$[$r)rrkrrrrs rr  Name.__eq__xs8 eT " "99??$ (8(8(:: :rc,[UR5$rr rrs rr Name.__hash__}DIIrc,[UR5$)z5 Represent this L{Name} instance by its string name. rrrs rr Name.__str__sDII&&r)rr)r bytes | strrrr) rrrrrrrrr rrrrrrrkrk s''B$5L 'rrkc`\rSrSrSrS\\4S SjjrSSjrSSjr Sr S r SS jr SS jr S rg)rliz Represent a single DNS query. @ivar name: The name about which this query is requesting information. @type name: L{Name} @ivar type: The query type. @type type: L{int} @ivar cls: The query class. @type cls: L{int} rc<[U5UlX lX0lg)z @type name: L{bytes} or L{str} @param name: See L{Query.name} @type type: L{int} @param type: The query type. @type cls: L{int} @param cls: The query class. N)rkrrclsrrrr<s rrQuery.__init__sJ  rNcURRX5 UR[R"SUR UR 55 gN!HH)rrrrr rr<rrrs rr Query.encodes5 ) FKKtyy$((;)regetrrhrdr<rrtcs rr Query.__str__sq OO II{tyy.4992LM    dhh(A B 1QCq1--rcpSURR<SUR<SUR<S3$)NzQuery(r))rrr<rs r__repr__Query.__repr__s. )DII=488,aHHr)r<rr)rUnion[bytes, str]rrr<rrr)rrrrrrr<rrrrrIrrVrrrrrlrls6 25!PR =9 C.Irrlc\rSrSrSrSS4SSSSS S 4rS rSS jr\S5r \S5r SSjr SSjr \ S5rSrg ) _OPTHeaderia& An OPT record header. @ivar name: The DNS name associated with this record. Since this is a pseudo record, the name is always an L{Name} instance with value b'', which represents the DNS root zone. This attribute is a readonly property. @ivar type: The DNS record type. This is a fixed value of 41 C{dns.OPT} for OPT Record. This attribute is a readonly property. @see: L{_OPTHeader.__init__} for documentation of other public instance attributes. @see: U{https://tools.ietf.org/html/rfc6891#section-6.1.2} @since: 13.2 rc,[UR5$rr7)ns r_OPTHeader.s </rrudpPayloadSize extendedRCODEversiondnssecOKoptions)rrr_r`rarbrcNcJXlX lX0lX@lUc/nXPlg)a @type udpPayloadSize: L{int} @param udpPayloadSize: The number of octets of the largest UDP payload that can be reassembled and delivered in the requestor's network stack. @type extendedRCODE: L{int} @param extendedRCODE: Forms the upper 8 bits of extended 12-bit RCODE (together with the 4 bits defined in [RFC1035]. Note that EXTENDED-RCODE value 0 indicates that an unextended RCODE is in use (values 0 through 15). @type version: L{int} @param version: Indicates the implementation level of the setter. Full conformance with this specification is indicated by version C{0}. @type dnssecOK: L{bool} @param dnssecOK: DNSSEC OK bit as defined by [RFC3225]. @type options: L{list} @param options: A L{list} of 0 or more L{_OPTVariableOption} instances. Nr_r`rarbrc)rr_r`rarbrcs rr_OPTHeader.__init__s*@-*  ?G rc[S5$)z A readonly property for accessing the C{name} attribute of this record. @return: The DNS name associated with this record. Since this is a pseudo record, the name is always an L{Name} instance with value b'', which represents the DNS root zone. r)rkrs rr_OPTHeader.namesCyrc[$)z A readonly property for accessing the C{type} attribute of this record. @return: The DNS record type. This is a fixed value of 41 (C{dns.OPT} for OPT Record. )r.rs rr_OPTHeader.type$s  rc t[5nURHnURU5 M UR5n[ UR R UR URURS-URS--URS--[U5S9RX5 g)aa Encode this L{_OPTHeader} instance to bytes. @type strio: file @param strio: the byte representation of this L{_OPTHeader} will be written to this file. @type compDict: L{dict} or L{None} @param compDict: A dictionary of backreference addresses that have already been written to this stream and that may be used for DNS name compression. r)rrr<ttlpayloadN) rrcrgetvaluermrrr_r`rarbrc)rrrro optionBytess rr_OPTHeader.encode/s IA HHQKjjl ####r)DLLB,>>RTATT!+.  & !rc [5nURX5 [[XR55UlUR U5nURH nUS;dM [X[XE55 M" g)z Decode bytes into an L{_OPTHeader} instance. @type strio: file @param strio: Bytes will be read from this file until the full L{_OPTHeader} is decoded. @type length: L{int} or L{None} @param length: Not used. )rrN) rmrrcrrdlengthro fromRRHeadercompareAttributessetattrgetattr)rrrh newOptHeaderattrNames rr_OPTHeader.decodeIsd J !-zz"BC ((+ ..H// (GH/rcSnURb/n[URR5n[URR5nUR 5U:aB[ 5nUR U5 URU5 UR 5U:aMBU"URURS- URS- S-URS-S- US9$)a) A classmethod for constructing a new L{_OPTHeader} from the attributes and payload of an existing L{RRHeader} instance. @type rrHeader: L{RRHeader} @param rrHeader: An L{RRHeader} instance containing an L{UnknownRecord} payload. @return: An instance of L{_OPTHeader}. @rtype: L{_OPTHeader} Nrlrrirmre) rordatarr!_OPTVariableOptionrrr<rn)r<rrHeaderrc optionsBytesoptionsBytesLengthrqs rrv_OPTHeader.fromRRHeader_s    'G"8#3#3#8#89L!$X%5%5%:%:!; ##%(::&(&q!##%(:: #<<",,",LLB&-llV+2   r)rbr`rcr_ra)irrFNr)rrrrrshowAttributesrwrpropertyrrrr classmethodrvrrrrrZrZs* /0N 'R  "4I,  rrZcJ\rSrSrSrSS\44rSrSrS Sjr S S jr S S jr Sr g) riz A class to represent OPT record variable options. @see: L{_OPTVariableOption.__init__} for documentation of public instance attributes. @see: U{https://tools.ietf.org/html/rfc6891#section-6.1.2} @since: 13.2 coderrrrAcXlX lg)zd @type code: L{int} @param code: The option code @type data: L{bytes} @param data: The option data Nr)rrrs rr_OPTVariableOption.__init__s  rNc UR[R"URUR[ UR 55UR -5 g)ah Encode this L{_OPTVariableOption} to bytes. @type strio: file @param strio: the byte representation of this L{_OPTVariableOption} will be written to this file. @type compDict: L{dict} or L{None} @param compDict: A dictionary of backreference addresses that have already been written to this stream and that may be used for DNS name compression. N)rrr _fmtrrrrBs rr_OPTVariableOption.encodes6  FKK 499c$))nE QRrc[R"UR5n[X5n[R"URU5uUln[X5Ulg)z Decode bytes into an L{_OPTVariableOption} instance. @type strio: file @param strio: Bytes will be read from this file until the full L{_OPTVariableOption} is decoded. @type length: L{int} or L{None} @param length: Not used. N)rcalcsizerrrrr)rrrrrs rr_OPTVariableOption.decodesG OODII &U&"MM$))T: 6!%0 r)rrr) rrrrrrrrwrrrrrrrrrrs3 v|45N( D  S1rrc\rSrSrSrSrSrSrSrS\ \ SSS4SS jjr SS jr SS jr S rSS jr\rSrg)rmia3 A resource record header. @cvar fmt: L{str} specifying the byte format of an RR. @ivar name: The name about which this reply contains information. @type name: L{Name} @ivar type: The query type of the original request. @type type: L{int} @ivar cls: The query class of the original request. @ivar ttl: The time-to-live for this record. @type ttl: L{int} @ivar payload: The record described by this header. @type payload: L{IEncodableRecord} or L{None} @ivar auth: A L{bool} indicating whether this C{RRHeader} was parsed from an authoritative message. )rrr<rnroauthz!HHIHNrrFc >UcSO URnUb?Xr:wa:[S[RXw5<S[RX"5<S35e[ U5nUS:a [S5e[ U5UlX lX0lXl XPl X`l g)aE @type name: L{bytes} or L{str} @param name: See L{RRHeader.name} @type type: L{int} @param type: The query type. @type cls: L{int} @param cls: The query class. @type ttl: L{int} @param ttl: Time to live for this record. This will be converted to an L{int}. @type payload: L{IEncodableRecord} or L{None} @param payload: An optional Query Type specific data object. @raises TypeError: if the ttl cannot be converted to an L{int}. @raises ValueError: if the ttl is negative. @raises ValueError: if the payload type is not equal to the C{type} argument. NzPayload type (z) does not match given type (rUrzTTL cannot be negative) rrrerOrrkrrr<rnror) rrrr<rnror payloadType integralTTLs rrRRHeader.__init__s>&od7<<  "{': OOK=OOD/ #h ?56 6J    rc URRX5 UR[R"UR UR URURS55 UR(aUR5nURRX5 UR5nURUS- S5 UR[R"SXC- 55 URUS5 gg)Nrrr) rrrrr fmtrr<rnror!r*)rrrprefixafts rrRRHeader.encodes ) FKK$))TXXtxxKL <<ZZ\F LL   0**,C JJvz1 % KK D#,7 8 JJsA  rcURRU5 [R"UR5n[ X5n[R "URU5nUuUlUlUl Ul gr) rrrrrrrrr<rnru)rrrrrrs rrRRHeader.decodesZ  OODHH %U& MM$((D )784 48TXt}rcUR$rrrs risAuthoritativeRRHeader.isAuthoritative%s yyrcf[RUR[RURSUR-55n[RUR SUR -5nSUR UUURUR=(a S=(d S4-$)NrLz-TrueFalse) rerOrrhrdr<rrnrrPs rrRRHeader.__str__(s OO II{tyy.4992LM    dhh(A B> II HH II & +G B   r)rr<rrorurnr) rrXrrr<rrnrrozOptional[IEncodableRecord]rrrr)rrrrrrwrrucachedResponserr<rrrrrrVrrrrrmrms.J CHN#&.2333 3  3 , 33j 9  HrrmcX\rSrSr%SrSrSrSrS\S'Sr S Sjr S S jr S S jr S r Srg)rni8z A Resource Record which consists of a single RFC 1035 domain-name. @type name: L{Name} @ivar name: The name associated with this record. @type ttl: L{int} @ivar ttl: The maximum number of seconds which this record should be cached. )rr%srn)rrnNz Optional[int]rcD[U5Ul[U5Ulg)zF @param name: See L{SimpleRecord.name} @type name: L{bytes} or L{str} N)rkrrrn)rrrns rrSimpleRecord.__init__Ks J C=rc:URRX5 gr)rrrBs rrSimpleRecord.encodeSs )rcX[5UlURRU5 gr)rkrrrrrs rrSimpleRecord.decodeVsF  rc,[UR5$rr3rs rrSimpleRecord.__hash__Zr5rrNr)rrrrrrrwr__annotations__rrrrrrrrrrnrn8s7 5N'D- D!* rrnc \rSrSrSr\rSrSrg)rXi_z An authoritative nameserver. r,rN) rrrrrr,r fancybasenamerrrrrXrX_s DMrrXc \rSrSrSr\rSrSrg)rQihzH A mail destination. This record type is obsolete. @see: L{Record_MX} r%rN) rrrrrr%rrrrrrrQrQh DMrrQc \rSrSrSr\rSrSrg)rRiuzF A mail forwarder. This record type is obsolete. @see: L{Record_MX} r&rN) rrrrrr&rrrrrrrRrRurrrRc \rSrSrSr\rSrSrg)rMiz" The canonical name for an alias. rrN) rrrrrrrrrrrrrMrMs DMrrMc \rSrSrSr\rSrSrg)rPiz> A mailbox domain name. This is an experimental record type. r$rN) rrrrrr$rrrrrrrPrP DMrrPc \rSrSrSr\rSrSrg)rSiz< A mail group member. This is an experimental record type. r'rN) rrrrrr'rrrrrrrSrSrrrSc \rSrSrSr\rSrSrg)rUizB A mail rename domain name. This is an experimental record type. r)rN) rrrrrr)rrrrrrrUrUrrrUc \rSrSrSr\rSrSrg)rZiz A domain name pointer. r/rN) rrrrrr/rrrrrrrZrZs DMrrZc \rSrSrSr\rSrSrg)rNia? A non-terminal DNS name redirection. This record type provides the capability to map an entire subtree of the DNS name space to another domain. It differs from the CNAME record which maps a single node of the name space. @see: U{http://www.faqs.org/rfcs/rfc2672.html} @see: U{http://www.faqs.org/rfcs/rfc3363.html} r rN) rrrrrr rrrrrrrNrNs  DMrrNc\\rSrSrSrSr\rSrS Sjr S Sjr S Sjr Sr S S jr \ rS rSrg)rIia An IPv4 host address. @type address: L{bytes} @ivar address: The packed network-order representation of the IPv4 address associated with this record. @type ttl: L{int} @ivar ttl: The maximum number of seconds which this record should be cached. addressrnNc[U[5(aURS5n[R"U5nXl[ U5Ulg)~ @type address: L{bytes} or L{str} @param address: The IPv4 address associated with this record, in quad-dotted notation. rN)rr~rsocket inet_atonrrrnrrrns rrRecord_A.__init__s? gu % %nnW-G""7+ C=rc:URUR5 grrrrBs rrRecord_A.encode DLL!rc&[US5Ulg)Nrrrrs rrRecord_A.decodes$UA. rc,[UR5$rr rrs rrRecord_A.__hash__DLL!!rcDSUR5SURS3$)Nz $UA.  dM%,CDQG   3rcZ[URURUR45$r)r rrrrs rrRecord_WKS.__hash__s T\\4==$((;< gu % %nnV,G''': C=rc:URUR5 grrrBs rrRecord_AAAA.encoderrc&[US5Ulg)Nrrrs rrRecord_AAAA.decodes$UB/ rc,[UR5$rrrs rrRecord_AAAA.__hash__rr)::Nr)rrrrrrrrrrwrrrrrrrrrrrKrKsD  DM;N* 88 !"0"rrKc\rSrSrSr\rSrSrSr \ S5r SSSjjr SS jr SS jrSS jrS rSS jrSrg)rJial An IPv6 address. This is an experimental record type. @type prefixLen: L{int} @ivar prefixLen: The length of the suffix. @type suffix: L{bytes} @ivar suffix: An IPv6 address suffix in network order. @type prefix: L{Name} @ivar prefix: If specified, a name which will be used as a prefix for other A6 records. @type bytes: L{int} @ivar bytes: The length of the prefix. @type ttl: L{int} @ivar ttl: The maximum number of seconds which this record should be cached. @see: U{http://www.faqs.org/rfcs/rfc2874.html} @see: U{http://www.faqs.org/rfcs/rfc3363.html} @see: U{http://www.faqs.org/rfcs/rfc3364.html} r))_suffixsuffixr)rrrrn) prefixLenrrrncL[R"[UR5$r)rrrrrs rrRecord_A6._suffixs$++66rNc[U[5(aURS5nXl[R "[ U5Ul[U5Ul [SUR- S- 5Ul[U5Ul g)z @param suffix: An IPv6 address suffix in in RFC 2373 format. @type suffix: L{bytes} or L{str} @param prefix: An IPv6 address prefix for other A6 records. @type prefix: L{bytes} or L{str} r @N) rr~rrrrrrrkrrrrn)rrrrrns rrRecord_A6.__init__sh fe $ $]]6*F"&&x8 6l #.#56 C=rc4UR[R"SUR55 UR(a)URUR UR*S5 UR(aUR RUS5 ggr)rrr rr~rrrrBs rrRecord_A6.encode5sa FKKdnn56 :: KK TZZKM2 3 >> KK  ud + rcl[R"S[US55SUl[ SUR- S- 5UlUR (a-SSUR - -[XR 5-UlUR(aURRU5 gg)Nrrrr"r#rr) rrrrrr~rrrrs rrRecord_A6.decode=st]5!-DEaH#.#56 ::!R$**_5 eZZ8XXDK >> KK  u % rcb[U[5(aURUR:H=(au URUR*SURUR*S:H=(a9 UR UR :H=(a UR UR :H$[$r)rrJrrr~rrnrrs rr Record_A6.__eq__Es eY ' '%//1*KK .%,, {}2MM*KK5<</*HH )   rcv[URURUR*SUR45$r)r rrr~rrs rrRecord_A6.__hash__Os-T^^T[[$**%?MNNrcSUR[R"[UR5UR UR 4-$)Nz)rrrrrrrnrs rrRecord_A6.__str__Rs=' KK   Xt{{ 3 NN HH +   r)r~rrrrn)rrrN)rrrr9rr9rnUnion[str, bytes, int, None]rrr)rrrrrrrrrrwrrrrrr rrrrrrrJrJs6 DMUN@ 77 "!,0 !!! ! * !.,&O rrJcL\rSrSrSr\rSrSrSr S Sjr S Sjr S S jr S r S rg)r^i[a The location of the server(s) for a specific protocol and domain. This is an experimental record type. @type priority: L{int} @ivar priority: The priority of this target host. A client MUST attempt to contact the target host with the lowest-numbered priority it can reach; target hosts with the same priority SHOULD be tried in an order defined by the weight field. @type weight: L{int} @ivar weight: Specifies a relative weight for entries with the same priority. Larger weights SHOULD be given a proportionately higher probability of being selected. @type port: L{int} @ivar port: The port on this target host of this service. @type target: L{Name} @ivar target: The domain name of the target host. There MUST be one or more address records for this name, the name MUST NOT be an alias (in the sense of RFC 1034 or RFC 2181). Implementors are urged, but not required, to return the address record(s) in the Additional Data section. Unless and until permitted by future standards action, name compression is not to be used for this field. @type ttl: L{int} @ivar ttl: The maximum number of seconds which this record should be cached. @see: U{http://www.faqs.org/rfcs/rfc2782.html} r3)priorityweighttargetportrn)r1r2)r3r3rr4rnNc[U5Ul[U5Ul[U5Ul[ U5Ul[ U5Ulg)zJ @param target: See L{Record_SRV.target} @type target: L{bytes} or L{str} N)rr1r2r4rkr3rrn)rr1r2r4r3rns rrRecord_SRV.__init__s; H  &k I 6l C=rcUR[R"SURURUR 55 UR RUS5 gN!HHH)rrr r1r2r4r3rrBs rrRecord_SRV.encodes= FKK t{{DIINO 5$'rc [R"S[U[R"S555nUuUlUlUl[5UlURRU5 gr8) rrrrr1r2r4rkr3rrs rrRecord_SRV.decodesO MM&-vv7N"O P01- t{DIf  5!rcp[URURURUR45$r)r r1r2r4r3rs rrRecord_SRV.__hash__s&T]]DKKDKKHIIr)r4r1r3rnr2)rrrrNr)rrrrrr3rrrwrrrrrrrrrr^r^[s4 D DMGVN !( " Jrr^cZ\rSrSrSr\rSrSrSr S Sjr S Sjr S S jr S r S rg)rWia The location of the server(s) for a specific protocol and domain. @type order: L{int} @ivar order: An integer specifying the order in which the NAPTR records MUST be processed to ensure the correct ordering of rules. Low numbers are processed before high numbers. @type preference: L{int} @ivar preference: An integer that specifies the order in which NAPTR records with equal "order" values SHOULD be processed, low numbers being processed before high numbers. @type flag: L{Charstr} @ivar flag: A containing flags to control aspects of the rewriting and interpretation of the fields in the record. Flags are single characters from the set [A-Z0-9]. The case of the alphabetic characters is not significant. At this time only four flags, "S", "A", "U", and "P", are defined. @type service: L{Charstr} @ivar service: Specifies the service(s) available down this rewrite path. It may also specify the particular protocol that is used to talk with a service. A protocol MUST be specified if the flags field states that the NAPTR is terminal. @type regexp: L{Charstr} @ivar regexp: A STRING containing a substitution expression that is applied to the original string held by the client in order to construct the next domain name to lookup. @type replacement: L{Name} @ivar replacement: The next NAME to query for NAPTR, SRV, or address records depending on the value of the flags field. This MUST be a fully qualified domain-name. @type ttl: L{int} @ivar ttl: The maximum number of seconds which this record should be cached. @see: U{http://www.faqs.org/rfcs/rfc2915.html} )order preferenceflagsserviceregexp replacementr+)r@rA)rBrBr)rCrCr)rDrDr)rErErrnNc[U5Ul[U5Ul[U5Ul[U5Ul[U5Ul[U5Ul[U5Ul g)z[ @param replacement: See L{Record_NAPTR.replacement} @type replacement: L{bytes} or L{str} N) rr@rArirBrCrDrkrErrn)rr@rArBrCrDrErns rrRecord_NAPTR.__init__sTZ j/U^ w' fo  ,C=rcZUR[R"SURUR55 UR R US5 URR US5 URR US5 URR US5 gr@) rrr r@rArBrrCrDrErBs rrRecord_NAPTR.encodesu FKKtzz4??CD %& E4( 5$' t,rc [R"S[U[R"S555nUuUlUl[ 5Ul[ 5Ul[ 5Ul [5Ul URRU5 URRU5 URRU5 URRU5 gr@) rrrrr@rArirBrCrDrkrErrs rrRecord_NAPTR.decodes MM%ufooe6L!M N&'# DOY y i 6 %  E" 5! &rc[URURURURUR UR 45$r)r r@rArBrCrDrErs rrRecord_NAPTR.__hash__ s@         r)rBr@rArDrErCrn)rrrrrrNr)rrrrrr+rrwrrrrrrrrrrrWrWsP*X DMN !,- '  rrWcL\rSrSrSr\rSrSrSr S Sjr S Sjr S S jr S r S rg)rLiau Map from a domain name to the name of an AFS cell database server. @type subtype: L{int} @ivar subtype: In the case of subtype 1, the host has an AFS version 3.0 Volume Location Server for the named AFS cell. In the case of subtype 2, the host has an authenticated name server holding the cell-root directory node for the named DCE/NCA cell. @type hostname: L{Name} @ivar hostname: The domain name of a host that has a server for the cell named by this record. @type ttl: L{int} @ivar ttl: The maximum number of seconds which this record should be cached. @see: U{http://www.faqs.org/rfcs/rfc1183.html} r)subtypehostnamern)rO)rPrPrrnNcd[U5Ul[U5Ul[ U5Ulg)zR @param hostname: See L{Record_AFSDB.hostname} @type hostname: L{bytes} or L{str} N)rrOrkrPrrn)rrOrPrns rrRecord_AFSDB.__init__6s% 7| X C=rcUR[R"SUR55 URR X5 gNr)rrr rOrPrrBs rrRecord_AFSDB.encode?s/ FKKdll34 U-rc [R"S[U[R"S555nUuUlUR R U5 grT)rrrrrOrPrrs rrRecord_AFSDB.decodeCs= MM$ eV__T5J K L U#rcD[URUR45$r)r rOrPrs rrRecord_AFSDB.__hash__HsT\\4==122r)rPrOrnrrNr)rrrrrrrrrwrrrrrrrrrrLrLs2( DM6GN!.$ 3rrLcL\rSrSrSr\rSrSrSr S Sjr S Sjr S S jr S r S rg)r[iLa The responsible person for a domain. @type mbox: L{Name} @ivar mbox: A domain name that specifies the mailbox for the responsible person. @type txt: L{Name} @ivar txt: A domain name for which TXT RR's exist (indirection through which allows information sharing about the contents of this RP record). @type ttl: L{int} @ivar ttl: The maximum number of seconds which this record should be cached. @see: U{http://www.faqs.org/rfcs/rfc1183.html} r0)mboxtxtrn))r\r\r)r]r]rrnNcd[U5Ul[U5Ul[U5Ulg)z @param mbox: See L{Record_RP.mbox}. @type mbox: L{bytes} or L{str} @param txt: See L{Record_RP.txt} @type txt: L{bytes} or L{str} N)rkr\r]rrn)rr\r]rns rrRecord_RP.__init__fs%J 9C=rcpURRX5 URRX5 gr)r\rr]rBs rrRecord_RP.encoders$ ) (rc[5Ul[5UlURRU5 URRU5 gr)rkr\r]rrs rrRecord_RP.decodevs6F 6  rcD[URUR45$r)r r\r]rs rrRecord_RP.__hash__|TYY)**r)r\rnr]rrNr)rrrrrr0rrrwrrrrrrrrrr[r[Ls2$ DM.JN !) +rr[cx\rSrSrSr\rSrS\4S\4S4r Sr SSS jjr SS jr SS jr SS jrS rSrg)rOiz Host information. @type cpu: L{bytes} @ivar cpu: Specifies the CPU type. @type os: L{bytes} @ivar os: Specifies the OS. @type ttl: L{int} @ivar ttl: The maximum number of seconds which this record should be cached. r!cpuosrn)rirjrnNc@XsUlUl[U5Ulgr)rirjrrn)rrirjrns rrRecord_HINFO.__init__s  $'C=rcUR[R"S[UR55UR-5 UR[R"S[UR 55UR -5 gr)rrr rrirjrBs rrRecord_HINFO.encodesR FKKc$((m4txx?@ FKKc$''l3dgg=>rc[R"S[US55Sn[X5Ul[R"S[US55Sn[X5Ulg)Nrrr)rrrrirj)rrrrirjs rrRecord_HINFO.decodesRmmD-q"9:1= , ]]4ua!8 9! <*rcZ[U[5(aURR5URR5:H=(aU URR5URR5:H=(a UR UR :H$[ $r)rrOrjrrirnrrs rr Record_HINFO.__eq__sq e\ * * 588>>#33*HHNN$ (99*HH )  rc|[URR5URR545$r)r rjrrirs rrRecord_HINFO.__hash__s'TWW]]_dhhnn&6788rrg)rir~rjr~rnr/rr)rrrrrr!rrrrrwrrrr rrrrrrOrOso  DMj)D*+=uEN,,0 ! ! !* !?+ 9rrOcT\rSrSrSr\rSrSrSr Sr Sr S Sjr S Sjr S S jrS rS rg)rTia Mailbox or mail list information. This is an experimental record type. @type rmailbx: L{Name} @ivar rmailbx: A domain-name which specifies a mailbox which is responsible for the mailing list or mailbox. If this domain name names the root, the owner of the MINFO RR is responsible for itself. @type emailbx: L{Name} @ivar emailbx: A domain-name which specifies a mailbox which is to receive error messages related to the mailing list or mailbox specified by the owner of the MINFO record. If this domain name names the root, errors should be returned to the sender of the message. @type ttl: L{int} @ivar ttl: The maximum number of seconds which this record should be cached. Nr()rmailbxemailbxrn))rvresponsibilityr)rwerrorsrrncf[U5[U5sUlUl[U5Ulg)z @param rmailbx: See L{Record_MINFO.rmailbx}. @type rmailbx: L{bytes} or L{str} @param emailbx: See L{Record_MINFO.rmailbx}. @type emailbx: L{bytes} or L{str} N)rkrvrwrrn)rrvrwrns rrRecord_MINFO.__init__s'&*']DM" dlC=rcpURRX5 URRX5 gr)rvrrwrBs rrRecord_MINFO.encodes& E, E,rc[5[5sUlUlURRU5 URRU5 gr)rkrvrwrrs rrRecord_MINFO.decodes:%)VTV" dl E" E"rcD[URUR45$r)r rvrwrs rrRecord_MINFO.__hash__sT\\4<<011r)rwrvrnrgr)rrrrrr(rrvrwrrwrrrrrrrrrrTrTs>* DGGM5N !-# 2rrTcL\rSrSrSr\rSrSrSr S Sjr S Sjr S S jr S r S rg)rViax Mail exchange. @type preference: L{int} @ivar preference: Specifies the preference given to this RR among others at the same owner. Lower values are preferred. @type name: L{Name} @ivar name: A domain-name which specifies a host willing to act as a mail exchange. @type ttl: L{int} @ivar ttl: The maximum number of seconds which this record should be cached. r*)rArrn)rArrnNc [U5Ul[URSU55Ul[ U5Ulg)zD @param name: See L{Record_MX.name}. @type name: L{bytes} or L{str} exchangeN)rrArkrOrrrn)rrArrnkwargss rrRecord_MX.__init__ s1 j/J56 C=rcUR[R"SUR55 URR X5 grT)rrr rArrrBs rrRecord_MX.encodes/ FKKdoo67 )rc[R"S[US55SUl[ 5UlUR R U5 g)Nrrr)rrrrArkrrrs rrRecord_MX.decodes; --mE1.EFqIF  rcD[URUR45$r)r rArrs rrRecord_MX.__hash__sT__dii011r)rrArnrZr)rrrrrr*rrrwrrrrrrrrrrVrVs2 DM5BN!* 2rrVcd\rSrSrSrSrSrSr\r Sr Sr Sr S r SrSrSS jrSS jrSS jrSrSrg )r_i a A record containing the fingerprint of an SSH key. @type algorithm: L{int} @ivar algorithm: The SSH key's algorithm, such as L{ALGORITHM_RSA}. Note that the numbering used for SSH key algorithms is specific to the SSHFP record, and is not the same as the numbering used for KEY or SIG records. @type fingerprintType: L{int} @ivar fingerprintType: The fingerprint type, such as L{FINGERPRINT_TYPE_SHA256}. @type fingerprint: L{bytes} @ivar fingerprint: The key's fingerprint, e.g. a 32-byte SHA-256 digest. @cvar ALGORITHM_RSA: The algorithm value for C{ssh-rsa} keys. @cvar ALGORITHM_DSS: The algorithm value for C{ssh-dss} keys. @cvar ALGORITHM_ECDSA: The algorithm value for C{ecdsa-sha2-*} keys. @cvar ALGORITHM_Ed25519: The algorithm value for C{ed25519} keys. @cvar FINGERPRINT_TYPE_SHA1: The type for SHA-1 fingerprints. @cvar FINGERPRINT_TYPE_SHA256: The type for SHA-256 fingerprints. @see: U{RFC 4255 } and U{RFC 6594 } r5 algorithmfingerprintType fingerprintrn)rrrrrrrc4XlX lX0lX@lgrr)rrrrrns rrRecord_SSHFP.__init__Ms".&rNcUR[R"SURUR55 URUR 5 g)N!BB)rrr rrrrBs rrRecord_SSHFP.encodeSs7 FKKt~~t7K7KLM D$$%rc[R"S[US55nUuUlUl[XS- 5Ulg)Nrr)rrrrrrrs rrRecord_SSHFP.decodeWs9 MM%ua!8 912.-( ;rcZ[URURUR45$r)r rrrrs rrRecord_SSHFP.__hash__\s$T^^T%9%94;K;KLMMr)rrrrn)rrrrr)rrrrrrrwrr5r ALGORITHM_RSA ALGORITHM_DSSALGORITHM_ECDSAALGORITHM_Ed25519FINGERPRINT_TYPE_SHA1FINGERPRINT_TYPE_SHA256rrrrrrrrr_r_ sT:MNDN DMMO &< Nrr_cP\rSrSrSr\rSrS\4S4r Sr Sr S S jr S S jr S rSrg) rai`z Freeform text. @type data: L{list} of L{bytes} @ivar data: Freeform text which makes up this record. @type ttl: L{int} @ivar ttl: The maximum number of seconds which this record should be cached. r4rrnrrncd[U5Ul[URSS55Ulg)Nrn)rrrrOrn)rrkws rrRecord_TXT.__init__rs$J BFF5$/0rNc URH5nUR[R"S[ U55U-5 M7 gr)rrrr r)rrrds rrRecord_TXT.encodews0A KK D#a&1A5 6rc"Sn/UlX2:aV[R"S[US55SnURR [X55 X4S-- nX2:aMVX2:wa&[ R "SX0RU4-5 gg)Nrrrz1Decoded %d bytes in %s record, but rdlength is %d)rrrrrrmsgr)rrrsoFarLs rrRecord_TXT.decode{s n dM%$;[[UR55$r)r tuplerrs rrRecord_TXT.__hash__sE$))$%%rr)rrrrrr4rrrrrwrrrrrrrrrara`s< DM~.6N'1 7 &rracT\rSrSrSrSrSrSrS\4S4r S Sjr S S jr S S jr S r Srg)rcia Encapsulate the wire data for unknown record types so that they can pass through the system unchanged. @type data: L{bytes} @ivar data: Wire data which makes up this record. @type ttl: L{int} @ivar ttl: The maximum number of seconds which this record should be cached. @since: 11.1 NUNKNOWNrrrnc0Xl[U5Ulgr)rrrn)rrrns rrUnknownRecord.__init__s C=rc:URUR5 g)zK Write the raw bytes corresponding to this record's payload to the stream. N)rrrBs rrUnknownRecord.encodes  DIIrc@Uc [S5e[X5Ulg)zf Load the bytes which are part of this record from the stream and store them unparsed and unmodified. Nz)must know length for unknown record types) Exceptionrrrs rrUnknownRecord.decodes! >GH H!%0 rcD[URUR45$r)r rrnrs rrUnknownRecord.__hash__rfrrr)rrrrrrrrwrrrrrrrrrrrcrcs<  DM'z*E2N!1+rrcc \rSrSrSr\rSrSrg)r]iaO Structurally, freeform text. Semantically, a policy definition, formatted as defined in U{rfc 4408}. @type data: L{list} of L{bytes} @ivar data: Freeform text which makes up this record. @type ttl: L{int} @ivar ttl: The maximum number of seconds which this record should be cached. r2rN) rrrrrr2rrrrrrr]r]s  DMrr]c`\rSrSrSrSrSr/SQr\r SSSSS\ S S4S jr SS jr SS jr S rSrg)r`ia A transaction signature, encapsulated in a RR, as described in U{RFC 2845 }. @type algorithm: L{Name} @ivar algorithm: The name of the signature or MAC algorithm. @type timeSigned: L{int} @ivar timeSigned: Signing time, as seconds from the POSIX epoch. @type fudge: L{int} @ivar fudge: Allowable time skew, in seconds. @type MAC: L{bytes} @ivar MAC: The message digest or signature. @type originalID: L{int} @ivar originalID: A message ID. @type error: L{int} @ivar error: An error code (extended C{RCODE}) carried in exceptional cases. @type otherData: L{bytes} @ivar otherData: Other data carried in exceptional cases. r6)r timeSignedfudgeMAC originalIDerror otherDatarn)rrrrrNrrrc UcSO [U5UlX l[U5UlX@lXPlX`lXplXl gr) rkrrrrrrrrrn) rrrrrrrrrns rrRecord_TSIG.__init__s? "+!2Y$e_ $ "rc 2URRX5 UR[R"SUR 5SS5 UR[R"SUR [UR555 URUR5 UR[R"SURUR[UR555 URUR5 g)Nz!QrrAr9) rrrrr rrrrrrrrBs rrRecord_TSIG.encode s e. FKKdoo6qr:; FKKtzz3txx=AB DHH KKS=P Q   DNN#rcP[5nURU5 X0l[R"SS[ US5-5nUuUlUln[ X5Ul[R"S[ US55nUuUl Ul n[ X5Ul g)Nz!QHHs r9r) rkrrrrrrrrrrr)rrrrfields macLength otherLengths rrRecord_TSIG.decode sF "v{]5"5M'MN17.Y 2v}UA'>?390[&u:rcp[URURURUR45$r)r rrrrrs rrRecord_TSIG.__hash__% s&T^^T__dhhPQQr)rrrrrrrrnr)rrrrrrrwrr6rrrrrrrrrrrr`r`sR8M NN D  2$ ;Rrr`c XU"SURSS.UD6nURSSUlU$)av Generate a L{Message} like instance suitable for use as the response to C{message}. The C{queries}, C{id} attributes will be copied from C{message} and the C{answer} flag will be set to L{True}. @param responseConstructor: A response message constructor with an initializer signature matching L{dns.Message.__init__}. @type responseConstructor: C{callable} @param message: A request message. @type message: L{Message} @param kwargs: Keyword arguments which will be passed to the initialiser of the response message. @type kwargs: L{dict} @return: A L{Message} like response instance. @rtype: C{responseConstructor} T)idanswerNr)rqueries)responseConstructormessagerresponses r_responseFromMessager) s2,#HgjjHHHq)H Orc/n[R"URR5nUHLnURUR n[ XU5nXQ;dXv:wdM4URSUSU<35 MN U$)a Inspect the function signature of C{obj}'s constructor, and get a list of which arguments should be displayed. This is a helper function for C{_compactRepr}. @param obj: The instance whose repr is being generated. @param alwaysShow: A L{list} of field names which should always be shown. @param fieldNames: A L{list} of field attribute names which should be shown if they have non-default values. @return: A L{list} of displayable arguments. rM=)inspect signature __class__r parametersdefaultryr)obj alwaysShow fieldNamesdisplayableArgsrr defaultValue fieldValues r_getDisplayableArgumentsrD s}O!!#--"8"89I ++D199 S 5  J$>  " "QtfAj^#< =  rcUc/nUc/nUc/nUc/n/nUH+nXa;d[XS5S:XdMURU5 M- [XU5nSURR/U-nU(a/URSR SR U555 UH0n[X/5n U (dMURSUSU <35 M2 URS5 S R U5$) a Return a L{str} representation of C{obj} which only shows fields with non-default values, flags which are True and sections which have been explicitly set. @param obj: The instance whose repr is being generated. @param alwaysShow: A L{list} of field names which should always be shown. @param flagNames: A L{list} of flag attribute names which should be shown if they are L{True}. @param fieldNames: A L{list} of field attribute names which should be shown if they have non-default values. @param sectionNames: A L{list} of section attribute names which should be shown if they have been assigned a value. @return: A L{str} representation of C{obj}. FT}. @type authenticData: L{int} @param checkingDisabled: A flag indicating in a query that pending (non-authenticated) data is acceptable to the resolver sending the query. See U{RFC2535 section-6.1}. @type authenticData: L{int} N)rrrrrrrrrrrrrrr) rrrrrrrrrrrrs rrMessage.__init__ sZT        * 0  rc[USSSSS9$)z Generate a repr of this L{Message}. Only includes the non-default fields and sections and only includes flags which are set. The C{id} is always shown. @return: The native string repr. )rrrrrrr)rrrrrrrrrrrrrrrs rrVMessage.__repr__0 s$ <J  rcNURR[XU55 g)z Add another query to this Message. @type name: L{bytes} @param name: The name to query. @type type: L{int} @param type: Query type @type cls: L{int} @param cls: Query class N)rrrlr=s raddQueryMessage.addQueryI s E$c23rc0n[5nURHnURX25 M URHnURX25 M URHnURX25 M UR HnURX25 M UR 5n[U5UR-nUR(a2X`R:a#SUl USURUR- nURS-S-URS-S--URS-S--URS-S--URS--nURS-S-UR S-S--UR"S-S--UR$S--nUR'[(R*"UR,UR.UU[UR5[UR5[UR5[UR 555 UR'U5 g)Nrrmrrrr)rrrrrrrprr"rrrrrrrrrrrrr  headerFmtr) rrrbody_tmpqbodysizebyte3byte4s rrMessage.encodeX s9A HHX (A HHX (A HHX ( A HHX (!  "4y4??* <UVDA   aE *   sE EEc[U5Hn[URS9nURU5 UR UR 5nU(dMLU"URS9UlURRX5R5 URU5 M g![a  gf=f![a  gf=f)Nr)rn) rrmrrrlookupRecordTyperrnrorur)rrnumrrrrQs rrMessage.parseRecords ssA499-F  e$%%fkk2A6::.FN %%e__= KK     s#B).%B:) B76B7: CCRecord_cBURRU[5$)a  Retrieve the L{IRecord} implementation for the given record type. @param type: A record type, such as C{A} or L{NS}. @type type: L{int} @return: An object which implements L{IRecord} or L{None} if none can be found for the given type. @rtype: C{Type[IRecord]} ) _recordTypesrOrc)rrs rrMessage.lookupRecordType s  $$T=99rcX[5nURU5 UR5$)zb Encode this L{Message} into a byte string in the format described by RFC 1035. @rtype: L{bytes} )rrrp)rrs rtoStr Message.toStr s$  E~~rc<[U5nURU5 g)zf Decode a byte string in the format described by RFC 1035 into this L{Message}. @param str: L{bytes} N)rr)rrrs rfromStrMessage.fromStr s  Er)rrrrrrrrrrrrrrrrr) rrrrrrwr rrr"rrr+nsrrrrVr=r<rrrrr#globalsr startswithrrr&r)rrrrrjrj s&P$I+J$('G'g'b  Yv 2#.2 4*X+: *L  ??9 % %184L4-- .  :  rrjcx\rSrSrSrSr\rSS\SSSSSSSSSSSSSS4Sjr SS jr S r S r \ S 5rS rSrg) _EDNSMessagei ar An I{EDNS} message. Designed for compatibility with L{Message} but with a narrower public interface. Most importantly, L{_EDNSMessage.fromStr} will interpret and remove I{OPT} records that are present in the additional records section. The I{OPT} records are used to populate certain I{EDNS} specific attributes. L{_EDNSMessage.toStr} will add suitable I{OPT} records to the additional section to represent the extended EDNS information. @see: U{https://tools.ietf.org/html/rfc6891} @ivar id: See L{__init__} @ivar answer: See L{__init__} @ivar opCode: See L{__init__} @ivar auth: See L{__init__} @ivar trunc: See L{__init__} @ivar recDes: See L{__init__} @ivar recAv: See L{__init__} @ivar rCode: See L{__init__} @ivar ednsVersion: See L{__init__} @ivar dnssecOK: See L{__init__} @ivar authenticData: See L{__init__} @ivar checkingDisabled: See L{__init__} @ivar maxSize: See L{__init__} @ivar queries: See L{__init__} @ivar answers: See L{__init__} @ivar authority: See L{__init__} @ivar additional: See L{__init__} @ivar _messageFactory: A constructor of L{Message} instances. Called by C{_toMessage} and C{_fromMessage}. rrrrrrrr ednsVersionrbrrrrrrrrFrNcXlX lX0lX@lXPlX`lXplXlXlXl Xl Xl Xl Uc/nXl Uc/nXlUc/nUUlUc/nUUlg)a Construct a new L{_EDNSMessage} @see: U{RFC1035 section-4.1.1} @see: U{RFC2535 section-6.1} @see: U{RFC3225 section-3} @see: U{RFC6891 section-6.1.3} @param id: A 16 bit identifier assigned by the program that generates any kind of query. This identifier is copied the corresponding reply and can be used by the requester to match up replies to outstanding queries. @type id: L{int} @param answer: A one bit field that specifies whether this message is a query (0), or a response (1). @type answer: L{bool} @param opCode: A four bit field that specifies kind of query in this message. This value is set by the originator of a query and copied into the response. @type opCode: L{int} @param auth: Authoritative Answer - this bit is valid in responses, and specifies that the responding name server is an authority for the domain name in question section. @type auth: L{bool} @param trunc: Truncation - specifies that this message was truncated due to length greater than that permitted on the transmission channel. @type trunc: L{bool} @param recDes: Recursion Desired - this bit may be set in a query and is copied into the response. If set, it directs the name server to pursue the query recursively. Recursive query support is optional. @type recDes: L{bool} @param recAv: Recursion Available - this bit is set or cleared in a response, and denotes whether recursive query support is available in the name server. @type recAv: L{bool} @param rCode: Extended 12-bit RCODE. Derived from the 4 bits defined in U{RFC1035 4.1.1} and the upper 8bits defined in U{RFC6891 6.1.3}. @type rCode: L{int} @param ednsVersion: Indicates the EDNS implementation level. Set to L{None} to prevent any EDNS attributes and options being added to the encoded byte string. @type ednsVersion: L{int} or L{None} @param dnssecOK: DNSSEC OK bit as defined by U{RFC3225 3}. @type dnssecOK: L{bool} @param authenticData: A flag indicating in a response that all the data included in the answer and authority portion of the response has been authenticated by the server according to the policies of that server. See U{RFC2535 section-6.1}. @type authenticData: L{bool} @param checkingDisabled: A flag indicating in a query that pending (non-authenticated) data is acceptable to the resolver sending the query. See U{RFC2535 section-6.1}. @type authenticData: L{bool} @param maxSize: The requestor's UDP payload size is the number of octets of the largest UDP payload that can be reassembled and delivered in the requestor's network stack. @type maxSize: L{int} @param queries: The L{list} of L{Query} associated with this message. @type queries: L{list} of L{Query} @param answers: The L{list} of answers associated with this message. @type answers: L{list} of L{RRHeader} @param authority: The L{list} of authority records associated with this message. @type authority: L{list} of L{RRHeader} @param additional: The L{list} of additional records associated with this message. @type additional: L{list} of L{RRHeader} Nr0)rrrrrrrrrr1rbrrrrrrrs rr_EDNSMessage.__init__ sZ       & * 0 ?G ?G  I"  J$rc[USSSSS9$)N)rrrrrrrrb)rrrrr1rrrrrs rrV_EDNSMessage.__repr__ s#  KJ  rc bURURURURURUR UR URURS-URURS9 nURSSUl URSSUl URSSUl URSSUlURbR[!URUR"UR$URS- S9nURR'U5 U$)a Convert to a standard L{dns.Message}. If C{ednsVersion} is not None, an L{_OPTHeader} instance containing all the I{EDNS} specific attributes and options will be appended to the list of C{additional} records. @return: A L{dns.Message} @rtype: L{dns.Message} rm) rrrrrrrrrrNr)rarbr_r`)_messageFactoryrrrrrrrrrrrrrrr1rZrbrr)rmrqs r _toMessage_EDNSMessage._toMessage s  ww;;;;**;;****s",,!22 ! LLO LLO nnQ' q)    '((#||"jjAo A LL   "rc>UR5R5$)zf Encode to wire format by first converting to a standard L{dns.Message}. @return: A L{bytes} string. )r9r&rs rr&_EDNSMessage.toStr s  &&((rc/n/nURHNnUR[:Xa&UR[R U55 M=URU5 MP U"S0SUR _SUR_SUR_SUR_SUR_SUR_SUR_SUR_S UR_S UR_S S _S S_SUR S S _SUR"S S _SUR$S S _SU_6n['U5S:XaYUSnUR(UlUR,UlUR.UlUR2S-UR-Ul U$)aP Construct and return a new L{_EDNSMessage} whose attributes and records are derived from the attributes and records of C{message} (a L{Message} instance). If present, an C{OPT} record will be extracted from the C{additional} section and its attributes and options will be used to set the EDNS specific attributes C{extendedRCODE}, C{ednsVersion}, C{dnssecOK}, C{ednsOptions}. The C{extendedRCODE} will be combined with C{message.rCode} and assigned to C{self.rCode}. @param message: The source L{Message}. @type message: L{Message} @return: A new L{_EDNSMessage} @rtype: L{_EDNSMessage} rrrrrrrrrrr1NrbFrrrrrrrr)rrr.rrZrvrrrrrrrrrrrrrrrar1rbr_rr`)r<rr optRecordsr newMessageopts r _fromMessage_EDNSMessage._fromMessage s*  ##Avv}!!*"9"9!"<=!!!$ $  zz >> >>   --  >>  -- -- "// %55   OOA& OOA&! "''*# $"% * z?a Q-C%([[J ""%,,J !$!3!3J "00A5 EJ rc UR5nURU5 URU5nURHn[ X[ X455 M g)z Decode from wire format, saving flags, values and records to this L{_EDNSMessage} instance in place. @param bytes: The full byte string to be decoded. @type bytes: L{bytes} N)r7r)rArwrxry)rr~r8 ednsMessager|s rr)_EDNSMessage.fromStr, sM  " %''* ..H DGK$B C/r)rrrrrrrrbr1rrrrrrrrr)rrrrrrwrjr7rurrVr9r&rrAr)rrrrr/r/ s~%N(O  %I%V $(T)::x Drr/cB\rSrSrSrSrSrS SjrSrSr Sr Sr S r g) rpi< z DNS protocol mixin shared by UDP and TCP implementations. @ivar _reactor: A L{IReactorTime} and L{IReactorUDP} provider which will be used to issue DNS queries and manage request timeouts. NcfXl[R"SS5UlUcSSKJn X lg)Niir)reactor) controllerrandom randrangertwisted.internetrH_reactor)rrIrHs rrDNSMixin.__init__G s($""5%0 ? 0 rc>[5nXR;aU$M)z! Return a unique ID for queries. )r liveMessagesrrs rpickIDDNSMixin.pickIDN s$B*** rc<URR"X/UQ76$)z< Wrapper around reactor.callLater, mainly for test purpose. )rM callLater)rperiodfuncargss rrUDNSMixin.callLaterW s}}&&v;d;;rc[USS9nXlU"U5 [R "5nUR X RXc5nXg4URU'U$![a [R"5s$f=f)aJ Send out a message with the given queries. @type queries: L{list} of C{Query} instances @param queries: The queries to transmit @type timeout: L{int} or C{float} @param timeout: How long to wait before giving up @type id: L{int} @param id: Unique key for this request @type writeMessage: C{callable} @param writeMessage: One-parameter callback which writes the message @rtype: C{Deferred} @return: a C{Deferred} which will be fired with the result of the query, or errbacked with any errors that could happen (exceptions during writing of the query, timeout errors, ...). r)r) rjr BaseExceptionrfailDeferredrU _clearFailedrP)rrtimeoutr writeMessager8resultDeferred cancelCalls r_queryDNSMixin._query] s{* Bq !  O)^^G->->S !/ <" ::<  sAA?>A?cURU UR[R"[ U555 g![a N;f=f)z% Clean the Deferred after a timeout. N)rPKeyErrorerrbackrFailurerz)rdeferredrs rr^DNSMixin._clearFailed sH !!"% )=b)ABC   s > A  A )rMrIrr) rrrrrrrPrrRrUrcr^rrrrrprp< s. BL < !FDrrpcJ\rSrSrSrSrSrSrSrSr Sr S r S S jr S r g) roi z DNS protocol over UDP. Nc.0Ul0UlSUlg)z' Stop protocol: reset state variables. NrPresends transportrs r stopProtocol DNSDatagramProtocol.stopProtocol s rc 0Ul0Ulg)z# Upon start, reset internal state. N)rPrnrs r startProtocol!DNSDatagramProtocol.startProtocol s rcXURRUR5U5 g)@ Send a message holding DNS queries. @type message: L{Message} N)rorr&)rrrs rr` DNSDatagramProtocol.writeMessage s W]]_g6rc:URRSUSS9 g)Nrr) maxPacketSize)rM listenUDPrs rstartListening"DNSDatagramProtocol.startListening s 4s;rc[5nURU5 URUR;aUURURupVURUR UR5 URU5 gURUR;aUR R#X0U5 gg![a' [R"S[ U5U4-5 g[ a&n[R"SUSU35 SnAgSnAf[a- [R"[R"5S5 gf=f![a [R"5 gf=f)zQ Read a datagram, extract the message in it and trigger the associated Deferred. z#Truncated packet (%d bytes) from %sNzInvalid packet (z) from zUnexpected decoding error)rjr)rrrrrr[errrrhrrPcancelcallbackrnrImessageReceived)rraddrr8exr cancellers rdatagramReceived$DNSDatagramProtocol.datagramReceived s/ I  IIdO 444$$ $,,QTT2LA!!!$$'      1 tt4<<'//>(1  GG9SY Mark message ID as no longer having duplication suppression. N)rnrfrQs r removeResend DNSDatagramProtocol.removeResend s%  R    s  c ^^TR(dTR5 UcTR 5nOSTR U'UU4SjnTRX#XE5$![a [R"5s$f=f)z Send out a message with the given queries. @type address: L{tuple} of L{str} and L{int} @param address: The address to which to send the query @type queries: L{list} of C{Query} instances @param queries: The queries to transmit @rtype: C{Deferred} rc*>TRUT5 gr)r`)r8rrs rr`/DNSDatagramProtocol.query..writeMessage s   a )r)ror{rrr\rRrnrc)rrrr_rr`s`` rqueryDNSDatagramProtocol.query sr~~ $##% :B DLL  *{{7R>>% $zz|# $sA!!BBrm)rN)rrrrrrnrprsr`r{rrrrrrrroro s2G7<!?F?rrocB\rSrSrSrSrSrSrSrSr Sr S S jr S r g) rqi z DNS protocol over TCP. NrcUR5nURR[R"S[ U55U-5 g)rvrN)r&rorrr r)rrrs rr`DNSProtocol.writeMessage s5 MMO V[[s1v6:;rcH0UlURRU5 g)zF Connection is made: reset internal state, and notify the controller. N)rPrIconnectionMaders rrDNSProtocol.connectionMade s &&t,rc:URRU5 g)zB Notify the controller that this protocol is no longer connected. N)rIconnectionLost)rreasons rrDNSProtocol.connectionLost s &&t,rcU=RU- slUR(GaNURcY[UR5S:a@[R"SURSS5SUlURSSUl[UR5UR:aURSURn[ 5nUR U5 URURupEURUR UR5 URU5 URURSUlSUlOgUR(aGMMgg![a [R"5 N^f=f![a URR!X05 Nf=f)Nrrr)bufferrrrrrjr)rPrrrr[rr~rfrIr)rrmyChunkr8rrs r dataReceivedDNSProtocol.dataReceived sU t kkk{{"s4;;'71'<$mmD$++bq/B1E "kk!"o 4;;4;;.++m 4I '" "#'#4#4QTT#:LA))!$$/$$&" 1 #kk$++-8 " 5kkk()" " =OO33A<=s$&F)E77FF%GGcZUR5nURXX0R5$)z Send out a message with the given queries. @type queries: L{list} of C{Query} instances @param queries: The queries to transmit @rtype: C{Deferred} )rRrcr`)rrr_rs rrDNSProtocol.query4 s&[[]{{7R1B1BCCr)rrrP)r) rrrrrrrr`rrrrrrrrrqrq s-F F<--> Drrq)rz str | bytesrr~)rrrr)rzUnion[str, bytes, int]rr)rNonerr)rr/rzUnion[int, None])NNNN) rrrSequence[str] | Nonerrrrrrrr)r __future__rrrJrrior itertoolsrtypingrrrr r zope.interfacer r r rLrrtwisted.internet.errorrtwisted.pythonrrrrtputiltwisted.python.compatrrr__all__rrrrrrxrrr,r%r&rr1r$r'r)r-r7r/r!r(r*r4r0rrr3r+rr r.r5r2rr6rer?r>r#r"r=rhrrgr<r:r9r;r8rdrfrursrvrtrwrrr@rDrArBrCrErFrGrHrtwisted.names.errorryrzr{rrrrrrrrrirkrl FancyStrMixin FancyEqMixinrZrrmrnrXrQrRrMrPrSrUrZrNrIr\rYrbrKrJr^rWrLr[rOrTrVr_rarcr]r`rrrrjr/rpDatagramProtocolroProtocolrq)kvs00rrs1   # CC<<-4BB??e P ??CK * !RL'          s   7    & 7 7 !"#$ 7& 7 7 7&&; @).c3%dE5+ && 7 7  !&k&7&7&9;;L;L;N O P OfqQT O P q!BB T2tRr4eD "/"5"5"78"7qt"78 #((*i 27q.GWeWh "2r](EiE(BF<B,     4$ $ Nz7 Z.).).)b Zc'c'c'L  Z9I9I 9Ix Zw %%v':':w w t Z91--v/B/B9191x Zwv""wwt "6'')<)<""L     <    <   ..v""....b p $$f&:&:p p f "&&&(;(;""> 9=$$f&:&:9=9=x +"&%%v';';+"+"\ ` $$f&9&9` ` F @J$$f&:&:@J@JF w 6&&(<(<w w t .36'')<)<.3.3b 0+##V%9%90+0+f 296'')<)<2929j 826&&(<(<8282v *2$$f&9&9*2*2Z <N6&&(<(<<N<N~ (&$$f&:&:(&(&V )+F'')=)=)+)+X" [R&%%v';';[R[R|64(,&*'+)- 5 5$5$5% 5 ' 5  5pKf!!K\ WD6&&WDt LDLD^h?(H$=$=h?VHD(H--HDg_ Q 9s ?Z:[