twisted.names.secondary.SecondaryAuthority

An Authority that keeps itself updated by performing zone transfers.

Instance Variable	primary	The IP address of the server from which zone transfers will be attempted. (type: `str`)
Instance Variable	domain	The domain for which this is the secondary authority.
Method	__init__
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	transfer	Attempt a zone transfer.
Method	update	Undocumented
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.
Method	_lookup	Determine a response to a particular DNS query.
Method	_cbZone	Undocumented
Method	_ebZone	Undocumented
Method	_cbTransferred	Undocumented
Method	_ebTransferred	Undocumented

Inherited from FileAuthority:

Instance Variable	soa	A 2-tuple containing the SOA domain name as a `bytes` and a `dns.Record_SOA`.
Instance Variable	records	A mapping of domains (as lowercased `bytes`) to records. (type: `dict` with `byte` keys)
Method	__setstate__	Undocumented
Method	loadFile	Load DNS records from a file.
Method	lookupZone	Perform an AXFR record lookup.
Instance Variable	_ADDITIONAL_PROCESSING_TYPES	Record types for which additional processing will be done.
Instance Variable	_ADDRESS_TYPES	Record types which are useful for inclusion in the additional section generated during additional processing.
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

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	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	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	_cbRecords	Undocumented

primary =

The IP address of the server from which zone transfers will be attempted. (type: str)

_port =

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

domain =

The domain for which this is the secondary authority.

_reactor =

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

def __init__(self, primaryIP, domain):

overrides twisted.names.authority.FileAuthority.__init__

Parameters domain The domain for which this will be the secondary authority. (type: bytes or str)

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

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	A `bytes` giving the domain to transfer. (type: `bytes`)
Returns	A new instance of `SecondaryAuthority`.

def transfer(self):

Attempt a zone transfer.

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

def _lookup(self, name, cls, type, timeout=None):

overrides twisted.names.authority.FileAuthority._lookup

Determine a response to a particular DNS query.

Parameters	name	The name which is being queried and for which to lookup a response. (type: `bytes`)
	cls	The class which is being queried. Only IN is implemented here and this value is presently disregarded. (type: `int`)
	type	The type of records being queried. See the types defined in `twisted.names.dns`. (type: `int`)
	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.

def _cbZone(self, zone):

Undocumented

def _ebZone(self, failure):

Undocumented

def update(self):

Undocumented

def _cbTransferred(self, result):

Undocumented

def _ebTransferred(self, failure):

Undocumented

API Documentation for twisted, generated by pydoctor at 2020-03-25 17:34:30.

twisted.names.secondary.SecondaryAuthority(FileAuthority) class documentation

`twisted.names.secondary.SecondaryAuthority(FileAuthority)` class documentation