2.4.1 DNR Result Objects

Since the DNR calls all execute asynchronously you do not get the results back immediately. Instead, you get a dnr result object. You can check this object to see whether the query is complete, and access its attributes to obtain the information when it is.

Alternatively, you can also reference the result attributes directly, this will result in an implicit wait for the query to complete.

The rtnCode and cname attributes are always available, the others depend on the type of query (address, hinfo or mx).

wait (): Wait for the query to complete.

isdone (): Return 1 if the query is complete.

rtnCode: The error code returned by the query.

cname: The canonical name of the host that was queried.

ip0
ip1
ip2
ip3: At most four integer IP addresses for this host. Unused entries are zero. Valid only for address queries.

cpuType
osType: Textual strings giving the machine type an OS name. Valid for ``hinfo'' queries.

exchange: The name of a mail-exchanger host. Valid for ``mx'' queries.

preference: The preference of this mx record. Not too useful, since the Macintosh will only return a single mx record. Valid for ``mx'' queries only.

The simplest way to use the module to convert names to dotted-decimal strings, without worrying about idle time, etc:

>>> def gethostname(name):
...     import macdnr
...     dnrr = macdnr.StrToAddr(name)
...     return macdnr.AddrToStr(dnrr.ip0)

See About this document... for information on suggesting changes.