t.n.r.Resolver(common.ResolverBase) : class documentation

Part of twisted.names.root View Source View In Hierarchy

Resolver implements recursive lookup starting from a specified list of root servers.
Instance Variable hints A list of str giving the dotted quad representation of IP addresses of root servers at which to begin resolving names.
Method __init__ Undocumented
Instance Variable _maximumQueries A int giving the maximum number of queries which will be attempted to resolve a single name.
Instance Variable _reactor A IReactorTime and IReactorUDP provider to use to bind UDP ports and manage timeouts.
Method _roots Return a list of two-tuples representing the addresses of the root servers, as defined by self.hints.
Method _query Issue one query and return a Deferred which fires with its response.
Method _lookup Implement name lookup by recursively discovering the authoritative server for the name and then asking it, starting at one of the servers in self.hints.
Method _discoverAuthority Issue a query to a server and follow a delegation if necessary.
Method _discoveredAuthority Interpret the response to a query, checking for error codes and following delegations if necessary.

Inherited from ResolverBase:

Method exceptionForCode Convert a response code (one of the possible values of dns.Message.rCode to an exception instance representing it.
Method query Undocumented
Method lookupAddress Undocumented
Method lookupIPV6Address Undocumented
Method lookupAddress6 Undocumented
Method lookupMailExchange Undocumented
Method lookupNameservers Undocumented
Method lookupCanonicalName Undocumented
Method lookupMailBox Undocumented
Method lookupMailGroup Undocumented
Method lookupMailRename Undocumented
Method lookupPointer Undocumented
Method lookupAuthority Undocumented
Method lookupNull Undocumented
Method lookupWellKnownServices Undocumented
Method lookupService Undocumented
Method lookupHostInfo Undocumented
Method lookupMailboxInfo Undocumented
Method lookupText Undocumented
Method lookupSenderPolicy Undocumented
Method lookupResponsibility Undocumented
Method lookupAFSDatabase Undocumented
Method lookupZone Undocumented
Method lookupNamingAuthorityPointer Undocumented
Method lookupAllRecords Undocumented
Method getHostByName Undocumented
Class Variable _errormap A dict mapping DNS protocol failure response codes to exception classes which will be used to represent those failures.
Method _cbRecords Undocumented
hints =
A list of str giving the dotted quad representation of IP addresses of root servers at which to begin resolving names.
_maximumQueries =
A int giving the maximum number of queries which will be attempted to resolve a single name.
_reactor =
A IReactorTime and IReactorUDP provider to use to bind UDP ports and manage timeouts.
def __init__(self, hints, maximumQueries=10, reactor=None): (source)
Undocumented
def _roots(self): (source)
Return a list of two-tuples representing the addresses of the root servers, as defined by self.hints.
def _query(self, query, servers, timeout, filter): (source)
Issue one query and return a Deferred which fires with its response.
ParametersqueryThe query to issue. (type: dns.Query)
serversThe servers which might have an answer for this query. (type: list of tuple of str and int)
timeoutA timeout on how long to wait for the response. (type: tuple of int)
filterA flag indicating whether to filter the results. If True, the returned Deferred will fire with a three-tuple of lists of RRHeaders (like the return value of the lookup* methods of IResolver. IF False, the result will be a Message instance. (type: bool)
ReturnsA Deferred which fires with the response or a timeout error. (type: Deferred)
def _lookup(self, name, cls, type, timeout): (source)
Implement name lookup by recursively discovering the authoritative server for the name and then asking it, starting at one of the servers in self.hints.
def _discoverAuthority(self, query, servers, timeout, queriesLeft): (source)
Issue a query to a server and follow a delegation if necessary.
ParametersqueryThe query to issue. (type: dns.Query)
serversThe servers which might have an answer for this query. (type: list of tuple of str and int)
timeoutA tuple of int giving the timeout to use for this query.
queriesLeftA int giving the number of queries which may yet be attempted to answer this query before the attempt will be abandoned.
ReturnsA Deferred which fires with a three-tuple of lists of RRHeaders giving the response, or with a Failure if there is a timeout or response error.
def _discoveredAuthority(self, response, query, timeout, queriesLeft): (source)
Interpret the response to a query, checking for error codes and following delegations if necessary.
ParametersresponseThe Message received in response to issuing query. (type: Message)
queryThe dns.Query which was issued. (type: dns.Query.)
timeoutThe timeout to use if another query is indicated by this response. (type: tuple of int)
queriesLeftA int giving the number of queries which may yet be attempted to answer this query before the attempt will be abandoned.
ReturnsA Failure indicating a response error, a three-tuple of lists of RRHeaders giving the response to query or a Deferred which will fire with one of those.
API Documentation for Twisted, generated by pydoctor at 2013-11-08 22:07:30.