t.n.client : module documentation

Part of twisted.names View Source

Asynchronous client DNS

The functions exposed in this module can be used for asynchronous name resolution and dns queries.

If you need to create a resolver with specific requirements, such as needing to do queries against a particular host, the createResolver function will return an IResolver.

Future plans: Proper nameserver acquisition on Windows/MacOS, better caching, respect timeouts

Class Resolver No summary
Class AXFRController Undocumented
Class ThreadedResolver Undocumented
Class DNSClientFactory No class docstring; 1/4 methods documented
Function createResolver Create and return a Resolver.
Function getResolver Get a Resolver instance.
Function getHostByName Resolve a name to a valid ipv4 or ipv6 address.
Function query Undocumented
Function lookupAddress Undocumented
Function lookupIPV6Address Undocumented
Function lookupAddress6 Undocumented
Function lookupMailExchange Undocumented
Function lookupNameservers Undocumented
Function lookupCanonicalName Undocumented
Function lookupMailBox Undocumented
Function lookupMailGroup Undocumented
Function lookupMailRename Undocumented
Function lookupPointer Undocumented
Function lookupAuthority Undocumented
Function lookupNull Undocumented
Function lookupWellKnownServices Undocumented
Function lookupService Undocumented
Function lookupHostInfo Undocumented
Function lookupMailboxInfo Undocumented
Function lookupText Undocumented
Function lookupSenderPolicy Undocumented
Function lookupResponsibility Undocumented
Function lookupAFSDatabase Undocumented
Function lookupZone Undocumented
Function lookupAllRecords Undocumented
Function lookupNamingAuthorityPointer Undocumented
def createResolver(servers=None, resolvconf=None, hosts=None): (source)
Create and return a Resolver.
ParametersserversIf not None, interpreted as a list of domain name servers to attempt to use. Each server is a tuple of address in str dotted-quad form and int port number. (type: list of (str, int) or None)
resolvconfIf not None, on posix systems will be interpreted as an alternate resolv.conf to use. Will do nothing on windows systems. If None, /etc/resolv.conf will be used. (type: str or None)
hostsIf not None, an alternate hosts file to use. If None on posix systems, /etc/hosts will be used. On windows, C:\windows\hosts will be used. (type: str or None)
Returns (type: IResolver)
def getResolver(): (source)
Get a Resolver instance.

Create twisted.names.client.theResolver if it is None, and then return that value.

Returns (type: IResolver)
def getHostByName(name, timeout=None, effort=10): (source)
Resolve a name to a valid ipv4 or ipv6 address.

Will errback with DNSQueryTimeoutError on a timeout, DomainError or AuthoritativeDomainError (or subclasses) on other errors.

ParametersnameDNS name to resolve. (type: str)
timeoutNumber of seconds after which to reissue the query. When the last timeout expires, the query is considered failed. (type: Sequence of int)
effortHow many times CNAME and NS records to follow while resolving this name. (type: int)
Returns (type: Deferred)
def query(query, timeout=None): (source)
Undocumented
def lookupAddress(name, timeout=None): (source)
Undocumented
def lookupIPV6Address(name, timeout=None): (source)
Undocumented
def lookupAddress6(name, timeout=None): (source)
Undocumented
def lookupMailExchange(name, timeout=None): (source)
Undocumented
def lookupNameservers(name, timeout=None): (source)
Undocumented
def lookupCanonicalName(name, timeout=None): (source)
Undocumented
def lookupMailBox(name, timeout=None): (source)
Undocumented
def lookupMailGroup(name, timeout=None): (source)
Undocumented
def lookupMailRename(name, timeout=None): (source)
Undocumented
def lookupPointer(name, timeout=None): (source)
Undocumented
def lookupAuthority(name, timeout=None): (source)
Undocumented
def lookupNull(name, timeout=None): (source)
Undocumented
def lookupWellKnownServices(name, timeout=None): (source)
Undocumented
def lookupService(name, timeout=None): (source)
Undocumented
def lookupHostInfo(name, timeout=None): (source)
Undocumented
def lookupMailboxInfo(name, timeout=None): (source)
Undocumented
def lookupText(name, timeout=None): (source)
Undocumented
def lookupSenderPolicy(name, timeout=None): (source)
Undocumented
def lookupResponsibility(name, timeout=None): (source)
Undocumented
def lookupAFSDatabase(name, timeout=None): (source)
Undocumented
def lookupZone(name, timeout=None): (source)
Undocumented
def lookupAllRecords(name, timeout=None): (source)
Undocumented
def lookupNamingAuthorityPointer(name, timeout=None): (source)
Undocumented
API Documentation for Twisted, generated by pydoctor at 2013-11-08 22:07:30.