twisted.names.root.Resolver : API documentation

Instance Variable	hints	See `hints` parameter of `__init__`
Method	__init__	No summary
Instance Variable	_maximumQueries	See `maximumQueries` parameter of `__init__`
Instance Variable	_reactor	See `reactor` parameter of `__init__`
Instance Variable	_resolverFactory	See `resolverFactory` parameter of `__init__`
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

def __init__(self, hints, maximumQueries=10, reactor=None, resolverFactory=None): (source)

Parameters	hints	A `list` of `str` giving the dotted quad representation of IP addresses of root servers at which to begin resolving names. (type: `list` of `str`)
	maximumQueries	An optional `int` giving the maximum number of queries which will be attempted to resolve a single name. (type: `int`)
	reactor	An optional `IReactorTime` and `IReactorUDP` provider to use to bind UDP ports and manage timeouts. (type: `IReactorTime` and `IReactorUDP` provider)
	resolverFactory	An optional callable which accepts `reactor` and `servers` arguments and returns an instance that provides a `queryUDP` method. Defaults to `twisted.names.client.Resolver`. (type: callable)

def _query(self, query, servers, timeout, filter): (source)

Issue one query and return a Deferred which fires with its response.

Parameters	query	The query to issue. (type: `dns.Query`)
	servers	The servers which might have an answer for this query. (type: `list` of `tuple` of `str` and `int`)
	timeout	A timeout on how long to wait for the response. (type: `tuple` of `int`)
	filter	A 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`)
Returns	A `Deferred` which fires with the response or a timeout error. (type: `Deferred`)

def _discoverAuthority(self, query, servers, timeout, queriesLeft): (source)

Issue a query to a server and follow a delegation if necessary.

Parameters	query	The query to issue. (type: `dns.Query`)
	servers	The servers which might have an answer for this query. (type: `list` of `tuple` of `str` and `int`)
	timeout	A `tuple` of `int` giving the timeout to use for this query.
	queriesLeft	A `int` giving the number of queries which may yet be attempted to answer this query before the attempt will be abandoned.
Returns	A `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.

Parameters	response	The `Message` received in response to issuing `query`. (type: `Message`)
	query	The `dns.Query` which was issued. (type: `dns.Query`.)
	timeout	The timeout to use if another query is indicated by this response. (type: `tuple` of `int`)
	queriesLeft	A `int` giving the number of queries which may yet be attempted to answer this query before the attempt will be abandoned.
Returns	A `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.

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