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`.`names`.`secondary`.`SecondaryAuthority``

class documentation

`class SecondaryAuthority(FileAuthority): (source)`

View In Hierarchy

An Authority that keeps itself updated by performing zone transfers.

Class Method | `fromServerAddressAndDomain` | Construct a new `SecondaryAuthority` from a tuple giving a server address and a `bytes` giving the name of a domain for which this is an authority.
Method | `__init__` | No summary
Method | `transfer` | Attempt a zone transfer.
Method | `update` | Undocumented
Instance Variable | `domain` | The domain for which this is the secondary authority.
Instance Variable | `primary` | The IP address of the server from which zone transfers will be attempted.
Instance Variable | `records` | Undocumented
Instance Variable | `soa` | Undocumented
Instance Variable | `transfering` | Undocumented
Instance Variable | `transferred` | Undocumented
Instance Variable | `transferring` | Undocumented
Method | `_cbTransferred` | Undocumented
Method | `_cbZone` | Undocumented
Method | `_ebTransferred` | Undocumented
Method | `_ebZone` | Undocumented
Method | `_lookup` | Determine a response to a particular DNS query.
Instance Variable | `_port` | The port number of the server from which zone transfers will be attempted.
Instance Variable | `_reactor` | The reactor to use to perform the zone transfers, or `None` to use the global reactor.

Inherited from `FileAuthority`:

Method | `__setstate__` | Undocumented
Method | `loadFile` | Load DNS records from a file.
Method | `lookupZone` | Perform an AXFR record lookup.
Instance Variable | `__dict__` | Undocumented
Method | `_additionalRecords` | Find locally known information that could be useful to the consumer of the response and construct appropriate records to include in the additional section of that response.
Method | `_cbAllRecords` | Undocumented
Constant | `_ADDITIONAL_PROCESSING_TYPES` | Record types for which additional processing will be done.
Constant | `_ADDRESS_TYPES` | Record types which are useful for inclusion in the additional section generated during additional processing.
Instance Variable | `_cache` | Undocumented

Inherited from `ResolverBase` (via `FileAuthority`):

Method | `exceptionForCode` | Convert a response code (one of the possible values of `dns.Message.rCode` to an exception instance representing it.
Method | `getHostByName` | Resolve the domain name `name` into an IP address.
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 | `query` | Dispatch `query` to the method which can handle its type.
Instance Variable | `typeToMethod` | Undocumented
Method | `_cbRecords` | Undocumented
Class Variable | `_errormap` | A `dict` mapping DNS protocol failure response codes to exception classes which will be used to represent those failures.
Class Variable | `_log` | Undocumented

@classmethod
def fromServerAddressAndDomain(cls, serverAddress, domain): (source)

Construct a new `SecondaryAuthority` from a tuple giving a server address and a `bytes` giving the name of a domain for which this is an authority.

Parameters
serverAddress | A two-tuple, the first element of which is a `str` giving an IP address and the second element of which is a `int` giving a port number. Together, these define where zone transfers will be attempted from.
domain:`bytes` | A `bytes` giving the domain to transfer.
Returns
A new instance of `SecondaryAuthority`.

def __init__(self, primaryIP, domain): (source)
overrides `twisted.names.authority.FileAuthority.__init__`

Parameters
primaryIP | Undocumented
domain:`bytes` or `str` | The domain for which this will be the secondary authority.

def transfer(self): (source)

Attempt a zone transfer.

Returns
A `Deferred` that fires with `None` when attempted zone transfer has completed.

def update(self): (source)

Undocumented

domain: `bytes` = (source)

The domain for which this is the secondary authority.

primary: `str` = (source)

The IP address of the server from which zone transfers will be attempted.

records: `dict` = (source)
overrides `twisted.names.authority.FileAuthority.records`

Undocumented

soa = (source)
overrides `twisted.names.authority.FileAuthority.soa`

Undocumented

transfering: `bool` = (source)

Undocumented

transferred: `bool` = (source)

Undocumented

transferring: `bool` = (source)

Undocumented

def _cbTransferred(self, result): (source)

Undocumented

def _cbZone(self, zone): (source)

Undocumented

def _ebTransferred(self, failure): (source)

Undocumented

def _ebZone(self, failure): (source)

Undocumented

def _lookup(self, name, cls, type, timeout=None): (source)
overrides `twisted.names.authority.FileAuthority._lookup`

Determine a response to a particular DNS query.

Parameters
name:`bytes` | The name which is being queried and for which to lookup a response.
cls:`int` | The class which is being queried. Only IN is implemented here and this value is presently disregarded.
type:`int` | The type of records being queried. See the types defined in `twisted.names.dns`.
timeout | All processing is done locally and a result is available immediately, so the timeout value is ignored.
Returns
A `Deferred` that fires with a `tuple` of three sets of response records (to comprise the answer, authority, and additional sections of a DNS response) or with a `Failure` if there is a problem processing the query.

_port: `int` = (source)

The port number of the server from which zone transfers will be attempted.

_reactor = (source)

The reactor to use to perform the zone transfers, or `None` to use the global reactor.