Source

pydns /

Filename Size Date modified Message
DNS
tests
tools
485 B
130 B
3.1 KB
524 B
3.7 KB
18.4 KB
821 B
1.5 KB
95 B
Release 2.2, Mon Apr 27 22:59:16 EST 1998

This is a test release of the DNS code, as originally written by 
Guido van Rossum, and with a hopefully nicer API bolted over the
top of it by Anthony Baxter <arb@connect.com.au>. It's also in a 
python 1.5 package.

There are several known bugs/unfinished bits

- processing of AXFR results is not done yet.
- something I've done recently has broken the DnsAsyncRequest(). Bummer.
- doesn't do IPv6 DNS requests (type AAAA) (as per [RFC 1886])
- docs, aside from this file
- all sorts of other stuff that I've probably forgotten.

Stuff it _does_ do:
  processes /etc/resolv.conf - at least as far as nameserver directives go.
  tries multiple nameservers.
  nicer API - see below.
  returns results in more useful format.
  optional timing of requests.
  default 'show' behaviour emulates 'dig' pretty closely.
  support for asyncore.py ### NOTE: currently broken a bit.
  

To use:

import DNS
reqobj=DNS.Request(args)
reqobj.req(args)

args can be a name, in which case it takes that as the query, and/or a series
of keyword/value args. (see below for a list of args)

when calling the 'req()' method, it reuses the options specified in the
DNS.Request() call as defaults.

options are applied in the following order:
  those specified in the req() call
  or, if not specified there,
  those specified in the creation of the Request() object
  or, if not specified there,
  those specified in the DNS.defaults dictionary

name servers can be specified in the following ways:
  by calling DNS.ParseResolvConf(), which will load the DNS.servers
    from the system's /etc/resolv.conf file
  by specifying it as an option to the request
  by manually setting DNS.defaults['server'] to a list of server IP
    addresses to try
  XXXX It should be possible to load the DNS servers on a windows or
    mac box, from where-ever they've squirrelled them away

name="host.do.main"   # the object being looked up
qtype="SOA"           # the query type, eg SOA, A, MX, CNAME, ANY
protocol="udp"        # "udp" or "tcp" - usually you want "udp"
server="nameserver"   # the name of the nameserver. Note that you might
                      # want to use an IP address here
rd=1                  # "recursion desired" - defaults to 1.
other: opcode, port, ...

There's also some convenience functions, for the lazy:

to do a reverse lookup:
>>> print DNS.revlookup("192.189.54.17")    
yarrina.connect.com.au

to look up all MX records for an entry:
>>> print DNS.mxlookup("connect.com.au")
[(10, 'yarrina.connect.com.au'), (100, 'warrane.connect.com.au')]

Documentation of the rest of the interface will have to wait for a 
later date. Note that the DnsAsyncRequest stuff is currently not
working - I haven't looked too closely at why, yet.

There's some examples in the tests/ directory - including test5.py,
which is even vaguely useful. It looks for the SOA for a domain, checks
that the primary NS is authoritative, then checks the nameservers
that it believes are NSs for the domain and checks that they're
authoritative, and that the zone serial numbers match.

see also README.guido for the original docs.

comments to me - arb@connect.com.au