/*
 * adns lookup TYPE DOMAIN [QUERY-OPTIONS]                    => [list RDATA]
 *    if no or dontknow, throws an exception, with errorCode one of
 *         ADNS permfail 300 nxdomain {No such domain}
 *         ADNS permfail 301 nodata {No such data}
 *         ADNS tempfail ERROR-CODE ERROR-NAME ERROR-STRING
 *    where
 *         ERROR-CODE is the numerical adns status value
 *         ERROR-NAME is the symbolic adns status value (in lowercase)
 *         ERROR-STRING is the result of adns_strstatus
 *
 * adns synch TYPE DOMAIN [QUERY-OPTIONS]                     => RESULTS
 *        RESULTS is [list ok|permfail|tempfail
 *                         ERROR-CODE ERROR-NAME ERROR-STRING  \
 *                         OWNER CNAME                         \
 *                         [list RDATA ...]]
 *        OWNER is the RR owner
 *        CNAME is the empty string or the canonical name if we went
 *                  via a CNAME
 *
 * adns asynch ON-YES ON-NO ON-DONTKNOW XARGS \
 *             TYPE DOMAIN \
 *             [QUERY-OPTIONS...]                            => QUERY-ID
 *        calls, later,
 *           [concat ON-YES|ON-NO|ON-DONTKNOW XARGS RESULTS]
 * adns asynch-cancel QUERY-ID
 *
 * QUERY-OPTIONS are zero or more of
 *         -resolver RESOLVER  (see adns new-resolver)
 *                 default is to use a default resolver
 *         -search
 *         -usevc
 *         -quoteok-query
 *         -quoteok-anshost
 *         -quotefail-cname
 *         -cname-loose
 *         -cname-forbid
 *         -reverse
 *         -reverse-any ZONE-A-LIKE
 *
 * adns new-resolver [RES-OPTIONS...]                         => RESOLVER
 *        options:
 *         -errfile stdout|stderr       (stderr is the default)
 *         -noerrprint
 *         -errcallback CALLBACK    results in  eval CALLBACK [list MESSAGE]
 *         -noenv|-debug|-logpid
 *         -checkc-entex
 *         -checkc-freq
 *         -config CONFIG-STRING
 *
 * adns set-default-resolver RESOLVER
 *        cancels any outstanding queries from a previous anonymous
 *        default resolver
 *
 * adns destroy-resolver RESOLVER
 *        cancels outstanding queries
 *
 */
/* ---8<--- end of documentation comment --8<-- */