Go to the latest version of this document.
search in docstrings

Search bar offers the following options:

- Term presence. The below example searches for documents that must contain “foo”, might contain “bar” and must not contain “baz”: `+foo bar -baz`
- Wildcards. The below example searches for documents with words beginning with “foo”: `foo*`
- Search in specific fields. The following search matches all objects in "twisted.mail" that matches “search”: `+qname:twisted.mail.* +search`

  Possible fields: 'name', 'qname' (fully qualified name), 'docstring', and 'kind'. Last two fields are only applicable if "search in docstrings" is enabled.

- Fuzzy matches. The following search matches all documents that have a word within 1 edit distance of “foo”: `foo~1`

Results provided by Lunr.js

# ``twisted`.`internet`.`interfaces`.`IResolver``

interface documentation

`class IResolver(IResolverSimple): (source)`

Known implementations: `twisted.names.client`, `twisted.names.common.ResolverBase`, `twisted.names.resolve.ResolverChain`

View In Hierarchy

Undocumented

Method | `lookupAddress` | Perform an A record lookup.
Method | `lookupAddress6` | Perform an A6 record lookup.
Method | `lookupAFSDatabase` | Perform an AFSDB record lookup.
Method | `lookupAllRecords` | Perform an ALL_RECORD lookup.
Method | `lookupAuthority` | Perform an SOA record lookup.
Method | `lookupCanonicalName` | Perform a CNAME record lookup.
Method | `lookupHostInfo` | Perform a HINFO record lookup.
Method | `lookupIPV6Address` | Perform an AAAA record lookup.
Method | `lookupMailBox` | Perform an MB record lookup.
Method | `lookupMailboxInfo` | Perform an MINFO record lookup.
Method | `lookupMailExchange` | Perform an MX record lookup.
Method | `lookupMailGroup` | Perform an MG record lookup.
Method | `lookupMailRename` | Perform an MR record lookup.
Method | `lookupNameservers` | Perform an NS record lookup.
Method | `lookupNamingAuthorityPointer` | Perform a NAPTR record lookup.
Method | `lookupNull` | Perform a NULL record lookup.
Method | `lookupPointer` | Perform a PTR record lookup.
Method | `lookupResponsibility` | Perform an RP record lookup.
Method | `lookupSenderPolicy` | Perform a SPF record lookup.
Method | `lookupService` | Perform an SRV record lookup.
Method | `lookupText` | Perform a TXT record lookup.
Method | `lookupWellKnownServices` | Perform a WKS record lookup.
Method | `lookupZone` | Perform an AXFR record lookup.
Method | `query` | Dispatch `query` to the method which can handle its type.

Inherited from `IResolverSimple`:

Method | `getHostByName` | Resolve the domain name `name` into an IP address.

def lookupAddress(name, timeout): (source)

Perform an A record lookup.

Parameters
name:`str` | DNS name to resolve.
timeout:`Sequence[int]` | Number of seconds after which to reissue the query. When the last timeout expires, the query is considered failed.
Returns

`Deferred[Tuple[RRHeader, RRHeader, RRHeader]]`

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`.

def lookupAddress6(name, timeout): (source)

Perform an A6 record lookup.

Parameters
name:`str` | DNS name to resolve.
timeout:`Sequence[int]` | Number of seconds after which to reissue the query. When the last timeout expires, the query is considered failed.
Returns

`Deferred[Tuple[RRHeader, RRHeader, RRHeader]]`

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`.

def lookupAFSDatabase(name, timeout): (source)

Perform an AFSDB record lookup.

Parameters
name:`str` | DNS name to resolve.
timeout:`Sequence[int]` | Number of seconds after which to reissue the query. When the last timeout expires, the query is considered failed.
Returns

`Deferred[Tuple[RRHeader, RRHeader, RRHeader]]`

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`.

def lookupAllRecords(name, timeout): (source)

Perform an ALL_RECORD lookup.

Parameters
name:`str` | DNS name to resolve.
timeout:`Sequence[int]` | Number of seconds after which to reissue the query. When the last timeout expires, the query is considered failed.
Returns

`Deferred[Tuple[RRHeader, RRHeader, RRHeader]]`

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`.

def lookupAuthority(name, timeout): (source)

Perform an SOA record lookup.

Parameters
name:`str` | DNS name to resolve.
timeout:`Sequence[int]` | Number of seconds after which to reissue the query. When the last timeout expires, the query is considered failed.
Returns

`Deferred[Tuple[RRHeader, RRHeader, RRHeader]]`

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`.

def lookupCanonicalName(name, timeout): (source)

Perform a CNAME record lookup.

Parameters
name:`str` | DNS name to resolve.
timeout:`Sequence[int]` | Number of seconds after which to reissue the query. When the last timeout expires, the query is considered failed.
Returns

`Deferred[Tuple[RRHeader, RRHeader, RRHeader]]`

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`.

def lookupHostInfo(name, timeout): (source)

Perform a HINFO record lookup.

Parameters
name:`str` | DNS name to resolve.
timeout:`Sequence[int]` | Number of seconds after which to reissue the query. When the last timeout expires, the query is considered failed.
Returns

`Deferred[Tuple[RRHeader, RRHeader, RRHeader]]`

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`.

def lookupIPV6Address(name, timeout): (source)

Perform an AAAA record lookup.

Parameters
name:`str` | DNS name to resolve.
timeout:`Sequence[int]` | Number of seconds after which to reissue the query. When the last timeout expires, the query is considered failed.
Returns

`Deferred[Tuple[RRHeader, RRHeader, RRHeader]]`

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`.

