twisted.internet.interfaces.IResolver : API documentation

def query(query, timeout): (source)

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: `Query`)
	timeout	Number of seconds after which to reissue the query. When the last timeout expires, the query is considered failed. (type: `Sequence[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`)

def lookupAddress(name, timeout): (source)

Perform an A 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[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`)

def lookupAddress6(name, timeout): (source)

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[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`)

def lookupIPV6Address(name, timeout): (source)

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[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`)

def lookupMailExchange(name, timeout): (source)

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[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`)

def lookupNameservers(name, timeout): (source)

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[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`)

def lookupCanonicalName(name, timeout): (source)

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[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`)

def lookupMailBox(name, timeout): (source)

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[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`)

def lookupMailGroup(name, timeout): (source)

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[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`)

def lookupMailRename(name, timeout): (source)

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[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`)

def lookupPointer(name, timeout): (source)

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[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`)

def lookupAuthority(name, timeout): (source)

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[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`)

def lookupNull(name, timeout): (source)

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[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`)

def lookupWellKnownServices(name, timeout): (source)

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[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`)

def lookupHostInfo(name, timeout): (source)

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[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`)

def lookupMailboxInfo(name, timeout): (source)

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[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`)

def lookupText(name, timeout): (source)

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[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`)

def lookupResponsibility(name, timeout): (source)

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[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`)

def lookupAFSDatabase(name, timeout): (source)

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[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`)

def lookupService(name, timeout): (source)

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[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`)

def lookupAllRecords(name, timeout): (source)

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[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`)

def lookupSenderPolicy(name, timeout): (source)

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[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`)

def lookupNamingAuthorityPointer(name, timeout): (source)

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[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`)

def lookupZone(name, timeout): (source)

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: `Sequence[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`)

Method	query	Dispatch `query` to the method which can handle its type.
Method	lookupAddress	Perform an A record lookup.
Method	lookupAddress6	Perform an A6 record lookup.
Method	lookupIPV6Address	Perform an AAAA 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	lookupHostInfo	Perform a HINFO record lookup.
Method	lookupMailboxInfo	Perform an MINFO record lookup.
Method	lookupText	Perform a TXT record lookup.
Method	lookupResponsibility	Perform an RP record lookup.
Method	lookupAFSDatabase	Perform an AFSDB record lookup.
Method	lookupService	Perform an SRV record lookup.
Method	lookupAllRecords	Perform an ALL_RECORD lookup.
Method	lookupSenderPolicy	Perform a SPF record lookup.
Method	lookupNamingAuthorityPointer	Perform a NAPTR record lookup.
Method	lookupZone	Perform an AXFR record lookup.