twisted.names.root.Resolver(common.ResolverBase) class documentationtwisted.names.root
View Source
(View In Hierarchy)
Resolver
implements recursive lookup starting from a specified list of root
servers.
| 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 | Dispatch query to the method which can handle its type. |
| Method | lookupAddress | Perform an A record lookup. |
| Method | lookupIPV6Address | Perform an AAAA record lookup. |
| Method | lookupAddress6 | Perform an A6 record lookup. |
| Method | lookupMailExchange | Perform an MX record lookup. |
| Method | lookupNameservers | Perform an NS record lookup. |
| Method | lookupCanonicalName | Perform a CNAME record lookup. |
| Method | lookupMailBox | Perform an MB record lookup. |
| Method | lookupMailGroup | Perform an MG record lookup. |
| Method | lookupMailRename | Perform an MR record lookup. |
| Method | lookupPointer | Perform a PTR record lookup. |
| Method | lookupAuthority | Perform an SOA record lookup. |
| Method | lookupNull | Perform a NULL record lookup. |
| Method | lookupWellKnownServices | Perform a WKS record lookup. |
| Method | lookupService | Perform an SRV record lookup. |
| Method | lookupHostInfo | Perform a HINFO record lookup. |
| Method | lookupMailboxInfo | Perform an MINFO record lookup. |
| Method | lookupText | Perform a TXT record lookup. |
| Method | lookupSenderPolicy | Perform a SPF record lookup. |
| Method | lookupResponsibility | Perform an RP record lookup. |
| Method | lookupAFSDatabase | Perform an AFSDB record lookup. |
| Method | lookupZone | Perform an AXFR record lookup. |
| Method | lookupNamingAuthorityPointer | Perform a NAPTR record lookup. |
| Method | lookupAllRecords | Perform an ALL_RECORD lookup. |
| Method | getHostByName | Resolve the domain name name into an IP address. |
| 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 |
| 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) |
Return a list of two-tuples representing the addresses of the root
servers, as defined by self.hints.
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 twisted.names.dns.RRHeader
(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) | |
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.
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 twisted.names.dns.RRHeader
giving the response, or with a Failure if
there is a timeout or response error. | |
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 twisted.names.dns.RRHeader
giving the response to query or a Deferred which
will fire with one of those. | |