def lookupMailBox(name, timeout): (source)

Perform an MB record lookup.

Parameters
name:`str` | DNS name to resolve.
timeout:`Sequence[int]` | Number of seconds after which to reissue the query. When the last timeout expires, the query is considered failed.
Returns

`Deferred[Tuple[RRHeader, RRHeader, RRHeader]]`

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`.

def lookupMailboxInfo(name, timeout): (source)

Perform an MINFO record lookup.

Parameters
name:`str` | DNS name to resolve.
timeout:`Sequence[int]` | Number of seconds after which to reissue the query. When the last timeout expires, the query is considered failed.
Returns

`Deferred[Tuple[RRHeader, RRHeader, RRHeader]]`

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`.

def lookupMailExchange(name, timeout): (source)

Perform an MX record lookup.

Parameters
name:`str` | DNS name to resolve.
timeout:`Sequence[int]` | Number of seconds after which to reissue the query. When the last timeout expires, the query is considered failed.
Returns

`Deferred[Tuple[RRHeader, RRHeader, RRHeader]]`

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`.

def lookupMailGroup(name, timeout): (source)

Perform an MG record lookup.

Parameters
name:`str` | DNS name to resolve.
timeout:`Sequence[int]` | Number of seconds after which to reissue the query. When the last timeout expires, the query is considered failed.
Returns

`Deferred[Tuple[RRHeader, RRHeader, RRHeader]]`

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`.

def lookupMailRename(name, timeout): (source)

Perform an MR record lookup.

Parameters
name:`str` | DNS name to resolve.
timeout:`Sequence[int]` | Number of seconds after which to reissue the query. When the last timeout expires, the query is considered failed.
Returns

`Deferred[Tuple[RRHeader, RRHeader, RRHeader]]`

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`.

def lookupNameservers(name, timeout): (source)

Perform an NS record lookup.

Parameters
name:`str` | DNS name to resolve.
timeout:`Sequence[int]` | Number of seconds after which to reissue the query. When the last timeout expires, the query is considered failed.
Returns

`Deferred[Tuple[RRHeader, RRHeader, RRHeader]]`

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`.

def lookupNamingAuthorityPointer(name, timeout): (source)

Perform a NAPTR record lookup.

Parameters
name:`str` | DNS name to resolve.
timeout:`Sequence[int]` | Number of seconds after which to reissue the query. When the last timeout expires, the query is considered failed.
Returns

`Deferred[Tuple[RRHeader, RRHeader, RRHeader]]`

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`.

def lookupNull(name, timeout): (source)

Perform a NULL record lookup.

Parameters
name:`str` | DNS name to resolve.
timeout:`Sequence[int]` | Number of seconds after which to reissue the query. When the last timeout expires, the query is considered failed.
Returns

`Deferred[Tuple[RRHeader, RRHeader, RRHeader]]`

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`.

def lookupPointer(name, timeout): (source)

Perform a PTR record lookup.

Parameters
name:`str` | DNS name to resolve.
timeout:`Sequence[int]` | Number of seconds after which to reissue the query. When the last timeout expires, the query is considered failed.
Returns

`Deferred[Tuple[RRHeader, RRHeader, RRHeader]]`

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`.

def lookupResponsibility(name, timeout): (source)

Perform an RP record lookup.

Parameters
name:`str` | DNS name to resolve.
timeout:`Sequence[int]` | Number of seconds after which to reissue the query. When the last timeout expires, the query is considered failed.
Returns

`Deferred[Tuple[RRHeader, RRHeader, RRHeader]]`

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`.

def lookupSenderPolicy(name, timeout): (source)

Perform a SPF record lookup.

Parameters
name:`str` | DNS name to resolve.
timeout:`Sequence[int]` | Number of seconds after which to reissue the query. When the last timeout expires, the query is considered failed.
Returns

`Deferred[Tuple[RRHeader, RRHeader, RRHeader]]`

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`.

def lookupService(name, timeout): (source)

Perform an SRV record lookup.

Parameters
name:`str` | DNS name to resolve.
timeout:`Sequence[int]` | Number of seconds after which to reissue the query. When the last timeout expires, the query is considered failed.
Returns

`Deferred[Tuple[RRHeader, RRHeader, RRHeader]]`

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`.

def lookupText(name, timeout): (source)

Perform a TXT record lookup.

Parameters
name:`str` | DNS name to resolve.
timeout:`Sequence[int]` | Number of seconds after which to reissue the query. When the last timeout expires, the query is considered failed.
Returns

`Deferred[Tuple[RRHeader, RRHeader, RRHeader]]`

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`.

def lookupWellKnownServices(name, timeout): (source)

Perform a WKS record lookup.

Parameters
name:`str` | DNS name to resolve.
timeout:`Sequence[int]` | Number of seconds after which to reissue the query. When the last timeout expires, the query is considered failed.
Returns

`Deferred[Tuple[RRHeader, RRHeader, RRHeader]]`

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`.

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:`str` | DNS name to resolve.
timeout:`Sequence[int]` | When this timeout expires, the query is considered failed.
Returns
`Deferred[Tuple[RRHeader, RRHeader, RRHeader]]` | 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`.

def query(query, timeout): (source)

Dispatch `query` to the method which can handle its type.

Parameters
query:`Query` | The DNS query being issued, to which a response is to be generated.
timeout:`Sequence[int]` | Number of seconds after which to reissue the query. When the last timeout expires, the query is considered failed.
Returns

`Deferred[Tuple[RRHeader, RRHeader, RRHeader]]`

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`.