twisted.names.secondary.SecondaryAuthority

class documentation

class SecondaryAuthority(FileAuthority): (source)

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