twisted.names.common.ResolverBase
class documentationtwisted.names.common
View Source
(View In Hierarchy)
Known subclasses: twisted.names.authority.FileAuthority, twisted.names.cache.CacheResolver, twisted.names.client.Resolver, twisted.names.hosts.Resolver, twisted.names.resolve.ResolverChain, twisted.names.root.Resolver
Implements interfaces: twisted.internet.interfaces.IResolver
ResolverBase
is a base class for implementations of interfaces.IResolver
which deals with a lot of the boilerplate of implementing all of the lookup
methods.
Method | __init__ | Undocumented |
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 | _lookup | Undocumented |
Method | _cbRecords | Undocumented |
dict
mapping DNS protocol failure response codes to
exception classes which will be used to represent those failures.
Convert a response code (one of the possible values of dns.Message.rCode
to an exception instance representing it.
Present Since | 10.0 |
Dispatch query
to the method which can handle its type.
Parameters | query | The DNS query being issued, to which a response is to be generated. (type: twisted.names.dns.Query ) |
timeout | Number of seconds after which to reissue the query. When the last timeout
expires, the query is considered failed. (type: Sequence of int ) | |
Returns | A Deferred
which fires with a three-tuple of lists of twisted.names.dns.RRHeader
instances. The first element of the tuple gives answers. The second
element of the tuple gives authorities. The third element of the tuple
gives additional information. The Deferred may
instead fail with one of the exceptions defined in twisted.names.error or
with NotImplementedError . (type: Deferred ) |
Perform an A record lookup.
Parameters | name | DNS name to resolve. (type: bytes ) |
timeout | Number of seconds after which to reissue the query. When the last timeout
expires, the query is considered failed. (type: Sequence of int ) | |
Returns | A Deferred
which fires with a three-tuple of lists of twisted.names.dns.RRHeader
instances. The first element of the tuple gives answers. The second
element of the tuple gives authorities. The third element of the tuple
gives additional information. The Deferred may
instead fail with one of the exceptions defined in twisted.names.error or
with NotImplementedError . (type: Deferred ) |
Perform an AAAA record lookup.
Parameters | name | DNS name to resolve. (type: str ) |
timeout | Number of seconds after which to reissue the query. When the last timeout
expires, the query is considered failed. (type: Sequence of int ) | |
Returns | A Deferred
which fires with a three-tuple of lists of twisted.names.dns.RRHeader
instances. The first element of the tuple gives answers. The second
element of the tuple gives authorities. The third element of the tuple
gives additional information. The Deferred may
instead fail with one of the exceptions defined in twisted.names.error or
with NotImplementedError . (type: Deferred ) |
Perform an A6 record lookup.
Parameters | name | DNS name to resolve. (type: str ) |
timeout | Number of seconds after which to reissue the query. When the last timeout
expires, the query is considered failed. (type: Sequence of int ) | |
Returns | A Deferred
which fires with a three-tuple of lists of twisted.names.dns.RRHeader
instances. The first element of the tuple gives answers. The second
element of the tuple gives authorities. The third element of the tuple
gives additional information. The Deferred may
instead fail with one of the exceptions defined in twisted.names.error or
with NotImplementedError . (type: Deferred ) |
Perform an MX record lookup.
Parameters | name | DNS name to resolve. (type: str ) |
timeout | Number of seconds after which to reissue the query. When the last timeout
expires, the query is considered failed. (type: Sequence of int ) | |
Returns | A Deferred
which fires with a three-tuple of lists of twisted.names.dns.RRHeader
instances. The first element of the tuple gives answers. The second
element of the tuple gives authorities. The third element of the tuple
gives additional information. The Deferred may
instead fail with one of the exceptions defined in twisted.names.error or
with NotImplementedError . (type: Deferred ) |
Perform an NS record lookup.
Parameters | name | DNS name to resolve. (type: str ) |
timeout | Number of seconds after which to reissue the query. When the last timeout
expires, the query is considered failed. (type: Sequence of int ) | |
Returns | A Deferred
which fires with a three-tuple of lists of twisted.names.dns.RRHeader
instances. The first element of the tuple gives answers. The second
element of the tuple gives authorities. The third element of the tuple
gives additional information. The Deferred may
instead fail with one of the exceptions defined in twisted.names.error or
with NotImplementedError . (type: Deferred ) |
Perform a CNAME record lookup.
Parameters | name | DNS name to resolve. (type: str ) |
timeout | Number of seconds after which to reissue the query. When the last timeout
expires, the query is considered failed. (type: Sequence of int ) | |
Returns | A Deferred
which fires with a three-tuple of lists of twisted.names.dns.RRHeader
instances. The first element of the tuple gives answers. The second
element of the tuple gives authorities. The third element of the tuple
gives additional information. The Deferred may
instead fail with one of the exceptions defined in twisted.names.error or
with NotImplementedError . (type: Deferred ) |
Perform an MB record lookup.
Parameters | name | DNS name to resolve. (type: str ) |
timeout | Number of seconds after which to reissue the query. When the last timeout
expires, the query is considered failed. (type: Sequence of int ) | |
Returns | A Deferred
which fires with a three-tuple of lists of twisted.names.dns.RRHeader
instances. The first element of the tuple gives answers. The second
element of the tuple gives authorities. The third element of the tuple
gives additional information. The Deferred may
instead fail with one of the exceptions defined in twisted.names.error or
with NotImplementedError . (type: Deferred ) |
Perform an MG record lookup.
Parameters | name | DNS name to resolve. (type: str ) |
timeout | Number of seconds after which to reissue the query. When the last timeout
expires, the query is considered failed. (type: Sequence of int ) | |
Returns | A Deferred
which fires with a three-tuple of lists of twisted.names.dns.RRHeader
instances. The first element of the tuple gives answers. The second
element of the tuple gives authorities. The third element of the tuple
gives additional information. The Deferred may
instead fail with one of the exceptions defined in twisted.names.error or
with NotImplementedError . (type: Deferred ) |
Perform an MR record lookup.
Parameters | name | DNS name to resolve. (type: str ) |
timeout | Number of seconds after which to reissue the query. When the last timeout
expires, the query is considered failed. (type: Sequence of int ) | |
Returns | A Deferred
which fires with a three-tuple of lists of twisted.names.dns.RRHeader
instances. The first element of the tuple gives answers. The second
element of the tuple gives authorities. The third element of the tuple
gives additional information. The Deferred may
instead fail with one of the exceptions defined in twisted.names.error or
with NotImplementedError . (type: Deferred ) |
Perform a PTR record lookup.
Parameters | name | DNS name to resolve. (type: str ) |
timeout | Number of seconds after which to reissue the query. When the last timeout
expires, the query is considered failed. (type: Sequence of int ) | |
Returns | A Deferred
which fires with a three-tuple of lists of twisted.names.dns.RRHeader
instances. The first element of the tuple gives answers. The second
element of the tuple gives authorities. The third element of the tuple
gives additional information. The Deferred may
instead fail with one of the exceptions defined in twisted.names.error or
with NotImplementedError . (type: Deferred ) |
Perform an SOA record lookup.
Parameters | name | DNS name to resolve. (type: str ) |
timeout | Number of seconds after which to reissue the query. When the last timeout
expires, the query is considered failed. (type: Sequence of int ) | |
Returns | A Deferred
which fires with a three-tuple of lists of twisted.names.dns.RRHeader
instances. The first element of the tuple gives answers. The second
element of the tuple gives authorities. The third element of the tuple
gives additional information. The Deferred may
instead fail with one of the exceptions defined in twisted.names.error or
with NotImplementedError . (type: Deferred ) |
Perform a NULL record lookup.
Parameters | name | DNS name to resolve. (type: str ) |
timeout | Number of seconds after which to reissue the query. When the last timeout
expires, the query is considered failed. (type: Sequence of int ) | |
Returns | A Deferred
which fires with a three-tuple of lists of twisted.names.dns.RRHeader
instances. The first element of the tuple gives answers. The second
element of the tuple gives authorities. The third element of the tuple
gives additional information. The Deferred may
instead fail with one of the exceptions defined in twisted.names.error or
with NotImplementedError . (type: Deferred ) |
Perform a WKS record lookup.
Parameters | name | DNS name to resolve. (type: str ) |
timeout | Number of seconds after which to reissue the query. When the last timeout
expires, the query is considered failed. (type: Sequence of int ) | |
Returns | A Deferred
which fires with a three-tuple of lists of twisted.names.dns.RRHeader
instances. The first element of the tuple gives answers. The second
element of the tuple gives authorities. The third element of the tuple
gives additional information. The Deferred may
instead fail with one of the exceptions defined in twisted.names.error or
with NotImplementedError . (type: Deferred ) |
Perform an SRV record lookup.
Parameters | name | DNS name to resolve. (type: str ) |
timeout | Number of seconds after which to reissue the query. When the last timeout
expires, the query is considered failed. (type: Sequence of int ) | |
Returns | A Deferred
which fires with a three-tuple of lists of twisted.names.dns.RRHeader
instances. The first element of the tuple gives answers. The second
element of the tuple gives authorities. The third element of the tuple
gives additional information. The Deferred may
instead fail with one of the exceptions defined in twisted.names.error or
with NotImplementedError . (type: Deferred ) |
Perform a HINFO record lookup.
Parameters | name | DNS name to resolve. (type: str ) |
timeout | Number of seconds after which to reissue the query. When the last timeout
expires, the query is considered failed. (type: Sequence of int ) | |
Returns | A Deferred
which fires with a three-tuple of lists of twisted.names.dns.RRHeader
instances. The first element of the tuple gives answers. The second
element of the tuple gives authorities. The third element of the tuple
gives additional information. The Deferred may
instead fail with one of the exceptions defined in twisted.names.error or
with NotImplementedError . (type: Deferred ) |
Perform an MINFO record lookup.
Parameters | name | DNS name to resolve. (type: str ) |
timeout | Number of seconds after which to reissue the query. When the last timeout
expires, the query is considered failed. (type: Sequence of int ) | |
Returns | A Deferred
which fires with a three-tuple of lists of twisted.names.dns.RRHeader
instances. The first element of the tuple gives answers. The second
element of the tuple gives authorities. The third element of the tuple
gives additional information. The Deferred may
instead fail with one of the exceptions defined in twisted.names.error or
with NotImplementedError . (type: Deferred ) |
Perform a TXT record lookup.
Parameters | name | DNS name to resolve. (type: str ) |
timeout | Number of seconds after which to reissue the query. When the last timeout
expires, the query is considered failed. (type: Sequence of int ) | |
Returns | A Deferred
which fires with a three-tuple of lists of twisted.names.dns.RRHeader
instances. The first element of the tuple gives answers. The second
element of the tuple gives authorities. The third element of the tuple
gives additional information. The Deferred may
instead fail with one of the exceptions defined in twisted.names.error or
with NotImplementedError . (type: Deferred ) |
Perform a SPF record lookup.
Parameters | name | DNS name to resolve. (type: str ) |
timeout | Number of seconds after which to reissue the query. When the last timeout
expires, the query is considered failed. (type: Sequence of int ) | |
Returns | A Deferred
which fires with a three-tuple of lists of twisted.names.dns.RRHeader
instances. The first element of the tuple gives answers. The second
element of the tuple gives authorities. The third element of the tuple
gives additional information. The Deferred may
instead fail with one of the exceptions defined in twisted.names.error or
with NotImplementedError . (type: Deferred ) |
Perform an RP record lookup.
Parameters | name | DNS name to resolve. (type: str ) |
timeout | Number of seconds after which to reissue the query. When the last timeout
expires, the query is considered failed. (type: Sequence of int ) | |
Returns | A Deferred
which fires with a three-tuple of lists of twisted.names.dns.RRHeader
instances. The first element of the tuple gives answers. The second
element of the tuple gives authorities. The third element of the tuple
gives additional information. The Deferred may
instead fail with one of the exceptions defined in twisted.names.error or
with NotImplementedError . (type: Deferred ) |
Perform an AFSDB record lookup.
Parameters | name | DNS name to resolve. (type: str ) |
timeout | Number of seconds after which to reissue the query. When the last timeout
expires, the query is considered failed. (type: Sequence of int ) | |
Returns | A Deferred
which fires with a three-tuple of lists of twisted.names.dns.RRHeader
instances. The first element of the tuple gives answers. The second
element of the tuple gives authorities. The third element of the tuple
gives additional information. The Deferred may
instead fail with one of the exceptions defined in twisted.names.error or
with NotImplementedError . (type: Deferred ) |
Perform an AXFR record lookup.
NB This is quite different from other DNS requests. See http://cr.yp.to/djbdns/axfr-notes.html for more information.
NB Unlike other lookup*
methods, the timeout here is not a
list of ints, it is a single int.
Parameters | name | DNS name to resolve. (type: str ) |
timeout | When this timeout expires, the query is considered failed. (type: int ) | |
Returns | A Deferred
which fires with a three-tuple of lists of twisted.names.dns.RRHeader
instances. The first element of the tuple gives answers. The second and
third elements are always empty. The Deferred may
instead fail with one of the exceptions defined in twisted.names.error or
with NotImplementedError . (type: Deferred ) |
Perform a NAPTR record lookup.
Parameters | name | DNS name to resolve. (type: str ) |
timeout | Number of seconds after which to reissue the query. When the last timeout
expires, the query is considered failed. (type: Sequence of int ) | |
Returns | A Deferred
which fires with a three-tuple of lists of twisted.names.dns.RRHeader
instances. The first element of the tuple gives answers. The second
element of the tuple gives authorities. The third element of the tuple
gives additional information. The Deferred may
instead fail with one of the exceptions defined in twisted.names.error or
with NotImplementedError . (type: Deferred ) |
Perform an ALL_RECORD lookup.
Parameters | name | DNS name to resolve. (type: str ) |
timeout | Number of seconds after which to reissue the query. When the last timeout
expires, the query is considered failed. (type: Sequence of int ) | |
Returns | A Deferred
which fires with a three-tuple of lists of twisted.names.dns.RRHeader
instances. The first element of the tuple gives answers. The second
element of the tuple gives authorities. The third element of the tuple
gives additional information. The Deferred may
instead fail with one of the exceptions defined in twisted.names.error or
with NotImplementedError . (type: Deferred ) |
Resolve the domain name name
into an IP address.
Parameters | name | DNS name to resolve. (type: str ) |
timeout | Number of seconds after which to reissue the query. When the last timeout
expires, the query is considered failed. (type: Sequence of int ) | |
Returns | The callback of the Deferred that is returned will be passed a string that
represents the IP address of the specified name, or the errback will be
called if the lookup times out. If multiple types of address records are
associated with the name, A6 records will be returned in preference to AAAA
records, which will be returned in preference to A records. If there are
multiple records of the type to be returned, one will be selected at
random. (type: twisted.internet.defer.Deferred ) | |
Raises | twisted.internet.defer.TimeoutError | Raised (asynchronously) if the name cannot be resolved within the specified timeout period. |