+ Dfj0Rt^RIHt^RIHtHtHt^RIHt!RR4t !RR]P4t Rt !R R 4t R R ltR #)z Resolver implementation for querying successive authoritative servers to lookup a record, starting from the root nameservers. @author: Jp Calderone todo:: robustify it documentation )defer)commondnserror)Failurec*a]tRt^toRtRtRtVtR#)_DummyControllerz A do-nothing DNS controller. This is useful when all messages received will be responses to previously issued queries. Anything else received will be ignored. cR#N)selfargss&*4/usr/lib/python3/dist-packages/twisted/names/root.pymessageReceived _DummyController.messageReceiveds r N)__name__ __module__ __qualname____firstlineno____doc__r__static_attributes____classdictcell__ __classdict__s@rrrs   rrcLa]tRt^ toRtR RltRtRtRtRt Rt R t Vt R#) ResolveraS L{Resolver} implements recursive lookup starting from a specified list of root servers. @ivar hints: See C{hints} parameter of L{__init__} @ivar _maximumQueries: See C{maximumQueries} parameter of L{__init__} @ivar _reactor: See C{reactor} parameter of L{__init__} @ivar _resolverFactory: See C{resolverFactory} parameter of L{__init__} Nc \PPV4WnW nW0nVf^RIHpW@nR#)a @param hints: A L{list} of L{str} giving the dotted quad representation of IP addresses of root servers at which to begin resolving names. @type hints: L{list} of L{str} @param maximumQueries: An optional L{int} giving the maximum number of queries which will be attempted to resolve a single name. @type maximumQueries: L{int} @param reactor: An optional L{IReactorTime} and L{IReactorUDP} provider to use to bind UDP ports and manage timeouts. @type reactor: L{IReactorTime} and L{IReactorUDP} provider @param resolverFactory: An optional callable which accepts C{reactor} and C{servers} arguments and returns an instance that provides a C{queryUDP} method. Defaults to L{twisted.names.client.Resolver}. @type resolverFactory: callable Nr) r ResolverBase__init__hints_maximumQueries_reactortwisted.names.clientr_resolverFactory)r r!maximumQueriesreactorresolverFactorys&&&&&rr Resolver.__init__+s7* $$T* -  " H /rc bVPUu.uFq\P3NK up#uupi)zj Return a list of two-tuples representing the addresses of the root servers, as defined by C{self.hints}. )r!rPORT)r ips& r_rootsResolver._rootsHs& *.42SXX444s,c VPW PR7pVPV.V4pV'dVPVP4V#)a Issue one query and return a L{Deferred} which fires with its response. @param query: The query to issue. @type query: L{dns.Query} @param servers: The servers which might have an answer for this query. @type servers: L{list} of L{tuple} of L{str} and L{int} @param timeout: A timeout on how long to wait for the response. @type timeout: L{tuple} of L{int} @param filter: A flag indicating whether to filter the results. If C{True}, the returned L{Deferred} will fire with a three-tuple of lists of L{twisted.names.dns.RRHeader} (like the return value of the I{lookup*} methods of L{IResolver}. IF C{False}, the result will be a L{Message} instance. @type filter: L{bool} @return: A L{Deferred} which fires with the response or a timeout error. @rtype: L{Deferred} )serversr')r%r#queryUDP addCallback filterAnswers)r queryr0timeoutfilterrds&&&&& r_queryResolver._queryOsE2  ! !'== ! I JJw (  MM!// *rc VfRpVP\P!WV4VP4W@P4#)z Implement name lookup by recursively discovering the authoritative server for the name and then asking it, starting at one of the servers in C{self.hints}. ) -)_discoverAuthorityrQueryr-r")r nameclstyper5s&&&&&r_lookupResolver._lookupnsA ?%G&& IId# & w@T@T  rc V^8:d \\P!R44#VPWVR4pVP VP WV^, 4V#)a Issue a query to a server and follow a delegation if necessary. @param query: The query to issue. @type query: L{dns.Query} @param servers: The servers which might have an answer for this query. @type servers: L{list} of L{tuple} of L{str} and L{int} @param timeout: A C{tuple} of C{int} giving the timeout to use for this query. @param queriesLeft: A C{int} giving the number of queries which may yet be attempted to answer this query before the attempt will be abandoned. @return: A L{Deferred} which fires with a three-tuple of lists of L{twisted.names.dns.RRHeader} giving the response, or with a L{Failure} if there is a timeout or response error. z"Query limit reached without resultF)rr ResolverErrorr9r2_discoveredAuthority)r r4r0r5 queriesLeftr8s&&&&& rr@Resolver._discoverAuthority|sT. ! 5../STU U KK 7 d//qQrc aaaaaaVP\P8wd+\SP VP4!V44#/oVP F.pSP VP.4PV4K0 V3Rlp\4pSPpRp VPV4V oV!VSPSP4p V fVSP8XdMSP\P!\V4SPSP4SP!4SS4p V3Rlp V P#V 4V #V PSP8Xd$VP VP$VP&3#V P(PV9d\*P,!R4hV P(PpEK>/p VP&FTp V P\P.8XgK$V P(P14WPP&KV .p.pVP$Fp V P\P28XgK$V P(PPpVV 9d+VPV V,\P434KuVPV4K V'dSPSVSS4#V'dHSP7V^,S4p RpV P#V4V P#VVVV3Rl4V #\\*P,!R44#)a Interpret the response to a query, checking for error codes and following delegations if necessary. @param response: The L{Message} received in response to issuing C{query}. @type response: L{Message} @param query: The L{dns.Query} which was issued. @type query: L{dns.Query}. @param timeout: The timeout to use if another query is indicated by this response. @type timeout: L{tuple} of L{int} @param queriesLeft: A C{int} giving the number of queries which may yet be attempted to answer this query before the attempt will be abandoned. @return: A L{Failure} indicating a response error, a three-tuple of lists of L{twisted.names.dns.RRHeader} giving the response to C{query} or a L{Deferred} which will fire with one of those. c<RpSPV.4FNpVPV8XgKVPV8XdVu#VP\P8XgKLTpKP V#r )getrCrDrCNAME)rBrDrCcnamerecordrecordss&&& rfindAnswerOrCName8Resolver._discoveredAuthority..findAnswerOrCNamesVE!++dB/::${{d*%  1 & 0LrNc:<VwrpVP^S4WV3#)insert)resultsanswers authority additionalpreviouss& r cbResolved1Resolver._discoveredAuthority..cbResolveds&9@6Jq(3 'J??rzCycle in CNAME processingcNVwrpV^,PP4#rV)payload dottedQuad)rYrZr[r\s& r getOneAddress4Resolver._discoveredAuthority..getOneAddresss%18.Jqz))4466rc\<SPSV\P3.SS^, 4#)r<)r@rr+)hintrJr4r r5s&r/Resolver._discoveredAuthority..s)T44T388,-w arz/Stuck at response without answers or delegation)rCoderOKrexceptionForCoderZ setdefaultrBappendsetaddrDrCr@rAstrr-r2r[r\rarrHArbNSr+ lookupAddress)r responser4r5rJanswerrSseenrBrQr8r^ addressesrrr!trapsnsrcr]rRsf&fff @@rrIResolver._discoveredAuthoritys. >>SVV #400@JK K&&F   v{{B / 6 6v >' uzz HHTNH&tUZZCF~5::%// #d)UZZC # A@ MM*-H * (((*<*Q>QRR>>&&$.--.IJJ~~** %%Bww#%%*,***?*?*A '',,'&$$Bww#&& ZZ__))?LL)B-!:;LL$ % **5%+N N ""58W5A 7 MM- ( MM  H##$UV r)r"r#r%r!) NN) rrrrrr r-r9rEr@rIrrrs@rrr s/0:5>  .placeholder..swq$'7'D'Dr)r2)r rdeferredrBsjlr placeholder$makePlaceholder..placeholdersDErr )rrBrsff rmakePlaceholderrs rc2a]tRtRtoRtRtRtRtVtR#)DeferredResolvericJ.VnVPVP4R#r )waitingr2gotRealResolver)r resolverDeferreds&&rr DeferredResolver.__init__s $$T%9%9:rcVPpVPVnVPVnVFpVPV4K R#r )r__dict__ __class__callback)r resolverwr8s&& rr DeferredResolver.gotRealResolvers; LL )) !++A JJx rcVPR4'gVR9dLVPP\P!44\ VPR,V4#\ V4h)lookup) getHostByNamer4) startswithrrmrDeferredrAttributeError)r rBs&&r __getattr__DeferredResolver.__getattr__%sS ??8 $ $0J(J LL   0 1"4<<#3T: :T""r)rrrN) rrrrr rrrrrs@rrrs;!##rrNc>a\^ 4Uu.uFp\\R4V,4NK ppVUu.uFq@PRV,4NK pp\P !VRR7pV3RlpVP V4\V4#uupiuupi)a Lookup the root nameserver addresses using the given resolver Return a Resolver which will eventually become a C{root.Resolver} instance that has references to all the root servers that we were able to look up. @param resolver: The resolver instance which will be used to lookup the root nameserver addresses. @type resolver: L{twisted.internet.interfaces.IResolverSimple} @param resolverFactory: An optional callable which returns a resolver instance. It will passed as the C{resolverFactory} argument to L{Resolver.__init__}. @type resolverFactory: callable @return: A L{DeferredResolver} which will be dynamically replaced with L{Resolver} when the root nameservers have been looked up. az%s.root-servers.netT) consumeErrorscv<\VUu.uFq^,'gKV^,NK upSR7#uupi)rW)r!r(r)reser(s& r buildResolver bootstrap..buildResolverDs5!$-A!41Q44-  -s6 6)rangechrordrr DeferredListr2r)rr(idomainsr8Lrs&f r bootstrapr,s(+0)4)Qs3s8a< )G4DKLGq   5 9 :GAL 1D1A MM- A 5Ls $B Br )rtwisted.internetr twisted.namesrrrtwisted.python.failurerrrrrrrr rrrsK #,,*  nv""nb##&r